Changes for page User Needs

Last modified by Robert Schaub on 2026/02/08 08:27

From version 1.3
edited by Robert Schaub
on 2026/01/20 20:24
Change comment: Renamed back-links.
To version 1.1
edited by Robert Schaub
on 2025/12/23 18:19
Change comment: Imported from XAR

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,1 @@
1 -Test.FactHarbor V0\.9\.100 incremental.Specification.Requirements.WebHome
1 +Test.FactHarbor.Specification.Requirements.WebHome
Content
... ... @@ -9,7 +9,6 @@
9 9  == 1. Core Reading & Discovery ==
10 10  
11 11  === UN-1: Trust Assessment at a Glance ===
12 -
13 13  **As** an article reader (any content type),
14 14  **I want** to see a trust score and overall verdict summary at a glance,
15 15  **so that** I can quickly decide if the content is worth my time to read in detail.
... ... @@ -17,7 +17,6 @@
17 17  **Maps to**: FR7 (Automated Verdicts), NFR3 (Transparency)
18 18  
19 19  === UN-2: Claim Extraction and Verification ===
20 -
21 21  **As** an article reader,
22 22  **I want** to see the key factual claims extracted from content with verification verdicts (likelihood ranges + uncertainty ratings) for each relevant scenario,
23 23  **so that** I can distinguish proven facts from speculation and understand context-dependent truth.
... ... @@ -25,7 +25,6 @@
25 25  **Maps to**: FR1 (Claim Intake), FR4 (Scenario Generation), FR7 (Automated Verdicts)
26 26  
27 27  === UN-3: Article Summary with FactHarbor Analysis Summary ===
28 -
29 29  **As** an article reader,
30 30  **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),
31 31  **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.
... ... @@ -42,7 +42,6 @@
42 42  **Credibility:** Very High (peer-reviewed expert consensus)
43 43  
44 44  === The Big Picture ===
45 -
46 46  **Old belief:** "A glass of wine is good for your heart"
47 47  **New position:** We're no longer sure that's true
48 48  
... ... @@ -54,11 +54,9 @@
54 54  |None|(% style="color:green" %)✅ **Don't start drinking for heart health**
55 55  
56 56  === Why the Shift? ===
57 -
58 58  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.
59 59  
60 60  === AHA Bottom Line ===
61 -
62 62  (% class="box" %)
63 63  (((
64 64  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.
... ... @@ -71,7 +71,6 @@
71 71  **Document:** AHA Scientific Statement on Alcohol and Cardiovascular Disease (2025)
72 72  
73 73  === Source Assessment ===
74 -
75 75  **Credibility:** (% style="color:green" %)**VERY HIGH**(%%) – Official AHA statement, peer-reviewed, expert panel, published in top journal (//Circulation//)
76 76  
77 77  === Analysis Findings ===
... ... @@ -103,7 +103,6 @@
103 103  **Key Elements of Two-Panel Layout**:
104 104  
105 105  **Left Panel (Article Summary)**:
106 -
107 107  * Document title and source
108 108  * Source credibility (document's own authority)
109 109  * "The Big Picture" - old belief vs. new position
... ... @@ -112,7 +112,6 @@
112 112  * "Bottom Line" - document's conclusion
113 113  
114 114  **Right Panel (FactHarbor Analysis Summary)**:
115 -
116 116  * FactHarbor's source assessment (independent credibility check)
117 117  * Claim-by-claim analysis with verdicts and confidence scores
118 118  * Assessment of methodology (strengths/limitations)
... ... @@ -122,7 +122,6 @@
122 122  **Design Principle**: User sees **what they claim** and **FactHarbor's complete analysis** side-by-side without scrolling.
123 123  
124 124  === UN-4: Social Media Fact-Checking ===
125 -
126 126  **As** a social media user,
127 127  **I want** to check claims in posts before sharing,
128 128  **so that** I can avoid spreading misinformation.
... ... @@ -130,7 +130,6 @@
130 130  **Maps to**: FR1 (Claim Intake), FR7 (Automated Verdicts), NFR1 (Performance - fast processing)
131 131  
132 132  === UN-17: In-Article Claim Highlighting ===
133 -
134 134  **As** a reader viewing an article,
135 135  **I want** to see factual claims highlighted with color-coded credibility indicators (green for well-supported, yellow for uncertain, red for refuted),
136 136  **so that** I can immediately identify which statements are trustworthy and which require skepticism without interrupting my reading flow.
... ... @@ -161,7 +161,6 @@
161 161  == 2. Source Tracing & Credibility ==
162 162  
163 163  === UN-5: Source Provenance and Track Records ===
164 -
165 165  **As** an article reader,
166 166  **I want** to trace each piece of evidence back to its original source and see that source's historical track record,
167 167  **so that** I can assess the reliability of the information chain and learn which sources are consistently trustworthy.
... ... @@ -169,7 +169,6 @@
169 169  **Maps to**: FR5 (Evidence Linking), Section 4.1 (Source Requirements - track record system)
170 170  
171 171  === UN-6: Publisher Reliability History ===
172 -
173 173  **As** an article reader,
174 174  **I want** to see historical accuracy track records for sources and publishers,
175 175  **so that** I can learn which outlets are consistently reliable over time.
... ... @@ -179,7 +179,6 @@
179 179  == 3. Understanding the Analysis ==
180 180  
181 181  === UN-7: Evidence Transparency ===
182 -
183 183  **As** a skeptical reader,
184 184  **I want** to see the evidence and reasoning behind each verdict,
185 185  **so that** I can judge whether I agree with the assessment and form my own conclusions.
... ... @@ -187,7 +187,6 @@
187 187  **Maps to**: FR5 (Evidence Linking), NFR3 (Transparency)
188 188  
189 189  === UN-8: Understanding Disagreement and Consensus ===
190 -
191 191  **As** an article reader,
192 192  **I want** to see which scenarios have strong supporting evidence versus which have conflicting evidence or high uncertainty,
193 193  **so that** I can understand where legitimate disagreement exists versus where consensus is clear.
... ... @@ -195,7 +195,6 @@
195 195  **Maps to**: FR6 (Scenario Comparison), FR7 (Automated Verdicts - uncertainty factors), AKEL Gate 2 (Contradiction Search)
196 196  
197 197  === UN-9: Methodology Transparency ===
198 -
199 199  **As** an article reader,
200 200  **I want** to understand how likelihood ranges and confidence scores are calculated,
201 201  **so that** I can trust the verification process itself.
... ... @@ -205,7 +205,6 @@
205 205  == 4. Pattern Recognition & Learning ==
206 206  
207 207  === UN-10: Manipulation Tactics Detection ===
208 -
209 209  **As** an article reader,
210 210  **I want** to see common manipulation tactics or logical fallacies identified in content,
211 211  **so that** I can recognize them elsewhere and become a more critical consumer of information.
... ... @@ -213,7 +213,6 @@
213 213  **Maps to**: AKEL (Bubble Detection), Section 5 (Automated Risk Scoring)
214 214  
215 215  === UN-11: Filtered Research ===
216 -
217 217  **As** a researcher,
218 218  **I want** to filter content by verification status, confidence levels, and source quality,
219 219  **so that** I can work only with reliable information appropriate for my research needs.
... ... @@ -223,7 +223,6 @@
223 223  == 5. Taking Action ==
224 224  
225 225  === UN-12: Submit Unchecked Claims ===
226 -
227 227  **As** a reader who finds unchecked claims,
228 228  **I want** to submit them for verification,
229 229  **so that** I can help expand fact-checking coverage and contribute to the knowledge base.
... ... @@ -231,7 +231,6 @@
231 231  **Maps to**: FR1 (Claim Intake), Section 1.1 (Reader role)
232 232  
233 233  === UN-13: Cite FactHarbor Verdicts ===
234 -
235 235  **As** a content creator,
236 236  **I want** to cite FactHarbor verdicts when sharing content,
237 237  **so that** I can add credibility to what I publish and help my audience distinguish fact from speculation.
... ... @@ -241,7 +241,6 @@
241 241  == 6. Professional Use ==
242 242  
243 243  === UN-14: API Access for Integration ===
244 -
245 245  **As** a journalist/researcher,
246 246  **I want** API access to verification data and claim histories,
247 247  **so that** I can integrate fact-checking into my professional workflow without manual lookups.
... ... @@ -266,7 +266,6 @@
266 266  **Maps to**: ~~FR8 (Deferred)~~, Data Model (Versioned entities), NFR3 (Transparency)
267 267  
268 268  === UN-16: AI vs. Human Review Status ===
269 -
270 270  **As** an article reader,
271 271  **I want** to know if the verdict was AI-generated, human-reviewed, or expert-validated,
272 272  **so that** I can gauge the appropriate level of trust and understand the review process used.
... ... @@ -324,7 +324,6 @@
324 324  This section identifies user needs that may emerge as the platform matures:
325 325  
326 326  **Potential Future Needs**:
327 -
328 328  * **Collaborative annotation**: Users want to discuss verdicts with others
329 329  * **Personal tracking**: Users want to track claims they're following
330 330  * **Custom alerts**: Users want notifications when tracked claims are updated
... ... @@ -332,7 +332,6 @@
332 332  * **Comparative analysis**: Users want to compare how different fact-checkers rate the same claim
333 333  
334 334  **When to address**: These needs should be considered when:
335 -
336 336  1. User feedback explicitly requests them
337 337  2. Usage metrics show users attempting these workflows
338 338  3. Competitive analysis shows these as differentiators
... ... @@ -344,9 +344,10 @@
344 344  * [[Requirements>>FactHarbor.Specification.Requirements.WebHome]] - Parent page with roles, rules, and functional requirements
345 345  * [[Architecture>>FactHarbor.Specification.Architecture.WebHome]] - How requirements are implemented
346 346  * [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Data structures supporting user needs
347 -* [[AKEL (AI Knowledge Extraction Layer)>>Archive.FactHarbor.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system fulfilling automation needs
323 +* [[AKEL (AI Knowledge Extraction Layer)>>FactHarbor.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system fulfilling automation needs
348 348  * [[Workflows>>FactHarbor.Specification.Workflows.WebHome]] - User interaction workflows
349 349  
326 +
350 350  == Additional User Needs (V0.9.70) ==
351 351  
352 352  === UN-26: Search Engine Visibility ===
... ... @@ -374,3 +374,4 @@
374 374  **So that** I can contribute without fear
375 375  
376 376  **Requirements:** FR48 (Safety Framework)
354 +