Skip to content

Routine Data Model

wcorn edited this page Jun 20, 2026 · 2 revisions

데이터 모델링: Routine (반복 루틴 / 고정 일정)

범위: 루틴 정의(반복 규칙·시작/종료·종류)는 Google Calendar 반복 이벤트에 저장한다(orino 미러 없음). orino가 추가로 보관하는 영속 데이터는 습관 완료 체크 오버레이 routine_check 1개 테이블뿐이다.

상태: ✅ 구현 완료 — R0R5 (2026-06). 관련 PR: #589#597 (BE #589/#590/#591/#592/#593, FE #594/#595/#596/#597). 결정 근거는 결정 기록 참고.

1. 개요

member (1) ──────< (N) routine_check        # 습관 날짜별 완료 체크 (오버레이)

google_account                              # Planner 그대로 (토큰)
[Google Calendar 반복 이벤트]                # 루틴 정의의 source of truth (orino 외부)
  • 루틴의 제목·반복 규칙(RRULE)·시작/종료일·시간·종류(habit/schedule)는 모두 Google 이벤트에 있다.
    • 종류·식별은 extendedProperties.private의 orinoRoutine="1", orinoRoutineType="habit"|"schedule" 태그로 표현(아키텍처 §3).
  • orino는 습관의 "그날 완료했는가"만 저장한다. Google 이벤트엔 완료 상태 개념이 없기 때문.

2. routine_check 테이블

체크형 습관의 날짜별 완료 기록. 행이 존재하면 완료, 없으면 미완료.

컬럼 타입 제약 설명
id BIGINT PK, AUTO_INCREMENT
member_id BIGINT NOT NULL, FK→member(id) 소유자
recurring_event_id VARCHAR(255) NOT NULL Google 반복 이벤트의 recurringEventId(시리즈 안정 키)
instance_date DATE NOT NULL 완료한 인스턴스의 날짜(사용자 시간대 로컬 날짜)
checked_at DATETIME(6) NOT NULL 체크 시각(UTC 저장)
created_at DATETIME(6) NOT NULL JPA Auditing
updated_at DATETIME(6) NOT NULL JPA Auditing
  • UNIQUE: (member_id, recurring_event_id, instance_date) — 하루 1행, upsert 키.
  • INDEX: (member_id, instance_date) — 통합 피드 기간 조회 시 batch 로드.
  • 체크/해제: 체크 = 행 upsert, 해제 = 행 delete. 별도 done boolean 컬럼을 두지 않는다(존재 기반이 단순·정합).
  • 삭제 정책:
    • 루틴 시리즈 삭제(scope=all) → 해당 recurring_event_id 행 전부 삭제.
    • scope=following 삭제 → 분할일 이후(instance_date >= splitDate) 행 삭제.
    • scope=instance 삭제 → 해당 (recurring_event_id, instance_date) 행 삭제.
    • member 삭제 시 cascade(기존 관례).

Liquibase

  • 마이그레이션 파일: 0NN-create-routine-check.yaml — Planner의 google_account(023) 다음 번호. 적용 직전 최신 changelog 번호를 확인해 부여한다.
  • 관례 준수: preCondition tableExists/not tableExists 가드, member(id) FK, DATETIME(6), created_at/updated_at. 상세는 DB 마이그레이션.
  • BOOLEAN 컬럼 없음: 존재 기반이라 boolean을 피했다. (BOOLEAN 필요 시 BIT(1)로 — Hibernate validate 호환, [DB 마이그레이션] 참고)

3. 엔티티 (JPA)

ds.project.orino.domain.planner.routine.entity.RoutineCheck

  • created_at/updated_at은 @CreatedDate/@LastModifiedDate.
  • (member_id, recurring_event_id, instance_date) 복합 유니크. upsert는 "있으면 무시 / 없으면 insert" + 해제는 delete로 처리(또는 INSERT ... ON DUPLICATE KEY 동등 로직).
  • 루틴 정의 엔티티는 없다(Google이 진실). BE는 Google 이벤트 DTO를 사용자 시간대로 정규화해 응답에 싣는다.

4. Redis 키

신규 키 없음. Planner의 google:cal-cache:*(통합 피드 단기 캐시)를 공유하며, 루틴 생성/편집/삭제·체크 토글 시 해당 기간 캐시를 무효화한다.

5. 비목표

  • 루틴 정의(제목·RRULE·시작/종료) 로컬 미러 테이블 없음 — Google이 진실
  • 반복 인스턴스 펼침 결과 저장 없음 — singleEvents=true로 매 조회 시 Google이 펼침
  • 스트릭/연속일/통계 집계 테이블 없음 (차기 — SP-V6-005/006). 필요 시 routine_check를 원천으로 계산
  • 시간 고정 일정 완료 상태 저장 안 함(체크 개념 없음)

Clone this wiki locally