Changes for page Data Model

Last modified by Robert Schaub on 2025/12/24 20:34

From version 1.1
edited by Robert Schaub
on 2025/12/11 18:37
Change comment: Imported from XAR
To version 2.2
edited by Robert Schaub
on 2025/12/11 21:34
Change comment: Renamed back-links.

Summary

Details

Page properties
Content
... ... @@ -2,7 +2,37 @@
2 2  
3 3  This page describes the current data model for FactHarbor.
4 4  
5 +== Core Data Model Refinements ==
6 +
7 +The system relies on the following versioned core entities:
8 +
9 +* **CLAIM_CLUSTER**
10 +** ``ClusterID`` (PK), ``EmbeddingVectorRef``, ``Theme``
11 +** Groups related claims into topical clusters.
12 +
13 +* **CLAIM / CLAIM_VERSION**
14 +** ``CLAIM`` is the long‑lived anchor for a real‑world claim.
15 +** ``CLAIM_VERSION`` is an immutable snapshot of wording + basic metadata.
16 +** Verdicts are **NOT** attached to ClaimVersion but to Scenario.
17 +
18 +* **SCENARIO / SCENARIO_VERSION**
19 +** ``SCENARIO`` represents a stable interpretive context for a claim.
20 +** ``SCENARIO_VERSION`` is an immutable snapshot of that context (definitions, assumptions, boundaries).
21 +** Verdicts are attached to SCENARIO, with verdict history in VERDICT_VERSION.
22 +
23 +* **EVIDENCE / EVIDENCE_VERSION**
24 +** ``EVIDENCE`` is the logical source (report, article, dataset…).
25 +** ``EVIDENCE_VERSION`` is the extracted/processed snapshot (summary, reliability, etc.).
26 +
27 +* **VERDICT / VERDICT_VERSION**
28 +** ``VERDICT`` represents “this scenario is evaluated for this claim.”
29 +** ``VERDICT_VERSION`` is an immutable snapshot of a concrete evaluation (likelihood, confidence, reasoning, timestamp).
30 +
31 +* **SCENARIO_EVIDENCE_VERSION_LINK**
32 +** Connects ``ScenarioVersion`` ↔ ``EvidenceVersion`` (many‑to‑many).
33 +** Fields: Relevance, Direction (SUPPORTS / CONTRADICTS / NEUTRAL).
34 +** **Rule:** The link always targets VERSIONED entities, never the base tables.
35 +
5 5  == Core Data Model ERD ==
6 -The authoritative ERD is provided via the dedicated diagram page:
7 7  
8 -{{include reference="FactHarbor.Specification.Diagrams.Core Data Model ERD.WebHome"/}}
38 +{{include reference="FactHarbor.Archive.Diagrams v0\.8q.Core Data Model ERD.WebHome"/}}