diff --git a/docs/architecture/client-cache-and-storage.md b/docs/architecture/client-cache-and-storage.md index 8e7143d6..95922e0e 100644 --- a/docs/architecture/client-cache-and-storage.md +++ b/docs/architecture/client-cache-and-storage.md @@ -47,9 +47,11 @@ generation마다 `QueryClient`를 만들고, query retry를 끄며, 30초 `stale `src/bootstrap/runtime-application.tsx`가 이 client를 실제 provider tree에 조립한다. -현재 `src/contracts/storage-keys.ts`에는 `COLOR_SCHEME`, -`CHUNK_RELOAD_GUARD`, 금지된 `AUTH_TOKEN`과 비활성 -`QUERY_PERSISTENCE`가 등록되어 있다. +등록된 Web Storage 키의 정본은 `src/contracts/storage-keys.ts`의 +`STORAGE_REGISTRY`다. 이 문서는 행 목록을 옮겨 적지 않는다. 옮겨 적은 목록은 +행이 늘 때 따라오지 않았다(1106/05-01). StoragePort(`getStorageDefinition`)는 +`classification: "sensitive-forbidden"` 행과 `backend: "external"` 행을 거절하고 +나머지 행만 읽고 쓴다. `src/adapters/storage/browser-storage-codec.ts`와 `browser-storage-adapter.ts`는 closed JSON codec, 기본 16,384-byte 상한, schema envelope, TTL과 동일 envelope를 쓰는 memory fallback을 제공한다. @@ -132,7 +134,7 @@ blocked/versionchange를 다루는 reference runtime이 있다. 이 설계는 | --- | --- | --- | --- | --- | | memory QueryClient | `COMPOSED` | server-state generation별 생성(session identity 변경 시 FENCED 뒤 새 client), global stale/gc/retry default | per-query policy | `DESIGNED_NOT_IMPLEMENTED` | | application query bridge | `COMPOSED` | AbortSignal, stale error, optimistic rollback/conflict surface | old-generation query/mutation callback 폐기 | `DESIGNED_NOT_IMPLEMENTED` | -| Web Storage | `COMPOSED` | 두 key, strict v1 envelope/codec, lazy TTL, global 16 KiB cap | per-key cap, HIT/MISS, durability, v2 scope, migration, sweep/logout | `DESIGNED_NOT_IMPLEMENTED` | +| Web Storage | `COMPOSED` | `STORAGE_REGISTRY`의 StoragePort 행, strict v1 envelope/codec, lazy TTL, global 16 KiB cap | per-key cap, HIT/MISS, durability, v2 scope, migration, sweep/logout | `DESIGNED_NOT_IMPLEMENTED` | | cross-tab invalidation | `COMPOSED` | release epoch(FNV-1a digest), versioned hint, duplicate/gap, BC→localStorage, registry pulse key, storageArea 동일성 검사, generation별 transport | composite scope epoch, durable ledger hook | `DESIGNED_NOT_IMPLEMENTED` | | generic IndexedDB | `AVAILABLE_NOT_COMPOSED` | reusable repository/maintenance runtime | product dataset schema/codec/query/policy composition | product selection `NOT_SELECTED` | | query persistence facade | `DESIGNED_NOT_IMPLEMENTED` | 없음, registry가 disabled 강제 | stable per-query record, bounded restore, namespace epoch/CAS | `DESIGNED_NOT_IMPLEMENTED` | @@ -1403,8 +1405,7 @@ invalidate-only runtime은 installed query contract가 실제로 소비하므로 | capability | 기본 | | --- | --- | | TanStack memory QueryClient | `COMPOSED` | -| 등록된 COLOR_SCHEME localStorage | `COMPOSED` | -| 등록된 CHUNK_RELOAD_GUARD sessionStorage | `COMPOSED` | +| `STORAGE_REGISTRY`의 StoragePort 행(`localStorage`·`sessionStorage`) | `COMPOSED` | | generic IndexedDB repository/maintenance reference | `AVAILABLE_NOT_COMPOSED` | | IndexedDB query persistence facade | `DESIGNED_NOT_IMPLEMENTED` | | product query persistence | `NOT_SELECTED` | diff --git a/docs/architecture/decisions/VD-13-client-cache-scope-and-persistence.md b/docs/architecture/decisions/VD-13-client-cache-scope-and-persistence.md index 571fbd94..b7c79db4 100644 --- a/docs/architecture/decisions/VD-13-client-cache-scope-and-persistence.md +++ b/docs/architecture/decisions/VD-13-client-cache-scope-and-persistence.md @@ -63,7 +63,7 @@ runtime의 구현 상태고, 후자는 제품 capability 선택 상태다. 하 | capability | 현재 상태 | 현재 보장 | | --- | --- | --- | | TanStack Query memory runtime | `COMPOSED` | runtime별 QueryClient, finite inactive GC, retry owner, query AbortSignal | -| registered Web Storage | `COMPOSED` | `COLOR_SCHEME`, `CHUNK_RELOAD_GUARD`만 strict codec/envelope로 사용 | +| registered Web Storage | `COMPOSED` | `STORAGE_REGISTRY`의 StoragePort 행만 strict codec/envelope로 사용. 행 목록은 `src/contracts/storage-keys.ts`가 정본이다 | | invalidate-only cross-tab runtime | `COMPOSED` | versioned topic, BroadcastChannel 우선, localStorage pulse fallback | | generic IndexedDB repository/maintenance runtime | `AVAILABLE_NOT_COMPOSED` | CAS, idempotency, transaction complete, policy binding, bounded lifecycle/migration | | session/account-scoped QueryClient lifecycle | `DESIGNED_NOT_IMPLEMENTED` | 없음; 현재 cache epoch는 release ID만 포함 | @@ -392,8 +392,10 @@ type WebStorageDefinition = Readonly<{ | 한 sweep에서 검사할 key | 16 | | 한 read에서 migration step | 2 | -현재 두 key는 각각 더 좁은 codec을 유지한다. `COLOR_SCHEME`은 public -origin-shared preference이고 `CHUNK_RELOAD_GUARD`는 tab session control이다. +현재 StoragePort 행은 행마다 더 좁은 `valueCodec`(`color-scheme-v1`, +`opaque-string-v1`)을 유지한다. `localStorage` 행은 public origin-shared +preference이고 `sessionStorage` 행은 tab session control이다. 행 목록은 +`src/contracts/storage-keys.ts`의 `STORAGE_REGISTRY`가 정본이다. server response, credential, signed URL, File/Blob, large draft와 queue를 Web Storage에 넣지 않는다.