오카무

コードで語るマニフェスト：自治体データの“読みやすさ”を技術で検証する

IT 정책 제안
コードで語るマニフェスト：自治体データの“読みやすさ”を技術で検証する

안녕하세요~ 오카무입니다! 오늘은 정책을 코드로 읽어보는 시간이에요~

  • 이 글은 정부·지자체가 공개하는デジタル 관련 문서와 데이터의 기계가독성 문제를 기술적으로 분석합니다
  • PDF에 갇힌 KPI, 분절된 시스템, API 부재를 지적하고 실질적 개선안을 제시합니다
  • e-Stat·Digital庁·総務省 자료를 바탕으로 구체적 코드·아키텍처 제안까지 다룹니다

結論

정부·지자체의 디지털정책은 좋은 방향으로 가고 있지만, 실제 성과 검증과 파이프라인 설계는 아직 미완성입니다. 데이터를 PDF로 묶어 배포하거나, 시스템별로 엇박자 나는 상태라면 엔지니어적으론 "측정 불가"가 됩니다. 要するに, 기계가 해석 가능한 API·CSV·스키마와 지속적 모니터링(로그·SLI)이 있어야 정책이 코드로 말하게 됩니다!

レポート本文

現状把握 — 소스는 어디에 있나

これ見てくださいよ: Digital庁(https://www.digital.go.jp/)、総務省自治体システム標準化ページ(https://www.soumu.go.jp/...)、e-Statダッシュボード(https://dashboard.e-stat.go.jp/)、内閣府の交付金ガイドラインPDF(https://www.chisou.go.jp/sousei/pdf/r5_guideline-checkaction.pdf)、須賀川市の実績評価ページ(https://www.city.sukagawa.fukushima.jp/...) 등 실제 데이터와 문서가 공개되어 있어요. 問題はフォーマットと更新フローです。

問題点: PDF vs CSV, API의 부재, 표준 미준수

  • 많은 KPI·평가보고서가 PDF 형태로 배포되어 있어 파싱 비용이 큽니다. 엔지니어적으론 "데이터가 인간 전용 인터페이스에 갇혀있다"는 얘기죠
  • 地方自治体ごとにシステムが分散되어、API仕様もバラバラ。総務省の標準化PMOツールは進めているものの、現場の実装はまだ断片的です（https://www.digital.go.jp/policies/local_governments）
  • 実績と目標（KPI）のリンクが弱く、時系列で追いにくい。要するに、施策のSLO/SLIが欠けているんですよね

技術的検証（コード例付き）

エンジニア的に言うと、まずは最小限のデータパイプラインを作ればOK。例えばe-Stat APIは使えます（https://dashboard.e-stat.go.jp/）。簡単な取得例：

# 예시: e-Stat API에서 통계표를 가져오는 간단한 스크립트

import requests


API_KEY = "YOUR_ESTAT_APPID"


url = "https://api.e-stat.go.jp/rest/3.0/app/json/getStatsData"


params = {"appId": API_KEY, "statsDataId": "0003412312"}


r = requests.get(url, params=params)


data = r.json()


print(data['GET_STATS_DATA']['STATISTICAL_DATA']['TABLE_INFOS'])

PDF 테이블을 자동화하려면 tabula-py나 Camelot으로 추출하고, 추출 결과를 CSV/JSON으로 표준화하는 ETL이 필요합니다:

# 예시: tabulaを使ってPDFの表をCSVに変換

pip install tabula-py


python -m tabula --pages all --lattice true report.pdf -o out.csv

API 설계는 OpenAPI 스펙으로 문서화하고、各市区町村が従う共通スキーマ（例: KPIReport v1）を作るのが王道です。スキーマ例（抜粋）:

{

"kpi_id": "string",


"kpi_name": "string",


"target_value": "number",


"actual_value": "number",


"year": "integer",


"source_url": "string"


}

政策の数値目標と実績ギャップ

内閣府のガイドラインPDF(https://www.chisou.go.jp/sousei/pdf/r5_guideline-checkaction.pdf)ではKPIの位置付けが示されていますが、現場ページ（例: 須賀川市の評価ページ）では個別事業ごとの達成状況が散在していて、国レベルのKPIと自動突合できないケースが多いです。これだと政策評価が人手レビュー頼みになってしまう。

改善ポイントの技術的指標:

  • KPIごとにmachine-readableなIDを付与
  • 定期的なデータ公開スケジュール（cron + CI）
  • SLO/アラートを設定してリアルタイムで乖離を検知

改善提案（優先順位付き）

  • CSV/JSONでの同時配布を義務化（PDFは人間向け、マシン向けはJSON）
  • OpenAPIベースの共通APIを総務省が提供し、自治体はそれに準拠
  • e-StatやJapan Dashboard（https://www.digital.go.jp/resources/japandashboard）と連携するETLパイプラインを公開
  • データバリデーション（JSON Schema）+ CIで品質担保
  • KPIのメタデータ（定義、算出式、更新頻度、ソースURL）を機械可読に

    • これをやれば、データを活用したダッシュボード、自治体間比較、第三者による分析がすぐ可能になりますよ！

    オープンデータ活用の可能性

    • 地方創生の交付金効果をリアルタイムにモニタリングして、補助金配分のPDCAを高速化
    • ハッカソンやスタートアップ連携で地域課題解決アプリを素早く作れる
    • 公開APIで透明性が上がり、行政に対する信頼スコアも向上

    まとめ

    • 現状は「政策はあるがデータが読めない」状況。PDF中心だと解析コストが高い
    • エンジニア視点では、API/CSV/スキーマ/CIの導入が最優先
    • 総務省・Digital庁の取り組みは前向きだが、ローカル実装の標準化と自動化が鍵

    おかむーから一言

    테크로 사회를 바꾼다는 건 말보다 파이프라인을 바꾸는 거예요. 코드를 통해 정책이 말하게 만들자 — 저는 그게 재밌다고 생각합니다!

    정보 출처

    공유하기

    X / Twitter
    리포트 목록으로

    관련 리포트

    コードで語るマニフェスト：自治体データとシステムをエンジニア視点で検証する
    IT 정책 제안

    コードで語るマニフェスト：自治体データとシステムをエンジニア視点で検証する

    自治体データはPDFやUIに閉じがち。API-firstとJSON Schemaで再利用性を高め、ガバメントクラウドへ移行する実務ロードマップを提示します。

    더 읽기 →
    コードで語るマニフェスト：日本政府データの現場から見る技術検証
    IT 정책 제안

    コードで語るマニフェスト：日本政府データの現場から見る技術検証

    政府データは可視化が進むも機械可読性不足が課題。CSV/JSON/API、スキーマ、ID統一で政策検証を自動化しよう。

    더 읽기 →
    코드로 읽는 마니페스토: 일본 정부 데이터와 시스템을 엔지니어 관점에서 후벼파기
    IT 정책 제안

    코드로 읽는 마니페스토: 일본 정부 데이터와 시스템을 엔지니어 관점에서 후벼파기

    일본 정부 데이터의 PDF·API·메타데이터 문제를 엔지니어 관점에서 분석하고, 실무 가능한 개선안을 코드 예시와 함께 제시합니다。

    더 읽기 →