Skip to content

Planner Usecase

wcorn edited this page Jul 23, 2026 · 2 revisions

유스케이스: Planner (Google Calendar 연동)

📁 「플래너」 통합 모듈의 하위 영역 캘린더. 통합 개요·정체성·연동 분리는 플래너 모듈 개요 참고.

범위: Google Calendar 양방향 연동(일정), Google Tasks 연동(할 일), orino SM-2 복습 일정 읽기 전용 오버레이, 월/주/일 캘린더 뷰. 자체 일정 저장소·자동 스케줄링·알림은 범위 외. 상세 결정은 결정 기록 참고.

1. 액터

액터 설명
사용자 단일 사용자(본인). JWT로 orino에 로그인된 상태
Google Calendar API / Tasks API / OAuth 2.0 (외부 시스템)
orino BE Google 토큰을 보관하고 모든 Google 호출을 프록시(BFF)

2. 사전 조건

  • orino에 로그인되어 있다 (JWT 유효).
  • 일정/할 일을 보려면 Google 계정이 연동되어 있어야 한다. 복습 일정은 연동과 무관하게 항상 표시된다.

3. 핵심 시나리오

UC-1. Google 계정 연결

  1. 사용자가 캘린더 화면 또는 설정에서 [Google 연결] 클릭.
  2. orino가 인증 URL(동의 범위: Calendar, Tasks)로 브라우저를 이동시킨다.
  3. 사용자가 Google 동의 화면에서 권한 승인.
  4. Google이 orino BE 콜백으로 돌아오고, BE가 토큰을 저장한다.
  5. 캘린더 화면으로 복귀하며 "연결됨" 표시 + 일정/할 일이 로드된다.

대안 흐름: 사용자가 동의를 거부 → "연결 취소됨" 안내, 캘린더는 복습만 표시.

UC-2. 캘린더 조망 (월/주/일)

  1. 사용자가 캘린더 화면 진입(기본 월 뷰).
  2. orino가 보이는 기간의 일정(구글) + 할 일(구글) + 복습(orino) 을 한 번에 불러와 표시.
    • 일정: 반복 일정은 해당 기간 인스턴스로 펼쳐 표시.
    • 복습: 읽기 전용 배지(🟣오늘 / 🔴밀림 / ⚪예정 / ✅완료).
    • 할 일: 마감일(due) 날짜 칸에 표시.
  3. 사용자가 월/주/일 뷰를 전환하거나 이전/다음 기간으로 이동 → 해당 기간 데이터 갱신.

UC-3. 일정 생성 / 수정 / 삭제 (양방향)

  1. 사용자가 날짜(또는 시간대) 클릭 → 일정 생성 폼(제목/시작·종료/종일/메모).
  2. 저장 → orino BE가 Google Calendar에 일정 생성, 화면에 즉시 반영.
  3. 기존 일정 클릭 → 편집 폼에서 수정/삭제 → Google에 반영.

제약: 반복 일정 생성/편집은 Google 규약을 따른다(1차는 단일 일정 + 단일 인스턴스 편집 우선, 결정 기록 참고).

대안 흐름: Google 미연동 상태에서 생성 시도 → "Google 연결이 필요합니다" 안내(409).

UC-4. 할 일 추가 / 완료 / 삭제 (Google Tasks)

  1. 사용자가 할 일 추가(제목, 선택적 마감일) → Google Tasks에 생성.
  2. 할 일 체크 → 완료 토글(Google Tasks completed).
  3. 할 일 삭제 → Google Tasks에서 삭제.

UC-5. 복습 일정 조망

  1. 캘린더에 orino 복습 일정이 함께 보인다(읽기 전용).
  2. 날짜 클릭 → 그날 항목 목록(일정/할일/복습)에서 복습 항목은 [오늘 복습 하러가기] 로 기존 복습 화면 연결.

UC-6. Google 연결 해제

  1. 사용자가 설정에서 [연결 해제] 클릭.
  2. orino가 Google 토큰을 폐기(revoke)하고 저장된 자격증명을 삭제.
  3. 캘린더는 복습만 표시 상태로 전환.

4. 예외 / 오류 시나리오

상황 동작
Google 미연동 통합 피드는 정상(복습만), googleConnected:false → 연결 CTA 노출. 쓰기 시도는 409
Access token 만료 BE가 refresh token으로 자동 재발급(사용자 인지 없음)
Refresh token 폐기/만료(invalid_grant) 연동 무효 표시 → "다시 연결" 요구
Google API 일시 오류/레이트리밋 해당 소스만 비우고 partial:true + 오류 배너, 나머지 소스는 표시

5. 화면 흐름

[로그인]
   ↓
[캘린더(월)] ──뷰 전환──▶ [주] / [일]
   │  ├─ 미연동 → [Google 연결] → (구글 동의) → 복귀(연결됨)
   │  ├─ 날짜/시간 클릭 → [일정 생성 폼] → 저장(구글 반영)
   │  ├─ 일정 클릭 → [일정 편집 폼] → 수정/삭제
   │  ├─ [할 일 추가] → 체크/삭제
   │  └─ 날짜 클릭 → [그날 목록] → 복습은 [오늘 복습 하러가기]
   └─ [설정] → [연결 해제]

6. 범위 외 (유스케이스)

  • 여러 구글 캘린더 선택/색상 매핑 (기본 primary 캘린더만)
  • 일정 알림/푸시
  • 복습 일정을 Google로 내보내기(one-way export) — 후속 검토
  • 드래그로 일정 시간 이동/리사이즈 — 차기
  • 오프라인 편집/충돌 병합

Clone this wiki locally