Skip to Content

Changes for page Data Model

Last modified by Robert Schaub on 2026/02/08 08:27
From version 3.1
edited by Robert Schaub
on 2025/12/19 14:41
Change comment: Imported from XAR
To version 4.1
edited by Robert Schaub
on 2025/12/19 14:58
Change comment: Imported from XAR

Summary

Details

Page properties
Content
... ... @@ -174,23 +174,24 @@
174 174  **Core Fields**:
175 175  * **id** (UUID): Primary key
176 176  * **scenario_id** (UUID FK): The scenario being assessed
177 -* **created_at** (timestamp): When verdict was first created
178 -
179 -**Versioned via VERDICT_VERSION**: Verdicts evolve as new evidence emerges or analysis improves. Each version captures:
180 180  * **likelihood_range** (text): Probabilistic assessment (e.g., "0.40-0.65 (uncertain)", "0.75-0.85 (likely true)")
181 181  * **confidence** (decimal 0-1): How confident we are in this assessment
182 182  * **explanation_summary** (text): Human-readable reasoning explaining the verdict
183 183  * **uncertainty_factors** (text array): Specific factors limiting confidence (e.g., "Small sample sizes", "Lifestyle confounds", "Long-term effects unknown")
184 -* **created_at** (timestamp): When this version was generated
181 +* **created_at** (timestamp): When verdict was created
182 +* **updated_at** (timestamp): Last modification
185 185  
186 -**Relationship**: Each Scenario has multiple Verdicts over time (as understanding evolves). Each Verdict has multiple versions.
184 +**Change Tracking**: Like all entities, verdict changes are tracked through the Edit entity (section 1.7), not through separate version tables. Each edit records before/after states.
187 187  
186 +**Relationship**: Each Scenario has one Verdict. When understanding evolves, the verdict is updated and the change is logged in the Edit entity.
187 +
188 188  **Example**:
189 189  For claim "Exercise improves mental health" in scenario "Clinical trials (healthy adults, structured programs)":
190 -* Initial verdict (v1): likelihood_range="0.40-0.65 (uncertain)", uncertainty_factors=["Small sample sizes", "Short-term studies only"]
191 -* Updated verdict (v2): likelihood_range="0.70-0.85 (likely true)", uncertainty_factors=["Lifestyle confounds remain"]
190 +* Initial state: likelihood_range="0.40-0.65 (uncertain)", uncertainty_factors=["Small sample sizes", "Short-term studies only"]
191 +* After new evidence: likelihood_range="0.70-0.85 (likely true)", uncertainty_factors=["Lifestyle confounds remain"]
192 +* Edit entity records the complete before/after change with timestamp and reason
192 192  
193 -**Key Design**: Separating Verdict from Scenario allows tracking how our understanding evolves without losing history.
194 +**Key Design**: Verdicts are mutable entities tracked through the centralized Edit entity, consistent with Claims, Evidence, and Scenarios.
194 194  
195 195  === 1.6 User ===
196 196  Fields: username, email, **role** (Reader/Contributor/Moderator), **reputation**, contributions_count