Skip to content

Planner Data Model

wcorn edited this page Jun 19, 2026 · 2 revisions

데이터 모델링: Planner (Google Calendar 연동)

범위: Google 연동 자격증명 저장. 일정/할 일은 Google이 source of truth이므로 orino에 저장하지 않는다(로컬 미러 없음). 복습은 기존 review_schedule 재사용. 결정 근거는 결정 기록 참고.

1. 개요

신규 영속 테이블은 google_account 1개(+ 복습 미러 활성화 시 review_calendar_mirror)이다.

member (1) ──────< (1) google_account             # 단일 사용자: 1 row (member_id UNIQUE)
member (1) ──────< (N) review_calendar_mirror     # 복습 미러링(§7) — dueDate당 1행

review_schedule / study_material / flashcard       # 기존 그대로 (복습 오버레이로 읽기 재사용)

일정·할 일은 Google Calendar / Google Tasks가 보관한다. orino는 표시할 때마다 라이브로 조회한다.

2. google_account 테이블

Google OAuth 연동 자격증명. 단일 사용자라 1 row지만 member_id FK + UNIQUE로 멀티유저 확장 여지를 남긴다.

컬럼 타입 제약 설명
id BIGINT PK, AUTO_INCREMENT
member_id BIGINT NOT NULL, UNIQUE, FK→member(id) 소유자
google_email VARCHAR(255) NULL 연동된 구글 계정 이메일(표시용)
refresh_token VARCHAR(512) NOT NULL Google refresh token (암호화 저장 권장, [#17])
scopes VARCHAR(512) NULL 동의된 scope 목록
primary_calendar_id VARCHAR(255) NULL 기본 캘린더 id(보통 "primary")
task_list_id VARCHAR(255) NULL 기본 task list id 캐시
connected_at DATETIME(6) NOT NULL 최초 연동 시각
revoked BOOLEAN NOT NULL DEFAULT false invalid_grant 등으로 무효화됨
created_at DATETIME(6) NOT NULL JPA Auditing
updated_at DATETIME(6) NOT NULL JPA Auditing
  • 인덱스: member_id UNIQUE.
  • 삭제 정책: 연결 해제 시 row DELETE. member 삭제 시 cascade(기존 관례 따름).

Liquibase

  • 마이그레이션 파일: 023-create-google-account.yaml (현재 마지막이 022).
  • 관례 준수: preCondition tableExists 가드, member(id) FK, DATETIME(6), created_at/updated_at 컬럼. 상세는 DB 마이그레이션.

3. Redis 키 (휘발성, 테이블 아님)

orino-domain-redis의 planner/google 리포지토리에서 관리.

키 값 TTL 용도
google:access:{memberId} access token expires_in(여유 차감) access token 캐시
google:oauth-state:{state} memberId 5분 OAuth 콜백 검증·CSRF 방지
google:cal-cache:{memberId}:{from}:{to} 직렬화된 피드 응답 ~60초 (선택) 뷰 전환 중복 호출 흡수, 쓰기 시 무효화

4. 엔티티 (JPA)

ds.project.orino.domain.planner.google.entity.GoogleAccount — created_at/updated_at은 @CreatedDate/@LastModifiedDate.

일정/할 일은 엔티티가 없다. BE는 Google API 응답 DTO를 그대로 사용자 시간대로 정규화해 응답에 싣는다(저장 없음).

6. 복습 미러링 (Review Calendar Mirror)

복습을 보조 캘린더로 단방향 push하는 하위 기능. 상세는 복습 → Google Calendar 단방향 미러링 참고.

6.1 review_calendar_mirror (신규)

dueDate 묶음 ↔ Google 이벤트 매핑. 행 존재 = 그날 미러 중, pending_count=0 도달 시 행·이벤트 삭제.

컬럼 타입 제약 설명
id BIGINT PK AI
member_id BIGINT NOT NULL, FK→member(id)
due_date DATE NOT NULL 복습 묶음 로컬 날짜
google_event_id VARCHAR(255) NOT NULL 보조 캘린더 종일 이벤트 id
pending_count INT NOT NULL 마지막 동기화 시 남은 PENDING 수
synced_at DATETIME(6) NOT NULL 마지막 동기화
created_at/updated_at DATETIME(6) NOT NULL JPA Auditing
  • UNIQUE (member_id, due_date).

6.2 google_account 컬럼 추가

컬럼 타입 설명
review_calendar_id VARCHAR(255) NULL 보조 "orino 복습" 캘린더 id
review_mirror_enabled BIT(1) NOT NULL DEFAULT 0 미러 토글 상태 (BOOLEAN은 BIT(1) — Hibernate validate 호환, DB 마이그레이션)

Liquibase

  • 0NN-create-review-calendar-mirror.yaml, 0NN-add-google-account-review-mirror.yaml — Planner 최신 changelog 다음 번호. tableExists/columnExists 가드.

7. 비목표

  • 일정(event) / 할 일(task) 로컬 미러 테이블 없음 (복습 미러는 dueDate↔eventId 매핑만, 이벤트 본문 미저장)
  • syncToken / 동기화 상태 테이블 없음
  • 자료별 캘린더 색상 컬럼 없음(카테고리 모듈과 함께 차기 — Study Planner 결정 기록 §4.5.2와 동일 기조)

Clone this wiki locally