chore(audit): 2026-04-20 历史批次预审 + 文档同步 + .gitignore 修正
- 新增 docs/audit/changes/2026-04-20__historical-batch-pre-audit.md 157 文件分批盘点审计（7 条主线 + 10 项高/中风险 + 2 份迁移 SQL DDL 清单） - 补追 docs/audit/changes/2026-04-15__meituan-settle-core-sync.md 原审计产物因 .gitignore 屏蔽长期未入仓，本次一并追回 - 刷新 docs/audit/audit_dashboard.md（33 条审计记录） - .gitignore 白名单放行 docs/audit/changes/*.md 与 audit_dashboard.md 同时屏蔽 changes/changes/ 嵌套误产物目录 - 新增 docs/specs/audit-gap-recovery/tasks.md 扫描嵌套目录发现 96 份 D 类孤本（从未入过 git history）， 生成独立 PRD 供单开任务清理与补追 - 文档同步（高风险项）： - apps/backend/docs/API-REFERENCE.md (+69) - apps/miniprogram/README.md (+50) - apps/etl/connectors/feiqiu/docs/architecture/data_flow.md (+52/-2) - apps/etl/connectors/feiqiu/docs/architecture/system_overview.md (+5/-3) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -1,107 +1,14 @@
|
||||
# 审计一览表
|
||||
|
||||
> 自动生成于 2026-04-08 15:09:30，请勿手动编辑。
|
||||
> 自动生成于 2026-04-20 06:07:33，请勿手动编辑。
|
||||
|
||||
## 时间线视图
|
||||
|
||||
| 日期 | 项目 | 需求摘要 | 变更类型 | 影响模块 | 风险 | 详情 |
|
||||
|------|------|----------|----------|----------|------|------|
|
||||
| 2026-04-08 | 项目级 | 变更审计记录：Fix-13 回滚手动完成 + 广义召回完成机制 | bugfix | 其他 | 低 | [链接](changes/2026-04-08__fix13-recall-events-refactor.md) |
|
||||
| 2026-04-20 | 项目级 | 变更审计记录：2026-04-20 历史累积批次预审 | bugfix | 其他 | 高 | [链接](changes/2026-04-20__historical-batch-pre-audit.md) |
|
||||
| 2026-04-15 | 项目级 | 变更审计记录：美团结算导入 + core 层定位 + CORE_DIM_SYNC 任务 | bugfix | 其他 | 低 | [链接](changes/2026-04-15__meituan-settle-core-sync.md) |
|
||||
| 2026-04-06 | 项目级 | 变更审计记录：v1 历史清理与 DDL 合并归档 | 清理 | 其他 | 极低 | [链接](changes/2026-04-06__v1-cleanup-ddl-consolidation.md) |
|
||||
| 2026-04-05 | 项目级 | 变更审计记录：Kiro → Claude Code 全量迁移 | 文档 | 其他 | 低 | [链接](changes/2026-04-05__kiro-to-claude-code-migration.md) |
|
||||
| 2026-03-31 | 项目级 | 变更审计记录：任务引擎改造 — 参数调优 + 客户级升级/转移 + 任务统计写入 | 功能 | 其他 | 未知 | [链接](changes/2026-03-31__task-engine-overhaul.md) |
|
||||
| 2026-03-29 | 项目级 | 变更审计记录：助教看板和客户看板懒加载（分页加载） | 重构 | 其他 | 未知 | [链接](changes/2026-03-29__board-lazy-loading-pagination.md) |
|
||||
| 2026-03-29 | 项目级 | 变更审计记录：助教详情页 API 500 修复（Schema 字段名对齐） | bugfix | 其他 | 未知 | [链接](changes/2026-03-29__coach-detail-500-field-name-fix.md) |
|
||||
| 2026-03-29 | 项目级 | 变更审计记录：助教详情页设计稿对齐 + 数据格式化修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-29__coach-detail-design-alignment.md) |
|
||||
| 2026-03-29 | ETL-feiqiu, 后端, 小程序 | 变更审计记录：助教详情页样式修复 + 数据聚合修复 + 关系指数回测支持 | bugfix | 其他 | 未知 | [链接](changes/2026-03-29__coach-detail-style-aggregation-fix.md) |
|
||||
| 2026-03-29 | 项目级 | 变更审计记录：DWS_TASK_ENGINE ETL 编排替代 fire_event 事件链 | 功能 | 其他 | 未知 | [链接](changes/2026-03-29__dws-task-engine-etl-orchestration.md) |
|
||||
| 2026-03-29 | 项目级 | 变更审计记录：修复 recall_completion_check 事件链断裂 | bugfix | 其他 | 未知 | [链接](changes/2026-03-29__fix-recall-completion-event-chain.md) |
|
||||
| 2026-03-28 | ETL-feiqiu, 后端, 项目级 | 变更审计记录：财务看板 5 项修复（ODS 行膨胀 / 优惠分摊 / 环比字段 / 区域过滤 / 规范沉淀） | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-28__board-finance-5fixes.md) |
|
||||
| 2026-03-28 | 项目级 | 变更审计记录：财务看板 DWS 区域维度重构审计 | 重构 | 其他 | 未知 | [链接](changes/2026-03-28__board-finance-dws-area-refactor-audit.md) |
|
||||
| 2026-03-28 | 项目级 | 变更审计记录：修复小程序登录落地页跳转失效 | bugfix | 其他 | 未知 | [链接](changes/2026-03-28__fix-miniprogram-login-landing-page.md) |
|
||||
| 2026-03-27 | 小程序 | 变更审计记录：board-finance 双重格式化修复 | bugfix | 其他 | 低 | [链接](changes/2026-03-27__board-finance-double-format-fix.md) |
|
||||
| 2026-03-27 | 后端 | 审计记录：board-finance-integration 阶段 2（后端 API 修复） | bugfix | 其他 | 未知 | [链接](changes/2026-03-27__board-finance-integration-T2.md) |
|
||||
| 2026-03-27 | 项目级 | 变更审计记录：财务看板 Phase 2 对齐 Demo（T1-T6） | bugfix | 其他 | 未知 | [链接](changes/2026-03-27__board-finance-phase2-t1-t6.md) |
|
||||
| 2026-03-27 | 项目级 | 变更审计记录：board-finance WXML 格式化迁移 + 动态 Tab + 加载态清理 | bugfix | 其他 | 未知 | [链接](changes/2026-03-27__board-finance-wxml-format-tabs-cleanup.md) |
|
||||
| 2026-03-27 | 项目级 | 变更审计记录：小程序权限体系统一改造（W1-W5） | 功能 | 其他 | 未知 | [链接](changes/2026-03-27__miniprogram-permission-unification.md) |
|
||||
| 2026-03-27 | 项目级 | 变更审计记录：任务列表近60天数据展示 + WXML 格式化改造 | 重构 | 其他 | 高 | [链接](changes/2026-03-27__task-list-recent60d-and-wxml-formatting.md) |
|
||||
| 2026-03-26 | 项目级 | 审计记录：ETL 缺失字段补充 — 第一阶段（DDL + FACT_MAPPINGS） | 功能 | 其他 | 低 | [链接](changes/2026-03-26__etl-missing-fields-phase1-ddl-mappings.md) |
|
||||
| 2026-03-26 | 项目级 | 变更审计记录：到手金额口径修复（全小程序统一） | bugfix | 其他 | 未知 | [链接](changes/2026-03-26__net-income-calibration-all-pages.md) |
|
||||
| 2026-03-25 | 项目级 | 变更审计记录：保底 relationship_building 任务生成 | bugfix | 其他 | 未知 | [链接](changes/2026-03-25__baseline-relationship-building-tasks.md) |
|
||||
| 2026-03-25 | 项目级 | 变更审计记录：保底任务生成独立连接修复 | bugfix | 其他 | 高 | [链接](changes/2026-03-25__baseline-task-independent-connection-fix.md) |
|
||||
| 2026-03-25 | 项目级 | 变更审计记录：绩效页→任务详情页按 member_id 查询任务 | 文档 | 其他 | 未知 | [链接](changes/2026-03-25__perf-to-task-detail-member-query.md) |
|
||||
| 2026-03-25 | 项目级 | 绩效页 WXML 缺少 data-member-id 导致任务详情页空白 | bugfix | 其他 | 未知 | [链接](changes/2026-03-25__perf-wxml-missing-member-id.md) |
|
||||
| 2026-03-25 | 项目级 | 变更审计记录（Change Audit Record） | bugfix | 其他 | 未知 | [链接](changes/2026-03-25__task-detail-service-records-6-improvements.md) |
|
||||
| 2026-03-25 | 项目级 | 变更审计记录：租户用户审核 — 软删除恢复 upsert 修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-25__tenant-users-soft-delete-upsert-fix.md) |
|
||||
| 2026-03-24 | 项目级 | 变更审计记录：补录 cfg_skill_type 缺失的 3 条课程类型配置 | bugfix | 其他 | 未知 | [链接](changes/2026-03-24__add_missing_cfg_skill_type.md) |
|
||||
| 2026-03-24 | ETL-feiqiu, 项目级 | 审计记录：迁移脚本合并到主 DDL 并归档 | 文档 | 其他, 文档 | 低 | [链接](changes/2026-03-24__ddl-migration-merge-and-archive.md) |
|
||||
| 2026-03-24 | 后端 | 审计记录：修复小程序前端档位进度条无刻度 + bonus_money 计算 | bugfix | 其他 | 低 | [链接](changes/2026-03-24__fix-tier-nodes-empty-progress-bar.md) |
|
||||
| 2026-03-24 | 项目级 | 变更审计记录：lookback_days 从 60 天扩大到 90 天 | 文档 | 其他 | 未知 | [链接](changes/2026-03-24__lookback_days_60_to_90.md) |
|
||||
| 2026-03-24 | ETL-feiqiu, 小程序, 项目级 | 变更审计记录：小程序登录页头像昵称获取功能（前端实施） | 文档 | 其他, 文档 | 低 | [链接](changes/2026-03-24__miniprogram-avatar-nickname-feature.md) |
|
||||
| 2026-03-24 | ETL-feiqiu, 后端 | 变更审计记录：P17 助教客户归属与任务生成引擎 | bugfix | 其他, 测试 | 未知 | [链接](changes/2026-03-24__p17-assistant-ownership-task-engine.md) |
|
||||
| 2026-03-24 | ETL-feiqiu, 后端, 管理后台 | 变更审计记录：P18 任务引擎运营看板实施 | bugfix | 其他, 文档, 脚本工具 | 未知 | [链接](changes/2026-03-24__p18-task-engine-dashboard.md) |
|
||||
| 2026-03-24 | 项目级 | 变更审计记录：绩效页数据正确性修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-24__perf-page-data-fix.md) |
|
||||
| 2026-03-24 | 后端, 项目级 | 审计记录：审核弹窗头像展示 + 排版优化 | 功能 | 其他 | 低 | [链接](changes/2026-03-24__review-modal-avatar-layout.md) |
|
||||
| 2026-03-24 | 项目级 | 变更审计记录：user_site_roles / user_assistant_binding 软删除实施 | 文档 | 其他 | 未知 | [链接](changes/2026-03-24__soft-delete-user-site-roles-binding.md) |
|
||||
| 2026-03-24 | 项目级 | 变更审计记录：TriggerJobs 清空任务交互反馈优化 | 清理 | 其他 | 高 | [链接](changes/2026-03-24__trigger-jobs-clear-task-interaction.md) |
|
||||
| 2026-03-23 | 项目级 | 变更审计记录：DDL 合并 — rejection_count + cancelled 状态 | 文档 | 其他 | 未知 | [链接](changes/2026-03-23__ddl-merge-rejection-count-cancelled.md) |
|
||||
| 2026-03-23 | 项目级 | 变更审计记录：禁用用户改为移除用户 + 小程序鉴权两层模型修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-23__disable-to-remove-user-auth-model-fix.md) |
|
||||
| 2026-03-23 | 项目级 | 变更审计记录：店铺筛选 + 时间格式 + 姓名格式 + 李小燕确认 | bugfix | 其他 | 未知 | [链接](changes/2026-03-23__mysites-tenant-filter-time-format-nickname-display.md) |
|
||||
| 2026-03-23 | 项目级 | 变更审计记录：审核弹窗手机号不显示修复 + 自动匹配优化 + 身份标签中文化 | bugfix | 其他 | 未知 | [链接](changes/2026-03-23__review-modal-phone-display-auto-match-identity-label.md) |
|
||||
| 2026-03-23 | 项目级 | 变更审计记录（Change Audit Record） | 功能 | 其他 | 未知 | [链接](changes/2026-03-23__role-routing-page-guard.md) |
|
||||
| 2026-03-23 | 项目级 | 变更审计记录：租户管理员用户名大小写不敏感 | 功能 | 其他 | 未知 | [链接](changes/2026-03-23__tenant-admin-case-insensitive-username.md) |
|
||||
| 2026-03-23 | 项目级 | 变更审计记录：租户管理后台审核弹窗改造（角色动态化 + 人员列表联动 + 手机号自动匹配） | bugfix | 其他 | 未知 | [链接](changes/2026-03-23__tenant-admin-review-modal-dynamic-roles.md) |
|
||||
| 2026-03-23 | 项目级 | 变更审计记录：根治 tenant_admin 的 managed_site_ids 限制（跨模块权限验证改造） | bugfix | 其他 | 未知 | [链接](changes/2026-03-23__tenant-admin-site-access-root-fix.md) |
|
||||
| 2026-03-23 | 项目级 | 变更审计记录：租户后台申请列表店铺筛选 + admin-web 简写ID修复 | bugfix | 其他 | 高 | [链接](changes/2026-03-23__tenant-user-approval-site-filter.md) |
|
||||
| 2026-03-23 | 项目级 | 变更审计记录：Task 6 Change B/C — 定时任务管理页面 + 小程序清理 | bugfix | 其他 | 未知 | [链接](changes/2026-03-23__trigger-jobs-admin-web-miniprogram-cleanup.md) |
|
||||
| 2026-03-22 | 项目级 | 变更审计记录：数据库字段走查批量修复 | bugfix | 其他 | 低 | [链接](changes/2026-03-22__db-field-walkthrough-batch-fix.md) |
|
||||
| 2026-03-22 | 后端 | 变更审计记录：DDL vs 数据库结构对比修复 + BD 手册全面审核走查 | bugfix | 其他 | 未知 | [链接](changes/2026-03-22__ddl-db-structure-diff-bd-manual-audit.md) |
|
||||
| 2026-03-22 | ETL-feiqiu | 变更审计记录（Change Audit Record） | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-22__ddl_bd_manual_consistency_fix.md) |
|
||||
| 2026-03-22 | 项目级 | 变更审计记录：dev-trace-log 全栈开发调试全链路日志系统 | 清理 | 其他 | 低 | [链接](changes/2026-03-22__dev-trace-log-fullstack-feature.md) |
|
||||
| 2026-03-22 | 项目级 | 变更审计记录：NS4 DDL 合并 — deleted_at 字段并入主迁移脚本 | 文档 | 其他 | 未知 | [链接](changes/2026-03-22__ns4-ddl-merge-deleted-at.md) |
|
||||
| 2026-03-22 | ETL-feiqiu, 项目级 | 审计记录：P14 Task 15 — 最终检查点完成 | bugfix | 其他, 脚本工具 | 极低 | [链接](changes/2026-03-22__p14-task15-final-checkpoint.md) |
|
||||
| 2026-03-22 | ETL-feiqiu | 变更审计记录：P16 调度任务最小运行间隔 — Spec 收尾文档同步 | 文档 | 文档 | 未知 | [链接](changes/2026-03-22__p16-spec-closing-doc-sync.md) |
|
||||
| 2026-03-22 | 项目级 | 变更审计记录：trace 日志路径修复 + 小程序登录竞态修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-22__trace-path-fix-miniprogram-login-race.md) |
|
||||
| 2026-03-22 | 项目级 | 变更审计记录：僵尸任务修复 + 优雅关闭 + 重新执行按钮 | bugfix | 其他 | 未知 | [链接](changes/2026-03-22__zombie-task-graceful-shutdown-rerun.md) |
|
||||
| 2026-03-20 | 项目级 | 变更审计记录：ai-prompt-refinement spec 完成 + board-coach Mock 精简 | bugfix | 其他 | 未知 | [链接](changes/2026-03-20__ai-prompt-refinement-board-coach-mock.md) |
|
||||
| 2026-03-20 | 项目级 | H2 修复：FDW → 直连 ETL 架构统一 | bugfix | 其他 | 未知 | [链接](changes/2026-03-20__h2-fdw-to-direct-etl-unification.md) |
|
||||
| 2026-03-20 | 项目级 | 审计记录：小程序文档同步更新 | bugfix | 其他 | 极低 | [链接](changes/2026-03-20__miniprogram-docs-sync.md) |
|
||||
| 2026-03-20 | ETL-feiqiu, 后端 | 变更审计记录：R3 项目类型筛选接口重建（fetchSkillTypes / cfg_area_category） | bugfix | 其他, 文档 | 高 | [链接](changes/2026-03-20__r3-skill-type-filter-rebuild.md) |
|
||||
| 2026-03-20 | 项目级 | RNS1 系列 AI 自主决策风险审计报告（完整版） | bugfix | 其他 | 高 | [链接](changes/2026-03-20__rns1-ai-autonomous-decision-risk-audit.md) |
|
||||
| 2026-03-20 | ETL-feiqiu, 后端, 项目级 | 变更审计记录：RNS1.3 三看板 FDW 查询层数据口径修复 | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-20__rns13-board-apis-e2e-fix.md) |
|
||||
| 2026-03-20 | 项目级 | 变更审计记录：RNS1.4 CHAT 模块重建 + FDW→直连统一 + R3 筛选修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-20__rns14-chat-fdw-filter-audit.md) |
|
||||
| 2026-03-20 | 项目级 | 变更审计记录：RNS1.4 CHAT 模块迁移 + R3 项目类型筛选重建 | bugfix | 其他 | 高 | [链接](changes/2026-03-20__rns14-chat-module-r3-filter-rebuild.md) |
|
||||
| 2026-03-19 | ETL-feiqiu, 后端 | 变更审计记录：card_type_id 年卡/月卡映射文档同步 | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-19__card-type-id-doc-sync.md) |
|
||||
| 2026-03-19 | 项目级 | 变更审计记录：coach_service 绩效档位硬编码修复 | bugfix | 其他 | 低 | [链接](changes/2026-03-19__coach-tier-hardcode-fix.md) |
|
||||
| 2026-03-19 | ETL-feiqiu, 后端 | 变更审计记录：助教等级映射硬编码修复（P2-9） | bugfix | 其他, 文档 | 低 | [链接](changes/2026-03-19__level-map-hardcode-fix.md) |
|
||||
| 2026-03-19 | 项目级 | 数据库变更审计：RNS1.2 客户与助教接口 | 文档 | 其他 | 低 | [链接](changes/2026-03-19__rns12-db-audit.md) |
|
||||
| 2026-03-18 | 项目级 | RNS1.1 E2E 测试 — FDW 直连改造 + performance_service bug 修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-18__rns1-e2e-fdw-direct-connect-bugfix.md) |
|
||||
| 2026-03-15 | 项目级 | 变更审计记录：DDL 基线统一整理 + BD 手册重组 + 小程序副本清理 | bugfix | 其他 | 低 | [链接](changes/2026-03-15__ddl-baseline-consolidation-bd-manual-reorg.md) |
|
||||
| 2026-03-13 | ETL-feiqiu, 小程序 | 审计记录：board-finance line-height 全量补齐 | bugfix | 其他, 文档 | 低 | [链接](changes/2026-03-13__board-finance-line-height-audit.md) |
|
||||
| 2026-03-13 | 项目级 | 审计记录：board-finance.wxss rpx 换算公式修正 | 功能 | 其他 | 未知 | [链接](changes/2026-03-13__board-finance-rpx-formula-correction.md) |
|
||||
| 2026-03-13 | 项目级 | 变更审计记录：task-list 页面 H5 原型 1:1 重写 | bugfix | 其他 | 未知 | [链接](changes/2026-03-13__task-list-h5-rewrite.md) |
|
||||
| 2026-03-12 | 项目级 | 变更审计记录：board-finance WXSS 视觉校对（四轮） | bugfix | 其他 | 未知 | [链接](changes/2026-03-12__board-finance-overview-wxss-calibration.md) |
|
||||
| 2026-03-12 | 项目级 | 变更审计记录：小程序前端开发文档体系收尾（步骤 1-4） | 文档 | 其他 | 低 | [链接](changes/2026-03-12__miniprogram-dev-docs-finalize.md) |
|
||||
| 2026-03-12 | 项目级 | 变更审计记录：多模块累积变更 — AI 对话系统 + 任务防御 + 小程序 UI 重构 + ETL DWS | bugfix | 其他 | 未知 | [链接](changes/2026-03-12__multi-module-ai-taskdefense-miniprogram-etl.md) |
|
||||
| 2026-03-12 | 项目级 | 变更审计记录：pixel-audit 结构化审计方法论替换像素对比 | 文档 | 其他 | 未知 | [链接](changes/2026-03-12__pixel-audit-structured-methodology.md) |
|
||||
| 2026-03-10 | 项目级 | 变更审计记录：多模块累积变更 — AI 应用骨架 + 任务队列防卡死 + 小程序页面迁移 | bugfix | 其他 | 未知 | [链接](changes/2026-03-10__multi-module-ai-apps-task-defense-miniprogram.md) |
|
||||
| 2026-03-08 | ETL-feiqiu, 后端 | 变更审计记录：P5 AI 集成需求审视 — 7 项歧义修补 + category 枚举对齐 | 文档 | 其他, 文档, 脚本工具 | 未知 | [链接](changes/2026-03-08__p5-ai-spec-review-category-enum-align.md) |
|
||||
| 2026-03-07 | 项目级 | 变更审计记录：TASK 3 项目标签计算逻辑 — 文档与配置同步 | 文档 | 其他 | 低 | [链接](changes/2026-03-07__task3-project-tag-docs-sync.md) |
|
||||
| 2026-03-06 | 项目级 | 变更审计记录：修复 RecordingAPIClient 缺少 post 方法 | bugfix | 其他 | 极低 | [链接](changes/2026-03-06__fix-api-client-post-method.md) |
|
||||
| 2026-03-06 | 项目级 | 变更审计记录：修复 DatabaseOperations 缺少 _dsn 属性导致 DWD 并行装载全部失败 | bugfix | 其他 | 极低 | [链接](changes/2026-03-06__fix-db-operations-dsn-proxy.md) |
|
||||
| 2026-03-04 | 项目级 | 变更审计记录：全栈累积变更（营业日配置、WebSocket 日志、微信认证、仓库清理） | 重构 | 其他 | 高 | [链接](changes/2026-03-04__fullstack-accumulated-changes.md) |
|
||||
| 2026-03-03 | 项目级 | 变更审计记录：微信小程序开发调试面板 | 文档 | 其他 | 低 | [链接](changes/2026-03-03__miniprogram-dev-debug-panel.md) |
|
||||
| 2026-03-02 | ETL-feiqiu, 项目级 | 变更审计：合并 ETL Hook 为统一分析入口 | 文档 | 其他, 脚本工具 | 未知 | [链接](changes/2026-03-02__etl-unified-analysis-hook-merge.md) |
|
||||
| 2026-03-02 | 项目级 | SPI 基数校准改用非零样本中位数 | 功能 | 其他 | 未知 | [链接](changes/2026-03-02__spi-calibration-nonzero-median.md) |
|
||||
| 2026-03-01 | 项目级 | 审计记录：DWD 清理 + ODS 商品销售修复 + dim_staff_ex 修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-01__dwd-cleanup-ods-fix-dim-staff-repair.md) |
|
||||
| 2026-03-01 | 项目级 | 变更审计：DWS numeric 精度扩展 + ODS 库存 siteid 注入 | 文档 | 其他 | 低 | [链接](changes/2026-03-01__dws-numeric-precision-ods-siteid-fix.md) |
|
||||
| 2026-02-28 | ETL-feiqiu, 后端, 管理后台 | 变更审计记录：多模块累积变更（营业日/核心业务/认证/ETL DWS 重构/参考文档合并） | 重构 | 其他 | 未知 | [链接](changes/2026-02-28__multi-module-accumulated-changes.md) |
|
||||
| 2026-02-27 | ETL-feiqiu, 共享包, 跨库(FDW), 项目级 | 变更审计：营业日分割规则 PRD 同步检查 + 全栈集成收口 | bugfix | API 层, DWD 层, DWS 层, 其他, 调度, 质量校验, 配置 | 低 | [链接](changes/2026-02-27__biz-day-cutoff-prd-sync-check.md) |
|
||||
| 2026-02-27 | 项目级 | 审计记录：P4 小程序核心业务路由 + 触发器注册 | 重构 | 其他 | 未知 | [链接](changes/2026-02-27__p4-core-business-routes-triggers.md) |
|
||||
| 2026-02-26 | 项目级 | 审计记录：ETL Bug 修复 — dim_staff_ex 列映射 + assistant_daily table_area_name | bugfix | 其他 | 未知 | [链接](changes/2026-02-26__etl-bugfix-dim-staff-rankname-assistant-daily-table-area.md) |
|
||||
| 2026-02-26 | 项目级 | 变更审计：P1/P2/P3 全栈集成（DB 基础 + ETL DWS 扩展 + 小程序鉴权） | bugfix | 其他 | 低 | [链接](changes/2026-02-26__p1-p2-p3-fullstack-integration.md) |
|
||||
| 2026-02-26 | 项目级 | 审计记录：维客线索重构（member_birthday_manual → member_retention_clue） | 重构 | 其他 | 未知 | [链接](changes/2026-02-26__retention-clue-refactor.md) |
|
||||
| 2026-02-26 | 项目级 | 审计记录：root-file — .gitignore 更新与 H5 UI / 临时文件清理 | 重构 | 其他 | 高 | [链接](changes/2026-02-26__root-file-gitignore-h5ui-cleanup.md) |
|
||||
| 2026-02-15 | 项目级 | 审计记录：管理后台全量实现 + DB Schema 迁移 + 审计产物重组 | 清理 | 其他 | 高 | [链接](changes/2026-02-15__admin-web-console-db-migration-audit-reorg.md) |
|
||||
| 2026-02-15 | ETL-feiqiu, 项目级 | 变更审计记录（Change Audit Record） | 文档 | 其他, 文档, 质量校验 | 极低 | [链接](changes/2026-02-15__audit-consolidation-doc-reorg.md) |
|
||||
| 2026-02-15 | 后端 | 审计记录：后端依赖补全使 FastAPI 可启动 | bugfix | 其他 | 未知 | [链接](changes/2026-02-15__backend-deps-bootstrap.md) |
|
||||
@@ -139,24 +46,6 @@
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 影响模块 | 风险 | 详情 |
|
||||
|------|----------|----------|----------|------|------|
|
||||
| 2026-03-29 | 变更审计记录：助教详情页样式修复 + 数据聚合修复 + 关系指数回测支持 | bugfix | 其他 | 未知 | [链接](changes/2026-03-29__coach-detail-style-aggregation-fix.md) |
|
||||
| 2026-03-28 | 变更审计记录：财务看板 5 项修复（ODS 行膨胀 / 优惠分摊 / 环比字段 / 区域过滤 / 规范沉淀） | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-28__board-finance-5fixes.md) |
|
||||
| 2026-03-24 | 审计记录：迁移脚本合并到主 DDL 并归档 | 文档 | 其他, 文档 | 低 | [链接](changes/2026-03-24__ddl-migration-merge-and-archive.md) |
|
||||
| 2026-03-24 | 变更审计记录：小程序登录页头像昵称获取功能（前端实施） | 文档 | 其他, 文档 | 低 | [链接](changes/2026-03-24__miniprogram-avatar-nickname-feature.md) |
|
||||
| 2026-03-24 | 变更审计记录：P17 助教客户归属与任务生成引擎 | bugfix | 其他, 测试 | 未知 | [链接](changes/2026-03-24__p17-assistant-ownership-task-engine.md) |
|
||||
| 2026-03-24 | 变更审计记录：P18 任务引擎运营看板实施 | bugfix | 其他, 文档, 脚本工具 | 未知 | [链接](changes/2026-03-24__p18-task-engine-dashboard.md) |
|
||||
| 2026-03-22 | 变更审计记录（Change Audit Record） | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-22__ddl_bd_manual_consistency_fix.md) |
|
||||
| 2026-03-22 | 审计记录：P14 Task 15 — 最终检查点完成 | bugfix | 其他, 脚本工具 | 极低 | [链接](changes/2026-03-22__p14-task15-final-checkpoint.md) |
|
||||
| 2026-03-22 | 变更审计记录：P16 调度任务最小运行间隔 — Spec 收尾文档同步 | 文档 | 文档 | 未知 | [链接](changes/2026-03-22__p16-spec-closing-doc-sync.md) |
|
||||
| 2026-03-20 | 变更审计记录：R3 项目类型筛选接口重建（fetchSkillTypes / cfg_area_category） | bugfix | 其他, 文档 | 高 | [链接](changes/2026-03-20__r3-skill-type-filter-rebuild.md) |
|
||||
| 2026-03-20 | 变更审计记录：RNS1.3 三看板 FDW 查询层数据口径修复 | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-20__rns13-board-apis-e2e-fix.md) |
|
||||
| 2026-03-19 | 变更审计记录：card_type_id 年卡/月卡映射文档同步 | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-19__card-type-id-doc-sync.md) |
|
||||
| 2026-03-19 | 变更审计记录：助教等级映射硬编码修复（P2-9） | bugfix | 其他, 文档 | 低 | [链接](changes/2026-03-19__level-map-hardcode-fix.md) |
|
||||
| 2026-03-13 | 审计记录：board-finance line-height 全量补齐 | bugfix | 其他, 文档 | 低 | [链接](changes/2026-03-13__board-finance-line-height-audit.md) |
|
||||
| 2026-03-08 | 变更审计记录：P5 AI 集成需求审视 — 7 项歧义修补 + category 枚举对齐 | 文档 | 其他, 文档, 脚本工具 | 未知 | [链接](changes/2026-03-08__p5-ai-spec-review-category-enum-align.md) |
|
||||
| 2026-03-02 | 变更审计：合并 ETL Hook 为统一分析入口 | 文档 | 其他, 脚本工具 | 未知 | [链接](changes/2026-03-02__etl-unified-analysis-hook-merge.md) |
|
||||
| 2026-02-28 | 变更审计记录：多模块累积变更（营业日/核心业务/认证/ETL DWS 重构/参考文档合并） | 重构 | 其他 | 未知 | [链接](changes/2026-02-28__multi-module-accumulated-changes.md) |
|
||||
| 2026-02-27 | 变更审计：营业日分割规则 PRD 同步检查 + 全栈集成收口 | bugfix | API 层, DWD 层, DWS 层, 其他, 调度, 质量校验, 配置 | 低 | [链接](changes/2026-02-27__biz-day-cutoff-prd-sync-check.md) |
|
||||
| 2026-02-15 | 变更审计记录（Change Audit Record） | 文档 | 其他, 文档, 质量校验 | 极低 | [链接](changes/2026-02-15__audit-consolidation-doc-reorg.md) |
|
||||
| 2026-02-15 | 审计记录：docs/bd_manual + docs/dictionary → docs/database 合并 | 清理 | 其他, 文档, 脚本工具 | 极低 | [链接](changes/2026-02-15__docs-database-merge.md) |
|
||||
| 2026-02-15 | 审计记录：docs/index + docs/开发笔记 清理与路径整合 | 清理 | 其他, 文档, 脚本工具 | 低 | [链接](changes/2026-02-15__docs-devnotes-index-cleanup.md) |
|
||||
@@ -187,141 +76,21 @@
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 影响模块 | 风险 | 详情 |
|
||||
|------|----------|----------|----------|------|------|
|
||||
| 2026-03-29 | 变更审计记录：助教详情页样式修复 + 数据聚合修复 + 关系指数回测支持 | bugfix | 其他 | 未知 | [链接](changes/2026-03-29__coach-detail-style-aggregation-fix.md) |
|
||||
| 2026-03-28 | 变更审计记录：财务看板 5 项修复（ODS 行膨胀 / 优惠分摊 / 环比字段 / 区域过滤 / 规范沉淀） | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-28__board-finance-5fixes.md) |
|
||||
| 2026-03-27 | 审计记录：board-finance-integration 阶段 2（后端 API 修复） | bugfix | 其他 | 未知 | [链接](changes/2026-03-27__board-finance-integration-T2.md) |
|
||||
| 2026-03-24 | 审计记录：修复小程序前端档位进度条无刻度 + bonus_money 计算 | bugfix | 其他 | 低 | [链接](changes/2026-03-24__fix-tier-nodes-empty-progress-bar.md) |
|
||||
| 2026-03-24 | 变更审计记录：P17 助教客户归属与任务生成引擎 | bugfix | 其他, 测试 | 未知 | [链接](changes/2026-03-24__p17-assistant-ownership-task-engine.md) |
|
||||
| 2026-03-24 | 变更审计记录：P18 任务引擎运营看板实施 | bugfix | 其他, 文档, 脚本工具 | 未知 | [链接](changes/2026-03-24__p18-task-engine-dashboard.md) |
|
||||
| 2026-03-24 | 审计记录：审核弹窗头像展示 + 排版优化 | 功能 | 其他 | 低 | [链接](changes/2026-03-24__review-modal-avatar-layout.md) |
|
||||
| 2026-03-22 | 变更审计记录：DDL vs 数据库结构对比修复 + BD 手册全面审核走查 | bugfix | 其他 | 未知 | [链接](changes/2026-03-22__ddl-db-structure-diff-bd-manual-audit.md) |
|
||||
| 2026-03-20 | 变更审计记录：R3 项目类型筛选接口重建（fetchSkillTypes / cfg_area_category） | bugfix | 其他, 文档 | 高 | [链接](changes/2026-03-20__r3-skill-type-filter-rebuild.md) |
|
||||
| 2026-03-20 | 变更审计记录：RNS1.3 三看板 FDW 查询层数据口径修复 | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-20__rns13-board-apis-e2e-fix.md) |
|
||||
| 2026-03-19 | 变更审计记录：card_type_id 年卡/月卡映射文档同步 | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-19__card-type-id-doc-sync.md) |
|
||||
| 2026-03-19 | 变更审计记录：助教等级映射硬编码修复（P2-9） | bugfix | 其他, 文档 | 低 | [链接](changes/2026-03-19__level-map-hardcode-fix.md) |
|
||||
| 2026-03-08 | 变更审计记录：P5 AI 集成需求审视 — 7 项歧义修补 + category 枚举对齐 | 文档 | 其他, 文档, 脚本工具 | 未知 | [链接](changes/2026-03-08__p5-ai-spec-review-category-enum-align.md) |
|
||||
| 2026-02-28 | 变更审计记录：多模块累积变更（营业日/核心业务/认证/ETL DWS 重构/参考文档合并） | 重构 | 其他 | 未知 | [链接](changes/2026-02-28__multi-module-accumulated-changes.md) |
|
||||
| 2026-02-15 | 审计记录：后端依赖补全使 FastAPI 可启动 | bugfix | 其他 | 未知 | [链接](changes/2026-02-15__backend-deps-bootstrap.md) |
|
||||
|
||||
### 管理后台
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 影响模块 | 风险 | 详情 |
|
||||
|------|----------|----------|----------|------|------|
|
||||
| 2026-03-24 | 变更审计记录：P18 任务引擎运营看板实施 | bugfix | 其他, 文档, 脚本工具 | 未知 | [链接](changes/2026-03-24__p18-task-engine-dashboard.md) |
|
||||
| 2026-02-28 | 变更审计记录：多模块累积变更（营业日/核心业务/认证/ETL DWS 重构/参考文档合并） | 重构 | 其他 | 未知 | [链接](changes/2026-02-28__multi-module-accumulated-changes.md) |
|
||||
|
||||
### 小程序
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 影响模块 | 风险 | 详情 |
|
||||
|------|----------|----------|----------|------|------|
|
||||
| 2026-03-29 | 变更审计记录：助教详情页样式修复 + 数据聚合修复 + 关系指数回测支持 | bugfix | 其他 | 未知 | [链接](changes/2026-03-29__coach-detail-style-aggregation-fix.md) |
|
||||
| 2026-03-27 | 变更审计记录：board-finance 双重格式化修复 | bugfix | 其他 | 低 | [链接](changes/2026-03-27__board-finance-double-format-fix.md) |
|
||||
| 2026-03-24 | 变更审计记录：小程序登录页头像昵称获取功能（前端实施） | 文档 | 其他, 文档 | 低 | [链接](changes/2026-03-24__miniprogram-avatar-nickname-feature.md) |
|
||||
| 2026-03-13 | 审计记录：board-finance line-height 全量补齐 | bugfix | 其他, 文档 | 低 | [链接](changes/2026-03-13__board-finance-line-height-audit.md) |
|
||||
|
||||
### 桌面GUI
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 影响模块 | 风险 | 详情 |
|
||||
|------|----------|----------|----------|------|------|
|
||||
| 2026-02-13 | 审计记录：移除旧版指数（RECALL/INTIMACY）+ ML last-touch 清理 | bugfix | DWS 层, GUI, 其他, 数据库, 文档, 测试, 调度 | 低 | [链接](changes/2026-02-13__remove-legacy-index-cleanup.md) |
|
||||
|
||||
### 共享包
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 影响模块 | 风险 | 详情 |
|
||||
|------|----------|----------|----------|------|------|
|
||||
| 2026-02-27 | 变更审计：营业日分割规则 PRD 同步检查 + 全栈集成收口 | bugfix | API 层, DWD 层, DWS 层, 其他, 调度, 质量校验, 配置 | 低 | [链接](changes/2026-02-27__biz-day-cutoff-prd-sync-check.md) |
|
||||
|
||||
### 跨库(FDW)
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 影响模块 | 风险 | 详情 |
|
||||
|------|----------|----------|----------|------|------|
|
||||
| 2026-02-27 | 变更审计：营业日分割规则 PRD 同步检查 + 全栈集成收口 | bugfix | API 层, DWD 层, DWS 层, 其他, 调度, 质量校验, 配置 | 低 | [链接](changes/2026-02-27__biz-day-cutoff-prd-sync-check.md) |
|
||||
|
||||
### 项目级
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 影响模块 | 风险 | 详情 |
|
||||
|------|----------|----------|----------|------|------|
|
||||
| 2026-04-08 | 变更审计记录：Fix-13 回滚手动完成 + 广义召回完成机制 | bugfix | 其他 | 低 | [链接](changes/2026-04-08__fix13-recall-events-refactor.md) |
|
||||
| 2026-04-20 | 变更审计记录：2026-04-20 历史累积批次预审 | bugfix | 其他 | 高 | [链接](changes/2026-04-20__historical-batch-pre-audit.md) |
|
||||
| 2026-04-15 | 变更审计记录：美团结算导入 + core 层定位 + CORE_DIM_SYNC 任务 | bugfix | 其他 | 低 | [链接](changes/2026-04-15__meituan-settle-core-sync.md) |
|
||||
| 2026-04-06 | 变更审计记录：v1 历史清理与 DDL 合并归档 | 清理 | 其他 | 极低 | [链接](changes/2026-04-06__v1-cleanup-ddl-consolidation.md) |
|
||||
| 2026-04-05 | 变更审计记录：Kiro → Claude Code 全量迁移 | 文档 | 其他 | 低 | [链接](changes/2026-04-05__kiro-to-claude-code-migration.md) |
|
||||
| 2026-03-31 | 变更审计记录：任务引擎改造 — 参数调优 + 客户级升级/转移 + 任务统计写入 | 功能 | 其他 | 未知 | [链接](changes/2026-03-31__task-engine-overhaul.md) |
|
||||
| 2026-03-29 | 变更审计记录：助教看板和客户看板懒加载（分页加载） | 重构 | 其他 | 未知 | [链接](changes/2026-03-29__board-lazy-loading-pagination.md) |
|
||||
| 2026-03-29 | 变更审计记录：助教详情页 API 500 修复（Schema 字段名对齐） | bugfix | 其他 | 未知 | [链接](changes/2026-03-29__coach-detail-500-field-name-fix.md) |
|
||||
| 2026-03-29 | 变更审计记录：助教详情页设计稿对齐 + 数据格式化修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-29__coach-detail-design-alignment.md) |
|
||||
| 2026-03-29 | 变更审计记录：DWS_TASK_ENGINE ETL 编排替代 fire_event 事件链 | 功能 | 其他 | 未知 | [链接](changes/2026-03-29__dws-task-engine-etl-orchestration.md) |
|
||||
| 2026-03-29 | 变更审计记录：修复 recall_completion_check 事件链断裂 | bugfix | 其他 | 未知 | [链接](changes/2026-03-29__fix-recall-completion-event-chain.md) |
|
||||
| 2026-03-28 | 变更审计记录：财务看板 5 项修复（ODS 行膨胀 / 优惠分摊 / 环比字段 / 区域过滤 / 规范沉淀） | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-28__board-finance-5fixes.md) |
|
||||
| 2026-03-28 | 变更审计记录：财务看板 DWS 区域维度重构审计 | 重构 | 其他 | 未知 | [链接](changes/2026-03-28__board-finance-dws-area-refactor-audit.md) |
|
||||
| 2026-03-28 | 变更审计记录：修复小程序登录落地页跳转失效 | bugfix | 其他 | 未知 | [链接](changes/2026-03-28__fix-miniprogram-login-landing-page.md) |
|
||||
| 2026-03-27 | 变更审计记录：财务看板 Phase 2 对齐 Demo（T1-T6） | bugfix | 其他 | 未知 | [链接](changes/2026-03-27__board-finance-phase2-t1-t6.md) |
|
||||
| 2026-03-27 | 变更审计记录：board-finance WXML 格式化迁移 + 动态 Tab + 加载态清理 | bugfix | 其他 | 未知 | [链接](changes/2026-03-27__board-finance-wxml-format-tabs-cleanup.md) |
|
||||
| 2026-03-27 | 变更审计记录：小程序权限体系统一改造（W1-W5） | 功能 | 其他 | 未知 | [链接](changes/2026-03-27__miniprogram-permission-unification.md) |
|
||||
| 2026-03-27 | 变更审计记录：任务列表近60天数据展示 + WXML 格式化改造 | 重构 | 其他 | 高 | [链接](changes/2026-03-27__task-list-recent60d-and-wxml-formatting.md) |
|
||||
| 2026-03-26 | 审计记录：ETL 缺失字段补充 — 第一阶段（DDL + FACT_MAPPINGS） | 功能 | 其他 | 低 | [链接](changes/2026-03-26__etl-missing-fields-phase1-ddl-mappings.md) |
|
||||
| 2026-03-26 | 变更审计记录：到手金额口径修复（全小程序统一） | bugfix | 其他 | 未知 | [链接](changes/2026-03-26__net-income-calibration-all-pages.md) |
|
||||
| 2026-03-25 | 变更审计记录：保底 relationship_building 任务生成 | bugfix | 其他 | 未知 | [链接](changes/2026-03-25__baseline-relationship-building-tasks.md) |
|
||||
| 2026-03-25 | 变更审计记录：保底任务生成独立连接修复 | bugfix | 其他 | 高 | [链接](changes/2026-03-25__baseline-task-independent-connection-fix.md) |
|
||||
| 2026-03-25 | 变更审计记录：绩效页→任务详情页按 member_id 查询任务 | 文档 | 其他 | 未知 | [链接](changes/2026-03-25__perf-to-task-detail-member-query.md) |
|
||||
| 2026-03-25 | 绩效页 WXML 缺少 data-member-id 导致任务详情页空白 | bugfix | 其他 | 未知 | [链接](changes/2026-03-25__perf-wxml-missing-member-id.md) |
|
||||
| 2026-03-25 | 变更审计记录（Change Audit Record） | bugfix | 其他 | 未知 | [链接](changes/2026-03-25__task-detail-service-records-6-improvements.md) |
|
||||
| 2026-03-25 | 变更审计记录：租户用户审核 — 软删除恢复 upsert 修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-25__tenant-users-soft-delete-upsert-fix.md) |
|
||||
| 2026-03-24 | 变更审计记录：补录 cfg_skill_type 缺失的 3 条课程类型配置 | bugfix | 其他 | 未知 | [链接](changes/2026-03-24__add_missing_cfg_skill_type.md) |
|
||||
| 2026-03-24 | 审计记录：迁移脚本合并到主 DDL 并归档 | 文档 | 其他, 文档 | 低 | [链接](changes/2026-03-24__ddl-migration-merge-and-archive.md) |
|
||||
| 2026-03-24 | 变更审计记录：lookback_days 从 60 天扩大到 90 天 | 文档 | 其他 | 未知 | [链接](changes/2026-03-24__lookback_days_60_to_90.md) |
|
||||
| 2026-03-24 | 变更审计记录：小程序登录页头像昵称获取功能（前端实施） | 文档 | 其他, 文档 | 低 | [链接](changes/2026-03-24__miniprogram-avatar-nickname-feature.md) |
|
||||
| 2026-03-24 | 变更审计记录：绩效页数据正确性修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-24__perf-page-data-fix.md) |
|
||||
| 2026-03-24 | 审计记录：审核弹窗头像展示 + 排版优化 | 功能 | 其他 | 低 | [链接](changes/2026-03-24__review-modal-avatar-layout.md) |
|
||||
| 2026-03-24 | 变更审计记录：user_site_roles / user_assistant_binding 软删除实施 | 文档 | 其他 | 未知 | [链接](changes/2026-03-24__soft-delete-user-site-roles-binding.md) |
|
||||
| 2026-03-24 | 变更审计记录：TriggerJobs 清空任务交互反馈优化 | 清理 | 其他 | 高 | [链接](changes/2026-03-24__trigger-jobs-clear-task-interaction.md) |
|
||||
| 2026-03-23 | 变更审计记录：DDL 合并 — rejection_count + cancelled 状态 | 文档 | 其他 | 未知 | [链接](changes/2026-03-23__ddl-merge-rejection-count-cancelled.md) |
|
||||
| 2026-03-23 | 变更审计记录：禁用用户改为移除用户 + 小程序鉴权两层模型修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-23__disable-to-remove-user-auth-model-fix.md) |
|
||||
| 2026-03-23 | 变更审计记录：店铺筛选 + 时间格式 + 姓名格式 + 李小燕确认 | bugfix | 其他 | 未知 | [链接](changes/2026-03-23__mysites-tenant-filter-time-format-nickname-display.md) |
|
||||
| 2026-03-23 | 变更审计记录：审核弹窗手机号不显示修复 + 自动匹配优化 + 身份标签中文化 | bugfix | 其他 | 未知 | [链接](changes/2026-03-23__review-modal-phone-display-auto-match-identity-label.md) |
|
||||
| 2026-03-23 | 变更审计记录（Change Audit Record） | 功能 | 其他 | 未知 | [链接](changes/2026-03-23__role-routing-page-guard.md) |
|
||||
| 2026-03-23 | 变更审计记录：租户管理员用户名大小写不敏感 | 功能 | 其他 | 未知 | [链接](changes/2026-03-23__tenant-admin-case-insensitive-username.md) |
|
||||
| 2026-03-23 | 变更审计记录：租户管理后台审核弹窗改造（角色动态化 + 人员列表联动 + 手机号自动匹配） | bugfix | 其他 | 未知 | [链接](changes/2026-03-23__tenant-admin-review-modal-dynamic-roles.md) |
|
||||
| 2026-03-23 | 变更审计记录：根治 tenant_admin 的 managed_site_ids 限制（跨模块权限验证改造） | bugfix | 其他 | 未知 | [链接](changes/2026-03-23__tenant-admin-site-access-root-fix.md) |
|
||||
| 2026-03-23 | 变更审计记录：租户后台申请列表店铺筛选 + admin-web 简写ID修复 | bugfix | 其他 | 高 | [链接](changes/2026-03-23__tenant-user-approval-site-filter.md) |
|
||||
| 2026-03-23 | 变更审计记录：Task 6 Change B/C — 定时任务管理页面 + 小程序清理 | bugfix | 其他 | 未知 | [链接](changes/2026-03-23__trigger-jobs-admin-web-miniprogram-cleanup.md) |
|
||||
| 2026-03-22 | 变更审计记录：数据库字段走查批量修复 | bugfix | 其他 | 低 | [链接](changes/2026-03-22__db-field-walkthrough-batch-fix.md) |
|
||||
| 2026-03-22 | 变更审计记录：dev-trace-log 全栈开发调试全链路日志系统 | 清理 | 其他 | 低 | [链接](changes/2026-03-22__dev-trace-log-fullstack-feature.md) |
|
||||
| 2026-03-22 | 变更审计记录：NS4 DDL 合并 — deleted_at 字段并入主迁移脚本 | 文档 | 其他 | 未知 | [链接](changes/2026-03-22__ns4-ddl-merge-deleted-at.md) |
|
||||
| 2026-03-22 | 审计记录：P14 Task 15 — 最终检查点完成 | bugfix | 其他, 脚本工具 | 极低 | [链接](changes/2026-03-22__p14-task15-final-checkpoint.md) |
|
||||
| 2026-03-22 | 变更审计记录：trace 日志路径修复 + 小程序登录竞态修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-22__trace-path-fix-miniprogram-login-race.md) |
|
||||
| 2026-03-22 | 变更审计记录：僵尸任务修复 + 优雅关闭 + 重新执行按钮 | bugfix | 其他 | 未知 | [链接](changes/2026-03-22__zombie-task-graceful-shutdown-rerun.md) |
|
||||
| 2026-03-20 | 变更审计记录：ai-prompt-refinement spec 完成 + board-coach Mock 精简 | bugfix | 其他 | 未知 | [链接](changes/2026-03-20__ai-prompt-refinement-board-coach-mock.md) |
|
||||
| 2026-03-20 | H2 修复：FDW → 直连 ETL 架构统一 | bugfix | 其他 | 未知 | [链接](changes/2026-03-20__h2-fdw-to-direct-etl-unification.md) |
|
||||
| 2026-03-20 | 审计记录：小程序文档同步更新 | bugfix | 其他 | 极低 | [链接](changes/2026-03-20__miniprogram-docs-sync.md) |
|
||||
| 2026-03-20 | RNS1 系列 AI 自主决策风险审计报告（完整版） | bugfix | 其他 | 高 | [链接](changes/2026-03-20__rns1-ai-autonomous-decision-risk-audit.md) |
|
||||
| 2026-03-20 | 变更审计记录：RNS1.3 三看板 FDW 查询层数据口径修复 | bugfix | 其他, 文档 | 未知 | [链接](changes/2026-03-20__rns13-board-apis-e2e-fix.md) |
|
||||
| 2026-03-20 | 变更审计记录：RNS1.4 CHAT 模块重建 + FDW→直连统一 + R3 筛选修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-20__rns14-chat-fdw-filter-audit.md) |
|
||||
| 2026-03-20 | 变更审计记录：RNS1.4 CHAT 模块迁移 + R3 项目类型筛选重建 | bugfix | 其他 | 高 | [链接](changes/2026-03-20__rns14-chat-module-r3-filter-rebuild.md) |
|
||||
| 2026-03-19 | 变更审计记录：coach_service 绩效档位硬编码修复 | bugfix | 其他 | 低 | [链接](changes/2026-03-19__coach-tier-hardcode-fix.md) |
|
||||
| 2026-03-19 | 数据库变更审计：RNS1.2 客户与助教接口 | 文档 | 其他 | 低 | [链接](changes/2026-03-19__rns12-db-audit.md) |
|
||||
| 2026-03-18 | RNS1.1 E2E 测试 — FDW 直连改造 + performance_service bug 修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-18__rns1-e2e-fdw-direct-connect-bugfix.md) |
|
||||
| 2026-03-15 | 变更审计记录：DDL 基线统一整理 + BD 手册重组 + 小程序副本清理 | bugfix | 其他 | 低 | [链接](changes/2026-03-15__ddl-baseline-consolidation-bd-manual-reorg.md) |
|
||||
| 2026-03-13 | 审计记录：board-finance.wxss rpx 换算公式修正 | 功能 | 其他 | 未知 | [链接](changes/2026-03-13__board-finance-rpx-formula-correction.md) |
|
||||
| 2026-03-13 | 变更审计记录：task-list 页面 H5 原型 1:1 重写 | bugfix | 其他 | 未知 | [链接](changes/2026-03-13__task-list-h5-rewrite.md) |
|
||||
| 2026-03-12 | 变更审计记录：board-finance WXSS 视觉校对（四轮） | bugfix | 其他 | 未知 | [链接](changes/2026-03-12__board-finance-overview-wxss-calibration.md) |
|
||||
| 2026-03-12 | 变更审计记录：小程序前端开发文档体系收尾（步骤 1-4） | 文档 | 其他 | 低 | [链接](changes/2026-03-12__miniprogram-dev-docs-finalize.md) |
|
||||
| 2026-03-12 | 变更审计记录：多模块累积变更 — AI 对话系统 + 任务防御 + 小程序 UI 重构 + ETL DWS | bugfix | 其他 | 未知 | [链接](changes/2026-03-12__multi-module-ai-taskdefense-miniprogram-etl.md) |
|
||||
| 2026-03-12 | 变更审计记录：pixel-audit 结构化审计方法论替换像素对比 | 文档 | 其他 | 未知 | [链接](changes/2026-03-12__pixel-audit-structured-methodology.md) |
|
||||
| 2026-03-10 | 变更审计记录：多模块累积变更 — AI 应用骨架 + 任务队列防卡死 + 小程序页面迁移 | bugfix | 其他 | 未知 | [链接](changes/2026-03-10__multi-module-ai-apps-task-defense-miniprogram.md) |
|
||||
| 2026-03-07 | 变更审计记录：TASK 3 项目标签计算逻辑 — 文档与配置同步 | 文档 | 其他 | 低 | [链接](changes/2026-03-07__task3-project-tag-docs-sync.md) |
|
||||
| 2026-03-06 | 变更审计记录：修复 RecordingAPIClient 缺少 post 方法 | bugfix | 其他 | 极低 | [链接](changes/2026-03-06__fix-api-client-post-method.md) |
|
||||
| 2026-03-06 | 变更审计记录：修复 DatabaseOperations 缺少 _dsn 属性导致 DWD 并行装载全部失败 | bugfix | 其他 | 极低 | [链接](changes/2026-03-06__fix-db-operations-dsn-proxy.md) |
|
||||
| 2026-03-04 | 变更审计记录：全栈累积变更（营业日配置、WebSocket 日志、微信认证、仓库清理） | 重构 | 其他 | 高 | [链接](changes/2026-03-04__fullstack-accumulated-changes.md) |
|
||||
| 2026-03-03 | 变更审计记录：微信小程序开发调试面板 | 文档 | 其他 | 低 | [链接](changes/2026-03-03__miniprogram-dev-debug-panel.md) |
|
||||
| 2026-03-02 | 变更审计：合并 ETL Hook 为统一分析入口 | 文档 | 其他, 脚本工具 | 未知 | [链接](changes/2026-03-02__etl-unified-analysis-hook-merge.md) |
|
||||
| 2026-03-02 | SPI 基数校准改用非零样本中位数 | 功能 | 其他 | 未知 | [链接](changes/2026-03-02__spi-calibration-nonzero-median.md) |
|
||||
| 2026-03-01 | 审计记录：DWD 清理 + ODS 商品销售修复 + dim_staff_ex 修复 | bugfix | 其他 | 未知 | [链接](changes/2026-03-01__dwd-cleanup-ods-fix-dim-staff-repair.md) |
|
||||
| 2026-03-01 | 变更审计：DWS numeric 精度扩展 + ODS 库存 siteid 注入 | 文档 | 其他 | 低 | [链接](changes/2026-03-01__dws-numeric-precision-ods-siteid-fix.md) |
|
||||
| 2026-02-27 | 变更审计：营业日分割规则 PRD 同步检查 + 全栈集成收口 | bugfix | API 层, DWD 层, DWS 层, 其他, 调度, 质量校验, 配置 | 低 | [链接](changes/2026-02-27__biz-day-cutoff-prd-sync-check.md) |
|
||||
| 2026-02-27 | 审计记录：P4 小程序核心业务路由 + 触发器注册 | 重构 | 其他 | 未知 | [链接](changes/2026-02-27__p4-core-business-routes-triggers.md) |
|
||||
| 2026-02-26 | 审计记录：ETL Bug 修复 — dim_staff_ex 列映射 + assistant_daily table_area_name | bugfix | 其他 | 未知 | [链接](changes/2026-02-26__etl-bugfix-dim-staff-rankname-assistant-daily-table-area.md) |
|
||||
| 2026-02-26 | 变更审计：P1/P2/P3 全栈集成（DB 基础 + ETL DWS 扩展 + 小程序鉴权） | bugfix | 其他 | 低 | [链接](changes/2026-02-26__p1-p2-p3-fullstack-integration.md) |
|
||||
| 2026-02-26 | 审计记录：维客线索重构（member_birthday_manual → member_retention_clue） | 重构 | 其他 | 未知 | [链接](changes/2026-02-26__retention-clue-refactor.md) |
|
||||
| 2026-02-26 | 审计记录：root-file — .gitignore 更新与 H5 UI / 临时文件清理 | 重构 | 其他 | 高 | [链接](changes/2026-02-26__root-file-gitignore-h5ui-cleanup.md) |
|
||||
| 2026-02-15 | 审计记录：管理后台全量实现 + DB Schema 迁移 + 审计产物重组 | 清理 | 其他 | 高 | [链接](changes/2026-02-15__admin-web-console-db-migration-audit-reorg.md) |
|
||||
| 2026-02-15 | 变更审计记录（Change Audit Record） | 文档 | 其他, 文档, 质量校验 | 极低 | [链接](changes/2026-02-15__audit-consolidation-doc-reorg.md) |
|
||||
| 2026-02-15 | 审计记录：docs/bd_manual + docs/dictionary → docs/database 合并 | 清理 | 其他, 文档, 脚本工具 | 极低 | [链接](changes/2026-02-15__docs-database-merge.md) |
|
||||
@@ -343,14 +112,12 @@
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 风险 | 详情 |
|
||||
|------|----------|----------|------|------|
|
||||
| 2026-02-27 | 变更审计：营业日分割规则 PRD 同步检查 + 全栈集成收口 | bugfix | 低 | [链接](changes/2026-02-27__biz-day-cutoff-prd-sync-check.md) |
|
||||
| 2026-02-14 | 审计记录：api/recording_client.py 默认时区修正 | 功能 | 极低 | [链接](changes/2026-02-14__recording-client-timezone-fix.md) |
|
||||
|
||||
### DWD 层
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 风险 | 详情 |
|
||||
|------|----------|----------|------|------|
|
||||
| 2026-02-27 | 变更审计：营业日分割规则 PRD 同步检查 + 全栈集成收口 | bugfix | 低 | [链接](changes/2026-02-27__biz-day-cutoff-prd-sync-check.md) |
|
||||
| 2026-02-14 | 审计记录：删除 DWD 层 dwd_settlement_head_ex.settle_list 冗余列 | 清理 | 未知 | [链接](changes/2026-02-14__drop-dwd-settle-list.md) |
|
||||
| 2026-02-14 | 审计记录：删除 ODS 层 settlelist 冗余列 | bugfix | 未知 | [链接](changes/2026-02-14__drop-ods-settlelist.md) |
|
||||
|
||||
@@ -358,7 +125,6 @@
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 风险 | 详情 |
|
||||
|------|----------|----------|------|------|
|
||||
| 2026-02-27 | 变更审计：营业日分割规则 PRD 同步检查 + 全栈集成收口 | bugfix | 低 | [链接](changes/2026-02-27__biz-day-cutoff-prd-sync-check.md) |
|
||||
| 2026-02-14 | 审计记录：DWS 基类 bugfix — 绩效档位兜底 + safe_decimal 异常捕获 | bugfix | 未知 | [链接](changes/2026-02-14__dws-bugfix-tier-safedecimal.md) |
|
||||
| 2026-02-13 | 审计记录：移除旧版指数（RECALL/INTIMACY）+ ML last-touch 清理 | bugfix | 低 | [链接](changes/2026-02-13__remove-legacy-index-cleanup.md) |
|
||||
|
||||
@@ -372,101 +138,9 @@
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 风险 | 详情 |
|
||||
|------|----------|----------|------|------|
|
||||
| 2026-04-08 | 变更审计记录：Fix-13 回滚手动完成 + 广义召回完成机制 | bugfix | 低 | [链接](changes/2026-04-08__fix13-recall-events-refactor.md) |
|
||||
| 2026-04-20 | 变更审计记录：2026-04-20 历史累积批次预审 | bugfix | 高 | [链接](changes/2026-04-20__historical-batch-pre-audit.md) |
|
||||
| 2026-04-15 | 变更审计记录：美团结算导入 + core 层定位 + CORE_DIM_SYNC 任务 | bugfix | 低 | [链接](changes/2026-04-15__meituan-settle-core-sync.md) |
|
||||
| 2026-04-06 | 变更审计记录：v1 历史清理与 DDL 合并归档 | 清理 | 极低 | [链接](changes/2026-04-06__v1-cleanup-ddl-consolidation.md) |
|
||||
| 2026-04-05 | 变更审计记录：Kiro → Claude Code 全量迁移 | 文档 | 低 | [链接](changes/2026-04-05__kiro-to-claude-code-migration.md) |
|
||||
| 2026-03-31 | 变更审计记录：任务引擎改造 — 参数调优 + 客户级升级/转移 + 任务统计写入 | 功能 | 未知 | [链接](changes/2026-03-31__task-engine-overhaul.md) |
|
||||
| 2026-03-29 | 变更审计记录：助教看板和客户看板懒加载（分页加载） | 重构 | 未知 | [链接](changes/2026-03-29__board-lazy-loading-pagination.md) |
|
||||
| 2026-03-29 | 变更审计记录：助教详情页 API 500 修复（Schema 字段名对齐） | bugfix | 未知 | [链接](changes/2026-03-29__coach-detail-500-field-name-fix.md) |
|
||||
| 2026-03-29 | 变更审计记录：助教详情页设计稿对齐 + 数据格式化修复 | bugfix | 未知 | [链接](changes/2026-03-29__coach-detail-design-alignment.md) |
|
||||
| 2026-03-29 | 变更审计记录：助教详情页样式修复 + 数据聚合修复 + 关系指数回测支持 | bugfix | 未知 | [链接](changes/2026-03-29__coach-detail-style-aggregation-fix.md) |
|
||||
| 2026-03-29 | 变更审计记录：DWS_TASK_ENGINE ETL 编排替代 fire_event 事件链 | 功能 | 未知 | [链接](changes/2026-03-29__dws-task-engine-etl-orchestration.md) |
|
||||
| 2026-03-29 | 变更审计记录：修复 recall_completion_check 事件链断裂 | bugfix | 未知 | [链接](changes/2026-03-29__fix-recall-completion-event-chain.md) |
|
||||
| 2026-03-28 | 变更审计记录：财务看板 5 项修复（ODS 行膨胀 / 优惠分摊 / 环比字段 / 区域过滤 / 规范沉淀） | bugfix | 未知 | [链接](changes/2026-03-28__board-finance-5fixes.md) |
|
||||
| 2026-03-28 | 变更审计记录：财务看板 DWS 区域维度重构审计 | 重构 | 未知 | [链接](changes/2026-03-28__board-finance-dws-area-refactor-audit.md) |
|
||||
| 2026-03-28 | 变更审计记录：修复小程序登录落地页跳转失效 | bugfix | 未知 | [链接](changes/2026-03-28__fix-miniprogram-login-landing-page.md) |
|
||||
| 2026-03-27 | 变更审计记录：board-finance 双重格式化修复 | bugfix | 低 | [链接](changes/2026-03-27__board-finance-double-format-fix.md) |
|
||||
| 2026-03-27 | 审计记录：board-finance-integration 阶段 2（后端 API 修复） | bugfix | 未知 | [链接](changes/2026-03-27__board-finance-integration-T2.md) |
|
||||
| 2026-03-27 | 变更审计记录：财务看板 Phase 2 对齐 Demo（T1-T6） | bugfix | 未知 | [链接](changes/2026-03-27__board-finance-phase2-t1-t6.md) |
|
||||
| 2026-03-27 | 变更审计记录：board-finance WXML 格式化迁移 + 动态 Tab + 加载态清理 | bugfix | 未知 | [链接](changes/2026-03-27__board-finance-wxml-format-tabs-cleanup.md) |
|
||||
| 2026-03-27 | 变更审计记录：小程序权限体系统一改造（W1-W5） | 功能 | 未知 | [链接](changes/2026-03-27__miniprogram-permission-unification.md) |
|
||||
| 2026-03-27 | 变更审计记录：任务列表近60天数据展示 + WXML 格式化改造 | 重构 | 高 | [链接](changes/2026-03-27__task-list-recent60d-and-wxml-formatting.md) |
|
||||
| 2026-03-26 | 审计记录：ETL 缺失字段补充 — 第一阶段（DDL + FACT_MAPPINGS） | 功能 | 低 | [链接](changes/2026-03-26__etl-missing-fields-phase1-ddl-mappings.md) |
|
||||
| 2026-03-26 | 变更审计记录：到手金额口径修复（全小程序统一） | bugfix | 未知 | [链接](changes/2026-03-26__net-income-calibration-all-pages.md) |
|
||||
| 2026-03-25 | 变更审计记录：保底 relationship_building 任务生成 | bugfix | 未知 | [链接](changes/2026-03-25__baseline-relationship-building-tasks.md) |
|
||||
| 2026-03-25 | 变更审计记录：保底任务生成独立连接修复 | bugfix | 高 | [链接](changes/2026-03-25__baseline-task-independent-connection-fix.md) |
|
||||
| 2026-03-25 | 变更审计记录：绩效页→任务详情页按 member_id 查询任务 | 文档 | 未知 | [链接](changes/2026-03-25__perf-to-task-detail-member-query.md) |
|
||||
| 2026-03-25 | 绩效页 WXML 缺少 data-member-id 导致任务详情页空白 | bugfix | 未知 | [链接](changes/2026-03-25__perf-wxml-missing-member-id.md) |
|
||||
| 2026-03-25 | 变更审计记录（Change Audit Record） | bugfix | 未知 | [链接](changes/2026-03-25__task-detail-service-records-6-improvements.md) |
|
||||
| 2026-03-25 | 变更审计记录：租户用户审核 — 软删除恢复 upsert 修复 | bugfix | 未知 | [链接](changes/2026-03-25__tenant-users-soft-delete-upsert-fix.md) |
|
||||
| 2026-03-24 | 变更审计记录：补录 cfg_skill_type 缺失的 3 条课程类型配置 | bugfix | 未知 | [链接](changes/2026-03-24__add_missing_cfg_skill_type.md) |
|
||||
| 2026-03-24 | 审计记录：迁移脚本合并到主 DDL 并归档 | 文档 | 低 | [链接](changes/2026-03-24__ddl-migration-merge-and-archive.md) |
|
||||
| 2026-03-24 | 审计记录：修复小程序前端档位进度条无刻度 + bonus_money 计算 | bugfix | 低 | [链接](changes/2026-03-24__fix-tier-nodes-empty-progress-bar.md) |
|
||||
| 2026-03-24 | 变更审计记录：lookback_days 从 60 天扩大到 90 天 | 文档 | 未知 | [链接](changes/2026-03-24__lookback_days_60_to_90.md) |
|
||||
| 2026-03-24 | 变更审计记录：小程序登录页头像昵称获取功能（前端实施） | 文档 | 低 | [链接](changes/2026-03-24__miniprogram-avatar-nickname-feature.md) |
|
||||
| 2026-03-24 | 变更审计记录：P17 助教客户归属与任务生成引擎 | bugfix | 未知 | [链接](changes/2026-03-24__p17-assistant-ownership-task-engine.md) |
|
||||
| 2026-03-24 | 变更审计记录：P18 任务引擎运营看板实施 | bugfix | 未知 | [链接](changes/2026-03-24__p18-task-engine-dashboard.md) |
|
||||
| 2026-03-24 | 变更审计记录：绩效页数据正确性修复 | bugfix | 未知 | [链接](changes/2026-03-24__perf-page-data-fix.md) |
|
||||
| 2026-03-24 | 审计记录：审核弹窗头像展示 + 排版优化 | 功能 | 低 | [链接](changes/2026-03-24__review-modal-avatar-layout.md) |
|
||||
| 2026-03-24 | 变更审计记录：user_site_roles / user_assistant_binding 软删除实施 | 文档 | 未知 | [链接](changes/2026-03-24__soft-delete-user-site-roles-binding.md) |
|
||||
| 2026-03-24 | 变更审计记录：TriggerJobs 清空任务交互反馈优化 | 清理 | 高 | [链接](changes/2026-03-24__trigger-jobs-clear-task-interaction.md) |
|
||||
| 2026-03-23 | 变更审计记录：DDL 合并 — rejection_count + cancelled 状态 | 文档 | 未知 | [链接](changes/2026-03-23__ddl-merge-rejection-count-cancelled.md) |
|
||||
| 2026-03-23 | 变更审计记录：禁用用户改为移除用户 + 小程序鉴权两层模型修复 | bugfix | 未知 | [链接](changes/2026-03-23__disable-to-remove-user-auth-model-fix.md) |
|
||||
| 2026-03-23 | 变更审计记录：店铺筛选 + 时间格式 + 姓名格式 + 李小燕确认 | bugfix | 未知 | [链接](changes/2026-03-23__mysites-tenant-filter-time-format-nickname-display.md) |
|
||||
| 2026-03-23 | 变更审计记录：审核弹窗手机号不显示修复 + 自动匹配优化 + 身份标签中文化 | bugfix | 未知 | [链接](changes/2026-03-23__review-modal-phone-display-auto-match-identity-label.md) |
|
||||
| 2026-03-23 | 变更审计记录（Change Audit Record） | 功能 | 未知 | [链接](changes/2026-03-23__role-routing-page-guard.md) |
|
||||
| 2026-03-23 | 变更审计记录：租户管理员用户名大小写不敏感 | 功能 | 未知 | [链接](changes/2026-03-23__tenant-admin-case-insensitive-username.md) |
|
||||
| 2026-03-23 | 变更审计记录：租户管理后台审核弹窗改造（角色动态化 + 人员列表联动 + 手机号自动匹配） | bugfix | 未知 | [链接](changes/2026-03-23__tenant-admin-review-modal-dynamic-roles.md) |
|
||||
| 2026-03-23 | 变更审计记录：根治 tenant_admin 的 managed_site_ids 限制（跨模块权限验证改造） | bugfix | 未知 | [链接](changes/2026-03-23__tenant-admin-site-access-root-fix.md) |
|
||||
| 2026-03-23 | 变更审计记录：租户后台申请列表店铺筛选 + admin-web 简写ID修复 | bugfix | 高 | [链接](changes/2026-03-23__tenant-user-approval-site-filter.md) |
|
||||
| 2026-03-23 | 变更审计记录：Task 6 Change B/C — 定时任务管理页面 + 小程序清理 | bugfix | 未知 | [链接](changes/2026-03-23__trigger-jobs-admin-web-miniprogram-cleanup.md) |
|
||||
| 2026-03-22 | 变更审计记录：数据库字段走查批量修复 | bugfix | 低 | [链接](changes/2026-03-22__db-field-walkthrough-batch-fix.md) |
|
||||
| 2026-03-22 | 变更审计记录：DDL vs 数据库结构对比修复 + BD 手册全面审核走查 | bugfix | 未知 | [链接](changes/2026-03-22__ddl-db-structure-diff-bd-manual-audit.md) |
|
||||
| 2026-03-22 | 变更审计记录（Change Audit Record） | bugfix | 未知 | [链接](changes/2026-03-22__ddl_bd_manual_consistency_fix.md) |
|
||||
| 2026-03-22 | 变更审计记录：dev-trace-log 全栈开发调试全链路日志系统 | 清理 | 低 | [链接](changes/2026-03-22__dev-trace-log-fullstack-feature.md) |
|
||||
| 2026-03-22 | 变更审计记录：NS4 DDL 合并 — deleted_at 字段并入主迁移脚本 | 文档 | 未知 | [链接](changes/2026-03-22__ns4-ddl-merge-deleted-at.md) |
|
||||
| 2026-03-22 | 审计记录：P14 Task 15 — 最终检查点完成 | bugfix | 极低 | [链接](changes/2026-03-22__p14-task15-final-checkpoint.md) |
|
||||
| 2026-03-22 | 变更审计记录：trace 日志路径修复 + 小程序登录竞态修复 | bugfix | 未知 | [链接](changes/2026-03-22__trace-path-fix-miniprogram-login-race.md) |
|
||||
| 2026-03-22 | 变更审计记录：僵尸任务修复 + 优雅关闭 + 重新执行按钮 | bugfix | 未知 | [链接](changes/2026-03-22__zombie-task-graceful-shutdown-rerun.md) |
|
||||
| 2026-03-20 | 变更审计记录：ai-prompt-refinement spec 完成 + board-coach Mock 精简 | bugfix | 未知 | [链接](changes/2026-03-20__ai-prompt-refinement-board-coach-mock.md) |
|
||||
| 2026-03-20 | H2 修复：FDW → 直连 ETL 架构统一 | bugfix | 未知 | [链接](changes/2026-03-20__h2-fdw-to-direct-etl-unification.md) |
|
||||
| 2026-03-20 | 审计记录：小程序文档同步更新 | bugfix | 极低 | [链接](changes/2026-03-20__miniprogram-docs-sync.md) |
|
||||
| 2026-03-20 | 变更审计记录：R3 项目类型筛选接口重建（fetchSkillTypes / cfg_area_category） | bugfix | 高 | [链接](changes/2026-03-20__r3-skill-type-filter-rebuild.md) |
|
||||
| 2026-03-20 | RNS1 系列 AI 自主决策风险审计报告（完整版） | bugfix | 高 | [链接](changes/2026-03-20__rns1-ai-autonomous-decision-risk-audit.md) |
|
||||
| 2026-03-20 | 变更审计记录：RNS1.3 三看板 FDW 查询层数据口径修复 | bugfix | 未知 | [链接](changes/2026-03-20__rns13-board-apis-e2e-fix.md) |
|
||||
| 2026-03-20 | 变更审计记录：RNS1.4 CHAT 模块重建 + FDW→直连统一 + R3 筛选修复 | bugfix | 未知 | [链接](changes/2026-03-20__rns14-chat-fdw-filter-audit.md) |
|
||||
| 2026-03-20 | 变更审计记录：RNS1.4 CHAT 模块迁移 + R3 项目类型筛选重建 | bugfix | 高 | [链接](changes/2026-03-20__rns14-chat-module-r3-filter-rebuild.md) |
|
||||
| 2026-03-19 | 变更审计记录：card_type_id 年卡/月卡映射文档同步 | bugfix | 未知 | [链接](changes/2026-03-19__card-type-id-doc-sync.md) |
|
||||
| 2026-03-19 | 变更审计记录：coach_service 绩效档位硬编码修复 | bugfix | 低 | [链接](changes/2026-03-19__coach-tier-hardcode-fix.md) |
|
||||
| 2026-03-19 | 变更审计记录：助教等级映射硬编码修复（P2-9） | bugfix | 低 | [链接](changes/2026-03-19__level-map-hardcode-fix.md) |
|
||||
| 2026-03-19 | 数据库变更审计：RNS1.2 客户与助教接口 | 文档 | 低 | [链接](changes/2026-03-19__rns12-db-audit.md) |
|
||||
| 2026-03-18 | RNS1.1 E2E 测试 — FDW 直连改造 + performance_service bug 修复 | bugfix | 未知 | [链接](changes/2026-03-18__rns1-e2e-fdw-direct-connect-bugfix.md) |
|
||||
| 2026-03-15 | 变更审计记录：DDL 基线统一整理 + BD 手册重组 + 小程序副本清理 | bugfix | 低 | [链接](changes/2026-03-15__ddl-baseline-consolidation-bd-manual-reorg.md) |
|
||||
| 2026-03-13 | 审计记录：board-finance line-height 全量补齐 | bugfix | 低 | [链接](changes/2026-03-13__board-finance-line-height-audit.md) |
|
||||
| 2026-03-13 | 审计记录：board-finance.wxss rpx 换算公式修正 | 功能 | 未知 | [链接](changes/2026-03-13__board-finance-rpx-formula-correction.md) |
|
||||
| 2026-03-13 | 变更审计记录：task-list 页面 H5 原型 1:1 重写 | bugfix | 未知 | [链接](changes/2026-03-13__task-list-h5-rewrite.md) |
|
||||
| 2026-03-12 | 变更审计记录：board-finance WXSS 视觉校对（四轮） | bugfix | 未知 | [链接](changes/2026-03-12__board-finance-overview-wxss-calibration.md) |
|
||||
| 2026-03-12 | 变更审计记录：小程序前端开发文档体系收尾（步骤 1-4） | 文档 | 低 | [链接](changes/2026-03-12__miniprogram-dev-docs-finalize.md) |
|
||||
| 2026-03-12 | 变更审计记录：多模块累积变更 — AI 对话系统 + 任务防御 + 小程序 UI 重构 + ETL DWS | bugfix | 未知 | [链接](changes/2026-03-12__multi-module-ai-taskdefense-miniprogram-etl.md) |
|
||||
| 2026-03-12 | 变更审计记录：pixel-audit 结构化审计方法论替换像素对比 | 文档 | 未知 | [链接](changes/2026-03-12__pixel-audit-structured-methodology.md) |
|
||||
| 2026-03-10 | 变更审计记录：多模块累积变更 — AI 应用骨架 + 任务队列防卡死 + 小程序页面迁移 | bugfix | 未知 | [链接](changes/2026-03-10__multi-module-ai-apps-task-defense-miniprogram.md) |
|
||||
| 2026-03-08 | 变更审计记录：P5 AI 集成需求审视 — 7 项歧义修补 + category 枚举对齐 | 文档 | 未知 | [链接](changes/2026-03-08__p5-ai-spec-review-category-enum-align.md) |
|
||||
| 2026-03-07 | 变更审计记录：TASK 3 项目标签计算逻辑 — 文档与配置同步 | 文档 | 低 | [链接](changes/2026-03-07__task3-project-tag-docs-sync.md) |
|
||||
| 2026-03-06 | 变更审计记录：修复 RecordingAPIClient 缺少 post 方法 | bugfix | 极低 | [链接](changes/2026-03-06__fix-api-client-post-method.md) |
|
||||
| 2026-03-06 | 变更审计记录：修复 DatabaseOperations 缺少 _dsn 属性导致 DWD 并行装载全部失败 | bugfix | 极低 | [链接](changes/2026-03-06__fix-db-operations-dsn-proxy.md) |
|
||||
| 2026-03-04 | 变更审计记录：全栈累积变更（营业日配置、WebSocket 日志、微信认证、仓库清理） | 重构 | 高 | [链接](changes/2026-03-04__fullstack-accumulated-changes.md) |
|
||||
| 2026-03-03 | 变更审计记录：微信小程序开发调试面板 | 文档 | 低 | [链接](changes/2026-03-03__miniprogram-dev-debug-panel.md) |
|
||||
| 2026-03-02 | 变更审计：合并 ETL Hook 为统一分析入口 | 文档 | 未知 | [链接](changes/2026-03-02__etl-unified-analysis-hook-merge.md) |
|
||||
| 2026-03-02 | SPI 基数校准改用非零样本中位数 | 功能 | 未知 | [链接](changes/2026-03-02__spi-calibration-nonzero-median.md) |
|
||||
| 2026-03-01 | 审计记录：DWD 清理 + ODS 商品销售修复 + dim_staff_ex 修复 | bugfix | 未知 | [链接](changes/2026-03-01__dwd-cleanup-ods-fix-dim-staff-repair.md) |
|
||||
| 2026-03-01 | 变更审计：DWS numeric 精度扩展 + ODS 库存 siteid 注入 | 文档 | 低 | [链接](changes/2026-03-01__dws-numeric-precision-ods-siteid-fix.md) |
|
||||
| 2026-02-28 | 变更审计记录：多模块累积变更（营业日/核心业务/认证/ETL DWS 重构/参考文档合并） | 重构 | 未知 | [链接](changes/2026-02-28__multi-module-accumulated-changes.md) |
|
||||
| 2026-02-27 | 变更审计：营业日分割规则 PRD 同步检查 + 全栈集成收口 | bugfix | 低 | [链接](changes/2026-02-27__biz-day-cutoff-prd-sync-check.md) |
|
||||
| 2026-02-27 | 审计记录：P4 小程序核心业务路由 + 触发器注册 | 重构 | 未知 | [链接](changes/2026-02-27__p4-core-business-routes-triggers.md) |
|
||||
| 2026-02-26 | 审计记录：ETL Bug 修复 — dim_staff_ex 列映射 + assistant_daily table_area_name | bugfix | 未知 | [链接](changes/2026-02-26__etl-bugfix-dim-staff-rankname-assistant-daily-table-area.md) |
|
||||
| 2026-02-26 | 变更审计：P1/P2/P3 全栈集成（DB 基础 + ETL DWS 扩展 + 小程序鉴权） | bugfix | 低 | [链接](changes/2026-02-26__p1-p2-p3-fullstack-integration.md) |
|
||||
| 2026-02-26 | 审计记录：维客线索重构（member_birthday_manual → member_retention_clue） | 重构 | 未知 | [链接](changes/2026-02-26__retention-clue-refactor.md) |
|
||||
| 2026-02-26 | 审计记录：root-file — .gitignore 更新与 H5 UI / 临时文件清理 | 重构 | 高 | [链接](changes/2026-02-26__root-file-gitignore-h5ui-cleanup.md) |
|
||||
| 2026-02-15 | 审计记录：管理后台全量实现 + DB Schema 迁移 + 审计产物重组 | 清理 | 高 | [链接](changes/2026-02-15__admin-web-console-db-migration-audit-reorg.md) |
|
||||
| 2026-02-15 | 变更审计记录（Change Audit Record） | 文档 | 极低 | [链接](changes/2026-02-15__audit-consolidation-doc-reorg.md) |
|
||||
| 2026-02-15 | 审计记录：后端依赖补全使 FastAPI 可启动 | bugfix | 未知 | [链接](changes/2026-02-15__backend-deps-bootstrap.md) |
|
||||
@@ -498,18 +172,6 @@
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 风险 | 详情 |
|
||||
|------|----------|----------|------|------|
|
||||
| 2026-03-28 | 变更审计记录：财务看板 5 项修复（ODS 行膨胀 / 优惠分摊 / 环比字段 / 区域过滤 / 规范沉淀） | bugfix | 未知 | [链接](changes/2026-03-28__board-finance-5fixes.md) |
|
||||
| 2026-03-24 | 审计记录：迁移脚本合并到主 DDL 并归档 | 文档 | 低 | [链接](changes/2026-03-24__ddl-migration-merge-and-archive.md) |
|
||||
| 2026-03-24 | 变更审计记录：小程序登录页头像昵称获取功能（前端实施） | 文档 | 低 | [链接](changes/2026-03-24__miniprogram-avatar-nickname-feature.md) |
|
||||
| 2026-03-24 | 变更审计记录：P18 任务引擎运营看板实施 | bugfix | 未知 | [链接](changes/2026-03-24__p18-task-engine-dashboard.md) |
|
||||
| 2026-03-22 | 变更审计记录（Change Audit Record） | bugfix | 未知 | [链接](changes/2026-03-22__ddl_bd_manual_consistency_fix.md) |
|
||||
| 2026-03-22 | 变更审计记录：P16 调度任务最小运行间隔 — Spec 收尾文档同步 | 文档 | 未知 | [链接](changes/2026-03-22__p16-spec-closing-doc-sync.md) |
|
||||
| 2026-03-20 | 变更审计记录：R3 项目类型筛选接口重建（fetchSkillTypes / cfg_area_category） | bugfix | 高 | [链接](changes/2026-03-20__r3-skill-type-filter-rebuild.md) |
|
||||
| 2026-03-20 | 变更审计记录：RNS1.3 三看板 FDW 查询层数据口径修复 | bugfix | 未知 | [链接](changes/2026-03-20__rns13-board-apis-e2e-fix.md) |
|
||||
| 2026-03-19 | 变更审计记录：card_type_id 年卡/月卡映射文档同步 | bugfix | 未知 | [链接](changes/2026-03-19__card-type-id-doc-sync.md) |
|
||||
| 2026-03-19 | 变更审计记录：助教等级映射硬编码修复（P2-9） | bugfix | 低 | [链接](changes/2026-03-19__level-map-hardcode-fix.md) |
|
||||
| 2026-03-13 | 审计记录：board-finance line-height 全量补齐 | bugfix | 低 | [链接](changes/2026-03-13__board-finance-line-height-audit.md) |
|
||||
| 2026-03-08 | 变更审计记录：P5 AI 集成需求审视 — 7 项歧义修补 + category 枚举对齐 | 文档 | 未知 | [链接](changes/2026-03-08__p5-ai-spec-review-category-enum-align.md) |
|
||||
| 2026-02-15 | 变更审计记录（Change Audit Record） | 文档 | 极低 | [链接](changes/2026-02-15__audit-consolidation-doc-reorg.md) |
|
||||
| 2026-02-15 | 审计记录：docs/bd_manual + docs/dictionary → docs/database 合并 | 清理 | 极低 | [链接](changes/2026-02-15__docs-database-merge.md) |
|
||||
| 2026-02-15 | 审计记录：docs/index + docs/开发笔记 清理与路径整合 | 清理 | 低 | [链接](changes/2026-02-15__docs-devnotes-index-cleanup.md) |
|
||||
@@ -538,7 +200,6 @@
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 风险 | 详情 |
|
||||
|------|----------|----------|------|------|
|
||||
| 2026-03-24 | 变更审计记录：P17 助教客户归属与任务生成引擎 | bugfix | 未知 | [链接](changes/2026-03-24__p17-assistant-ownership-task-engine.md) |
|
||||
| 2026-02-14 | 审计记录：DWS 基类 bugfix — 绩效档位兜底 + safe_decimal 异常捕获 | bugfix | 未知 | [链接](changes/2026-02-14__dws-bugfix-tier-safedecimal.md) |
|
||||
| 2026-02-14 | 审计记录：废弃独立 ODS/DWD 任务代码清理 + 文档同步 | bugfix | 未知 | [链接](changes/2026-02-14__legacy-ods-dwd-cleanup.md) |
|
||||
| 2026-02-13 | 审计记录：BD_Manual 文档整理与 DDL 同步 | bugfix | 低 | [链接](changes/2026-02-13__bd-manual-docs-consolidation-ddl-sync.md) |
|
||||
@@ -548,10 +209,6 @@
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 风险 | 详情 |
|
||||
|------|----------|----------|------|------|
|
||||
| 2026-03-24 | 变更审计记录：P18 任务引擎运营看板实施 | bugfix | 未知 | [链接](changes/2026-03-24__p18-task-engine-dashboard.md) |
|
||||
| 2026-03-22 | 审计记录：P14 Task 15 — 最终检查点完成 | bugfix | 极低 | [链接](changes/2026-03-22__p14-task15-final-checkpoint.md) |
|
||||
| 2026-03-08 | 变更审计记录：P5 AI 集成需求审视 — 7 项歧义修补 + category 枚举对齐 | 文档 | 未知 | [链接](changes/2026-03-08__p5-ai-spec-review-category-enum-align.md) |
|
||||
| 2026-03-02 | 变更审计：合并 ETL Hook 为统一分析入口 | 文档 | 未知 | [链接](changes/2026-03-02__etl-unified-analysis-hook-merge.md) |
|
||||
| 2026-02-15 | 审计记录：docs/bd_manual + docs/dictionary → docs/database 合并 | 清理 | 极低 | [链接](changes/2026-02-15__docs-database-merge.md) |
|
||||
| 2026-02-15 | 审计记录：docs/index + docs/开发笔记 清理与路径整合 | 清理 | 低 | [链接](changes/2026-02-15__docs-devnotes-index-cleanup.md) |
|
||||
| 2026-02-14 | 审计记录：API vs ODS 比对 v3-fixed | 文档 | 极低 | [链接](changes/2026-02-14__api-ods-comparison-v3-fixed.md) |
|
||||
@@ -572,7 +229,6 @@
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 风险 | 详情 |
|
||||
|------|----------|----------|------|------|
|
||||
| 2026-02-27 | 变更审计：营业日分割规则 PRD 同步检查 + 全栈集成收口 | bugfix | 低 | [链接](changes/2026-02-27__biz-day-cutoff-prd-sync-check.md) |
|
||||
| 2026-02-14 | 审计记录：废弃独立 ODS/DWD 任务代码清理 + 文档同步 | bugfix | 未知 | [链接](changes/2026-02-14__legacy-ods-dwd-cleanup.md) |
|
||||
| 2026-02-13 | 审计记录：移除旧版指数（RECALL/INTIMACY）+ ML last-touch 清理 | bugfix | 低 | [链接](changes/2026-02-13__remove-legacy-index-cleanup.md) |
|
||||
|
||||
@@ -580,11 +236,4 @@
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 风险 | 详情 |
|
||||
|------|----------|----------|------|------|
|
||||
| 2026-02-27 | 变更审计：营业日分割规则 PRD 同步检查 + 全栈集成收口 | bugfix | 低 | [链接](changes/2026-02-27__biz-day-cutoff-prd-sync-check.md) |
|
||||
| 2026-02-15 | 变更审计记录（Change Audit Record） | 文档 | 极低 | [链接](changes/2026-02-15__audit-consolidation-doc-reorg.md) |
|
||||
|
||||
### 配置
|
||||
|
||||
| 日期 | 需求摘要 | 变更类型 | 风险 | 详情 |
|
||||
|------|----------|----------|------|------|
|
||||
| 2026-02-27 | 变更审计：营业日分割规则 PRD 同步检查 + 全栈集成收口 | bugfix | 低 | [链接](changes/2026-02-27__biz-day-cutoff-prd-sync-check.md) |
|
||||
|
||||
124
docs/audit/changes/2026-04-15__meituan-settle-core-sync.md
Normal file
124
docs/audit/changes/2026-04-15__meituan-settle-core-sync.md
Normal file
@@ -0,0 +1,124 @@
|
||||
# 变更审计记录：美团结算导入 + core 层定位 + CORE_DIM_SYNC 任务
|
||||
|
||||
| 字段 | 值 |
|
||||
|------|-----|
|
||||
| 日期 | 2026-04-15 01:41:01 |
|
||||
|
||||
## 操作摘要
|
||||
|
||||
本次变更包含 5 项关联改动，围绕"美团结算数据入库"和"core 维度层重新启用"两条主线展开：
|
||||
|
||||
1. **美团结算数据导入**：在 dwd.dwd_groupbuy_redemption 新增 6 个 mt_* 字段（mt_settlement_price / mt_gross_income / mt_service_fee / mt_marketing_fee / mt_other_adjust / mt_import_time），通过临时表批量 UPDATE 导入 15,878 条结算价记录（95.4% 覆盖率，未匹配 759 条为非美团券码）。
|
||||
2. **core 层重新定位与数据填充**：明确 core 层为"跨平台统一维度层"（屏蔽 ODS/DWD 多数据源差异），对 core.dim_assistant / dim_member / dim_site / dim_project 执行 TRUNCATE+INSERT 全量填充，修复 app 视图空查询问题。
|
||||
3. **CORE_DIM_SYNC 新 ETL 任务**：新建 core_dim_sync_task.py 实现 DWD->core 全量刷新（TRUNCATE+INSERT 4 个维度表），注册到 ETL task_registry（depends_on=DWD_LOAD_FROM_ODS）和后端 task_registry（admin-web 展示），meta.etl_task 新增 task_id=69。
|
||||
4. **DWS_ASSISTANT_ORDER_CONTRIBUTION 补全**：该任务此前仅在 ETL 侧注册，本次补齐后端 task_registry 注册和 meta.etl_task 配置（task_id=68），并全量回刷 2025-09-01~2026-04-15 数据（2,207 条）。
|
||||
5. **文档同步**：db/README.md 补充 core 层说明，ETL 任务文档新增 Core 层段落，BD 手册补 6 个 mt_* 字段说明。
|
||||
|
||||
## 变更文件
|
||||
|
||||
### 新增
|
||||
|
||||
| 文件 | 说明 |
|
||||
|------|------|
|
||||
| `apps/etl/connectors/feiqiu/tasks/dws/core_dim_sync_task.py` | CORE_DIM_SYNC 任务实现（TRUNCATE+INSERT 4 个维度表） |
|
||||
|
||||
### 修改
|
||||
|
||||
| 文件 | 说明 |
|
||||
|------|------|
|
||||
| `db/etl_feiqiu/schemas/dwd.sql` | DDL 基线同步：dwd_groupbuy_redemption 新增 6 个 mt_* 字段 |
|
||||
| `db/etl_feiqiu/schemas/app.sql` | 视图定义同步（保持指向 core） |
|
||||
| `db/etl_feiqiu/schemas/core.sql` | 注释更新：core 层定位说明 |
|
||||
| `db/README.md` | core 层补充说明 |
|
||||
| `apps/etl/connectors/feiqiu/tasks/dws/__init__.py` | 导出 CoreDimSyncTask |
|
||||
| `apps/etl/connectors/feiqiu/orchestration/task_registry.py` | 注册 CORE_DIM_SYNC（task_id=69, depends_on=DWD_LOAD_FROM_ODS） |
|
||||
| `apps/backend/app/services/task_registry.py` | 注册 CORE_DIM_SYNC + DWS_ASSISTANT_ORDER_CONTRIBUTION 到 admin-web 展示 |
|
||||
| `apps/etl/connectors/feiqiu/docs/etl_tasks/README.md` | 新增 Core 层段落 |
|
||||
| `apps/etl/connectors/feiqiu/docs/database/DWD/main/BD_manual_dwd_groupbuy_redemption.md` | 补充 6 个 mt_* 字段说明 |
|
||||
|
||||
## 改动注解
|
||||
|
||||
### 高风险
|
||||
|
||||
- **db/etl_feiqiu/schemas/dwd.sql**：ALTER TABLE 新增 6 列均为 NULLABLE，无破坏性。DDL 基线已同步数据库现状。数据通过临时表 UPDATE 导入，非 ETL 自动流程。
|
||||
- **db/etl_feiqiu/schemas/app.sql**：app.v_assistant / v_member / v_site 视图保持原始定义（指向 core.dim_*），core 表已填充数据，视图查询恢复正常。
|
||||
- **db/etl_feiqiu/schemas/core.sql**：注释变更，无结构变更。core 层定位从"待废弃"改为"跨平台统一维度层"。
|
||||
- **apps/etl/connectors/feiqiu/orchestration/task_registry.py**：新增 CORE_DIM_SYNC 注册项，depends_on=DWD_LOAD_FROM_ODS 确保在 DWD 加载后执行。
|
||||
- **apps/backend/app/services/task_registry.py**：新增 2 项展示注册（CORE_DIM_SYNC + DWS_ASSISTANT_ORDER_CONTRIBUTION），不影响已有任务。
|
||||
|
||||
### 普通
|
||||
|
||||
- **apps/etl/connectors/feiqiu/tasks/dws/core_dim_sync_task.py**：新建文件，TRUNCATE+INSERT 全量刷新模式，4 个维度表映射关系明确。
|
||||
- **apps/etl/connectors/feiqiu/tasks/dws/__init__.py**：仅添加导出行。
|
||||
- **db/README.md**：文档补充。
|
||||
- **apps/etl/connectors/feiqiu/docs/**：ETL 文档同步，无逻辑影响。
|
||||
|
||||
## 数据库变更
|
||||
|
||||
### etl_feiqiu 库
|
||||
|
||||
| 操作 | 对象 | 详情 | 执行状态 |
|
||||
|------|------|------|----------|
|
||||
| ALTER TABLE | `dwd.dwd_groupbuy_redemption` | 新增 6 列：mt_settlement_price (numeric(10,2)), mt_gross_income (numeric(10,2)), mt_service_fee (numeric(10,2)), mt_marketing_fee (numeric(10,2)), mt_other_adjust (numeric(10,2)), mt_import_time (timestamptz) | 已执行 |
|
||||
| TRUNCATE+INSERT | `core.dim_assistant` | 从 DWD 全量填充 | 已执行 |
|
||||
| TRUNCATE+INSERT | `core.dim_member` | 从 DWD 全量填充 | 已执行 |
|
||||
| TRUNCATE+INSERT | `core.dim_site` | 从 DWD 全量填充 | 已执行 |
|
||||
| TRUNCATE+INSERT | `core.dim_project` | 从 DWD 全量填充 | 已执行 |
|
||||
| INSERT | `meta.etl_task` | task_id=68 (DWS_ASSISTANT_ORDER_CONTRIBUTION) | 已执行 |
|
||||
| INSERT | `meta.etl_task` | task_id=69 (CORE_DIM_SYNC) | 已执行 |
|
||||
| CREATE OR REPLACE VIEW | `app.v_assistant / v_member / v_site` | 确认保持指向 core.dim_*（无变更） | 已验证 |
|
||||
|
||||
## 风险与回滚
|
||||
|
||||
### 风险点
|
||||
|
||||
| 级别 | 风险 | 缓解 |
|
||||
|------|------|------|
|
||||
| 中 | mt_* 字段通过临时表手工导入，非 ETL 自动化流程，后续美团结算单需手动重跑 | 后续可考虑封装为 scripts/ops/ 脚本 |
|
||||
| 中 | CORE_DIM_SYNC 使用 TRUNCATE+INSERT 全量刷新，执行期间 core 表短暂为空 | 任务执行时间极短（4 个维度表数据量小），可接受 |
|
||||
| 低 | DWS_ASSISTANT_ORDER_CONTRIBUTION 回刷数据量大（2,207 条跨 7 个月） | 已验证数据正确性 |
|
||||
|
||||
### 回滚要点
|
||||
|
||||
1. mt_* 字段回滚：`ALTER TABLE dwd.dwd_groupbuy_redemption DROP COLUMN mt_settlement_price, DROP COLUMN mt_gross_income, DROP COLUMN mt_service_fee, DROP COLUMN mt_marketing_fee, DROP COLUMN mt_other_adjust, DROP COLUMN mt_import_time;`
|
||||
2. CORE_DIM_SYNC 回滚：删除 core_dim_sync_task.py，从两个 task_registry 移除注册项，`DELETE FROM meta.etl_task WHERE task_id = 69;`
|
||||
3. DWS_ASSISTANT_ORDER_CONTRIBUTION 回滚：从后端 task_registry 移除，`DELETE FROM meta.etl_task WHERE task_id = 68;`
|
||||
|
||||
## 验证
|
||||
|
||||
```sql
|
||||
-- 1. 验证 mt_* 字段导入覆盖率
|
||||
SELECT
|
||||
COUNT(*) AS total,
|
||||
COUNT(mt_settlement_price) AS has_settle,
|
||||
ROUND(COUNT(mt_settlement_price)::numeric / COUNT(*) * 100, 1) AS pct
|
||||
FROM dwd.dwd_groupbuy_redemption;
|
||||
|
||||
-- 2. 验证 core 维度表非空
|
||||
SELECT 'dim_assistant' AS tbl, COUNT(*) FROM core.dim_assistant
|
||||
UNION ALL SELECT 'dim_member', COUNT(*) FROM core.dim_member
|
||||
UNION ALL SELECT 'dim_site', COUNT(*) FROM core.dim_site
|
||||
UNION ALL SELECT 'dim_project', COUNT(*) FROM core.dim_project;
|
||||
|
||||
-- 3. 验证 app 视图正常返回数据
|
||||
SELECT COUNT(*) FROM app.v_assistant;
|
||||
SELECT COUNT(*) FROM app.v_member;
|
||||
|
||||
-- 4. 验证 meta.etl_task 新增记录
|
||||
SELECT task_id, task_name, is_active FROM meta.etl_task WHERE task_id IN (68, 69);
|
||||
|
||||
-- 5. 验证 DWS_ASSISTANT_ORDER_CONTRIBUTION 回刷数据
|
||||
SELECT COUNT(*), MIN(stat_date), MAX(stat_date)
|
||||
FROM dws.dws_assistant_order_contribution;
|
||||
```
|
||||
|
||||
## 合规检查
|
||||
|
||||
| 项目 | 状态 |
|
||||
|------|------|
|
||||
| DDL 基线同步（db/etl_feiqiu/schemas/） | 已完成：dwd.sql, app.sql, core.sql 已更新 |
|
||||
| db/README.md 文档同步 | 已完成：core 层说明已补充 |
|
||||
| ETL 任务文档同步 | 已完成：docs/etl_tasks/README.md 新增 Core 层段落 |
|
||||
| BD 手册同步 | 已完成：BD_manual_dwd_groupbuy_redemption.md 补 mt_* 字段 |
|
||||
| 后端 task_registry 同步 | 已完成：CORE_DIM_SYNC + DWS_ASSISTANT_ORDER_CONTRIBUTION 已注册 |
|
||||
| RLS 视图双 Schema 规则 | 不涉及：本次无新建视图，现有视图保持不变 |
|
||||
374
docs/audit/changes/2026-04-20__historical-batch-pre-audit.md
Normal file
374
docs/audit/changes/2026-04-20__historical-batch-pre-audit.md
Normal file
@@ -0,0 +1,374 @@
|
||||
# 变更审计记录：2026-04-20 历史累积批次预审
|
||||
|
||||
| 字段 | 值 |
|
||||
|------|-----|
|
||||
| 日期 | 2026-04-20 06:01:35 |
|
||||
| 分类 | 历史批次预审（方案 C：详细） |
|
||||
| 触发时间窗口 | 2026-04-15 ~ 2026-04-20（最后一次 commit 后 5 天累积） |
|
||||
| 覆盖文件数 | 156 |
|
||||
| 高风险文件数 | 54 |
|
||||
| 新迁移 SQL | 2 |
|
||||
| 参与 spec | 7+ |
|
||||
|
||||
## 操作摘要
|
||||
|
||||
本次审计是"历史累积盘点"——156 个文件来自 HEAD (79d3c2e 开发机迁移) 之后 5 天的多次会话改动，用户本次会话无新改动。由于改动跨会话累积，缺失单次 /audit 的即时上下文，本次通过 git diff + 交叉比对 `docs/audit/changes/` 历史审计与 `docs/specs/` 现行规范还原语义上下文。
|
||||
|
||||
改动跨 6 个模块（backend / etl feiqiu / miniprogram / db / docs / 工具脚本）和 7 条主线：开发机迁移（路径基线搬迁）、rns1-customer-coach-api + 04-miniapp-core-business 联合实施、P19 指数回测框架（Phase 1+2）、Core 维度层启用、客户项目标签稳定性优化、美团结算导入收尾、运维工具与分析扩展。
|
||||
|
||||
2 个迁移 SQL 均已在开发库执行，schema 基线与任务代码一致。~95% 路径同步改动（开发机迁移衍生）为低风险；实质性业务变更集中在 16 个 backend + 22 个 miniprogram + 13 个 ETL 文件，全部可追溯到既有 spec。7 项高风险待验证项已在"风险与回滚"章节单独列出。
|
||||
|
||||
## 主线归类
|
||||
|
||||
### 主线 1：开发机迁移（路径同步，~95% 改动量来源）
|
||||
|
||||
- 根目录迁移 `C:\NeoZQYY` → `C:\Project\NeoZQYY`
|
||||
- 涵盖：`.env` / `.env.template` / `.mcp.json` / `apps/backend/.env.local` / `apps/etl/connectors/feiqiu/.env` / `scripts/ops/*.py` / `tools/db/*.py` / `tests/test_property_*.py` / `docs/specs/**/*.md` / `docs/deployment/*.md` / `docs/migrate/*.md` / `docs/mcp/*.md` / `docs/ops/*.md` / `docs/README.md` / `_DEL/**/*.md`
|
||||
- 风险：无（纯路径同步）
|
||||
|
||||
### 主线 2：rns1-customer-coach-api + 04-miniapp-core-business spec 实施
|
||||
|
||||
- **后端 16 文件**：配置 4 / 路由 schema 5 / 服务 9
|
||||
- **小程序 22 文件**：配置 5 / i18n typings 2 / 服务 1 / 工具组件 3 / 页面 11
|
||||
- **关键改动**：
|
||||
- `coach-service-records` 新页面（管理者视角业绩明细，需 `view_board_coach` 权限）
|
||||
- `performance-records` 拆分：去除 coachId 分支，恢复助教自查单一职责
|
||||
- `fdw_queries` 重构：`get_service_records_summary()` 直接 SQL 聚合、`get_last_visit_days()` 改用 `consumption_summary`、`get_consumption_records()` 按结算单粒度聚合
|
||||
- `build_performance_summary()` 公开化，`coach-detail` 和 `task-list` 数据源统一
|
||||
- `isScattered` 散客标记跨端贯通
|
||||
- `task_generator` 回访宽限 48h → 72h，新增 UPSERT 替代策略和 Step 5 清理保底任务
|
||||
- `recall_detector` settle_type=3 限制 + 门店级 resolved 召回解除
|
||||
|
||||
### 主线 3：P19 指数回测框架（Phase 1+2）
|
||||
|
||||
- **DDL**：`dws_member_assistant_relation_index` / `dws_member_winback_index` / `dws_member_newconv_index` 新增 `stat_date DATE NOT NULL DEFAULT CURRENT_DATE`，唯一约束扩展 `(site_id, member_id[, assistant_id], stat_date)`，app schema 视图改 `DISTINCT ON + ORDER BY stat_date DESC`
|
||||
- **任务**：`relation_index` / `winback_index` / `newconv_index` 改日快照模式（按 `stat_date` 删除 + 插入），批量写入优化
|
||||
- **新建**：`DWS_INDEX_BACKFILL` + `DWS_TASK_SIMULATION` 两个工具任务
|
||||
- **task_engine** 升级为双模式（HTTP 实时 / 推演回测）
|
||||
- **前置**：`member_index_base` STOP 分流改为 OLD
|
||||
|
||||
### 主线 4：Core 维度层启用（承接 2026-04-15 美团结算审计后续）
|
||||
|
||||
- 新建 `CORE_DIM_SYNC` 任务（DWD → core 4 维度表 TRUNCATE+INSERT）
|
||||
- `core.sql` 注释更新：定位为"跨平台统一维度层"
|
||||
- 修复 app 视图空查询问题
|
||||
- `task_registry` + `orchestration/task_registry.py` 注册新任务
|
||||
|
||||
### 主线 5：客户项目标签稳定性优化
|
||||
|
||||
- `member_project_tag` 从 `LAST_30/60_DAYS`（固定日期窗口）改为 `LAST_30_VISITS`（最近 30 次消费）
|
||||
- 配套迁移 SQL：`20260411_member_project_tag_visit_based.sql`（DELETE 旧窗口数据 + 新增 `cfg_area_category` 配置行）
|
||||
|
||||
### 主线 6：美团结算数据导入（已有 2026-04-15 审计覆盖）
|
||||
|
||||
- `dwd_groupbuy_redemption` 新增 6 个 `mt_*` 字段（`mt_settlement_price` / `mt_gross_income` / `mt_service_fee` / `mt_marketing_fee` / `mt_other_adjust` / `mt_import_time`）
|
||||
- 本次审计仅作"基线同步"确认：`db/etl_feiqiu/schemas/dwd.sql` + `docs/database/ddl/etl_feiqiu__dwd.sql` 已更新；`apps/etl/connectors/feiqiu/docs/database/DWD/main/BD_manual_dwd_groupbuy_redemption.md` 同步
|
||||
- **主审计记录**：`docs/audit/changes/2026-04-15__meituan-settle-core-sync.md`（本批次不重复审计）
|
||||
|
||||
### 主线 7：运维工具与分析扩展
|
||||
|
||||
- 新增脚本：`scripts/ops/churned_customer_report.py`（流失客户回访报告，~1137 行），`scripts/ops/simulate_historical_tasks.py`（历史任务推演，~524 行）
|
||||
- 新增目录：`tools/task-analysis/`（任务报告工具 + 7 份历史报告）
|
||||
- 新增启动：`start-admin.bat`
|
||||
- 新增报告：`excel_analysis_report.txt` / `sheet_structure.txt`（根目录中间产物）
|
||||
- `demo-miniprogram` SDK 1.6.28 → 1.6.29；项目名归一化
|
||||
|
||||
## 变更文件
|
||||
|
||||
### 后端 backend (16)
|
||||
|
||||
- `apps/backend/app/config.py`：路径注释更新（开发机迁移）
|
||||
- `apps/backend/.env.local`：路径同步
|
||||
- `apps/backend/auth_only.txt`：测试产物刷新
|
||||
- `apps/backend/auth_only_results.txt`：测试产物刷新
|
||||
- `apps/backend/auth_test_results.txt`：测试产物刷新
|
||||
- `apps/backend/app/routers/xcx_coaches.py`：**新增** `GET /xcx/coaches/{id}/banner` 轻量端点（+16）
|
||||
- `apps/backend/app/routers/xcx_performance.py`：**关键**——新增 `coach_id` 可选参数 + 权限分流 `view_board_coach`（+29/-11）
|
||||
- `apps/backend/app/schemas/xcx_coaches.py`：`PerformanceMetrics` 6→25 字段、新增 `CoachBannerResponse` / `CoachTaskStats`（+49/-8）
|
||||
- `apps/backend/app/schemas/xcx_customers.py`：`ConsumptionRecord + foodDetail`，`CustomerNote + creator_name/creator_role`（+3）
|
||||
- `apps/backend/app/schemas/xcx_performance.py`：`DateGroupRecord + is_scattered`（+1）
|
||||
- `apps/backend/app/services/board_service.py`：狭义召回改从 `coach_tasks` 统计（+38/-38）
|
||||
- `apps/backend/app/services/coach_service.py`：**关键**——新增 `get_coach_banner()`、`get_coach_detail` 重构 + `store_name/task_stats`、fdw 查询预容错（+194/-194）
|
||||
- `apps/backend/app/services/customer_service.py`：`notes JOIN auth.users` 获取创建者、结算单粒度消费记录重构（+256/-395）
|
||||
- `apps/backend/app/services/fdw_queries.py`：**关键**——新增 `get_service_records_summary()`、修复 `get_last_visit_days` 改用 `consumption_summary`、`get_consumption_records` 按结算单粒度（+219/-395）
|
||||
- `apps/backend/app/services/performance_service.py`：`assistant_id_override` + 散客标记 + summary 直接 SQL 聚合（+34/-34）
|
||||
- `apps/backend/app/services/recall_detector.py`：**关键**——`settle_type=3` 双重限制 + 门店级 resolved 召回解除 + 72h 宽限期（+109/-109）
|
||||
- `apps/backend/app/services/task_generator.py`：**关键**——回访 48h→72h、UPSERT 替代策略、Step 5 清理保底任务（+194/-194）
|
||||
- `apps/backend/app/services/task_manager.py`：`_build_performance_summary → build_performance_summary` 公开化、`current_tier` 改用数组下标（+18/-18）
|
||||
- `apps/backend/app/services/task_registry.py`：注册 `CORE_DIM_SYNC` / `DWS_ASSISTANT_ORDER_CONTRIBUTION` / `DWS_INDEX_BACKFILL`（+6/-1）
|
||||
|
||||
> 说明：`apps/backend/` 下文件总计 16 个（含 .env.local 和 3 份 auth 测试产物），其余均为实质业务逻辑改动。
|
||||
|
||||
### ETL feiqiu (13)
|
||||
|
||||
- `apps/etl/connectors/feiqiu/.env`：路径迁移 + API_TOKEN 续期（不列值）
|
||||
- `apps/etl/connectors/feiqiu/orchestration/task_registry.py`：注册 `CORE_DIM_SYNC` + `DWS_INDEX_BACKFILL`
|
||||
- `apps/etl/connectors/feiqiu/tasks/dws/__init__.py`：导出 `CoreDimSyncTask`
|
||||
- `apps/etl/connectors/feiqiu/tasks/dws/core_dim_sync_task.py` **[新建]**（+174）：DWD → core 4 维度表 TRUNCATE+INSERT
|
||||
- `apps/etl/connectors/feiqiu/tasks/dws/member_project_tag_task.py`：`LAST_30/60_DAYS → LAST_30_VISITS`
|
||||
- `apps/etl/connectors/feiqiu/tasks/dws/task_engine.py`：**关键**——升级双模式（HTTP 实时 / 推演回测）（+767/-96）
|
||||
- `apps/etl/connectors/feiqiu/tasks/dws/index/member_index_base.py`：STOP 分流改 OLD（+2/-1）
|
||||
- `apps/etl/connectors/feiqiu/tasks/dws/index/newconv_index_task.py`：日快照模式（+93/-30）
|
||||
- `apps/etl/connectors/feiqiu/tasks/dws/index/relation_index_task.py`：日快照 + 批量写入优化（+90/-27）
|
||||
- `apps/etl/connectors/feiqiu/tasks/dws/index/winback_index_task.py`：日快照 + 365 天保留策略 + `execute_batch`
|
||||
- `apps/etl/connectors/feiqiu/tasks/utility/index_backfill_task.py` **[新建]**：`DWS_INDEX_BACKFILL` 工具任务
|
||||
- `apps/etl/connectors/feiqiu/tasks/utility/task_simulation_task.py` **[新建]**：`DWS_TASK_SIMULATION` 工具任务
|
||||
- `apps/etl/connectors/feiqiu/scripts/research_coupon_details.py`：路径迁移（+1）
|
||||
- `apps/etl/connectors/feiqiu/docs/database/DWD/main/BD_manual_dwd_groupbuy_redemption.md`：`mt_*` 6 字段说明（+6）
|
||||
- `apps/etl/connectors/feiqiu/docs/database/DWS/main/BD_manual_cfg_area_category.md`：美洲豹赛台 BILLIARD
|
||||
- `apps/etl/connectors/feiqiu/docs/database/DWS/main/BD_manual_dws_member_project_tag.md`：新窗口文档同步
|
||||
- `apps/etl/connectors/feiqiu/docs/etl_tasks/README.md`：Core 层段落新增
|
||||
|
||||
### 小程序 miniprogram (22)
|
||||
|
||||
- `apps/miniprogram/project.config.json`：JSON 格式标准化
|
||||
- `apps/miniprogram/project.miniapp.json`：JSON 格式标准化
|
||||
- `apps/miniprogram/project.private.config.json`：JSON 格式标准化
|
||||
- `apps/miniprogram/miniprogram/app.miniapp.json`：JSON 格式标准化
|
||||
- `apps/miniprogram/miniprogram/app.json`：新增 `coach-service-records` 路由（+1）
|
||||
- `apps/miniprogram/i18n/base.json`：i18n 更新
|
||||
- `apps/miniprogram/typings/types/wx/lib.wx.miniapp.d.ts`：微信 API 类型更新
|
||||
- `apps/miniprogram/miniprogram/services/api.ts`：**关键**——新增 `fetchCoachBanner(coachId)`、`fetchPerformanceRecords` 新增 `coachId` 可选参数（+28/-1）
|
||||
- `apps/miniprogram/miniprogram/utils/format.wxs`：新增 `daysAgo()`（+11）
|
||||
- `apps/miniprogram/miniprogram/utils/perf-progress.ts` **[新建]**（+125）：进度条动画参数 + 工具函数单一源
|
||||
- `apps/miniprogram/miniprogram/components/perf-progress-bar/perf-progress-bar.wxss`：CSS 变量化（+1/-1）
|
||||
- `apps/miniprogram/miniprogram/pages/board-coach/board-coach.ts`：`formatCount` 简化（+4/-4）
|
||||
- `apps/miniprogram/miniprogram/pages/coach-detail/coach-detail.ts`：**关键**——进度条去重 + performance 字段扩展（+143/-94）
|
||||
- `apps/miniprogram/miniprogram/pages/coach-detail/coach-detail.wxml`：属性传参 + 散客标记 + Recent 限制 5 条（+18/-4）
|
||||
- `apps/miniprogram/miniprogram/pages/coach-detail/coach-detail.wxss`：散客置灰样式（+4）
|
||||
- `apps/miniprogram/miniprogram/pages/coach-service-records/coach-service-records.json` **[新建]**（+14）
|
||||
- `apps/miniprogram/miniprogram/pages/coach-service-records/coach-service-records.ts` **[新建]**（+200+）：权限守卫 `checkPageAccess('view_board_coach')`，`fetchCoachBanner + fetchPerformanceRecords(coach_id)`
|
||||
- `apps/miniprogram/miniprogram/pages/coach-service-records/coach-service-records.wxml` **[新建]**（+150+）：助教 banner + 月份切换 + 日期分组
|
||||
- `apps/miniprogram/miniprogram/pages/coach-service-records/coach-service-records.wxss` **[新建]**（+200+）：样式同 `performance-records`
|
||||
- `apps/miniprogram/miniprogram/pages/customer-detail/customer-detail.ts`：`foodDetail + phoneFull` + 复制改用 `phoneFull`（+7/-2）
|
||||
- `apps/miniprogram/miniprogram/pages/customer-detail/customer-detail.wxml`：手机号脱敏 + 食品类目动态 + notes 创建者（+8/-4）
|
||||
- `apps/miniprogram/miniprogram/pages/customer-detail/customer-detail.wxss`：食品标签长文本支持（+9）
|
||||
- `apps/miniprogram/miniprogram/pages/customer-records/customer-records.wxml`：食品类目动态同步（+4/-2）
|
||||
- `apps/miniprogram/miniprogram/pages/customer-records/customer-records.wxss`：食品标签样式同步（+9/-1）
|
||||
- `apps/miniprogram/miniprogram/pages/performance-records/performance-records.ts`：变更日志（拆分助教视角）（+1）
|
||||
- `apps/miniprogram/miniprogram/pages/performance-records/performance-records.wxml`：散客标记（+2/-1）
|
||||
- `apps/miniprogram/miniprogram/pages/performance-records/performance-records.wxss`：banner 字体 + 散客置灰（+10/-4）
|
||||
- `apps/miniprogram/miniprogram/pages/task-list/task-list.ts`：进度条逻辑外包到 `perf-progress.ts`（+107/-62，净 -90）
|
||||
- `apps/miniprogram/miniprogram/pages/task-list/task-list.wxml`：`fmt.days → fmt.daysAgo`（+6/-4）
|
||||
|
||||
### 数据库 db (6)
|
||||
|
||||
- `db/etl_feiqiu/migrations/2026-04-12__add_stat_date_to_index_tables.sql` **[新建]**：stat_date 字段 + 唯一约束扩展 + 索引重建 + app 视图 `DISTINCT ON`（详见下方 DDL 清单）
|
||||
- `db/etl_feiqiu/migrations/20260411_member_project_tag_visit_based.sql` **[新建]**：美洲豹赛台配置 + 清理旧窗口数据（详见下方 DDL 清单）
|
||||
- `db/etl_feiqiu/schemas/app.sql`：同步 3 视图 `DISTINCT ON` 改写（+40/-40）
|
||||
- `db/etl_feiqiu/schemas/core.sql`：注释更新，定位为跨平台统一维度层（+6）
|
||||
- `db/etl_feiqiu/schemas/dwd.sql`：`mt_*` 6 字段（对应 2026-04-15 美团审计）
|
||||
- `db/etl_feiqiu/schemas/dws.sql`：3 表 stat_date + 约束 + 索引 + `v_member_recall_priority` 改写（+133/-88）
|
||||
- `db/README.md`：core 层注释补充
|
||||
|
||||
### 文档 docs (40+)
|
||||
|
||||
> 95% 为路径同步（`C:\NeoZQYY → C:\Project\NeoZQYY`）；DDL 基线刷新仅 dws / zqyy_app biz 有实质内容；无新 spec。
|
||||
|
||||
**根文档**：
|
||||
|
||||
- `docs/README.md`：路径同步
|
||||
- `docs/assistant-task-detail-report.md`：历史报告（内容保留）
|
||||
|
||||
**DDL 基线（auto-gen，+201/-110 集中在 dws/biz）**：
|
||||
|
||||
- `docs/database/ddl/etl_feiqiu__app.sql`：基线刷新
|
||||
- `docs/database/ddl/etl_feiqiu__core.sql`：基线刷新
|
||||
- `docs/database/ddl/etl_feiqiu__dwd.sql`：基线刷新 + `mt_*` 字段
|
||||
- `docs/database/ddl/etl_feiqiu__dws.sql`：基线刷新 + stat_date + 视图
|
||||
- `docs/database/ddl/etl_feiqiu__meta.sql`：基线刷新
|
||||
- `docs/database/ddl/etl_feiqiu__ods.sql`：基线刷新
|
||||
- `docs/database/ddl/zqyy_app__app.sql`：基线刷新
|
||||
- `docs/database/ddl/zqyy_app__auth.sql`：基线刷新
|
||||
- `docs/database/ddl/zqyy_app__biz.sql`：基线刷新（有内容）
|
||||
- `docs/database/ddl/zqyy_app__public.sql`：基线刷新
|
||||
|
||||
**部署/迁移/MCP/运维**：
|
||||
|
||||
- `docs/deployment/EXPORT-PATHS.md`：路径同步 + LF→CRLF 标准化
|
||||
- `docs/deployment/LAUNCH-CHECKLIST.md`：路径同步 + LF→CRLF 标准化
|
||||
- `docs/mcp/WEIXIN-DEVTOOLS-MCP.md`：路径同步
|
||||
- `docs/migrate/*.md × 2`：路径同步
|
||||
- `docs/ops/init-test-user.md`：路径同步
|
||||
|
||||
**Specs（约 28 份，全部路径同步无进度变更）**：
|
||||
|
||||
- `docs/specs/*/tasks.md × 约 18`：pytest 命令路径同步
|
||||
- `docs/specs/*/design.md × 约 10`：pytest 命令路径同步
|
||||
|
||||
### 工具/脚本/测试/配置 (其余约 43)
|
||||
|
||||
> 95% 路径迁移，实质新增 2 个运维脚本 + 1 个工具目录 + 1 个启动 bat。
|
||||
|
||||
**根配置 5**：
|
||||
|
||||
- `.env`：路径同步
|
||||
- `.env.template`：路径同步
|
||||
- `.mcp.json`：路径同步
|
||||
- `.playwright-mcp/`：新增目录
|
||||
- `uv.lock`：大规模格式重排（不审跨 lockfile 内容）
|
||||
|
||||
**根中间产物 2**：
|
||||
|
||||
- `excel_analysis_report.txt`：Excel 分析中间产物
|
||||
- `sheet_structure.txt`：Sheet 结构中间产物
|
||||
|
||||
**scripts/ops 12**：
|
||||
|
||||
- `scripts/ops/ai_backfill.py`：路径同步
|
||||
- `scripts/ops/backfill_coach_area_hours.py`：路径同步
|
||||
- `scripts/ops/backfill_finance_area_daily.py`：路径同步
|
||||
- `scripts/ops/backfill_index_snapshots.py`：路径同步
|
||||
- `scripts/ops/check_and_refresh_audit.py`：路径同步
|
||||
- `scripts/ops/etl_unified_analysis.py`：路径同步
|
||||
- `scripts/ops/gen_integration_report.py`：路径同步
|
||||
- `scripts/ops/init_test_user.py`：路径同步
|
||||
- `scripts/ops/start-admin.ps1`：路径同步
|
||||
- `scripts/ops/churned_customer_report.py` **[新建]**：流失客户回访报告（~1137 行）
|
||||
- `scripts/ops/simulate_historical_tasks.py` **[新建]**：历史任务推演（~524 行）
|
||||
|
||||
**tools 3 + 新建子目录**：
|
||||
|
||||
- `tools/db/*.py × 3`：路径同步
|
||||
- `tools/task-analysis/` **[新建目录]**：任务报告工具 + 7 份历史报告
|
||||
|
||||
**tests 7**：
|
||||
|
||||
- `tests/test_property_*.py × 7`：常量路径同步
|
||||
|
||||
**apps/demo-miniprogram 4**：
|
||||
|
||||
- SDK 1.6.28 → 1.6.29 + 项目名归一化：
|
||||
- `apps/demo-miniprogram/i18n/base.json`
|
||||
- `apps/demo-miniprogram/miniprogram/app.miniapp.json`
|
||||
- `apps/demo-miniprogram/project.miniapp.json`
|
||||
- `apps/demo-miniprogram/project.private.config.json`
|
||||
|
||||
**_DEL 归档 4**：
|
||||
|
||||
- `_DEL/MIGRATION-PLAYBOOK.md`：路径同步
|
||||
- `_DEL/miniprogram-h5-conversion/steering/action-manual.md`：路径同步
|
||||
- `_DEL/weixin-devtools-mcp.md`：路径同步
|
||||
- `_DEL/weixin-devtools/steering/workflow.md`：路径同步
|
||||
|
||||
**根新增启动**：
|
||||
|
||||
- `start-admin.bat`：根目录启动引导（新建）
|
||||
|
||||
**其他配置**：
|
||||
|
||||
- `.claude/settings.json`：环境配置更新
|
||||
|
||||
## 数据库变更
|
||||
|
||||
### 迁移 1：`db/etl_feiqiu/migrations/2026-04-12__add_stat_date_to_index_tables.sql`
|
||||
|
||||
- **执行状态**：已执行（从 schema 基线一致性 + 任务代码已引用 `stat_date` 推断）
|
||||
- **DDL 清单**：
|
||||
1. `dws.dws_member_assistant_relation_index`：
|
||||
- `ADD COLUMN stat_date DATE NOT NULL DEFAULT CURRENT_DATE`
|
||||
- `DROP CONSTRAINT` 原唯一约束 `(site_id, member_id, assistant_id)`
|
||||
- `ADD CONSTRAINT` 新唯一约束 `(site_id, member_id, assistant_id, stat_date)`
|
||||
- `DROP INDEX` 旧索引（如有）
|
||||
- `CREATE INDEX` 新索引 `(site_id, stat_date)`
|
||||
- `UPDATE` 回填已有行 `stat_date = CURRENT_DATE`
|
||||
2. `dws.dws_member_winback_index`：同上，唯一约束变 `(site_id, member_id, stat_date)`
|
||||
3. `dws.dws_member_newconv_index`：同上，唯一约束变 `(site_id, member_id, stat_date)`
|
||||
4. `app.v_dws_member_assistant_relation_index`：重写 `SELECT DISTINCT ON (site_id, member_id, assistant_id) ... ORDER BY site_id, member_id, assistant_id, stat_date DESC`
|
||||
5. `app.v_dws_member_winback_index`：同上 `DISTINCT ON (site_id, member_id) ... ORDER BY ..., stat_date DESC`
|
||||
6. `app.v_dws_member_newconv_index`：同上 `DISTINCT ON (site_id, member_id) ... ORDER BY ..., stat_date DESC`
|
||||
7. `dws.v_member_recall_priority`：改写以依赖新视图
|
||||
- **影响对象**：3 张 DWS 表 + 4 张视图 + 4 个新索引
|
||||
- **回滚 SQL**：文件末尾提供（TRUNCATE 过期快照 → 恢复原唯一约束 → 删除 `stat_date` 列）
|
||||
- **兼容性**：`stat_date NOT NULL + DEFAULT CURRENT_DATE`，安全；大表 ALTER 因 DATE 列小，锁表风险低
|
||||
|
||||
### 迁移 2：`db/etl_feiqiu/migrations/20260411_member_project_tag_visit_based.sql`
|
||||
|
||||
- **执行状态**：已执行（`member_project_tag_task` 已改为 `LAST_30_VISITS` 模式）
|
||||
- **DDL 清单**：
|
||||
1. `dws.cfg_area_category`：`INSERT ... ON CONFLICT DO NOTHING` 幂等新增 `('美洲豹赛台', 'BILLIARD', '中式/追分')`
|
||||
2. `dws.dws_member_project_tag`：`DELETE WHERE time_window IN ('LAST_30_DAYS', 'LAST_60_DAYS')`
|
||||
- **影响对象**：1 条配置新增 + 旧窗口数据清理
|
||||
- **回滚 SQL**：恢复 DELETE 数据（需从备份） + DELETE 新增配置行
|
||||
- **兼容性**：无破坏性（纯数据操作 + 幂等配置）
|
||||
|
||||
## 风险与回滚
|
||||
|
||||
### 高风险项（需人工验证或测试）
|
||||
|
||||
1. **task_generator UPSERT + Step 5 清理**（`apps/backend/app/services/task_generator.py`）：72h 宽限期 + 双任务替代策略 + 保底任务清理——业务逻辑复杂，需回归测试各种任务替代路径
|
||||
2. **recall_detector settle_type=3 双重限制**（`apps/backend/app/services/recall_detector.py`）：`settle_type=3` 且 `order_assistant_type=2` 才计入；门店级召回自动解除（新增 resolved 状态）——需验证对历史数据的影响
|
||||
3. **fetchPerformanceRecords coach_id 参数权限**（`apps/backend/app/routers/xcx_performance.py` + `apps/miniprogram/miniprogram/services/api.ts`）：管理者跨级查询需要 `view_board_coach` 权限——需 e2e 权限测试防越权
|
||||
4. **coach-service-records 新页面权限守卫**（`apps/miniprogram/miniprogram/pages/coach-service-records/*`）：`onShow` 中 `checkPageAccess('view_board_coach')`，URL 参数 `coachId` 需后端二次验证防枚举
|
||||
5. **fdw_queries 消费汇总表口径统一**（`apps/backend/app/services/fdw_queries.py`）：`get_last_visit_days` / `batch_query_for_task_list` 改用 `v_dws_member_consumption_summary` 替代 `v_dwd_assistant_service_log`——下游多调用方，需验证聚合无重复
|
||||
6. **isScattered 散客标记端到端**（跨 backend/schemas + 小程序多页）：后端 `member_id ≤ 0` 自动标记——需验证所有调用方语义一致
|
||||
7. **task_engine 双模式分支**（`apps/etl/connectors/feiqiu/tasks/dws/task_engine.py`）：HTTP 实时 + 推演回测双路径，需独立 `APP_DB_DSN` 连接业务库
|
||||
|
||||
### 中风险项
|
||||
|
||||
- `PerformanceMetrics` schema 扩展（6→25 字段）：前端多页依赖，需字段可用性保证
|
||||
- `current_tier` 语义修正（tier_id 主键 → tier_nodes 数组下标 0-based）：前端档位展示语义对应
|
||||
- 指数任务日快照模式：DELETE 策略从全量变 `(site_id, stat_date)`，回填任务需防重跑
|
||||
|
||||
### 回滚策略
|
||||
|
||||
- **迁移 SQL**：两份回滚脚本已内嵌（文件末尾注释块）
|
||||
- **后端代码**：git revert 对应文件即可（未 commit，`git checkout HEAD -- <file>` 可立即回退）
|
||||
- **小程序代码**：同上
|
||||
- **ETL 任务**：可禁用 `CORE_DIM_SYNC` / `DWS_INDEX_BACKFILL` / `DWS_TASK_SIMULATION` 任务的编排注册
|
||||
|
||||
## 验证
|
||||
|
||||
### SQL 验证（3 条起步）
|
||||
|
||||
```sql
|
||||
-- 验证 stat_date 已生效
|
||||
SELECT COUNT(DISTINCT stat_date) FROM dws.dws_member_winback_index WHERE site_id = 1;
|
||||
|
||||
-- 验证 member_project_tag 新窗口已写入
|
||||
SELECT DISTINCT time_window FROM dws.dws_member_project_tag;
|
||||
-- 应只返回 LAST_30_VISITS
|
||||
|
||||
-- 验证 core 维度表非空（CORE_DIM_SYNC 已跑过）
|
||||
SELECT COUNT(*) FROM core.dim_assistant;
|
||||
SELECT COUNT(*) FROM core.dim_member;
|
||||
```
|
||||
|
||||
### 功能验证
|
||||
|
||||
- **小程序**：登录 coach 账号打开 `task-list` 查看绩效卡；登录 admin 账号从 `board-coach` 点击助教卡进 `coach-service-records` 页
|
||||
- **后端**：`pytest apps/backend/tests/` 跑现有测试
|
||||
- **ETL**：`python -m cli.main --dry-run --tasks CORE_DIM_SYNC,DWS_MEMBER_PROJECT_TAG,WINBACK_INDEX,RELATION_INDEX,NEWCONV_INDEX`
|
||||
|
||||
## 合规检查
|
||||
|
||||
### 文档同步缺口（预扫描识别的 25 项）
|
||||
|
||||
**已有文档覆盖（免补齐）**：
|
||||
|
||||
- 美团 `mt_*` 字段 → 已在 `docs/audit/changes/2026-04-15__meituan-settle-core-sync.md` 审计覆盖 + `BD_manual_dwd_groupbuy_redemption.md` 已更新
|
||||
- `stat_date` 迁移 → `db/etl_feiqiu/migrations/` 已有完整 SQL，`docs/database/ddl/etl_feiqiu__dws.sql` 已同步
|
||||
- `member_project_tag` 新窗口 → `BD_manual_dws_member_project_tag.md` 已同步
|
||||
|
||||
**待补齐高风险项（建议后续单独任务处理，本次审计仅标注缺口，不强制补齐）**：
|
||||
|
||||
- `apps/backend/docs/API-REFERENCE.md`：需增补 `xcx/coaches/{id}/banner`、`xcx/performance` 的 `coach_id` 参数说明、`xcx/customers` 的 `foodDetail` / `phoneFull` / `notes.creator*` 字段
|
||||
- `apps/miniprogram/README.md`：需增补 `coach-service-records` 新页面说明
|
||||
- `apps/etl/connectors/feiqiu/docs/architecture/`：建议补充 `orchestration/task_registry.py` 新增任务（`CORE_DIM_SYNC` / `DWS_INDEX_BACKFILL` / `DWS_TASK_SIMULATION`）
|
||||
|
||||
### 状态清单
|
||||
|
||||
| 项 | 状态 |
|
||||
|---|---|
|
||||
| 迁移 SQL 回滚脚本 | 已内嵌 |
|
||||
| DDL 基线同步 | 已同步（dws/app 一致） |
|
||||
| 代码→文档映射（美团/stat_date/project_tag） | 已覆盖 |
|
||||
| 代码→文档映射（backend API / miniprogram 新页 / ETL 新任务） | 待补齐（已列入后续任务） |
|
||||
| Spec 与实现对应 | 全部可追溯 |
|
||||
|
||||
## 下一步建议
|
||||
|
||||
1. 提交本基线（本次审计后可作为 commit 起点）
|
||||
2. 后续新改动走标准 `/audit` 流程（单独审计、小颗粒度）
|
||||
3. 高风险 7 项应在 commit 前或上线前完成端到端测试
|
||||
4. 文档补齐列入待办，非阻断本次提交
|
||||
226
docs/specs/audit-gap-recovery/tasks.md
Normal file
226
docs/specs/audit-gap-recovery/tasks.md
Normal file
@@ -0,0 +1,226 @@
|
||||
# 审计记录补追与嵌套目录清理
|
||||
|
||||
**发现日期**：2026-04-20
|
||||
**发现上下文**：2026-04-20 历史批次预审过程中，放宽 `.gitignore` 白名单后暴露出 `docs/audit/changes/changes/` 嵌套目录
|
||||
|
||||
## 背景
|
||||
|
||||
开发机迁移（79d3c2e 提交）前后，`docs/audit/changes/` 下意外出现了一个同名嵌套子目录 `docs/audit/changes/changes/`，其中堆积了 127 份审计记录 md 文件。推测原因是迁移脚本或某次批量拷贝时，误把 `docs/audit/changes/` 整个目录作为源，再次写入到了它自身下面，形成了 `changes/changes/` 的路径嵌套。
|
||||
|
||||
同时期 `.gitignore` 将 `docs/audit/` 整目录屏蔽（仅白名单少量文件），导致此后新增的审计记录长期无法入仓。主目录 `docs/audit/changes/` 当前仅有 33 份入仓 md，而嵌套目录累积了 127 份。
|
||||
|
||||
用户最初的设想是直接 `rm -rf docs/audit/changes/changes/` 了事。但实地核查发现：嵌套目录里相当一部分文件从未进入过 git 任何分支的 history（即未 commit 的孤本），一旦删除就永久丢失。因此需要先对 127 份做全量分类，再按类别分阶段处理，不能一删了之。
|
||||
|
||||
本 PRD 即用于指导后续清理动作，独立可执行。
|
||||
|
||||
## 扫描结果统计
|
||||
|
||||
| 分类 | 数量 | 含义 | 处理方式 |
|
||||
|------|------|------|---------|
|
||||
| A 纯副本 | 30 | 主目录同名同内容（diff 无输出） | 可直接删除嵌套版本 |
|
||||
| B 内容漂移 | 1 | 主目录同名但内容不同 | 人工比对选最新 |
|
||||
| C 已 commit 的孤本 | 0 | 主目录无，git history 有 | 无此类 |
|
||||
| D 未 commit 的孤本 | 96 | 主目录无，git history 也无 | **最高优先级补追**，删除即永久丢失 |
|
||||
| **合计** | 127 | | |
|
||||
|
||||
扫描方法：对 `docs/audit/changes/changes/*.md` 每个文件，先查 `docs/audit/changes/<同名>.md` 是否存在，存在则用 `diff -q` 比对内容；不存在则用 `git log --all --oneline -- docs/audit/changes/<文件名>` 查历史。扫描时主目录文件数 33，嵌套目录文件数 127。
|
||||
|
||||
## 类别 D：未 commit 的孤本清单（最高风险，共 96 份）
|
||||
|
||||
以下 96 份文件仅存在于 `docs/audit/changes/changes/`，且 git 所有分支 history 中均无记录。删除即永久丢失。
|
||||
|
||||
```
|
||||
2026-02-26__etl-bugfix-dim-staff-rankname-assistant-daily-table-area.md
|
||||
2026-02-26__p1-p2-p3-fullstack-integration.md
|
||||
2026-02-26__retention-clue-refactor.md
|
||||
2026-02-26__root-file-gitignore-h5ui-cleanup.md
|
||||
2026-02-27__biz-day-cutoff-prd-sync-check.md
|
||||
2026-02-27__p4-core-business-routes-triggers.md
|
||||
2026-02-28__multi-module-accumulated-changes.md
|
||||
2026-03-01__dwd-cleanup-ods-fix-dim-staff-repair.md
|
||||
2026-03-01__dws-numeric-precision-ods-siteid-fix.md
|
||||
2026-03-02__etl-unified-analysis-hook-merge.md
|
||||
2026-03-02__spi-calibration-nonzero-median.md
|
||||
2026-03-03__miniprogram-dev-debug-panel.md
|
||||
2026-03-04__fullstack-accumulated-changes.md
|
||||
2026-03-06__fix-api-client-post-method.md
|
||||
2026-03-06__fix-db-operations-dsn-proxy.md
|
||||
2026-03-07__task3-project-tag-docs-sync.md
|
||||
2026-03-08__p5-ai-spec-review-category-enum-align.md
|
||||
2026-03-10__multi-module-ai-apps-task-defense-miniprogram.md
|
||||
2026-03-12__board-finance-overview-wxss-calibration.md
|
||||
2026-03-12__miniprogram-dev-docs-finalize.md
|
||||
2026-03-12__multi-module-ai-taskdefense-miniprogram-etl.md
|
||||
2026-03-12__pixel-audit-structured-methodology.md
|
||||
2026-03-13__board-finance-line-height-audit.md
|
||||
2026-03-13__board-finance-rpx-formula-correction.md
|
||||
2026-03-13__task-list-h5-rewrite.md
|
||||
2026-03-15__ddl-baseline-consolidation-bd-manual-reorg.md
|
||||
2026-03-18__rns1-e2e-fdw-direct-connect-bugfix.md
|
||||
2026-03-19__card-type-id-doc-sync.md
|
||||
2026-03-19__coach-tier-hardcode-fix.md
|
||||
2026-03-19__level-map-hardcode-fix.md
|
||||
2026-03-19__rns12-db-audit.md
|
||||
2026-03-20__ai-prompt-refinement-board-coach-mock.md
|
||||
2026-03-20__h2-fdw-to-direct-etl-unification.md
|
||||
2026-03-20__miniprogram-docs-sync.md
|
||||
2026-03-20__r3-skill-type-filter-rebuild.md
|
||||
2026-03-20__rns1-ai-autonomous-decision-risk-audit.md
|
||||
2026-03-20__rns13-board-apis-e2e-fix.md
|
||||
2026-03-20__rns14-chat-fdw-filter-audit.md
|
||||
2026-03-20__rns14-chat-module-r3-filter-rebuild.md
|
||||
2026-03-22__db-field-walkthrough-batch-fix.md
|
||||
2026-03-22__ddl-db-structure-diff-bd-manual-audit.md
|
||||
2026-03-22__ddl_bd_manual_consistency_fix.md
|
||||
2026-03-22__dev-trace-log-fullstack-feature.md
|
||||
2026-03-22__ns4-ddl-merge-deleted-at.md
|
||||
2026-03-22__p14-task15-final-checkpoint.md
|
||||
2026-03-22__p16-spec-closing-doc-sync.md
|
||||
2026-03-22__trace-path-fix-miniprogram-login-race.md
|
||||
2026-03-22__zombie-task-graceful-shutdown-rerun.md
|
||||
2026-03-23__ddl-merge-rejection-count-cancelled.md
|
||||
2026-03-23__disable-to-remove-user-auth-model-fix.md
|
||||
2026-03-23__mysites-tenant-filter-time-format-nickname-display.md
|
||||
2026-03-23__review-modal-phone-display-auto-match-identity-label.md
|
||||
2026-03-23__role-routing-page-guard.md
|
||||
2026-03-23__tenant-admin-case-insensitive-username.md
|
||||
2026-03-23__tenant-admin-review-modal-dynamic-roles.md
|
||||
2026-03-23__tenant-admin-site-access-root-fix.md
|
||||
2026-03-23__tenant-user-approval-site-filter.md
|
||||
2026-03-23__trigger-jobs-admin-web-miniprogram-cleanup.md
|
||||
2026-03-24__add_missing_cfg_skill_type.md
|
||||
2026-03-24__ddl-migration-merge-and-archive.md
|
||||
2026-03-24__fix-tier-nodes-empty-progress-bar.md
|
||||
2026-03-24__lookback_days_60_to_90.md
|
||||
2026-03-24__miniprogram-avatar-nickname-feature.md
|
||||
2026-03-24__p17-assistant-ownership-task-engine.md
|
||||
2026-03-24__p18-task-engine-dashboard.md
|
||||
2026-03-24__perf-page-data-fix.md
|
||||
2026-03-24__review-modal-avatar-layout.md
|
||||
2026-03-24__soft-delete-user-site-roles-binding.md
|
||||
2026-03-24__trigger-jobs-clear-task-interaction.md
|
||||
2026-03-24_fix_cfg_skill_type_missing_records.md
|
||||
2026-03-25__baseline-relationship-building-tasks.md
|
||||
2026-03-25__baseline-task-independent-connection-fix.md
|
||||
2026-03-25__perf-to-task-detail-member-query.md
|
||||
2026-03-25__perf-wxml-missing-member-id.md
|
||||
2026-03-25__task-detail-service-records-6-improvements.md
|
||||
2026-03-25__tenant-users-soft-delete-upsert-fix.md
|
||||
2026-03-26__etl-missing-fields-phase1-ddl-mappings.md
|
||||
2026-03-26__net-income-calibration-all-pages.md
|
||||
2026-03-27__board-finance-double-format-fix.md
|
||||
2026-03-27__board-finance-integration-T2.md
|
||||
2026-03-27__board-finance-phase2-t1-t6.md
|
||||
2026-03-27__board-finance-wxml-format-tabs-cleanup.md
|
||||
2026-03-27__miniprogram-permission-unification.md
|
||||
2026-03-27__task-list-recent60d-and-wxml-formatting.md
|
||||
2026-03-28__board-finance-5fixes.md
|
||||
2026-03-28__board-finance-dws-area-refactor-audit.md
|
||||
2026-03-28__fix-miniprogram-login-landing-page.md
|
||||
2026-03-29__board-lazy-loading-pagination.md
|
||||
2026-03-29__coach-detail-500-field-name-fix.md
|
||||
2026-03-29__coach-detail-design-alignment.md
|
||||
2026-03-29__coach-detail-style-aggregation-fix.md
|
||||
2026-03-29__dws-task-engine-etl-orchestration.md
|
||||
2026-03-29__fix-recall-completion-event-chain.md
|
||||
2026-03-31__task-engine-overhaul.md
|
||||
2026-04-05__kiro-to-claude-code-migration.md
|
||||
2026-04-08__fix13-recall-events-refactor.md
|
||||
```
|
||||
|
||||
注意其中一份为 `2026-03-24_fix_cfg_skill_type_missing_records.md`（单下划线），与同日的 `2026-03-24__add_missing_cfg_skill_type.md` 命名风格不同，疑似历史遗留命名，补追时保持原名即可。
|
||||
|
||||
## 类别 B：内容漂移清单（需人工比对，共 1 份）
|
||||
|
||||
```
|
||||
2026-04-06__v1-cleanup-ddl-consolidation.md
|
||||
```
|
||||
|
||||
处理提示：主目录版本与嵌套版本在 2026-04-06 的 v1 整理 commit（779b2f6）前后可能经历过修订，需逐行对比选最新信息最完整的一版。
|
||||
|
||||
## 类别 C：已 commit 的孤本清单（可恢复，共 0 份）
|
||||
|
||||
本次扫描未发现此类文件。主目录缺失的 94 份全部属于 D 类未 commit 孤本。
|
||||
|
||||
## 类别 A：纯副本清单（可直接删除，共 30 份）
|
||||
|
||||
以下 30 份文件在主目录有同名同内容版本，嵌套副本可安全删除。
|
||||
|
||||
```
|
||||
2026-02-13__api-ods-comparison-v2.md
|
||||
2026-02-13__api-ods-comparison.md
|
||||
2026-02-13__api-reference-batch2.md
|
||||
2026-02-13__api-reference-overhaul.md
|
||||
2026-02-13__bd-manual-docs-consolidation-ddl-sync.md
|
||||
2026-02-13__field-drift-report-update.md
|
||||
2026-02-13__git-repo-reinit-push.md
|
||||
2026-02-13__remove-legacy-index-cleanup.md
|
||||
2026-02-14__api-doc-reorg-field-grouping.md
|
||||
2026-02-14__api-ods-comparison-v3-fixed.md
|
||||
2026-02-14__api-ods-comparison-v3.md
|
||||
2026-02-14__api-param-audit-ods-design.md
|
||||
2026-02-14__drop-dwd-settle-list.md
|
||||
2026-02-14__drop-ods-settlelist.md
|
||||
2026-02-14__dws-bugfix-tier-safedecimal.md
|
||||
2026-02-14__json-refresh-md-patch.md
|
||||
2026-02-14__json-vs-md-audit.md
|
||||
2026-02-14__legacy-ods-dwd-cleanup.md
|
||||
2026-02-14__md-placeholder-fix-cleanup.md
|
||||
2026-02-14__ods-cleanup-doc-update.md
|
||||
2026-02-14__ods-vs-summary-comparison.md
|
||||
2026-02-14__recording-client-timezone-fix.md
|
||||
2026-02-14__replace-role-area-new-api-doc.md
|
||||
2026-02-14__skip-words-remark-fix.md
|
||||
2026-02-15__admin-web-console-db-migration-audit-reorg.md
|
||||
2026-02-15__audit-consolidation-doc-reorg.md
|
||||
2026-02-15__backend-deps-bootstrap.md
|
||||
2026-02-15__docs-database-merge.md
|
||||
2026-02-15__docs-devnotes-index-cleanup.md
|
||||
2026-02-15__monorepo-migration-phase1-8.md
|
||||
```
|
||||
|
||||
## 建议的执行顺序
|
||||
|
||||
1. **阶段 1：先保全 D 类（96 份）**
|
||||
- 在动任何东西前，先 `git add -A && git commit -m "WIP 清理前快照"` 做一次保护 commit
|
||||
- 将 `docs/audit/changes/changes/` 下所有 D 类文件复制（不是移动）到 `docs/audit/changes/`
|
||||
- 检查 `.gitignore` 是否放行 `docs/audit/changes/*.md`，若未放行则先调整白名单
|
||||
- `git add docs/audit/changes/ && git commit -m "补追未入仓的 96 份审计孤本"`
|
||||
|
||||
2. **阶段 2：处理 B 类（1 份）**
|
||||
- 针对 `2026-04-06__v1-cleanup-ddl-consolidation.md`，用 `diff docs/audit/changes/<该文件> docs/audit/changes/changes/<该文件>` 查看差异
|
||||
- 选更完整的一版保留到主目录；将另一版备份到 `_DEL/audit-backup/2026-04-06__v1-cleanup-ddl-consolidation.嵌套版.md` 或类似路径
|
||||
- commit 消息"内容漂移修正：v1-cleanup-ddl-consolidation"
|
||||
|
||||
3. **阶段 3：恢复 C 类（0 份，跳过）**
|
||||
- 本次无 C 类，无需操作
|
||||
|
||||
4. **阶段 4：删除嵌套目录**
|
||||
- 确认阶段 1、2 已 commit 入仓
|
||||
- `rm -rf docs/audit/changes/changes/`
|
||||
- `git add -A && git commit -m "清理嵌套目录 docs/audit/changes/changes/"`
|
||||
|
||||
## 风险与回滚
|
||||
|
||||
- 风险 1：D 类补追后，主目录审计时间线会出现大段 2026-02-26 至 2026-04-08 的批量入仓，commit 时间与文件日期不一致。可接受，目标是保全历史。
|
||||
- 风险 2：B 类仅 1 份，若选错版本会丢失另一方内容。缓解：另一版强制先备份到 `_DEL/` 再删。
|
||||
- 风险 3：`.gitignore` 可能仍然屏蔽 `docs/audit/changes/*.md`，导致 `git add` 静默忽略。阶段 1 第一次 `git add` 后必须 `git status` 核对文件是否真的进入了暂存区；若未进入，先修 `.gitignore` 白名单再重试。
|
||||
- 风险 4：D 类中 `2026-03-24_fix_cfg_skill_type_missing_records.md` 为单下划线命名，可能与同日双下划线版本功能重叠，补追后若发现重复再单独合并。
|
||||
- 回滚：所有删除前应已有"WIP 清理前快照"commit；任何阶段出问题 `git reset --hard <快照 hash>` 即可恢复。
|
||||
|
||||
## 验证
|
||||
|
||||
阶段 4 完成后执行以下验证：
|
||||
|
||||
- `ls docs/audit/changes/*.md | wc -l` 应等于 33（原）+ 96（D 补追）+ 0（C 恢复）= 129
|
||||
- 若 B 类合并后主目录文件未增加，则仍为 129；若 B 类创建了新文件名则为 130
|
||||
- `ls docs/audit/changes/changes/ 2>/dev/null` 应返回空或"目录不存在"
|
||||
- `git log --oneline -- "docs/audit/changes/"` 应能看到至少 3 次本次操作 commit（快照 / 补追 / 清理）
|
||||
- 抽查 D 类中的 3 份文件，确认 `git log --all -- "docs/audit/changes/<文件名>"` 返回非空
|
||||
|
||||
## 不在本次任务范围
|
||||
|
||||
- 审计内容本身的正确性复核（只做文件层面的保全，不审查内容）
|
||||
- `.gitignore` 结构的长期设计（仅在本次清理中按需放行白名单）
|
||||
- 其他模块的遗漏审计补追
|
||||
- 审计看板 `docs/audit/audit_dashboard.md` 的刷新（阶段 4 完成后单独跑 `scripts/audit/gen_audit_dashboard.py`）
|
||||
Reference in New Issue
Block a user