docs(session): 추천 자동화/override 흐름 기준으로 세션 상태 갱신

맥락:
- workflow 종료 규칙에 따라 현재 구현 상태와 다음 리스크를 세션 복구 문서에 반영해야 했습니다.

변경사항:
- docs/90_current_state.md의 DONE/NEXT/RISKS/CHANGED FILES를 Scene 추천 자동화, override, Control Center 단순화, 로컬 저장/복원 기준으로 업데이트했습니다.
- docs/session_brief.md의 현재 우선순위/최근 세션 상태/리스크를 최신 구현 상태로 압축 갱신했습니다.

검증:
- 문서 갱신 작업(코드 검증 없음)

세션-상태: 세션 복구 문서가 현재 코드 상태와 다음 작업 우선순위를 반영합니다.
세션-다음: work.md의 다음 작업 지시를 기준으로 구현을 이어갑니다.
세션-리스크: docs/work.md와 docs/01_ui_guidelines.md의 사용자 수정분은 별도 검토 없이 유지 중입니다.
This commit is contained in:
2026-03-05 12:27:24 +09:00
parent 478159f787
commit c9817f518e
2 changed files with 49 additions and 11 deletions

View File

@@ -1,6 +1,6 @@
# Session Brief
Last Updated: 2026-02-28
Last Updated: 2026-03-05
세션 시작 시 항상 읽는 초소형 스냅샷 문서.
@@ -14,12 +14,25 @@ Last Updated: 2026-02-28
## 현재 우선순위
1. `RoomSheetWidget`/도크 패널의 인원 수 UI를 큐레이션형으로 전환
2. 몰입 모드에서 터치 환경 레일 발견성(미니 핸들 UX) 보완 여부 결정
3. `/space` 헤더 최소화 스타일의 밝은 배경 대비 점검
1. Scene 추천 매핑 품질 점검(공간별 사운드/타이머 추천값 보정)
2. override 정책(수동 선택 후 Scene 변경 시 유지)의 사용자 기대치 검증
3. 터치 환경 도구 레일 발견성(미니 핸들 UX) 보완 여부 결정
## 최근 세션 상태
- `/space`에 Scene 추천 자동 적용 규칙을 도입했다.
- Room 데이터에 `recommendedSoundPresetId`, `recommendedTimerPresetId`를 추가했다.
- 초기 진입/Scene 변경 시 override가 없는 항목만 추천값으로 자동 반영된다.
- `/space`에 override 상태(`sound`, `timer`)를 추가했다.
- 사용자가 직접 고른 사운드/타이머는 Scene 변경에도 자동 덮어쓰지 않는다.
- `추천으로 되돌리기(더미)` 액션으로 override 초기화 + 추천값 즉시 복원이 가능하다.
- Control Center를 Scene/Time 중심으로 단순화했다.
- Sound/Preset Packs 섹션 제거
- 추천 정보 1줄 + `추천으로 되돌리기`만 유지
- 우하단 Sound Quick 선택 경로를 `onQuickSoundSelect`로 분리해 override.sound 규칙을 명시했다.
- `/space` 선택 상태 로컬 저장/복원을 추가했다.
- 저장: `sceneId`, `timerPresetId`, `soundPresetId`, `override(sound/timer)`
- 복원 우선순위: 쿼리 파라미터 > 저장 상태 > Scene 추천
- 세션 복구용 문서/템플릿/스크립트가 준비되어 있다.
- `workFlow.md`는 토큰 절약 모드를 사용한다.
- `/space` 하단 사운드 바를 제거하고 오른쪽 `🎧 Sound` 시트로 이동했다.
@@ -80,6 +93,8 @@ Last Updated: 2026-02-28
## 리스크
- 네트워크 제한 환경에서는 `npm run build` 시 Google Fonts fetch 실패 가능
- localStorage 저장 포맷 변경 시 이전 세션 데이터와의 호환성 이슈가 생길 수 있음
- Scene 추천값이 사용자 선호와 어긋나면 자동 추천 체감 품질이 낮을 수 있음
- 터치 환경에서 레일 미니 상태가 발견성 낮을 수 있어 UX 보완이 필요할 수 있음
- safe-area가 작은 기기에서는 HUD 하단 간격 체감이 과도할 수 있어 미세 조정이 필요할 수 있음
- 롱프레스 인터랙션은 신규 사용자에게 즉시 인지되지 않을 수 있어 보조 카피가 필요할 수 있음