docs(docs): 문서를 화면과 용도별 폴더로 재구성

This commit is contained in:
2026-03-16 11:31:03 +09:00
parent acfa8f4f48
commit 38a9d1e762
25 changed files with 112 additions and 112 deletions

View File

@@ -0,0 +1,44 @@
# 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가 갱신된다.