Skip to Content

Wiki source code of Data Model

Version 4.1 by Robert Schaub on 2025/12/12 08:32
Show last authors
1 = Data Model =
2
3 This page describes the current data model for FactHarbor.
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 == Core Data Model ERD ==
40
41 {{include reference="FactHarbor.Specification.Diagrams.Core Data Model ERD.WebHome"/}}