Changes for page Data Model

Last modified by Robert Schaub on 2025/12/24 20:34

From version 3.1
edited by Robert Schaub
on 2025/12/11 21:35
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
... ... @@ -9,29 +9,32 @@
9 9  * **CLAIM_CLUSTER**
10 10  ** ``ClusterID`` (PK), ``EmbeddingVectorRef``, ``Theme``
11 11  ** Groups related claims into topical clusters.
12 +** One Cluster has many Claims.
13 +** A Claim belongs to exactly one primary cluster.
12 12  
13 13  * **CLAIM / CLAIM_VERSION**
14 14  ** ``CLAIM`` is the long‑lived anchor for a real‑world claim.
15 15  ** ``CLAIM_VERSION`` is an immutable snapshot of wording + basic metadata.
16 -** Verdicts are **NOT** attached to ClaimVersion but to Scenario.
18 +** **Note:** Verdicts are **NEVER** attached directly to a Claim. They are attached to Scenarios.
17 17  
18 18  * **SCENARIO / SCENARIO_VERSION**
19 19  ** ``SCENARIO`` represents a stable interpretive context for a claim.
20 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.
23 +** A single Claim may have multiple Scenarios.
22 22  
23 23  * **EVIDENCE / EVIDENCE_VERSION**
24 24  ** ``EVIDENCE`` is the logical source (report, article, dataset…).
25 -** ``EVIDENCE_VERSION`` is the extracted/processed snapshot (summary, reliability, etc.).
27 +** ``EVIDENCE_VERSION`` is the extracted/processed snapshot (summary, reliability score, extraction method).
26 26  
27 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 +** ``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.
30 30  
31 31  * **SCENARIO_EVIDENCE_VERSION_LINK**
32 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.
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.
35 35  
36 36  == Core Data Model ERD ==
37 37