viberoom-web/docs/foundation/00_project_brief.md

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가 갱신된다.