Files
viberoom-web/docs/session_brief.md
corpi 313ef88961 style(space-hud): 30초 복귀 액션을 숨 고르기 톤으로 리브랜딩
맥락:
- /space 하단 HUD의 30초 복귀 액션을 저자극 감성 톤으로 정리해 복귀 행동의 심리적 부담을 낮춘다.

변경사항:
- restart-30s feature에 카피 상수(model/copy)를 추가하고 버튼/모드/안내 문구를 중앙 관리로 전환했다.
- useRestart30s에 더미 상태 전환(isBreatheMode, hintMessage)을 추가해 클릭 후 2초 내 안내 노출과 자동 복귀를 구현했다.
- HUD에서 30초 진입 중 상태 라벨을 BREATHE로 표시하고, 안내 문구를 목표 라인에 저대비로 잠깐 노출하도록 조정했다.
- 30초 액션 버튼을 "숨 고르기 30초" + 🌬️ 형태의 보조 액션 톤으로 변경했다.
- 세션 복구 문서(90_current_state, session_brief)에 이번 작업 상태/리스크를 반영했다.

검증:
- npx tsc --noEmit

세션-상태: /space 30초 복귀 액션 카피 리브랜딩 및 HUD 더미 안내 반영 완료
세션-다음: RoomSheet/도크 인원수 기반 카피를 큐레이션형 표현으로 전환
세션-리스크: HUD 목표 문구와 안내 문구가 교체 노출되어 정보 우선순위 점검 필요
2026-02-27 14:58:35 +09:00

54 lines
2.8 KiB
Markdown

# Session Brief
Last Updated: 2026-02-27
세션 시작 시 항상 읽는 초소형 스냅샷 문서.
## 고정 규칙 (요약)
- 구현 범위는 UI 목업 + 더미 데이터 + 토스트로 제한한다.
- `page.tsx`는 조합만 담당한다.
- 비즈니스 로직은 `features/entities`로 이동한다.
- 파일이 500줄 이상이면 분리한다.
- 커밋은 주제별 1커밋, 한국어 Conventional Commit으로 작성한다.
## 현재 우선순위
1. `RoomSheetWidget`/도크 패널의 인원 수 UI를 큐레이션형으로 전환
2. 몰입 모드에서 터치 환경 레일 발견성(미니 핸들 UX) 보완 여부 결정
3. `/space` 헤더 최소화 스타일의 밝은 배경 대비 점검
## 최근 세션 상태
- 세션 복구용 문서/템플릿/스크립트가 준비되어 있다.
- `workFlow.md`는 토큰 절약 모드를 사용한다.
- `/space` 하단 사운드 바를 제거하고 오른쪽 `🎧 Sound` 시트로 이동했다.
- `/space` 헤더 프레임을 축소하고 HUD를 하단 safe-area 기준으로 더 밀착시켰다.
- 상단 우측 나가기 액션을 클릭형에서 1초 롱프레스형으로 전환했다.
- 0.05초에 진행률 20%까지 빠르게 상승하는 가속 진행을 적용했다.
- 몰입 OFF는 bar, 몰입 ON은 ring 형태로 진행률을 표시한다.
- 롱프레스 bar 진행 표시를 CSS keyframes 기반으로 교체해 즉시 가시성을 개선했다.
- 완료 후 fill이 0으로 역방향 축소되는 현상을 제거했다.
- fill 끝단은 직선 형태로 정리했다.
- 30초 복귀 액션을 감성 라운지 톤으로 리브랜딩했다.
- 버튼 라벨을 `숨 고르기 30초`로 변경했다.
- HUD 모드 라벨은 진입 시 `BREATHE`로 표시된다.
- 클릭 시 저자극 안내 문구를 HUD 미니 안내 + 토스트로 노출한다.
- 몰입 모드 ON 시 상단 룸 블록 숨김, 레일 미니화, HUD 저대비, 비네팅 강화가 적용된다.
- 이후 작업은 `docs/work.md`를 기준으로 실행한다.
## 리스크
- 네트워크 제한 환경에서는 `npm run build` 시 Google Fonts fetch 실패 가능
- 터치 환경에서 레일 미니 상태가 발견성 낮을 수 있어 UX 보완이 필요할 수 있음
- safe-area가 작은 기기에서는 HUD 하단 간격 체감이 과도할 수 있어 미세 조정이 필요할 수 있음
- 롱프레스 인터랙션은 신규 사용자에게 즉시 인지되지 않을 수 있어 보조 카피가 필요할 수 있음
- bar/ring 진행 구현 방식이 달라 향후 진행 규칙 변경 시 회귀 확인이 필요함
- HUD 안내 문구와 목표 문구가 교체 노출되므로 정보 우선순위 점검이 필요함
## 상세 원문 위치
- 장문 상세 상태: `docs/90_current_state.md`
- 구조 규칙 상세: `docs/02_arch_fsd_rules.md`
- 커밋 규칙 상세: `docs/06_commit_convention.md`