코드로 말하는 매니페스토: 일본 행정 데이터와 시스템을 엔지니어 시선으로 해부하기

どうも〜おかむーです!(오카무ー입니다!) 오늘은 일본 정부·지자체의 데이터와 시스템을 코드와 엔지니어 관점에서 파헤쳐볼게요〜
- 행정 데이터, 공개는 됐지만 기계가 읽기 어려운 경우가 많다
- 표준화·공통화 정책은 진행 중이지만 구현·운영 관점의 갭 존재
- API 우선·OpenAPI·데이터 카탈로그 도입으로 실용성을 높일 수 있다
結論
요약하면, 정책 문서는 충실히 나오고(例: デジタル庁의 표준화 정책, 総務省의共通化 방침) 공개 플랫폼(ジャパン・ダッシュボードやe-Stat)이 있지만, 엔지니어 관점에서는 "기계가 바로 쓰기 좋은 데이터"로 연결되는 파이프라인이 부족하다. 要するに、公開의 질(포맷·API·メタ데ータ)과 운영(스키마 관리·SLO)이 더 중요하다는 것~
레포트 본문
これ見てくださいよ:公開状況の現場感
정부·디지털청 자료(https://www.digital.go.jp)、総務省의自治体共通化 자료(https://www.soumu.go.jp)、Japan Dashboard(https://www.digital.go.jp/resources/japandashboard)、e-Stat 대시보드(https://dashboard.e-stat.go.jp/)를 보면 데이터 자체는 많다. 근데 문제는 형태다:
- PDF/Large HTML: 사람은 읽지만 기계는 못 읽음
- CSV는 일부 존재하나 메타데이터·スキーマが不十分
- API는 곳곳에 있으나 표준화·認証·バージョン管理がバラバラ
엔지니어적으론 이게 무슨 의미냐 하면, 재사용 가능한 데이터 파이프라인을 만들기 위해 매번 파싱·클렌징을 해야 한다는 것!
정책 목표 vs 実績のギャップ
デジタル庁が示す「基幹業務システムの統一・標準化」(https://www.digital.go.jp/policies/local_governments)은 큰 그림은 맞다. 하지만 실제로:
- 마이그레이션率やAPI公開율の定量目標が不明확
- 各自治体のレガシーシステムとの互換性コストが高い
要するに、目標はあるけどKPIで追い切れていないんです。
技術적な問題点(具体的)
具体的なコード例(取り回し案)
これ見てくださいよ、e-Stat API 같은 곳からデータを取ってETLする簡単な例です。
# 예시: e-Stat風のAPIからJSONを取得してCSVに落とす(疑似コード)
import requests, csv
API_URL = 'https://api.e-stat.go.jp/rest/2.1/app/json/getStatsData'
params = {'appId': 'YOUR_APP_ID', 'statsDataId': '00000'}
resp = requests.get(API_URL, params=params)
data = resp.json()
要するに: dataの中から必要なレコードを取り出してCSV化
rows = []
for rec in data['GET_STATS_DATA']['STATISTICAL_DATA']['DATA_INF']['VALUE']:
rows.append({'year': rec.get('@time'), 'value': rec.get('#text')})
with open('out.csv', 'w', newline='') as f:
writer = csv.DictWriter(f, fieldnames=['year','value'])
writer.writeheader()
writer.writerows(rows)
このコード例で言いたいのは、APIがあれば簡単にパイプライン化できるんですよね。要するにAPIの品質が鍵!
改善提案(実務向け)
- 全省共通のOpenAPI仕様を定義して、自治体ごとのAPIも継承できるようにする
- データカタログ(CKANやDataHub)を採用して、メタデータとスキーマを管理
- PDFの時点での公開は禁止ではないが、オリジナルの機械可読データ(CSV/JSON/Parquet)を必須に
- スキーマレジストリを用いてバージョン管理と後方互換性を担保
- SLO(更新頻度、欠損率、レイテンシ)を定義して運用を可視化
技術スタックの例:
- API: OpenAPI + OAuth2 / mTLS
- データカタログ: CKAN
- ストレージ: Parquet on object storage
- ETL: Airflow / Prefect
- モニタ: Prometheus + Grafana
政策面での施策提案
- 移行補助金を「コード品質」で評価(ただのUI刷新で点を上げない)
- オープンデータの再利用を促すマッチング施策(企業→自治体)
- 標準化推進チームを中央に置き、自治体ごとにサポート要員を配置
まとめ
公開は進んでるけど、使える形での公開が足りない。エンジニア的にはAPIとメタデータが王道で、これを整えれば二次利用が爆発的に増えるんですよ!政策側の数値目標もSLOやAPI公開率に落とし込んで可視化すべきです。
おかむーから一言
テクノロジーで行政をアップデートするのは筋トレみたいなもので、継続とメンテが大事。コードで語る政治、ここから本気でやりましょう〜!
정보 출처
- https://www.zhihu.com/question/1940157301433557604
- https://www.govtechtokyo.or.jp/services/data-utilization/
- https://www.zhihu.com/question/40553450
- https://note.govtechtokyo.jp/n/n77785a8254d6
- https://bus.gov.ru/
- https://www.keiba.go.jp/
- https://www.digital.go.jp/policies/local_governments
- https://www.keiba.go.jp/KeibaWeb/TodayRaceInfo/TodayRaceInfoTop
- https://www.soumu.go.jp/menu_seisaku/chiho/jichitaijoho_system/index.html
- https://www.keiba.go.jp/live/
- https://www.kantei.go.jp/
- https://www.digital.go.jp/resources/japandashboard
- https://www.kantei.go.jp/jp/news/index.html
- https://dashboard.e-stat.go.jp/
- https://www.kantei.go.jp/jp/naikaku/index.html
공유하기
관련 리포트

コードで語るマニフェスト:自治体データとシステムをエンジニア視点で検証する
自治体データはPDFやUIに閉じがち。API-firstとJSON Schemaで再利用性を高め、ガバメントクラウドへ移行する実務ロードマップを提示します。

コードで語るマニフェスト:日本政府データの現場から見る技術検証
政府データは可視化が進むも機械可読性不足が課題。CSV/JSON/API、スキーマ、ID統一で政策検証を自動化しよう。

코드로 읽는 마니페스토: 일본 정부 데이터와 시스템을 엔지니어 관점에서 후벼파기
일본 정부 데이터의 PDF·API·메타데이터 문제를 엔지니어 관점에서 분석하고, 실무 가능한 개선안을 코드 예시와 함께 제시합니다。