corpi
4717bb3a1a
맥락: - /space 에서 forest 배경이 remote manifest asset 대신 기본 이미지로 조용히 fallback 될 수 있었다. - scene key alias 와 manifest 실패 상태가 코드상 드러나지 않아 원인 추적이 어려웠다. 변경사항: - media scene asset key 를 alias-aware 하게 정규화하고 asset source(fallback|remote) 메타를 추가했다. - useMediaCatalog 가 remote manifest 실패와 fallback 사용 여부를 노출하도록 보강했다. - SpaceWorkspaceWidget 에서 manifest 실패와 scene fallback 사용을 진단 로그/상태 메시지로 남기도록 정리했다. - docs/work.md, docs/90_current_state.md, docs/session_brief.md 를 이번 작업 기준으로 갱신했다. 검증: - npx tsc --noEmit 세션-상태: /space 배경 asset lookup 과 manifest fallback 진단을 보강했다. 세션-다음: forest/green-forest manifest 변형을 실제 브라우저에서 QA 한다. 세션-리스크: alias 목록 밖의 legacy scene id 는 추가 정규화가 필요할 수 있다.
1.6 KiB
1.6 KiB
Work Order
이 파일은 이번 세션에서 처리할 작업을 적는 실행 입력서다.
작성 규칙
- 작업은 가능한 한 "주제별"로 분리해서 작성한다.
- 한 주제는 가능하면 한 커밋으로 끝낼 수 있게 범위를 좁힌다.
- "금지사항/제외 범위"를 명시해서 불필요한 변경을 막는다.
우선순위
- 위에서 아래 순서대로 높은 우선순위로 간주한다.
작업 1을 먼저 처리하고, 완료 시 다음 작업으로 넘어간다.
작업 1
- 제목: Space 배경 asset 해석 안정화 - forest R2 배경 fallback 제거
- 목적:
/space에서forest배경이 R2 asset 대신 기본 이미지로 조용히 fallback 되는 원인을 제거한다.- scene asset miss가 나도 원인을 코드상 추적 가능하게 만들어 재발을 막는다.
- 변경 범위:
- media manifest의 scene asset key를 scene alias까지 고려해 해석하도록 보강
/space배경이 scene asset miss 또는 manifest load 실패 시 조용히 기본 이미지로만 끝나지 않도록 진단 정보 추가- 기존 sound playback 동작과 UI 흐름은 유지
- 제외 범위:
- 백엔드 manifest 스키마 변경 금지
- R2 업로드 파이프라인 수정 금지
- focus timer / session / audio 동작 변경 금지
- 완료 조건:
forest와green-forest어느 key로 scene asset이 내려와도/space에서 같은 asset을 찾는다.- remote manifest를 못 읽는 경우 원인을 코드상 드러낼 수 있다.
- 검증:
npx tsc --noEmit
- 커밋 힌트:
- fix(space): 배경 asset fallback 경로와 scene alias 해석 보강