Repository navigation
Routine Open Items
이 문서는 Routine 모듈 기획 과정에서 내린 결정과 이유를 보존한다. 향후 변경 시 컨텍스트 참고용. 본 모듈은 백로그 SP-V5-002(루틴 CRUD)를 Planner(Google 연동) 위에 활성화한 결과다.
상태: ✅ 구현 완료 — R0
R5 (2026-06). 관련 PR: #589#597 (BE #589/#590/#591/#592/#593, FE #594/#595/#596/#597).
결정: Todomate의 '루틴'(체크형 습관)과 '고정 일정'(시간 반복일정)을 하나의 루틴 개념으로 다룬다. "종일 토글"로 갈린다.
이유: 사용자가 둘 다 필요. 생성/편집/반복 규칙 흐름이 동일해 한 모델로 묶는 게 단순.
영향: type = habit | schedule 태그로 구분. habit만 완료 체크 대상.
결정: 루틴을 자체 테이블이 아니라 Google Calendar 반복 이벤트(RRULE) 로 생성. Google이 source of truth. 이유: Planner가 이미 Google을 진실로 삼고 반복(RRULE)·휴대폰 알림을 구글에 위임. 루틴도 같은 기조 → 휴대폰 구글앱/알림에 그대로 보이고, 자체 반복 엔진·미러 부채를 피한다. 영향: 루틴 정의 로컬 미러 없음. RRULE을 orino가 작성해야 함(Planner는 읽기만 했음 → 신규 책임). 대안(기각): orino 자체 routine 도메인(복습처럼 오버레이). 완전 제어 가능하나 구글앱 미동기. 사용자가 Google 동기화를 우선함.
결정: Google 이벤트엔 "완료" 개념이 없으므로, 체크형 습관의 날짜별 완료만 orino routine_check 1개 테이블에 오버레이로 저장.
이유: 복습 오버레이와 동일 패턴. 기기 간 동기·스트릭 원천 확보. 존재=완료로 단순.
대안(기각): ①v1 체크 없음 — Todomate 습관의 핵심(체크 맛)이 빠짐. ②LocalStorage — 데스크탑/모바일 따로 고립.
영향: 유일한 신규 영속 테이블. 시간 고정 일정은 이 테이블 미사용.
결정: 위 4종 지원. N일 간격 = FREQ=DAILY;INTERVAL=N.
이유: Todomate 수준 커버. 시작일(DTSTART)·종료일(UNTIL, 비우면 무기한).
1차 제외: BYSETPOS("마지막 주 금요일"), 복수 RRULE, 음수 BYMONTHDAY(말일). 필요 시 차기.
결정: Google/Todomate 수준의 3가지 편집 범위를 v1에 모두 제공. 이유: 사용자가 완전한 편집을 원함. 'this-and-following' 분할까지 포함.
결정: GoogleTokenProvider·RestClient·OAuth·캐시·통합 피드를 그대로 상속. Routine은 planner/google/routine,recurrence 추가뿐.
이유: 단일 사용자·유지보수 최소화. 인증 모델·외부 의존 불변.
결정: extendedProperties.private에 orinoRoutine="1"(sentinel) + orinoRoutineType="habit"|"schedule".
이유: 일반 일정과 구분하고 events.list?privateExtendedProperty=orinoRoutine=1로 루틴만 필터(관리 목록). sentinel을 별도 키로 둬 한 번의 list로 전체 루틴 조회.
대안(기각): 제목 접두사/색상 — 취약하고 사용자 데이터 오염.
결정: GET /planner/calendar가 이미 singleEvents=true로 인스턴스를 펼침. 각 인스턴스에 routine 메타를 주석으로 덧붙이고 habit은 routine_check batch 조인으로 done 세팅.
이유: 두 번째 캘린더 호출·FE 병합 회피. react-query 키 1개 유지.
결정: RecurrenceRuleFactory가 문자열로 RRULE 생성/역파싱. Planner의 "RestClient 직접" 기조 계승.
이유: 사용 패턴이 소수. 의존성 0. UNTIL은 UTC 직렬화(RFC 5545).
결정: 'this-and-following'은 Google 단일 콜이 없어 ①마스터 RRULE UNTIL=분할 전날 patch → ②분할일부터 새 반복 이벤트 insert(태그 복사) 2단계로 구현(Google Calendar UI와 동일).
리스크/완화:
- ① 성공 후 ② 실패 시 시리즈가 분할일에서 끊긴 채 새 시리즈 없음 → 멱등 재시도로 ②만 재실행. 작업 시작 전 상태를 기록해 부분 적용을 보정.
- 새
recurringEventId발생 → 응답에 신규 id 포함.routine_check는 과거(옛 id)/이후(새 id)로 자연 분리(데이터 손실 없음).
결정: 생성/편집은 X-Timezone 기준. 종일(habit)은 date, 시간(schedule)은 dateTime+tz. UNTIL·checked_at는 UTC 저장. routine_check.instance_date는 사용자 로컬 날짜.
이유: [UTC 저장 + 사용자 시간대 반환] 규칙 일관(#432 계열).
- "오늘의 루틴" 체크 리스트 배치 — 월 뷰 상단 vs 사이드 vs 별도 위젯. 사용 후 조정.
- recurrenceText 생성 위치 — 1차 BE 제공. FE i18n 필요 시 FE 이동.
- 체크 행 보존 정책 — 현재 해제=delete(존재 기반). 스트릭/통계 도입(SP-V6-005/006) 시 soft-keep 필요 여부 재검토.
- 종일 습관의 정렬/표시 — 종일 이벤트 행이 많아질 때 캘린더 밀도. 접기/요약 필요 여부.
- 색상 — 루틴별 색은 카테고리 모듈과 함께 차기(Planner와 동일 기조).
- 루틴 정의 로컬 미러 / 인스턴스 펼침 저장 (Google이 진실)
- 자동 스케줄링 엔진 / 배치(SP-V5-004)
- 루틴 알림/푸시, 스트릭/히트맵 집계
- BYSETPOS·EXDATE 직접 작성 등 고급 RRULE
- 루틴을 Google Tasks로 생성