방법론

입력값과 계산 순서

재현 가능한 계산은 도구 종류, 날짜 또는 날짜 범위, 이동 방향과 기간, 국가, 필요한 경우 시간대, 선택한 계산 방식을 먼저 기록하는 데서 시작합니다. DeadlineDays는 입력값을 정리한 뒤 시작·종료 경계를 확정하고, 포함 규칙, 반복 휴무 요일, 공휴일 자료, 사용자 지정 휴무일, 최종일 조정을 정해진 처리 순서대로 적용합니다. 뒤 단계가 앞에서 선택한 규칙을 조용히 바꾸지 않습니다. 필수 입력이 없거나 자료를 사용할 수 없거나 지원 범위를 벗어나면 임의 기본값으로 대체하지 않고 결과 상태에 그 사실을 남겨야 합니다. 이 순서를 보존하면 입력 해석의 차이인지, 달력 자료의 차이인지, 최종 조정의 차이인지 구분해 필요한 단계만 다시 검토할 수 있습니다.

• 영업일 계산 규칙

day 0, day 1과 경계 포함

day 0과 day 1은 날짜 자체의 고정 속성이 아니라 기산 경계를 정하는 선택입니다. 사건 발생일을 제외하는 규칙에서는 그 날짜가 day 0이 되고 다음으로 계산 가능한 날부터 셉니다. 사건 발생일을 포함하더라도 그날이 적용 달력에서 실제 영업일이어야 day 1이 됩니다. 기간 계산의 종료일 포함 여부는 또 다른 질문이며, 휴무일에 도착한 결과를 이전 또는 다음 영업일로 옮기는 규칙과도 분리해야 합니다. '5영업일 이내', '5영업일 후', '금요일까지'는 같은 표현이 아니므로 화면의 경계 포함 설정을 계약이나 정책 문구와 나란히 확인하세요. 결과와 함께 어떤 날짜를 day 0과 day 1로 보았는지 기록해야 다른 담당자도 같은 결론을 재현할 수 있습니다.

• 영업일 경계 규칙

반복 주말과 휴무 요일

반복 휴무 계층은 해당 업무가 통상 처리되지 않는 요일을 나타냅니다. 토요일과 일요일은 흔한 기본값이지만 모든 국가와 조직, 업무 과정에 공통인 주말은 아닙니다. 창고, 고객 지원, 급여 대행사, 은행, 거래 상대방, 공공기관이 서로 다른 주간 운영표를 사용할 수 있습니다. DeadlineDays는 선택한 휴무 요일을 계산 범위 전체에 일관되게 적용한 뒤 일회성 공휴일과 회사 휴무일을 반영합니다. 같은 날짜가 여러 제외 규칙에 걸려도 한 번만 제외합니다. 이 계층은 날짜 단위이므로 반일 근무, 순환 교대, 온콜 대응, 시간별 처리량 감소는 표현하지 못합니다. 마감 책임 주체의 운영표를 기준으로 선택하고, 시간 단위 SLA는 별도 한계와 테스트 자료를 확인하세요.

• SLA 마감 계산 한계

공휴일 출처와 상태

공휴일 계층은 날짜 목록과 그 목록의 상태를 함께 다룹니다. 공휴일 기능이 있는 도구는 선택한 국가와 연도의 자료를 요청하고, 계산에 사용한 제공자와 사용 가능·사용 불가·범위 불완전 같은 상태를 결과에 표시합니다. 응답이 성공했다고 해서 지역 기념일, 은행·학교·시장 휴무, 고용주 휴일, 임시 휴무가 모두 포함됐다는 뜻은 아닙니다. 공식 연간 자료도 특정 기관이나 근로자 범위에만 적용되거나 게시 뒤 변경될 수 있습니다. 자료를 불러오지 못한 경우 공휴일이 없다고 표현해서는 안 됩니다. 중요한 날짜는 표시된 국가·연도·출처·상태를 보관하고 연결된 공식 자료에서 실제 적용 범위를 다시 확인하세요.

• 공휴일 데이터 출처 및 검토일

공휴일과 회사 휴무일

회사 휴무일은 재고조사, 고용주 휴일, 고객사 블랙아웃, 제공자 점검, 지역 행사처럼 공통 공휴일 자료가 알 수 없는 날짜를 추가하는 계층입니다. 반복 휴무 요일과 공휴일을 적용한 뒤 합치며, 같은 날짜가 두 목록에 있어도 한 번만 제외합니다. 사용자 지정 날짜는 공식 공휴일 지정이 아니라 사용자가 제공한 운영 근거이므로 그 의미를 혼동하지 않아야 합니다. 하루 전체를 제외하는 방식은 반일 휴무, 교대 변경, 시간별 SLA 정지를 대신하지 못합니다. 중요한 계산이라면 입력한 날짜를 해당 조직의 최신 공지와 대조하고, 감사나 승인 근거로 필요할 때는 목록과 사유를 조직 내부 기록에 별도로 보관하세요.

재현과 검토

결과 날짜만 적어 두면 계산을 완전히 재현할 수 없습니다. 사용한 계산기 경로, 입력 날짜와 시각, 이동 방향과 기간, 경계 포함, 휴무 요일, 국가와 연도, 공휴일 설정과 상태, 회사 휴무일, 최종일 조정, 시간대, 검토일을 함께 보관하세요. 결과 화면에 제외 날짜나 처리 단계가 표시되면 그 근거도 남겨야 합니다. 공유 링크는 허용된 제한 설정만 담을 수 있고 사용자 입력 문구가 빠질 수 있으므로 중요한 업무 기록을 대신하지 않습니다. 같은 입력을 다시 넣은 뒤 최종일보다 중간 제외 날짜부터 비교하면 입력 정리, 달력 자료, 정책 변경 중 무엇이 차이를 만들었는지 찾기 쉽습니다. 이전 결과를 덮어쓰기보다 변경 원인을 별도 기록하세요.

테스트 전략과 회귀 사례

DeadlineDays의 날짜 계산 테스트는 입력, 경계 규칙, 제외 날짜, 예상 결과가 고정된 회귀 사례를 사용합니다. 일반 범위뿐 아니라 월·연도 경계, 역방향 이동, 중복 휴무일, 빈 공휴일 응답과 자료 사용 불가, 업무시간 경계, 해당 도구가 지원하는 시간대 사례를 점검합니다. 공개 페이지 테스트는 설명, 출처 상태, 접근 가능한 근거, 언어 쌍, 경로, canonical, 내비게이션이 정적 빌드 뒤에도 남는지 별도로 확인합니다. 이런 테스트는 코드와 게시물의 회귀를 찾지만 계약 해석을 인증하거나 외부 달력이 계속 최신임을 보장하지는 않습니다. 새 오류가 확인되면 그 현상을 재현하는 가장 작은 사례를 추가하고 관련 사례를 함께 실행해 한 도구의 수정이 다른 업무 흐름을 바꾸지 않았는지 확인합니다.

• SLA 영업시간과 DST 테스트 사례

알려진 한계와 공식 출처 확인

DeadlineDays는 일정 계획과 독립적인 계산 확인을 위한 도구입니다. 어떤 계약이 우선하는지, 통지가 유효했는지, 승인이 실제로 언제 이루어졌는지, 어느 고용주 정책이 적용되는지 판단하지 않습니다. 선택한 자료에 없는 지역 관행, 제공자 마감시간, 부분 영업일, 순환 교대, 서비스 데스크 정지 사건, 이후의 출처 개정도 자동으로 추론할 수 없습니다. 신고, 지급 권리, 고용 조치, 세무 처리, 규제 통지처럼 잘못된 가정의 영향이 큰 날짜는 현행 정부·기관 자료, 서명 계약과 정책 버전, 책임 조직의 운영 달력을 직접 확인해야 합니다. 해석이 필요하면 해당 분야 전문가에게 문의하고, 계산기와 다른 결론을 사용한 경우 입력을 억지로 맞추지 말고 근거와 최종 판단을 명시적인 예외로 기록하세요.

• SLA 마감 계산 한계