mkt.ose.tw/HANDOFF.md

Project Handoff

先看

1. ROADMAP.md
2. docs/INDEX.md
3. docs/EXECUTION_PLAN.md
4. 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