viberoom-web/docs/work.md

Work Order

이 파일은 이번 세션에서 처리할 작업을 적는 실행 입력서다.

작성 규칙

• 작업은 가능한 한 "주제별"로 분리해서 작성한다.
• 한 주제는 가능하면 한 커밋으로 끝낼 수 있게 범위를 좁힌다.
• "금지사항/제외 범위"를 명시해서 불필요한 변경을 막는다.

우선순위

• 위에서 아래 순서대로 높은 우선순위로 간주한다.
• 작업 1을 먼저 처리하고, 완료 시 다음 작업으로 넘어간다.

---

작업 1

• 제목: /space Refocus polish 마무리
• 목적:
  • 10_refocus_system_spec.md 기준으로 pause / refocus / next beat / goal complete를 premium recovery flow로 정리한다.
  • recovery overlay가 planner/checklist처럼 보이지 않게 한다.
• 변경 범위:
  • pause tray
  • refocus tray
  • next beat tray
  • goal complete tray
  • copy / hierarchy / material / motion polish
• 제외 범위:
  • multi-goal / list affordance 추가 금지
  • social/accountability 확장 금지
  • review 통계 확장 금지
• 완료 조건:
  • refocus가 편집 기능이 아니라 recovery ritual처럼 읽힌다.
  • pause / next beat / complete가 한 번에 하나만 보인다.
  • bright/dark scene 모두에서 안정적으로 읽힌다.
• 검증:
  • 브라우저 수동 확인
• 커밋 힌트:
  • feat(space): refocus-system polish

작업 2

• 제목: Away / Return Recovery 구현
• 목적:
  • 11_away_return_recovery_spec.md 기준으로 pause 없이 떠난 사용자의 복귀 흐름을 구현한다.
  • pause, break, return이 같은 멈춤 상태처럼 읽히지 않게 한다.
• 변경 범위:
  • visibilitychange
  • pagehide
  • sleep/wake delta 감지
  • return tray
  • focus ended while away 처리
• 제외 범위:
  • webcam / idle tracking / 감시성 기능 금지
  • planner/list affordance 추가 금지
  • break를 standard pause처럼 재사용 금지
• 완료 조건:
  • focus가 끝난 뒤 복귀하면 바로 standard break로 가지 않는다.
  • return 상태에서 이어가기 / 한 조각 다시 잡기 / 지금부터 쉬기 중 적절한 제안이 나온다.
• 검증:
  • 브라우저 수동 확인 + 상태 전이 점검
• 커밋 힌트:
  • feat(space): away-return-recovery

작업 3

• 제목: Pause / Break / Return 분리 polish
• 목적:
  • 세 상태가 감정적으로도 구조적으로도 다르게 읽히도록 정리한다.
• 변경 범위:
  • 카피
  • material
  • tray hierarchy
  • timer/HUD와의 연결
• 제외 범위:
  • review 통계 확장 금지
  • social/accountability 확장 금지
• 완료 조건:
  • pause는 recovery tone
  • break는 release tone
  • return은 re-entry tone으로 분리된다
  • copy와 CTA hierarchy 2차 분리가 반영된다
  • motion polish 1차가 반영된다
• 검증:
  • 브라우저 수동 확인
  • motion 미세 조정
• 커밋 힌트:
  • feat(space): separate-pause-break-return

작업 4

• 제목: Weekly Review Reframe 구현 준비
• 목적:
  • 14_weekly_review_reframe_spec.md 기준으로 /stats를 행동 변화 중심 review surface로 옮기기 위한 첫 구현 slice를 연다.
• 변경 범위:
  • weekly-review API shape 설계
  • mock summary 구조 재정의
  • /stats IA 재배치 초안
• 제외 범위:
  • planner/dashboard 확장 금지
  • 과한 해석형 카피 금지
  • Premium Ambience 작업 선행 금지
• 완료 조건:
  • /stats가 더 이상 단순 factual card 반복이 아니라 snapshot + start/recovery/completion 구조로 전환되기 시작한다.
• 검증:
  • 상세 spec과 구현 초안 일치
  • 브라우저 구조 확인
• 커밋 힌트:
  • feat(stats): weekly-review-snapshot