perf(B05): 3D 코리도를 브라우저 보관함(IndexedDB)에 담아 재수신 없앰

손 안 댄 프로젝트를 열면 저장본 열쇠가 맞아 매번 16.9MB 를 받았고, 브라우저 보관이
모듈 Map 이라 새로고침 한 번에 날아가 또 받았음(보조 창 실측: 첫 로그인~B05 도달 29MB
중 16.9MB 가 이것). 해시 질의(0b30f5b0)는 낡았을 때만 막았지 맞을 때는 그대로였음.

- b_asset_cache 에 readCachedBytes / writeCachedBytes / purgeAssetsWithPrefix 추가.
  앞 둘은 네트워크를 안 타는 순수 보관함 접근이고, 마지막은 주소 앞머리가 같은 옛
  보관본을 지움 — 코리도는 주소에 열쇠가 박혀 정본이 바뀌면 새 주소가 되므로 17MB 짜리가
  쌓이지 않게 담기 전에 치움.
- 코리도 조회가 보관함을 먼저 봄. 주소에 열쇠가 있어 정본이 바뀌면 저절로 다른 주소가
  되므로 옛 보관본을 잘못 쓸 일이 없음.

자체검증(공용 브라우저) — 담기·읽기 왕복 정상(44바이트 왕복, 해시 보존), 열쇠만 다른 두 벌을
담은 뒤 앞머리 지우기로 둘 다 제거 확인. typecheck 통과.
※ 실제 16.9MB 절감은 저장본이 최신인 프로젝트에서 확인해야 함 — 이 프로젝트는 검증 중
계획고를 만져 저장본이 낡은 상태라 코리도 자체가 안 실림(__corridorSource null).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-07 00:18:37 +09:00
co-authored by Claude Opus 5
parent 9b93d3055b
commit e2cc5e759b
2 changed files with 93 additions and 7 deletions
+32 -7
View File
@@ -14,6 +14,11 @@
* ========================================================================== */
import { API_BASE_URL, API_TIMEOUT_MS } from "@config/config_frontend";
import {
purgeAssetsWithPrefix,
readCachedBytes,
writeCachedBytes,
} from "../A00_Common/b_asset_cache";
import type { SectionDetailResponse } from "../B06_Section/B06_Section_Api_Fetch";
import type { RoutePoint } from "./B05_Profile_Api_Fetch";
import { buildCorridor, type CorridorBuildResult } from "./B05_Profile_UI_Corridor_Build";
@@ -60,31 +65,51 @@ async function requestCorridor(path: string, init: RequestInit): Promise<Respons
/** 저장본 조회 결과 — 파일을 받았거나, 열쇠가 어긋나 안 받았거나, 아예 없거나. */
type StoredLookup =
| { kind: "envelope"; envelope: CorridorEnvelope }
| { kind: "stale" }
| { kind: "missing" };
{ kind: "envelope"; envelope: CorridorEnvelope } | { kind: "stale" } | { kind: "missing" };
/**
* 저장본을 가져온다. **열쇠(hash)를 함께 보내면 서버가 먼저 맞춰 본다** — 어긋나면
* 파일 대신 수십 바이트짜리 `stale` 만 온다(2026-09-06). 그 전에는 18.6MB 를 다 받은 뒤
* 해시가 다르다고 버렸다.
*/
/** 이 노선 코리도의 보관 주소 앞머리 — 열쇠만 다른 옛 보관본을 치울 때 쓴다. */
function corridorUrlPrefix(projectId: string, routeId: number): string {
return `${API_BASE_URL}/projects/${projectId}/routes/${routeId}/corridor`;
}
async function fetchStored(
projectId: string,
routeId: number,
hash: string,
): Promise<StoredLookup> {
const url = `${corridorUrlPrefix(projectId, routeId)}?hash=${encodeURIComponent(hash)}`;
try {
// **브라우저 보관함을 먼저 본다**(2026-09-06) — 저장본이 최신이면 열쇠가 맞아 매번
// 17MB 를 받았고, 새로고침 한 번이면 메모리 캐시가 날아가 또 받았다. 주소에 열쇠가
// 박혀 있으므로 정본이 바뀌면 저절로 다른 주소가 되어 옛 보관본을 안 쓴다.
const cached = await readCachedBytes(projectId, url);
if (cached) {
const payload = JSON.parse(new TextDecoder().decode(cached)) as CorridorEnvelope;
if (payload?.version === ENVELOPE_VERSION && Array.isArray(payload.ribbons)) {
return { kind: "envelope", envelope: payload };
}
}
const response = await requestCorridor(
`/projects/${projectId}/routes/${routeId}/corridor?hash=${encodeURIComponent(hash)}`,
{ method: "GET" },
);
if (!response.ok) return { kind: "missing" };
const payload = (await response.json()) as CorridorEnvelope & { status?: string };
const text = await response.text();
const payload = JSON.parse(text) as CorridorEnvelope & { status?: string };
if (payload?.status === "stale") return { kind: "stale" };
return payload && payload.version === ENVELOPE_VERSION && Array.isArray(payload.ribbons)
? { kind: "envelope", envelope: payload }
: { kind: "missing" };
if (payload && payload.version === ENVELOPE_VERSION && Array.isArray(payload.ribbons)) {
// 담기 전에 열쇠만 다른 옛 보관본을 치운다 — 17MB 짜리가 쌓이지 않게.
void purgeAssetsWithPrefix(projectId, corridorUrlPrefix(projectId, routeId)).then(() =>
writeCachedBytes(projectId, url, new TextEncoder().encode(text).buffer as ArrayBuffer),
);
return { kind: "envelope", envelope: payload };
}
return { kind: "missing" };
} catch {
return { kind: "missing" }; // 저장본 조회 실패는 빌드로 폴백 — 표시를 막지 않는다.
}