feat(vacation): 입사일(이름 옆 날짜) · 근로기준법 연차 자동 · 2026 시스템 전 사용 연차

- 잔여 연차 표 이름 옆 입사일 날짜 버튼(ErpDatePop.enhance, « » 1년씩) → vacation_employees(마이그레이션 002)
- 법정 연차 = 근로기준법 제60조 입사일 기준(1년 미만 월 1일·최대 11, 근속 n년 min(25, 15+(n-1)//2)), 그해 생기는 날을 모음
  (store.legal_annual_leave, 화면도 같은 계산으로 바로 표시) — 연차 칸을 비우면 법정, 숫자면 직접 입력(total_days NULL 허용)
- 2026(도입 해)만 "시스템 전 사용"(prior_used) 칸 — 잔여 = 총 − 시스템 전 사용 − 승인된 연차·반차(db.balance_summary 한 곳)
- 테스트: 법정 연차 규칙, 실제 PG(입사일·법정·직접·시스템 전·검증), 실제 앱 저장, 브라우저(입사일 버튼·바로 계산·전송)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-26 15:53:45 +09:00
parent f0391e88fa
commit d20ce1efac
18 changed files with 592 additions and 97 deletions
+30 -19
View File
@@ -26,7 +26,7 @@ from fastapi.responses import (
from app.timezone import now_kst, today_kst
from .store import HALF_LABELS, HALVES, VACATION_TYPES
from .store import HALF_LABELS, HALVES, SYSTEM_START_YEAR, VACATION_TYPES
router = APIRouter(prefix="/vacation", tags=["vacation"])
@@ -486,7 +486,8 @@ def settings_page(request: Request) -> RedirectResponse:
@router.post("/options/balances")
async def balances_save(request: Request) -> RedirectResponse:
"""잔여 연차 한꺼번에(옵션 — ERP 관리자·휴가 승인자·승인 통보자) — 참여자 줄마다 email·total·memo. 연차 칸을 비운 줄은 그대로 둔다(새로 만들지 않음)."""
"""잔여 연차 한꺼번에(옵션 — ERP 관리자·휴가 승인자·승인 통보자) — 참여자 줄마다 email·hire·total·prior·memo(2026-10-27).
hire = 입사일(빈 칸 = 지움), total = 연차 직접 입력(빈 칸 = 입사일 기준 법정 연차), prior = 시스템 전에 그해 쓴 연차(빈 칸 = 0)."""
from urllib.parse import urlencode # noqa: WPS433
user = _require_user(request)
@@ -502,22 +503,27 @@ async def balances_save(request: Request) -> RedirectResponse:
raise HTTPException(status_code=400, detail="연도가 올바르지 않습니다.")
if not 2000 <= year <= 2100:
raise HTTPException(status_code=400, detail="연도가 올바르지 않습니다.")
emails, totals, memos = form.getlist("email"), form.getlist("total"), form.getlist("memo")
if not (len(emails) == len(totals) == len(memos)):
emails, memos = form.getlist("email"), form.getlist("memo")
totals, priors, hires = form.getlist("total"), form.getlist("prior"), form.getlist("hire")
if not (len(emails) == len(totals) == len(memos) == len(priors) == len(hires)):
raise HTTPException(status_code=400, detail="잔여 연차 칸이 맞지 않습니다.")
rows = []
for email, total, memo in zip(emails, totals, memos):
total = str(total).strip()
if not total:
continue
def num(v: Any, label: str, email: str) -> float | None:
v = str(v).strip()
if not v:
return None
try:
rows.append({"user_email": email, "total_days": float(total), "memo": memo})
return float(v)
except ValueError:
raise HTTPException(status_code=400, detail=f"연차 일수가 숫자가 아닙니다: {email}")
raise HTTPException(status_code=400, detail=f"{label}이(가) 숫자가 아닙니다: {email}")
rows = [{"user_email": email, "total_days": num(total, "연차 일수", email), "prior_used": num(prior, "시스템 전 사용", email),
"memo": memo, "hire_date": str(hire).strip()}
for email, total, prior, memo, hire in zip(emails, totals, priors, memos, hires)]
from starlette.concurrency import run_in_threadpool # noqa: WPS433 — 폼 배열을 읽으려 async, DB 는 동기라 스레드에서
try:
n = await run_in_threadpool(store.save_balances, year=year, rows=rows)
n = await run_in_threadpool(store.save_balances, year=year, rows=rows, by=user["email"])
except ValueError as exc:
raise HTTPException(status_code=400, detail=str(exc))
return RedirectResponse(url="/vacation/options?" + urlencode({"year": year, "msg": f"{year}년 잔여 연차 {n}명을 저장했습니다."})
@@ -526,22 +532,25 @@ async def balances_save(request: Request) -> RedirectResponse:
def _balance_rows(store: Any, year: int) -> list[dict[str, Any]]:
"""옵션 잔여 연차 표 — 참여자(휴가 모듈 사용자) 전원 + 예전에 등록됐지만 지금 권한이 없는 사람.
줄마다 그해 연차·사용(승인된 연차·반차)·잔여·메모, 아직 없으면 작년 연차를 참고로."""
줄마다 입사일·근속·법정 연차(근로기준법, 입사일 기준)·연차(직접 입력)·시스템 전 사용·사용·잔여·메모(db.balance_summary 한 곳)."""
users = _vacation_users()
this_year = {b["user_email"]: b for b in store.list_balances(year=year)}
last_year = {b["user_email"]: b for b in store.list_balances(year=year - 1)}
hires = store.hire_dates()
rows = []
people = [(u["email"].lower(), u.get("name") or u["email"].split("@")[0], u.get("picture") or "", True) for u in users]
known = {p[0] for p in people}
people += [(e, e.split("@")[0], "", False) for e in sorted(this_year) if e not in known]
for email, name, picture, active in people:
bal = this_year.get(email)
used = store.used_days(user_email=email, year=year)
total = float(bal["total_days"]) if bal else None
s = store.balance_summary(user_email=email, year=year, hire_date=hires.get(email))
last = last_year.get(email)
rows.append({"email": email, "name": name, "picture": picture, "active": active,
"total": total, "used": used, "remaining": round(total - used, 2) if total is not None else None,
"memo": (bal or {}).get("memo") or "",
"last_total": float(last_year[email]["total_days"]) if email in last_year else None})
"hire_date": s["hire_date"], "service_years": s["service_years"],
"legal": s["legal_days"], "legal_tip": ", ".join(f"{i['date'][5:]} {i['label']} {i['days']:g}일" for i in s["legal_items"]),
"total": s["manual_total"], "effective_total": s["total_days"], "prior": s["prior_used"],
"used": s["erp_used"], "remaining": s["remaining_days"] if (s["manual_total"] is not None or s["hire_date"]) else None,
"memo": s["memo"],
"last_total": last["total_days"] if last and last.get("total_days") is not None else None})
return rows
@@ -691,6 +700,8 @@ def options_page(request: Request) -> HTMLResponse:
"gmail": _gmail_state(request, user),
"msg": request.query_params.get("msg", ""),
"bal_year": bal_year,
"bal_prior_year": bal_year == SYSTEM_START_YEAR, # 시스템 도입 해만 "시스템 전 사용" 칸
"hire_ready": store.hire_ready() if can_edit else False,
"can_edit": can_edit,
"bal_rows": _balance_rows(store, bal_year) if can_edit else [],
},