Skip to Content

Changes for page Data Model

Last modified by Robert Schaub on 2025/12/24 20:34
From version 4.1
edited by Robert Schaub
on 2025/12/12 08:32
Change comment: Imported from XAR
To version 1.1
edited by Robert Schaub
on 2025/12/11 18:37
Change comment: Imported from XAR

Summary

Details

Page properties
Content
... ... @@ -2,40 +2,7 @@
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 -
39 39  == Core Data Model ERD ==
6 +The authoritative ERD is provided via the dedicated diagram page:
40 40  
41 41  {{include reference="FactHarbor.Specification.Diagrams.Core Data Model ERD.WebHome"/}}