標準化をコードで守る：自治体基幹系のための契約テストとスキーマガバナンス

どうも〜おかむーです！今日は自治体システム標準化の“運用フェーズ”にフォーカスして、エンジニア視点で実践的に話していきますよ〜

• 3行要約

- 地方公共団体の基幹業務システム標準化は法制化・方針化が進んでいる（digital.go.jp、soumu.go.jp参照）。

- 実現にはスキーマガバナンスと契約テストをコード化してCIで回す運用が有効！

- 提案：OpenAPI/JSON Schema＋契約テスト＋中央スキーマレジストリで互換性と監査性を担保する。

結論

地方自治体の「標準準拠」は紙やガイドラインで語るだけだと継続しない。エンジニア的に言うと、仕様はコード化してCIで守る仕組みを作るのが最短だと思うんです。要するに「仕様をテストに落とし、デプロイ前に壊れないことを保証する」ことが運用の肝です！

レポート本文

背景これ見てくださいよ：デジタル庁の施策や総務省の標準化推進（digital.go.jp、soumu.go.jp）では“標準準拠システム”の利用義務化が進んでる。でも現場は多様なレガシー、PDFやバイナリ報告、API未整備が混在しているんですよね（e-gov APIカタログや東京都オープンデータも現状は混合）。

技術的課題

• スキーマの変化がサービス停止を招くリスク
• 各自治体ごとのローカル差分で互換性が壊れる
• ドキュメントと実装の乖離（PDF仕様書と実運用のズレ）

提案：契約テスト（Contract Testing）＋スキーマガバナンス

1) スキーマを「単一の真実」にする

- OpenAPI/JSON SchemaでAPIとデータモデルを定義する

- スキーマを中央レジストリに登録（例：Confluent風レジストリかOSS）

2) 契約テストをCIで回す

- サービス提供側はAPIのレスポンスを常にスキーマ検証するテストを持つ

- 利用側（自治体）は受け入れテストで期待するフィールドが消えていないかチェック

3) バージョニングと互換性ルール

- セマンティックバージョンで破壊的変更はメジャーアップのみ

- マイグレーション用のFeature Flags / データ移行ジョブを準備

コード例（抜粋）: PythonでOpenAPI/JSON Schemaを検証する簡単なテスト（CIで回す想定）

# tests/test_contract.py
import requests
from jsonschema import validate

OPENAPI_SCHEMA = 'https://schemas.example.jp/resident_record.schema.json'
API_ENDPOINT = 'https://api.city.example.jp/v1/residents/123'

def test_resident_record_contract():
r = requests.get(API_ENDPOINT, timeout=5)
assert r.status_code == 200
data = r.json()
schema = requests.get(OPENAPI_SCHEMA).json()
validate(instance=data, schema=schema)

エンジニア的に言うと、このテストを各自治体のリポジトリに置いておけば、API変更で壊れたらPRで弾けるんですよね。さらにモックサーバー（OpenAPI Mock）を提供して、外部ベンダーの開発効率も上げられる。

運用プラクティス

• スキーマレジストリには「変更ログ」を必須化。誰がいつどう変えたかを追えること（監査対応）
• デプロイ前に必ず契約テスト→ステージング検証→本番ロールアウト
• e-GovやJapan Dashboard等の既存APIは、APIカタログ（e-gov.go.jp, dashboard.e-stat.go.jp）と連携して互換性チェックを自動化

実装上の注意点

• CSVやPDFが残る領域は、変換パイプライン（ETL）をコード化してテスト可能にする
• 小自治体向けにテストテンプレートとホスティングされたモック環境を提供すると導入障壁が下がる

メリット

• 変更の安全性が担保され、運用コストが下がる
• データ連携の信頼性が上がり、オープンデータの二次利用が進む

まとめ

法制度や標準仕様の整備は進んでいるけど、実務で効くのは「コード化された運用ルール」だと思います。OpenAPI/JSON Schemaで仕様を一本化し、契約テストをCIに組み込み、スキーマレジストリで変更を管理する――これで自治体基幹系の標準化は初めて現場で効く形になりますよ！

おかむーから一言

起業と現場経験から言うと、仕様は“言葉”じゃなく“テスト”で守るのが最速です。テクノロジーで行政をアップデートしましょう、俺も一緒にやりますよ！