MAKITTHandoff
Handoff Boards
finishednode-snapshot-rendering

Node Snapshot Rendering — E2E 핸드오프 보드

Node Snapshot Rendering — E2E 핸드오프 보드

✅ Closed 2026-05-11. spec 진행 중 발견한 9가지 hard-won 깨달음 + 매트릭스 통과 기록 보존. 운영자 가이드는 docs/E2E_PLAYBOOK.md §3.4 + /snapshot-node skill.

스펙: README.md

목표 한 줄: henriette 의 컴포넌트/fragment/모달을 격리 PNG 로 받기.


본 spec 의 핵심 메커니즘은 통과했고, 아래 항목은 운영 진입 / 시각 회귀 자동화 단계에서 별도 spec 으로 승격할 것:

  • i18n (locale=ja) — 동적 resource 까지 적용 — 현재 SSR 의 정적 텍스트 (compiled translations) 는 ja 적용되지만 header.current 같은 runtime API 응답은 KR 그대로. compiler /node-snapshot → shop /snapshot 호출 시 X-Dev-Language 헤더를 shop-api fetch 에 주입해야 함. shop 의 resource fetcher (api client) 가 이 헤더를 어떻게 흐르게 할지 추적 필요.
  • PDP 매트릭스 fan-out — (locale × currency) 9 조합 + 다른 product slug 로 회귀 baseline 정착.
  • 결정론 검증 (S5) — 같은 입력 5회 호출 → sha256 동일성 측정.
  • 회귀 detect (S6) — token 변경 → 재캡처 → diff 검출. baseline 저장 정책 동반 (별도 node-snapshot-baselines spec).
  • dev gate 재도입 — 운영 진입 전 SNAPSHOT_ENABLED=true 환경 + 인증 헤더 게이트 복원 (shop /snapshot + compiler /node-snapshot 양쪽).
  • modal payload override (선택) — 현재 inputs 가 노드 props 만 merge → 모달 payload 변형 시 SnapshotOpener 의 payload 인자로 흘러야 함. inputs._modalPayload convention 또는 별도 query param 으로 노출 검토.
  • caching (compiler 메모리 LRU) — 같은 (versionId, nodeId, locale, currency, customerId, urlParams) tuple 매번 13s. /save 호출 시 invalidate.
  • CI 통합 — PR 마다 영향받는 fragment 자동 fan-out + diff 코멘트 (baseline 정착 후).

비어 있음

당신이 처리할 항목

docs / spec / finished / node-snapshot-rendering / e2e.md