Files
viberoom-web/docs/work.md

112 lines
3.6 KiB
Markdown

# Work Order
이 파일은 이번 세션에서 처리할 작업을 적는 실행 입력서다.
## 작성 규칙
- 작업은 가능한 한 "주제별"로 분리해서 작성한다.
- 한 주제는 가능하면 한 커밋으로 끝낼 수 있게 범위를 좁힌다.
- `finding -> fix -> docs -> validation -> commit`까지 한 라운드에서 닫는다.
- browser QA가 필요한 작업은 반드시 완료 조건에 명시한다.
## 우선순위
- 위에서 아래 순서대로 높은 우선순위로 간주한다.
- `작업 1`을 먼저 처리하고, 완료 시 다음 작업으로 넘어간다.
---
## 작업 1
- 제목: `/app` Atmosphere Entry Shell
- 목적:
- `docs/screens/app/current/19_app_atmosphere_entry_spec.md` 기준으로 `/app` no-session 상태를 `goal + duration + atmosphere` 중심의 premium entry screen으로 재설계한다.
- entry에서 scene/sound의 감각 품질을 다시 살리되 planner/dashboard 톤으로 흐르지 않게 만든다.
- 변경 범위:
- no-session `/app` shell
- atmosphere dummy 12개
- goal input
- duration input
- 4x3 atmosphere grid
- primary CTA
- 제외 범위:
- `/space` recovery UX 재설계 금지
- weekly review 상세 IA 변경 금지
- server contract 변경 금지
- 완료 조건:
- current session이 없을 때만 새 entry shell이 보인다
- goal + duration + selected atmosphere가 start surface 안에서 명확히 읽힌다
- 12개 dummy atmosphere가 4열 그리드로 배치된다
- 진행 상태:
- 구현 완료, browser QA 대기
- 검증:
- `/app` no-session browser QA
- 커밋 힌트:
- feat(app): atmosphere entry shell 1차 구현
## 작업 2
- 제목: `Custom Duration Contract`
- 목적:
- `/app`의 분 단위 duration 입력을 실제 세션 길이로 반영한다.
- 변경 범위:
- web start payload
- server startSession contract
- break duration 정책
- `/space` timer 연동
- 제외 범위:
- weekly review recommendation 확장 금지
- atmosphere personalization 금지
- 완료 조건:
- `70분` 같은 값이 실제 focus duration으로 반영된다
- break duration이 정책 기준으로 계산된다
- 진행 상태:
- 다음 작업
- 검증:
- start -> `/space` -> timer duration 확인
- 커밋 힌트:
- feat(flow): custom duration contract 연결
## 작업 3
- 제목: `Weekly Review Dock Reposition`
- 목적:
-`/app` entry shell 안에서 weekly review를 start를 방해하지 않는 quiet secondary dock로 재배치한다.
- 변경 범위:
- `/app` review teaser placement
- desktop/mobile responsive placement
- review return hint placement
- 제외 범위:
- `/stats` IA 변경 금지
- `/space` recovery UX 재설계 금지
- 완료 조건:
- review entry는 항상 발견 가능하지만 start보다 앞서지 않는다
- no-session shell 안에서만 quiet secondary dock로 읽힌다
- 진행 상태:
- 대기
- 검증:
- `/app` no-session browser QA
- 커밋 힌트:
- fix(app): review dock 위치 재정렬
## 작업 4
- 제목: `Core Loop Alignment Audit` browser slice
- 목적:
-`/app` entry shell까지 포함한 핵심 흐름을 브라우저에서 실제로 검증한다.
- 변경 범위:
- `/app` no-session
- current session 상태에서 `/app -> /space` redirect
- `/app -> /stats -> /app`
- `/space` pause / return / next beat / complete
- `/space` complete -> setup -> weekly review entry
- 제외 범위:
- new feature 추가 금지
- 완료 조건:
- browser QA findings가 ledger에 반영된다
- P1/P2 mismatch는 수정 대상 라운드로 분리된다
- 검증:
- manual browser QA
- 커밋 힌트:
- docs(qa): core-loop browser audit 기록