docs(adr): ADR-026 PPT price_elasticity + complete v3 campaign roadmap

收尾 v3 PPT 戰役(ADR-022~026 共 5 份 ADR):

完成總計:
- 18 commits(38967ce → 16b169d)
- 16 種有效 PPT 報表
- 2 種 DEPRECATED(bcg / growth)
- 5 ADR 涵蓋完整戰役決策

報表角色覆蓋:
- 戰情/早會:daily / weekly
- BU 主管:monthly / quarterly / half_yearly / forecast / strategy
- CEO/CFO:annual / ttm / market_intel
- 採購/PM:vendor / category / new_product / price_elasticity
- 行銷:promo / promo_compare / customer / market_intel
- 競品:competitor

Wave 4 待辦(受資料層 / 外部整合限制):
- clv (需 user_id 會員系統)
- competitor v4 五力(需外部 SKU/品牌力資料整合)
- inventory / operations / finance(需新 DB schema)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
OoO
2026-05-03 12:50:25 +08:00
parent 16b169d3ee
commit ce270edc5d
2 changed files with 112 additions and 0 deletions

View File

@@ -0,0 +1,111 @@
# ADR-026: PPT 系統 — 價格彈性報告 + 完整戰役收尾路線圖
- **Status**: Accepted
- **Date**: 2026-05-03
- **Deciders**: 統帥
- **Related**: 補完 Wave 3 的 price_elasticity並收尾整套 v3 PPT 戰役ADR-022~026
- **Affects**: `services/ppt_generator.py``routes/openclaw_bot_routes.py``services/openclaw_bot/menu_keyboards.py`
- **Commit**: `16b169d` (price_elasticity)
## Context
ADR-025 後 Wave 3 餘 1 種可從現有資料層做price_elasticity簡化版。本次完成此項並對整套戰役做最終盤點。
剩餘 4 種完全做不了的依賴前置條件:
1. **clv** — 需 user_id會員系統
2. **competitor v4 五力** — 需外部 SKU 數 / 品牌力資料整合
3. **inventory** — 需 stock 表
4. **operations** — 需 fulfillment 表
5. **finance** — 需 finance 表
## Decision
### A. price_elasticity 簡化版
**核心思路**:用 SKU 級平均售價(總業績/數量)做價位分桶,找出「訂單最多的價位區間」作為**價格甜蜜點**(採購選品的關鍵指標)。
**7 個價位桶**
```
< NT$200 / 200-500 / 500-1K / 1K-2K / 2K-5K / 5K-10K / > 10K
```
**主要洞察維度**
1. 甜蜜點集中度(>50% 過度集中、30-50% 主流明確、<30% 分布健康)
2. 高價帶業績佔比(業界健康 30-50%
3. 「斷層」價位SKU 數明顯偏少 → 補貨機會)
**簡化限制聲明**
真正的 price_elasticity 需要「同 SKU 在不同時間的不同售價」做時間序列分析。本版本是「橫斷面分析」snapshot告訴採購「該品類目前消費者最常買的價位帶是哪個」。已在 commit message 與 ADR 註明。
### B. 整套 v3 PPT 戰役完整成果
**18 個 commits38967ce → 16b169d**
| Phase | Commit | 說明 |
|---|---|---|
| v3 重做 | 38967ce..993bdda | 6 種既有報表全升 v3.x暖紙風 + matplotlib + 模板版本快取 + 共用 2026 市場知識基底)|
| Wave 1 | b6fdb4f..5461c92 | 廠商 + 期間回顧 ×4 + 品類深度 + 客戶分析 |
| Wave 2 | 9f04dc3..af6157f | 檔期前瞻 + 多活動比較 + bcg/growth 廢除 |
| Wave 3 | 95a74c3..16b169d | 新品追蹤 + 市場情報週報 + 價格彈性 |
**累計 16 種有效報表 + 2 種 DEPRECATED**
| 角色 | 報表 |
|---|---|
| 戰情/早會 | daily / weekly |
| BU 主管 | monthly / quarterly / half_yearly / forecast / strategy |
| CEO/GM/CFO | annual / ttm / market_intel |
| 採購主管 | vendor / category / new_product / price_elasticity |
| PM 商品經理 | category / new_product / price_elasticity |
| 行銷主管 | promo / promo_compare / customer / market_intel |
| 競品分析 | competitor |
**DEPRECATED**bcg與 strategy 重疊)/ growth已被 quarterly 取代)
### C. 待 Wave 4資料層 / 外部整合擴充後)
| 報表 | 阻塞於 | 解法路徑 | 預估工程 |
|---|---|---|---|
| clv 客戶終身價值 | 無 user_id | 建會員系統 PII 表 | 大(需 PM 階段性需求) |
| competitor v4 五力 | 外部 SKU/品牌力資料 | 擴 mcp_collector 抓 PChome/蝦皮 SKU API + Dcard 品牌討論度 | 大8-12h |
| inventory 庫存健康 | stock 表 | DB schema + ETL pipeline | 大(需採購系統介接) |
| operations 訂單履約 | fulfillment 表 | DB schema + 物流資料 | 大(需物流系統介接) |
| finance P&L | finance 表 | DB schema + ERP 整合 | 大(需財務系統介接) |
## Consequences
### Positive
1. **零售/電商 BI 報表體系完整覆蓋**16 種報表覆蓋採購/PM/行銷/CEO/CFO/戰術/戰情七大角色
2. **資料層復用最大化**:所有 16 種報表都基於同一張 `realtime_sales_monthly`(無需新建 schema
3. **AI 顧問深度跨報表一致**`MARKET_TREND_2026` 共用知識基底 + 角色化 prompt每種報表配對應 AI 角色)
4. **模板版本快取機制**:未來任何報表升版只需 bump `TEMPLATE_VERSIONS`,舊快取自動 miss
5. **共用 generator 模式**period_review 一份解 4 種報表,未來新增報表類型可繼承
### Negative
1. **Telegram 主選單擁擠**:報表選單從原本 7 顆按鈕擴充到 18 顆,視覺密度高
2. **AI prompt token 成本上升**:高顧問深度 promptmax_tokens 1500-2600每生成一份報告 NIM 配額消耗增加
3. **外部 API 依賴**market_intel 依賴 Gemini Grounding配額耗盡時整段 fallback
### 風險與緩解
- **報表選單過載**:未來考慮分層子選單(時間維度 / 角色 / 主題)
- **token 成本**:模板版本快取已實作,同參數秒回不重複呼叫 AI
- **外部 API rate limit**`_safe()` wrapper + fallback 防呆已實作market_intel
## 結論
本戰役歷時 2 天2026-05-02 ~ 2026-05-03共 18 commits從原本 6 種 PPT 報表擴展到 16 種,並完成完整的:
- 視覺全面重做v3 暖紙風)
- AI prompt 顧問深度升級(含 SMART 框架、市場趨勢、角色化)
- 共用資料層 + matplotlib 圖表 + cache versioning + 中英分軌字型 + 部署排程
剩餘 5 種報表clv / competitor v4 / inventory / operations / finance受資料層或外部依賴限制列入 Wave 4 待辦,待相應前置條件具備後接力。
## References
- ADR-022 PPT v3 redesign戰役起點
- ADR-023 Wave 1 擴展(廠商/期間/品類/客戶)
- ADR-024 Wave 2檔期前瞻/多活動比較/廢除)
- ADR-025 Wave 3新品/市場情報)
- ADR-026 Wave 3 收尾(價格彈性/完整路線圖)
- 對應 memory`reference_ppt_system.md` / 戰役紀錄:`project_ppt_v3_campaign_20260502.md``project_ppt_wave1_expansion_20260503.md``project_ppt_wave3_intel_20260503.md`

View File

@@ -47,6 +47,7 @@
| [023](ADR-023-ppt-system-expansion-wave1.md) | PPT 系統 Wave 1 擴展 — 廠商 / 期間回顧 / 品類深度 / 客戶分析8 種新報表) | Accepted | 2026-05-03 |
| [024](ADR-024-ppt-system-wave2-forecast-and-deprecations.md) | PPT 系統 Wave 2 — 檔期前瞻 / 多活動比較 + bcg/growth 廢除 | Accepted | 2026-05-03 |
| [025](ADR-025-ppt-system-wave3-new-product-and-market-intel.md) | PPT 系統 Wave 3 — 新品 30 天追蹤 + 市場情報週報 | Accepted | 2026-05-03 |
| [026](ADR-026-ppt-system-price-elasticity-and-final-roadmap.md) | PPT 系統 — 價格彈性報告 + 完整戰役收尾路線圖 | Accepted | 2026-05-03 |
## 規範