📋 대한민국 패치노트 (Korea Patch Notes)
한국의 모든 것을 데이터로 — 정치·법안·선거·인물·역사 종합 데이터 플랫폼.
🔗 라이브 사이트: https://patchkr.com
🎯 5대 데이터 영역
| 영역 | 데이터 | 페이지 |
|---|
| 🏛 정치 | 대통령·총리·17부처 장관/차관·외청장·헌법기관 27명 + 대통령실 4명 | / /group/executive |
| 📜 법안 | 22대 국회 본회의 통과 1,595건 (발의자·정당·15분야·통과 속도) | /bills |
| 🗳 선거 | 9회 지방선거 후보자 697명 실시간 (5대 공약 포함) + 역대 7·8회 비교 | /election2026 /elections |
| 👥 인물 | 744명 종합 (22대 의원·단체장·사법부·검찰·역대 인물) | / |
| 📚 역사 | 1948~현재 정당사 45개, 역대 광역단체장·사법부 수장·정당 대표 | /history/parties |
✨ 핵심 기능
- 🗺 정치 분포 지도 — 17 시도 + 250 시군구 정당색 인터랙티브
- 📊 법안 상세 분석 — 정당별 표결·반란표·관련 판례·헌재 결정·법령 본문
- 📰 실시간 뉴스 — 네이버 검색 API로 인물·법안별 최신 보도
- 📈 관심도 추적 — 위키백과 페이지뷰 30일 추이
- 🌐 국제 비교 — 12개 민주국가 (의원수·여성비율·민주주의지수)
- 🌓 다크·라이트 모드 — 시스템 설정 자동 감지
🛠 기술 스택
- Frontend: 순수 HTML 단일 파일 (10,000+ 줄), 인라인 CSS·JS, d3 v7
- Hosting: Vercel (CDN·서버리스 함수)
- API 프록시: Vercel Serverless (
/api/*)
api/nec.js — 중앙선거관리위원회 후보자 데이터api/law.js — 국가법령정보 (법령·판례·헌재 결정)api/naver.js — 네이버 검색 (뉴스)api/bill.js — 국회 법안 상세
- 데이터 출처 (11개 통합):
- 대한민국 국회 OPEN API
- 중앙선거관리위원회 OpenAPI
- 국가법령정보센터 OpenAPI
- 한국어 위키백과 + Wikimedia 페이지뷰
- 네이버 검색 API
- IPU Parline · EIU · RSF · TI · OECD
🚀 로컬 실행
git clone https://github.com/minsoo500101-rgb/politik.git
cd politik
# 정적 서버 — 예: Python 내장
python -m http.server 8000
# 브라우저에서 http://localhost:8000
API 프록시 기능을 로컬에서 테스트하려면 Vercel CLI:
npm i -g vercel
vercel link
vercel env pull # .env.local 받기 (운영자만 가능)
vercel dev # http://localhost:3000
🔐 환경 변수 (Vercel)
| Key | 용도 | 발급처 |
|---|
DATA_GO_KR_KEY | 중앙선관위 후보자·공약 | data.go.kr |
LAW_GO_KR_OC | 국가법령정보 (법령·판례) | open.law.go.kr |
NAVER_CLIENT_ID | 네이버 검색 | developers.naver.com |
NAVER_CLIENT_SECRET | 네이버 검색 (시크릿) | 동일 |
🤝 기여 (Contributing)
기여 환영합니다! 특히:
데이터 PR 시 검증 기준
- 한국어 위키백과 또는 정부 공식 발표 출처
- 객관 사실만 (평가·해석·의견 X)
- 출생년도·학력·주요 경력·임명년도 등 검증 가능한 정보
🔌 공개 데이터 API (REST)
개발자·시민테크 프로젝트용 무료 REST API. CORS 열림, 24시간 CDN 캐시.
# Endpoint 목록
curl https://patchkr.com/api/data
# 정치인 전체 (학력·경력 포함)
curl https://patchkr.com/api/data?type=politicians
# 그룹별 (legislative/executive/judicial/local/historical)
curl https://patchkr.com/api/data?type=politicians&group=legislative
# 단일 정치인
curl https://patchkr.com/api/data?type=politicians&id=kr.min.보훈
# 정치 용어 사전 (136개)
curl https://patchkr.com/api/data?type=glossary
# 사이트 통계·요약
curl https://patchkr.com/api/data?type=info
라이선스: 공공누리 1유형 · CC BY-SA 4.0 (위키 인용분)
출처 표기 권장: Data: patchkr.com · https://github.com/minsoo500101-rgb/politik
💼 비즈니스 문의
광고·데이터 라이선싱·컨설팅:
☕ 후원
서버 운영비·API 사용료에 사용됩니다:
📊 누적 통계
| 항목 | 수치 |
|---|
| 등록 인물 | 744명 |
| career 데이터 | 141명 (27.6%) |
| 22대 통과 법안 | 1,595건 |
| 9회 지선 후보자 | 697명 |
| 통합 API | 11개 |
| 시군구 매핑 | 250 (100%) |
🛡 안정성 (Site Reliability)
자동 검증 (배포 전)
모든 git push에서 GitHub Actions가 자동 검증:
- ✅ politicians.json JSON 파싱
- ✅ 필수 필드 (id·name·type) + 중복 id 검사
- ✅ POLITICIANS_VER ↔ data version 일치
- ✅ sitemap.xml URL 유효성
- ✅ index.html 인라인 JS 신택스 (node --check)
- ✅
</script> 리터럴 검사 (HTML 파서 조기 종료 방지)
- ✅ API 파일에 하드코딩된 시크릿 검사
로컬 검증:
node scripts/validate.js
# 또는
npm run validate
런타임 에러 방지
- 전역 에러 핸들러 — JS 오류 시 빈 화면 대신 안내 카드 + 새로고침 버튼
- Promise rejection 핸들러 — API 실패해도 UI 손상 X
- 이미지·외부 리소스 로드 실패는 무시 — 비핵심 자원이 메인 페이지를 깨지 못함
모니터링 권장 (운영자 단계별 설치 가이드)
1) UptimeRobot — 다운타임 알림 (5분, 무료)
- uptimerobot.com 가입
- New Monitor → Type: HTTPS → URL:
https://patchkr.com → Interval 5분
- Alert Contact에 이메일 등록 → 사이트 다운 시 메일 알림
2) Sentry — 클라이언트 에러 자동 수집 (무료 5K/월)
- sentry.io 가입 → 새 프로젝트 (Platform: Browser JavaScript)
- DSN 받아서
index.html <head>에 추가:
<script src="https://browser.sentry-cdn.com/7/bundle.min.js"></script>
<script>Sentry.init({ dsn: 'YOUR_DSN', tracesSampleRate: 0.1 });</script>
3) Plausible — 사이트 분석 (개인정보 친화, $9/월 or 셀프호스팅)
<script defer data-domain="patchkr.com" src="https://plausible.io/js/script.js"></script>
GA4 대비 가벼움(1KB) + 쿠키 없음 + GDPR 친화.
4) Google Search Console — 색인 가속 (무료)
- search.google.com/search-console 가입
- URL 접두어 →
https://patchkr.com 입력
- HTML 파일 업로드 또는
<meta name="google-site-verification"> 태그 방식 선택
- 사이트맵 제출 →
sitemap.xml
- URL 검사 도구로 주요 페이지 색인 요청
5) Bing Webmaster Tools — Bing/Duck 색인
- bing.com/webmasters 가입
- Google Search Console에서 임포트 (한 클릭)
자동 데이터 동기화 (GitHub Actions)
.github/workflows/daily-sync.yml이 매일 09:00 KST에:
- 위키백과 자동 career fetch (career 미보유 인사 30명/타입)
- 변경 있으면 자동 검증 + 커밋 + push
- POLITICIANS_VER 자동 bump
수동 트리거: Actions 탭 → Daily data sync → Run workflow
📜 라이선스
- 코드: MIT
- 데이터: 각 출처 라이선스 (공공누리 1유형·CC BY-SA 4.0)
상업적 이용 가능. 출처 표기 권장.
운영자용 부록 — 네이버 검색 등록 / 분석 도구
1단계: 가입
- searchadvisor.naver.com 접속
- 사이트 등록 →
https://patchkr.com 입력
2단계: 소유 확인 (HTML 메타 태그)
- 발급된 인증 코드 복사
index.html의 <meta name="naver-site-verification"> content 교체- git push → 1~2분 후 "확인"
3단계: 사이트맵 제출
- 요청 → 사이트맵 제출 →
sitemap.xml 입력
4단계: 색인 가속 (요청 → 웹페이지 수집)
주요 URL 10개 정도 수동 요청 (일 50회 가능)
| 도구 | 가격 | 개인정보 | 무게 |
|---|
| Plausible ⭐ | $9/월 (or 셀프호스팅 무료) | 100% 익명·쿠키 X | 1KB |
| Umami | 셀프호스팅 무료 | 익명 | 2KB |
| GA4 | 무료 | 추적·동의 필요 | 50KB+ |
추가 1줄로 적용:
<script defer data-domain="patchkr.com" src="https://plausible.io/js/script.js"></script>
🤖 Open source · Built with Claude Code
