46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# Project Handoff
|
||
|
||
## 先看
|
||
|
||
1. [ROADMAP.md](/Users/chirs/Documents/workspace/marketing/mkt.ose.tw/ROADMAP.md)
|
||
2. [docs/INDEX.md](/Users/chirs/Documents/workspace/marketing/mkt.ose.tw/docs/INDEX.md)
|
||
3. [docs/EXECUTION_PLAN.md](/Users/chirs/Documents/workspace/marketing/mkt.ose.tw/docs/EXECUTION_PLAN.md)
|
||
4. [docs/CURRENT_WORK_ITEMS.md](/Users/chirs/Documents/workspace/marketing/mkt.ose.tw/docs/CURRENT_WORK_ITEMS.md)
|
||
|
||
## 系統目標
|
||
|
||
- 建立可實際運行的銷售實驗平台
|
||
- 核心流程：`Experiment -> Variant -> Editor -> Release -> Runtime`
|
||
- FastAPI 為產品 API 主入口，Directus 為 CMS / Identity 底座
|
||
|
||
## 現在主線
|
||
|
||
- Phase A：文件治理與結構收斂
|
||
- Phase B：Visual Editor 穩定化
|
||
- Phase C：管理流 API 與頁面補齊
|
||
|
||
## 本輪強制規格（先遵守）
|
||
|
||
- URL 規則 + 裝置限制決定實驗命中
|
||
- 建立 Experiment 時自動建立原始 Variant
|
||
- 移除 `is_control`
|
||
- 移除 `variant_changes.enabled`
|
||
- `experiment_key` 由系統生 `EX+timestamp`
|
||
- `variant_key` 由系統生 `VA+timestamp`
|
||
- Variant 使用者只可編輯 `name` / `traffic_weight`
|
||
|
||
## 重要程式入口
|
||
|
||
- Frontend Editor：`frontend/src/module/editor/*`
|
||
- Frontend 管理流：`frontend/src/module/experiment`、`variant`、`release`
|
||
- Backend API：`backend/app/api/*`
|
||
- Backend domain/service：`backend/app/domain`、`backend/app/services`
|
||
- Bridge snippet：`frontend/public/editor-bridge-snippet.js`
|
||
|
||
## 文件維護規則
|
||
|
||
- 方向只寫 `ROADMAP.md`
|
||
- 任務只寫 `docs/EXECUTION_PLAN.md`
|
||
- 當前細項只寫 `docs/CURRENT_WORK_ITEMS.md`
|
||
- 細修 backlog 只寫 `docs/DEFERRED_POLISH_BACKLOG.md`
|