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>
7.4 KiB
7.4 KiB
[휴가] 휴가 관리 모듈 — app/modules/vacation/, vacation_db
이 모듈만 고칠 때 읽는 요약. 별도 상세 문서 없음 — 코드가 기준. 정적 파일:
app/static/vacation.css,app/static/vacation.js. 템플릿:templates/.
- 월간 달력(구글식 bar) / 연차·반차 신청 / 승인 워크플로 / 옵션(승인자·통보자·잔여 연차).
- 설정 화면 없음(2026-10-27 삭제 — [설정] 버튼·공휴일 추가/삭제 기능 포함).
GET /vacation/settings는 옵션으로 넘김, 공휴일 저장 주소 없음. - 권한키
vacation(사용)·vacation_approver(승인). - 신청 화면 날짜 칸 = 프로젝트와 같은 아사나식 날짜 팝업(2026-10-27, 공용
app/static/erp-datepop.js·.css— project.jsopenDatePopover·enhanceDateInput을 떼어 낸 것). 시작일·종료일 input 은 숨긴 값 저장소, 옆 날짜 버튼 둘(ErpDatePop.enhanceRange) — 어느 쪽을 눌러도 같은 기간 팝업(누른 칸이 먼저, 시작일 고르면 종료일 칸으로, 종료일 고르면 닫힘, 지우기 없음), 반차는 하루짜리 팝업(시작=종료). 직접 입력(10/27·1027 Enter). 공휴일 = 국경일·대체공휴일(router._red_holidays→db.holiday_map, 작년~내년,#vac-holidays) — 팝업 빨강·이름 + 예상 일수에서도 뺀다(서버 compute_days 와 같은 표). 테스트tests/js/vacation_datepop.browser.test.js(render_vacation.py).
공휴일 · 연차 (2026-10-27)
- 쉬는 날 = 대한민국 국경일·대체공휴일 표만(
db.holiday_map한 곳 — 달력·날짜 팝업·일수 계산red_holiday_set모두). 표는 프로젝트 모듈app/modules/project/store.pyKR_HOLIDAYS(2026~2030, 새 연도는 그 표에 추가). 공휴일 설정 화면은 없앴고vacation_holidays표(예전 seed·직접 넣은 줄)는 남아 있지만 읽지 않는다. 예전엔 그 표만 써서 seed 가 없는 해·제헌절은 근무일로 셌다. 이미 저장된 신청의 일수는 그대로(새로 저장·수정할 때 다시 계산). - 메인 달력: 공휴일 이름이 날짜 숫자 아래(
.vac-hol-name), 그 주는.vac-week.has-hol(휴가 막대 top 38 → 54px). - 연차 차감 = 승인된
DEDUCT_TYPES(연차·오전반차·오후반차)만(db.used_days, 병가·경조·대체휴무·기타는 안 뺌 — 예전엔 모든 승인 휴가를 뺐다), 제출·작성중은 안 뺌. 해를 넘는 신청은 해마다 그 해 날짜만큼 나눔(예전엔 시작일 연도에 통째로). 연차는 그해 것만 — 12/31 소멸, 다음 해로 넘기지 않음 (vacation_balances가 연도별, 새해는 새로 등록. 달력 잔여 옆 "yyyy.12.31 소멸"). - 잔여 연차 등록 = 옵션(설정에서 옮김, 옵션 수정 권한자만 보기·저장) — 참여자(휴가 모듈 사용자) 전원을 아이콘·이름·이메일과 함께 미리 보여 주는 표
(연차 입력·사용·잔여(음수 빨강)·메모, 아직 없으면 작년 연차를 회색 참고, 예전에 등록됐지만 권한이 없는 사람도 아래에), 연도 ‹ › 이동,
POST /vacation/options/balances한꺼번에(db.save_balances한 트랜잭션 — 0~365·0.5일 단위, 빈 칸 = 그대로). 예전POST /settings/balances는 없앴다.
입사일 · 근로기준법 연차 · 시스템 전 사용 (2026-10-27, 마이그레이션 vacation_db_002_hire_prior.sql)
- 옵션 잔여 연차 표 이름 옆 입사일 = 날짜 버튼(
ErpDatePop.enhance, « » 1년씩·직접 입력 2020-03-02 Enter, 지우기) →vacation_employees(사람마다 하나). - 법정 연차 =
store.legal_annual_leave(입사일, 연도)— 근로기준법 제60조를 입사일 기준으로 생기는 날을 그해(1/1~12/31)에 모음 (12/31 소멸 규칙과 맞춤): 입사 1년 미만 = 입사일 + 1~11개월마다 1일, 입사일이 돌아올 때마다(근속 n년)min(25, 15 + (n−1)//2). 출근율(개근·80%)은 따지지 않음(모두 채운 것으로). 화면(vacation.js)도 같은 계산으로 입사일을 고르는 즉시 근속·법정·잔여를 다시 보여 줌. - 연차 칸 = 직접 입력(값이 있으면 그 값), 비우면 법정 연차(
vacation_balances.total_daysNULL). 입사일도 연차도 없으면 0. - 시스템 전 사용(
prior_used) — 이 시스템을 쓰기 전에 그해 이미 쓴 연차, 도입 해(store.SYSTEM_START_YEAR= 2026)만 표에 칸. - 잔여 = 총(직접 또는 법정) − 시스템 전 사용 − 승인된 연차·반차 —
db.balance_summary한 곳(달력 잔여·옵션 표 모두). - 저장
POST /vacation/options/balances줄마다 email·hire·total·prior·memo(칸 수가 다르면 400, 한 줄이라도 틀리면 전부 안 함 —db.save_balances). 002 전이면 입사일·시스템 전 사용은 무시(입사일 칸은 숨김 칸, 안내 문구), 연차 직접 입력만 예전처럼.
휴가 옵션 · 휴가 메일 (2026-10-27, 마이그레이션 vacation_db_001_options_mail.sql)
- 옵션
/vacation/options(달력 위 [옵션], 누구나 보기): 휴가 승인자(여러 명) · 휴가 승인 통보자 · 잔여 연차. 수정 = ERP 관리자(수퍼관리자 포함) + 지금 승인자(옵션 지정, 없으면 휴가 승인 권한자) + 승인 통보자(router._can_edit_options한 곳, 2026-10-27 — 예전엔 관리자만).vacation_options키approval={"approvers": [...], "notifiers": [...]}(db.get_options·save_options, 휴가 모듈 사용자만 고를 수 있음). - 승인·반려 권한(
router._is_approver) = ERP 관리자 + 옵션 승인자(지정했으면 그 사람만), 승인자를 비우면 예전처럼vacation_approver권한자. 승인 대기 버튼·상세 조회·_require_approver모두 이 한 곳. - 메일(
notify.py, 응답 뒤 BackgroundTasks — 실패해도 휴가 처리는 그대로): 제출 = 승인자 + 통보자, 승인·반려 = 승인자 + 통보자 + 신청자 (승인자 미지정이면vacation_approver칩을 켠 사람 — 관리자는 자동으로 안 넣음, 중복 한 번). 제목[휴가 승인] 이름 · 종류 기간 (N일), 본문 표 + [휴가 신청 보기] 링크(PUBLIC_BASE_URL). 사유·반려 사유는 escape. - 보내는 사람 = 그 일을 한 사람 본인 Gmail(제출 = 신청자, 승인·반려 = 처리한 승인자) — 입출고와 같은 Gmail 연결(inout_db
inout_gmail_tokens, gmail.send 만, 한 사람 = 연결 하나). 옵션 화면 [Gmail 연결] →/vacation/gmail/connect(세션_gmail_origin=vacation) → 구글 → 입출고 콜백/inout/gmail/callback이 휴가 권한으로 처리(inout.router._gmail_callback_vacation— 구글 클라우드 리디렉션 주소 추가 없음) → 옵션으로. 연결이 없거나 끊김·Gmail 실패면 회사 SMTP(app/mail.py, 보낸 사람 이름 = "이름 (DBX ERP)"·Reply-To = 그 사람). 끊긴 토큰은 지움. - 기록
vacation_mail_log(이벤트·보낸 사람·gmail|smtp·받는 사람·제목·성공·오류, 본문·토큰은 안 남김) → 상세 화면 "메일" 줄. - 001 미적용이면 옵션 없음(예전 권한 규칙)·저장 503·기록 없음, 메일은 그대로 나감. 화면
.erp-page:has(> .vac)border-box(셸 오른쪽 48px 넘침). - 테스트
tests/test_vacation_options_mail.py(규칙·내용·Gmail→SMTP·실제 앱 권한·콜백 분기),tests/test_vacation_db.py(실제 PG,VACATION_TEST_DB_URL).