feat(dotnet): add provenance contract harness

2026-07-13 00:24:44 +09:00
parent 6475ecd3b0
commit 14ced733f2
7 changed files with 208 additions and 0 deletions
@@ -0,0 +1,67 @@
+formula_id: WBS_10_DOTNET_PROVENANCE_CONTRACT_V1
+owner: QuantEngine
+status: draft
+goal: "결정/팩터/수집 provenance payload를 표준화한다."
+
+payloads:
+  - payload_id: factor_evidence
+    source: src/dotnet/QuantEngine.Application/Services/DecisionLearningService.cs
+    required_fields:
+      - FactorObservationId
+      - FactorId
+      - FactorVersion
+      - ObservedAt
+      - Gate
+      - Role
+      - SourceName
+      - PayloadJson
+      - ProvenanceJson
+    nullable_fields:
+      - NumericValue
+      - TextValue
+    pass_condition: "factor evidence payload가 누락 없이 기록됨"
+
+  - payload_id: decision_event
+    source: src/dotnet/QuantEngine.Application/Services/DecisionLearningService.cs
+    required_fields:
+      - decisionKey
+      - decidedAt
+      - instrumentId
+      - action
+      - gate
+      - sourceVersion
+    nullable_fields:
+      - score
+      - trace
+      - provenance
+    pass_condition: "decision event payload가 normalized store에 기록됨"
+
+  - payload_id: collection_audit
+    source: src/dotnet/QuantEngine.Application/Models/CollectionExecutionAudit.cs
+    required_fields:
+      - RunId
+      - State
+      - StartedAt
+      - SuccessCount
+      - ErrorCount
+    nullable_fields:
+      - FinishedAt
+      - Message
+    pass_condition: "collection audit payload가 append-only JSONL에 기록됨"
+
+  - payload_id: scheduler_audit
+    source: src/dotnet/QuantEngine.Web/Services/SchedulerModels.cs
+    required_fields:
+      - JobId
+      - RunId
+      - State
+      - StartedAt
+    nullable_fields:
+      - Reason
+      - FinishedAt
+      - ResourceKey
+    pass_condition: "scheduler audit payload가 append-only JSONL에 기록됨"
+
+notes:
+  - "provenance payload는 구조를 표준화하되, 숫자 계산은 하지 않는다."
+  - "LLM은 payload value를 재계산하지 않는다."