Files
Neo-ZQYY/docs/audit/changes/2026-03-23__ddl-merge-rejection-count-cancelled.md
Neo 14a12342b5 chore(audit): 补追 96 份未入仓审计孤本 — 覆盖 2026-02-26 ~ 2026-04-08
这些审计记录原本堆积在 docs/audit/changes/changes/ 嵌套误产物目录下(由开发机迁移
79d3c2e 前后的不明批量操作产生)。由于同期 .gitignore 屏蔽了 docs/audit/ 全目录,
它们从未入过 git 任何分支 history。删除即永久丢失。

按 docs/specs/audit-gap-recovery/tasks.md 阶段 1 执行,将全部 96 份 D 类孤本
(主目录无同名、git history 亦无记录)复制到 docs/audit/changes/ 主目录入仓。

涵盖主题: P1-P18 全栈集成 / 多模块累积变更 / ETL bug 修复 / 业务日切 /
   召回与任务引擎改造 / 租户管理与审批 / 董事会财务 / 客户与助教详情 /
   DDL 基线合并 / Kiro 到 Claude Code 迁移

阶段 2(B 类内容漂移 1 份)和阶段 4(嵌套目录删除)独立推进。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 06:35:42 +08:00

64 lines
3.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 变更审计记录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` 为空 |
## 待办事项
- [ ] 正式库 `zqyy_app` 手动执行迁移 `db/zqyy_app/migrations/2026-03-23__add_rejection_count_and_cancelled_status.sql`