docs(GOV-005): 建立 MySQL 5.7 兼容性基线

2026-08-13 10:44:34 +08:00
parent fa1df71eac
commit 91d9b9ce85
23 changed files with 359 additions and 7 deletions
@@ -0,0 +1,32 @@
+# MySQL 5.7 字符集与兼容性基线 PRD
+
+- 功能编号：GOV-005
+- PRD 版本：0.1
+- 状态：approved
+- 日期：2026-08-13
+
+## 问题
+
+项目只写明使用 MySQL，没有固定版本、字符集和排序规则。开发或部署人员可能使用 MySQL 8.x 或不同默认排序规则，造成 SQL、迁移、索引和字符串比较行为不一致。
+
+## 目标
+
+- 固定 MySQL 5.7.x、`utf8mb4` 和 `utf8mb4_general_ci`。
+- 在架构和开发规范中覆盖数据库、表、连接、迁移、测试与 Review。
+- 禁止无意引入 MySQL 8.x 专属能力。
+- 用自动化契约测试防止规范回退。
+
+## 非目标
+
+- 不安装或启动 MySQL。
+- 不创建 Schema、表、迁移或 ORM 配置。
+- 不连接开发或生产数据库。
+- 不启用市场概览持久化。
+
+## 验收标准
+
+- 系统架构明确 MySQL 5.7.x、字符集和排序规则。
+- 开发规范明确全链路显式配置、禁止能力、大小写语义和索引预算。
+- 新契约测试在旧规范上失败，在新规范上通过。
+- 原治理测试无回归。
+- 双 Review 和完成门禁通过。