Files
clean-architecture-frontend…/docs/operations
DongHyeonka b4ae4c1ed3 docs(operations): waiting 기간에 소유 캐시가 쌓이는 것과 정리 시점을 적는다
문제
캐시를 지우는 곳은 activate 하나다(현재 + 마커가 가장 높은 직전 1개).
템플릿은 requestActivation()을 부르지 않으므로 활성화는 그 scope의
탭이 모두 닫혀야 일어난다. 그 사이 release마다 새 후보가 waiting
워커를 밀어내지만 밀려난 캐시는 남는다(리뷰 실험 L2: A 활성 + 탭
유지에서 B, C를 받으면 소유 캐시 3개, 활성화 뒤 2개). 운영 문서는
"현재 + 직전 1개"만 말해 waiting 기간의 캐시 수가 보이지 않는다.

고른 방법
- 리뷰 5.1 판단대로 (a) 문서만 고친다. SW runbook 8절에 쌓이는 규칙,
  예, 크기 상한, 쿼터에 닿았을 때의 결과, 줄이는 방법
  (requestActivation 화면)과 install이 지우지 않는 이유를 적는다.
  release-cache-rollback.md SW 1단계에 한 문장과 링크를 둔다.
- 버린 대안: (b) install 성공 뒤 "무마커 + 이번 후보 아님 + 활성 캐시
  아님"을 지우기. install하는 워커는 활성 캐시 이름을 모르고, 마커
  쓰기에 실패한 활성 캐시는 후보와 구별되지 않는다. (c) 이번 후보를 뺀
  무마커 캐시를 모두 지우기. 그 활성 캐시를 지워 직전 캐시 보존 성질을
  깬다.

위험·한계
- 쌓이는 동작 자체는 그대로다. 사전 캐시가 1 MiB를 넘고 release가 잦아
  지면 (b)를 다시 본다(리뷰 재검토 조건).
- 브라우저 종료로 활성화되는지는 확인하지 않았다.

검증
- 문서와 코드(service-worker-lifecycle.ts onActivate,
  service-worker-static-assets.ts QUOTA_EXCEEDED, service-worker.ts
  assetSetBytes)를 대조했다.

Refs: docs/reviews/2026-11-03-maturity-review/06-adapters-service-worker-push.md 06-04
2026-11-04 20:27:30 +09:00
..