# 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`