feat(project): month-bounded meeting weeks, weekly sales targets, sticky header
- Weeks stay inside the month: week 1 starts on the 1st (through the next Sunday if the 1st is a weekend); a trailing Mon/Tue joins the last week. "Last week" is the previous period. - Prev-week review columns: 전주 업무 | 결과(text, new result_note) | 전주 목표 | 결과(amount). - Header now shows month target, cumulative weekly target, month-to-date sales and gap (amount + %), with decisions/notes beside it; the area stays fixed while scrolling. - Goals board: the monthly sales target is entered per week; the sum becomes the month target. - Migration 020: result_note, goal_week_targets, drop Monday-only check, move absorbed Monday meetings to the new week start. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -2600,6 +2600,8 @@ def _goal_call(fn: Any, *args: Any, **kwargs: Any) -> Any:
|
||||
raise HTTPException(status_code=503, detail=_GOALS_017_MSG)
|
||||
except store.MeetingCellMigrationNeeded:
|
||||
raise HTTPException(status_code=503, detail="회의록 셀 병합은 project_db 마이그레이션 019 적용 후 사용할 수 있습니다.")
|
||||
except store.MeetingMigration020Needed:
|
||||
raise HTTPException(status_code=503, detail="새 주차·결과 글·주차별 목표는 project_db 마이그레이션 020 적용 후 사용할 수 있습니다.")
|
||||
except store.GoalCellConflict as exc:
|
||||
raise HTTPException(status_code=409, detail=str(exc))
|
||||
except UndefinedTable:
|
||||
@@ -2644,6 +2646,13 @@ def goals_page(request: Request, year: int) -> HTMLResponse:
|
||||
for area in board["areas"]:
|
||||
_goal_area_layout(area["rows"], this_month)
|
||||
_goal_label_spans(area["rows"])
|
||||
# 주차별 매출 목표(020) — 월 매출 목표 칸을 누르면 그 달 주차별 입력 창(합계 = 월 목표)
|
||||
week_targets = None
|
||||
if board and st.week_targets_enabled():
|
||||
saved = st.goal_week_targets(start=date(year, 1, 1), end=date(year, 12, 31))
|
||||
week_targets = {mo: [{"start": a.isoformat(), "n": i + 1, "label": f"{a.month}/{a.day}~{b.month}/{b.day}",
|
||||
"value": _goal_label("sales", saved.get(a.isoformat()))}
|
||||
for i, (a, b) in enumerate(store.month_weeks(year, mo))] for mo in range(1, 13)}
|
||||
return render_template(
|
||||
request,
|
||||
"project/goals.html",
|
||||
@@ -2670,10 +2679,25 @@ def goals_page(request: Request, year: int) -> HTMLResponse:
|
||||
for q in (1, 2, 3, 4)],
|
||||
"this_month": this_month,
|
||||
"goal_area_colors": list(store.GOAL_AREA_COLORS),
|
||||
"week_targets": week_targets,
|
||||
},
|
||||
)
|
||||
|
||||
|
||||
@router.put("/api/goals/{year}/week-targets/{month}")
|
||||
def api_set_goal_week_targets(request: Request, year: int, month: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
"""그 달 주차별 매출 목표 {weeks: {주차 시작일: 값|""}} — 합계가 그 달 매출 목표가 된다(관리자)."""
|
||||
user = _require_admin(request)
|
||||
st = _db_or_503(request)
|
||||
raw = payload.get("weeks")
|
||||
if not isinstance(raw, dict) or len(raw) > 6:
|
||||
raise HTTPException(status_code=400, detail="weeks 가 올바르지 않습니다.")
|
||||
values = {_goal_call(store.validate_period_start, k): _goal_call(store.validate_goal_value, v) for k, v in raw.items()}
|
||||
total = _goal_call(st.set_goal_week_targets, year=year, month=month, values=values, updated_by=user["email"])
|
||||
return JSONResponse({"ok": True, "value": total, "label": _goal_label("sales", total),
|
||||
"weeks": {k.isoformat(): _goal_label("sales", v) for k, v in values.items()}})
|
||||
|
||||
|
||||
@router.post("/api/goals/years")
|
||||
def api_create_goal_year(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
"""연도 추가(관리자) — 가장 가까운 이전 연도의 영역·줄 구조를 글 없이 복사."""
|
||||
@@ -2697,11 +2721,11 @@ def api_goal_meeting_nav(request: Request) -> JSONResponse:
|
||||
mon = store.validate_week_start(value)
|
||||
if mon.year not in years:
|
||||
continue
|
||||
end = mon + timedelta(days=6)
|
||||
# 달이 바뀌어도 월요일이 속한 월 아래에 한 번만 표시한다.
|
||||
number = next(i + 1 for i, (w, _) in enumerate(store.month_weeks(mon.year, mon.month)) if w == mon)
|
||||
# 주차는 달을 넘지 않는다(020) — 회의록 시작일이 든 주차
|
||||
a, end = store.week_period(mon)
|
||||
number = store.week_number(mon)
|
||||
grouped.setdefault(mon.year, {}).setdefault(mon.month, []).append({
|
||||
"start": mon.isoformat(), "label": f"{number}주차 ({mon.month}/{mon.day}~{end.month}/{end.day})",
|
||||
"start": mon.isoformat(), "label": f"{number}주차 ({a.month}/{a.day}~{end.month}/{end.day})",
|
||||
"href": f"/project/goals/{mon.year}/meetings/{mon.month}?week={mon.isoformat()}",
|
||||
})
|
||||
return JSONResponse({"years": [
|
||||
@@ -2876,9 +2900,9 @@ def api_unmerge_goal_cells(request: Request, row_id: int, start: int) -> JSONRes
|
||||
|
||||
|
||||
# ════════════════════════════════════════════════════════════
|
||||
# 주간 회의록 (마이그레이션 015) — 목표 표 월 머리 → /project/goals/{연도}/meetings/{월}?week=월요일
|
||||
# 주 = 월요일~일요일. 지난주 목표·결과 리뷰 → 월 목표 달성을 위한 이번주 목표·할 일.
|
||||
# 쇼핑몰 연결(유통 줄) 결과·전주/금주 매출·월 누적은 실적 모듈(performance_db)에서 읽기만 한다.
|
||||
# 주간 회의록 (마이그레이션 015·020) — 목표 표 월 머리 → /project/goals/{연도}/meetings/{월}?week=주차 시작일
|
||||
# 주차 = store.month_weeks(그 달 안, 1주차는 1일부터). 지난 주차 업무·결과 리뷰 → 이번 주차 주요 업무·목표.
|
||||
# 월 누적 실적은 실적 모듈(performance_db)에서 읽기만, 월 누적 목표는 목표 표 주차별 목표(goal_week_targets) 합.
|
||||
# ════════════════════════════════════════════════════════════
|
||||
def _perf_sales(request: Request) -> Any:
|
||||
"""실적 모듈 저장소(읽기 전용). 없거나 오류면 None — 회의록은 직접 입력만으로도 동작한다."""
|
||||
@@ -2975,21 +2999,21 @@ def _kst_short(iso: str) -> str:
|
||||
|
||||
|
||||
def _meeting_view(request: Request, st: Any, *, year: int, month: int, week: date) -> dict[str, Any]:
|
||||
"""회의록 화면 데이터 — 머리(월 목표·누적·남은 주 필요 매출·전주/금주 목표·결과) + 줄(지난주 리뷰 포함).
|
||||
"""회의록 화면 데이터 — 머리(월 목표 매출 · 월 누적 목표 · 월 누적 실적 · 누적 목표 대비 차액·%) + 줄(지난주 리뷰 포함).
|
||||
|
||||
"지난주"는 정확히 7일 전 주(prev_week)만 — 머리 전주 목표·전주 결과·줄의 지난주 칸·결과·달성률이 같은 주다
|
||||
(db.get_meeting 이 7일 전 주 회의록에서 같은 연결키 줄만 prev 로 준다). 실적은 _MeetingPerf — 알 수 없는 값은
|
||||
None + head.unknown 에 이름(0 원·0% 로 보이지 않게, 그 값에 기대는 달성률·필요 매출도 계산하지 않는다)."""
|
||||
"지난주"는 바로 앞 주차(store.prev_week_period)만 — 줄의 지난주 칸이 그 주차 회의록의 같은 연결키 줄이다.
|
||||
월 누적 목표 = 1주차~이 주차의 주차별 목표 합(목표 표 매출 단위 → 원), 월 누적 실적 = 1일~오늘(지난 주차면 그 끝날).
|
||||
실적은 _MeetingPerf — 알 수 없는 값은 None + head.unknown 에 이름(0 원·0% 로 보이지 않게)."""
|
||||
today = today_kst()
|
||||
week_end = store.week_period(week)[1]
|
||||
prev_start, _prev_end = store.prev_week_period(week)
|
||||
meeting = st.get_meeting(week_start=week)
|
||||
targets = st.goal_month_targets(year=year, month=month)
|
||||
mult = store.sales_unit_multiplier(targets["sales_unit"])
|
||||
perf = _MeetingPerf(_perf_sales(request))
|
||||
names = perf.names
|
||||
week_end = week + timedelta(days=6)
|
||||
prev_start, prev_end = week - timedelta(days=7), week - timedelta(days=1)
|
||||
first = date(year, month, 1)
|
||||
last = date(year + (month == 12), month % 12 + 1, 1) - timedelta(days=1)
|
||||
last = store.month_last_day(year, month)
|
||||
unknown: list[str] = []
|
||||
|
||||
def total(key: str, a: date, b: date) -> int | None:
|
||||
@@ -2998,26 +3022,27 @@ def _meeting_view(request: Request, st: Any, *, year: int, month: int, week: dat
|
||||
unknown.append(key) # 목록 장애(error) 또는 이 기간 매출 조회 실패(ok 인데 None)
|
||||
return v
|
||||
|
||||
# 월 누적 = 이 주 앞까지(지난주 일요일까지) — 남은 목표를 이번 주 포함 남은 주로 나눠 "주당 필요 매출"
|
||||
mtd_end = min(last, today, prev_end)
|
||||
month_target_won = int(round(targets["sales_target"] * mult)) if targets["sales_target"] is not None and mult else None
|
||||
mtd = total("mtd", first, mtd_end) if mtd_end >= first else 0 # 1주차 앞에는 지난 날이 없다(정말 0)
|
||||
weeks_left = sum(1 for mon, _ in store.month_weeks(year, month) if mon >= week)
|
||||
pm = meeting.get("prev_meeting") if meeting else None # 정확히 7일 전 주 회의록이어야 "전주 목표"
|
||||
need = None
|
||||
if month_target_won is not None and mtd is not None and weeks_left:
|
||||
need = max(0, month_target_won - mtd) // weeks_left
|
||||
try:
|
||||
wt = st.goal_week_targets(start=first, end=last)
|
||||
except Exception: # noqa: BLE001 — 주차 목표를 못 읽어도 회의록은 열린다
|
||||
logger.warning("goal week targets unavailable for meeting", exc_info=True)
|
||||
wt = {}
|
||||
cum_unit = sum(v for k, v in wt.items() if k <= week.isoformat()) if wt else None
|
||||
cum_target_won = int(round(cum_unit * mult)) if cum_unit is not None and mult else None
|
||||
mtd_end = min(last, today, week_end)
|
||||
mtd = total("mtd", first, mtd_end) if mtd_end >= first else None # 아직 시작 전 달은 비움
|
||||
gap = mtd - cum_target_won if mtd is not None and cum_target_won is not None else None
|
||||
rate = round(mtd / cum_target_won * 100, 1) if mtd is not None and cum_target_won else None
|
||||
pm = meeting.get("prev_meeting") if meeting else None
|
||||
fresh = perf.freshness()
|
||||
head = {
|
||||
"sales_unit": targets["sales_unit"], "sales_target": targets["sales_target"],
|
||||
"roas_target": targets["roas_target"], "month_target_won": month_target_won,
|
||||
"mtd": mtd, "mtd_end": mtd_end.isoformat() if mtd_end >= first else "", "weeks_left": weeks_left,
|
||||
"need_per_week": need,
|
||||
"prev_target": pm["week_target"] if pm and pm["week_start"] == prev_start.isoformat() else None,
|
||||
"month_target_won": month_target_won,
|
||||
"week_targets_set": bool(wt), "cum_target": cum_unit, "cum_target_won": cum_target_won,
|
||||
"mtd": mtd, "mtd_end": mtd_end.isoformat() if mtd_end >= first else "", "gap": gap, "rate": rate,
|
||||
"prev_exists": bool(pm and pm["week_start"] == prev_start.isoformat()),
|
||||
"prev_result": total("prev_result", prev_start, prev_end) if prev_start <= today else None,
|
||||
"week_result": total("week_result", week, week_end) if week <= today else None,
|
||||
# perf = 실적 모듈 연결 여부(예전 뜻 그대로 — 갱신 상자·안내 문구 조건), 조회 성공 여부는 perf_state·unknown
|
||||
# perf = 실적 모듈 연결 여부(갱신 상자·안내 문구 조건), 조회 성공 여부는 perf_state·unknown
|
||||
"perf": perf.state != "off",
|
||||
"perf_state": perf.state,
|
||||
"unknown": unknown,
|
||||
@@ -3134,18 +3159,21 @@ def goal_meeting_page(request: Request, year: int, month: int, week: str | None
|
||||
sel = None
|
||||
if week:
|
||||
try:
|
||||
sel = store.validate_week_start(week)
|
||||
sel = store.week_period(store.validate_week_start(week))[0] # 예전 월요일 주소도 그 날짜가 든 주차로
|
||||
except ValueError:
|
||||
sel = None
|
||||
if sel is not None and (sel.year, sel.month) != (year, month):
|
||||
# 다른 달의 주(주는 월요일이 속한 달의 것) — 그 달 회의록 주소로
|
||||
# 다른 달의 주차 — 그 달 회의록 주소로
|
||||
return RedirectResponse(url=f"/project/goals/{sel.year}/meetings/{sel.month}?week={sel.isoformat()}" + ("&content=1" if content else ""),
|
||||
status_code=303)
|
||||
if sel is None or sel not in [w for w, _ in weeks]:
|
||||
if sel is None:
|
||||
sel = next((w for w, e in weeks if w <= today <= e), weeks[0][0])
|
||||
enabled = st.meetings_enabled()
|
||||
cal = store.calendar_weeks(year, month)
|
||||
existing = set(st.meeting_weeks(start=cal[0][0], end=cal[-1][0])) if enabled else set()
|
||||
existing = set(st.meeting_weeks(start=cal[0][0], end=cal[-1][1])) if enabled else set()
|
||||
first = date(year, month, 1)
|
||||
sel_end = store.week_period(sel)[1]
|
||||
prev_start, prev_end = store.prev_week_period(sel)
|
||||
view = _meeting_view(request, st, year=year, month=month, week=sel) if enabled else {}
|
||||
members = _meet_members()
|
||||
admin = is_admin(user)
|
||||
@@ -3171,34 +3199,25 @@ def goal_meeting_page(request: Request, year: int, month: int, week: str | None
|
||||
"meeting_embedded": content,
|
||||
"meetings_enabled": enabled,
|
||||
"weeks": [{"start": w.isoformat(), "end": e.isoformat(), "n": i + 1, "label": f"{w.month}/{w.day}~{e.month}/{e.day}",
|
||||
"has": w.isoformat() in existing, "now": w <= today <= e,
|
||||
# 작은 달력(월요일 시작) 한 줄 — 날짜·그 달 여부·오늘·요일(5 토, 6 일)·공휴일
|
||||
"days": [{"d": (w + timedelta(days=k)).day, "iso": (w + timedelta(days=k)).isoformat(),
|
||||
"in": (w + timedelta(days=k)).month == month, "today": w + timedelta(days=k) == today,
|
||||
"wd": k, "hol": store.KR_HOLIDAYS.get((w + timedelta(days=k)).isoformat(), "")}
|
||||
for k in range(7)]}
|
||||
"has": w.isoformat() in existing, "now": w <= today <= e}
|
||||
for i, (w, e) in enumerate(weeks)],
|
||||
# 작은 달력 — 그 달 날짜가 든 주 전부(앞뒤 달에 속한 주는 흐리게, 누르면 그 달 회의록)
|
||||
"cal_weeks": [{"start": w.isoformat(), "own": (w.year, w.month) == (year, month),
|
||||
"href": (f"?week={w.isoformat()}" if (w.year, w.month) == (year, month)
|
||||
else f"/project/goals/{w.year}/meetings/{w.month}?week={w.isoformat()}"),
|
||||
"title": (f"{next(i + 1 for i, (x, _) in enumerate(weeks) if x == w)}주차"
|
||||
if (w.year, w.month) == (year, month) else f"{w.month}월 주")
|
||||
+ f" ({w.month}/{w.day}~{e.month}/{e.day})",
|
||||
"has": w.isoformat() in existing,
|
||||
# 작은 달력(월요일 시작 줄) — 줄을 누르면 그 줄의 이 달 날짜가 든 주차 회의록(주차는 줄과 꼭 같지 않다)
|
||||
"cal_weeks": [{"start": p[0].isoformat(), "own": True, "href": f"?week={p[0].isoformat()}",
|
||||
"title": f"{store.week_number(p[0])}주차 ({p[0].month}/{p[0].day}~{p[1].month}/{p[1].day})",
|
||||
"has": p[0].isoformat() in existing,
|
||||
"days": [{"d": (w + timedelta(days=k)).day, "in": (w + timedelta(days=k)).month == month,
|
||||
"today": w + timedelta(days=k) == today, "wd": k,
|
||||
"hol": store.KR_HOLIDAYS.get((w + timedelta(days=k)).isoformat(), "")}
|
||||
for k in range(7)]}
|
||||
for w, e in store.calendar_weeks(year, month)],
|
||||
for w, e in cal for p in [store.week_period(max(w, first))]],
|
||||
"week": sel.isoformat(),
|
||||
"week_n": next(i + 1 for i, (w, _) in enumerate(weeks) if w == sel),
|
||||
"week_end": (sel + timedelta(days=6)).isoformat(),
|
||||
"prev_week": (sel - timedelta(days=7)).isoformat(),
|
||||
"prev_week_end": (sel - timedelta(days=1)).isoformat(),
|
||||
# 주차를 열면 다시 받을 매출 기간(실적 모듈 매출 업데이트) — 지난주 월요일 ~ 이번 주 일요일(오늘까지)
|
||||
"sync_from": (sel - timedelta(days=7)).isoformat() if sel - timedelta(days=7) <= today else "",
|
||||
"sync_to": min(sel + timedelta(days=6), today).isoformat(),
|
||||
"week_n": store.week_number(sel),
|
||||
"week_end": sel_end.isoformat(),
|
||||
"prev_week": prev_start.isoformat(),
|
||||
"prev_week_end": prev_end.isoformat(),
|
||||
# 주차를 열면 다시 받을 매출 기간(실적 모듈 매출 업데이트) — 지난 주차 시작 ~ 이 주차 끝(오늘까지)
|
||||
"sync_from": prev_start.isoformat() if prev_start <= today else "",
|
||||
"sync_to": min(sel_end, today).isoformat(),
|
||||
# 쇼핑몰 매출 갱신(실적 모듈 POST /performance/api/sync)은 실적 모듈 권한자만 — 없으면 화면이 부르지 않는다
|
||||
"can_sync": has_module(user, "performance"),
|
||||
"meeting_status": store.MEETING_STATUS,
|
||||
@@ -3227,7 +3246,7 @@ def api_create_meeting(request: Request, week_start: str, payload: dict[str, Any
|
||||
"""회의록 만들기(관리자) — 앞선 회의록 줄을 이어받거나, 처음이면 그 해 목표 표 업무 영역 + 기본 양식 줄."""
|
||||
user = _require_admin(request)
|
||||
st = _db_or_503(request)
|
||||
ws = _goal_call(store.validate_week_start, week_start)
|
||||
ws = _goal_call(store.validate_period_start, week_start)
|
||||
year = _goal_call(store.validate_goal_year, payload.get("year") or ws.year)
|
||||
created = _goal_call(st.create_meeting, week_start=ws, sections=st.goal_area_sections(year=year),
|
||||
created_by=user["email"])
|
||||
|
||||
Reference in New Issue
Block a user