Wiki source code of Data Model
Version 4.1 by Robert Schaub on 2025/12/12 08:32
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | = Data Model = |
| 2 | |||
| 3 | This page describes the current data model for FactHarbor. | ||
| 4 | |||
| |
2.1 | 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. | ||
| |
4.1 | 12 | ** One Cluster has many Claims. |
| 13 | ** A Claim belongs to exactly one primary cluster. | ||
| |
2.1 | 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. | ||
| |
4.1 | 18 | ** **Note:** Verdicts are **NEVER** attached directly to a Claim. They are attached to Scenarios. |
| |
2.1 | 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). | ||
| |
4.1 | 23 | ** A single Claim may have multiple Scenarios. |
| |
2.1 | 24 | |
| 25 | * **EVIDENCE / EVIDENCE_VERSION** | ||
| 26 | ** ``EVIDENCE`` is the logical source (report, article, dataset…). | ||
| |
4.1 | 27 | ** ``EVIDENCE_VERSION`` is the extracted/processed snapshot (summary, reliability score, extraction method). |
| |
2.1 | 28 | |
| 29 | * **VERDICT / VERDICT_VERSION** | ||
| |
4.1 | 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. | ||
| |
2.1 | 33 | |
| 34 | * **SCENARIO_EVIDENCE_VERSION_LINK** | ||
| 35 | ** Connects ``ScenarioVersion`` ↔ ``EvidenceVersion`` (many‑to‑many). | ||
| |
4.1 | 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. | ||
| |
2.1 | 38 | |
| |
1.1 | 39 | == Core Data Model ERD == |
| 40 | |||
| |
3.1 | 41 | {{include reference="FactHarbor.Specification.Diagrams.Core Data Model ERD.WebHome"/}} |