root/Neo-ZQYY
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
b44096600dd6668738057b809f05e42f63f83513
Neo-ZQYY/docs/audit/changes/2026-03-15__ddl-baseline-consolidation-bd-manual-reorg.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

13 KiB
Raw Blame History

变更审计记录：DDL 基线统一整理 + BD 手册重组 + 小程序副本清理

字段 值
日期 2026-03-15 10:09:07
Prompt-ID P20260315-095422
Session-ID d10f49f0
Session 路径 docs/audit/session_logs/2026-03/15/17_1fc8e375_033312

操作摘要

本轮执行完成数据库 DDL 基线统一整理与同步，核心目标是以当前测试库实际结构为唯一权威来源，全面合并零散变更，实现 docs/database/ddl/ 目录的完整性、一致性与可迁移性。DDL 文件精准更新（7 个文件），所有修改均基于对 TEST_DB_DSN / TEST_APP_DB_DSN 的实时导出。同时完成 BD 手册重组（ETL 专属文档迁入模块内部）和小程序旧副本清理。

变更范围

1. DDL 基线统一整理

  • 运行 scripts/ops/gen_consolidated_ddl.py 从测试库导出最新 DDL
  • 生成/更新 10 个 DDL 基线文件于 docs/database/ddl/
  • 合并 7 个种子数据文件到对应 DDL 文件：
    • seed_ods_tasks.sql + seed_scheduler_tasks.sql → etl_feiqiu__meta.sql
    • seed_dws_config.sql + seed_index_parameters.sql → etl_feiqiu__dws.sql
    • admin_web_seed.sql → zqyy_app__public.sql
    • p3_seed_roles_permissions.sql → zqyy_app__auth.sql
    • p4_seed_trigger_jobs.sql → zqyy_app__biz.sql
  • 删除全部 22 个 etl_feiqiu 迁移脚本 + 4 个种子文件
  • 删除全部 15 个 zqyy_app 迁移脚本 + 1 个种子文件
  • 保留 4 个 FDW 配置脚本（db/fdw/，运行时资产）

2. BD 手册重组

将 ETL 专属 BD 手册从 docs/database/ 迁移到 apps/etl/connectors/feiqiu/docs/database/，遵循"模块专属文档放模块内部"原则：

  • 12 个跨层映射文档 → cross_layer/ 子目录（新建）
  • 4 个 DWS 变更文档 → DWS/changes/
  • 1 个 DWD 变更文档 → DWD/changes/
  • 5 个历史变更文档 → docs/database/_archived/（归档）
  • docs/database/ 保留业务库文档（auth/biz/public/FDW/RLS/AI）

3. 小程序旧副本清理

  • 删除 apps/miniprogram - 副本/ 整个目录（旧的小程序副本，含完整 miniprogram 源码、文档、依赖）
  • 涉及约 200+ 文件，包括页面、组件、工具函数、类型定义、配置文件等

本次对话文件变更

新增文件（27 个）

文件 说明
apps/etl/.../docs/database/DWD/changes/BD_Manual_dim_groupbuy_package_ex_detail_fields.md 团购包扩展表字段变更文档
apps/etl/.../docs/database/DWS/changes/BD_Manual_dws_assistant_order_contribution.md 助教订单贡献表变更文档
apps/etl/.../docs/database/DWS/changes/BD_Manual_dws_goods_stock_summary.md 商品库存汇总表变更文档
apps/etl/.../docs/database/DWS/changes/BD_Manual_dws_member_spending_power_index.md 会员消费力指数表变更文档
apps/etl/.../docs/database/DWS/changes/BD_Manual_dws_project_tags.md 项目标签表变更文档
apps/etl/.../docs/database/cross_layer/BD_Manual_assistant_accounts_master.md 助教账户主表跨层映射
apps/etl/.../docs/database/cross_layer/BD_Manual_assistant_service_records.md 助教服务记录跨层映射
apps/etl/.../docs/database/cross_layer/BD_Manual_goods_stock_movements.md 商品库存流水跨层映射
apps/etl/.../docs/database/cross_layer/BD_Manual_goods_stock_summary.md 商品库存汇总跨层映射
apps/etl/.../docs/database/cross_layer/BD_Manual_goods_stock_warning_info.md 商品库存预警跨层映射
apps/etl/.../docs/database/cross_layer/BD_Manual_group_buy_package_details.md 团购包详情跨层映射
apps/etl/.../docs/database/cross_layer/BD_Manual_member_balance_changes.md 会员余额变动跨层映射
apps/etl/.../docs/database/cross_layer/BD_Manual_recharge_settlements.md 充值结算跨层映射
apps/etl/.../docs/database/cross_layer/BD_Manual_site_tables_master.md 门店台桌主表跨层映射
apps/etl/.../docs/database/cross_layer/BD_Manual_store_goods_master.md 门店商品主表跨层映射
apps/etl/.../docs/database/cross_layer/BD_Manual_store_goods_sales_records.md 门店商品销售记录跨层映射
apps/etl/.../docs/database/cross_layer/BD_Manual_tenant_goods_master.md 租户商品主表跨层映射
docs/database/_archived/BD_Manual_20260301_cleanup_and_fixes.md 归档：清理修复变更记录
docs/database/_archived/BD_Manual_biz_date_function_and_mv_rebuild.md 归档：营业日函数与物化视图重建
docs/database/_archived/BD_Manual_fix_dim_staff_ex_rankname.md 归档：dim_staff_ex 列名修复
docs/database/_archived/BD_Manual_fix_dws_assistant_daily_table_area.md 归档：助教日报表区域修复
docs/database/_archived/BD_Manual_tenant_id_int_to_bigint.md 归档：tenant_id 类型变更
scripts/ops/reorganize_bd_manuals.py BD 手册重组脚本
docs/audit/prompt_logs/prompt_log_20260315_095422.md Prompt 日志
docs/audit/session_logs/2026-03/15/17_1fc8e375_033312/main_01_d10f49f0.md Session 主日志
docs/audit/session_logs/2026-03/15/17_1fc8e375_033312/sub_01_d10f49f0.md Session 子代理日志 1
docs/audit/session_logs/2026-03/15/17_1fc8e375_033312/sub_02_d10f49f0.md Session 子代理日志 2

删除文件（23 个 BD 手册 + 200+ 小程序副本文件）

BD 手册删除（从 docs/database/ 迁出）：

文件 去向
BD_Manual_assistant_accounts_master.md → apps/etl/.../cross_layer/
BD_Manual_assistant_service_records.md → apps/etl/.../cross_layer/
BD_Manual_goods_stock_movements.md → apps/etl/.../cross_layer/
BD_Manual_goods_stock_summary.md → apps/etl/.../cross_layer/
BD_Manual_goods_stock_warning_info.md → apps/etl/.../cross_layer/
BD_Manual_group_buy_package_details.md → apps/etl/.../cross_layer/
BD_Manual_member_balance_changes.md → apps/etl/.../cross_layer/
BD_Manual_recharge_settlements.md → apps/etl/.../cross_layer/
BD_Manual_site_tables_master.md → apps/etl/.../cross_layer/
BD_Manual_store_goods_master.md → apps/etl/.../cross_layer/
BD_Manual_store_goods_sales_records.md → apps/etl/.../cross_layer/
BD_Manual_tenant_goods_master.md → apps/etl/.../cross_layer/
BD_Manual_dws_assistant_order_contribution.md → apps/etl/.../DWS/changes/
BD_Manual_dws_goods_stock_summary.md → apps/etl/.../DWS/changes/
BD_Manual_dws_member_spending_power_index.md → apps/etl/.../DWS/changes/
BD_Manual_dws_project_tags.md → apps/etl/.../DWS/changes/
BD_Manual_dim_groupbuy_package_ex_detail_fields.md → apps/etl/.../DWD/changes/
BD_Manual_20260301_cleanup_and_fixes.md → docs/database/_archived/
BD_Manual_biz_date_function_and_mv_rebuild.md → docs/database/_archived/
BD_Manual_fix_dim_staff_ex_rankname.md → docs/database/_archived/
BD_Manual_fix_dws_assistant_daily_table_area.md → docs/database/_archived/
BD_Manual_tenant_id_int_to_bigint.md → docs/database/_archived/

小程序副本删除：apps/miniprogram - 副本/ 整个目录（旧的小程序完整副本，约 200+ 文件）。

DDL/迁移检查

  • compliance.new_migration_sql：空（无新增迁移 SQL）
  • ⚠️ DDL 基线已通过 gen_consolidated_ddl.py 从测试库实时导出更新，has_ddl_baseline 标记为 false 是因为本次操作本身就是 DDL 基线整理操作，整理后基线已完整

改动注解

docs/database/ddl/etl_feiqiu__meta.sql

  • 变更类型：修改
  • 原始原因：用户要求以测试库现状为基准，统一整理所有 DDL 文件，合并零散迁移和种子数据
  • 思路分析：从 test_etl_feiqiu 实时导出 meta schema DDL，并将 seed_ods_tasks.sql + seed_scheduler_tasks.sql 种子数据合并入文件末尾
  • 修改结果：meta schema DDL 基线完整，包含表结构 + 种子数据，可直接用于新环境部署

docs/database/ddl/zqyy_app__public.sql

  • 变更类型：修改
  • 原始原因：同上，统一 DDL 基线
  • 思路分析：从 test_zqyy_app 导出 public schema DDL，合并 admin_web_seed.sql
  • 修改结果：public schema 基线完整

docs/database/ddl/zqyy_app__auth.sql

  • 变更类型：修改
  • 原始原因：同上
  • 思路分析：从 test_zqyy_app 导出 auth schema DDL，合并 p3_seed_roles_permissions.sql
  • 修改结果：auth schema 基线完整，含角色权限种子数据

docs/database/ddl/zqyy_app__biz.sql

  • 变更类型：修改
  • 原始原因：同上
  • 思路分析：从 test_zqyy_app 导出 biz schema DDL，合并 p4_seed_trigger_jobs.sql
  • 修改结果：biz schema 基线完整，含触发器任务种子数据

docs/database/ddl/etl_feiqiu__dws.sql

  • 变更类型：修改
  • 原始原因：同上
  • 思路分析：从 test_etl_feiqiu 导出 dws schema DDL，合并 seed_dws_config.sql + seed_index_parameters.sql
  • 修改结果：dws schema 基线完整，含 DWS 配置和指数参数种子数据

db/README.md

  • 变更类型：修改
  • 原始原因：DDL 整理后目录结构变化，需同步更新文档
  • 思路分析：更新目录结构说明、迁移管理章节，反映迁移脚本已合并入 DDL 基线的新状态
  • 修改结果：README 准确反映当前 db/ 目录结构

docs/database/README.md

  • 变更类型：修改
  • 原始原因：DDL 整理 + BD 手册重组后需同步更新文档索引
  • 思路分析：更新 DDL 统计数据、BD 手册列表、相关资源链接
  • 修改结果：README 准确反映当前 docs/database/ 目录内容

apps/etl/connectors/feiqiu/docs/database/README.md

  • 变更类型：修改
  • 原始原因：BD 手册重组，新增 cross_layer 子目录和多个变更文档
  • 思路分析：更新目录结构说明，新增 cross_layer 分类描述
  • 修改结果：README 准确反映 ETL 数据库文档的新组织结构

scripts/ops/reorganize_bd_manuals.py

  • 变更类型：新增
  • 原始原因：自动化执行 BD 手册重组操作
  • 思路分析：编写 Python 脚本实现文件移动、目录创建、归档操作，确保可重复执行
  • 修改结果：一次性运维脚本，已执行完成

apps/etl/.../docs/database/cross_layer/BD_Manual_*.md（12 个文件）

  • 变更类型：新增（从 docs/database/ 迁入）
  • 原始原因：遵循"模块专属文档放模块内部"原则，ETL 跨层映射文档应归属 ETL 模块
  • 思路分析：将 ODS→DWD 跨层映射 BD 手册从项目级目录迁移到 ETL 模块内部，新建 cross_layer 子目录统一管理
  • 修改结果：ETL 数据库文档结构更清晰，跨层映射文档集中管理

apps/etl/.../docs/database/DWS/changes/BD_Manual_dws_*.md（4 个文件）

  • 变更类型：新增（从 docs/database/ 迁入）
  • 原始原因：同上，DWS 变更文档归属 ETL 模块
  • 修改结果：DWS 变更文档归入 ETL 模块 DWS/changes/ 目录

apps/etl/.../docs/database/DWD/changes/BD_Manual_dim_groupbuy_package_ex_detail_fields.md

  • 变更类型：新增（从 docs/database/ 迁入）
  • 原始原因：同上，DWD 变更文档归属 ETL 模块
  • 修改结果：DWD 变更文档归入 ETL 模块 DWD/changes/ 目录

docs/database/_archived/BD_Manual_*.md（5 个文件）

  • 变更类型：新增（归档）
  • 原始原因：这些是已完成的历史变更记录（清理修复、函数重建、列名修复、区域修复、类型变更），变更已合并入 DDL 基线，原始记录归档保存
  • 修改结果：历史变更文档归档，不再出现在活跃文档目录中

apps/miniprogram - 副本/（整个目录）

  • 变更类型：删除
  • 原始原因：旧的小程序完整副本，与 apps/miniprogram/ 重复，占用仓库空间且造成混淆
  • 修改结果：清理完成，仓库中只保留唯一的小程序源码目录 apps/miniprogram/

db/etl_feiqiu/migrations/*.sql（22 个文件）

  • 变更类型：删除
  • 原始原因：所有迁移内容已合并入 DDL 基线文件，项目 1.0 未上线，不需要保留零散迁移脚本
  • 修改结果：迁移目录清空（保留 .gitkeep），DDL 基线为唯一权威来源

db/etl_feiqiu/seeds/*.sql（4 个文件）

  • 变更类型：删除
  • 原始原因：种子数据已合并入对应 DDL 基线文件
  • 修改结果：种子目录清空

db/zqyy_app/migrations/*.sql（15 个文件）

  • 变更类型：删除
  • 原始原因：同上
  • 修改结果：迁移目录清空

db/zqyy_app/seeds/*.sql（1 个文件）

  • 变更类型：删除
  • 原始原因：同上
  • 修改结果：种子目录清空

风险评估

  • 低风险：所有 DDL 变更基于测试库实时导出，数据准确性有保障
  • 低风险：BD 手册重组为纯文档移动操作，不涉及代码逻辑变更
  • 低风险：小程序副本删除为清理操作，活跃代码在 apps/miniprogram/ 中不受影响
  • 注意：删除的迁移脚本不可恢复（但内容已合并入 DDL 基线），如需回溯可查看 git 历史
Reference in New Issue View Git Blame Copy Permalink