Files
Neo-ZQYY/docs/audit/changes/2026-03-24__ddl-migration-merge-and-archive.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

2.7 KiB
Raw Blame History

审计记录:迁移脚本合并到主 DDL 并归档

  • 日期2026-03-24
  • Promptdb\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 文件中新增内容与对应迁移脚本一致