Repository navigation
Planner Open Items
이 문서는 Planner 모듈 기획 과정에서 내린 결정과 그 이유를 보존한다. 향후 변경 시 컨텍스트 참고용.
결정: 자체 일정 저장소를 만들지 않고 Google Calendar와 양방향 연동. Google이 source of truth.
이유: 사용자가 실제 구글 캘린더와 함께 쓰기를 원함. 반복 일정(RRULE)·휴대폰 알림 등을 구글이 이미 잘 처리 → 자체 구현 부담 회피, 단일 사용자 유지보수 최소화.
영향: 일정 로컬 미러 테이블 없음. RRULE 직접 구현 안 함(singleEvents=true로 구글이 인스턴스 확장).
결정: 할 일도 자체 저장 대신 Google Tasks API 연동. 이유: 일정과 동일 기조(외부가 진실, 구글 앱에서도 보임). 단, 별도 scope·API 로직이 추가됨(트레이드오프 수용). 대안: orino 자체 todo 테이블 — 복습/자료와 연결은 자연스럽지만 구글 앱 동기화 불가. 사용자가 구글 연동을 택함.
결정: 기존 SM-2 복습 스케줄을 같은 캘린더에 읽기 전용으로 겹쳐 표시. orino가 복습의 source of truth. 이유: 복습 평가 흐름(앞→답→4지선다)은 기존 오늘 복습 화면에 집중. 캘린더는 조망 + 진입점.
결정: BE가 Google 토큰을 독점 보관하고 모든 Google API를 프록시. 이유: FE에 Google 토큰 노출 회피, 인증 모델 불변(기존 JWT만), 통합 피드 병합을 한 곳에서. 토큰 갱신/폐기/레이트리밋 대응 일원화.
결정: 무거운 google-api-java-client 의존성 대신 Spring RestClient로 직접 호출.
이유: 사용 엔드포인트가 소수. 의존성 0 추가, Jackson 재사용, Java 25/Boot 4 호환 검증 부담 회피. 장기 유지보수 가치.
결정: 뷰 조회마다 구글 라이브 호출 + Redis ~60초 캐시. 로컬 미러/ syncToken 증분 동기화는 안 함. 이유: 단일 사용자/저트래픽. 미러는 두 진실·삭제 추적·재동기화 부채를 낳음. 과설계 회피.
결정: GET /calendar 하나가 events+tasks+reviews를 모아 반환. 소스별 분리 엔드포인트 + FE 병합 안 함.
이유: 시간대·정렬·종일 정규화를 BE 한 곳에서. FE는 react-query 키 1개로 단순.
결정: refresh token은 DB google_account(영속, 암호화 권장), access token은 Redis(TTL), state는 Redis(5분).
이유: refresh는 장기 영속이라 휘발 저장 부적합. access는 단명이라 Redis 자동 만료가 적합.
결정: 콜백 시점엔 JWT가 없으므로, url 발급 시 state에 memberId를 묶어 Redis에 저장하고 콜백에서 복원.
이유: 단일 사용자라 하드코딩도 가능하지만, state-바인딩이 CSRF 방지를 겸하고 멀티유저 확장 여지를 남김.
결정: 기존 복습 전용 캘린더 화면을 통합 캘린더로 대체. 복습 전용 화면은 제거(복습 조회 API는 오버레이로 재사용).
이유: 메뉴 단순화, "캘린더는 하나" UX. 복습 캘린더 FE 유틸(monthGridDays/CalendarCell)은 통합 뷰에서 재사용.
결정: 1차는 단일 일정 + 반복의 단일 인스턴스 patch. "이 일정 이후 전체/모든 일정" 편집은 차기. 이유: Google의 recurrence 편집 규약이 복잡. 핵심 흐름(생성·표시·단일 수정·삭제) 먼저.
결정(당초): 복습을 Google 캘린더에 push하지 않음(읽기 전용). 휴대폰 구글앱 표시 요구 시 별도 "review 캘린더 one-way export" 후속 이슈. 이유(당초): 양방향이면 충돌·중복 위험. orino가 복습 진실. 현재 범위 밖. 업데이트(2026-06): 본 후속을 복습 → Google Calendar 단방향 미러링 으로 활성화. 보조 캘린더 "orino 복습"에 dueDate당 종일 "복습 N개" 묶음을 순수 단방향으로 push(orino=진실, reconcile self-heal). 양방향 충돌 회피라는 당초 우려는 단방향 + 보조 캘린더로 해소.
- 여러 캘린더 동시 표시 / 캘린더별 색상(카테고리 모듈과 함께)
- 드래그 이동/리사이즈
- 일정 알림/푸시, Google push notifications(웹훅) 수신
- 자동 스케줄링 엔진 / 배치 서비스
- refresh token 암호화는 1차 최소안(평문+접근통제) 후 [#17]에서 적용
결정: 대한민국 공휴일은 FE 표시 오버레이로 다룬다. 단 정적 하드코딩이 아니라, BE가 한국천문연구원 특일정보 API(공공데이터포털 data 15012690, getRestDeInfo)로 매일 00:00(KST) 동기화해 holiday 테이블에 캐시하고, FE는 GET /api/planner/holidays?from&to로 조회해 월 셀·일 상세에 빨간날 + 공휴일명을 표시한다.
이유: 임시공휴일·대체공휴일 변경을 자동 반영(하드코딩 수동 유지보수 제거), 권위 있는 출처, Google 연동과 무관(미연동이어도 표시).
멀티캘린더 아님: §4.3 "여러 캘린더 동시 표시" 비목표와 무관 — Google 캘린더가 아니라 별도 공공 데이터 소스이며 primary-only 피드 계약을 건드리지 않는다.
대안(기각): ① FE 정적 테이블 — 매년 수동 갱신·임시공휴일 누락. ② 구글 "대한민국의 휴일" 캘린더를 피드에 합류 — 멀티캘린더 비목표 위반.
- 캐시 TTL 값(60초) — 사용 패턴 보고 조정.
- 할 일 전용 To-do 리스트 뷰 제공 여부 — 캘린더 칩만으로 충분한지 사용 후 판단.
- Google API 쿼터 — 단일 사용자라 무료 쿼터 내 예상. 초과 징후 시 캐시 TTL 상향/배치 조회.