Workstream D: AEG-X-009 Source Catalog Consolidation #25

2026-08-07T17:09:58+09:00

kjh2064 commented

2026-08-07 17:09:58 +09:00

Workstream D: AEG-X-009 Source Catalog v2.0 (Consolidated)

Summary

Master Data Source Consolidation: All 3 external APIs (KRX, OpenDart, KIS) documented
SLA & Error Handling: Formal error classification, retry policies, fallback strategy
Data Retention: Hot/cold/archive tiers (3-10 years)
Contracts: JSON Schema for source approval governance
Impact: Unblocks VS-02 (Financial Security Master) implementation

Deliverables

1. source-catalog.md v2.0 (Enhanced)

KRX OpenAPI: Endpoints, auth, SLA 99.5%, fallback procedure
OpenDart API: Financial disclosure endpoints, retry policy
KIS API: Korea Investment & Securities trading API
Error Classification: Transient (retry) vs Permanent (quarantine)
Fallback Strategy: LKG cache, max age, priority ordering
Data Retention: Hot (1 year), Cold (3 years), Archive (7-10 years)

2. source-approval.v1.json (Contract Schema)

Metadata (id, name, type, URL, auth)
Frequency & SLA definition
Retention policy
Fallback strategy with priority
Data quality rules + error classification
Approval tracking + status

3. AEG-X-009_SOURCE_CATALOG_CONSOLIDATION.md (Execution Report)

Completion summary (45 min)
Acceptance criteria: ✅ All met
Unknowns resolved: 4/4
- ✅ KRX data source: /svc/apis/idx/krx_dd_trd
- ✅ Import SLA: Daily T+0, <4 hours
- ✅ Error handling: Transient/permanent + fallback
- ✅ Audit/correction: Append-only revisions, PIT tracking
AGENTS.md v16.0: 13/13 ✅

Unknowns Resolved

For VS-02 (Financial Security Master):

✅ Data Source: KRX OpenAPI confirmed
✅ Import SLA: Daily T+0, <4 hours after market close
✅ Error Handling: Transient (retry) vs permanent (quarantine)
✅ Audit/Correction: Append-only revisions + PIT tracking

Impact

Unblocks:

VS-02 implementation (now has source catalog)
VS-03 design (references governance from E)
VS-04 design (audit framework from E/F)
Phase 2 implementation (no source unknowns)

Testing

Source endpoints documented + verified
SLA metrics validated
Error scenarios mapped
Fallback strategy documented

## Workstream D: AEG-X-009 Source Catalog v2.0 (Consolidated) ### Summary - **Master Data Source Consolidation:** All 3 external APIs (KRX, OpenDart, KIS) documented - **SLA & Error Handling:** Formal error classification, retry policies, fallback strategy - **Data Retention:** Hot/cold/archive tiers (3-10 years) - **Contracts:** JSON Schema for source approval governance - **Impact:** Unblocks VS-02 (Financial Security Master) implementation ### Deliverables #### 1. source-catalog.md v2.0 (Enhanced) - **KRX OpenAPI:** Endpoints, auth, SLA 99.5%, fallback procedure - **OpenDart API:** Financial disclosure endpoints, retry policy - **KIS API:** Korea Investment & Securities trading API - **Error Classification:** Transient (retry) vs Permanent (quarantine) - **Fallback Strategy:** LKG cache, max age, priority ordering - **Data Retention:** Hot (1 year), Cold (3 years), Archive (7-10 years) #### 2. source-approval.v1.json (Contract Schema) - Metadata (id, name, type, URL, auth) - Frequency & SLA definition - Retention policy - Fallback strategy with priority - Data quality rules + error classification - Approval tracking + status #### 3. AEG-X-009_SOURCE_CATALOG_CONSOLIDATION.md (Execution Report) - Completion summary (45 min) - Acceptance criteria: ✅ All met - Unknowns resolved: 4/4 - ✅ KRX data source: /svc/apis/idx/krx_dd_trd - ✅ Import SLA: Daily T+0, <4 hours - ✅ Error handling: Transient/permanent + fallback - ✅ Audit/correction: Append-only revisions, PIT tracking - AGENTS.md v16.0: 13/13 ✅ ### Unknowns Resolved For VS-02 (Financial Security Master): 1. ✅ **Data Source:** KRX OpenAPI confirmed 2. ✅ **Import SLA:** Daily T+0, <4 hours after market close 3. ✅ **Error Handling:** Transient (retry) vs permanent (quarantine) 4. ✅ **Audit/Correction:** Append-only revisions + PIT tracking ### Impact **Unblocks:** - VS-02 implementation (now has source catalog) - VS-03 design (references governance from E) - VS-04 design (audit framework from E/F) - Phase 2 implementation (no source unknowns) ### Testing - [x] Source endpoints documented + verified - [x] SLA metrics validated - [x] Error scenarios mapped - [x] Fallback strategy documented ### Related - Blocks: VS-02-01 (now unblocked) - Feeds into: Workstream E (governance), Workstream G (API implementation) --- **Generated with Claude Code** 🤖

kjh2064 added 1 commit 2026-08-07 17:09:59 +09:00

feat(AEG-X-009): consolidate external data source catalog with SLA/retry policies 80d1636107

Deliverables:
- Enhanced source-catalog.md v2.0: KRX/OpenDart/KIS APIs with full SLA/retention/fallback
- New source-approval.v1.json: JSON schema contract for data source governance
- New AEG-X-009_SOURCE_CATALOG_CONSOLIDATION.md: Execution summary (45 min)

Resolves VS-02 data governance unknowns:
✅ KRX listing/delisting source confirmed
✅ Import SLA documented (T+0, <4 hours)
✅ Audit/correction policy defined

Enables parallel development:
→ VS-02-01: Data governance UNBLOCKED
→ VS-03-01/04-01: Design can proceed
→ Phase 2 implementation: No source unknowns

AGENTS.md v16.0: 13/13 criteria ✅

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

kjh2064 merged commit 4e8a7bd021 into main

2026-08-07 17:18:26 +09:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: kjh2064/KArtSell.Aegis#25