Repository navigation
Monthly Goal
wcorn edited this page Jul 5, 2026
·
1 revision
범위: Planner 통합 캘린더의 월 뷰에서, 화면 좌상단 년월 제목(
2026년 7월) 오른쪽에 그 달의 목표를 한 단락 자유 텍스트로 적고 표시하는 기능. 멤버당 (년, 월) 1개. orino 내부에만 저장하며 Google 연동과 무관하다.상태: 기획 진행 중. Planner 모듈 위에 올라가는 소기능이다.
"이번 달 뭘 할지"를 캘린더를 보는 그 자리에서 바로 적고 상기한다. 별도 목표 관리 화면 없이, 월 뷰 헤더에 인라인으로 붙는다.
장기 백로그의 PRD §6.A.1 목표 CRUD(1년/6개월/3개월, 마일스톤, SP-V3-002)와는 별개의 가벼운 기능이다. 그쪽은 카테고리·마일스톤을 가진 본격 목표 모듈이고, 월간 목표는 "달력 한 칸 위의 메모 한 줄"에 가깝다.
| 항목 | 결정 | 근거 |
|---|---|---|
| 단위 | (member, year, month) 당 1개 | 년월 오른쪽 인라인 배치에 맞는 최소 단위 |
| 형태 | 한 단락 자유 텍스트(여러 줄 허용) | 체크 목표 여러 개(팝오버/패널)는 v1 범위 밖. 인라인 한 줄 표시에 적합 |
| 노출 뷰 | 월 뷰에서만 | 주/일 뷰 제목은 날짜 범위라 "그 달"이 모호. 월 뷰만 년월이 깔끔 |
| 저장소 | orino RDB (monthly_goal) |
개인 메모 성격, 외부 연동 불필요 |
| 빈 목표 | 내용을 비우고 저장하면 행 삭제(DELETE) | 빈 문자열 행을 남기지 않음 |
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| 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개 보장 + 조회 |
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_ymPlanner 네임스페이스 아래에 둔다. 모든 응답은 공통 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} |
목표 삭제 |
200 (있을 때)
{ "code": "SUCCESS", "data": { "year": 2026, "month": 7, "content": "운동 꾸준히, 책 2권 읽기", "updatedAt": "2026-07-05T09:00:00Z" } }200 (없을 때) — { "code": "SUCCESS", "data": null }
요청
{ "content": "운동 꾸준히, 책 2권 읽기" }| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| content | string | Y | 1–1000자, 공백만은 불가(비우려면 DELETE) |
- 해당 (member, year, month) 행이 있으면
content갱신, 없으면 생성. idempotent. - 200 — 저장된 목표(GET과 동일 형식).
-
400 —
content공백/1000자 초과. 400 —month범위(1–12) 위반.
- 해당 월 목표 행 제거. 없어도 200(idempotent) 처리.
대안(오픈): 통합 캘린더 피드(
GET /api/planner/calendar) 응답에 커서 월의monthlyGoal을 함께 실어 요청 1회를 아낄 수 있다. v1은 조회 단순성을 위해 전용 엔드포인트로 분리하고, 성능 이슈 시 피드 통합을 검토한다.
┌──────────────────────────────────────────────────────────────────────────────┐
│ [<] 2026년 7월 [>] ✏️ 운동 꾸준히, 책 2권 읽기 [월][주][일] [오늘] [할일] [일정] │
└──────────────────────────────────────────────────────────────────────────────┘
- 위치:
PlannerCalendar헤더 flex 행에서 년월 제목 그룹 오른쪽, 우측 컨트롤(뷰 전환·오늘·할일·일정) 앞. 좁은 화면에서는 다음 줄로 wrap. -
월 뷰(
view === "month")에서만 렌더. 주/일 뷰에서는 숨김.
| 상태 | 표시 |
|---|---|
| 목표 없음 | 흐린 플레이스홀더 + 이번 달 목표 (클릭하면 편집) |
| 목표 있음 | 아이콘 + 텍스트. 길면 한 줄 말줄임(…), hover/클릭 시 전체 |
| 편집 | 클릭 → 인라인 편집(자동 확장 textarea) 또는 소형 팝오버(textarea + [저장]/[삭제]) |
| 저장 중/실패 | 소형 상태 표시(저장 실패 시 재시도, 내용 유실 없음) |
| 동작 | 결과 |
|---|---|
| 플레이스홀더/텍스트 클릭 | 편집 모드 진입, 기존 내용 로드·포커스 |
| 저장(Enter 또는 [저장], blur) |
PUT upsert → 표시 갱신 |
| 내용 비우고 저장 |
DELETE → 플레이스홀더로 복귀 |
월 이동(< >) |
새 년월의 목표를 로드해 표시 |
- 소형 팝오버 + textarea: 여러 줄 입력이 자연스럽고 헤더 레이아웃을 밀지 않는다. [저장]·[삭제] 버튼 명시. 저장은 명시 버튼(또는 blur) — 헤더 인라인에 "저장됨" 토스트성 표시는 최소화.
- 대안: 인라인 자동저장(2초 debounce) — 메모와 일관되나 헤더 상태 표시가 번잡. v1은 팝오버 명시 저장 권장.
- 디자인 시스템: 다크모드, 공통 팝오버/버튼/입력 컴포넌트 재사용. 플레이스홀더·아이콘은 muted 톤.
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을 렌더.
- 단일 사용자·저트래픽 → 일반 RDB 조회. 조회/저장 200ms 이내.
- 다크모드·반응형. 헤더 레이아웃 밀림 방지(고정/유연 폭, 주간 계획표 #712/#714 교훈 승계).
- 체크 가능한 목표 항목 여러 개(팝오버/패널) — 차기
- 주/일 뷰 노출, 주간/연간 목표
- 목표 달성률·통계·회고, 카테고리 연결
- 지난 달 목표 자동 이월/복사
- 본격 목표 모듈(PRD §6.A.1 SP-V3-002)과의 통합