Repository navigation
Day Plan Data Model
wcorn edited this page Jun 27, 2026
·
3 revisions
범위: 멤버당 단일 주간 템플릿의 시간 블록을 로컬 테이블 하나(
day_plan_block)에 저장한다. 플랜 wrapper·반복 규칙·미러 매핑·Google 컬럼 전부 없음(재설계로 제거).상태: 구현 완료 (2026-06-27, WP0 #633 · WP1 #636). 옛 설계 폐기 경위는 결정 기록 §0 참고.
member (1) ──< (N) day_plan_block # 멤버에 직접 종속. wrapper 테이블 없음
└ day_of_week · start/end TIME · label · color
- 한 주의 모든 블록 = 그 멤버의
day_plan_block행 전체. 이게 곧 "단일 주간 템플릿". - Google·보조 캘린더·
google_event_id·미러 매핑 일체 없음.
요일별 시간 블록. 한 주 계획표의 한 칸.
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
id |
BIGINT | PK, AUTO_INCREMENT | |
member_id |
BIGINT | NOT NULL, FK→member(id)
|
소유자(블록이 직접 보유) |
day_of_week |
TINYINT | NOT NULL | 요일 0=일 … 6=토
|
start_time |
TIME | NOT NULL | 시작(벽시계, 예: 08:00) |
end_time |
TIME | NOT NULL | 종료. 항상 > start_time(구간 블록) |
label |
VARCHAR(100) | NOT NULL | 블록 라벨("개인 프로젝트") |
color |
VARCHAR(20) | NULL | 블록 색(디자인 토큰 키 또는 hex) |
sort_order |
INT | NOT NULL DEFAULT 0 | 동일 요일 내 표시 정렬(보통 start 순) |
created_at |
DATETIME(6) | NOT NULL | JPA Auditing |
updated_at |
DATETIME(6) | NOT NULL | JPA Auditing |
-
INDEX:
(member_id, day_of_week, start_time)— 멤버 주간 블록을 요일·시각 순 일괄 로드. - 옛 모델 대비 변경:
plan_id→member_id, 추가day_of_week·color, 제거chime·시점 블록(end_timeNULL) 개념.end_time은 NOT NULL. - member 삭제 시 cascade(기존 관례).
재설계로 다음 스키마 요소를 모두 폐기한다:
| 폐기 | 사유 |
|---|---|
day_plan 테이블 전체 |
단일 템플릿이라 wrapper 불필요. member_id를 블록이 직접 보유 |
freq/interval_val/by_day/by_month_day/starts_on/until
|
반복 펼침 없음("이번 주=매주") |
enabled |
활성/비활성 관리 없음 |
day_plan_block.chime |
알림 없음 |
day_plan_block.google_event_id |
미러 없음 |
google_account.plan_calendar_id / plan_mirror_enabled
|
미러 토글 없음 |
ds.project.orino.domain.planner.dayplan.entity.DayPlanBlock
-
created_at/updated_at은@CreatedDate/@LastModifiedDate. - wrapper 엔티티(
DayPlan)·DayPlanFreqenum·CSV 컨버터 제거. - 단순 평면 엔티티 1개. 연관은
member_id컬럼만(필요 시@ManyToOne Member대신 FK 값 보유 — 기존 관례 따름).
옛 DP0가 적용한 028-create-day-plan.yaml(day_plan + day_plan_block, 반복/차임 포함)을 재설계로 갈아엎는다. 기능이 사용자에게 노출된 적 없으므로 데이터 보존 불필요.
-
029-reshape-day-plan.yaml(번호는 머지 시점 최신 다음):-
day_plan테이블 drop(있으면),day_plan_block테이블 drop 후 재생성 또는alter(plan_id·chime·google_event_id 제거, member_id·day_of_week·color 추가). - 권장: drop-and-recreate(미사용 테이블이라 단순·안전).
-
-
google_account에 plan 미러 컬럼이 추가된 적 없으면 별도 작업 불필요(옛 설계 컬럼은 DP0 #608에 포함되지 않았다면 무시). - 관례 준수:
tableExists/columnExistspreCondition 가드,member(id)FK,DATETIME(6),TINYINT. 상세는 DB 마이그레이션.
스키마와 함께 다음 BE 코드를 삭제한다: DayPlan(엔티티)·DayPlanFreq·DayPlanRepository·PlanExpander·DayPlanRecurrenceMapper·DayPlanRecurrence(DTO)·PlanInstancesResponse·펼침(/instances) 컨트롤러/서비스 경로·관련 테스트(PlanExpanderTest).
신규 키 없음. 외부 피드가 없으므로 캐시 대상도 없다.
- 플랜 wrapper / 반복 규칙 / 펼침 결과 저장 테이블
- 미러 매핑·
google_event_id·Google 컬럼 - 인스턴스 예외("이 날짜만") 테이블 — v1 제외
- 블록 완료/시간 추적 테이블 — v1 제외