opencode-workflow/skills/data-modeling

資料建模 (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 檔案