Files
Neo 2a7a5d68aa feat: 2026-04-15~04-20 累积变更基线 — 多主线合流
主线 1: rns1-customer-coach-api + 04-miniapp-core-business 后端实施
  - 新增 GET /xcx/coaches/{id}/banner 轻量接口
  - performance/records 加 coach_id 参数 + view_board_coach 权限分流
  - coach/customer/performance/board/task 服务层重构
  - fdw_queries 结算单粒度聚合 + consumption_summary 视图统一
  - task_generator 回访宽限 72h + UPSERT 替代策略 + Step 5 保底清理
  - recall_detector settle_type=3 双重限制 + 门店级 resolved

主线 2: 小程序权限分流 + 新增 coach-service-records 管理者视角业绩明细页
  - perf-progress 共享模块去重 task-list/coach-detail 动画逻辑
  - isScattered 散客标记端到端
  - foodDetail/phoneFull/creator* 字段透传

主线 3: P19 指数回测框架 Phase 1+2
  - 3 个指数表 stat_date 日快照模式
  - 新增 DWS_INDEX_BACKFILL / DWS_TASK_SIMULATION 工具任务
  - task_engine 升级 HTTP 实时 + 推演回测双模式

主线 4: Core 维度层启用
  - 新增 CORE_DIM_SYNC 任务(DWD → core 4 维度表)
  - 修复 app 视图空查询问题

主线 5: member_project_tag 改为 LAST_30_VISITS 消费次数窗口

主线 6: 2 个迁移 SQL 已执行(stat_date + member_project_tag 新窗口)
  - schema 基线与 DDL 快照同步

主线 7: 开发机路径迁移 C:\NeoZQYY → C:\Project\NeoZQYY(约 95% 改动量)

附带: 新建运维脚本(churned_customer_report / simulate_historical_tasks /
      backfill_index_snapshots)+ tools/task-analysis/ 任务分析工具

合计 157 文件。未包含中间产物(tmp/ .playwright-mcp/ inspect-* excel/sheet 分析 txt)。
审计记录见下一个 commit。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 06:32:07 +08:00
..
1
2026-03-15 10:15:02 +08:00
1
2026-03-15 10:15:02 +08:00

飞球 ETL 数据库手册

模块专属的表级文档、字段映射、扩展表说明。 DDL 基线见项目级 docs/database/ddl/,变更记录已归档至 _archived/

目录结构

database/
├── ODS/
│   ├── main/       — ODS 表级文档BD_manual_*.md
│   └── mappings/   — API JSON → ODS 字段映射mapping_*.md
├── DWD/
│   ├── main/       — DWD 主表文档
│   ├── Ex/         — DWD 扩展表文档
│   └── changes/    — DWD 层变更记录
├── DWS/
│   ├── main/       — DWS 汇总表文档
│   └── changes/    — DWS 层变更记录
├── ETL_Admin/
│   └── main/       — meta schema 表文档
├── cross_layer/    — ODS→DWD 跨层字段映射(从 docs/database/ 迁入)
└── _archived/      — 过时的变更记录、DDL 对比报告、已删除表文档

文档类型

类型 命名规则 说明
表级文档 BD_manual_{表名}.md 字段说明、主键、业务含义
扩展表文档 BD_manual_{表名}_ex.md SCD2 扩展字段、溢出字段
字段映射 mapping_{API端点}_{ODS表名}.md API JSON 字段 → ODS 列的映射关系
跨层映射 BD_Manual_{ODS表名}.md ODS → DWD 字段映射、装载方式、业务含义

与项目级文档的关系

内容 位置 说明
DDL 基线 docs/database/ddl/ 从数据库自动导出,按 schema 分文件
业务库 BD_Manual docs/database/BD_Manual_*.md zqyy_app 表结构、FDW、RLS 视图
ODS→DWD 跨层映射 本目录 cross_layer/BD_Manual_*.md ODS 表 → DWD 表字段映射
表级字段说明 本目录 */main/BD_manual_*.md 单表字段详情
API→ODS 字段映射 本目录 ODS/mappings/ API JSON → ODS 列映射
DWD/DWS 层变更记录 本目录 DWD/changes/DWS/changes/ 加列、新表等变更说明