About this project

# KPubData Watch **Can this public data be trusted and used right now?** > A Public Data Reliability service that continuously monitors Korean public data APIs and publishes current status and change/anomaly history with evidence. It operates on KPubData and does not depend on KPubData Builder. > > Related projects: > > - [KPubData](https://github.com/yeongseon/kpubdata) — Independent Python SDK for accessing Korean public data. The only product Watch depends on > - [KPubData Builder](https://github.com/yeongseon/kpubdata-builder) — A sibling product that creates reproducible datasets and tables with KPubData > - [KPubData Studio](https://github.com/yeongseon/kpubdata-studio) — Visual workspace for KPubData Builder [English](./README.en.md) ## What problem does it solve A public API succeeding does not mean the data is healthy. Even with `HTTP 200`, data may not have been updated for 3 days, record counts may have dropped to 60% of usual, or fields may have disappeared. ```text HTTP 200 ≠ Data Healthy ``` KPubData Watch observes not only availability but also **Freshness · Contract · Quality**, and records Expected · Observed · Difference · Rule · Evidence · Timestamp for every judgment. It does not produce results like "AI has determined something is wrong." ## Current status **MVP — Public Status (0-3 months) in preparation.** The repository skeleton and CI exist, but implementation is not yet present. The MVP goal is to continuously observe 10 actual public datasets from 3 or more providers. Implementation order and completion criteria are in [ROADMAP](docs/ROADMAP.md). ## Documentation | Document | Description | |---|---| | [PRD](docs/PRD.md) | Product definition, problems, principles, goals, non-goals, success metrics | | [ROADMAP](docs/ROADMAP.md) | MVP scope (P0/P1/deferred), implementation order, completion criteria, next steps | | [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 · Storage and deployment | | [REGISTRY](docs/REGISTRY.md) | Dataset Registry format and dataset selection criteria | | [UI](docs/UI.md) | UI strategy · UI Lab · Public Status screen principles | | [TESTING](docs/TESTING.md) | Test strategy and CI gates | | [Decision records](docs/decisions/README.md) | ADR and PRD decision log (D-001~D-020) mapping table | | [API_CONTRACT](API_CONTRACT.md) | Public Read API and operator CLI (draft) | | [SECURITY](SECURITY.md) | Security reporting, credential and redaction requirements | | [CONTRIBUTING](CONTRIBUTING.md) · [AGENTS](AGENTS.md) | Contribution methods and agent rules | The authoritative version of project management rules is in kpubdata's [POLICY.md](https://github.com/yeongseon/kpubdata/blob/main/docs/governance/POLICY.md). ## Product family | Repository | Role | |---|---| | [kpubdata](https://github.com/yeongseon/kpubdata) | Public data collection and normalization SDK — the only product Watch depends on | | [kpubdata-builder](https://github.com/yeongseon/kpubdata-builder) | Dataset pipeline and deployment — sibling product of Watch, not a dependency | | [kpubdata-studio](https://github.com/yeongseon/kpubdata-studio) | Builder's screens and workflows | | **kpubdata-watch** | Public data reliability observation and Public Status — this repository | ## License [MIT](LICENSE)