# 儲存知識 (Storage Knowledge) 知識合約指南

## 概述
`storage-knowledge` 是知識合約，用來提供儲存技術選擇的原則與框架。涵蓋關聯式、寬列式、文件式與鍵值式儲存，並提供 Use-When 與 Avoid-When 判斷標準。供 `design-architecture` 在做儲存決策時參考。

## 核心原則
儲存選擇必須由 PRD 中識別的查詢模式、寫入模式、一致性需求與規模預期驅動。不要因為熟悉、時尚或覺得可能需要就選擇儲存技術。

## 儲存選擇標準
選擇儲存前，必須先回答：
1. 主要查詢模式是什麼？（按鍵、按範圍、按複雜過濾、全文搜索）
2. 寫入模式是什麼？（寫入為主、更新為主、僅附加）
3. 需要什麼一致性？（Strong、Eventual、Tunable）
4. 預期規模是多少？（每天列數、總列數、生長率）
5. 存取延遲需求是什麼？（毫秒、秒、最終一致）
6. 與其他實體的關係是什麼？（外鍵、嵌套文件、圖形遍歷）

## 儲存類型
- **Relational (PostgreSQL)**：強一致性、複雜 JOIN、交易完整性
- **Wide-Column (Cassandra)**：高寫入吞吐量、查詢優先建模、線性水平擴展
- **Document (MongoDB)**：文件中心資料、Schema 彈性、豐富查詢能力
- **Key-Value (Redis)**：快取、速率限制、Idempotency Keys、工作階段

## 知識合約職責
- 提供各儲存技術的比較與選擇框架
- 不替 PRD 做最終儲存選擇

## 不應做的事
- 不替系統選擇特定儲存技術
- 不基於時尚或流行選擇儲存
- 不假設某種儲存適合所有場景