Files
Neo-ZQYY/apps/etl/connectors/feiqiu/docs
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
..

docs/ — 项目文档

子目录索引

目录 / 文件 内容
architecture/ 架构设计文档 — 系统整体架构、数据流向ODS→DWD→DWS、模块交互关系
api-reference/ API 参考文档25 个端点的标准化文档 + JSON 样本)
business-rules/ 业务规则文档 — 指数算法、DWS 口径定义、SCD2 处理规则等业务逻辑
database/ 数据库文档统一目录 — 层级概览 + ODS/DWD/DWS/ETL_Admin 表级文档
database/overview/ 层级概览 / 速查索引(表清单、主键、记录数、业务域分类)
database/ODS/ ODS 层表手册main/mappings/changes
database/DWD/ DWD 层表手册main 表 + Ex 扩展表)
database/DWS/ DWS 层表手册(助教、财务、会员、指数等)
database/ETL_Admin/ ETL 管理层表手册etl_cursor/etl_run/etl_task
etl_tasks/ ETL 任务文档ODS/DWD/DWS/指数任务说明与机制)
operations/ 运维文档 — 环境搭建指南、调度配置说明、故障排查手册
CHANGELOG.md 项目级版本变更历史(日期、变更摘要、影响范围)

维护约定

  • 代码变更涉及表结构或口径时,同步更新 database/
  • 审计一览表通过 python scripts/audit/gen_audit_dashboard.py(在项目根目录执行)重新生成
  • 审计变更记录已统一迁移至根 docs/audit/changes/
  • 审计报告通过 python -m scripts.audit.run_audit 重新生成,不要手动编辑
  • 文档统一 UTF-8 编码,中文撰写