Initial commit: Add project files

2026-08-02 05:15:36 +09:00
commit dcd1322d41
636 changed files with 122352 additions and 0 deletions
@@ -0,0 +1,17 @@
+# 데이터 의미·PIT·이력성 하드닝
+
+## 계층
+
+L0 Source/License → L1 Raw append-only → L2 Canonical PIT/revision → L3 DQ/Quarantine/Lineage → L4 Feature/Forecast/Risk/Evidence → L5 Ledger/Decision/Review/Publish/Outcome → L6 Read Model → L7 Backtest/Release Artifact.
+
+## v12.3 의미 버전
+
+`weight_semantics_version=1`은 v12.2 이전 ambiguous backfill이다. `version=2`만 종목 전체 비중과 대상 Lot 비중이 독립 원천에서 명시된 것으로 인정한다. 기존 데이터를 같다고 추정하지 않고 Projection/Evidence를 재구축한다.
+
+## 정규화/역정규화
+
+원장·Lot·Fill·현금·비용 schedule은 3NF, unique source key, reversal/correction을 사용한다. 역정규화는 Owner/ProjectionVersion/Watermark/Rebuild/Staleness가 있는 Read Model에만 허용한다.
+
+## 필수 필드
+
+source_event_time, published_at, ingested_at, effective_from/to, revision_no, source_id, content_hash, dataset_id, tradable_session, quality_status를 보존한다.