Repository navigation
Planner Usecase
wcorn edited this page Jul 23, 2026
·
2 revisions
📁 「플래너」 통합 모듈의 하위 영역 캘린더. 통합 개요·정체성·연동 분리는 플래너 모듈 개요 참고.
범위: Google Calendar 양방향 연동(일정), Google Tasks 연동(할 일), orino SM-2 복습 일정 읽기 전용 오버레이, 월/주/일 캘린더 뷰. 자체 일정 저장소·자동 스케줄링·알림은 범위 외. 상세 결정은 결정 기록 참고.
| 액터 | 설명 |
|---|---|
| 사용자 | 단일 사용자(본인). JWT로 orino에 로그인된 상태 |
| Calendar API / Tasks API / OAuth 2.0 (외부 시스템) | |
| orino BE | Google 토큰을 보관하고 모든 Google 호출을 프록시(BFF) |
- orino에 로그인되어 있다 (JWT 유효).
- 일정/할 일을 보려면 Google 계정이 연동되어 있어야 한다. 복습 일정은 연동과 무관하게 항상 표시된다.
- 사용자가 캘린더 화면 또는 설정에서 [Google 연결] 클릭.
- orino가 인증 URL(동의 범위: Calendar, Tasks)로 브라우저를 이동시킨다.
- 사용자가 Google 동의 화면에서 권한 승인.
- Google이 orino BE 콜백으로 돌아오고, BE가 토큰을 저장한다.
- 캘린더 화면으로 복귀하며 "연결됨" 표시 + 일정/할 일이 로드된다.
대안 흐름: 사용자가 동의를 거부 → "연결 취소됨" 안내, 캘린더는 복습만 표시.
- 사용자가 캘린더 화면 진입(기본 월 뷰).
- orino가 보이는 기간의 일정(구글) + 할 일(구글) + 복습(orino) 을 한 번에 불러와 표시.
- 일정: 반복 일정은 해당 기간 인스턴스로 펼쳐 표시.
- 복습: 읽기 전용 배지(🟣오늘 / 🔴밀림 / ⚪예정 / ✅완료).
- 할 일: 마감일(due) 날짜 칸에 표시.
- 사용자가 월/주/일 뷰를 전환하거나 이전/다음 기간으로 이동 → 해당 기간 데이터 갱신.
- 사용자가 날짜(또는 시간대) 클릭 → 일정 생성 폼(제목/시작·종료/종일/메모).
- 저장 → orino BE가 Google Calendar에 일정 생성, 화면에 즉시 반영.
- 기존 일정 클릭 → 편집 폼에서 수정/삭제 → Google에 반영.
제약: 반복 일정 생성/편집은 Google 규약을 따른다(1차는 단일 일정 + 단일 인스턴스 편집 우선, 결정 기록 참고).
대안 흐름: Google 미연동 상태에서 생성 시도 → "Google 연결이 필요합니다" 안내(409).
- 사용자가 할 일 추가(제목, 선택적 마감일) → Google Tasks에 생성.
- 할 일 체크 → 완료 토글(Google Tasks
completed). - 할 일 삭제 → Google Tasks에서 삭제.
- 캘린더에 orino 복습 일정이 함께 보인다(읽기 전용).
- 날짜 클릭 → 그날 항목 목록(일정/할일/복습)에서 복습 항목은 [오늘 복습 하러가기] 로 기존 복습 화면 연결.
- 사용자가 설정에서 [연결 해제] 클릭.
- orino가 Google 토큰을 폐기(revoke)하고 저장된 자격증명을 삭제.
- 캘린더는 복습만 표시 상태로 전환.
| 상황 | 동작 |
|---|---|
| Google 미연동 | 통합 피드는 정상(복습만), googleConnected:false → 연결 CTA 노출. 쓰기 시도는 409 |
| Access token 만료 | BE가 refresh token으로 자동 재발급(사용자 인지 없음) |
Refresh token 폐기/만료(invalid_grant) |
연동 무효 표시 → "다시 연결" 요구 |
| Google API 일시 오류/레이트리밋 | 해당 소스만 비우고 partial:true + 오류 배너, 나머지 소스는 표시 |
[로그인]
↓
[캘린더(월)] ──뷰 전환──▶ [주] / [일]
│ ├─ 미연동 → [Google 연결] → (구글 동의) → 복귀(연결됨)
│ ├─ 날짜/시간 클릭 → [일정 생성 폼] → 저장(구글 반영)
│ ├─ 일정 클릭 → [일정 편집 폼] → 수정/삭제
│ ├─ [할 일 추가] → 체크/삭제
│ └─ 날짜 클릭 → [그날 목록] → 복습은 [오늘 복습 하러가기]
└─ [설정] → [연결 해제]
- 여러 구글 캘린더 선택/색상 매핑 (기본 primary 캘린더만)
- 일정 알림/푸시
- 복습 일정을 Google로 내보내기(one-way export) — 후속 검토
- 드래그로 일정 시간 이동/리사이즈 — 차기
- 오프라인 편집/충돌 병합