기준체크 (gijuncheck)
퇴직 전후 건강보험 선택을 공식 기준과 공개된 검증 이력으로 설명하는 민간 참고 도구.
유사한 기능을 제공하는 민간 서비스가 이미 있으므로, 기준체크는 기능의 존재보다
단계별 근거·공식 대조 범위·갱신 이력·한계 공개를 경쟁력으로 삼는다.
문서
여기부터 읽으세요 — 이 저장소가 공개하는 것은 판정 근거와 검증 이력이다.
기준·운영 문서
운영 계획·우선순위·시장 조사 문서는 저장소에서 추적하지 않고 로컬에만 둔다.
대상은 .gitignore 하단에 있다. 작업을 이어갈 때는 로컬 MEMORY.md부터 읽는다.
시작하기
npm install
npm run dev # 개발 서버
npm test # 판정·보험료 로직 단위 테스트
npm run verify # 타입체크 + 테스트 + 빌드 한 번에
프로덕션 결과 확인
output: 'export' 설정이므로 next start 를 쓸 수 없습니다.
빌드 결과인 out/ 을 정적 서버로 띄웁니다.
npm run build # out/ 생성
npm run preview # out/ 을 정적 서버로 서빙
# 또는 한 번에
npm start
이 제약을 포함해 output: 'export' 때문에 생기는 세 가지 주의사항은
next.config.mjs 주석에 적어뒀습니다.
검증 상태
| 항목 | 상태 |
|---|
| 판정 로직 (부양·소득·재산 3단, 금융소득 문턱) | 단위 테스트 통과 |
| 보험료 계산 · 재산 60등급표 · 반영률 · 상한하한 | 단위 테스트 통과 |
| 타입 안정성 | tsc --noEmit 통과 |
next build + 정적 내보내기 | 통과 (16라우트 SSG) |
| 가이드 본문 ↔ 상수 교차검증 | 낡은 값 없음 확인 |
| canonical ↔ sitemap 일치 | 빌드 산출물에서 확인 |
| 정책 페이지 noindex · sitemap 제외 | 빌드 산출물에서 확인 |
| 공단 모의계산 대조 | 지역보험료 27건 대조 완료 (VERIFIED_AGAINST_NHIS = true). 피부양자는 공단 공개 안내·시행규칙 기준 사례를 자체 재현하며, 로그인 모의계산은 별도 |
구조
src/
├── app/
│ ├── layout.tsx 공통 레이아웃 + 메타데이터
│ ├── page.tsx 허브
│ ├── sitemap.ts routes.ts 에서 자동 생성
│ ├── robots.ts
│ └── health-insurance/dependent/ 1순위 도구
├── components/
│ └── DependentJudge.tsx 판정 폼 (클라이언트)
└── lib/
├── site.ts 사이트 전역 상수
├── routes.ts ★ 경로 레지스트리
├── constants/
│ ├── 2026.ts ★ 연도별 요건·요율
│ └── property-score-table.ts 재산 60등급표
├── dependent/
│ ├── types.ts
│ ├── judge.ts 판정 로직 (순수 함수)
│ └── judge.test.ts
└── premium/
├── regional.ts 지역보험료 · 임의계속가입
└── regional.test.ts
지켜야 할 규칙 5개
1. 숫자를 코드에 직접 쓰지 않는다.
요건과 요율은 매년 바뀝니다. 기존 계산기들이 낡아서 죽은 이유가 이것입니다.
현재 적용 기준값은 src/lib/constants/active.ts를 통해 관리하며, 실제 2026년 값은
src/lib/constants/2026.ts에 있습니다. 연도 전환 전 확정되지 않은 값은 계산에 반영하지 않습니다.
새 연도가 오면 2026.ts를 복사해 2027.ts를 만드세요.
2. 로직을 UI에 넣지 않는다.
judge.ts와 regional.ts는 순수 함수이고 React를 import하지 않습니다.
법령이 바뀔 때 컴포넌트를 뒤지게 되면 유지보수를 포기하게 됩니다.
3. 경로는 routes.ts에만 쓴다.
페이지를 추가할 때 sitemap 등록을 잊는 게 가장 흔한 실수입니다.
ROUTES에 등록하고 ready: true로 바꾸면 sitemap이 자동으로 따라옵니다.
컴포넌트에 경로 문자열을 직접 쓰지 마세요.
4. 결과에는 항상 근거와 기준 연도를 붙인다.
이 사이트의 자산은 신뢰입니다. 모든 StepResult에 basis가 있고
JudgeResult에 year가 있습니다. UI에서 빼지 마세요.
5. layout.tsx에서 임의 상수를 export 하지 않는다.
Next.js App Router는 layout 파일의 export 필드를 제한합니다.
SITE 같은 상수를 여기 두면 빌드가 실패합니다. src/lib/site.ts를 쓰세요.
진행 상황
현재 남은 확인 과제
① 검색 색인 처리 결과 확인
Google Search Console과 네이버 서치어드바이저에 사이트·sitemap·핵심 URL의 수집/색인을
요청했습니다. 신청과 실제 색인 완료는 다르므로 1주 단위로 색인 상태·제외 사유·선택
canonical을 확인해야 합니다.
지역보험료 계산은 2026-08-05 공단 공식 모의계산 대표 사례 13건을 금융소득 산식 수정 후
재대조해 VERIFIED_AGAINST_NHIS = true로 갱신했고, 2026-08-06 C14~C28을 더해 27건으로
넓혔습니다. 확대 과정에서 전월세 반영 규칙 결함과 소득월액보험료 화면 표시 결함을
찾아 고쳤으며, 그 불일치 사례도 /verification-policy/ 표에 그대로 공개합니다.
공단 계산기와 마찬가지로
지역보험료는 사업·이자·배당·기타소득을 100% 반영하며, 피부양자 판정의 금융소득 문턱과는
별도입니다. 피부양자 판정은 공단 공개 안내·시행규칙 기준 대표 사례를 자체 재현하며,
로그인 모의계산·실제 처리 결과 대조는 별도 과제입니다.
② 운영 지표 누적 확인
GA4 핵심 이벤트는 실시간 수신까지 확인했습니다. Vercel Speed Insights는 연결·배포를
완료했으므로 실제 Core Web Vitals 데이터가 누적되는지 확인하고, 내부 테스트 트래픽을
분리하는 운영 기준을 정해야 합니다.
참고: 피부양자 최종 자격·지역보험료 고지액·임의계속가입 신청 가능 여부는
국민건강보험공단의 최신 안내와 개별 심사가 우선입니다.
놓치기 쉬운 함정 5개
작업 중 실제로 밟았던 것들입니다. 같은 곳을 또 밟지 않도록 적어둡니다.
① layout.tsx에서 임의 상수를 export 하면 빌드가 깨진다
Next.js App Router는 layout 파일의 export 필드를 제한합니다. → src/lib/site.ts
② 'use client' 모듈의 함수를 서버 컴포넌트에서 호출하면 빌드가 깨진다
won() 같은 포맷 함수를 components/ui.tsx에 두면
page.tsx의 metadata·FAQ 생성에서 호출할 수 없습니다. → src/lib/format.ts
③ output: 'export'에서 메타데이터 라우트는 force-static이 필수
robots.ts·sitemap.ts에 export const dynamic = 'force-static'이 없으면
"Collecting page data" 단계에서 실패합니다.
④ .gitignore는 이미 추적 중인 파일을 보호하지 못한다
git rm --cached + .gitignore 로 추적을 끊은 뒤 그 커밋을 머지하고 git pull 하면,
로컬 워킹트리의 파일이 삭제됩니다. 삭제가 커밋에 담겨 있고 .gitignore 는 아직
추적 중이던 파일에 개입하지 못하기 때문입니다. 추적 해제 대상이 로컬에 남아야 하는
문서라면 pull 전에 백업하세요. 이미 지워졌다면 머지 직전 커밋에서 되살립니다.
git show <머지_직전_커밋>:"경로" > "경로" # 인덱스를 건드리지 않고 복원
⑤ git ls-files 를 pathspec 으로 넘기면 한글 파일명이 누락된다
git grep 패턴 -- $(git ls-files) 는 한글 파일명이 이스케이프된 채로 반환돼
한글 문서가 통째로 검색에서 빠집니다. 실제로 이 때문에 문서 참조 점검이
"0건"으로 잘못 나온 적이 있습니다. pathspec 없이 git grep 패턴 만 쓰세요.
판정 요건 요약 (2026년)
| 요건 | 기준 |
|---|
| 합산소득 | 연 2,000만원 이하 (1원 초과도 탈락) |
| 사업소득 · 등록 있음 | 0원이어야 인정 |
| 사업소득 · 등록 없음 | 연 500만원 이하 |
| 재산 과표 | 5.4억 이하 인정 / 5.4~9억은 소득 1,000만원 이하 / 9억 초과 탈락 |
| 형제자매 재산 | 과표 1.8억 이하 |
| 형제자매 부양 | 만 30세 미만 또는 65세 이상 또는 장애인 + 미혼 + 동거 |
| 건강보험료율 | 7.19% |
| 장기요양보험료율 | 0.9448% |
| 재산점수당 금액 | 211.5원 |
| 재산 기본공제 | 1억원 |
근거: 국민건강보험법 시행규칙 별표 1·별표 1의2, 시행령 별표 4 / 공단 2026년도 보험료율 고시
면책
본 프로젝트의 판정·계산 결과는 모의 결과이며 법적 효력이 없습니다.
최종 확인은 국민건강보험공단(1577-1000)에 문의해야 합니다.
