Files
viberoom-web/README.md
corpi cbd9017744 feat(fsd): 허브·스페이스 중심 UI 목업 구조로 재편
맥락:

- 기존 라우트/컴포넌트 구조를 FSD 기준으로 정리하고, /app 허브와 /space 집중 화면 중심의 목업 흐름을 구성하기 위해

변경사항:

- App Router 구조를 /landing, /app, /space, /stats, /settings 중심으로 재배치

- entities/session/room/user 더미 데이터와 타입 정의 추가

- features(커스텀 입장, 룸 선택, 체크인, 리액션, 30초 리스타트 등) 단위로 로직 분리

- widgets(허브, 룸 갤러리, 타이머 HUD, 툴 도크 등) 조합형 UI 추가

- shared 공용 UI(Button/Chip/Modal/Toast 등) 및 유틸(cn/useReducedMotion) 정비

- 로그인 후 이동 경로를 /dashboard 에서 /app 으로 변경

- README를 현재 프로젝트 구조/라우트/구현 범위 기준으로 갱신

검증:

- npx tsc --noEmit

세션-상태: 허브·스페이스 목업이 FSD 레이어로 동작 가능하도록 정리됨

세션-다음: /space 상단 및 도크의 인원 수 카피를 분위기형 카피로 후속 정리

세션-리스크: build는 네트워크 환경에서 Google Fonts fetch 실패 가능
2026-02-27 13:30:55 +09:00

50 lines
1.4 KiB
Markdown

# VibeRoom Web
Next.js(App Router) + TypeScript + TailwindCSS 기반 VibeRoom 프론트엔드입니다.
## 실행 방법
```bash
npm install
npm run dev
```
브라우저에서 `http://localhost:3000` 접속
## 주요 라우트
- `/` : Landing 페이지 (`src/app/(landing)/page.tsx`)
- `/app` : 가상공간 입장 허브
- `/space` : 집중공간 스켈레톤
- `/stats` : 집중 통계 목업
- `/settings` : 설정 목업
- `/login` : 로그인
## 구조
FSD 스타일로 `src/` 하위 레이어를 사용합니다.
- `src/entities` : room/user/session 타입 + 더미 데이터
- `src/features` : room-select/check-in/reactions/custom-entry-modal/profile-menu/distraction-dump
- `src/widgets` : 페이지 섹션 단위 UI (TopBar, StartRitual, RoomsGallery, SpaceShell 등)
- `src/shared` : 공용 UI, 유틸, 설정
- `src/app` : App Router 페이지 조합
## 구현 범위
이번 변경은 **UI 목업** 중심입니다.
- 타이머 카운트다운/오디오 재생/실시간/DB 저장/API 호출 미구현
- 선택 하이라이트, 패널 토글, 모달 탭, 드롭다운, 라우팅, 토스트만 구현
## 문서(작업 재개용)
세션이 끊겨도 같은 품질로 이어서 작업하려면 아래 문서를 먼저 확인합니다.
- `docs/README.md`
- `docs/00_project_brief.md`
- `docs/01_ui_guidelines.md`
- `docs/02_arch_fsd_rules.md`
- `docs/03_routes_map.md`
- `docs/90_current_state.md`