变更审计记录:DDL 合并 — rejection_count + cancelled 状态
| 字段 |
值 |
| 日期 |
2026-03-23 01:47:59 |
| Prompt-ID |
P20260323-013317 |
| Session-ID |
af624a77 |
| Session 路径 |
docs/audit/session_logs/2026-03/23/04_7a0da2a2_004044 |
操作摘要
将 2026-03-23 迁移(rejection_count 字段 + cancelled 状态 CHECK 约束 + head_coach/manager 角色)合并到主 DDL 基线 docs/database/ddl/zqyy_app__auth.sql,同步更新 BD 手册 docs/database/BD_Manual_auth_tables.md。删除一次性迁移执行脚本 scripts/ops/_run_migration_prod.py。
变更文件
| 文件 |
变更类型 |
说明 |
docs/database/ddl/zqyy_app__auth.sql |
修改 |
合并迁移到主 DDL 基线 |
docs/database/BD_Manual_auth_tables.md |
修改 |
更新 BD 手册文档 |
scripts/ops/_run_migration_prod.py |
删除 |
一次性迁移脚本,已完成使命 |
本次对话文件变更
新增文件
docs/audit/prompt_logs/prompt_log_20260323_013317.md
docs/audit/session_logs/2026-03/23/04_7a0da2a2_004044/main_01_af624a77.md
docs/audit/session_logs/2026-03/23/04_7a0da2a2_004044/sub_01_af624a77.md
删除文件
docs/audit/session_logs/2026-03/23/04_7a0da2a2_004044/main_01_288df125.md(Session 日志重建替换)
改动注解
docs/database/ddl/zqyy_app__auth.sql
- 变更类型:修改
- 原始原因:2026-03-23 迁移脚本已在测试库验证通过,需合并到主 DDL 基线以保持基线与实际库结构一致
- 思路分析:将迁移中的三项变更直接写入基线 DDL:(1)
auth.users 表增加 rejection_count integer NOT NULL DEFAULT 0 字段;(2) auth.user_applications 的 status CHECK 约束扩展为含 cancelled;(3) 角色种子数据从 4 条更新为 6 条(新增 head_coach/manager),角色-权限映射从 14 条更新为 24 条
- 修改结果:DDL 基线现在完整反映测试库
test_zqyy_app 的 auth schema 实际结构,新建库时可直接使用此基线
docs/database/BD_Manual_auth_tables.md
- 变更类型:修改
- 原始原因:DDL 基线变更后需同步更新 BD 手册,保持文档与数据库结构一致
- 思路分析:在现有文档基础上增量更新:(1) 头部新增迁移脚本引用;(2) 表字段描述中补充
rejection_count 和 cancelled 状态;(3) 约束表新增 user_applications_status_check CHECK 约束;(4) 种子数据更新为 6 角色 / 24 映射;(5) 新增第 5 节完整变更记录(含业务规则、兼容性、回滚、验证 SQL)
- 修改结果:BD 手册完整记录了申请审核流程增强的所有数据库层面变更,包含回滚策略和验证 SQL
scripts/ops/_run_migration_prod.py
- 变更类型:删除
- 原始原因:该脚本为一次性迁移执行辅助工具,迁移已完成(测试库成功,正式库因 psycopg2 Windows 编码问题需手动执行),脚本不再需要保留
合规检查
| 检查项 |
状态 |
说明 |
| BD 手册同步 |
✅ 已更新 |
docs/database/BD_Manual_auth_tables.md 已包含完整变更记录 |
| DDL 基线合并 |
⚠️ 本次完成 |
docs/database/ddl/zqyy_app__auth.sql 已合并迁移内容 |
| 迁移执行状态 |
⚠️ 部分完成 |
测试库 test_zqyy_app 已通过 MCP 验证成功;正式库 zqyy_app 因 psycopg2 Windows 编码问题未能通过脚本执行,需用户手动执行 |
| 新增迁移 SQL |
✅ 无待执行 |
compliance.new_migration_sql 为空 |
| API 变更 |
✅ 无变更 |
compliance.api_changed 为 false |
| 文档缺失 |
✅ 无缺失 |
compliance.code_without_docs 为空 |
待办事项