Skip to Content

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 4.1
edited by Robert Schaub
on 2025/12/12 08:32
Change comment: Imported from XAR

Summary

Details

Page properties
Content
... ... @@ -2,7 +2,40 @@
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 +** One Cluster has many Claims.
13 +** A Claim belongs to exactly one primary cluster.
14 +
15 +* **CLAIM / CLAIM_VERSION**
16 +** ``CLAIM`` is the long‑lived anchor for a real‑world claim.
17 +** ``CLAIM_VERSION`` is an immutable snapshot of wording + basic metadata.
18 +** **Note:** Verdicts are **NEVER** attached directly to a Claim. They are attached to Scenarios.
19 +
20 +* **SCENARIO / SCENARIO_VERSION**
21 +** ``SCENARIO`` represents a stable interpretive context for a claim.
22 +** ``SCENARIO_VERSION`` is an immutable snapshot of that context (definitions, assumptions, boundaries).
23 +** A single Claim may have multiple Scenarios.
24 +
25 +* **EVIDENCE / EVIDENCE_VERSION**
26 +** ``EVIDENCE`` is the logical source (report, article, dataset…).
27 +** ``EVIDENCE_VERSION`` is the extracted/processed snapshot (summary, reliability score, extraction method).
28 +
29 +* **VERDICT / VERDICT_VERSION**
30 +** ``VERDICT`` represents the assertion "this claim is assessed **under this specific scenario**."
31 +** ``VERDICT_VERSION`` is an immutable snapshot of the evaluation (likelihood, confidence, reasoning, timestamp).
32 +** **Cardinality:** 1 Scenario has 1 active Verdict (but many Verdict versions over time). Therefore, 1 Claim has N Verdicts.
33 +
34 +* **SCENARIO_EVIDENCE_VERSION_LINK**
35 +** Connects ``ScenarioVersion`` ↔ ``EvidenceVersion`` (many‑to‑many).
36 +** Fields: ``LinkID``, ``Relevance``, ``Direction`` (SUPPORTS / CONTRADICTS / NEUTRAL / MIXED).
37 +** **Rule:** The link always targets specific **VERSIONS** of entities, never the base tables, to ensure auditability.
38 +
5 5  == Core Data Model ERD ==
6 -The authoritative ERD is provided via the dedicated diagram page:
7 7  
8 8  {{include reference="FactHarbor.Specification.Diagrams.Core Data Model ERD.WebHome"/}}