2.2 KiB
2.2 KiB
Data Ownership Matrix
目的
這份文件用來固定「資料放哪裡、誰負責寫入、誰能直接讀取」，避免新模組把資料邊界混在一起。
規則總結
- 對外業務 API 只走 FastAPI。
- 內容型資料可由 FastAPI 經 Directus repository 寫入 Directus（保留 revision）。
- 高頻系統型資料由 FastAPI native repository 直接處理，不走 Directus revision。
- Frontend/SDK 不直接做 Directus 新業務寫入。
- 變更模型簡化：
Variant不使用is_control/status，VariantChange不使用enabled。
資料歸屬矩陣
| Entity | 主儲存 | 寫入責任 | 讀取入口 | Revision | 頻率特性 |
|---|---|---|---|---|---|
| site | Directus | FastAPI -> Directus repo | Admin API | Yes | 低頻 |
| experiment | Directus | FastAPI -> Directus repo | Admin API | Yes | 中頻 |
| variant | Directus | FastAPI -> Directus repo | Admin/Editor API | Yes | 中頻 |
| variant_change | Directus | FastAPI -> Directus repo | Editor API | Yes | 中頻 |
| experiment_release | Directus | FastAPI -> Directus repo | Admin/Runtime API | Yes | 中頻 |
| goal | Directus | FastAPI -> Directus repo | Admin API | Yes | 低頻 |
| sdk_config | Directus | FastAPI -> Directus repo | Admin/Runtime API | Yes | 低頻 |
| editor_session | Native DB | FastAPI native repo | Editor API | No | 中高頻 |
| assignment | Native DB | FastAPI native repo | Runtime API | No | 高頻 |
| runtime_event | Native DB | FastAPI native repo | Runtime API / analytics pipeline | No | 高頻 |
| audit_log | Native DB | FastAPI native repo | Internal ops API | No | 中高頻 |
新 Entity 判斷流程
- 是否需要 CMS/revision 與人工管理？
- 是：優先 Directus（由 FastAPI 轉寫）
- 否：走 FastAPI native
- 是否高頻（每請求或每曝光級）？
- 是：禁止放 Directus revision 路徑
- 否：可評估 Directus
- 是否要給 runtime 低延遲讀取？
- 是：優先 native 或快取層
- 否：可走內容層
禁止事項
- 新功能直接在 frontend 直寫 Directus。
- 同一份資料同時承擔 CMS 欄位與 runtime payload 責任。
- 把 runtime 高頻事件塞進 Directus revision 流。