docs: 添加 AGENTS.md 项目规范，记录数据库迁移命名规则

2026-05-27 21:23:09 +08:00
parent b0219df313
commit 0beaed8121
1 changed files with 19 additions and 0 deletions
@@ -0,0 +1,19 @@
+# 项目规范
+
+## 数据库迁移（Flyway Migration）
+
+### 命名规则
+- 脚本格式：`V{YYYYMMDD}_{序号}__{描述}.sql`
+- 日期必须使用**实际编写日期**，不得使用过去的日期
+- 序号从 1 开始，同一天多个脚本递增
+- 描述使用下划线分隔的英文短语
+
+### 核心原则
+- **不可变性**：已执行的迁移脚本永远不得修改
+- **只增不减**：数据库变更只能通过新增迁移脚本实现
+- **向后兼容**：新脚本应兼容已有数据
+
+### 操作规范
+- 删除表：创建新迁移脚本，使用 `DROP TABLE IF EXISTS`
+- 修改表结构：使用 `ALTER TABLE` 语句
+- 新增表：创建新迁移脚本，使用 `CREATE TABLE`