Neo
32716bc71a
新增指标(无 fdw_queries 原查询 + 0 现有调用方 + 无 thin wrapper),沿用 sprint 1/sprint2 #1 模式 @trace_service + @runtime_aware decorator + 显式 stat_date <= ctx.business_date 上界 + dws_member_consumption_summary .total_consume_amount 字段 items_sum 口径。 双口径数值验证 PASS(member=2799207087163141 黄先生,直接 Python 调用): - 4a live(today=2026-05-05): get_total_consume_amount=1252.65 - 4b sandbox=2026-04-20: get_total_consume_amount=999.99(walkthrough 测试快照) unit test sprint1+sprint2 累计 19/19 PASS,无回归。 记录 thin wrapper 决策原则到 spec §5.5(迁移辅助层,非常态架构; fdw_queries 长远退化纯 ETL 物理访问层,清理放收尾 sprint)。 注:#3 累计交易笔数因 spec §4 字段未明确(dws_order_summary vs total_visit_count)暂停,等 Neo 决断后继续。 详见 docs/audit/changes/2026-05-06__f1_6_sprint2_total_consume_amount.md Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
47 lines
2.0 KiB
Python
47 lines
2.0 KiB
Python
"""沙箱时光机重算引擎 (Sandbox Replay Engine)
|
|
|
|
F1-6 沙箱时光机阶段 B 启动模块。
|
|
|
|
设计意图:
|
|
P20 沙箱(`runtime_mode='sandbox' + sandbox_business_date`)的"时光机"语义
|
|
要求所有业务指标按 sandbox_business_date 重新累计/截断,而非展示 ETL
|
|
跑批的最新累计。F1-5a/F1-5b 已建立基础设施(RuntimeContext + app 视图
|
|
业务日上界),本模块统一所有"runtime-aware"业务读取路径。
|
|
|
|
完整 spec:
|
|
docs/_overview/sandbox-replay-engine-spec.md
|
|
|
|
模块结构(随 sprint 推进逐步填充):
|
|
sandbox_replay/
|
|
├── __init__.py # 本文件,re-export 主要 API
|
|
├── _decorator.py # @runtime_aware decorator
|
|
├── consumption_replay.py # 消费/到店/累计交易(P1-2/3/4/12/13)
|
|
├── balance_replay.py # 会员余额(P1-1)— sprint 2
|
|
├── assistant_metrics_replay.py # 助教课时/收入/客户(P1-5/6/7/8)— sprint 3
|
|
├── salary_replay.py # MP-2 完整 daily salary(P2-17)— sprint 3
|
|
├── adjustments_replay.py # Excel 修正截断(P2-19)— sprint 3
|
|
├── tasks_replay.py # 任务完成率(P2-18)— sprint 4
|
|
├── rs_replay.py # RS 算法重算(P2-15)— sprint 4
|
|
└── intimacy_replay.py # 客户黏性(P2-16)— sprint 4
|
|
|
|
接口契约(sprint 1):
|
|
@runtime_aware(metric='last_visit_days')
|
|
def get_last_visit_days(conn, site_id: int, member_ids: list[int]) -> dict[int, int | None]:
|
|
'''函数体内自动接收 RuntimeContext,可读 ctx.is_sandbox / ctx.business_date。'''
|
|
...
|
|
"""
|
|
|
|
from app.services.sandbox_replay._decorator import runtime_aware
|
|
from app.services.sandbox_replay.consumption_replay import (
|
|
get_consumption_60d as get_consumption_60d_replay,
|
|
get_last_visit_days as get_last_visit_days_replay,
|
|
get_total_consume_amount as get_total_consume_amount_replay,
|
|
)
|
|
|
|
__all__ = [
|
|
"runtime_aware",
|
|
"get_last_visit_days_replay",
|
|
"get_consumption_60d_replay",
|
|
"get_total_consume_amount_replay",
|
|
]
|