Skip to content

Day Plan Data Model

wcorn edited this page Jun 27, 2026 · 3 revisions

데이터 모델링: 주간 계획표 (Weekly Plan)

범위: 멤버당 단일 주간 템플릿의 시간 블록을 로컬 테이블 하나(day_plan_block)에 저장한다. 플랜 wrapper·반복 규칙·미러 매핑·Google 컬럼 전부 없음(재설계로 제거).

상태: 구현 완료 (2026-06-27, WP0 #633 · WP1 #636). 옛 설계 폐기 경위는 결정 기록 §0 참고.

1. 개요

member (1) ──< (N) day_plan_block       # 멤버에 직접 종속. wrapper 테이블 없음
                       └ day_of_week · start/end TIME · label · color
  • 한 주의 모든 블록 = 그 멤버의 day_plan_block 행 전체. 이게 곧 "단일 주간 템플릿".
  • Google·보조 캘린더·google_event_id·미러 매핑 일체 없음.

2. day_plan_block 테이블

요일별 시간 블록. 한 주 계획표의 한 칸.

컬럼 타입 제약 설명
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_time NULL) 개념. end_time은 NOT NULL.
  • member 삭제 시 cascade(기존 관례).

3. 제거된 것 (옛 설계)

재설계로 다음 스키마 요소를 모두 폐기한다:

폐기 사유
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 미러 토글 없음

4. 엔티티 (JPA)

ds.project.orino.domain.planner.dayplan.entity.DayPlanBlock

  • created_at/updated_at은 @CreatedDate/@LastModifiedDate.
  • wrapper 엔티티(DayPlan)·DayPlanFreq enum·CSV 컨버터 제거.
  • 단순 평면 엔티티 1개. 연관은 member_id 컬럼만(필요 시 @ManyToOne Member 대신 FK 값 보유 — 기존 관례 따름).

5. 마이그레이션 (Liquibase)

옛 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/columnExists preCondition 가드, member(id) FK, DATETIME(6), TINYINT. 상세는 DB 마이그레이션.

6. 제거 대상 코드 (옛 DP0 #608)

스키마와 함께 다음 BE 코드를 삭제한다: DayPlan(엔티티)·DayPlanFreq·DayPlanRepository·PlanExpander·DayPlanRecurrenceMapper·DayPlanRecurrence(DTO)·PlanInstancesResponse·펼침(/instances) 컨트롤러/서비스 경로·관련 테스트(PlanExpanderTest).

7. Redis / 캐시

신규 키 없음. 외부 피드가 없으므로 캐시 대상도 없다.

8. 비목표

  • 플랜 wrapper / 반복 규칙 / 펼침 결과 저장 테이블
  • 미러 매핑·google_event_id·Google 컬럼
  • 인스턴스 예외("이 날짜만") 테이블 — v1 제외
  • 블록 완료/시간 추적 테이블 — v1 제외

Clone this wiki locally