Files
viberoom-web/docs/03_routes_map.md
corpi ecb17a485a docs(session): add restart-safe recovery workflow
Context:

- codex cli 중단 후에도 작업 품질과 맥락을 안정적으로 복구하기 위해

Changes:

- docs/00~07, 90 문서 세트 추가/정리

- commit convention 문서 및 .gitmessage-session.txt 템플릿 추가

- scripts/session/recover-context.sh 추가

- package.json에 session:recover 스크립트 추가

Validation:

- npm run session:recover

Session-State: session recovery docs, template, and script are in place

Session-Next: apply this commit format to feature and refactor commits

Session-Risks: legacy commits before this change do not include session trailers
2026-02-27 13:27:20 +09:00

1.2 KiB

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/app-hub/ui/AppHubWidget.tsx
  • 주요 구성:
    • StartRitualWidget
    • RoomsGalleryWidget
    • CustomEntryWidget
  • 데이터 소스:
    • room 목록: entities/room
    • 목표/타이머/사운드 프리셋: entities/session

/space (집중 화면)

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

/space 쿼리 파라미터

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

변경 시 체크포인트

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