Repository navigation
Planner Data Model
wcorn edited this page Jun 19, 2026
·
2 revisions
범위: Google 연동 자격증명 저장. 일정/할 일은 Google이 source of truth이므로 orino에 저장하지 않는다(로컬 미러 없음). 복습은 기존
review_schedule재사용. 결정 근거는 결정 기록 참고.
신규 영속 테이블은 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는 표시할 때마다 라이브로 조회한다.
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_idUNIQUE. - 삭제 정책: 연결 해제 시 row DELETE. member 삭제 시 cascade(기존 관례 따름).
- 마이그레이션 파일:
023-create-google-account.yaml(현재 마지막이022). - 관례 준수: preCondition
tableExists가드,member(id)FK,DATETIME(6),created_at/updated_at컬럼. 상세는 DB 마이그레이션.
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초 (선택) | 뷰 전환 중복 호출 흡수, 쓰기 시 무효화 |
ds.project.orino.domain.planner.google.entity.GoogleAccount — created_at/updated_at은 @CreatedDate/@LastModifiedDate.
일정/할 일은 엔티티가 없다. BE는 Google API 응답 DTO를 그대로 사용자 시간대로 정규화해 응답에 싣는다(저장 없음).
복습을 보조 캘린더로 단방향 push하는 하위 기능. 상세는 복습 → Google Calendar 단방향 미러링 참고.
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).
| 컬럼 | 타입 | 설명 |
|---|---|---|
review_calendar_id |
VARCHAR(255) NULL | 보조 "orino 복습" 캘린더 id |
review_mirror_enabled |
BIT(1) NOT NULL DEFAULT 0 | 미러 토글 상태 (BOOLEAN은 BIT(1) — Hibernate validate 호환, DB 마이그레이션) |
-
0NN-create-review-calendar-mirror.yaml,0NN-add-google-account-review-mirror.yaml— Planner 최신 changelog 다음 번호.tableExists/columnExists가드.
- 일정(event) / 할 일(task) 로컬 미러 테이블 없음 (복습 미러는 dueDate↔eventId 매핑만, 이벤트 본문 미저장)
- syncToken / 동기화 상태 테이블 없음
- 자료별 캘린더 색상 컬럼 없음(카테고리 모듈과 함께 차기 — Study Planner 결정 기록 §4.5.2와 동일 기조)