Skip to Content

Changes for page User Needs

Last modified by Robert Schaub on 2025/12/24 21:53
From version 4.1
edited by Robert Schaub
on 2025/12/19 10:20
Change comment: There is no comment for this version
To version 1.1
edited by Robert Schaub
on 2025/12/19 08:55
Change comment: There is no comment for this version

Summary

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: Article Summary with FactHarbor Analysis Summary ===
25 +=== UN-3: Summary with Verdict Context ===
26 26  **As** an article reader,
27 -**I want** to see an article summary (the document's position, key claims, and reasoning) side-by-side with FactHarbor's analysis summary (source credibility assessment, claim-by-claim verdicts, methodology evaluation, and overall quality verdict),
28 -**so that** I can quickly understand both what the document claims and FactHarbor's complete analysis of its credibility without reading the full detailed report.
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,
... ... @@ -119,34 +119,6 @@
119 119  
120 120  **Maps to**: FR1 (Claim Intake), FR7 (Automated Verdicts), NFR1 (Performance - fast processing)
121 121  
122 -=== UN-17: In-Article Claim Highlighting ===
123 -**As** a reader viewing an article,
124 -**I want** to see factual claims highlighted with color-coded credibility indicators (green for well-supported, yellow for uncertain, red for refuted),
125 -**so that** I can immediately identify which statements are trustworthy and which require skepticism without interrupting my reading flow.
126 -
127 -**Maps to**: FR7 (Automated Verdicts), FR13 (In-Article Claim Highlighting), NFR1 (Performance - real-time highlighting)
128 -
129 -==== Visual Concept ====
130 -
131 -When reading an article on FactHarbor:
132 -
133 -(% style="font-family:monospace; background-color:#f5f5f5; padding:10px; display:block;" %)
134 -(((
135 -Regular article text flows normally...
136 -
137 -(% style="background-color:#90EE90; padding:2px 5px;" %)This claim is well-supported by evidence(%%) and you can continue reading...
138 -
139 -More context and explanation...
140 -
141 -(% style="background-color:#FFD700; padding:2px 5px;" %)This claim is uncertain with conflicting evidence(%%) but the article continues...
142 -
143 -Additional information...
144 -
145 -(% style="background-color:#FFB6C6; padding:2px 5px;" %)This claim has been refuted by research(%%) and understanding that helps readers...
146 -)))
147 -
148 -**Hover/Click on any highlighted claim** → See verdict, confidence score, and evidence summary
149 -
150 150  == 2. Source Tracing & Credibility ==
151 151  
152 152  === UN-5: Source Provenance and Track Records ===
... ... @@ -249,45 +249,43 @@
249 249  
250 250  === 8.1 Functional Requirements Coverage ===
251 251  
252 -(% style="width:100%" %)
253 -|=(% style="width:10%" %)FR#|=(% style="width:35%" %)Requirement|=(% style="width:55%" %)Fulfills User Needs
254 -|(% style="width:10%" %)FR1|(% style="width:35%" %)Claim Intake|(% style="width:55%" %)UN-2, UN-4, UN-12
255 -|(% style="width:10%" %)FR4|(% style="width:35%" %)Scenario Generation|(% style="width:55%" %)UN-2, UN-3
256 -|(% style="width:10%" %)FR5|(% style="width:35%" %)Evidence Linking|(% style="width:55%" %)UN-5, UN-7
257 -|(% style="width:10%" %)FR6|(% style="width:35%" %)Scenario Comparison|(% style="width:55%" %)UN-3, UN-8
258 -|(% style="width:10%" %)FR7|(% style="width:35%" %)Automated Verdicts|(% style="width:55%" %)UN-1, UN-2, UN-3, UN-4, UN-13, UN-17
259 -|(% style="width:10%" %)FR8|(% style="width:35%" %)Time Evolution|(% style="width:55%" %)UN-15
260 -|(% style="width:10%" %)FR11|(% style="width:35%" %)Audit Trail|(% style="width:55%" %)UN-14, UN-16
261 -|(% style="width:10%" %)FR12|(% style="width:35%" %)Two-Panel Summary View|(% style="width:55%" %)UN-3
262 -|(% style="width:10%" %)FR13|(% style="width:35%" %)In-Article Claim Highlighting|(% style="width:55%" %)UN-17
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 |
263 263  
264 264  === 8.2 Non-Functional Requirements Coverage ===
265 265  
266 -(% style="width:100%" %)
267 -|=(% style="width:10%" %)NFR#|=(% style="width:35%" %)Requirement|=(% style="width:55%" %)Fulfills User Needs
268 -|(% style="width:10%" %)NFR1|(% style="width:35%" %)Performance|(% style="width:55%" %)UN-4 (fast fact-checking), UN-11 (responsive filtering), UN-17 (real-time highlighting)
269 -|(% style="width:10%" %)NFR2|(% style="width:35%" %)Scalability|(% style="width:55%" %)UN-14 (API access at scale)
270 -|(% style="width:10%" %)NFR3|(% style="width:35%" %)Transparency|(% style="width:55%" %)UN-1, UN-7, UN-9, UN-13, UN-15
153 +| 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 |
271 271  
272 272  === 8.3 AKEL System Coverage ===
273 273  
274 -(% style="width:100%" %)
275 -|=(% style="width:45%" %)AKEL Component|=(% style="width:55%" %)Fulfills User Needs
276 -|(% style="width:45%" %)Quality Gates|(% style="width:55%" %)UN-9 (methodology transparency)
277 -|(% style="width:45%" %)Contradiction Search (Gate 2)|(% style="width:55%" %)UN-8 (understanding disagreement)
278 -|(% style="width:45%" %)Bubble Detection|(% style="width:55%" %)UN-10 (manipulation tactics)
279 -|(% style="width:45%" %)Publication Modes|(% style="width:55%" %)UN-16 (AI vs. human review status)
280 -|(% 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) |
281 281  
282 282  === 8.4 Data Model Coverage ===
283 283  
284 -(% style="width:100%" %)
285 -|=(% style="width:45%" %)Entity|=(% style="width:55%" %)Fulfills User Needs
286 -|(% style="width:45%" %)Source (with track_record_score)|(% style="width:55%" %)UN-5, UN-6 (source reliability)
287 -|(% style="width:45%" %)Scenario|(% style="width:55%" %)UN-2, UN-3, UN-8 (context-dependent truth)
288 -|(% style="width:45%" %)Verdict (with likelihood_range, uncertainty_factors)|(% style="width:55%" %)UN-1, UN-2, UN-3, UN-8 (detailed assessment)
289 -|(% style="width:45%" %)Versioned entities|(% style="width:55%" %)UN-15 (evolution timeline)
290 -|(% 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) |
291 291  
292 292  == 9. User Need Gaps & Future Considerations ==
293 293