Repository navigation
Routine Data Model
wcorn edited this page Jun 20, 2026
·
2 revisions
범위: 루틴 정의(반복 규칙·시작/종료·종류)는 Google Calendar 반복 이벤트에 저장한다(orino 미러 없음). orino가 추가로 보관하는 영속 데이터는 습관 완료 체크 오버레이
routine_check1개 테이블뿐이다.상태: ✅ 구현 완료 — R0
R5 (2026-06). 관련 PR: #589#597 (BE #589/#590/#591/#592/#593, FE #594/#595/#596/#597). 결정 근거는 결정 기록 참고.
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 이벤트엔 완료 상태 개념이 없기 때문.
체크형 습관의 날짜별 완료 기록. 행이 존재하면 완료, 없으면 미완료.
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
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. 별도
doneboolean 컬럼을 두지 않는다(존재 기반이 단순·정합). -
삭제 정책:
- 루틴 시리즈 삭제(scope=all) → 해당
recurring_event_id행 전부 삭제. - scope=following 삭제 → 분할일 이후(
instance_date >= splitDate) 행 삭제. - scope=instance 삭제 → 해당
(recurring_event_id, instance_date)행 삭제. - member 삭제 시 cascade(기존 관례).
- 루틴 시리즈 삭제(scope=all) → 해당
- 마이그레이션 파일:
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)로 — Hibernatevalidate호환, [DB 마이그레이션] 참고)
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를 사용자 시간대로 정규화해 응답에 싣는다.
신규 키 없음. Planner의 google:cal-cache:*(통합 피드 단기 캐시)를 공유하며, 루틴 생성/편집/삭제·체크 토글 시 해당 기간 캐시를 무효화한다.
- 루틴 정의(제목·RRULE·시작/종료) 로컬 미러 테이블 없음 — Google이 진실
- 반복 인스턴스 펼침 결과 저장 없음 —
singleEvents=true로 매 조회 시 Google이 펼침 - 스트릭/연속일/통계 집계 테이블 없음 (차기 — SP-V6-005/006). 필요 시
routine_check를 원천으로 계산 - 시간 고정 일정 완료 상태 저장 안 함(체크 개념 없음)