KV：為 read-heavy 世界設計

01 / DECISION

何時值得加入這個 primitive

KV 適合 configuration、reference data、cached results 與可容忍 propagation delay 的 read-heavy values。

02 / ARCHITECTURE

建立最小且站得住腳的路徑

選擇穩定 key 與有版本的 value、明確設定 expiration、分開 authoring 與 read path，並定義 stale-read 行為。

1. 01先命名 contract

   KV 適合 configuration、reference data、cached results 與可容忍 propagation delay 的 read-heavy values。

2. 02只加入一個 primitive

   選擇穩定 key 與有版本的 value、明確設定 expiration、分開 authoring 與 read path，並定義 stale-read 行為。

3. 03保留 failure evidence

   從多個地點測試 read-after-write、expiration 與 missing-key path，並證明 consumer 能安全接受 stale version。

03 / REPRODUCE

有證據，再有信心

從多個地點測試 read-after-write、expiration 與 missing-key path，並證明 consumer 能安全接受 stale version。

npx wrangler kv key put --binding=CACHE_KV sample-key sample-value

05 / FIRST-PARTY SOURCES

讓第一方來源保持權威

產品行為、限制、價格與供應狀態會改變；採取行動前請重新核對這些來源。