Skip to content

Monthly Goal

wcorn edited this page Jul 5, 2026 · 1 revision

월간 목표 (Monthly Goal) — Planner 하위 기능

범위: Planner 통합 캘린더의 월 뷰에서, 화면 좌상단 년월 제목(2026년 7월) 오른쪽에 그 달의 목표를 한 단락 자유 텍스트로 적고 표시하는 기능. 멤버당 (년, 월) 1개. orino 내부에만 저장하며 Google 연동과 무관하다.

상태: 기획 진행 중. Planner 모듈 위에 올라가는 소기능이다.

1. 목표

"이번 달 뭘 할지"를 캘린더를 보는 그 자리에서 바로 적고 상기한다. 별도 목표 관리 화면 없이, 월 뷰 헤더에 인라인으로 붙는다.

장기 백로그의 PRD §6.A.1 목표 CRUD(1년/6개월/3개월, 마일스톤, SP-V3-002)와는 별개의 가벼운 기능이다. 그쪽은 카테고리·마일스톤을 가진 본격 목표 모듈이고, 월간 목표는 "달력 한 칸 위의 메모 한 줄"에 가깝다.

2. 핵심 결정

항목 결정 근거
단위 (member, year, month) 당 1개 년월 오른쪽 인라인 배치에 맞는 최소 단위
형태 한 단락 자유 텍스트(여러 줄 허용) 체크 목표 여러 개(팝오버/패널)는 v1 범위 밖. 인라인 한 줄 표시에 적합
노출 뷰 월 뷰에서만 주/일 뷰 제목은 날짜 범위라 "그 달"이 모호. 월 뷰만 년월이 깔끔
저장소 orino RDB (monthly_goal) 개인 메모 성격, 외부 연동 불필요
빈 목표 내용을 비우고 저장하면 행 삭제(DELETE) 빈 문자열 행을 남기지 않음

3. 데이터 모델

테이블: monthly_goal

컬럼 타입 제약 설명
id BIGINT PK, AUTO_INCREMENT
member_id BIGINT NOT NULL, FK → member(id) 소유자
year SMALLINT NOT NULL 연도 (예: 2026)
month TINYINT NOT NULL, 1–12 월
content VARCHAR(1000) NOT NULL 목표 텍스트(여러 줄은 \n)
created_at DATETIME(6) NOT NULL, updatable=false JPA Auditing
updated_at DATETIME(6) NOT NULL JPA Auditing

인덱스

인덱스 컬럼 용도
PK id
uq_monthly_goal_member_ym UNIQUE (member_id, year, month) 년월당 1개 보장 + 조회

Liquibase

DB 마이그레이션 규칙에 따라 신규 changeset으로 관리한다. 파일명은 구현 시점의 다음 번호(예: 032-create-monthly-goal.yaml).

# 032-create-monthly-goal.yaml (개요)
- createTable: monthly_goal
    - id         BIGINT PK AUTO_INCREMENT
    - member_id  BIGINT NOT NULL
    - year       SMALLINT NOT NULL
    - month      TINYINT NOT NULL
    - content    VARCHAR(1000) NOT NULL
    - created_at DATETIME(6) NOT NULL
    - updated_at DATETIME(6) NOT NULL
- addForeignKeyConstraint: monthly_goal.member_id → member(id)
- addUniqueConstraint: (member_id, year, month)  name=uq_monthly_goal_member_ym

4. API 설계

Planner 네임스페이스 아래에 둔다. 모든 응답은 공통 envelope(code, data), JWT 필요. 에러 컨벤션.

Method Path 설명
GET /api/planner/monthly-goals/{year}/{month} 해당 월 목표 조회. 없으면 data: null
PUT /api/planner/monthly-goals/{year}/{month} 목표 upsert(생성/수정)
DELETE /api/planner/monthly-goals/{year}/{month} 목표 삭제

GET — 조회

200 (있을 때)

{ "code": "SUCCESS", "data": { "year": 2026, "month": 7, "content": "운동 꾸준히, 책 2권 읽기", "updatedAt": "2026-07-05T09:00:00Z" } }

200 (없을 때) — { "code": "SUCCESS", "data": null }

PUT — upsert

요청

{ "content": "운동 꾸준히, 책 2권 읽기" }
필드 타입 필수 설명
content string Y 1–1000자, 공백만은 불가(비우려면 DELETE)
  • 해당 (member, year, month) 행이 있으면 content 갱신, 없으면 생성. idempotent.
  • 200 — 저장된 목표(GET과 동일 형식).
  • 400 — content 공백/1000자 초과. 400 — month 범위(1–12) 위반.

DELETE — 삭제

  • 해당 월 목표 행 제거. 없어도 200(idempotent) 처리.

대안(오픈): 통합 캘린더 피드(GET /api/planner/calendar) 응답에 커서 월의 monthlyGoal을 함께 실어 요청 1회를 아낄 수 있다. v1은 조회 단순성을 위해 전용 엔드포인트로 분리하고, 성능 이슈 시 피드 통합을 검토한다.

5. 화면 설계

배치 (월 뷰 헤더)

┌──────────────────────────────────────────────────────────────────────────────┐
│ [<] 2026년 7월 [>]   ✏️ 운동 꾸준히, 책 2권 읽기         [월][주][일] [오늘] [할일] [일정] │
└──────────────────────────────────────────────────────────────────────────────┘
  • 위치: PlannerCalendar 헤더 flex 행에서 년월 제목 그룹 오른쪽, 우측 컨트롤(뷰 전환·오늘·할일·일정) 앞. 좁은 화면에서는 다음 줄로 wrap.
  • 월 뷰(view === "month")에서만 렌더. 주/일 뷰에서는 숨김.

상태별 표시

상태 표시
목표 없음 흐린 플레이스홀더 + 이번 달 목표 (클릭하면 편집)
목표 있음 아이콘 + 텍스트. 길면 한 줄 말줄임(…), hover/클릭 시 전체
편집 클릭 → 인라인 편집(자동 확장 textarea) 또는 소형 팝오버(textarea + [저장]/[삭제])
저장 중/실패 소형 상태 표시(저장 실패 시 재시도, 내용 유실 없음)

상호작용

동작 결과
플레이스홀더/텍스트 클릭 편집 모드 진입, 기존 내용 로드·포커스
저장(Enter 또는 [저장], blur) PUT upsert → 표시 갱신
내용 비우고 저장 DELETE → 플레이스홀더로 복귀
월 이동(< >) 새 년월의 목표를 로드해 표시

편집 방식 (권장안)

  • 소형 팝오버 + textarea: 여러 줄 입력이 자연스럽고 헤더 레이아웃을 밀지 않는다. [저장]·[삭제] 버튼 명시. 저장은 명시 버튼(또는 blur) — 헤더 인라인에 "저장됨" 토스트성 표시는 최소화.
  • 대안: 인라인 자동저장(2초 debounce) — 메모와 일관되나 헤더 상태 표시가 번잡. v1은 팝오버 명시 저장 권장.

디자인 시스템

  • 디자인 시스템: 다크모드, 공통 팝오버/버튼/입력 컴포넌트 재사용. 플레이스홀더·아이콘은 muted 톤.

6. FE 구조

fe/src/features/planner
├─ api/monthlyGoal.ts            fetchMonthlyGoal / saveMonthlyGoal(PUT) / deleteMonthlyGoal
├─ hooks/useMonthlyGoal.ts       (year, month) 조회
├─ hooks/useMonthlyGoalMutations.ts  저장/삭제 + 캐시 무효화
└─ components/calendar/MonthlyGoalInline.tsx   년월 오른쪽 인라인 표시·편집
  • PlannerCalendar에서 view === "month"일 때 커서의 getFullYear()/getMonth()+1로 MonthlyGoalInline을 렌더.

7. 비기능 요구사항

  • 단일 사용자·저트래픽 → 일반 RDB 조회. 조회/저장 200ms 이내.
  • 다크모드·반응형. 헤더 레이아웃 밀림 방지(고정/유연 폭, 주간 계획표 #712/#714 교훈 승계).

8. 범위 외 (v1)

  • 체크 가능한 목표 항목 여러 개(팝오버/패널) — 차기
  • 주/일 뷰 노출, 주간/연간 목표
  • 목표 달성률·통계·회고, 카테고리 연결
  • 지난 달 목표 자동 이월/복사
  • 본격 목표 모듈(PRD §6.A.1 SP-V3-002)과의 통합

Clone this wiki locally