fix(project): 목표·주간 회의록 저장 손실·지난주 연결·실적 미확인 수정 (점검 9건)

- 칸별 자동 저장 createFieldSaver: 같은 칸 요청 직렬화, 보낸 값만 saved,
  늦은 응답이 새 초안을 덮지 않음, 실패 시 초안·dirty 유지(빨간 테두리),
  localStorage 초안 백업·되살리기, 페이지 떠남 keepalive + 이탈 경고
- 목표 표: 저장 실패면 영역·줄·병합 작업과 표 교체 중단, 받는 사이 입력 보호
- 회의록: 금주 목표 저장 뒤 새로고침 대신 숫자 칸만 다시(차례 번호로 옛 응답 버림),
  이번주 실적 %는 서버 확정 목표로 즉시 재계산
- 지난주 = 정확히 7일 전 주의 같은 연결키 줄(line_key, 마이그레이션 018),
  역순 생성·이름 변경·삭제 후 재생성에도 연결, 이름 추정 연결 없음
- 실적 조회 장애를 0원 대신 미확인으로(목록·매출·부분 실패 구분)
- 구역·항목 ⋮ 메뉴 버튼(키보드·터치), 메뉴 키보드 탐색·포커스 복귀
- 매출 갱신 실패·일부 실패 안내 + 재시도, 서버 기록 갱신 시각, 권한 없으면 호출 안 함
- 테스트: Python 통합(역순 생성·실적 장애), 018 백필, jsdom UI 106건

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-01 21:14:10 +09:00
parent 21981eb946
commit e1006c63de
20 changed files with 2334 additions and 393 deletions
+143 -47
View File
@@ -2838,78 +2838,157 @@ def _perf_sales(request: Request) -> Any:
return getattr(request.app.state, "performance_store", None)
def _perf_markets(perf: Any) -> list[dict[str, Any]]:
if perf is None:
return []
try:
return [m for m in perf.list_marketplaces() if m.get("enabled")]
except Exception: # noqa: BLE001 — 실적 DB 장애가 회의록을 막지 않게
logger.warning("performance marketplaces unavailable for meeting", exc_info=True)
return []
class _MeetingPerf:
"""회의록이 읽는 실적(읽기 전용) — 값과 상태를 따로 둔다. 조회 장애를 0 원으로 바꾸지 않는다.
state: ``off``(실적 모듈 미연결) · ``error``(쇼핑몰 목록 조회 실패) · ``empty``(매출 집계 쇼핑몰 없음) · ``ok``.
``sum``/``total`` 은 알 수 없으면 None(목록 장애·매출 조회 실패), 정상 조회 결과 0 건이면 0.
매출 조회가 실패할 때마다 ``failures`` 가 늘어난다(부분 실패 — 머리 숫자마다 따로 미확인)."""
def __init__(self, perf: Any) -> None:
self.perf = perf
self.markets: list[dict[str, Any]] = []
self.failures = 0
if perf is None:
self.state = "off"
else:
try:
self.markets = [m for m in perf.list_marketplaces() if m.get("enabled")]
self.state = "ok"
except Exception: # noqa: BLE001 — 실적 DB 장애가 회의록을 막지 않게
logger.warning("performance marketplaces unavailable for meeting", exc_info=True)
self.state = "error"
self.names = {m["code"]: m["name"] for m in self.markets}
self.sales_codes = [m["code"] for m in self.markets if m.get("include_in_sales")]
if self.state == "ok" and not self.sales_codes:
self.state = "empty"
@property
def readable(self) -> bool:
"""쇼핑몰 목록을 읽었는가(ok·empty) — 연결 쇼핑몰이 "사용 중이 아님"을 판단할 수 있는가."""
return self.state in ("ok", "empty")
def sum(self, start: date, end: date, codes: list[str]) -> dict[str, int] | None:
"""기간 쇼핑몰별 매출 합(원, 취소·반품 차감 = 대시보드 총매출과 같은 값). 알 수 없으면 None."""
if not self.readable:
return None
if not codes or end < start:
return {}
try:
out: dict[str, int] = {}
for (_, code), amount in self.perf.daily_amounts(start, end, codes).items():
out[code] = out.get(code, 0) + int(amount)
return out
except Exception: # noqa: BLE001
self.failures += 1
logger.warning("performance sales unavailable for meeting", exc_info=True)
return None
def total(self, start: date, end: date) -> int | None:
"""매출 집계 쇼핑몰 합계. 매출 집계 쇼핑몰이 없으면(empty) None — 0 원으로 보이지 않게."""
if self.state != "ok":
return None
r = self.sum(start, end, self.sales_codes)
return None if r is None else sum(r.values())
def freshness(self) -> dict[str, Any] | None:
"""매출 집계 쇼핑몰별 마지막 갱신 성공 시각(실적 모듈 perf_connection_status — 서버가 기록한 값만).
oldest = 가장 오래된 쇼핑몰 기준(자료가 적어도 이 시각까지는 갱신됨), never = 한 번도 성공 못 한 쇼핑몰."""
if self.state != "ok" or not hasattr(self.perf, "statuses"):
return None
try:
stats = self.perf.statuses() or {}
except Exception: # noqa: BLE001
logger.warning("performance statuses unavailable for meeting", exc_info=True)
return None
shops, never = [], []
for code in self.sales_codes:
t = (stats.get(code) or {}).get("last_success_sync_at")
if t:
shops.append({"name": self.names.get(code, code), "at": str(t)})
else:
never.append(self.names.get(code, code))
oldest = min((s["at"] for s in shops), default="")
return {"shops": shops, "never": never, "oldest": oldest}
def _perf_sum(perf: Any, start: date, end: date, codes: list[str]) -> dict[str, int] | None:
"""기간 쇼핑몰별 매출 합(원, 취소·반품 차감 = 대시보드 총매출과 같은 값). 실적 모듈이 없으면 None."""
if perf is None or not codes or end < start:
return {} if perf is not None else None
def _kst_short(iso: str) -> str:
"""'2026-10-01T14:20:00+09:00' → '10/01 14:20'(서버가 준 시각을 한국시간으로)."""
if not iso:
return ""
try:
out: dict[str, int] = {}
for (_, code), amount in perf.daily_amounts(start, end, codes).items():
out[code] = out.get(code, 0) + int(amount)
return out
except Exception: # noqa: BLE001
logger.warning("performance sales unavailable for meeting", exc_info=True)
return None
from datetime import datetime # noqa: WPS433
d = datetime.fromisoformat(str(iso))
if d.tzinfo is not None:
d = d.astimezone(KST)
return d.strftime("%m/%d %H:%M")
except ValueError:
return str(iso)[:16]
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% 로 보이지 않게, 그 값에 기대는 달성률·필요 매출도 계산하지 않는다)."""
today = today_kst()
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 = _perf_sales(request)
markets = _perf_markets(perf)
names = {m["code"]: m["name"] for m in markets}
sales_codes = [m["code"] for m in markets if m.get("include_in_sales")]
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)
unknown: list[str] = []
def total(a: date, b: date) -> int | None:
r = _perf_sum(perf, a, min(b, today), sales_codes)
return None if r is None else sum(r.values())
def total(key: str, a: date, b: date) -> int | None:
v = perf.total(a, min(b, today))
if v is None and perf.state in ("error", "ok"):
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(first, mtd_end) if mtd_end >= first else 0
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 # 바로 앞 주 회의록이어야 "전주 목표"
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
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,
"prev_result": total(prev_start, prev_end) if prev_start <= today else None,
"week_result": total(week, week_end) if week <= today else None,
"perf": perf is not None,
"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 != "off",
"perf_state": perf.state,
"unknown": unknown,
"fresh_oldest": _kst_short(fresh["oldest"]) if fresh else "",
"fresh_tip": ("매출 자료(실적 모듈) 쇼핑몰별 마지막 갱신 성공 — " +
" · ".join(f"{s['name']} {_kst_short(s['at'])}" for s in fresh["shops"]) +
(f" · 갱신 성공 기록 없음: {', '.join(fresh['never'])}" if fresh["never"] else "")) if fresh else "",
}
if meeting:
# 줄마다 전주 결과 — 쇼핑몰 연결이면 그 주 실적(자동), 아니면 직접 입력한 결과
all_codes = [m["code"] for m in markets]
# 줄마다 지난주 결과 — 쇼핑몰 연결이면 그 주 실적(자동), 아니면 직접 입력한 결과(지난주 줄에 저장)
all_codes = [m["code"] for m in perf.markets]
by_week: dict[str, dict[str, int] | None] = {}
def week_sales(ws: str) -> dict[str, int] | None:
"""그 주(월~일, 오늘까지) 쇼핑몰별 실적 — 아직 시작 안 한 주는 None."""
"""그 주(월~일, 오늘까지) 쇼핑몰별 실적 — 조회 실패면 None(시작 전 주는 부르지 않는다)."""
if ws not in by_week:
a = date.fromisoformat(ws)
by_week[ws] = _perf_sum(perf, a, min(a + timedelta(days=6), today), all_codes) if a <= today else None
by_week[ws] = perf.sum(a, min(a + timedelta(days=6), today), all_codes)
return by_week[ws]
for it in meeting["items"]:
@@ -2921,21 +3000,32 @@ def _meeting_view(request: Request, st: Any, *, year: int, month: int, week: dat
a = date.fromisoformat(prev["week_start"])
prev["period"] = f"{a.month}/{a.day}~{(a + timedelta(days=6)).month}/{(a + timedelta(days=6)).day}"
prev["not_started"] = bool(code) and a > today
# 쇼핑몰 목록을 못 읽었으면 연결 쇼핑몰이 사용 중인지 알 수 없다 → 결과 미확인(직접 입력 칸·0 으로 바꾸지 않음)
prev["auto_error"] = bool(code) and not prev["not_started"] and perf.state == "error"
# 실적 모듈에서 사용 중이 아닌 쇼핑몰(설정에서 사용 OFF·없는 코드)은 늘 0 이라 자동으로 보지 않고 직접 입력
prev["market_off"] = bool(code) and code not in names
if code and perf is not None and not prev["not_started"] and not prev["market_off"]:
prev["market_off"] = bool(code) and perf.state != "error" and code not in names
if code and perf.readable and not prev["not_started"] and not prev["market_off"]:
got = week_sales(prev["week_start"])
auto = None if got is None else got.get(code, 0)
if got is None:
prev["auto_error"] = True
else:
auto = got.get(code, 0)
prev["auto_result"] = auto
prev["result"] = auto if auto is not None else prev.get("result_amount")
prev["result"] = auto if auto is not None else (None if prev["auto_error"] else prev.get("result_amount"))
prev["market_name"] = names.get(code, code)
for it in meeting["items"]:
code = it["marketplace_code"]
it["market_name"] = names.get(code, code) if code else ""
it["market_off"] = bool(code) and code not in names
# 이번 주 진행 중 실적(쇼핑몰 연결 줄) — 목표 금액 칸 아래에 "이번주 실적"
got = week_sales(meeting["week_start"]) if code and perf is not None and not it["market_off"] else None
it["week_auto"] = None if got is None else got.get(code, 0)
it["market_off"] = bool(code) and perf.state != "error" and code not in names
it["market_unknown"] = bool(code) and perf.state == "error"
# 이번 주 진행 중 실적(쇼핑몰 연결 줄) — 정량 목표 칸 아래에 "이번주 실적"
it["week_auto"], it["week_error"] = None, False
if code and week <= today and not it["market_off"]:
got = week_sales(meeting["week_start"]) if perf.readable else None
if got is None:
it["week_error"] = perf.state != "off"
else:
it["week_auto"] = got.get(code, 0)
p = it.get("prev")
it["rate"] = (round(p["result"] / p["target_amount"] * 100, 1)
if p and p.get("result") is not None and p.get("target_amount") else None)
@@ -2948,7 +3038,8 @@ def _meeting_view(request: Request, st: Any, *, year: int, month: int, week: dat
meeting["sections"] = sections
prev_items = [it["prev"] for it in meeting["items"] if it.get("prev")]
head["prev_items_target"] = sum(p["target_amount"] or 0 for p in prev_items) if prev_items else None
return {"meeting": meeting, "head": head, "markets": [{"code": m["code"], "name": m["name"]} for m in markets]}
return {"meeting": meeting, "head": head,
"markets": [{"code": m["code"], "name": m["name"]} for m in perf.markets]}
def _month_plan(st: Any, year: int, month: int) -> list[dict[str, Any]] | None:
@@ -3014,7 +3105,7 @@ def _parse_attendees(text: str, members: list[dict[str, str]]) -> list[dict[str,
def goal_meeting_page(request: Request, year: int, month: int, week: str | None = None) -> HTMLResponse:
"""주간 회의록 — 그 달과 겹치는 주(월~일) 탭, 주마다 회의록 하나. 입력은 관리자만(목표 표와 같음)."""
from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433
from app.store import has_module, is_admin # noqa: WPS433
user = _require_user(request)
st = _store(request)
@@ -3091,6 +3182,8 @@ def goal_meeting_page(request: Request, year: int, month: int, week: str | None
# 주차를 열면 다시 받을 매출 기간(실적 모듈 매출 업데이트) — 지난주 월요일 ~ 이번 주 일요일(오늘까지)
"sync_from": (sel - timedelta(days=7)).isoformat() if sel - timedelta(days=7) <= today else "",
"sync_to": min(sel + timedelta(days=6), today).isoformat(),
# 쇼핑몰 매출 갱신(실적 모듈 POST /performance/api/sync)은 실적 모듈 권한자만 — 없으면 화면이 부르지 않는다
"can_sync": has_module(user, "performance"),
"meeting_status": store.MEETING_STATUS,
"meet_members": members,
"month_plan": _month_plan(st, year, month),
@@ -3131,7 +3224,10 @@ def api_update_meeting(request: Request, week_start: str, payload: dict[str, Any
ws = _goal_call(store.validate_week_start, week_start)
fields = {k: payload[k] for k in ("week_target", "attendees", "notes") if k in payload}
_goal_call(st.update_meeting, week_start=ws, fields=fields, updated_by=user["email"])
return JSONResponse({"ok": True})
out: dict[str, Any] = {"ok": True}
if "week_target" in fields: # 화면이 서버 확정값(원 정수)으로 칸을 맞춘다
out["week_target"] = store.validate_meeting_amount(fields["week_target"])
return JSONResponse(out)
@router.delete("/api/goals/meetings/{week_start}")