style(space): stage 배경 overscan과 문서 상태 갱신

맥락:
- space stage 배경 pan 애니메이션 중 가장자리 빈틈이 보일 수 있었다.
- 관련 코드와 세션 문서 상태를 함께 맞춰둘 필요가 있었다.

변경사항:
- SpaceWorkspaceWidget 의 stage background layer 를 로 확장했다.
- 90_current_state, session_brief 에 overscan 보정과 관련 리스크를 반영했다.
- work.md 를 다음 브라우저 QA 작업 기준으로 갱신했다.

검증:
- npx tsc --noEmit

세션-상태: stage 배경 overscan 보정과 문서 정리를 마쳤다.
세션-다음: forest/green-forest manifest 변형을 실제 브라우저에서 QA 한다.
세션-리스크: overscan 으로 좁은 화면에서 배경 crop 체감이 조금 더 커질 수 있다.
This commit is contained in:
2026-03-11 13:46:59 +09:00
parent 4717bb3a1a
commit 7867bd39ca
4 changed files with 18 additions and 13 deletions

View File

@@ -17,22 +17,21 @@
## 작업 1
- 제목: Space 배경 asset 해석 안정화 - forest R2 배경 fallback 제거
- 제목: Space 배경 QA - forest / green-forest manifest 변형 검증
- 목적:
- `/space`에서 `forest` 배경이 R2 asset 대신 기본 이미지로 조용히 fallback 되는 원인을 제거한다.
- scene asset miss가 나도 원인을 코드상 추적 가능하게 만들어 재발을 막는다.
- 최근 적용한 scene alias/fallback 보강이 실제 브라우저에서 기대대로 동작하는지 확인한다.
- `forest``green-forest` 두 manifest 변형 모두에서 같은 배경이 표시되는지 검증한다.
- 변경 범위:
- media manifest의 scene asset key를 scene alias까지 고려해 해석하도록 보강
- `/space` 배경이 scene asset miss 또는 manifest load 실패 시 조용히 기본 이미지로만 끝나지 않도록 진단 정보 추가
- 기존 sound playback 동작과 UI 흐름은 유지
- 로컬 또는 스테이징 환경에서 `/space?scene=forest` 진입 확인
- manifest의 `sceneId=forest` / `sceneId=green-forest` 두 경우 모두 동일 배경 적용 확인
- manifest 실패 시 HUD 메시지/console 진단 로그 노출 확인
- 제외 범위:
- 백엔드 manifest 스키마 변경 금지
- 추가 코드 수정 금지
- R2 업로드 파이프라인 수정 금지
- focus timer / session / audio 동작 변경 금지
- 완료 조건:
- `forest``green-forest` 어느 key로 scene asset이 내려와도 `/space`에서 같은 asset을 찾는다.
- remote manifest를 못 읽는 경우 원인을 코드상 드러낼 수 있다.
- 두 scene key 변형 모두에서 같은 forest 배경이 노출된다.
- manifest 실패 시 조용한 fallback만 남지 않고 진단 정보가 확인된다.
- 검증:
- `npx tsc --noEmit`
- 브라우저 수동 확인
- 커밋 힌트:
- fix(space): 배경 asset fallback 경로와 scene alias 해석 보강
- chore(qa): space 배경 alias/fallback 브라우저 검증