Code-driven Manifest: Auditing Japan's Public Data Stack

IT Policy Proposals
Code-driven Manifest: Auditing Japan's Public Data Stack
  • Quick takeaways:
- Japan now exposes a centralized "Japan Dashboard" (Digital Agency) but many sources remain fragmented across e-Stat, prefectural CKAN, and municipal portals.

- Machine-readability is uneven: CSV/GeoJSON and CKAN coexist with PDFs and ad-hoc Excel files — so reproducible analysis still requires glue code.

- Practical fixes: API-first publishing, DCAT/CSVW metadata, schema validation and CI for data quality can close the policy → evidence gap.

結論

How to say it simply: Japan has the right building blocks (Digital Agency's Japan Dashboard, e-Stat, Tokyo's open-data catalog, CKAN instances) but the integration and machine-readability needed for rigorous, code-driven policy verification are not yet consistent. エンジニア的に言うと、API contracts and metadata matter more than pretty dashboards.

Report

Hey — Okamu here! Let’s walk through what’s live and what an engineer would fix first.

What exists

  • Japan Dashboard (Digital Agency): centralized dashboards publishing public statistics (https://www.digital.go.jp/resources/japandashboard). Nice single entrypoint, intended to unite economic/finance/population dashboards.
  • e-Stat (Statistics Bureau): core official statistics with graphing and API hints (https://dashboard.e-stat.go.jp/ and https://www.stat.go.jp). This is the canonical dataset pool.
  • Municipal catalogs: Tokyo Open Data portal (https://portal.data.metro.tokyo.lg.jp/, https://catalog.data.metro.tokyo.lg.jp/) and many cities run CKAN (e.g., Daisen city CKAN). These provide CSV/GeoJSON but with varying schema quality.

Data quality & machine-readability — code sees the pain

これ見てくださいよ: often the most critical KPI or evaluation lives in a PDF (see some prefectural reports on digital grant outcomes). From an engineering view PDFs are black boxes. 要するに、PDF = manual extraction, non-reproducible.

Concrete issues observed

  • Mixed formats: CSV/GeoJSON and PDFs/Excel coexist. No uniform content negotiation.
  • Metadata gaps: license, update cadence, column semantics missing or inconsistent across municipalities.
  • API inconsistencies: Some CKAN-powered catalogs provide full API; others only allow downloads. Japan Dashboard aggregates visuals but not always a documented API for bulk retrieval.
  • KPI opacity: Grants like the Digital Garden City subsidies publish evaluation PDFs; machine-readable KPIs would let independent verification compare targets vs outcomes programmatically.

Quick code snippets (practical)

  • Fetching a CKAN dataset (Python):

import requests

import pandas as pd

r = requests.get('https://catalog.data.metro.tokyo.lg.jp/api/3/action/package_show', params={'id':'dataset-id'})

meta = r.json()['result']

url = meta['resources'][0]['url']

df = pd.read_csv(url)

  • Verifying KPI achievement (pseudo):

load published_kpis.csv and actuals.csv

compare with vectorized pandas math; flag discrepancies > tolerance

These are trivial automation wins but need consistent endpoints.

Recommendations (engineer-first)

1) API-first publishing: every dashboard must expose a RESTful bulk API (OpenAPI spec) plus dataset endpoints for CSV/JSON/GeoJSON.

2) Standard metadata: require DCAT + CSVW/JSON-LD describing schema, license, last_updated, source_id. Tokyo already signals municipal standard datasets — adopt and enforce that across prefectures.

3) Machine-readable KPIs: publish program KPIs as structured data (CSV/JSON) alongside narrative reports so outcomes can be objectively computed.

4) Data CI & validation: run pipelines with Great Expectations or Data Package Pipelines that validate schema, value ranges, and timeliness before publishing.

5) Reproducible analytics: host example Jupyter notebooks in a public repo that pull from the Dashboard/e-Stat and reproduce official charts — makes claims auditable.

Policy gap example

  • The Digital Garden City grant evaluations (found in prefectural PDFs) sometimes rely on self-reported, mechanically-scored documents. If those KPI results were published as structured time-series, we could compute attainment rates across municipalities and detect over/under-performance programmatically.

Implementation roadmap (practical steps)

  • Phase 1 (30–90 days): Inventory endpoints (crawl e-Stat, Japan Dashboard, municipal CKANs), publish an index.json with dataset metadata.
  • Phase 2 (3–6 months): Add CSVW manifests and OpenAPI specs for major datasets; create sample notebooks reproducing 3 flagship indicators.
  • Phase 3 (6–12 months): Automate data CI and a public metrics portal that surfaces KPI attainment with raw data and reproducible code links.

まとめ

Japan’s public data ecosystem is reaching maturity: central dashboards and municipal CKANs are in place, but without consistent machine-readable contracts and KPI publishing, independent verification is painful. エンジニア的に言うと、pretty charts are the last mile — the real work is in APIs, metadata, and pipelines.

おかむーから一言

I’ve built product teams that ship data pipelines — you don’t need magic, just standards and CI. Let’s push the government to publish KPIs as data, not PDFs. Tech can make democracy more auditable, and that’s why I’m fired up about this!