chris/mkt.ose.tw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9a43563d4536622643e13a11b3dcbe801a5e5a4d
mkt.ose.tw/docs/CURRENT_WORK_ITEMS.md

7.0 KiB
Raw Blame History

Current Work Items

用途

只記這一輪正在做的事情。方向看 ROADMAP，分階段交付看 EXECUTION_PLAN。

規格重置（2026-03-22）

這輪以你最新決策為準：

  1. 實驗抓取：URL 規則 + 裝置限制
  2. 建立 Experiment 同步建立原始 Variant
  3. 移除 is_control
  4. 移除 variant_changes.enabled
  5. key 改系統生成：EX+timestamp / VA+timestamp
  6. Variant 移除 status，使用者只調 name / traffic_weight

目前進行中

A. 文件與契約（✅ 完成）

  • SYSTEM_SPEC_MASTER 已寫入 6 條新規格
  • EXPERIMENT_SYSTEM_SPEC 已更新為新流程
  • API_CONTRACT_MASTER 已更新欄位約束
  • docs/MIGRATION_NOTE.md 已建立：is_control / variants.status / variant_changes.enabled 移除策略與 DB 清理建議

B. Backend 實作調整（✅ 完成）

  • domain/keys.py 新建：generate_experiment_key() / generate_variant_key() → EXxxxxxx / VAxxxxxx
  • ExperimentCreate 移除 experiment_key 欄位；service 層改為系統生成
  • VariantCreate 移除 variant_key 欄位；service 層改為系統生成
  • 建立 Experiment 時自動建立「原始版本」Variant
  • domain/admin.py Variant 移除 status、is_control
  • domain/editor.py VariantChange 移除 enabled
  • domain/editor_builder.py 移除 enabled 過濾
  • schemas/admin.py VariantRead / VariantCreate / VariantUpdate 同步更新
  • repositories/directus/variants.py default_fields 移除 status / is_control
  • repositories/directus/variant_changes.py default_fields 移除 enabled（修復 CORS/500 bug）
  • schemas/editor.py EditorChangeRead / EditorChangeWrite 已移除 enabled
  • application/admin/releases.py 移除 enabled / is_control 依賴；加 archive_release()
  • application/editor/service.py build_preview 移除 enabled=item.enabled
  • Variant 流量權重加總 = 100 驗證（_assert_weights_sum_100）
  • repositories/directus/activity.py 新建：Directus built-in /activity 查詢
  • application/admin/activity.py 新建：ActivityService.list_for_experiment()
  • api/admin/experiments.py 加 GET /{id}/activity 端點
  • api/admin/releases.py 加 POST /{id}/archive 端點

C. Frontend 實作調整（✅ 完成）

  • VariantFormDialog.vue 簡化為只保留 name + traffic_weight
  • variant-view-model.js 移除 status、isControl、buildVariantStatusTag
  • experiment-view-model.js mapVariantItem 移除 status、isControl；mapReleaseItem 加 versionNo
  • experiment/detail.vue 改寫為 5 tab 設計（實驗設定 / 變體列表 / 版本列表 / 目標設定 / 操作紀錄）
  • variant/detail.vue 移除狀態/角色 metric card；完整 change set 摘要已存在
  • use-variant-detail-page.js 移除 roleLabel、variantStatusTag
  • use-experiment-detail-page.js 完整重寫：含 activityLog、release lifecycle、experiment settings
  • release-api.js 加 archiveRelease()
  • experiment-api.js 加 listActivity()
  • dashboard/home.vue 已有真實實驗統計摘要
  • 清理未使用的 openFirstVariantEditor / statusTypeMap 從 composable return

D. 驗證清單（規劃項）

  • 建立實驗後自動產生原始 Variant 的 E2E 測試
  • Key 自動生成格式測試：EX+timestamp / VA+timestamp
  • URL + device targeting 命中測試
  • Release build / publish / rollback / archive 回歸測試
  • Directus Activity log 在真實環境顯示正常

E. Runtime 實作修正（✅ 完成）

  • domain/runtime.py 移除 RuntimeVariantCandidate.is_control
  • schemas/runtime.py 移除 RuntimeVariantCandidateInput.is_control
  • application/runtime/assignment.py bootstrap() 移除 variant filter[status] 查詢（variants 已無 status 欄位）
  • application/runtime/assignment.py 移除所有 is_control=variant.is_control 引用
  • application/runtime/assignment.py _matches_targeting() 實作完整 URL rule 匹配：
    • contains / equals / starts_with / regex 四種 operator
    • device_targets 裝置限制（mobile / tablet / desktop via user-agent 偵測）
    • 空 url_rules 時 fallback 到 base_url startswith 檢查

F. Staging 真實環境驗證（✅ 完成，2026-03-23）

  • Auth flow：/api/auth/me → 確認 is_admin + 完整 permissions
  • Site 查詢：ose-demo-local site 可讀
  • Experiment 建立：key 自動生成（EX1774195099342）
  • 原始版本 Variant 自動建立（VA1774195099525，weight=50）
  • 第二個 Variant 建立（weight=50，總計=100）
  • 權重驗證：嘗試新增 weight=1 的第三個 variant → 正確回傳 400
  • Variant change 儲存：replace_text 操作可寫入
  • Release build：runtime_payload 格式正確，operations 包含 selector + action + payload
  • Publish / Rollback / Archive 鏈路全部可跑
  • Experiment 設為 running + targeting_config 儲存
  • Runtime bootstrap：URL rule 命中正確（example.com ✓，other-site.com → 0 candidates ✓）
  • Activity log：6 筆操作紀錄正確回傳（建立/更新/版本/變體）

G. Code Review 待修（✅ 完成，2026-03-23）

  • P0 Release lifecycle 修正：publish() 先 unpublish 同實驗其他 published release，rollback() 會回退到較早版本。
  • P0 Editor preview API 契約對齊：前端 buildPreview() 改送 items（原為 changes），與 BuildPreviewRequest.items 一致。
  • P0 save_changes() 改為完整覆蓋語意：先刪除 DB 中不在 request items 的舊 change，再 upsert。
  • P1 移除 variant_changes.enabled：EditorChangeRead / EditorChangeWrite schema 刪除欄位；frontend editor-workspace-model.js 同步清除。
  • P1 建立 Experiment 時前端不再送 experiment_key（ExperimentFormDialog 移除 autoFillKey、_auto_key、_generated_key）。
  • P1 Runtime bootstrap 改為從 release snapshot 讀取 traffic_weight / variant_key，避免即時 variant 異動造成分流不一致。
  • P1 Editor bridge snippet handleMessage 加 event.source === window.parent 驗證；EditorCanvasFrame 捕捉 event.origin 並存入 canvasOrigin，postMessage 改用具體 targetOrigin（fallback "*"）。
  • P1 Release rollback 邊界條件補強：只允許 rollback published release，並在 publish/rollback 後保證同一 experiment 僅有一個 published。
  • P2 補自動化測試：Backend API 契約、Editor flow、Runtime targeting/assignment、Release lifecycle 回歸。
  • P2 文件狀態一致化：ROADMAP、CURRENT_WORK_ITEMS、VALIDATION_EXECUTION_LOG 的完成狀態同步。

系統狀態

Phase A–G 主線已完成（2026-03-23），目前剩餘：2 項 P2 強化。

目前系統可運作；P1/P2 完成後可進一步提高一致性與可回歸性。

延後項目

  • 大型 UI polish
  • ose-card 深度重構
  • conutdown-timer 深度重構
Reference in New Issue View Git Blame Copy Permalink