Kgaroo
점프의 정치학
강걸우의 AI정치놀이터
문서 홈으로

Public JSON Contracts

공개 JSON 계약과 현재 숫자 해석

점프의 정치학 웹앱은 공개 계약을 통과한 스냅샷만 읽습니다. 부족한 자료는 사람 확인을 기다리는 blocker가 아니라 신뢰도 라벨과 보류 상태로 구분합니다. 이 페이지는 어떤 공개 숫자를 기준값으로 읽고, 어떤 숫자는 참고 신호로 읽어야 하는지 분리합니다.

엔진
V1.0.5
kangaroo-jump-engine-v1.0.5
스냅샷 상태
기존 결과 유지
2026.05.15 16:25
공개 가능 상태
여론조사 반영 공개 가능
여론조사 반영
Goal 상태
입력 준비 완료
데이터 보완 0 · 신뢰도 5
릴리즈 수
1개
20260429T121012_830205Z-802e5c60

계약 파일

공개 예측 패키지

예측 화면, 요약 카드, 실험실 기준값이 읽는 공개 예측 패키지

forecast-package
읽어도 되는 공개 항목
지역별 예측, 투표율 가정, 품질 라벨, 엔진 버전
현재 상태
시·도 17개, 시군구 광역 집계 17개, 재보궐 대기 17개

공개 후보 목록

후보 명부, 후보 근거, 선거 종류별 공식 반영 범위

candidate-manifest
읽어도 되는 공개 항목
후보 수, 후보 목록, 선거 종류별 반영 범위, 출마 상태
현재 상태
후보 항목 1,521건, 검수 후보 643건, 출마 중 626건, 반영 지역 256개

공개 근거 요약

후보 근거와 여론조사 승격 상태를 공개 가능한 메타데이터로 정리

evidence-manifest
읽어도 되는 공개 항목
근거 수, 후보별 근거, 여론조사 반영 상태, 검수 대기 수
현재 상태
후보 근거 85건, 반영 여론조사 12건, 검수 대기 11건

스냅샷 업데이트

최신 스냅샷 상태와 변경 입력 요약

snapshot-update
읽어도 되는 공개 항목
결과 상태, 집계 숫자, 변경 입력, 릴리즈 정보
현재 상태
최신 결과 유지, 여론조사 반영 가능, V1.0.5 엔진

스냅샷 목록

과거 공개 스냅샷 목록과 최신 release id

snapshot-catalog
읽어도 되는 공개 항목
최신 스냅샷, 과거 스냅샷, 예측판 링크, 업데이트 링크
현재 상태
현재 release 1개

공개 준비 상태

공개 준비 상태, 실제 데이터 보완 항목, 데이터 신뢰도 라벨을 집계 정보로 정리

goal-completion-readiness
읽어도 되는 공개 항목
현재 상태, 실제 데이터 보완 항목, 데이터 신뢰도 라벨, 현재 근거
현재 상태
실제 데이터 보완 항목 0개, 신뢰도 라벨 5개

사용자 시나리오 이벤트

로그인 사용자 실험실 입력을 구조화한 private assumption

ScenarioEvent
읽어도 되는 공개 항목
scope, eventType, issueTags, magnitude, salience, confidence, reliability
현재 상태
compile_status=compiled인 입력에서만 생성, public/data 미포함

사용자 시나리오 입력

대화·파일·수치 입력과 컴파일 상태를 계정별로 보관

ScenarioInput
읽어도 되는 공개 항목
inputKind, scope, compileStatus, clarificationQuestions, compilerMode
현재 상태
프로젝트별 조회 가능, 불명확한 지역·후보·정당은 needs_clarification으로 보류

사용자 private 첨부 요약

계정별 실험실 첨부의 공개-safe 요약과 삭제 상태 확인

RawAssetSummary
읽어도 되는 공개 항목
fileName, mimeType, reliability, createdAt, summary
현재 상태
목록 조회에서 storage path와 signed URL 제외

사용자 시나리오 실행 결과

계정별 실험 run의 지역별 변화량과 설명

ScenarioRunRegionResult
읽어도 되는 공개 항목
지역, 득표율 변화, 예상 득표수, 불확실성, 대표 코호트 설명
현재 상태
사용자 본인만 조회, 공식 예측으로 승격하지 않음

계정형 실험실 계약

로그인 사용자의 실험실 데이터는 공식 공개 스냅샷과 다른 생명주기를 가집니다. 입력은 private assumption으로 저장되고, 컴파일러가 적용 범위와 사건 유형을 확인한 뒤에만 실행 가능한 `ScenarioEvent`가 됩니다. 지역·후보·정당 매핑이 불명확하면 `needs_clarification`으로 보류되며, 보류 입력은 실행 큐에 들어가지 않습니다.

Projectscenario_projects

사용자별 프로젝트와 기준 스냅샷 id를 보관합니다.

Inputscenario_inputs

대화, 파일 요약, 수치 변경과 compile status를 보관합니다.

Eventscenario_events

scope, type, direction, magnitude, salience, confidence, reliability를 가진 실행 단위입니다.

Run Resultscenario_run_region_results

득표율, 예상 득표수, 승리확률 변화, 불확실성, 설명만 노출합니다.

private 첨부 목록과 실행 결과 API는 storage path, signed URL, raw OCR 원문, 업로드 파일 내용을 반환하지 않습니다. 업로드 토큰은 파일 저장 직후에만 쓰이는 authenticated write path이며, 사용자 화면에는 요약·라벨·상태만 표시합니다.

기준값으로 읽는 공개 숫자

합성 페르소나1,000,000명

집계 시뮬레이션 표면. 개별 행은 공개하지 않음

검수 후보643건

공식 근거를 확인한 후보 항목

출마 중 후보626건

사퇴·이력 보존 항목 17건을 제외한 현재 출마 후보

후보 반영 지역256개

광역·기초·재보궐 반영 지역

검수 여론조사12건

공개 표시 요건을 통과한 NESDC 여론조사

인구 보정 총량44,519,085명

현재 official_csv 기준

참고·보류 상태로 읽는 숫자

선관위 후보 수집 이벤트0건

공식 후보 반영 숫자와 별도로 보는 수집 이력

NESDC 검수 대기11건

아직 공개 표시 요건 확인이 남은 여론조사

공식 인구 기준 행272건

MOIS 1세·성별 공식 기준의 시·도 단위 집계

기초단체장 후보 반영 지역227/220

공식 선관위 후보자 명부 기반 출마 지역

재보궐 후보 반영 지역14/14

공식 선관위 국회의원 재보궐 후보자 명부 기반 출마 지역

Goal 완료 조건과 신뢰도 라벨

현재 Goal 상태입력 준비 완료

The active goal is complete when real data blockers are empty and public-safe verification passes; data that needs more context receives a reliability label instead of becoming a person-wait blocker, and passing tests alone is not sufficient.

실제 데이터 보완 항목0개

none

공식 인구 coverage272/272

official_csv requires complete accepted/provisional coverage for every required region, age_band, and sex cell; partial accepted rows stay on forecast_electorate_proxy.

공식 인구 기준

공식·고신뢰

MOIS/KOSIS official target coverage is active.

후보 명부

공식·고신뢰

Metropolitan, municipal, and byelection candidate coverage are ready.

여론조사

공식·고신뢰

12 accepted public poll rows; legal display gate is ok.

뉴스 메타데이터

참고 신호

News is used as metadata/digest signal only; article bodies are not public forecast facts.

합성 페르소나

합성 가정

Synthetic personas are aggregate modeling inputs, not individual voter records.

goal completion readiness JSON 보기
스냅샷 노트
  • 검수 통과 입력과 검수 상태 리포트는 갱신됐고, 공개 예측 결과 패키지는 직전 스냅샷을 유지했습니다.
  • 뉴스 요약 74건과 공약 요약 176건을 최신 상태로 정리했습니다.
  • 선관위 2026 후보 수집 경로는 현재 새 후보 사실을 반환하지 않아 기존 공개 후보 기준을 유지했습니다.
  • 공개 후보 매니페스트에는 검수 통과/임시 승인 검수 후보 643건, 출마 중 후보 반영 626건, 반영 지역 256개가 있습니다.
  • 검수 통과 여론조사 12건이 공개 근거 요약에 반영되어 있습니다.
  • 공식 인구 기준은 official_target_ready 상태이며, 2026-04 official_csv 가중 인구 44,519,085명을 사용합니다.
  • 변경된 입력 묶음: 근거 매니페스트, 엔진 실행 리포트, candidate_acceptance_readiness, 여론조사 검수 준비도, goal_completion_readiness