feat(vacation): 연차 12/31 소멸 삭제 — 입사일 기준, 연차마다 쓸 수 있는 기한

- store.leave_grants/leave_period/leave_status: 1년 미만 월 1일 = 입사일부터 1년까지, 근속 n년 연차 = 생긴 날부터 1년까지(근로기준법 제60조)
- 승인된 연차·반차를 날짜별(usage_units = compute_days 규칙)로 나눠 그날 쓸 수 있는 연차 중 먼저 소멸하는 것부터 차감, 생기기 전이면 당겨 씀
- 화면: 지금 연차 기간 · 생기는 연차(오늘까지 +앞으로) · 사용 · 오늘 쓸 수 있는 잔여 · 먼저 소멸(날짜·일수), 해 이동 없음, 달력 위 내 연차도 같은 값
- 직접 입력 = 지금 연차 기간이 시작한 해 줄(override_year), 시스템 전 사용 = 2026 줄(도입일에 쓴 것으로)
- 테스트: 규칙(10/12 입사 사례·먼저 소멸·당겨 씀·시스템 전·입사일 없음), 실제 PG, 실제 앱, 브라우저

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-26 16:27:50 +09:00
parent 197c3c13a3
commit 4b2defac3a
16 changed files with 500 additions and 311 deletions
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/vacation.css?v=20261027d" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/vacation.css?v=20261027e" />{% endblock %}
{% block content %}
<section class="vac">
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/vacation.css?v=20261027d" />
{% block head_extra %}<link rel="stylesheet" href="/static/vacation.css?v=20261027e" />
{#- 날짜 칸 = 프로젝트와 같은 아사나식 날짜 팝업(2026-10-27, erp-datepop) -#}
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
<link rel="stylesheet" href="/static/erp-datepop.css?v=20261027a" />{% endblock %}
@@ -73,4 +73,4 @@
{% block scripts %}<script type="application/json" id="vac-holidays">{{ holidays | tojson }}</script>
<script src="/static/erp-datepop.js?v=20261027b" defer></script>
<script src="/static/vacation.js?v=20261027b" defer></script>{% endblock %}
<script src="/static/vacation.js?v=20261027c" defer></script>{% endblock %}
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/vacation.css?v=20261027d" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/vacation.css?v=20261027e" />{% endblock %}
{% block content %}
<section class="vac">
@@ -19,13 +19,15 @@
<a class="erp-btn erp-btn-outline" href="/vacation/options">옵션</a>
</div>
<div class="vac-balance">
<span class="vac-bal-item">총 <strong>{{ balance.total_days }}</strong></span>
{#- 내 연차 — 입사일 기준(2026-10-27, 12/31 소멸 없음): 이번 연차 기간에 생기는 연차·쓴 날·지금 쓸 수 있는 잔여·먼저 소멸할 잔여 -#}
{% set gt = '%g' % balance.granted_so_far ~ ((' (+%g 예정)' % balance.upcoming) if balance.upcoming else '') %}
<span class="vac-bal-item" title="이번 연차 기간 {{ balance.period_start }} ~ {{ balance.period_end }}에 생기는 연차(오늘까지 생긴 것 + 앞으로 생길 것)">발생 <strong>{{ gt }}</strong></span>
<span class="vac-bal-sep">·</span>
<span class="vac-bal-item">사용 <strong>{{ balance.used_days }}</strong></span>
<span class="vac-bal-item" title="승인된 연차·오전반차·오후반차(병가·경조·대체휴무·기타는 빼지 않음)">사용 <strong>{{ '%g' % balance.used_days }}</strong></span>
<span class="vac-bal-sep">·</span>
<span class="vac-bal-item vac-bal-remain">잔여 <strong>{{ balance.remaining_days }}</strong></span>
{#- 연차는 그해 것만 — 12/31 소멸, 다음 해로 넘어가지 않음(2026-10-27). 사용 = 승인된 연차·반차 -#}
<span class="erp-muted vac-bal-year" title="사용 = 승인된 연차·오전반차·오후반차(병가·경조·대체휴무·기타는 빼지 않음)">{{ year }}년 · {{ year }}.12.31 소멸</span>
<span class="vac-bal-item vac-bal-remain{% if balance.remaining_days < 0 %} is-minus{% endif %}" title="오늘 쓸 수 있는 연차">잔여 <strong>{{ '%g' % balance.remaining_days }}</strong></span>
{% if balance.expiring %}<span class="erp-muted vac-bal-year">{{ balance.expiring.date | replace('-', '.') }} 소멸 {{ '%g' % balance.expiring.days }}일</span>
{% elif not balance.has_hire and balance.manual_total is none %}<span class="erp-muted vac-bal-year">입사일 미등록(옵션)</span>{% endif %}
</div>
</div>
@@ -2,7 +2,7 @@
{#- 휴가 옵션(2026-10-27) — 승인자·승인 통보자·잔여 연차(수정 = ERP 관리자·승인자·통보자, 나머지는 보기만) + 내 Gmail 연결(누구나).
메일: 제출 = 승인자·통보자, 승인·반려 = 승인자·통보자·신청자. 보내는 사람 = 처리한 사람 본인 Gmail(없으면 회사 메일). -#}
{% block head_extra %}<link rel="stylesheet" href="/static/vacation.css?v=20261027d" />
{% block head_extra %}<link rel="stylesheet" href="/static/vacation.css?v=20261027e" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
<link rel="stylesheet" href="/static/erp-datepop.css?v=20261027a" />{% endblock %}
@@ -63,27 +63,24 @@
{#- 잔여 연차(2026-10-27, 설정에서 옮김) — 참여자(휴가 모듈 사용자) 전원을 미리 보여 주고 줄마다 연차 입력. 관리자·승인자·통보자만 보임·저장. -#}
<form method="post" action="/vacation/options/balances" class="erp-card vac-opt-card vac-opt-balcard" id="balances">
<div class="vac-card-head vac-bal-head">
<h2>잔여 연차 <span class="erp-muted vac-opt-count">{{ bal_year }}년 · 참여자 {{ bal_rows | selectattr('active') | list | length }}명</span></h2>
<span class="vac-bal-years">
<a class="erp-btn erp-btn-outline erp-btn-sm" href="/vacation/options?year={{ bal_year - 1 }}#balances">‹ {{ bal_year - 1 }}</a>
<a class="erp-btn erp-btn-outline erp-btn-sm" href="/vacation/options?year={{ bal_year + 1 }}#balances">{{ bal_year + 1 }} ›</a>
</span>
<h2>잔여 연차 <span class="erp-muted vac-opt-count">{{ bal_today | replace('-', '.') }} 기준 · 참여자 {{ bal_rows | selectattr('active') | list | length }}명</span></h2>
</div>
<p class="erp-muted vac-opt-hint">이름 옆 <b>입사일</b>을 고르면 <b>근로기준법 제60조</b>대로 {{ bal_year }}년에 생기는 연차를 계산합니다
(입사 1년 미만 = 1개월마다 1일·최대 11일, 입사일이 돌아올 때마다 15일 + 최초 1년을 넘는 근속 2년마다 1일·최대 25일, 출근율은 모두 채운 것으로 봄).
<b>연차</b> 칸을 비우면 법정 연차를 쓰고, 숫자를 넣으면 그 값을 씁니다. 휴가가 <b>승인되면</b> 차감됩니다(연차·오전반차·오후반차 — 병가·경조·대체휴무·기타는 차감 안 함).
{{ bal_year }}년 연차는 <b>{{ bal_year }}.12.31 에 소멸</b>하고 다음 해로 넘어가지 않습니다.
{% if bal_prior_year %}<b>시스템 전 사용</b> = 이 시스템을 쓰기 전에 {{ bal_year }}년에 이미 쓴 연차(잔여에서 뺍니다).{% endif %}</p>
<p class="erp-muted vac-opt-hint">연차는 사람마다 <b>입사일 기준</b>입니다(근로기준법 제60조 — 출근율은 모두 채운 것으로 봄).
입사 1년 미만은 입사일 + 1~11개월마다 1일씩 생기고 <b>입사일부터 1년</b>까지, 입사일이 돌아올 때마다 15일 + 최초 1년을 넘는 근속 2년마다 1일(최대 25일)이
생겨 <b>그날부터 1년</b>까지 씁니다(12/31 에 없어지지 않음). 휴가가 <b>승인되면</b> 그날 쓸 수 있는 연차 중 <b>먼저 소멸하는 것부터</b> 뺍니다
(연차·오전반차·오후반차 — 병가·경조·대체휴무·기타는 안 뺌, 생기기 전에 쓰면 다음 연차를 당겨 씀).
<b>직접 입력</b> = 이번 연차 기간 연차를 법정 대신 그 값으로(비우면 법정).
{% if bal_prior_col %}<b>시스템 전 사용</b> = 이 시스템을 쓰기 전({{ system_start_year }}년)에 이미 쓴 연차.{% endif %}</p>
{% if not hire_ready %}<p class="vac-opt-msg is-warn" role="alert">입사일·시스템 전 사용 칸은 <code>scripts/sql/vacation_db_002_hire_prior.sql</code> 적용 뒤 저장됩니다(지금은 연차 직접 입력만).</p>{% endif %}
<input type="hidden" name="year" value="{{ bal_year }}" />
<div class="erp-table-wrap">
<table class="erp-table vac-bal-table" data-year="{{ bal_year }}">
<thead><tr><th>참여자 · 입사일</th><th>근속</th><th title="입사일 기준 근로기준법 제60조">법정 연차</th><th>연차</th>
{% if bal_prior_year %}<th title="이 시스템을 쓰기 전에 그해 이미 쓴 연차">시스템 전 사용</th>{% endif %}
<th title="ERP 에서 승인된 연차·반차">사용</th><th>잔여</th><th>메모</th></tr></thead>
<table class="erp-table vac-bal-table" data-today="{{ bal_today }}">
<thead><tr><th>참여자 · 입사일</th><th>근속</th><th>이번 연차 기간</th>
<th title="이번 연차 기간에 생기는 법정 연차 — 오늘까지 생긴 것 (+ 앞으로 생길 것)">생기는 연차</th><th title="비우면 법정 연차">직접 입력</th>
{% if bal_prior_col %}<th title="이 시스템을 쓰기 전에 이미 쓴 연차">시스템 전 사용</th>{% endif %}
<th title="이번 연차 기간에 승인된 연차·반차">사용</th><th title="오늘 쓸 수 있는 연차">잔여</th><th>먼저 소멸</th><th>메모</th></tr></thead>
<tbody>
{% for b in bal_rows %}
<tr class="vac-bal-row{{ '' if b.active else ' is-inactive' }}" data-used="{{ '%g' % b.used }}">
<tr class="vac-bal-row{{ '' if b.active else ' is-inactive' }}">
<td>
<span class="vac-bal-person">
{% if b.picture %}<img class="vac-opt-face" src="{{ b.picture }}" alt="" referrerpolicy="no-referrer" />
@@ -92,33 +89,34 @@
<span class="vac-opt-name">{{ b.name }}</span>
<span class="erp-muted vac-opt-mail">{{ b.email }}{% if not b.active %} · 휴가 권한 없음{% endif %}</span>
</span>
{#- 입사일 — 이름 옆 날짜 버튼(erp-datepop, 숨긴 input 이 값) -#}
{#- 002 전이면 숨김 칸만(서버가 무시) — disabled 는 폼에서 빠져 칸 수가 어긋나므로 쓰지 않는다 -#}
{#- 입사일 — 이름 옆 날짜 버튼(erp-datepop, 숨긴 input 이 값). 002 전이면 숨김 칸만(서버가 무시) -#}
<input class="vac-hire-input" type="{{ 'date' if hire_ready else 'hidden' }}" name="hire" value="{{ b.hire_date }}" aria-label="{{ b.name }} 입사일" />
</span>
<input type="hidden" name="email" value="{{ b.email }}" />
</td>
<td class="vac-bal-num vac-bal-years-cell">{% if b.hire_date %}{{ b.service_years }}년{% else %}—{% endif %}</td>
<td class="vac-bal-num vac-bal-legal"{% if b.legal_tip %} title="{{ b.legal_tip }}"{% endif %}>{{ '%g' % b.legal if b.legal is not none else '—' }}</td>
<td class="vac-bal-period">{% if b.period_start %}{{ b.period_start[2:] | replace('-', '.') }} ~ {{ b.period_end[2:] | replace('-', '.') }}{% else %}—{% endif %}</td>
<td class="vac-bal-num vac-bal-legal"{% if b.grants_tip %} title="{{ b.grants_tip }}"{% endif %}>{% if b.period_start %}{{ '%g' % b.granted_so_far }}{% if b.upcoming %} <small>(+{{ '%g' % b.upcoming }})</small>{% endif %}{% else %}—{% endif %}</td>
<td><input class="erp-input vac-bal-input" type="number" name="total" step="0.5" min="0" max="365"
value="{{ '%g' % b.total if b.total is not none else '' }}"
placeholder="{{ ('%g' % b.legal) if b.legal is not none else (('%g' % b.last_total) if b.last_total is not none else '') }}"
aria-label="{{ b.name }} 연차(비우면 법정 연차)" /></td>
{% if bal_prior_year %}
value="{{ '%g' % b.total if b.total is not none else '' }}" placeholder="{{ '%g' % b.granted if b.hire_date else '' }}"
aria-label="{{ b.name }} 이번 연차 기간 직접 입력(비우면 법정)" /></td>
{% if bal_prior_col %}
<td><input class="erp-input vac-bal-input vac-bal-prior" type="number" name="prior" step="0.5" min="0" max="365"
value="{{ '%g' % b.prior if b.prior else '' }}" placeholder="0" aria-label="{{ b.name }} 시스템 전 사용"{% if not hire_ready %} readonly{% endif %} /></td>
{% else %}<input type="hidden" name="prior" value="{{ '%g' % b.prior if b.prior else '' }}" />{% endif %}
<td class="vac-bal-num">{{ '%g' % b.used }}</td>
<td class="vac-bal-num vac-bal-remain{% if b.remaining is not none and b.remaining < 0 %} is-minus{% endif %}">{{ '%g' % b.remaining if b.remaining is not none else '—' }}</td>
<td class="vac-bal-num vac-bal-remain{% if b.available is not none and b.available < 0 %} is-minus{% endif %}">{{ '%g' % b.available if b.available is not none else '—' }}</td>
<td class="vac-bal-expire">{% if b.expiring %}{{ b.expiring.date[2:] | replace('-', '.') }} · {{ '%g' % b.expiring.days }}일{% else %}—{% endif %}</td>
<td><input class="erp-input vac-bal-memo" type="text" name="memo" maxlength="200" value="{{ b.memo }}" placeholder="비고" aria-label="{{ b.name }} 메모" /></td>
</tr>
{% else %}
<tr><td colspan="8" class="erp-muted">휴가 모듈 권한이 있는 사용자가 없습니다.</td></tr>
<tr><td colspan="10" class="erp-muted">휴가 모듈 권한이 있는 사용자가 없습니다.</td></tr>
{% endfor %}
</tbody>
</table>
</div>
<div class="vac-opt-save"><button type="submit" class="erp-btn erp-btn-primary">{{ bal_year }}년 잔여 연차 저장</button></div>
<div class="vac-opt-save"><button type="submit" class="erp-btn erp-btn-primary">잔여 연차 저장</button>
<span class="erp-muted vac-bal-note" hidden>입사일·직접 입력을 바꿨습니다 — 저장하면 사용·잔여·소멸을 다시 계산합니다.</span></div>
</form>
{% endif %}
@@ -152,4 +150,4 @@
{% endblock %}
{% block scripts %}<script src="/static/erp-datepop.js?v=20261027b" defer></script>
<script src="/static/vacation.js?v=20261027b" defer></script>{% endblock %}
<script src="/static/vacation.js?v=20261027c" defer></script>{% endblock %}
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/vacation.css?v=20261027d" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/vacation.css?v=20261027e" />{% endblock %}
{% block content %}
<section class="vac">