Skip to Content

Changes for page Data Model

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

Summary

Details

Page properties
Content
... ... @@ -174,24 +174,23 @@
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:
177 177  * **likelihood_range** (text): Probabilistic assessment (e.g., "0.40-0.65 (uncertain)", "0.75-0.85 (likely true)")
178 178  * **confidence** (decimal 0-1): How confident we are in this assessment
179 179  * **explanation_summary** (text): Human-readable reasoning explaining the verdict
180 180  * **uncertainty_factors** (text array): Specific factors limiting confidence (e.g., "Small sample sizes", "Lifestyle confounds", "Long-term effects unknown")
181 -* **created_at** (timestamp): When verdict was created
182 -* **updated_at** (timestamp): Last modification
184 +* **created_at** (timestamp): When this version was generated
183 183  
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.
186 +**Relationship**: Each Scenario has multiple Verdicts over time (as understanding evolves). Each Verdict has multiple versions.
185 185  
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 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
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"]
193 193  
194 -**Key Design**: Verdicts are mutable entities tracked through the centralized Edit entity, consistent with Claims, Evidence, and Scenarios.
193 +**Key Design**: Separating Verdict from Scenario allows tracking how our understanding evolves without losing history.
195 195  
196 196  === 1.6 User ===
197 197  Fields: username, email, **role** (Reader/Contributor/Moderator), **reputation**, contributions_count