50 lines
2.2 KiB
Markdown
50 lines
2.2 KiB
Markdown
# 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 判斷流程
|
||
|
||
1. 是否需要 CMS/revision 與人工管理？
|
||
- 是：優先 Directus（由 FastAPI 轉寫）
|
||
- 否：走 FastAPI native
|
||
|
||
2. 是否高頻（每請求或每曝光級）？
|
||
- 是：禁止放 Directus revision 路徑
|
||
- 否：可評估 Directus
|
||
|
||
3. 是否要給 runtime 低延遲讀取？
|
||
- 是：優先 native 或快取層
|
||
- 否：可走內容層
|
||
|
||
## 禁止事項
|
||
|
||
- 新功能直接在 frontend 直寫 Directus。
|
||
- 同一份資料同時承擔 CMS 欄位與 runtime payload 責任。
|
||
- 把 runtime 高頻事件塞進 Directus revision 流。
|