feat(dotnet): add read model contract harness

2026-07-13 00:41:30 +09:00
parent c852ad49cf
commit d610ecb57c
7 changed files with 193 additions and 0 deletions
@@ -1475,6 +1475,7 @@ WBS-8.8 (KIS 리팩터) — 독립적 (원격 병행)
 > idempotency contract: [WBS_10_DOTNET_IDEMPOTENCY_CONTRACT.yaml](./WBS_10_DOTNET_IDEMPOTENCY_CONTRACT.yaml)
 > ci/cd chain contract: [WBS_10_DOTNET_CICD_CHAIN_CONTRACT.yaml](./WBS_10_DOTNET_CICD_CHAIN_CONTRACT.yaml)
 > domain parity backlog: [WBS_10_DOTNET_DOMAIN_PARITY_BACKLOG.yaml](./WBS_10_DOTNET_DOMAIN_PARITY_BACKLOG.yaml)
+> read model contract: [WBS_10_DOTNET_READ_MODEL_CONTRACT.yaml](./WBS_10_DOTNET_READ_MODEL_CONTRACT.yaml)

 > 현황 진단(2026-06-26): .NET 프로젝트는 Python 엔진(41 모듈, 14,500 LOC) 대비 5~10%(~1,400 LOC) 수준.
 > Domain 계산기 6개·데이터 모델 8개·KIS/Naver/Yahoo 클라이언트·PostgreSQL 마이그레이션·Razor Pages 어드민 대시보드 기본 구현 완료.
@@ -0,0 +1,54 @@
+formula_id: WBS_10_DOTNET_READ_MODEL_CONTRACT_V1
+owner: QuantEngine
+status: draft
+goal: "운영 화면과 조회 API의 read model 경계를 분리한다."
+
+read_models:
+  - model_id: dashboard_summary
+    purpose: "운영 대시보드 상태"
+    source: QuantEngine.Infrastructure.Repositories.CollectionRepository
+    consumers:
+      - src/dotnet/QuantEngine.Web/Pages/Admin/Dashboard/Index.cshtml.cs
+      - src/dotnet/QuantEngine.Web/Endpoints/CollectionEndpoints.cs
+    fields:
+      - LastRunId
+      - LastRunAt
+      - SuccessCount
+      - ErrorCount
+      - SnapshotCount
+    staleness_budget: "5m"
+  - model_id: collection_runs
+    purpose: "최근 수집 실행 이력"
+    source: QuantEngine.Infrastructure.Repositories.CollectionRepository
+    consumers:
+      - src/dotnet/QuantEngine.Web/Pages/Admin/Collection/Index.cshtml.cs
+      - src/dotnet/QuantEngine.Web/Endpoints/CollectionEndpoints.cs
+    fields:
+      - RunId
+      - State
+      - StartedAt
+      - FinishedAt
+      - SuccessCount
+      - ErrorCount
+    staleness_budget: "5m"
+  - model_id: price_history_summary
+    purpose: "가격 히스토리 요약"
+    source: QuantEngine.Infrastructure.Repositories.CollectionRepository
+    consumers:
+      - src/dotnet/QuantEngine.Web/Pages/Admin/Collection/Index.cshtml.cs
+      - src/dotnet/QuantEngine.Web/Endpoints/CollectionEndpoints.cs
+    fields:
+      - Ticker
+      - Count
+      - FirstDate
+      - LastDate
+    staleness_budget: "15m"
+
+rules:
+  - "read model은 조회 전용이어야 한다."
+  - "운영 화면은 직접 원장 테이블을 조립하지 않는다."
+  - "쓰기 로직은 read model에 의존하지 않는다."
+  - "staleness_budget이 명시되지 않은 조회는 금지한다."
+
+notes:
+  - "의도된 역정규화는 허용하되, 원장과 동일 테이블로 재사용하지 않는다."