Skip to content

feat(supply): D3b v3.11 adopted 单一事实源 + 趋势/季节模型与趋势诊断(P0+P1) - #346

Merged
keyapi merged 3 commits into
claude/d3b-owner-restatementfrom
keyapi/forecast-research
Nov 12, 2026
Merged

keyapi merged 3 commits into
claude/d3b-owner-restatementfrom
keyapi/forecast-research

Conversation

@keyapi

@keyapi keyapi commented Nov 12, 2026 •

Copy link
Copy Markdown
Owner

摘要

P0 + P1,已按 Codex 两轮复审修复。未改 D5/D6/CNY。

本 PR 基于 #329 claude/d3b-owner-restatement(supply_netting 尚未进 main),diff 只含 P0/P1;#329 合并后可改基到 main。

Codex 第二轮 P1 修复(commit e1f66ec3)

  1. 候选资格/模型集训练期化:SELECTION_END=202604;eligible、demand_pattern、sbc_class、models_for 只用 ≤202604 的数据。3_分类 增加 n_obs_train/n_pos_train/demand_pattern_train/sbc_class_train,3a_分类_asof 增加 *_full,训练期与全历史可对照。holdout(202605..202610)不参与 eligibility/分类/模型集。
  2. A/B/C 不再同窗选模:models 沿用前置 validation 的 current_adoption adopted,不在 ABC 内重选;A/B/C 统一在 holdout origin 202604(h=6,test 202605..202610)评估。
  3. A/B/C 共同样本:汇总新增 common_keys/common_actual/common_wape/common_bias/common_stockout_rate/excluded_actual;full 与 common 并列,差量单列。本轮 A/B/C actual 均为 20,499,common actual 20,499,差量 +0;A WAPE 0.8193,B/C90/C180 0.8171。

Codex 第一轮 P1/P2 修复(commit 75a9aa00)

  • Holt 缺测按日历推进;validation/holdout 分离;自检 fail-closed;ABC 共同键对账。
  • ETS(A,A,A) 先还季节再截零;多源含 none 标 adopted_partial;同比按同月配对。

验收(最终 clean run)

项 结果
行数 3_分类 1749 / 3a 1853 / 4_回测 46,483(validation 27,701 + holdout 18,782)/ 15_趋势诊断 1749
单源 join 763 / 763 精确(相对 adopted_sources 源键)
多源 join 85:agree 1 / partial 67 / maxqty 17;0 不一致
3a vs 4_回测(validation) 0 不一致
自检 PASS,0 fail;fail-closed 生效
当前采用 none 901 / snaive 242 / naive 160 / ma3 123 / theta 104 / ets_aadn 57 / ets_ann 54 / ets_aaa 42 / croston 34 / sba 32
状态 adopted 781 / adopted_partial 67 / none 901
趋势桶 down>30 624 / down10-30 142 / stable 131 / up10-30 61 / up>30 306 / no_2025_base 244 / no_data 241
结构突变 up 55 / down 35

独立 holdout 的诚实结果:adopted 中 holdout 可用 640 条;holdout WAPE 中位数 0.848,同批最佳基线 0.851;holdout FVA(中位数)0.3%,adopted 仅 22/640 键优于最佳基线。即 validation 选出的模型在真正独立的 6 个月里几乎没有超出基线的增量——已写进报告,作为后续 P2 重审候选集/门槛的依据。

软包墙围 4 SKU(validation / holdout WAPE)

键 旧 adopted 新 adopted validation WAPE holdout WAPE holdout 最佳基线
DM-60-DEEPGREY / 波兰 naive sba 0.579 1.056 1.463
DM-60-DEEPGREY / USTX naive sba(partial) 0.646 0.744 0.667
KJB-60-BEIGE / 波兰 ets_ann snaive 2.667 6.097 6.097
KJB-60-BEIGE / USTX ets_ann croston 0.175 0.586 0.578
KJB-90-BEIGE / 波兰 sba naive 55.000 0.980 0.980
KJB-90-BEIGE / USTX sba croston 0.348 0.797 0.987
KJB-90-DEEPGREY / 波兰 ets_ann sba 0.484 1.492 0.940
KJB-90-DEEPGREY / USTX ets_ann ma3 0.477 0.444 0.444

说明

  • 输入:orders_unified_20261111_v2.parquet;输出:D:/Work/fzh-order-store/analysis/D3b-v3_11-20261112/。
  • 运行用现有 venv,未新建 venv、未安装 statsforecast/statsmodels、未写 EN/通途。
  • 3_分类 的 none 为 901:只认该键自己的 as-of 采用结果;旧版按产品历史量借模型的做法已移除。D5 消费时必须保留 none 的 fallback。
  • 根 index.md 由 scripts/update_index.py 重新生成(首 commit);后续 commit 只改脚本 + ADR + log。
  • 未实现 Diebold–Mariano/block bootstrap 显著性检验(ADR 列为 P2)。

🤖 Generated with Claude Code

keyapi and others added 2 commits November 12, 2026 11:07
- 3_分类 只 join 4_回测_asof 的 adopted:单源精确、多源一致/历史量最大并留痕;
  采用门槛回退后重新 join;断言 fail closed,不再按产品历史量另选模型
- 新增 ETS(A,Ad,N)、ETS(A,A,A)/STL+ETS、简化 Theta(numpy 实现,无新依赖)
- 新增趋势诊断:2026 vs 2025 同期、3/6/12 月斜率、结构突变标记;
  输出 15_趋势诊断 + trend CSV
- 新增 P0 ADR:H_key 公式、98/154/161/91/112 标准桶、A/B/C/D 服务先验、
  rolling-origin + FVA 选择协议、春节供给日历 + bridge 原则
- 同步 supply_netting 文档索引与根索引

Co-Authored-By: Claude Code <noreply@anthropic.com>
P1:
- Holt 缺测月按日历推进状态(level=预测值, trend=phi*trend),尾部缺测推进到预测起点
- validation(202512/202601, h=3) 选模;holdout(202604, h=6, 202605..202610) 只评估,
  select() 不读取 holdout;3a/4_回测 增加 split 与 validation/holdout 双指标
- 自检 FAIL 不写工作簿/报告/manifest 且非零退出
- ABC 实际分母改为共同键对账;A 缺 1 键/100 件单列,自检全 PASS

P2:
- ETS(A,A,A) 先还季节再截零,避免去季节负值被提前截断抬高预测
- 多源键含 none 标 adopted_partial,不再算“一致”;adopted_sources 留痕
- 同比只比较同月两边都有效观测的配对月,新增 paired_months

验收:3_分类 1749 / 3a 1853 / 4_回测 49,997(val 29,487 + holdout 20,510);
单源 763/763 精确、多源 85 条(agree 1 / partial 67 / maxqty 17)、0 不一致;
自检 PASS、0 fail;holdout FVA(中位数)0.2%,adopted 仅 23/640 键优于最佳基线。

Co-Authored-By: Claude Code <noreply@anthropic.com>
@keyapi

keyapi commented Nov 12, 2026

Copy link
Copy Markdown
Owner Author

已按 Codex 复审意见修完 P1/P2,commit 75a9aa00,请复审。

P1

  1. _fit_damped_holt:缺测月按日历推进(level=pred, trend=phi*trend),尾部缺测推进到预测起点;不再跳过月份。
  2. 独立 holdout:validation 202512/202601(h=3)选模;holdout 202604(h=6,202605..202610)只评估,select() 不读取;3a/4_回测 增加 split 与 validation/holdout 双指标。
  3. 自检 fail-closed:sc_ok=False 不写工作簿/报告/manifest,非零退出;ABC 实际分母改共同键对账(A 缺 1 键/100 件单列),自检 0 fail。

P2

  1. ETS(A,A,A) 先还季节再截零。
  2. 多源含 none 标 adopted_partial(asof_join_multi_partial[_maxqty]),只有全部源键同模型且无 none 才叫 multi_agree。
  3. 同比按同月配对,新增 paired_months。

验收:3_分类 1749 / 3a 1853 / 4_回测 49,997(val 29,487 + holdout 20,510);单源 763/763 精确;多源 85(agree 1 / partial 67 / maxqty 17),0 不一致;自检 PASS。

独立 holdout 的结论:adopted 640 条,holdout WAPE 中位数 0.850 vs 最佳基线 0.851,holdout FVA 0.2%,仅 23/640 键优于基线。即 validation 选出的模型在真正独立的 6 个月里几乎没有超出基线的增量——这条已写进 PR 描述,作为后续 P2 重新考虑候选集/门槛的依据。

- 候选资格/分类/模型集只用 SELECTION_END=202604 之前的数据;holdout 202605..202610
  不参与 eligibility、分类或模型集
- 3_分类 增加 n_obs_train/n_pos_train/demand_pattern_train/sbc_class_train;
  3a_分类_asof 增加 *_full,训练期与全历史可对照
- A/B/C 仓级回测不再同窗选模:沿用前置 validation 的 adopted,
  统一在 holdout origin 202604(h=6,202605..202610)评估
- A/B/C 汇总增加 common_keys/common_actual/common_wape/excluded_actual;
  共同样本与 full 并列,差量单列
- 自检 PASS;4_回测 46,483(validation 27,701 + holdout 18,782)

Co-Authored-By: Claude Code <noreply@anthropic.com>
@keyapi

keyapi commented Nov 12, 2026

Copy link
Copy Markdown
Owner Author

已修完 Codex 第二轮三条 P1,commit e1f66ec3,请复审。

  1. 候选资格训练期化:SELECTION_END=202604;eligible/demand_pattern/sbc_class/models_for 只用 ≤202604 的数据;3_分类 加 *_train,3a 加 *_full;holdout 不参与资格/分类/模型集。
  2. ABC 不再同窗选模:沿用 validation 的 current_adoption adopted;A/B/C 统一在 holdout 202604(h=6,202605..202610)评估。
  3. ABC 共同样本:汇总新增 common_actual/common_wape/excluded_actual 等;本轮 A/B/C actual 均 20,499,common actual 20,499,差量 +0;A WAPE 0.8193,B/C 0.8171。

最终验收:3_分类 1749 / 3a 1853 / 4_回测 46,483(val 27,701 + holdout 18,782);单源 763/763;多源 85(1/67/17),0 不一致;自检 PASS。

独立 holdout:640 条可用,WAPE 中位数 0.848 vs 最佳基线 0.851,FVA 0.3%,22/640 键优于基线。这条作为后续 P2 重审候选集/门槛的依据,不再用 selection 窗口的改善代替。

@keyapi
keyapi merged commit b4cf694 into claude/d3b-owner-restatement Nov 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant