Methodology
계산 방법
KR Numbers는 한국 생활에서 자주 확인하는 급여, 노동, 날짜, 세금, 복지, 생활금융, 주거비, 단위 환산 숫자를 정적 페이지와 브라우저 계산으로 제공합니다. 사용자가 입력한 급여·근로시간·날짜·대출·생년월일 같은 원문 값은 KR Numbers 서버로 보내지 않고, 각 페이지의 스크립트가 브라우저에서 계산합니다.
어떻게 계산하나요
각 도구는 페이지에 보이는 입력값과 기준일을 사용해 계산합니다. 공식 기준이 있는 경우에는 정부·공공기관·법령·공식 보도자료를 먼저 확인하고, 계산에 직접 쓰인 값은 TypeScript 함수와 정적 데이터로 분리해 테스트합니다. 대량 페이지는 같은 틀을 복사하기보다 실수령 인사이트, 생활 숫자 인덱스, 복지 소득 기준 맵처럼 여러 기준을 다시 묶은 해석 페이지와 함께 연결합니다.
자동화와 AI 보조를 어떻게 사용하나요
공개되는 수치와 표는 공식 기준을 넣은 결정론적 계산 코드와 정적 데이터에서 생성합니다. 설명 초안과 코드 검토에 AI 보조 도구를 사용할 수 있습니다. 다만 운영 과정에서 출처, 계산 가정, 결과 표본과 회귀 테스트를 다시 확인하며, 생성형 AI가 계산값이나 공식 출처를 대신하지 않습니다. 자동 생성한 수치만으로 유사 페이지를 대량 발행하지 않고, 사용자가 비교·재현할 수 있는 표와 분석으로 선별해 공개합니다.
1. 공식 출처 우선
요율, 기준표, 공휴일, 복지 기준, 실거래 집계처럼 공공 기준이 있는 항목은 정부·공공기관· 법령·공식 보도자료를 우선 사용합니다. 각 계산기에는 확인일과 출처 링크를 표시하고, 출처가 여러 개인 경우 계산에 직접 쓰인 기준과 참고 기준을 분리합니다.
2. 계산식과 입력 범위
계산식은 TypeScript 함수로 분리해 관리합니다. 연봉 실수령표는 4대보험 요율, 국민연금 상·하한, 국세청 간이세액표 기반 소득세, 지방소득세 계산을 조합합니다. 날짜·영업일·공휴일 도구는 KST 기준 날짜와 정적 공휴일 데이터를 사용하고, 대출·예적금 도구는 입력한 금리와 기간을 기준으로 월 상환액·세후 이자를 계산합니다.
3. 정적 빌드와 개인정보
사이트는 Cloudflare Pages에 정적 파일로 배포됩니다. 회원가입, 로그인, 개인별 저장 기능을 두지 않으며 계산기 입력 원문을 백엔드 데이터베이스에 저장하지 않습니다. 현재는 제3자 분석 스크립트와 광고 스크립트도 로드하지 않습니다. 향후 분석 기능을 활성화하려면 사용자의 명시적 선택과 철회 경로를 먼저 제공하고, 계산기 입력 숫자 원문은 이벤트 값으로 전송하지 않습니다.
4. 회귀 테스트와 배포 전 점검
계산 로직은 Vitest 회귀 테스트로 검증합니다. 배포 전에는 테스트, 정적 빌드, 보안 감사, sitemap/robots/ads.txt, 내부 링크, 중복·얇은 페이지 여부를 확인합니다. 사용자가 결과를 읽는 흐름을 방해하는 빈 영역, 미완성 안내, 과도한 책임 회피 표현은 공개 HTML에 남기지 않는 것을 원칙으로 합니다.
5. 결과를 읽는 방법
결과는 각 페이지의 입력값, 확인일, 공식 출처, 계산 가정에 맞춰 해석하면 됩니다. 부양가족, 비과세 항목, 회사 정산 방식, 가구원수, 재산, 금융기관 심사 기준처럼 개인별로 달라지는 값은 별도 확인이 필요합니다.
주요 기준 링크는 출처 모음에서, 계산 범위는계산 범위와 출처에서 함께 볼 수 있습니다. 계산 오류나 공식 기준 갱신 제보는문의 페이지로 보내 주세요.