# 00. Project Brief ## 프로젝트 목적 VibeRoom Web은 ADHD와 프리랜서를 위한 premium focus service의 웹 제품을 설계하고 구현하는 프로젝트다. 핵심 목표는 UX 흐름, 화면 구조, 상호작용 톤, core loop 계약을 실제 제품 품질로 안정적으로 끌어올리는 것이다. ## 기술 스택 - Next.js (App Router) - TypeScript - TailwindCSS - 상태: React state + local storage + 일부 shared store ## 유지보수 역할 정의 이 프로젝트에서 엔지니어의 역할: - FSD 구조를 지키며 화면/기능을 지속적으로 리팩터링한다. - View 계층을 조합 중심으로 유지하고 로직이 새지 않게 막는다. - 감성/저자극 톤을 유지하며 과한 강조 UI를 억제한다. - mock UI만 만드는 데 그치지 않고, core focus/session/review 흐름은 실제 계약과 연결한다. ## 범위와 비범위 범위: - 라우트/위젯/피처 단위 UI 개선 - 더미 데이터 + 실제 계약 혼합 상태 표현 - 모달, 토글, 탭, 선택, 토스트 비범위: - 실시간 인원수/presence 정확도 보장 - 오디오 DSP 수준의 고급 엔진 - 운영 observability 완성 - 모든 주변 기능의 production hardening ## Definition of Done - 요구사항 화면이 동작하고, 기존 톤과 충돌하지 않는다. - FSD, 뷰 무로직, 500줄 분리 규칙을 지킨다. - `/app`, `/space` 등 관련 라우트에서 UX 흐름이 깨지지 않는다. - `docs/90_current_state.md`에 DONE/NEXT/RISKS/CHANGED FILES가 갱신된다.