업무기한 계산기

시작일과 처리기간(일)을 넣으면 세 가지 마감일을 계산하는 정적 웹앱입니다. 서버와 데이터베이스는 없습니다.

결과	뜻
① 달력일 원래 마감일	시작일 + N일. 휴일이어도 그대로 표시
② 휴일 연장 적용 마감일	①이 휴일이면 다음 근무일로 미룬 날 (옵션, 기본 켜짐)
③ 근무일 기준 마감일	토·일요일(과 공휴일)을 빼고 N번째 근무일

시작일은 세지 않습니다(초일 불산입). 처리기간은 1~365일입니다. 자세한 규칙은 PRD.md에 있습니다.

이 계산기는 일반 내부 업무기한 참고용입니다. 법정 처리기한은 해당 법령에 따라 따로 산정해야 합니다.

폴더 구성

index.html              화면
css/styles.css          스타일 (라이트·다크 모드)
js/holidays.js          공휴일 데이터 (출처·기준일 포함) ← 매년 갱신
js/calc.js              계산 로직 (화면과 분리, Node에서 테스트 가능)
js/app.js               화면 처리
tests/expected-cases.json  PRD 9장 테스트 기대값
tests/calc.test.js      계산 로직 테스트 (Node 내장 테스트, 외부 패키지 없음)
scripts/verify_expected.py 기대값 독립 검산 (웹앱 코드를 쓰지 않음)

실행

빌드 과정이 없습니다. index.html을 브라우저로 바로 열어도 됩니다.

테스트

npm test                          # 웹앱 계산 로직 테스트 (Node 18 이상)
python scripts/verify_expected.py # 기대값 독립 검산 (Python 3.9 이상)

배포 (GitHub → Vercel)

1. 이 폴더를 GitHub 저장소에 올립니다.
2. Vercel에서 Add New → Project로 저장소를 가져옵니다.
3. Framework Preset은 Other를 고르고, Build Command와 Output Directory는 비워 둡니다.
4. 배포하면 index.html이 첫 화면이 됩니다. tests/, scripts/ 등은 .vercelignore로 배포에서 뺍니다.

공휴일 데이터 갱신

js/holidays.js 하나만 고칩니다.

1. 새 연도의 월력요항(우주항공청, 보통 6월 발표)과 임시공휴일 공고를 확인합니다.
2. holidays에 날짜를 추가하고, 근거를 sources에 등록한 뒤 sourceIds로 연결합니다.
   • 근거를 확인하지 못한 날은 status: "pending"으로 넣습니다. 이런 날은 근무일로 계산하고 화면에 안내를 표시합니다.
3. coverageYears에 연도를 추가하고 updatedAt을 검증한 날로 바꿉니다.
4. tests/expected-cases.json, tests/calc.test.js, scripts/verify_expected.py의 공휴일 목록과 일수를 함께 고친 뒤 두 테스트를 모두 통과하는지 확인합니다.