Context: - codex cli 중단 후에도 작업 품질과 맥락을 안정적으로 복구하기 위해 Changes: - docs/00~07, 90 문서 세트 추가/정리 - commit convention 문서 및 .gitmessage-session.txt 템플릿 추가 - scripts/session/recover-context.sh 추가 - package.json에 session:recover 스크립트 추가 Validation: - npm run session:recover Session-State: session recovery docs, template, and script are in place Session-Next: apply this commit format to feature and refactor commits Session-Risks: legacy commits before this change do not include session trailers
1.4 KiB
1.4 KiB
00. Project Brief
프로젝트 목적
VibeRoom Web은 몰입 공간 경험을 빠르게 실험하기 위한 프론트엔드 목업 프로젝트다.
핵심 목표는 실제 기능 완성보다 UX 흐름, 화면 구조, 상호작용 톤을 안정적으로 검증하는 것이다.
기술 스택
- Next.js (App Router)
- TypeScript
- TailwindCSS
- 상태: React state + 일부 Zustand
유지보수 역할 정의
이 프로젝트에서 엔지니어의 역할:
- FSD 구조를 지키며 화면/기능을 지속적으로 리팩터링한다.
- View 계층을 조합 중심으로 유지하고 로직이 새지 않게 막는다.
- 감성/저자극 톤을 유지하며 과한 강조 UI를 억제한다.
- 실제 서비스 로직은 구현하지 않고, 더미 데이터와 토스트로 흐름만 검증한다.
범위와 비범위
범위:
- 라우트/위젯/피처 단위 UI 개선
- 더미 데이터 기반 상태 표현
- 모달, 토글, 탭, 선택, 토스트
비범위:
- 실시간 인원수/presence 정확도 보장
- 타이머 카운트다운 실제 동작
- 오디오 재생 엔진
- 서버/DB/API 연동 완성
Definition of Done
- 요구사항 화면이 동작하고, 기존 톤과 충돌하지 않는다.
- FSD, 뷰 무로직, 500줄 분리 규칙을 지킨다.
/app,/space등 관련 라우트에서 UX 흐름이 깨지지 않는다.docs/90_current_state.md에 DONE/NEXT/RISKS/CHANGED FILES가 갱신된다.