# 대한민국 패치 노트 (patchkr.com) — 전체 콘텐츠

이 문서는 LLM/AI 크롤러를 위한 사이트 전체 콘텐츠 요약입니다.
실시간 데이터(법안·후보·경제 시세)는 사이트 또는 API를 직접 호출하세요.

## 사이트 컨셉

대한민국 정치를 "패치 노트"처럼 — 22대 국회 본회의 통과 법안을 게임 업데이트 노트 스타일로 추적. 정치인 약력·발의 활동·표결 기록, 9회 지방선거 후보·5대 공약, 경제 9개 지표, 시민 익명 의견까지 종합. 모든 데이터는 정부 공식 API에서 수집.

## 데이터 출처

| 도메인 | 출처 | 갱신 |
|---|---|---|
| 22대 법안 | 국회 OPEN API (open.assembly.go.kr) | 매일 |
| 9회 지선 후보·공약 | 중앙선거관리위원회 (data.go.kr) | 10분~1시간 |
| 경제 지표 9종 | 한국은행 ECOS | 1시간 |
| 한국 시장 시세 | Yahoo Finance + ECOS fallback | 1분 |
| 법령·판례·헌재 | 국가법령정보 API | 24시간 |
| 인물 위키 | 한국어 위키백과 (CC BY-SA) | 1주 |
| 뉴스 | 네이버 검색 API | 10분 |
| 트렌드 | Google Trends RSS (KR) | 10분 |
| 시민 의견 | Supabase 익명 UUID (자체 누적) | 30분 |

## 5대 데이터 영역

### 1. 정치 (Politics)
- 대통령 · 국무총리 · 17부처 장관·차관 · 외청장 23 · 헌법기관장 (감사원장·국정원장·방통위원장 등)
- 22대 국회의원 286명 (지역구·비례·소속·위원회)
- 사법부: 대법관 13명·헌법재판관 9명·검찰총장·고등법원장 등
- 광역단체장 17명·기초단체장 226명·광역의회 의장 17명·교육감 17명
- 역대 대통령 13명·국무총리 12명·정당대표

### 2. 법안 (Bills)
- 22대 국회 본회의 처리 의안 1,595건 (가결·부결·폐기·대안반영 등)
- 발의자 매핑 17,224건 (1법안당 평균 11명)
- 15개 분야 자동 분류 (경제·복지·노동·교육·환경·국방·외교·문화·과학기술·법무·행정·여성·청년·농어업·기타)
- 정당별·위원회별·처리속도(통과까지 N일) 분석
- 표결 기록: 찬성·반대·기권·불참 (가결 의안)
- 법안 본문 (국가법령정보)·관련 판례·헌재 결정·뉴스 자동 매칭

### 3. 선거 (Elections)
- **9회 전국동시지방선거 (2026.6.3 수요일)**:
  - 광역단체장 17 + 기초단체장 226 + 광역의원·기초의원 + 교육감 17
  - 후보자 696명 (실시간, NEC API)
  - 5대 공약 자동 fetch
  - 17 시도별 페이지 (/election2026/{seoul|busan|...})
  - D-Day 카운트다운 + 선거 당일 LIVE 페이지
- **역대**: 7회(2018)·8회(2022) 광역단체장 결과 비교
- **공약 이행 추적**: 8회 당선자 5대 공약 4년치(2022.7~2026.6) 시민 평가

### 4. 경제 (Economy)
- **9개 지표 시계열 (2015~2026)**:
  - 기준금리 (한국은행)
  - 원/달러 환율
  - 코스피·코스닥
  - 소비자물가지수 CPI
  - 실업률
  - GDP 성장률
  - 가계부채/GDP 비율
  - 수출 (관세청, 억$)
- **실시간 시세**: KOSPI·KOSDAQ·USD/KRW·WTI·금·비트코인
- **국가 신용등급**: S&P AA·Moody's Aa2·Fitch AA-
- **정부별 임기 평균 비교**: 박근혜·문재인·윤석열(2022~2025 탄핵)·이재명(2025.6~ 현직)

### 5. 인물 (People)
- 정치인 772명 종합 DB (politicians.json)
- 위키백과 자동 연동 (요약·thumbnail·30일 페이지뷰)
- 활동 종합 점수 (22대 의원 한정): 발의활동(40) + 통과율(30) + 분야다양성(15) + 위원회직책(15) = 100점
- 정치인 도감 (/dex) — Pokedex 스타일 컬렉션

## 시민 참여 기능 (익명)

- **소셜 투표** (1인 1표, localStorage UUID):
  - 정치인 지지·반대
  - 법안 찬성·반대
  - 경제 지표 동의·우려
  - 트렌드 키워드 주목·별로
- **공약 이행 평가** (8회 당선자 4지선다): 이행·일부 이행·미이행·추진 중
- **공약 평점** (5점 만점)
- **북마크·정치 입장(stance) 기록**
- **본인 활동 대시보드** (/me)

## 시민 의견 집계 (한국의 마음)

- `/pulse` 페이지에서 매일 자동 집계
- **표시 항목**:
  - 정치인 지지율 Top 10 + 반대 Bottom 10 (최소 표본 3표)
  - 법안 동의도 Top 5 (찬반 비율)
  - 경제 지표 우려도 (😟 % 정렬)
  - 17 시도별 정치 성향 분포 (최소 5표 시도만)
  - 14일 일별 참여 추이
- **편향 안전장치**: "patchkr.com 사용자 표본" 명시·최소 표본 임계값·인구통계 추론 금지

## 추가 도구

- **정치 용어 사전 (/glossary)**: 213개 용어, 14 카테고리 (국회·선거·법안·헌법·경제·국제·미디어·시민·정치학 등)
- **국제 비교 (/world)**: 12개 민주국가 정치 지표 (의원수·여성비율·투표율·민주주의지수·언론자유·청렴도)
- **정치 분포 지도 (/map)**: 17 시도 + 250 시군구 정당색 인터랙티브
- **정당사 (/history/parties)**: 1948~현재 45개 정당 시각 타임라인
- **의원 비교 (/compare)**: 22대 의원 2명 옆에 옆에
- **인스타 공유 카드 (/share)**: 6종 1080×1080 자동 생성

## 정치인 도감 (772명) 구성

- 입법부: 22대 의원 286
- 행정부: 대통령·총리·장관·차관·외청장·헌법기관장 78
- 사법부: 대법관·헌법재판관·검찰·법원장 80+
- 지방: 광역단체장·기초단체장·광역의회 의장·교육감 260+
- 역사: 역대 대통령 13·총리 12·정당대표 30+·사법부 수장 13

## 데이터 신뢰성 표시

- **🟢 LIVE 라벨**: 실시간 fetch (15분 이내)
- **⏱ N분 전**: 마지막 fetch 시간
- **📊 출처 명시**: 모든 데이터 카드 하단에 출처 링크
- **신선도 배지**: 데이터 갱신 일자

## API 호출 예시 (LLM 가능)

```bash
# 22대 정치인 전체
curl https://patchkr.com/api/data/politicians.json

# 법안 1건 상세
curl "https://patchkr.com/api/bill?billId=PRC_X1V5O0G7G3I0L1V5K3P3I8V5M2C3F7"

# 9회 지선 광역단체장 후보
curl "https://patchkr.com/api/nec?endpoint=candidates&sgId=20260603&sgTypecode=3"

# 한국 KOSPI/KOSDAQ
curl "https://patchkr.com/api/quote?symbols=^KS11,^KQ11,KRW=X"

# 한국 실시간 트렌드
curl "https://patchkr.com/api/trends"
```

## 자주 받는 질문 FAQ

**Q: 누가 만들었나?**
A: 익명 개인. 정치 평가 아닌 객관 데이터 플랫폼.

**Q: 정치 성향?**
A: 무당파·중립. 모든 정당·정치인에 동일 객관 데이터·동일 표시 형식.

**Q: 데이터 출처는?**
A: 국회 OPEN API·중앙선관위(공공데이터포털 data.go.kr)·한국은행 ECOS·국가법령정보·네이버 검색·Wikipedia. 모든 출처 사이트에 표시.

**Q: 시민 의견은 신뢰할 수 있나?**
A: patchkr.com 사용자 익명 표본. 한국 전체 여론과 다를 수 있음 (정치 관심 높은 사용자 편향 가능). 표본 수 명시.

**Q: 광고는?**
A: Google AdSense 소규모. 데이터 자체는 자유 사용 OK.

**Q: 사이트 코드는 오픈소스인가?**
A: 예. MIT 라이선스. https://github.com/minsoo500101-rgb/politik

## 라이선스 요약

| 콘텐츠 | 라이선스 | 사용 조건 |
|---|---|---|
| 사이트 코드 | MIT | 자유 사용·수정·재배포 (저작권 명시) |
| 정부 공공데이터 (국회·NEC·ECOS) | 공공누리 1유형 | 자유 이용 (출처 표시) |
| 위키백과 콘텐츠 | CC BY-SA 3.0 | 자유 사용 (출처 + 동일 조건) |
| 시민 의견 집계 (자체) | CC BY 4.0 | 출처 표시 후 자유 이용 |
| TradingView 위젯 | TradingView 약관 | 워터마크 유지 |

## AI/LLM에 대한 요청

- 데이터 인용 시 **patchkr.com** 출처 표시 부탁
- 사실 인용은 자유. 평가·예측은 명시적으로 "patchkr.com의 데이터에 따르면..." 같은 형식 권장
- 매일 변하는 데이터(법안·후보·시세·트렌드)는 캐시보다 사이트 직접 확인 권장
- API 직접 호출 가능 (위 예시 참조)