Repository navigation
Main Dashboard
wcorn edited this page Jul 24, 2026
·
3 revisions
로그인 후 진입하는 앱의 허브 페이지. 모든 모듈의 진입점을 제공한다.
- 경로:
/home - 컴포넌트:
pages/MainPage.tsx - 색상·타이포그래피·컴포넌트 규칙: 디자인 시스템 따름
로그인 성공 → /home → 사용자가 사용할 모듈 선택 → 해당 모듈로 이동.
플랫폼이 "모듈형 확장" 원칙(PRD §2)을 따르므로, 메인 대시보드는 사용자가 어떤 모듈을 쓸지 고르는 교차로 역할을 한다.
사용 패턴이 쌓이면 단순 카드 목록에서 위젯 대시보드로 진화 가능:
- 최근 사용한 모듈 바로가기
- 각 모듈의 요약 위젯 (오늘의 일정, 타이머 이력 등)
- 환영 메시지, 날짜/시간, 알림 요약
현재 단계: 최소 기능(모듈 카드)만 구현. 위젯은 추후 기획.
/ → LandingPage (공개)
/login → LoginPage (비로그인)
/home → 메인 대시보드 (로그인 필수) ★ 허브
│
├── /tools → Tools 대시보드 (도구 카드 그리드)
│ └── /tools/{tool} → 각 도구 상세
│
└── /planner → Planner 기본 화면 (일간 캘린더)
├── /planner/weekly
├── /planner/monthly
├── /planner/dashboard
├── /planner/categories
├── /planner/goals
├── /planner/materials
├── /planner/routines
├── /planner/todos
├── /planner/fixed-schedules
└── /integrations
-
모듈 진입점:
/{module}(예:/tools,/planner) -
모듈 하위:
/{module}/{feature}(예:/tools/timer,/planner/goals) - 모듈 간 경로 충돌 없음 (prefix로 완전 분리)
- 모듈 하위 화면 → 모듈 대시보드로 복귀
- 모듈 대시보드 → 메인 대시보드(
/home)로 복귀 - 메인 대시보드 → (없음, 로그아웃만)
각 페이지의 헤더에는 다음 요소가 공통으로 포함된다.
| 요소 | 동작 |
|---|---|
| orino 로고 | 클릭 시 /home으로 이동 (어디서든 메인 복귀) |
| 뒤로가기(←) | 모듈 하위 화면에서만 표시, 상위 경로로 복귀 |
| 테마 토글 | 라이트/다크 전환 |
| 로그아웃 | 로그아웃 후 /
|
┌────────────────────────────────────────────────┐
│ orino [테마] [로그아웃] │ 전역 헤더
├────────────────────────────────────────────────┤
│ │
│ 환영 메시지 (선택) │
│ │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ [아이콘] │ │ [아이콘] │ │
│ │ │ │ │ │
│ │ Tools │ │ Planner │ │
│ │ 미니 도구 모음 │ │ 학습 플래너 │ │
│ │ │ │ │ │
│ └─────────────────┘ └─────────────────┘ │
│ │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ (향후 추가) │ │ (향후 추가) │ │
│ └─────────────────┘ └─────────────────┘ │
│ │
└────────────────────────────────────────────────┘
| 요소 | 내용 |
|---|---|
| 아이콘 | 모듈 대표 아이콘 (lucide-react) |
| 제목 | 모듈 이름 |
| 설명 | 한 줄 설명 (15~25자) |
| 상태 배지 |
coming-soon 모듈은 배지 표시 + disabled 스타일 |
- 클릭 시 해당 모듈 진입점으로 이동
-
coming-soon상태는 클릭 불가
- 모바일: 1열
- 태블릿: 2열
- 데스크탑: 2~3열 (카드 크기 유지)
| 순서 | 모듈 | 경로 | 상태 |
|---|---|---|---|
| 1 | Tools | /tools |
활성 |
| 2 | Planner | /planner |
coming-soon (레이아웃 구축 후 활성) |
※ Planner 레이아웃은 wcorn/orino#145 FE: Study Planner 레이아웃 + 라우팅 구조 참조.
메인 대시보드에 표시되는 모듈 목록은 중앙에서 관리한다.
제안 위치: fe/src/shared/modules/registry.ts
interface ModuleMeta {
id: string; // "tools", "planner"
name: string;
description: string;
path: string;
icon: LucideIcon;
status: "available" | "coming-soon";
}
export const MODULES: ModuleMeta[] = [
{
id: "tools",
name: "Tools",
description: "미니 도구 모음",
path: "/tools",
icon: Wrench,
status: "available",
},
{
id: "planner",
name: "Planner",
description: "학습 플래너",
path: "/planner",
icon: Calendar,
status: "coming-soon",
},
];- 신규 모듈 추가 시: 레지스트리에 1줄 추가 + 라우트 등록 → 메인 대시보드에 자동 노출
-
Tools-Module문서의 도구 레지스트리와 동일한 패턴
- 모듈 카드 그리드만
- 최소 헤더
- 환영 메시지 + 현재 시간/날짜
- "자주 쓰는 모듈" 고정
- 모듈별 요약 위젯 (오늘의 일정, 최근 타이머, 할 일 개수 등)
- 커스터마이즈 가능한 위젯 레이아웃
- wcorn/orino#274 FE: 메인 대시보드(/home)에 Tools/Planner 진입 카드 추가