这个项目能做什么

# 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 的 10 个真实公共 Dataset。 实现顺序和完成条件见 [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) | 贡献方式与 agent 规则 | 项目管理规则的权威版本是 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)