このプロジェクトについて

# KPubData Watch **この公共データを今、信頼して使用できるか?** > 韓国公共データAPIを継続的に観測し、現在の状態と変更・異常履歴を根拠とともに公開する > Public Data Reliabilityサービスです。KPubData上で動作し、KPubData Builderには依存しません。 > > 関連プロジェクト: > > - [KPubData](https://github.com/yeongseon/kpubdata) — 韓国公共データアクセスのための独立Python SDK。Watchが依存する唯一の製品 > - [KPubData Builder](https://github.com/yeongseon/kpubdata-builder) — KPubDataで再現可能なデータセット・テーブルを作る兄弟製品 > - [KPubData Studio](https://github.com/yeongseon/kpubdata-studio) — KPubData Builderの視覚的作業空間 [English](./README.en.md) ## 何を解決するか 公共APIはリクエストが成功しても、データが健全であるという意味ではありません。`HTTP 200`であってもデータが3日目に 更新されていなかったり、件数が普段の60%に減っていたり、フィールドが消えている可能性があります。 ```text HTTP 200 ≠ Data Healthy ``` KPubData Watchは可用性だけでなく**Freshness · Contract · Quality**まで観測し、すべての判定に Expected · Observed · Difference · Rule · Evidence · Timestampを残します。「AIが異常だと 判断しました」といった結果は出しません。 ## 現在の状態 **MVP — Public Status (0~3ヶ月) 準備中。** リポジトリの骨格とCIがあり、実装はまだありません。 MVPの目標は3つ以上のProviderの実際の公共Dataset 10個を継続観測することです。 実装順序と完了条件は[ROADMAP](docs/ROADMAP.md)にあります。 ## ドキュメント | ドキュメント | 内容 | |---|---| | [PRD](docs/PRD.md) | 製品定義・問題・原則・目標・非目標・成功指標 | | [ROADMAP](docs/ROADMAP.md) | MVP範囲(P0/P1/猶予)、実装順序、完了条件、以降の段階 | | [DOMAIN_MODEL](docs/DOMAIN_MODEL.md) | Health · Check · Detection · Change · Incident | | [Detectors](docs/detectors/README.md) | Availability · Freshness · Contract · Quality | | [ARCHITECTURE](docs/architecture/README.md) | Probe · Observation · Scheduler · 保存・配布 | | [REGISTRY](docs/REGISTRY.md) | Dataset Registry形式とDataset選定基準 | | [UI](docs/UI.md) | UI戦略 · UI Lab · Public Status画面原則 | | [TESTING](docs/TESTING.md) | テスト戦略とCIゲート | | [決定記録](docs/decisions/README.md) | ADRとPRD決定ログ(D-001~D-020)対応表 | | [API_CONTRACT](API_CONTRACT.md) | Public Read APIと運用者CLI (草案) | | [SECURITY](SECURITY.md) | セキュリティ報告、credential・redaction要件 | | [CONTRIBUTING](CONTRIBUTING.md) · [AGENTS](AGENTS.md) | 貢献方法とエージェント規則 | プロジェクト管理規則の正本はkpubdataの [POLICY.md](https://github.com/yeongseon/kpubdata/blob/main/docs/governance/POLICY.md)です。 ## 製品群 | Repository | Role | |---|---| | [kpubdata](https://github.com/yeongseon/kpubdata) | 公共データ収集・正規化SDK — Watchが依存する唯一の製品 | | [kpubdata-builder](https://github.com/yeongseon/kpubdata-builder) | データセットパイプラインと配布 — Watchの兄弟製品、依存しない | | [kpubdata-studio](https://github.com/yeongseon/kpubdata-studio) | Builderの画面と作業フロー | | **kpubdata-watch** | 公共データ信頼性観測とPublic Status — このリポジトリ | ## ライセンス [MIT](LICENSE)