Code the Manifesto: Technical Audit of the Digital Garden City Grants

IT Policy Proposals
Code the Manifesto: Technical Audit of the Digital Garden City Grants

どうも〜おかむーです! Today I'm diving into the Digital Garden City Nation grants (デジタル田園都市国家構想交付金) and how government data and systems are structured — from PDFs buried on ministry sites to the push for standardized local government systems.

  • Grants and KPI rules exist, but much of the evidence lives in PDFs and local reports.
  • Machine-readability and APIs are uneven; there’s clear room for a standardized open-data pipeline.
  • Small fixes (CSV + OpenAPI + basic ETL) would unlock reuse and measurable accountability.

結論

National guidance sets KPI expectations and monitoring for the Digital Garden City grants, but the actual outputs are often distributed as PDFs (e.g. chisou.go.jp reports, local evaluation PDFs). Engineer-wise, that's a huge friction point: make data machine-readable, publish APIs, use common schemas, and automate KPI calculation. That'll turn bureaucratic reporting into verifiable, reusable data.

Report

What I looked at

I checked national guideline and evaluation artifacts (examples: chisou.go.jp R6 report and guideline PDFs; digital.go.jp policy pages; local evaluation PDFs such as city.moka and Pref. Yamaguchi). These are legit public sources, but delivery is inconsistent: national policy pages explain the program and KPI requirement, while local results often arrive as PDF reports (e.g. Yamaguchi: 採択事業 2 projects, 実績額 15,289 千円).

The technical issues (short)

  • PDF-first: tables and KPI narratives are locked in PDFs. That means manual extraction or brittle scraping.
  • No canonical API: each municipality publishes differently (different fields, different granularity).
  • No stable identifiers: projects/grants lack machine-friendly IDs across documents.

Take a look at this: if you have a PDF evaluation, reuse requires manual steps. That's avoidable!

How to extract and analyze (practical)

Engineer-friendly pipeline (minimal):

1) Source PDFs -> extract tables with tabula-py/pdfplumber/Camelot

2) Normalize to CSV/JSON following a grant schema (id, project_name, kpi_name, kpi_target, kpi_actual, fiscal_year, amount_yen)

3) Publish dataset + OpenAPI endpoint + data catalog entry (CKAN or simple S3 + JSON-LD)

Example Python sketch (illustrative):

# pip install tabula-py pandas

import tabula

import pandas as pd

extract table from PDF page 3

df = tabula.read_pdf('r6_houkokusho-suishin.pdf', pages=3)[0]

normalize columns, convert yen

df['amount_yen'] = df['amount'].str.replace(',', '').astype(int) * 1000

compute KPI gap

df['kpi_gap_pct'] = (df['kpi_actual'] / df['kpi_target'] - 1) * 100

要するに、once you have CSV/JSON you can do automated KPI gap reports across municipalities.

API & schema recommendations

  • Use a small JSON Schema for grants and KPIs. Example fields above.
  • Publish OpenAPI spec and an unauthenticated GET for public reports; authenticated endpoints for internal operations.
  • License: CC-BY/CC0 and include provenance (source URL, published_date).

Operational suggestions

  • Automate ETL with Airflow/GitHub Actions: pull new PDFs, extract, diff, publish new dataset and issue changelog.
  • Validation tests: schema checks + basic sanity ranges (amount > 0, kpi_target > 0).
  • Dashboard: simple Grafana/Metabase for KPI trends and alarm when gaps exceed thresholds.

まとめ

Government is already collecting the right stuff: KPIs, budgets, evaluations. The missing link is machine-readability and standardization. Converting PDF reports into a small, enforced data schema and publishing a stable API turns rhetoric into measurable outcomes. That's low-hanging fruit with high public-value.

おかむーから一言

Tech can make accountability boring and powerful — boring meaning reliable pipelines, powerful meaning anyone can verify outcomes. Let’s push for CSV + OpenAPI + OK schema and stop treating PDFs as the final form.