/SimpleHR project
Sign in
SimpleHR project

휴가 잔액 변동 이력 스펙

conceptedited by Cairni · 방금 · AIv1

개요

휴가 잔액 변동 이력 조회 기능은 관리자가 특정 직원의 휴가 잔액이 어떤 경위로 변동되었는지 시계열로 파악할 수 있도록 2026년 6월 19일에 신규 추가된 기능이다. 휴가 관리 스펙 및 근태 관리 스펙과 연계된다. fix-task-0619.md fix-task-0619.md

API 스펙

신규 엔드포인트

항목내용
메서드GET
경로/admin/leave/balances/history
접근 권한관리자 전용
상태신규 구현 완료

fix-task-0619.md

UI 스펙 — 휴가지급관리 Drawer

관리자 페이지 근태 관리 > 휴가지급관리 에서 해당 직원을 클릭하면 열리는 Drawer 안에 변동 이력 테이블이 추가된다. fix-task-0619.md

변동 이력 테이블 컬럼

컬럼명설명
일시변동이 발생한 일시 (UTC → KST 변환 후 표시)
유형변동 유형 (예: ADJUST, CARRYOVER, EXPIRE 등)
휴가 종류연차, 반차, 특별휴가 등
변동증감 일수 (양수/음수)
잔여변동 후 잔여 일수
사유변동 사유 텍스트
변경자변동을 처리한 관리자 또는 시스템

fix-task-0619.md

시간대 처리

  • 서버에서 반환되는 일시는 UTC 기준
  • UI에서 KST(UTC+9) 로 변환하여 표시
  • 이 처리는 해당 Drawer 내 이력 테이블에 적용됨

fix-task-0619.md

구현 흐름

관련 미완료 사항 (이월 기능)

변동 이력과 연계되는 이월(Carryover) 관련 기능은 일부 미구현 상태이다. 자세한 내용은 연차 이월(Carryover) 기능 스펙을 참고한다. fix-task-0619.md

이월 기능 구현 현황AI · 출처 클릭
완료2
API change_type: CARRYOVER 구현
fix-task-0619.md
사용자 카드 '이월 N일' 표시 구현
fix-task-0619.md
미완료4
관리자 휴가 잔액 조정 드로어에 change_type 선택 UI 추가 (ADJUST/CARRYOVER/EXPIRE)
fix-task-0619.md
연말 미사용 연차 자동 이월 정책 설정 UI 필요 여부 확인 (회사별 이월 한도, 소멸 기한)
fix-task-0619.md
이월 연차 만료일(expires_at) 자동 설정 로직 확인
fix-task-0619.md
사용자 카드 carryover_days=0일 때 undefined 미반환 여부 확인
fix-task-0619.md

관련 페이지

Made with CairniExplore public wikis →