GBS123의 전기요금 프로그램을 공개하는 이유
전기요금 계산 프로그램 상세 보고서 및 통합 소스 코드
본 보고서는 한국전력공사(KEPCO)의 ‘주택용전력 통합 단가표’를 기반으로, 전력 소비량에 따른 요금을 정밀하게 산출하는 웹 기반 솔루션의 설계 사양과 통합 소스 코드를 제공합니다.
——————————————————————————–
1. 프로그램 개요 및 목적
1.1 프로그램 정의
본 프로그램은 사용자가 입력한 사용 기간(시작일~종료일)과 전력 사용량(kWh), 계약종별(저압/고압)에 따라 실시간으로 전기요금을 산출하는 정밀 시뮬레이션 계산기입니다.
1.2 개발 배경 및 목적
- 데이터 무결성 확보: 기존 엑셀 환경에서 빈번하게 발생하는 수식 파손(특히
@기호 삽입에 의한 배열 수식 오류)을 원천 차단하기 위해 독립적인 JavaScript 로직으로 재설계되었습니다. - 브라우저 호환성 강화: 파일명 및 경로 인코딩 문제를 방지하기 위해 ASCII 표준을 준수하며, 별도의 서버 통신 없이 클라이언트 사이드에서 즉시 실행됩니다.
- 오류 방지 로직 도입: 단순 누적 합산 방식(SUMIFS) 대신 **’매치별 평균 논리(Average-by-match logic)’**를 적용하여, 요금 개정 시기나 계절 전환기 발생할 수 있는 14.8%의 유형 오류를 방지합니다.
——————————————————————————–
2. 데이터 구조 및 정규화 DB 정의
본 프로그램은 2020년부터 2024년까지의 개정 단가를 정규화된 DB 구조로 내장하고 있습니다. 소스 데이터의 ‘FALSE’ 값은 0으로 예외 처리하여 계산의 연속성을 확보했습니다.
핵심 필드 상세 설명
|
필드명 |
설명 |
데이터 범위 및 제약 |
|
|
해당 요금 체계가 시작되는 기준일 |
2020-01-01 ~ 2024-12-31 |
|
|
주택용(저압), 주택용(고압) |
저압(주거용), 고압(아파트 등) |
|
|
하계(7 |
7, 8월 누진 구간 확대 적용 |
|
|
1단계, 2단계, 3단계(슈퍼유저) |
사용량 구간별 단가 차등 |
|
|
기본요금, 전력량요금, 기후/연료비 |
원 단위 및 소수점 포함 |
|
|
전력산업기반기금 적립 비율 |
2023(3.7% / 3.2%) → 2024(2.7%) |
——————————————————————————–
3. 요금 계산 알고리즘 상세
3.1 일할 계산(Prorated Calculation) 및 매치별 평균 논리
사용 기간 중 단가가 변경되는 경우(예: 2023년 5월 16일 요금 인상), 전체 사용량을 일수 비율로 나누어 각각의 단가를 적용합니다.
- 프로세스:
전체 사용량 / 전체 일수 = 일일 평균 사용량도출 → 각 날짜에 해당하는 단가 매칭 → 일일 요금 합산. - 이 방식은 기후환경요금 및 연료비조정요금 산출 시 기간별 단가 변동을 완벽히 추적하여 오차를 제거합니다.
3.2 누진제 및 계절성 처리 (Progressive Logic)
하계(7~8월)와 그 외 기간의 누진 구간이 다르게 설정되는 점을 반영합니다.
- 기타 기간: 1단계(0
200), 2단계(201400), 3단계(401+) - 하계 기간: 1단계(0
300), 2단계(301450), 3단계(451+) - JavaScript의
filter()와find()메서드를 사용하여 해당 날짜와 계절에 맞는 누진 단계 배열을 동적으로 호출합니다.
——————————————————————————–
4. 전체 통합 소스 코드 (HTML/CSS/JS)
본 코드는 시니어 엔지니어 관점에서 최적화된 모듈형 구조로 작성되었으며, 워드프레스 HTML 블록이나 WPCode 플러그인에 복사하여 즉시 실행할 수 있습니다.
<!DOCTYPE html>
——————————————————————————–
5. 결과 출력 양식 및 상세 내역
산출된 결과값은 KEPCO의 표준 청구서 항목에 따라 다음과 같이 구분 표시됩니다.
- 기본요금: 사용 기간 내 각 누진 단계에 대응하는 기본요금의 일할 가중 평균값.
- 전력량요금: 일일 평균 사용량을 누진 단계별 단가와 매칭하여 합산한 금액.
- 기후환경요금: 사용량에 기간별 기후환경단가를 적용한 합계.
- 연료비조정요금: 사용량에 기간별 연료비조정단가(±5원/kWh 등)를 적용한 합계.
- 부가가치세: 위 1~4번 합계액의 10% (원 미만 4사 5입).
- 전력산업기반기금: 위 1~4번 합계액에 해당 시점의 기금률을 곱한 금액 (원 미만 절사).
- 최종 청구금액: 모든 항목의 합계에서 10원 미만 절사 처리된 최종 납부액.
——————————————————————————–
6. 운영 및 검증 지침
6.1 법적 고지 및 확인 사항
본 프로그램의 계산 결과는 KEPCO의 공식 요금 규정을 충실히 반영하고 있으나, 실제 고지서와는 미세한 일수 계산 방식(월력 일수 vs 30.4일 기준 등)에 따라 근소한 차이가 발생할 수 있습니다. 법원 제출이나 공식 증빙으로 사용하기 전에는 반드시 KEPCO 공식 요금 통지서와 대조 검증을 수행하시기 바랍니다.
6.2 유지보수 가이드 (2024년 이후)
향후 전력 요금 체계가 개정될 경우, 소스 코드 내 TARIFF_DB 배열에 새로운 객체를 추가하십시오.
- 추가 예시:
{ date: "2025-01-01", type: "저압", stages: [...], climate: 10.0, fuel: 5.0, fund: 2.7 } - 데이터 업데이트 시에는 소스 컨텍스트 이미지의 1단계~3단계 단가를 반드시 확인하여 입력해야 합니다.
