Skip to content

Day Plan Open Items

wcorn edited this page Jun 27, 2026 · 3 revisions

Open Items / 결정 기록: 주간 계획표 (Weekly Plan)

이 문서는 주간 계획표(구 "데일리 플랜") 모듈의 결정과 이유를 보존한다. 향후 변경 시 컨텍스트 참고용.

상태: 구현 완료 (2026-06-27, WP0 #633 · WP1 #636). 멤버당 단일 주간 템플릿, 외부 의존 없음.

0. 재설계 결정 (2026-06-27, 사용자 합의)

옛 설계("반복되는 하루 템플릿" + 캘린더 배경 레이어 + Google 차임 미러, DP0~DP5)를 대폭 축소해 "주간 계획표 한 장"으로 다시 잡았다.

0.1 본질은 "한 주의 모양"을 그리는 인터페이스

결정: 데일리 플랜은 사실상 계획표다 — "내가 어떻게 살지"의 인터페이스를 그리는 것. 굳이 캘린더에 얹지 말고 일~토 한 주만 시간별로 설정하는 독립 페이지로 둔다. 이유: 생활 리듬은 주 단위(평일/주말·요일 패턴). 무한 캘린더에 펼칠 이유가 없고, 옛 설계의 복잡도(RRULE·다중 플랜·배경 오버레이)는 대부분 "캘린더에 얹는다"는 전제에서 나왔다. 전제를 버리면 복잡도가 함께 사라진다. 대안(기각): 옛 설계 유지 — 단일 사용자 정적 템플릿에 과한 기계 장치.

0.2 순수 시각 한 장 (알림·연동 없음)

결정: 세운 계획표는 들여다보는 정적 시각 템플릿. 폰 알림(차임)·Google 보조 캘린더 미러·캘린더 오버레이 전부 제거. 이유: 사용자가 "순수 시각 한 장"을 선택. 알림이 필요해지면 그때 재도입(YAGNI). 영향: BE 절반(미러 서비스·토글·백필·status 확장)과 FE 배경 레이어 단계가 통째로 사라짐. Google 의존 0.

0.3 단일 주간 템플릿 (멤버당 하나)

결정: 멤버당 템플릿은 하나(일~토). 여러 템플릿 전환·활성/비활성 관리 없음. 이유: 사용자가 "단일 주간 한 장" 선택. 플랜 wrapper 테이블·CRUD 관리 화면이 불필요해져 블록을 member_id에 직접 매단다. 대안(기각·차후): 전환 가능한 다중 템플릿(평소/시험기간) — 활성 관리 로직이 다시 생김. 필요해지면 wrapper 테이블 추가로 확장 가능.

0.4 반복·펼침 제거 ("이번 주 = 매주")

결정: RRULE·freq·starts_on/until·PlanExpander·/instances 펼침 삭제. 블록은 요일(0~6)에 직접 귀속. 이유: 단일 주간 템플릿이라 "이번 주가 곧 매주". 펼칠 대상이 없다.

0.5 블록 = 구간만 (시점·차임 제거)

결정: 모든 블록은 구간(end_time NOT NULL, > start_time). 옛 "시점 블록"(end NULL, 기상 알람용)과 chime 컬럼 제거. 이유: 알림이 없으므로 0길이 시점 블록의 의미가 사라짐. 자정 넘김(수면)은 두 블록으로 분리.

1. 구현 결정

1.1 전량 교체(declarative) 저장

결정: PUT /api/planner/plan이 멤버 주간 블록의 최종 상태를 통째로 받는다. 블록별 id diff 불필요. 이유: 단일 사용자·소수 블록. 부분 PATCH보다 단순하고 정합성 안전.

1.2 블록은 member에 직접 종속 (wrapper 없음)

결정: day_plan 테이블 폐기, day_plan_block(member_id, day_of_week, …)만 유지. 이유: "단일 템플릿"을 구조로 보장. 테이블·엔티티 1개로 최소화.

1.3 옛 DP0(#608) 머지 코드 갈아엎기

결정: 028 마이그레이션 + recurrence/expand 코드(PlanExpander·DayPlanRecurrenceMapper·DayPlanFreq·PlanInstancesResponse·DayPlan 엔티티)를 제거하고 029로 reshape. 이유: 옛 무거운 스키마가 그대로 머지돼 있으나 사용자 노출 0 → drop-and-recreate가 안전·단순. 데이터 모델 §5–6.

2. 의존성

  • 없음. Google·복습 미러(RM0 #584)·Routine RRULE 엔진에 대한 의존이 모두 사라졌다(재설계 0.2/0.4). 독립 진행 가능.

3. 미해결 / 구현 시 결정

  • 저장 방식: 명시적 [저장] 버튼 vs 디바운스 자동 저장 → 권장: 명시적 버튼 + 미저장 표시(UI §4).
  • 모바일 레이아웃: 7컬럼 동시 vs 1일 뷰 + 요일 스와이프 → 권장: 1일 뷰(UI §5).
  • 요일 간 블록 이동: 드래그로 요일 변경 지원 여부(v1은 삭제 후 재생성으로 대체 가능).
  • 표시 시간 범위: 기본 윈도우(예 06~24)와 스냅 단위(30분/1시간).
  • 겹침 시각화: 같은 요일 블록 겹침 시 분할 렌더 규칙(드문 케이스).
  • 여러 템플릿(차후): 필요 시 wrapper 테이블 재도입으로 확장.

4. 명시적 비목표

  • Google/캘린더 연동 일체(primary·보조 캘린더, 차임 미러)
  • 캘린더 일/주 타임라인 배경 레이어 오버레이
  • 반복 규칙·RRULE·인스턴스 펼침
  • 여러 템플릿 전환·인스턴스 예외("이 날짜만")·완료 체크·시간 추적
  • 자동 스케줄링/플랜 추천

Clone this wiki locally