d20ce1efac
- 잔여 연차 표 이름 옆 입사일 날짜 버튼(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>
147 lines
5.5 KiB
Python
147 lines
5.5 KiB
Python
"""휴가 관리 모듈 상수 및 순수 계산 헬퍼.
|
||
|
||
- 데이터 저장은 vacation_db(PostgreSQL) 전용이다(`db.py`).
|
||
운영 데이터가 JSON 과 DB 로 갈라지는 것을 막기 위해 JSON 폴백을 두지 않는다.
|
||
VACATION_DB_URL 미설정 시 라우터가 "설정 필요" 안내 페이지를 보여준다.
|
||
- 이 모듈에는 상수와 순수 계산 헬퍼(휴가일수 계산)만 둔다.
|
||
공휴일 집합은 db.py 가 vacation_holidays 에서 읽어 넘겨준다(holiday provider 분리).
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from datetime import date, timedelta
|
||
from typing import Iterable
|
||
|
||
# 휴가 종류 (한글 라벨 그대로 저장)
|
||
VACATION_TYPES: tuple[str, ...] = (
|
||
"연차",
|
||
"오전반차",
|
||
"오후반차",
|
||
"병가",
|
||
"경조",
|
||
"대체휴무",
|
||
"기타",
|
||
)
|
||
|
||
# 신청 상태 워크플로
|
||
STATUSES: tuple[str, ...] = ("작성중", "제출", "승인", "반려", "취소")
|
||
|
||
# 시작/종료일 구분
|
||
HALVES: tuple[str, ...] = ("full", "am", "pm")
|
||
HALF_LABELS: dict[str, str] = {"full": "종일", "am": "오전", "pm": "오후"}
|
||
|
||
# 수정/삭제(취소) 가능한 상태 — 본인 편집 허용
|
||
EDITABLE_STATUSES: tuple[str, ...] = ("작성중", "반려")
|
||
|
||
# 연차에서 차감하는 휴가 종류(2026-10-27) — 승인되면 그해 연차에서 빠진다. 병가·경조·대체휴무·기타는 차감하지 않는다.
|
||
# 연차는 그해(1/1~12/31) 것만 쓰고 다음 해로 넘기지 않는다(12/31 소멸 — 해마다 잔여 연차를 새로 등록).
|
||
DEDUCT_TYPES: tuple[str, ...] = ("연차", "오전반차", "오후반차")
|
||
|
||
# 이 시스템을 쓰기 시작한 해 — 그해만 잔여 연차 표에 "시스템 전 사용"(도입 전에 이미 쓴 연차) 칸(2026-10-27)
|
||
SYSTEM_START_YEAR = 2026
|
||
|
||
|
||
def add_months(d: date, n: int) -> date:
|
||
"""d 에서 n 달 뒤 같은 날(없는 날이면 그 달 말일 — 1/31 + 1달 = 2/28)."""
|
||
m = d.month - 1 + n
|
||
y, m = d.year + m // 12, m % 12 + 1
|
||
last = (date(y + (m == 12), m % 12 + 1, 1) - timedelta(days=1)).day
|
||
return date(y, m, min(d.day, last))
|
||
|
||
|
||
def legal_annual_leave(hire: date | None, year: int) -> dict:
|
||
"""근로기준법 제60조 연차 — 입사일 기준으로 생기는 날을 그해(1/1~12/31)에 모은다(연차는 12/31 소멸 규칙과 맞춤).
|
||
|
||
· 입사 1년 미만: 1개월 개근마다 1일(입사일 + 1~11개월 되는 날, 최대 11일) — 제60조 ②
|
||
· 입사일이 돌아올 때마다(근속 n년): 15일 + 최초 1년을 넘는 근속 2년마다 1일, 최대 25일 = min(25, 15 + (n−1)//2) — 제60조 ①④
|
||
출근율(1개월 개근·1년 80%)은 따지지 않는다(모두 채운 것으로 본다). 입사일이 없거나 그해 뒤면 0일.
|
||
반환 {"days", "items": [{"date", "days", "label"}], "service_years"(12/31 기준 만 근속 연수)}.
|
||
"""
|
||
out: dict = {"days": 0.0, "items": [], "service_years": 0}
|
||
if hire is None:
|
||
return out
|
||
y0, y1 = date(year, 1, 1), date(year, 12, 31)
|
||
items = []
|
||
for m in range(1, 12):
|
||
d = add_months(hire, m)
|
||
if y0 <= d <= y1:
|
||
items.append({"date": d.isoformat(), "days": 1.0, "label": f"입사 {m}개월(월 1일)"})
|
||
n = 1
|
||
while True:
|
||
d = add_months(hire, 12 * n)
|
||
if d > y1:
|
||
break
|
||
if d >= y0:
|
||
items.append({"date": d.isoformat(), "days": float(min(25, 15 + (n - 1) // 2)), "label": f"근속 {n}년"})
|
||
n += 1
|
||
out["items"] = items
|
||
out["days"] = float(sum(i["days"] for i in items))
|
||
out["service_years"] = max(0, n - 1)
|
||
return out
|
||
|
||
|
||
# 반차 성격의 휴가 종류 (단일 일자 0.5일 강제)
|
||
_HALF_DAY_TYPES: dict[str, str] = {"오전반차": "am", "오후반차": "pm"}
|
||
|
||
|
||
def _daterange(start: date, end: date) -> Iterable[date]:
|
||
cur = start
|
||
while cur <= end:
|
||
yield cur
|
||
cur += timedelta(days=1)
|
||
|
||
|
||
def is_working_day(d: date, holidays: set[str]) -> bool:
|
||
"""주말(토/일)과 공휴일(holidays: ISO 날짜 집합)을 제외하면 근무일."""
|
||
if d.weekday() >= 5: # 5=토, 6=일
|
||
return False
|
||
return d.isoformat() not in holidays
|
||
|
||
|
||
def compute_days(
|
||
*,
|
||
start_date: date,
|
||
end_date: date,
|
||
start_half: str = "full",
|
||
end_half: str = "full",
|
||
vacation_type: str = "연차",
|
||
holidays: set[str] | None = None,
|
||
) -> float:
|
||
"""휴가 일수 계산. 서버에서 항상 이 함수로 재계산한다(클라이언트 신뢰 금지).
|
||
|
||
- 주말 + 공휴일(is_red) 제외.
|
||
- 오전/오후 반차는 0.5일.
|
||
- 같은 날 + 반차면 0.5일.
|
||
- 여러 날에서 시작/종료가 반차면 시작일/종료일 각각 0.5 차감.
|
||
- 휴가 종류가 오전반차/오후반차면 단일 일자 0.5일로 강제.
|
||
"""
|
||
holidays = holidays or set()
|
||
if end_date < start_date:
|
||
return 0.0
|
||
|
||
# 반차 종류는 단일 일자 0.5
|
||
if vacation_type in _HALF_DAY_TYPES:
|
||
if is_working_day(start_date, holidays):
|
||
return 0.5
|
||
return 0.0
|
||
|
||
working = [d for d in _daterange(start_date, end_date) if is_working_day(d, holidays)]
|
||
n = len(working)
|
||
if n == 0:
|
||
return 0.0
|
||
|
||
if start_date == end_date:
|
||
return 0.5 if start_half in ("am", "pm") else 1.0
|
||
|
||
total = float(n)
|
||
if start_half in ("am", "pm") and is_working_day(start_date, holidays):
|
||
total -= 0.5
|
||
if end_half in ("am", "pm") and is_working_day(end_date, holidays):
|
||
total -= 0.5
|
||
return max(0.0, total)
|
||
|
||
|
||
def normalize_half(value: str | None) -> str:
|
||
v = (value or "full").strip().lower()
|
||
return v if v in HALVES else "full"
|