Changes for page Data Model
Last modified by Robert Schaub on 2026/02/08 08:27
Summary
-
Page properties (1 modified, 0 added, 0 removed)
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. 7Edit ===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. 8Flag ===261 +=== 1.7 Flag === 287 287 Fields: entity_id, reported_by, issue_type, status, resolution_note 288 -=== 1. 9QualityMetric ===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. 10ErrorPattern ===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**: ... ... @@ -307,10 +307,10 @@ 307 307 308 308 == 1.4 Core Data Model ERD == 309 309 310 -{{include reference=" Test.FactHarbor.Specification.Diagrams.Core Data Model ERD.WebHome"/}}285 +{{include reference="FactHarbor.Specification.Diagrams.Core Data Model ERD.WebHome"/}} 311 311 312 312 == 1.5 User Class Diagram == 313 -{{include reference=" Test.FactHarbor.Specification.Diagrams.User Class Diagram.WebHome"/}}288 +{{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]]551 +* [[Architecture>>FactHarbor.Specification.Architecture.WebHome]] 552 +* [[Requirements>>FactHarbor.Specification.Requirements.WebHome]] 553 +* [[Workflows>>FactHarbor.Specification.Workflows.WebHome]]