Files
dbx-main/app/modules/vacation/CLAUDE.md
T
king 77cf46c859 feat(vacation): 휴가 신청 날짜 칸 — 프로젝트와 같은 아사나식 날짜 팝업
- 공용 erp-datepop.js/css(project.js openDatePopover·enhanceDateInput·.pj-datepop CSS 를 떼어 낸 같은 모양·동작)
- 시작일·종료일 = 숨긴 input + 날짜 버튼 둘(enhanceRange), 어느 쪽을 눌러도 같은 기간 팝업(누른 칸 먼저, 시작 → 종료 → 닫힘),
  반차는 하루짜리, 직접 입력(Enter), Esc·바깥 클릭 닫힘
- 공휴일 = 휴가 설정 공휴일(빨강, 작년~내년) — 팝업 빨강·이름, 예상 일수에서도 제외(서버 compute_days 와 같게)
- 테스트: vacation_datepop.browser.test.js(render_vacation.py), 휴가 신청 화면 공휴일·스크립트 렌더 확인

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 14:50:25 +09:00

3.6 KiB

[휴가] 휴가 관리 모듈 — app/modules/vacation/, vacation_db

이 모듈만 고칠 때 읽는 요약. 별도 상세 문서 없음 — 코드가 기준. 정적 파일: app/static/vacation.css, app/static/vacation.js. 템플릿: templates/.

  • 월간 달력(구글식 bar) / 연차·반차 신청 / 승인 워크플로 / 공휴일·연차 설정.
  • 권한키 vacation(사용)·vacation_approver(승인).
  • 신청 화면 날짜 칸 = 프로젝트와 같은 아사나식 날짜 팝업(2026-10-27, 공용 app/static/erp-datepop.js·.css — project.js openDatePopover· enhanceDateInput 을 떼어 낸 것). 시작일·종료일 input 은 숨긴 값 저장소, 옆 날짜 버튼 둘(ErpDatePop.enhanceRange) — 어느 쪽을 눌러도 같은 기간 팝업(누른 칸이 먼저, 시작일 고르면 종료일 칸으로, 종료일 고르면 닫힘, 지우기 없음), 반차는 하루짜리 팝업(시작=종료). 직접 입력(10/27·1027 Enter). 공휴일 = 휴가 설정 공휴일 중 빨강(router._red_holidays, 작년~내년, #vac-holidays) — 팝업 빨강·이름 + 예상 일수에서도 뺀다(서버 compute_days 와 같은 표). 테스트 tests/js/vacation_datepop.browser.test.js(render_vacation.py).

휴가 옵션 · 휴가 메일 (2026-10-27, 마이그레이션 vacation_db_001_options_mail.sql)

  • 옵션 /vacation/options(달력 위 [옵션], 누구나 보기 · 수정 = ERP 관리자): 휴가 승인자(여러 명) · 휴가 승인 통보자. 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).