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>
This commit is contained in:
Neo
2026-04-20 06:35:42 +08:00
parent 80bda9b991
commit 14a12342b5
96 changed files with 9521 additions and 0 deletions

View File

@@ -0,0 +1,222 @@
# 变更审计记录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 未上线,不需要保留零散迁移脚本
- 修改结果:迁移目录清空(保留 .gitkeepDDL 基线为唯一权威来源
### `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 历史