这些审计记录原本堆积在 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>
2.7 KiB
2.7 KiB
审计记录:迁移脚本合并到主 DDL 并归档
- 日期:2026-03-24
- Prompt:db\zqyy_app\migrations 目录下的 DDL,能合并到主 DDL 里么?能合并的,合并后归档散落的 DDL
- 直接原因:23 个迁移脚本散落在 migrations 目录,其中 20 个的 DDL 变更已可合并到
docs/database/ddl/主基线文件
改动方案
将 3 个此前未合并的迁移脚本内容补充到对应主 DDL 文件,然后将所有已合并的 20 个迁移脚本移动到 _archived/ 目录。保留 3 个不可合并的脚本(含数据迁移/跨库操作)在原位。
文件清单
修改的主 DDL 文件
| 文件 | 变更内容 |
|---|---|
docs/database/ddl/zqyy_app__auth.sql |
新增 idx_tenant_admins_username_lower 唯一索引 |
docs/database/ddl/zqyy_app__public.sql |
新增 min_run_intervals JSONB 列到 scheduled_tasks 表 |
docs/database/ddl/fdw.sql |
新增 board 看板 3 个 RLS 视图的 LIMIT TO 导入 |
归档的迁移脚本(20 个)
移动至 db/zqyy_app/migrations/_archived/:
- 2026-03-18__rns1_add_score_to_notes.sql
- 2026-03-19_import_board_fdw_tables.sql
- 2026-03-20__ns4_member_clue_is_hidden.sql
- 2026-03-20__ns4_tenant_admin_tables.sql
- 2026-03-20__rns14_chat_module_extend.sql
- 2026-03-22__add_config_to_execution_log.sql
- 2026-03-22__ns41_registry_tables.sql
- 2026-03-22__p14_ai_module.sql
- 2026-03-22__p16_min_run_interval.sql
- 2026-03-23__add_head_coach_manager_roles.sql
- 2026-03-23__add_rejection_count_and_cancelled_status.sql
- 2026-03-23__case_insensitive_username.sql
- 2026-03-23__p15_ai_monitoring.sql
- 2026-03-23__scheduled_tasks_per_task_intervals.sql
- 2026-03-23__trigger_jobs_last_error.sql
- 2026-03-24__p17_task_engine_ownership.sql
- 2026-03-24__p18_task_engine_dashboard.sql
- 20260320_add_admin_users_roles.sql
- 20260324_add_avatar_url_to_users.sql
- 20260324_soft_delete_user_site_roles_and_binding.sql
保留在原位的不可合并脚本(3 个)
| 文件 | 原因 |
|---|---|
2026-03-20_rebuild_rls_view_gift_breakdown.sql |
ETL 库视图变更,非 zqyy_app DDL |
2026-03-20_refresh_fdw_finance_recharge_summary.sql |
FDW 外部表动态导入,运行时操作 |
2026-03-23__cleanup_roles_add_admin_type.sql |
包含数据迁移(删除角色),不可合并为基线 |
风险评估
- 低风险:仅文档基线同步,不影响运行中的数据库
- 归档脚本仍可在
_archived/中查阅历史
回滚
- 从
_archived/移回migrations/即可恢复原状 - 主 DDL 文件通过 git revert 回退
验证
db/zqyy_app/migrations/目录仅保留 3 个不可合并脚本 +.gitkeep+_archived/- 主 DDL 文件中新增内容与对应迁移脚本一致