Changes for page User Needs
Last modified by Robert Schaub on 2025/12/24 21:53
From version 3.1
edited by Robert Schaub
on 2025/12/19 10:03
on 2025/12/19 10:03
Change comment:
There is no comment for this version
To version 1.1
edited by Robert Schaub
on 2025/12/19 08:55
on 2025/12/19 08:55
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -22,96 +22,13 @@ 22 22 23 23 **Maps to**: FR1 (Claim Intake), FR4 (Scenario Generation), FR7 (Automated Verdicts) 24 24 25 -=== UN-3: ArticleSummary withFactHarborAnalysisSummary===25 +=== UN-3: Summary with Verdict Context === 26 26 **As** an article reader, 27 -**I want** to see a narticle summary(thedocument'sposition,keyclaims,and reasoning)side-by-sidewith FactHarbor'sanalysis summary (sourcecredibilityassessment,claim-by-claimverdicts, methodology evaluation,and overall quality verdict),28 -**so that** I can quickly understand both what thedocument claimsandFactHarbor'scomplete analysis of its credibilitywithout readingthefulldetailedreport.27 +**I want** to see a concise summary of the article's main claims alongside verdict summaries for each scenario, 28 +**so that** I can quickly understand both what is claimed and how credible those claims are under different interpretations. 29 29 30 -**Maps to**: FR7 (Automated Verdicts), FR6 (Scenario Comparison) , FR12 (Two-Panel Summary View - Article Summary with FactHarbor Analysis Summary)30 +**Maps to**: FR7 (Automated Verdicts), FR6 (Scenario Comparison) 31 31 32 -==== Example: Two-Panel Summary Layout ==== 33 - 34 -|=**ARTICLE SUMMARY**|=**FACTHARBOR ANALYSIS SUMMARY** 35 -|((( 36 -**FactHarbor Summary: AHA Alcohol & Heart Health Statement (2025)** 37 - 38 -**Source:** American Heart Association Scientific Statement, //Circulation//, June 2025 39 -**Credibility:** Very High (peer-reviewed expert consensus) 40 - 41 -=== The Big Picture === 42 -**Old belief:** "A glass of wine is good for your heart" 43 -**New position:** We're no longer sure that's true 44 - 45 -=== Key Findings === 46 - 47 -|=**Drinking Level**|=**Verdict** 48 -|Heavy (≥3 drinks/day)|(% style="color:red" %)❌ **Harmful** – consistent across ALL studies 49 -|Moderate (1-2 drinks/day)|(% style="color:orange" %)❓ **Uncertain** – benefits may have been overstated 50 -|None|(% style="color:green" %)✅ **Don't start drinking for heart health** 51 - 52 -=== Why the Shift? === 53 -Newer genetic studies (Mendelian randomization) found **no evidence** that moderate drinking protects the heart. The apparent benefits in older studies were likely due to lifestyle differences and methodological bias. 54 - 55 -=== AHA Bottom Line === 56 -(% class="box" %) 57 -((( 58 -If you don't drink, don't start. If you do drink, keep it to ≤2/day (men) or ≤1/day (women). Focus on proven healthy behaviors instead—exercise, diet, not smoking. 59 - 60 -//The "wine for heart health" era appears to be over.// 61 -))) 62 -)))|((( 63 -**FactHarbor Analysis Summary** 64 - 65 -**Document:** AHA Scientific Statement on Alcohol and Cardiovascular Disease (2025) 66 - 67 -=== Source Assessment === 68 -**Credibility:** (% style="color:green" %)**VERY HIGH**(%%) – Official AHA statement, peer-reviewed, expert panel, published in top journal (//Circulation//) 69 - 70 -=== Analysis Findings === 71 - 72 -|=**Claim in Document**|=**FactHarbor Verdict**|=**Confidence** 73 -|Heavy drinking harms heart health|(% style="color:green" %)**STRONGLY SUPPORTED**|(% style="color:green" %)**95%** 74 -|Moderate drinking benefits uncertain|(% style="color:green" %)**WELL SUPPORTED**|(% style="color:green" %)**85%** 75 -|Prior "cardioprotective" claims overstated|(% style="color:green" %)**SUPPORTED**|(% style="color:green" %)**80%** 76 -|More research needed|**APPROPRIATE**|N/A 77 - 78 -=== Assessment === 79 - 80 -(% style="color:green" %)✅(%%) **Strengths:** Transparent about methodological limitations, incorporates newer Mendelian randomization evidence, appropriately cautious, avoids overstatement 81 - 82 -(% style="color:green" %)✅(%%) **Methodology:** Sound synthesis of observational and genetic evidence 83 - 84 -(% style="color:orange" %)⚠️(%%) **Limitation:** Still relies heavily on observational data; RCT evidence limited 85 - 86 -=== Verdict on the Statement Itself === 87 - 88 -(% class="box successmessage" %) 89 -((( 90 -**WELL-SUPPORTED SCIENTIFIC SYNTHESIS** – The AHA statement is credible, balanced, and appropriately reflects the current state of evidence. It correctly signals a shift away from previous assumptions about moderate drinking benefits without overclaiming in either direction. 91 -))) 92 - 93 -**Analysis ID:** FH-AHA-ALCO-2025-12-17 94 -))) 95 - 96 -**Key Elements of Two-Panel Layout**: 97 - 98 -**Left Panel (Article Summary)**: 99 -* Document title and source 100 -* Source credibility (document's own authority) 101 -* "The Big Picture" - old belief vs. new position 102 -* "Key Findings" - document's main claims in structured format 103 -* "Why the Shift?" - document's reasoning 104 -* "Bottom Line" - document's conclusion 105 - 106 -**Right Panel (FactHarbor Analysis Summary)**: 107 -* FactHarbor's source assessment (independent credibility check) 108 -* Claim-by-claim analysis with verdicts and confidence scores 109 -* Assessment of methodology (strengths/limitations) 110 -* Overall verdict on the document itself 111 -* Analysis ID for reference 112 - 113 -**Design Principle**: User sees **what they claim** and **FactHarbor's complete analysis** side-by-side without scrolling. 114 - 115 115 === UN-4: Social Media Fact-Checking === 116 116 **As** a social media user, 117 117 **I want** to check claims in posts before sharing, ... ... @@ -221,44 +221,43 @@ 221 221 222 222 === 8.1 Functional Requirements Coverage === 223 223 224 -(% style="width:100%" %) 225 -|=(% style="width:10%" %)FR#|=(% style="width:35%" %)Requirement|=(% style="width:55%" %)Fulfills User Needs 226 -|(% style="width:10%" %)FR1|(% style="width:35%" %)Claim Intake|(% style="width:55%" %)UN-2, UN-4, UN-12 227 -|(% style="width:10%" %)FR4|(% style="width:35%" %)Scenario Generation|(% style="width:55%" %)UN-2, UN-3 228 -|(% style="width:10%" %)FR5|(% style="width:35%" %)Evidence Linking|(% style="width:55%" %)UN-5, UN-7 229 -|(% style="width:10%" %)FR6|(% style="width:35%" %)Scenario Comparison|(% style="width:55%" %)UN-3, UN-8 230 -|(% style="width:10%" %)FR7|(% style="width:35%" %)Automated Verdicts|(% style="width:55%" %)UN-1, UN-2, UN-3, UN-4, UN-13 231 -|(% style="width:10%" %)FR8|(% style="width:35%" %)Time Evolution|(% style="width:55%" %)UN-15 232 -|(% style="width:10%" %)FR11|(% style="width:35%" %)Audit Trail|(% style="width:55%" %)UN-14, UN-16 233 -|(% style="width:10%" %)FR12|(% style="width:35%" %)Two-Panel Summary View|(% style="width:55%" %)UN-3 141 +| FR# | Requirement | Fulfills User Needs | 142 +|-----|-------------|-------------------| 143 +| FR1 | Claim Intake | UN-2, UN-4, UN-12 | 144 +| FR4 | Scenario Generation | UN-2, UN-3 | 145 +| FR5 | Evidence Linking | UN-5, UN-7 | 146 +| FR6 | Scenario Comparison | UN-3, UN-8 | 147 +| FR7 | Automated Verdicts | UN-1, UN-2, UN-3, UN-4, UN-13 | 148 +| FR8 | Time Evolution | UN-15 | 149 +| FR11 | Audit Trail | UN-14, UN-16 | 234 234 235 235 === 8.2 Non-Functional Requirements Coverage === 236 236 237 - (%style="width:100%"%)238 -| =(% style="width:10%" %)NFR#|=(% style="width:35%" %)Requirement|=(% style="width:55%" %)Fulfills User Needs239 -| (%style="width:10%" %)NFR1|(%style="width:35%" %)Performance|(%style="width:55%" %)UN-4 (fast fact-checking), UN-11 (responsive filtering)240 -| (%style="width:10%" %)NFR2|(%style="width:35%" %)Scalability|(%style="width:55%" %)UN-14 (API access at scale)241 -| (%style="width:10%" %)NFR3|(%style="width:35%" %)Transparency|(%style="width:55%" %)UN-1, UN-7, UN-9, UN-13, UN-15153 +| NFR# | Requirement | Fulfills User Needs | 154 +|------|-------------|-------------------| 155 +| NFR1 | Performance | UN-4 (fast fact-checking), UN-11 (responsive filtering) | 156 +| NFR2 | Scalability | UN-14 (API access at scale) | 157 +| NFR3 | Transparency | UN-1, UN-7, UN-9, UN-13, UN-15 | 242 242 243 243 === 8.3 AKEL System Coverage === 244 244 245 - (%style="width:100%"%)246 -| =(% style="width:45%" %)AKEL Component|=(% style="width:55%" %)Fulfills User Needs247 -| (%style="width:45%" %)Quality Gates|(%style="width:55%" %)UN-9 (methodology transparency)248 -| (%style="width:45%" %)Contradiction Search (Gate 2)|(%style="width:55%" %)UN-8 (understanding disagreement)249 -| (%style="width:45%" %)Bubble Detection|(%style="width:55%" %)UN-10 (manipulation tactics)250 -| (%style="width:45%" %)Publication Modes|(%style="width:55%" %)UN-16 (AI vs. human review status)251 -| (%style="width:45%" %)Risk Tiers|(%style="width:55%" %)UN-16 (appropriate review level)161 +| AKEL Component | Fulfills User Needs | 162 +|----------------|-------------------| 163 +| Quality Gates | UN-9 (methodology transparency) | 164 +| Contradiction Search (Gate 2) | UN-8 (understanding disagreement) | 165 +| Bubble Detection | UN-10 (manipulation tactics) | 166 +| Publication Modes | UN-16 (AI vs. human review status) | 167 +| Risk Tiers | UN-16 (appropriate review level) | 252 252 253 253 === 8.4 Data Model Coverage === 254 254 255 - (%style="width:100%"%)256 -| =(% style="width:45%" %)Entity|=(% style="width:55%" %)Fulfills User Needs257 -| (%style="width:45%" %)Source (with track_record_score)|(%style="width:55%" %)UN-5, UN-6 (source reliability)258 -| (%style="width:45%" %)Scenario|(%style="width:55%" %)UN-2, UN-3, UN-8 (context-dependent truth)259 -| (%style="width:45%" %)Verdict (with likelihood_range, uncertainty_factors)|(%style="width:55%" %)UN-1, UN-2, UN-3, UN-8 (detailed assessment)260 -| (%style="width:45%" %)Versioned entities|(%style="width:55%" %)UN-15 (evolution timeline)261 -| (%style="width:45%" %)AuthorType field|(%style="width:55%" %)UN-16 (AI vs. human status)171 +| Entity | Fulfills User Needs | 172 +|--------|-------------------| 173 +| Source (with track_record_score) | UN-5, UN-6 (source reliability) | 174 +| Scenario | UN-2, UN-3, UN-8 (context-dependent truth) | 175 +| Verdict (with likelihood_range, uncertainty_factors) | UN-1, UN-2, UN-3, UN-8 (detailed assessment) | 176 +| Versioned entities | UN-15 (evolution timeline) | 177 +| AuthorType field | UN-16 (AI vs. human status) | 262 262 263 263 == 9. User Need Gaps & Future Considerations == 264 264