a-share-analysis/docs/features/GOV-007-development-schema-baseline/prd.md

开发数据库 Schema 基线与版本门禁 PRD

• 功能编号：GOV-007
• PRD 版本：0.1
• 状态：approved
• 日期：2026-08-13

问题

数据库迁移文件只能表达预期变化，不能证明每个版本开始前开发数据库的实际结构，也无法发现手工改表、对象遗漏或环境误连。当前 MySQL 尚未启用，还需要一种不伪造空 Schema 的可审计状态。

目标

• 每个新应用版本开发前，封存上一已发布版本的开发库完整 Schema。
• 将环境、数据库名、MySQL 版本、字符集、排序规则和对象范围设置为强制门禁。
• 生成确定性、可校验、可版本控制且不含数据或凭据的产物。
• MySQL 未启用时生成可验证的不适用记录。
• 在 governance:start 前阻断缺失或失效的上一版本基线。

用户流程

1. 开发者确认上一已发布语义化版本。
2. 执行 npm run schema:baseline 生成或幂等验证对应目录。
3. 执行 npm run schema:verify 复核清单、版本、提交和校验值。
4. 将基线用中文提交推送项目 Gitea。
5. 执行 governance:start 开始下一版本功能。

非目标

• 不备份任何业务数据、用户数据或生产数据。
• 不连接、探测、读取或验证生产数据库。
• 不替代生产运维备份、数据库恢复演练或迁移框架。
• 本版本不启动 MySQL，也不对真实数据库执行命令。

风险

• DEFINER、导出时间和当前自增值会造成不可移植或无意义差异。
• 参数可覆盖 env 或数据库名会扩大到生产资源的误操作范围。
• 空 SQL 或可篡改的 N/A 清单会让门禁形式化而不可信。
• 既有版本目录被覆盖会破坏发布历史。

验收标准

• 开发库、MySQL 5.7 和字符规则不符合时全部阻断。
• 导出参数明确只含结构并覆盖表、视图、触发器、例程和事件。
• 规范化固定样本精确保留业务对象和列自增属性。
• 真实基线三方 SHA-256 一致；N/A 基线只有清单。
• 版本、标签提交、对象范围、状态和文件集合都能自动校验。
• 既有不同内容禁止覆盖，命令行不能切换 production env 或数据库。
• 治理流程、双 Review、GitNexus、中文提交和 Gitea 推送完成。