1.4 KiB

Raw Blame History

資料建模 (Data Modeling) 知識合約指南

概述

data-modeling 是知識合約，用來定義資料庫結構、分區鍵、索引、查詢模式、反正規化策略、TTL/快取與資料所有權。供 design-architecture 在設計資料模型時參考。

核心原則

資料模型必須由查詢與寫入模式驅動，而非理論純度
每個資料表必須有明確目的，可追溯到 PRD 需求
索引必須有明確的查詢模式支撐
資料所有權必須明確：每筆資料只屬於一個服務

設計重點

資料表定義：資料表名稱、目的、欄位定義、主鍵、外鍵關係
索引設計：索引必須有查詢模式支撐，避免 speculation 索引
分區鍵：分散式資料儲存的分區鍵選擇、熱分割風險
關係：One-to-one、One-to-many、Many-to-many，(含義與 cascade 行為)
反正規化策略：何時反正規化、資料同步機制、過時容忍度
TTL 與快取：Ephemeral 資料的 TTL、快取類型與失效策略
資料所有權：每筆資料的唯一擁有服務、其他服務透過 API 或事件存取

知識合約職責

提供資料建模的理論指引
不直接產生資料庫結構定義（由 design_database_schema 負責格式）

不應做的事

不替特定資料庫選擇資料表名稱或欄位
不定義具體的索引名稱或類型
不產生 Schema 檔案