viberoom-web/docs/context_core.md

Context Core

세션 시작 시 빠르게 읽는 초단기 핵심 요약본이다.

전체 문서 구조는 README.md에서 본다.

제품 핵심

• VibeRoom Web은 ADHD와 프리랜서를 위한 premium focus service다.
• 핵심 루프는 commit -> enter -> immerse -> pause/return -> complete -> review다.
• /app은 planning dashboard가 아니라 entry stage다.
• /space는 dashboard가 아니라 execution sanctuary다.
• /stats는 summary page가 아니라 다음 세션 성공률을 높이는 review다.

현재 화면 기준

/app

• current session이 running이면 /space가 우선이다.
• current session이 paused이면 /app resume gate가 우선이다.
• no-session 상태의 source-of-truth는 goal + duration + atmosphere entry shell이다.
• microStep은 /app에서 입력하지 않는다.

/space

• goal card는 collapsed / expanded rail 구조다.
• pause, return, next beat, goal complete는 한 번에 하나만 열린다.
• active session에서는 closure 경로가 항상 남아 있어야 한다.

/stats

• review는 snapshot / start quality / recovery quality / completion quality / carry forward 구조다.
• primary entry는 /app, secondary entry는 /space complete 이후 setup이다.

구현 규칙 요약

• page.tsx는 조합만 담당한다.
• 레이어 규칙:
  • app -> widgets/features/entities/shared
  • widgets -> features/entities/shared
  • features -> entities/shared
  • entities -> shared
• UI는 premium ambient focus 톤을 유지한다.
• 한 화면에는 primary CTA를 1개만 둔다.

작업 시작 순서

1. work.md
2. session_brief.md
3. 90_current_state.md
4. 지금 건드릴 화면의 source-of-truth spec

주의

• 오래된 /app single-goal gate 문서는 legacy다.
• 문서가 충돌하면 README.md의 source-of-truth 분류가 우선이다.