Skip to content

Planner Module

wcorn edited this page Jul 23, 2026 · 3 revisions

플래너 모듈 개요 (통합)

한 줄: 캘린더 · 주간 계획표 · 루틴은 실은 한 모듈이다. 좌측 「플래너」 1탭 + 본문 상단 하위 탭으로 통합하되, 세 영역의 정체성(진실의 출처) 은 하위 섹션으로 보존한다.

상태: 좌측 탭 단일화 #961 · 연동 공용화 #962 · Epic #963. 세 하위 영역의 기능 자체는 모두 ✅ 구현 완료(2026-06).

1. 왜 통합인가

  • 코드상 이미 한 모듈: 셋 다 features/planner에 살고, 라우트도 /planner/calendar · /planner/plan · /planner/routines로 한 지붕이다. 루틴은 이미 캘린더 피드에 이벤트로 합류해 캘린더 안에서 체크된다.
  • 그런데 흩어져 보였다: 좌측 사이드바에 평면 3탭으로, Wiki에선 별개 모듈(4·5·6) 로 노출돼 "한 덩어리"라는 사실이 드러나지 않았다.
  • 통합은 내비게이션·문서 묶음이지 데이터 통합이 아니다(아래 §3).

2. 통합 형태 (확정)

  • 좌측 상위 탭 「플래너」 1개 → 기본 진입 = 캘린더
  • 본문 상단 하위 탭으로 전환: 캘린더 / 주간 계획표 / 루틴 (라우트는 유지)
  • 학습 자료·복습은 URL만 /planner/*일 뿐 Study Planner 모듈 — 통합 대상 아님
좌측 사이드바              본문
──────────         ┌───────────────────────────┐
 홈                │ [캘린더][주간계획표][루틴]     │
 학습 자료          ├───────────────────────────┤
 노트              │                           │
 복습              │      (선택된 하위 뷰)        │
 플래너  ←         │                           │
 연동 설정          └───────────────────────────┘

3. 세 하위 영역 — 정체성은 다르다 (보존)

영역 한 줄 진실의 출처 캘린더 연동 문서
캘린더 Google 일정·할일·복습을 한 화면에서 Google (일정/할일), orino (복습) — (이 뷰가 캘린더) Planner-*
루틴 "내가 하는 일" — 반복 습관·고정 일정 Google (반복 이벤트 RRULE) 캘린더 뷰에 인스턴스로 합류 Routine-*
주간 계획표 "내 한 주의 모양" — 정적 시각 템플릿 orino 내부 (연동 없음) 연동 없음(독립 그리드) Day-Plan-*

뭉개지 말 것: 루틴은 실제 약속(Google이 진실), 주간 계획표는 의도의 틀(orino가 진실). 데이터 저장소가 다르므로 하위 탭으로 묶되 모델은 분리 유지한다.

4. 연동(Google 연결)은 플래너 밖 공용

Google 연결 자체(OAuth url·callback·status·disconnect)는 캘린더·루틴·복습→캘린더 미러링이 모두 공유한다. 플래너 종속처럼 보이던 /api/planner/google/*를 공용 네임스페이스 /api/integrations/google/* 로 이전하고, 연동 설정 UI도 플래너 밖 공용 위치로 옮긴다. 자세한 내용·마이그레이션 체크리스트는 연동(Integrations) 참고.

  • 이전 대상 = 연결 그 자체만. 캘린더 피드·이벤트·할일·루틴 엔드포인트(/api/planner/*)는 진짜 플래너 기능이라 유지.
  • OAuth 콜백까지 완전 이전 → Google Cloud Console redirect URI 수동 전환 동반(#962).

5. 관련 이슈

  • Epic #963 — 플래너 통합 (트래킹)
  • #961 — A. 좌측 탭 단일화 (FE, 먼저 착수)
  • #962 — B. 연동 공용화 (BE+FE+infra, A 머지 후)

Clone this wiki locally