Files
viberoom-web/docs/context_core.md

57 lines
2.0 KiB
Markdown

# Context Core
세션 시작 시 빠르게 읽는 **초단기 핵심 요약본**이다.
전체 문서 구조는 [README.md](./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](./work.md)
2. [session_brief.md](./session_brief.md)
3. [90_current_state.md](./90_current_state.md)
4. 지금 건드릴 화면의 source-of-truth spec
## 주의
- 오래된 `/app` single-goal gate 문서는 legacy다.
- 문서가 충돌하면 [README.md](./README.md)의 `source-of-truth` 분류가 우선이다.