Skip to content

Routine Open Items

wcorn edited this page Jun 20, 2026 · 2 revisions

Open Items / 결정 기록: Routine (반복 루틴 / 고정 일정)

이 문서는 Routine 모듈 기획 과정에서 내린 결정과 이유를 보존한다. 향후 변경 시 컨텍스트 참고용. 본 모듈은 백로그 SP-V5-002(루틴 CRUD)를 Planner(Google 연동) 위에 활성화한 결과다.

상태: ✅ 구현 완료 — R0R5 (2026-06). 관련 PR: #589#597 (BE #589/#590/#591/#592/#593, FE #594/#595/#596/#597).

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

0.1 통합 루틴: 체크형 습관 + 시간 고정 일정 둘 다

결정: Todomate의 '루틴'(체크형 습관)과 '고정 일정'(시간 반복일정)을 하나의 루틴 개념으로 다룬다. "종일 토글"로 갈린다. 이유: 사용자가 둘 다 필요. 생성/편집/반복 규칙 흐름이 동일해 한 모델로 묶는 게 단순. 영향: type = habit | schedule 태그로 구분. habit만 완료 체크 대상.

0.2 진실 원천 = Google Calendar 반복 이벤트

결정: 루틴을 자체 테이블이 아니라 Google Calendar 반복 이벤트(RRULE) 로 생성. Google이 source of truth. 이유: Planner가 이미 Google을 진실로 삼고 반복(RRULE)·휴대폰 알림을 구글에 위임. 루틴도 같은 기조 → 휴대폰 구글앱/알림에 그대로 보이고, 자체 반복 엔진·미러 부채를 피한다. 영향: 루틴 정의 로컬 미러 없음. RRULE을 orino가 작성해야 함(Planner는 읽기만 했음 → 신규 책임). 대안(기각): orino 자체 routine 도메인(복습처럼 오버레이). 완전 제어 가능하나 구글앱 미동기. 사용자가 Google 동기화를 우선함.

0.3 습관 완료 체크 = orino 최소 오버레이

결정: Google 이벤트엔 "완료" 개념이 없으므로, 체크형 습관의 날짜별 완료만 orino routine_check 1개 테이블에 오버레이로 저장. 이유: 복습 오버레이와 동일 패턴. 기기 간 동기·스트릭 원천 확보. 존재=완료로 단순. 대안(기각): ①v1 체크 없음 — Todomate 습관의 핵심(체크 맛)이 빠짐. ②LocalStorage — 데스크탑/모바일 따로 고립. 영향: 유일한 신규 영속 테이블. 시간 고정 일정은 이 테이블 미사용.

0.4 반복 규칙 범위: 매일 / 주간(요일) / 매월(특정일) / N일 간격

결정: 위 4종 지원. N일 간격 = FREQ=DAILY;INTERVAL=N. 이유: Todomate 수준 커버. 시작일(DTSTART)·종료일(UNTIL, 비우면 무기한). 1차 제외: BYSETPOS("마지막 주 금요일"), 복수 RRULE, 음수 BYMONTHDAY(말일). 필요 시 차기.

0.5 시리즈 편집/삭제: 전체 / 이후 모두 / 이 인스턴스 (3종 전부)

결정: Google/Todomate 수준의 3가지 편집 범위를 v1에 모두 제공. 이유: 사용자가 완전한 편집을 원함. 'this-and-following' 분할까지 포함.

1. 아키텍처 결정

1.1 Planner 자산 재사용 (신규 인프라 0)

결정: GoogleTokenProvider·RestClient·OAuth·캐시·통합 피드를 그대로 상속. Routine은 planner/google/routine,recurrence 추가뿐. 이유: 단일 사용자·유지보수 최소화. 인증 모델·외부 의존 불변.

1.2 루틴 식별 = extendedProperties 태그

결정: extendedProperties.private에 orinoRoutine="1"(sentinel) + orinoRoutineType="habit"|"schedule". 이유: 일반 일정과 구분하고 events.list?privateExtendedProperty=orinoRoutine=1로 루틴만 필터(관리 목록). sentinel을 별도 키로 둬 한 번의 list로 전체 루틴 조회. 대안(기각): 제목 접두사/색상 — 취약하고 사용자 데이터 오염.

1.3 조회는 통합 피드 확장(신규 캘린더 엔드포인트 없음)

결정: GET /planner/calendar가 이미 singleEvents=true로 인스턴스를 펼침. 각 인스턴스에 routine 메타를 주석으로 덧붙이고 habit은 routine_check batch 조인으로 done 세팅. 이유: 두 번째 캘린더 호출·FE 병합 회피. react-query 키 1개 유지.

1.4 RRULE 직접 작성(라이브러리 없음)

결정: RecurrenceRuleFactory가 문자열로 RRULE 생성/역파싱. Planner의 "RestClient 직접" 기조 계승. 이유: 사용 패턴이 소수. 의존성 0. UNTIL은 UTC 직렬화(RFC 5545).

2. 편집(following) 2-스텝 전략

결정: 'this-and-following'은 Google 단일 콜이 없어 ①마스터 RRULE UNTIL=분할 전날 patch → ②분할일부터 새 반복 이벤트 insert(태그 복사) 2단계로 구현(Google Calendar UI와 동일). 리스크/완화:

  • ① 성공 후 ② 실패 시 시리즈가 분할일에서 끊긴 채 새 시리즈 없음 → 멱등 재시도로 ②만 재실행. 작업 시작 전 상태를 기록해 부분 적용을 보정.
  • 새 recurringEventId 발생 → 응답에 신규 id 포함. routine_check는 과거(옛 id)/이후(새 id)로 자연 분리(데이터 손실 없음).

3. 시간대 처리

결정: 생성/편집은 X-Timezone 기준. 종일(habit)은 date, 시간(schedule)은 dateTime+tz. UNTIL·checked_at는 UTC 저장. routine_check.instance_date는 사용자 로컬 날짜. 이유: [UTC 저장 + 사용자 시간대 반환] 규칙 일관(#432 계열).

4. 미해결 / 차후 결정

  • "오늘의 루틴" 체크 리스트 배치 — 월 뷰 상단 vs 사이드 vs 별도 위젯. 사용 후 조정.
  • recurrenceText 생성 위치 — 1차 BE 제공. FE i18n 필요 시 FE 이동.
  • 체크 행 보존 정책 — 현재 해제=delete(존재 기반). 스트릭/통계 도입(SP-V6-005/006) 시 soft-keep 필요 여부 재검토.
  • 종일 습관의 정렬/표시 — 종일 이벤트 행이 많아질 때 캘린더 밀도. 접기/요약 필요 여부.
  • 색상 — 루틴별 색은 카테고리 모듈과 함께 차기(Planner와 동일 기조).

5. 명시적 비목표

  • 루틴 정의 로컬 미러 / 인스턴스 펼침 저장 (Google이 진실)
  • 자동 스케줄링 엔진 / 배치(SP-V5-004)
  • 루틴 알림/푸시, 스트릭/히트맵 집계
  • BYSETPOS·EXDATE 직접 작성 등 고급 RRULE
  • 루틴을 Google Tasks로 생성

Clone this wiki locally