Skip to Content

Wiki source code of Data Model

Version 3.1 by Robert Schaub on 2025/12/11 21:35
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
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
36 == Core Data Model ERD ==
37
38 {{include reference="FactHarbor.Specification.Diagrams.Core Data Model ERD.WebHome"/}}