viberoom-web/docs/foundation/03_routes_map.md

03. Routes Map

라우트 개요

• / -> src/app/(landing)/page.tsx
• /login -> src/app/(auth)/login/page.tsx
• /app -> src/app/(app)/app/page.tsx
• /space -> src/app/(app)/space/page.tsx
• /stats -> src/app/(app)/stats/page.tsx
• /settings -> src/app/(app)/settings/page.tsx

주요 라우트 조합

/app (허브)

• Page: src/app/(app)/app/page.tsx
• Core Widget: src/widgets/focus-dashboard/ui/FocusDashboardWidget.tsx
• 주요 구성:
  • FocusDashboardWidget
  • paused Resume Gate
  • no-session Atmosphere Entry Shell (기획 기준, 구현 예정)
• 데이터 소스:
  • current session: features/focus-session
  • weekly review: features/stats
  • atmosphere 선택 데이터: entry slice 구현 예정

/space (집중 화면)

• Page: src/app/(app)/space/page.tsx
• Core Widget: src/widgets/space-workspace/ui/SpaceWorkspaceWidget.tsx
• 주요 구성:
  • SpaceTimerHudWidget
  • SpaceFocusHudWidget
  • SpaceSetupDrawerWidget
  • SpaceToolsDockWidget
  • features/restart-30s (HUD 내 조합)

/space 쿼리 파라미터

• room: 공간 id
• sound: 사운드 preset id
• timer: 타이머 라벨
• goal: 목표 한 줄 (선택)
• resume: continue | refocus

변경 시 체크포인트

• 라우팅 변경 시 /app -> /space 진입 흐름이 깨지지 않는지 확인
• running -> /space, paused -> /app 재진입 정책 유지
• query param 기본값 처리 유지
• page 파일에 로직 누수 여부 확인