Skip to Content

Changes for page Data Model

Last modified by Robert Schaub on 2025/12/24 21:46
From version 4.1
edited by Robert Schaub
on 2025/12/19 14:58
Change comment: Imported from XAR
To version 1.1
edited by Robert Schaub
on 2025/12/18 12:03
Change comment: Imported from XAR

Summary

Details

Page properties
Content
... ... @@ -157,6 +157,8 @@
157 157  * **description** (text): Human-readable description of the scenario
158 158  * **assumptions** (JSONB): Key assumptions that define this scenario context
159 159  * **extracted_from** (UUID): Reference to evidence that this scenario was extracted from
160 +* **verdict_summary** (text): Compiled verdict for this scenario
161 +* **confidence** (decimal 0-1): Confidence level for verdict in this scenario
160 160  * **created_at** (timestamp): When scenario was created
161 161  * **updated_at** (timestamp): Last modification
162 162  **How Found**: Evidence search → Extract context → Create scenario → Link to claim
... ... @@ -166,34 +166,7 @@
166 166  * Scenario 2: "Real-world data (diverse population, Omicron variant)" from hospital data
167 167  * Scenario 3: "Immunocompromised patients" from specialist study
168 168  **V2.0 Evolution**: Many-to-many relationship can be added if users request cross-claim scenario sharing. For V1.0, keeping scenarios tied to single claims simplifies queries and reduces complexity without limiting functionality.
169 -
170 -=== 1.5 Verdict ===
171 -
172 -**Purpose**: Assessment of a claim within a specific scenario context. Each verdict provides a conclusion about whether the claim is supported, refuted, or uncertain given the scenario's assumptions and available evidence.
173 -
174 -**Core Fields**:
175 -* **id** (UUID): Primary key
176 -* **scenario_id** (UUID FK): The scenario being assessed
177 -* **likelihood_range** (text): Probabilistic assessment (e.g., "0.40-0.65 (uncertain)", "0.75-0.85 (likely true)")
178 -* **confidence** (decimal 0-1): How confident we are in this assessment
179 -* **explanation_summary** (text): Human-readable reasoning explaining the verdict
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
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.
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 -**Example**:
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
193 -
194 -**Key Design**: Verdicts are mutable entities tracked through the centralized Edit entity, consistent with Claims, Evidence, and Scenarios.
195 -
196 -=== 1.6 User ===
171 +=== 1.5 User ===
197 197  Fields: username, email, **role** (Reader/Contributor/Moderator), **reputation**, contributions_count
198 198  === User Reputation System ==
199 199  **V1.0 Approach**: Simple manual role assignment
... ... @@ -249,8 +249,8 @@
249 249  * Threshold-based promotions
250 250  * Reputation decay for inactive users
251 251  * Track record scoring for contributors
252 -See [[When to Add Complexity>>Test.FactHarbor.Specification.When-to-Add-Complexity]] for triggers.
253 -=== 1.7 Edit ===
227 +See [[When to Add Complexity>>FactHarbor.Specification.When-to-Add-Complexity]] for triggers.
228 +=== 1.6 Edit ===
254 254  **Fields**: entity_type, entity_id, user_id, before_state (JSON), after_state (JSON), edit_type, reason, created_at
255 255  **Purpose**: Complete audit trail for all content changes
256 256  === Edit History Details ===
... ... @@ -283,9 +283,9 @@
283 283  * Legal compliance (audit trail)
284 284  * Rollback capability
285 285  See **Edit History Documentation** for complete details on what gets edited by whom, retention policy, and use cases
286 -=== 1.8 Flag ===
261 +=== 1.7 Flag ===
287 287  Fields: entity_id, reported_by, issue_type, status, resolution_note
288 -=== 1.9 QualityMetric ===
263 +=== 1.8 QualityMetric ===
289 289  **Fields**: metric_type, category, value, target, timestamp
290 290  **Purpose**: Time-series quality tracking
291 291  **Usage**:
... ... @@ -295,7 +295,7 @@
295 295  * **A/B testing**: Compare control vs treatment metrics
296 296  * **Improvement validation**: Measure before/after changes
297 297  **Example**: `{type: "ErrorRate", category: "Politics", value: 0.12, target: 0.10, timestamp: "2025-12-17"}`
298 -=== 1.10 ErrorPattern ===
273 +=== 1.9 ErrorPattern ===
299 299  **Fields**: error_category, claim_id, description, root_cause, frequency, status
300 300  **Purpose**: Capture errors to trigger system improvements
301 301  **Usage**:
... ... @@ -304,13 +304,8 @@
304 304  * **Improvement workflow**: Analyze → Fix → Test → Deploy → Re-process → Monitor
305 305  * **Metrics**: Track error rate reduction over time
306 306  **Example**: `{category: "WrongSource", description: "Unreliable tabloid cited", root_cause: "No quality check", frequency: 23, status: "Fixed"}`
307 -
308 -== 1.4 Core Data Model ERD ==
309 -
310 -{{include reference="Test.FactHarbor.Specification.Diagrams.Core Data Model ERD.WebHome"/}}
311 -
312 312  == 1.5 User Class Diagram ==
313 -{{include reference="Test.FactHarbor.Specification.Diagrams.User Class Diagram.WebHome"/}}
283 +{{include reference="FactHarbor.Specification.Diagrams.User Class Diagram.WebHome"/}}
314 314  == 2. Versioning Strategy ==
315 315  **All Content Entities Are Versioned**:
316 316  * **Claim**: Every edit creates new version (V1→V2→V3...)
... ... @@ -573,6 +573,6 @@
573 573  * Source names (autocomplete)
574 574  Synchronized from PostgreSQL via change data capture or periodic sync.
575 575  == 4. Related Pages ==
576 -* [[Architecture>>Test.FactHarbor.Specification.Architecture.WebHome]]
577 -* [[Requirements>>Test.FactHarbor.Specification.Requirements.WebHome]]
578 -* [[Workflows>>Test.FactHarbor.Specification.Workflows.WebHome]]
546 +* [[Architecture>>FactHarbor.Specification.Architecture.WebHome]]
547 +* [[Requirements>>FactHarbor.Specification.Requirements.WebHome]]
548 +* [[Workflows>>FactHarbor.Specification.Workflows.WebHome]]