From 36463f21190d4ef0ec6fb2316ed65de1cf0b282c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com>
Date: Sat, 5 Sep 2026 00:01:24 +0800
Subject: [PATCH] =?UTF-8?q?task-192:=20=E8=BF=81=E7=A7=BB=E8=A7=84?=
 =?UTF-8?q?=E8=8C=83=E6=A8=A1=E6=9D=BF=EF=BC=88docs/flyway-migration-templ?=
 =?UTF-8?q?ate.md=EF=BC=8C=E5=85=AD=E9=A1=B9=E5=BF=85=E5=A1=AB=E5=A4=B4?=
 =?UTF-8?q?=E6=B3=A8=E9=87=8A=EF=BC=9A=E7=9B=AE=E7=9A=84/=E5=BD=B1?=
 =?UTF-8?q?=E5=93=8D=E8=A1=A8=E6=95=B0=E6=8D=AE=E9=87=8F/=E9=94=81?=
 =?UTF-8?q?=E8=A1=A8=E9=A3=8E=E9=99=A9/=E9=AA=8C=E8=AF=81SQL/=E5=9B=9E?=
 =?UTF-8?q?=E6=BB=9A/=E7=AA=97=E5=8F=A3=EF=BC=89+=208=20=E6=9D=A1=E6=B5=8B?=
 =?UTF-8?q?=E8=AF=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../FlywayMigrationTemplateDocTest.java       | 76 +++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 backend-java/src/test/java/com/nanri/aiimage/config/FlywayMigrationTemplateDocTest.java

diff --git a/backend-java/src/test/java/com/nanri/aiimage/config/FlywayMigrationTemplateDocTest.java b/backend-java/src/test/java/com/nanri/aiimage/config/FlywayMigrationTemplateDocTest.java
new file mode 100644
index 00000000..8f8a8baa
--- /dev/null
+++ b/backend-java/src/test/java/com/nanri/aiimage/config/FlywayMigrationTemplateDocTest.java
@@ -0,0 +1,76 @@
+package com.nanri.aiimage.config;
+
+import org.junit.jupiter.api.Test;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * task-192：迁移规范模板契约。
+ * docs/flyway-migration-template.md 存在且六项必填（目的/影响表与数据量/锁表风险/验证 SQL/
+ * 回滚步骤/上线窗口）齐全，含示例 SQL，可被新迁移文件头注释引用。
+ */
+class FlywayMigrationTemplateDocTest {
+
+    private static final String DOC = "docs/flyway-migration-template.md";
+
+    private String doc() throws IOException {
+        return Files.readString(Path.of(System.getProperty("user.dir"), DOC));
+    }
+
+    @Test
+    void templateExists() throws IOException {
+        assertTrue(Files.exists(Path.of(System.getProperty("user.dir"), DOC)), "模板文件应存在");
+    }
+
+    @Test
+    void sixMandatoryFieldsPresent() throws IOException {
+        String text = doc();
+        for (int i = 1; i <= 6; i++) {
+            assertTrue(text.contains(i + ". "), "头注释应含第 " + i + " 项必填");
+        }
+    }
+
+    @Test
+    void fieldNamesListed() throws IOException {
+        String text = doc();
+        assertTrue(text.contains("变更目的"));
+        assertTrue(text.contains("影响表与数据量"));
+        assertTrue(text.contains("锁表风险"));
+        assertTrue(text.contains("验证 SQL"));
+        assertTrue(text.contains("回滚步骤"));
+        assertTrue(text.contains("上线窗口"));
+    }
+
+    @Test
+    void hasCopyableHeaderComment() throws IOException {
+        assertTrue(doc().contains("复制以下头注释"), "模板应提供可复制头注释");
+        assertTrue(doc().contains("V{N+1}__"), "头注释示例应含占位版本号");
+    }
+
+    @Test
+    void hasValidationSqlExample() throws IOException {
+        assertTrue(doc().contains("SELECT COUNT(*)"), "应含验证 SQL 示例");
+    }
+
+    @Test
+    void hasRollbackField() throws IOException {
+        assertTrue(doc().contains("回滚步骤"), "应含回滚步骤说明");
+    }
+
+    @Test
+    void hasUpgradeWindowField() throws IOException {
+        assertTrue(doc().contains("上线窗口"), "应含上线窗口说明");
+    }
+
+    @Test
+    void templateUsableByNewMigrations() throws IOException {
+        String text = doc();
+        assertTrue(text.contains("src/main/resources/db/"), "应说明迁移文件目录");
+        assertTrue(text.contains("只追加"), "应强调只追加不改历史");
+        assertTrue(text.contains("V109") || text.contains("最大现有版本"), "应说明版本号取最大现有版本+1");
+    }
+}