Skip to content

Main Dashboard

wcorn edited this page Jul 24, 2026 · 3 revisions

메인 대시보드 (Main Dashboard)

로그인 후 진입하는 앱의 허브 페이지. 모든 모듈의 진입점을 제공한다.

  • 경로: /home
  • 컴포넌트: pages/MainPage.tsx
  • 색상·타이포그래피·컴포넌트 규칙: 디자인 시스템 따름

1. 역할

진입 허브

로그인 성공 → /home → 사용자가 사용할 모듈 선택 → 해당 모듈로 이동.

플랫폼이 "모듈형 확장" 원칙(PRD §2)을 따르므로, 메인 대시보드는 사용자가 어떤 모듈을 쓸지 고르는 교차로 역할을 한다.

향후 확장

사용 패턴이 쌓이면 단순 카드 목록에서 위젯 대시보드로 진화 가능:

  • 최근 사용한 모듈 바로가기
  • 각 모듈의 요약 위젯 (오늘의 일정, 타이머 이력 등)
  • 환영 메시지, 날짜/시간, 알림 요약

현재 단계: 최소 기능(모듈 카드)만 구현. 위젯은 추후 기획.

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으로 이동 (어디서든 메인 복귀)
뒤로가기(←) 모듈 하위 화면에서만 표시, 상위 경로로 복귀
테마 토글 라이트/다크 전환
로그아웃 로그아웃 후 /

3. 화면 설계

3.1 레이아웃

┌────────────────────────────────────────────────┐
│  orino                        [테마] [로그아웃] │  전역 헤더
├────────────────────────────────────────────────┤
│                                                │
│   환영 메시지 (선택)                             │
│                                                │
│   ┌─────────────────┐  ┌─────────────────┐    │
│   │ [아이콘]         │  │ [아이콘]         │    │
│   │                 │  │                 │    │
│   │ Tools           │  │ Planner         │    │
│   │ 미니 도구 모음    │  │ 학습 플래너       │    │
│   │                 │  │                 │    │
│   └─────────────────┘  └─────────────────┘    │
│                                                │
│   ┌─────────────────┐  ┌─────────────────┐    │
│   │   (향후 추가)    │  │   (향후 추가)    │    │
│   └─────────────────┘  └─────────────────┘    │
│                                                │
└────────────────────────────────────────────────┘

3.2 모듈 카드 (ModuleCard)

요소 내용
아이콘 모듈 대표 아이콘 (lucide-react)
제목 모듈 이름
설명 한 줄 설명 (15~25자)
상태 배지 coming-soon 모듈은 배지 표시 + disabled 스타일
  • 클릭 시 해당 모듈 진입점으로 이동
  • coming-soon 상태는 클릭 불가

3.3 반응형

  • 모바일: 1열
  • 태블릿: 2열
  • 데스크탑: 2~3열 (카드 크기 유지)

3.4 초기 모듈 카드

순서 모듈 경로 상태
1 Tools /tools 활성
2 Planner /planner coming-soon (레이아웃 구축 후 활성)

※ Planner 레이아웃은 wcorn/orino#145 FE: Study Planner 레이아웃 + 라우팅 구조 참조.

4. 모듈 레지스트리

메인 대시보드에 표시되는 모듈 목록은 중앙에서 관리한다.

제안 위치: 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 문서의 도구 레지스트리와 동일한 패턴

5. 확장 로드맵

현재 (v1)

  • 모듈 카드 그리드만
  • 최소 헤더

다음 (v2, 모듈이 3~4개 쌓일 때)

  • 환영 메시지 + 현재 시간/날짜
  • "자주 쓰는 모듈" 고정

이후 (v3, 필요 시)

  • 모듈별 요약 위젯 (오늘의 일정, 최근 타이머, 할 일 개수 등)
  • 커스터마이즈 가능한 위젯 레이아웃

6. 관련 구현 이슈

  • wcorn/orino#274 FE: 메인 대시보드(/home)에 Tools/Planner 진입 카드 추가

Clone this wiki locally