Repository navigation
Day Plan Architecture
wcorn edited this page Jun 27, 2026
·
3 revisions
범위: 멤버당 단일 주간 템플릿(요일별 시간 블록)을 orino DB에 저장하고, 독립 페이지 한 장으로 보여준다. 외부 연동·반복 펼침·알림 미러 전부 없음.
상태: 구현 완료 (2026-06-27, WP0 #633 · WP1 #636). 핵심 가치: 단일 사용자 / 유지보수 최소화 → "가장 단순한 쪽". 옛 설계(캘린더 배경 레이어 + Google 차임 미러)는 결정 기록 §0에 따라 폐기했다.
┌──────────────┐ JWT/REST ┌────────────────────────────────┐ ┌─────────┐
│ Frontend │────────────▶│ orino BE │──▶│ MySQL │ day_plan_block
│ 주간 그리드 │◀────────────│ DayPlanService (CRUD only) │ └─────────┘
│ (/planner/ │ │ GET 주간 블록 조회 │
│ plan) │ │ PUT 주간 블록 전량 교체 │
└──────────────┘ └────────────────────────────────┘
외부 연동 없음 — Google / 보조 캘린더 / Redis 캐시 / 반복 엔진 모두 미사용.
- 진실 = orino DB. 단일 사용자의 내부 데이터일 뿐, 외부로 나가지 않는다.
- 서비스는 읽기·전량 교체만 한다. 반복 펼침(
PlanExpander)·미러(PlanMirrorService)·RRULE 매퍼는 존재하지 않는다(옛 DP0 코드에서 제거 대상, 데이터 모델 §6).
BE 코드 아키텍처를 따른다. Planner planner/ 하위.
orino-domain-rdb (ds.project.orino.domain.planner.dayplan/):
dayplan/
├── entity/DayPlanBlock.java # 요일·시작·종료·라벨·색 (member_id 직접 보유)
└── repository/DayPlanBlockRepository.java
orino-app-api (ds.project.orino.planner.dayplan/):
dayplan/
├── DayPlanController.java (GET /plan, PUT /plan)
├── DayPlanService.java (조회 · 전량 교체)
└── dto/ (DayPlanResponse, WeeklyPlanRequest, DayPlanBlockResponse/Request)
제거 대상(옛 DP0 #608 머지분):
DayPlan엔티티(wrapper)·DayPlanFreq·PlanExpander·DayPlanRecurrenceMapper·DayPlanRecurrence·PlanInstancesResponse·펼침(/instances) 엔드포인트. 재설계로 전부 삭제한다.
PUT /api/planner/plan { blocks: [ {dayOfWeek, startTime, endTime, label, color}, ... ] }
▼
DayPlanService.replace(memberId, blocks)
- 멤버의 기존 블록 전부 삭제 후 요청 블록으로 재삽입(또는 diff upsert)
- 요청 = 최종 상태. 부분 PATCH·블록별 id 추적 불필요(소수 데이터)
- 블록은 멤버에 직접 종속(
member_id). 플랜 wrapper 엔티티 없음 → "단일 템플릿"이 구조로 보장된다. - 단일 사용자·소수 블록이라 전량 교체 비용 무시 가능. 동시성·낙관적 락 불필요.
- 블록 시간은 벽시계(wall-clock) TIME로 저장(예: 08:00). 외부로 안 나가므로 시간대 변환·UTC 직렬화가 필요 없다.
- 요일은 정수
0=일 … 6=토로 저장(그리드 컬럼과 1:1). FE 표시 로케일과 무관.
Planner와 동일 인프라·정책을 상속한다.
| 상황 | 처리 |
|---|---|
| 조회/교체 | 인증만 필요(/api/planner/plan/**) |
| 잘못된 블록(역전·요일 범위·라벨 누락) | 400 PLN-ERR-002 |
| 외부 API | 호출 없음 → Google 관련 에러 코드(409/502/401) 사용 안 함 |
- Google / 캘린더 연동 일체(primary·보조 캘린더 push 모두 안 함)
- 반복 규칙·RRULE 엔진·인스턴스 펼침(항상 "이번 주 = 매주")
- 폰 알림/차임 미러(
PlanMirrorService제거) - 일/주 캘린더 타임라인 배경 레이어 오버레이(독립 페이지로 대체)
- 여러 템플릿 전환·인스턴스 예외·완료 체크·시간 추적(v1 제외)