docs(GOV-011): 确认系列版本约束设计

2026-08-17 17:01:39 +08:00
parent 9e85809096
commit fcfef2d524
9 changed files with 234 additions and 1 deletions
@@ -0,0 +1,22 @@
+# Node 与 MySQL 系列版本约束需求
+
+## 功能需求
+
+- FR-001：运行时门禁必须以主版本 22 判断 Node.js，不绑定 minor 或 patch。
+- FR-002：Schema 生成与验证必须以 major/minor 5.7 判断 mysql 客户端、mysqldump 客户端和 MySQL 服务端，不绑定 patch。
+- FR-003：API MySQL 健康检查必须接受任意 5.7.x，并在成功详情中显示实际版本。
+- FR-004：MySQL 5.7.x 系列校验不得放宽数据库名、字符集、排序规则、时区或开发环境安全边界。
+- FR-005：现行架构、开发规范和部署手册必须使用 Node.js 22.x、MySQL 5.7.x；历史证据中的实际版本不批量改写。
+
+## 质量需求
+
+- 必须测试系列内至少两个不同补丁版本和系列外上下边界。
+- 必须遵循 RED → GREEN：先让 5.7.41 被精确 5.7.42 校验拒绝，再实施系列校验。
+- `assertMysql57Metadata` 的 GitNexus 风险为 CRITICAL，必须完整回归 Schema 生成、历史验证、当前发布基线和治理启动相关测试。
+- 不新增依赖，不增加生产请求、数据库查询或后台任务。
+
+## 安全与性能
+
+- 版本字符串只做固定格式匹配，不执行命令、不拼接 SQL。
+- 数据库访问仍限于既有只读元数据查询；本功能不连接生产数据库。
+- 运行时只增加常数时间字符串判断，不产生可测量的吞吐或内存影响。