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
+67
View File
@@ -147,5 +147,72 @@ class VacationHolidayBalanceDBTests(unittest.TestCase):
self.assertEqual(st.get_balance(user_email=a, year=2031)["total_days"], 20.0)
class LegalAnnualLeaveTests(unittest.TestCase):
"""근로기준법 제60조 — 입사일 기준으로 생기는 연차를 그해에 모은다(2026-10-27, DB 없음)."""
def test_rules(self):
from datetime import date
from app.modules.vacation.store import add_months, legal_annual_leave as L
self.assertEqual(add_months(date(2026, 1, 31), 1), date(2026, 2, 28))
self.assertEqual(add_months(date(2024, 2, 29), 12), date(2025, 2, 28))
# 입사 1년 미만 = 1개월마다 1일, 입사일이 돌아오면 15일 — 2025-03-01 입사
self.assertEqual(L(date(2025, 3, 1), 2025)["days"], 9.0) # 4/1 ~ 12/1
r = L(date(2025, 3, 1), 2026)
self.assertEqual((r["days"], r["service_years"]), (17.0, 1)) # 1/1·2/1(월 1일) + 3/1 근속 1년 15일
self.assertEqual([i["date"] for i in r["items"]], ["2026-01-01", "2026-02-01", "2026-03-01"])
self.assertEqual(L(date(2025, 3, 1), 2027)["days"], 15.0) # 근속 2년 = 15일
# 3년 이상 = 최초 1년을 넘는 근속 2년마다 1일, 최대 25일
self.assertEqual(L(date(2023, 5, 10), 2026)["days"], 16.0) # 근속 3년
self.assertEqual(L(date(2020, 3, 2), 2026)["days"], 17.0) # 근속 6년 = 15 + 2
self.assertEqual(L(date(2001, 1, 1), 2026)["days"], 25.0) # 근속 25년 → 한도 25
self.assertEqual(L(date(2027, 1, 2), 2026)["days"], 0.0) # 아직 입사 전
self.assertEqual(L(None, 2026)["days"], 0.0)
@unittest.skipUnless(ENABLED, "VACATION_TEST_DB_URL(localhost) 미설정")
class VacationHireDBTests(unittest.TestCase):
"""002 — 입사일·시스템 전 사용·연차 비우면 법정(실제 PostgreSQL, 002 적용 DB)."""
@classmethod
def setUpClass(cls):
from app.modules.vacation.db import VacationDBStore
cls.st = VacationDBStore(DSN)
@classmethod
def tearDownClass(cls):
cls.st.close()
def test_hire_legal_manual_prior(self):
st = self.st
self.assertTrue(st.hire_ready())
a, b = f"h-{uuid.uuid4().hex[:6]}@test.local", f"h-{uuid.uuid4().hex[:6]}@test.local"
n = st.save_balances(year=2026, by="admin@test.local", rows=[
{"user_email": a, "total_days": None, "prior_used": 3.5, "memo": "", "hire_date": "2025-03-01"},
{"user_email": b, "total_days": 20, "prior_used": None, "memo": "직접", "hire_date": "2020-03-02"},
])
self.assertEqual(n, 2)
self.assertEqual(st.hire_dates()[a], "2025-03-01")
sa = st.balance_summary(user_email=a, year=2026)
self.assertEqual((sa["total_days"], sa["manual_total"], sa["legal_days"], sa["prior_used"], sa["remaining_days"]),
(17.0, None, 17.0, 3.5, 13.5)) # 법정 17 − 시스템 전 3.5
sb = st.balance_summary(user_email=b, year=2026)
self.assertEqual((sb["total_days"], sb["legal_days"], sb["remaining_days"], sb["service_years"]), (20.0, 17.0, 20.0, 6))
# 2027 — 아무것도 등록 안 해도 입사일로 법정 연차(이월 없음)
self.assertEqual(st.balance_summary(user_email=a, year=2027)["total_days"], 15.0)
# 입사일 지우기("") · 키 없으면 그대로 · 틀린 입사일은 전부 저장 안 함
st.save_balances(year=2026, rows=[{"user_email": a, "total_days": None, "prior_used": 0, "memo": ""}])
self.assertEqual(st.hire_dates()[a], "2025-03-01")
with self.assertRaises(ValueError):
st.save_balances(year=2026, rows=[{"user_email": a, "total_days": None, "hire_date": ""},
{"user_email": b, "total_days": None, "hire_date": "2020-13-01"}])
self.assertEqual(st.hire_dates()[a], "2025-03-01")
st.save_balances(year=2026, rows=[{"user_email": a, "total_days": None, "hire_date": ""}])
self.assertNotIn(a, st.hire_dates())
self.assertEqual(st.balance_summary(user_email=a, year=2026)["total_days"], 0.0)
if __name__ == "__main__":
unittest.main()