Skip to content

Planner Open Items

wcorn edited this page Jun 21, 2026 · 3 revisions

Open Items / 결정 기록: Planner (Google Calendar 연동)

이 문서는 Planner 모듈 기획 과정에서 내린 결정과 그 이유를 보존한다. 향후 변경 시 컨텍스트 참고용.

0. 방향 결정 (사용자 합의)

0.1 자체 캘린더 대신 Google Calendar 양방향 연동

결정: 자체 일정 저장소를 만들지 않고 Google Calendar와 양방향 연동. Google이 source of truth. 이유: 사용자가 실제 구글 캘린더와 함께 쓰기를 원함. 반복 일정(RRULE)·휴대폰 알림 등을 구글이 이미 잘 처리 → 자체 구현 부담 회피, 단일 사용자 유지보수 최소화. 영향: 일정 로컬 미러 테이블 없음. RRULE 직접 구현 안 함(singleEvents=true로 구글이 인스턴스 확장).

0.2 할 일 = Google Tasks 연동

결정: 할 일도 자체 저장 대신 Google Tasks API 연동. 이유: 일정과 동일 기조(외부가 진실, 구글 앱에서도 보임). 단, 별도 scope·API 로직이 추가됨(트레이드오프 수용). 대안: orino 자체 todo 테이블 — 복습/자료와 연결은 자연스럽지만 구글 앱 동기화 불가. 사용자가 구글 연동을 택함.

0.3 복습 일정은 읽기 전용 오버레이

결정: 기존 SM-2 복습 스케줄을 같은 캘린더에 읽기 전용으로 겹쳐 표시. orino가 복습의 source of truth. 이유: 복습 평가 흐름(앞→답→4지선다)은 기존 오늘 복습 화면에 집중. 캘린더는 조망 + 진입점.

1. 아키텍처 결정

1.1 BE 프록시(BFF) — FE 직접 호출 안 함

결정: BE가 Google 토큰을 독점 보관하고 모든 Google API를 프록시. 이유: FE에 Google 토큰 노출 회피, 인증 모델 불변(기존 JWT만), 통합 피드 병합을 한 곳에서. 토큰 갱신/폐기/레이트리밋 대응 일원화.

1.2 google-api-java-client 대신 Spring RestClient

결정: 무거운 google-api-java-client 의존성 대신 Spring RestClient로 직접 호출. 이유: 사용 엔드포인트가 소수. 의존성 0 추가, Jackson 재사용, Java 25/Boot 4 호환 검증 부담 회피. 장기 유지보수 가치.

1.3 라이브 프록시 + 단기 캐시 (미러·syncToken 비목표)

결정: 뷰 조회마다 구글 라이브 호출 + Redis ~60초 캐시. 로컬 미러/ syncToken 증분 동기화는 안 함. 이유: 단일 사용자/저트래픽. 미러는 두 진실·삭제 추적·재동기화 부채를 낳음. 과설계 회피.

1.4 통합 단일 피드 엔드포인트

결정: GET /calendar 하나가 events+tasks+reviews를 모아 반환. 소스별 분리 엔드포인트 + FE 병합 안 함. 이유: 시간대·정렬·종일 정규화를 BE 한 곳에서. FE는 react-query 키 1개로 단순.

1.5 토큰 저장: refresh=DB, access=Redis

결정: refresh token은 DB google_account(영속, 암호화 권장), access token은 Redis(TTL), state는 Redis(5분). 이유: refresh는 장기 영속이라 휘발 저장 부적합. access는 단명이라 Redis 자동 만료가 적합.

2. OAuth 콜백 ↔ member 바인딩

결정: 콜백 시점엔 JWT가 없으므로, url 발급 시 state에 memberId를 묶어 Redis에 저장하고 콜백에서 복원. 이유: 단일 사용자라 하드코딩도 가능하지만, state-바인딩이 CSRF 방지를 겸하고 멀티유저 확장 여지를 남김.

3. /planner/calendar 경로 = 통합 뷰로 승격

결정: 기존 복습 전용 캘린더 화면을 통합 캘린더로 대체. 복습 전용 화면은 제거(복습 조회 API는 오버레이로 재사용). 이유: 메뉴 단순화, "캘린더는 하나" UX. 복습 캘린더 FE 유틸(monthGridDays/CalendarCell)은 통합 뷰에서 재사용.

4. 1차 제외 / 차기

4.1 반복 일정 편집 범위

결정: 1차는 단일 일정 + 반복의 단일 인스턴스 patch. "이 일정 이후 전체/모든 일정" 편집은 차기. 이유: Google의 recurrence 편집 규약이 복잡. 핵심 흐름(생성·표시·단일 수정·삭제) 먼저.

4.2 복습 → Google 내보내기 → 활성화됨

결정(당초): 복습을 Google 캘린더에 push하지 않음(읽기 전용). 휴대폰 구글앱 표시 요구 시 별도 "review 캘린더 one-way export" 후속 이슈. 이유(당초): 양방향이면 충돌·중복 위험. orino가 복습 진실. 현재 범위 밖. 업데이트(2026-06): 본 후속을 복습 → Google Calendar 단방향 미러링 으로 활성화. 보조 캘린더 "orino 복습"에 dueDate당 종일 "복습 N개" 묶음을 순수 단방향으로 push(orino=진실, reconcile self-heal). 양방향 충돌 회피라는 당초 우려는 단방향 + 보조 캘린더로 해소.

4.3 기타 비목표

  • 여러 캘린더 동시 표시 / 캘린더별 색상(카테고리 모듈과 함께)
  • 드래그 이동/리사이즈
  • 일정 알림/푸시, Google push notifications(웹훅) 수신
  • 자동 스케줄링 엔진 / 배치 서비스
  • refresh token 암호화는 1차 최소안(평문+접근통제) 후 [#17]에서 적용

4.4 공휴일 표시 → BE 동기화로 활성화 (2026-06)

결정: 대한민국 공휴일은 FE 표시 오버레이로 다룬다. 단 정적 하드코딩이 아니라, BE가 한국천문연구원 특일정보 API(공공데이터포털 data 15012690, getRestDeInfo)로 매일 00:00(KST) 동기화해 holiday 테이블에 캐시하고, FE는 GET /api/planner/holidays?from&to로 조회해 월 셀·일 상세에 빨간날 + 공휴일명을 표시한다. 이유: 임시공휴일·대체공휴일 변경을 자동 반영(하드코딩 수동 유지보수 제거), 권위 있는 출처, Google 연동과 무관(미연동이어도 표시). 멀티캘린더 아님: §4.3 "여러 캘린더 동시 표시" 비목표와 무관 — Google 캘린더가 아니라 별도 공공 데이터 소스이며 primary-only 피드 계약을 건드리지 않는다. 대안(기각): ① FE 정적 테이블 — 매년 수동 갱신·임시공휴일 누락. ② 구글 "대한민국의 휴일" 캘린더를 피드에 합류 — 멀티캘린더 비목표 위반.

5. 미해결 / 차후 결정

  • 캐시 TTL 값(60초) — 사용 패턴 보고 조정.
  • 할 일 전용 To-do 리스트 뷰 제공 여부 — 캘린더 칩만으로 충분한지 사용 후 판단.
  • Google API 쿼터 — 단일 사용자라 무료 쿼터 내 예상. 초과 징후 시 캐시 TTL 상향/배치 조회.

Clone this wiki locally