diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..3b971e1 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,19 @@ +# 项目规范 + +## 数据库迁移(Flyway Migration) + +### 命名规则 +- 脚本格式:`V{YYYYMMDD}_{序号}__{描述}.sql` +- 日期必须使用**实际编写日期**,不得使用过去的日期 +- 序号从 1 开始,同一天多个脚本递增 +- 描述使用下划线分隔的英文短语 + +### 核心原则 +- **不可变性**:已执行的迁移脚本永远不得修改 +- **只增不减**:数据库变更只能通过新增迁移脚本实现 +- **向后兼容**:新脚本应兼容已有数据 + +### 操作规范 +- 删除表:创建新迁移脚本,使用 `DROP TABLE IF EXISTS` +- 修改表结构:使用 `ALTER TABLE` 语句 +- 新增表:创建新迁移脚本,使用 `CREATE TABLE`