Neo-ZQYY/docs/audit/changes/2026-04-20__historical-batch-pre-audit.md

变更审计记录：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 条起步）

-- 验证 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. 文档补齐列入待办，非阻断本次提交