feat(project): 연간 목표 — 사이드바 "목표" → 연도 → 그해 전체 목표 표

- 사이드바 휴지통 아래 "목표": 누르면 연도 목록이 펼쳐지고(올해는 항상), 관리자는 + 연도 추가
- /project/goals/{연도}: 매출(목표·실적·달성)·로아스(목표·실적) 월별 숫자 + 업무 영역
  (상품·마케팅·컨텐츠·유통[콜라보·인플·쿠팡·기타])별 연간·월별 글을 스프레드시트처럼 한 표에
- 매출 연간 합계·달성률은 화면에서 계산, 칸별 즉시 저장, 영역 이름·색·순서·줄 추가/삭제
- 입력·구조 변경은 관리자만, 조회는 project 권한자 전원
- 새 연도는 가장 가까운 이전 연도의 영역 구성을 복사(처음이면 기본 4개 영역)
- DB 마이그레이션 013(goal_years·goal_metrics·goal_areas·goal_rows·goal_cells), 문서·도움말 갱신
- project.js/css 캐시 버전 20260930a

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-30 11:13:54 +09:00
parent b95206dcf4
commit ec78dd328d
15 changed files with 1315 additions and 13 deletions
+83
View File
@@ -329,6 +329,89 @@ def validate_time(t: Any) -> str | None:
return f"{hh:02d}:{mm:02d}"
# ════════════════════════════════════════════════════════════
# 연간 목표 (마이그레이션 013) — 사이드바 "목표" → 연도
# ════════════════════════════════════════════════════════════
GOAL_METRICS: tuple[str, ...] = ("sales", "roas") # 매출 · 로아스
GOAL_KINDS: tuple[str, ...] = ("target", "actual") # 목표 · 실적
# 업무 영역 줄 배경색 — 스프레드시트처럼 연한 색만(글자는 항상 진한 색).
GOAL_AREA_COLORS: tuple[str, ...] = (
"#fbe1d5", "#d9f2d0", "#d4d4d4", "#f0cdec",
"#dbe8fb", "#fff2c2", "#e3dcfb", "#d3f0ee",
)
# 새 연도를 만들 때 이전 연도가 없으면 이 영역으로 시작한다(이전 연도가 있으면 그 구조를 복사).
DEFAULT_GOAL_AREAS: tuple[tuple[str, str, tuple[str, ...]], ...] = (
("상품", "#fbe1d5", ("",)),
("마케팅", "#d9f2d0", ("",)),
("컨텐츠", "#d4d4d4", ("",)),
("유통", "#f0cdec", ("콜라보", "인플", "쿠팡", "기타")),
)
GOAL_TEXT_MAX = 4000
def validate_goal_year(y: Any) -> int:
try:
v = int(str(y).strip())
except (TypeError, ValueError):
raise ValueError("연도가 올바르지 않습니다.")
if not 2000 <= v <= 2100:
raise ValueError("연도는 2000 ~ 2100 사이여야 합니다.")
return v
def validate_goal_month(m: Any, *, allow_year: bool = False) -> int:
"""1~12월. allow_year 이면 0(연간)도 허용."""
try:
v = int(m)
except (TypeError, ValueError):
raise ValueError("월이 올바르지 않습니다.")
if not ((0 if allow_year else 1) <= v <= 12):
raise ValueError("월이 올바르지 않습니다.")
return v
def validate_goal_value(v: Any) -> float | None:
"""지표 숫자 — '1,234.5' 같은 쉼표·공백·% 는 떼고 읽는다. 빈값은 None(=지움)."""
s = norm_str(v).replace(",", "").replace("%", "").replace(" ", "")
if not s:
return None
try:
f = float(s)
except ValueError:
raise ValueError(f"숫자가 아닙니다: {v}")
if f != f or abs(f) >= 1e16: # NaN · NUMERIC(18,2) 범위 밖
raise ValueError(f"숫자 범위를 벗어났습니다: {v}")
return round(f, 2)
def validate_goal_area_name(name: Any) -> str:
v = norm_str(name)
if not v:
raise ValueError("업무 영역 이름을 입력하세요.")
if len(v) > 50:
raise ValueError("업무 영역 이름은 50자 이하로 입력하세요.")
return v
def validate_goal_row_label(label: Any) -> str:
v = norm_str(label)
if len(v) > 50:
raise ValueError("줄 이름은 50자 이하로 입력하세요.")
return v
def validate_goal_color(color: Any) -> str:
v = norm_str(color).lower()
return v if v in GOAL_AREA_COLORS else GOAL_AREA_COLORS[0]
def validate_goal_text(body: Any) -> str:
v = str(body or "").replace("\r\n", "\n").strip()
if len(v) > GOAL_TEXT_MAX:
raise ValueError(f"칸 하나에 {GOAL_TEXT_MAX}자까지 쓸 수 있습니다.")
return v
def build_subject_assigned(*, project_name: str, task_title: str, assignee: str) -> str:
return f"[DBX 프로젝트] 작업 배정: {project_name} · {task_title} → {assignee}"