KPubData Watch 문서¶
한국 공공데이터 API 를 지속적으로 관측하고, "이 공공데이터를 지금 믿고 사용할 수 있는가?" 를 근거와 함께 답하는 Public Data Reliability 서비스입니다.
어디서부터 읽나¶
| 문서 | 내용 |
|---|---|
| PRD | 제품 정의 · 문제 · 원칙 · 목표 · 비목표 · 성공 지표 |
| 로드맵 | MVP 범위(P0/P1/유예) · 구현 순서 · 완료 조건 · Epic · 열린 질문 · 이후 단계 |
| 도메인 모델 | Health · Check · Detection · Change · Incident |
| Detectors | Availability · Freshness · Contract · Quality |
| 아키텍처 | Probe · Observation · Scheduler · 저장 · 관측성 · 배포 |
| Registry | Dataset Registry 형식과 Dataset 선정 기준 |
| UI | UI 전략 · UI Lab · Public Status 화면 원칙 |
| 시각 정체성 | KPubData Studio Brand v2 — 로고 · 토큰 · 상태색 · 접근성 (고정) |
| 테스트 | 테스트 전략과 CI 게이트 |
| 결정 기록 | ADR 과 PRD 결정 로그 대응표 |
| API 계약 | Public Read API 와 운영자 CLI (초안, English) |
| SECURITY | 보안 신고와 credential · redaction 요구사항 (English) |
PRD¶
원래의 PRD(prd.md, v1.0 Draft, 2026-09-30)는 한 파일에 제품·설계·계약·일정이 모두 들어 있었다.
목적에 맞게 나눈 뒤 각 절이 어디로 갔는지가 아래 표다. 각 문서의 절 제목 아래 PRD §N 표시가
원문 위치를 가리킨다. Development Epic(§81–§93)과 Open Questions(§105)는 GitHub 이슈로도
관리한다.
| PRD 절 | 제목 | 문서 |
|---|---|---|
| §0 | Executive Summary | PRD |
| §1 | Product Vision | PRD |
| §2 | Problem | PRD |
| §3 | Product Principle | PRD |
| §4 | MVP Goals | PRD |
| §5 | MVP Non-Goals | PRD |
| §6 | Core Product Model | 도메인 모델 |
| §7 | Health Model | 도메인 모델 |
| §8 | Check Result Model | 도메인 모델 |
| §9 | Health Aggregation | 도메인 모델 |
| §10 | Health와 Change의 분리 | 도메인 모델 |
| §11 | Core Checks | Detectors |
| §11.1 | Availability | Availability |
| §11.2 | Freshness | Freshness |
| §11.3 | Contract | Contract |
| §11.4 | Contract Change Classification | Contract |
| §11.5 | Quality | Quality |
| §11.6 | Volume | Quality |
| §11.7 | Completeness | Quality |
| §12 | Metrics vs Health | Detectors |
| §13 | Dataset Registry | Registry |
| §14 | Provider / Dataset / Probe Model | 아키텍처 |
| §15 | Probe Principle | 아키텍처 |
| §16 | Probe Pipeline | 아키텍처 |
| §17 | Probe Result | 아키텍처 |
| §18 | Observation | 아키텍처 |
| §19 | Raw Data Storage Policy | 아키텍처 |
| §20 | Schema Snapshot | 아키텍처 |
| §21 | Detection | 도메인 모델 |
| §22 | Evidence Schema | 도메인 모델 |
| §23 | Change | 도메인 모델 |
| §24 | Incident | 도메인 모델 |
| §25 | Incident Lifecycle | 도메인 모델 |
| §26 | Incident Severity | 도메인 모델 |
| §27 | Confirmation / Flapping Protection | Detectors |
| §28 | Scheduling | 아키텍처 |
| §29 | Scheduler Architecture | 아키텍처 |
| §30 | Overall Architecture | 아키텍처 |
| §31 | Repository Structure | 아키텍처 |
| §32 | Technology Recommendation | 아키텍처 |
| §33 | UI Strategy | UI |
| §34 | UI Architecture | UI |
| §35 | UI Read Model | UI |
| §36 | UI Lab | UI |
| §37 | UI Lab Fixtures | UI |
| §38 | UI Experiment A — Status Page | UI |
| §39 | UI Experiment B — Provider Group | UI |
| §40 | UI Experiment C — Issue First | UI |
| §41 | UI Evaluation Criteria | UI |
| §42 | Public Status Information Architecture | UI |
| §43 | Public Status Page | UI |
| §44 | Search / Filtering | UI |
| §45 | Provider Grouping | UI |
| §46 | Dataset List Density | UI |
| §47 | Dataset Detail | UI |
| §48 | Why Was This Detected? | UI |
| §49 | Contract Diff UX | UI |
| §50 | History UX | UI |
| §51 | Charts | UI |
| §52 | Visual Design Principles | UI |
| §53 | Color Semantics | UI |
| §54 | Time UX | UI |
| §55 | Official Notice | UI |
| §56 | Public Read API | API 계약 (English) |
| §57 | GET /api/v1/datasets |
API 계약 (English) |
| §58 | GET /api/v1/datasets/{id} |
API 계약 (English) |
| §59 | History API | API 계약 (English) |
| §60 | Operator Interface | API 계약 (English) |
| §61 | Credentials | SECURITY (English) |
| §62 | Secret Redaction | SECURITY (English) |
| §63 | Security Requirements | SECURITY (English) |
| §64 | Monitoring Reliability | 아키텍처 |
| §65 | Watch Internal Observability | 아키텍처 |
| §66 | Database Model | 아키텍처 |
| §67 | Retention | 아키텍처 |
| §68 | Dataset Selection | Registry |
| §69 | Initial Dataset Portfolio | Registry |
| §70 | Test Strategy | 테스트 |
| §71 | Fixture Regression Tests | 테스트 |
| §72 | Replay Tests | 테스트 |
| §73 | Integration Tests | 테스트 |
| §74 | Live Tests | 테스트 |
| §75 | CI Quality Gates | 테스트 |
| §76 | Non-Functional Requirements | 아키텍처 · API 계약 |
| §77 | Deployment | 아키텍처 |
| §78 | MVP Functional Scope | 로드맵 |
| §79 | P1 — 시간이 허용하면 | 로드맵 |
| §80 | Explicitly Deferred | 로드맵 |
| §81 | Development Epics | 로드맵 |
| §82 | Epic 2 — Dataset Registry | 로드맵 |
| §83 | Epic 3 — Probe Runtime | 로드맵 |
| §84 | Epic 4 — Observation | 로드맵 |
| §85 | Epic 5 — Availability | 로드맵 |
| §86 | Epic 6 — Contract | 로드맵 |
| §87 | Epic 7 — Freshness | 로드맵 |
| §88 | Epic 8 — Quality | 로드맵 |
| §89 | Epic 9 — Incident & Health | 로드맵 |
| §90 | Epic 10 — Read API | 로드맵 |
| §91 | Epic 11 — Public Status UI | 로드맵 |
| §92 | Epic 12 — UI Lab | 로드맵 |
| §93 | Epic 13 — Production Hardening | 로드맵 |
| §94 | Definition of Done — MVP | 로드맵 |
| §95 | MVP Success Metrics | PRD |
| §96 | UI Success Metrics | PRD |
| §97 | Roadmap After MVP | 로드맵 |
| §98 | Phase 3 — Impact | 로드맵 |
| §99 | Usage Manifest — Future | 로드맵 |
| §100 | Frontend Split Decision | 로드맵 |
| §101 | Key Product Boundary | PRD |
| §102 | Final MVP Shape | PRD |
| §103 | Product Statement | PRD |
| §104 | Decision Log | 결정 기록 |
| §105 | Open Questions | 로드맵 — Open Questions · 이슈 |
| §106 | Recommended Implementation Order | 로드맵 |
| §107 | Final Principle | PRD |