Skip to content

Day Plan Architecture

wcorn edited this page Jun 27, 2026 · 3 revisions

시스템 아키텍처: 주간 계획표 (Weekly Plan)

범위: 멤버당 단일 주간 템플릿(요일별 시간 블록)을 orino DB에 저장하고, 독립 페이지 한 장으로 보여준다. 외부 연동·반복 펼침·알림 미러 전부 없음.

상태: 구현 완료 (2026-06-27, WP0 #633 · WP1 #636). 핵심 가치: 단일 사용자 / 유지보수 최소화 → "가장 단순한 쪽". 옛 설계(캘린더 배경 레이어 + Google 차임 미러)는 결정 기록 §0에 따라 폐기했다.

1. 전체 구조

┌──────────────┐  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).

2. 백엔드 패키지 구조

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) 엔드포인트. 재설계로 전부 삭제한다.

3. 전량 교체(declarative) 한 가지 흐름

PUT /api/planner/plan  { blocks: [ {dayOfWeek, startTime, endTime, label, color}, ... ] }
        ▼
DayPlanService.replace(memberId, blocks)
   - 멤버의 기존 블록 전부 삭제 후 요청 블록으로 재삽입(또는 diff upsert)
   - 요청 = 최종 상태. 부분 PATCH·블록별 id 추적 불필요(소수 데이터)
  • 블록은 멤버에 직접 종속(member_id). 플랜 wrapper 엔티티 없음 → "단일 템플릿"이 구조로 보장된다.
  • 단일 사용자·소수 블록이라 전량 교체 비용 무시 가능. 동시성·낙관적 락 불필요.

4. 시간대 처리

  • 블록 시간은 벽시계(wall-clock) TIME로 저장(예: 08:00). 외부로 안 나가므로 시간대 변환·UTC 직렬화가 필요 없다.
  • 요일은 정수 0=일 … 6=토로 저장(그리드 컬럼과 1:1). FE 표시 로케일과 무관.

5. 보안 / 실패 처리

Planner와 동일 인프라·정책을 상속한다.

상황 처리
조회/교체 인증만 필요(/api/planner/plan/**)
잘못된 블록(역전·요일 범위·라벨 누락) 400 PLN-ERR-002
외부 API 호출 없음 → Google 관련 에러 코드(409/502/401) 사용 안 함

6. 명시적 비목표 (아키텍처)

  • Google / 캘린더 연동 일체(primary·보조 캘린더 push 모두 안 함)
  • 반복 규칙·RRULE 엔진·인스턴스 펼침(항상 "이번 주 = 매주")
  • 폰 알림/차임 미러(PlanMirrorService 제거)
  • 일/주 캘린더 타임라인 배경 레이어 오버레이(독립 페이지로 대체)
  • 여러 템플릿 전환·인스턴스 예외·완료 체크·시간 추적(v1 제외)

Clone this wiki locally