Changes for page User Needs

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -9,22 +9,22 @@
9	9	== 1. Core Reading & Discovery ==
10	10
11	11	=== UN-1: Trust Assessment at a Glance ===
12		-**As** an article reader (any content type),
13		-**I want** to see a trust score and overall verdict summary at a glance,
	12	+**As** an article reader (any content type),
	13	+**I want** to see a trust score and overall verdict summary at a glance,
14	14	**so that** I can quickly decide if the content is worth my time to read in detail.
15	15
16	16	**Maps to**: FR7 (Automated Verdicts), NFR3 (Transparency)
17	17
18	18	=== UN-2: Claim Extraction and Verification ===
19		-**As** an article reader,
20		-**I want** to see the key factual claims extracted from content with verification verdicts (likelihood ranges + uncertainty ratings) for each relevant scenario,
	19	+**As** an article reader,
	20	+**I want** to see the key factual claims extracted from content with verification verdicts (likelihood ranges + uncertainty ratings) for each relevant scenario,
21	21	**so that** I can distinguish proven facts from speculation and understand context-dependent truth.
22	22
23	23	**Maps to**: FR1 (Claim Intake), FR4 (Scenario Generation), FR7 (Automated Verdicts)
24	24
25	25	=== UN-3: Article Summary with FactHarbor Analysis Summary ===
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),
	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	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.
29	29
30	30	**Maps to**: FR7 (Automated Verdicts), FR6 (Scenario Comparison), FR12 (Two-Panel Summary View - Article Summary with FactHarbor Analysis Summary)
...	...	@@ -113,52 +113,24 @@
113	113	**Design Principle**: User sees **what they claim** and **FactHarbor's complete analysis** side-by-side without scrolling.
114	114
115	115	=== UN-4: Social Media Fact-Checking ===
116		-**As** a social media user,
117		-**I want** to check claims in posts before sharing,
	116	+**As** a social media user,
	117	+**I want** to check claims in posts before sharing,
118	118	**so that** I can avoid spreading misinformation.
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 ===
153		-**As** an article reader,
154		-**I want** to trace each piece of evidence back to its original source and see that source's historical track record,
	125	+**As** an article reader,
	126	+**I want** to trace each piece of evidence back to its original source and see that source's historical track record,
155	155	**so that** I can assess the reliability of the information chain and learn which sources are consistently trustworthy.
156	156
157	157	**Maps to**: FR5 (Evidence Linking), Section 4.1 (Source Requirements - track record system)
158	158
159	159	=== UN-6: Publisher Reliability History ===
160		-**As** an article reader,
161		-**I want** to see historical accuracy track records for sources and publishers,
	132	+**As** an article reader,
	133	+**I want** to see historical accuracy track records for sources and publishers,
162	162	**so that** I can learn which outlets are consistently reliable over time.
163	163
164	164	**Maps to**: Section 4.1 (Source Requirements), Data Model (Source entity with track_record_score)
...	...	@@ -166,22 +166,22 @@
166	166	== 3. Understanding the Analysis ==
167	167
168	168	=== UN-7: Evidence Transparency ===
169		-**As** a skeptical reader,
170		-**I want** to see the evidence and reasoning behind each verdict,
	141	+**As** a skeptical reader,
	142	+**I want** to see the evidence and reasoning behind each verdict,
171	171	**so that** I can judge whether I agree with the assessment and form my own conclusions.
172	172
173	173	**Maps to**: FR5 (Evidence Linking), NFR3 (Transparency)
174	174
175	175	=== UN-8: Understanding Disagreement and Consensus ===
176		-**As** an article reader,
177		-**I want** to see which scenarios have strong supporting evidence versus which have conflicting evidence or high uncertainty,
	148	+**As** an article reader,
	149	+**I want** to see which scenarios have strong supporting evidence versus which have conflicting evidence or high uncertainty,
178	178	**so that** I can understand where legitimate disagreement exists versus where consensus is clear.
179	179
180	180	**Maps to**: FR6 (Scenario Comparison), FR7 (Automated Verdicts - uncertainty factors), AKEL Gate 2 (Contradiction Search)
181	181
182	182	=== UN-9: Methodology Transparency ===
183		-**As** an article reader,
184		-**I want** to understand how likelihood ranges and confidence scores are calculated,
	155	+**As** an article reader,
	156	+**I want** to understand how likelihood ranges and confidence scores are calculated,
185	185	**so that** I can trust the verification process itself.
186	186
187	187	**Maps to**: NFR3 (Transparency), Architecture (documented algorithms), AKEL (Quality Gates)
...	...	@@ -189,15 +189,15 @@
189	189	== 4. Pattern Recognition & Learning ==
190	190
191	191	=== UN-10: Manipulation Tactics Detection ===
192		-**As** an article reader,
193		-**I want** to see common manipulation tactics or logical fallacies identified in content,
	164	+**As** an article reader,
	165	+**I want** to see common manipulation tactics or logical fallacies identified in content,
194	194	**so that** I can recognize them elsewhere and become a more critical consumer of information.
195	195
196	196	**Maps to**: AKEL (Bubble Detection), Section 5 (Automated Risk Scoring)
197	197
198	198	=== UN-11: Filtered Research ===
199		-**As** a researcher,
200		-**I want** to filter content by verification status, confidence levels, and source quality,
	171	+**As** a researcher,
	172	+**I want** to filter content by verification status, confidence levels, and source quality,
201	201	**so that** I can work only with reliable information appropriate for my research needs.
202	202
203	203	**Maps to**: FR1 (Claim Classification), Section 4.4 (Confidence Scoring), NFR1 (Performance)
...	...	@@ -205,15 +205,15 @@
205	205	== 5. Taking Action ==
206	206
207	207	=== UN-12: Submit Unchecked Claims ===
208		-**As** a reader who finds unchecked claims,
209		-**I want** to submit them for verification,
	180	+**As** a reader who finds unchecked claims,
	181	+**I want** to submit them for verification,
210	210	**so that** I can help expand fact-checking coverage and contribute to the knowledge base.
211	211
212	212	**Maps to**: FR1 (Claim Intake), Section 1.1 (Reader role)
213	213
214	214	=== UN-13: Cite FactHarbor Verdicts ===
215		-**As** a content creator,
216		-**I want** to cite FactHarbor verdicts when sharing content,
	187	+**As** a content creator,
	188	+**I want** to cite FactHarbor verdicts when sharing content,
217	217	**so that** I can add credibility to what I publish and help my audience distinguish fact from speculation.
218	218
219	219	**Maps to**: FR7 (Automated Verdicts), NFR3 (Transparency - exportable data)
...	...	@@ -221,8 +221,8 @@
221	221	== 6. Professional Use ==
222	222
223	223	=== UN-14: API Access for Integration ===
224		-**As** a journalist/researcher,
225		-**I want** API access to verification data and claim histories,
	196	+**As** a journalist/researcher,
	197	+**I want** API access to verification data and claim histories,
226	226	**so that** I can integrate fact-checking into my professional workflow without manual lookups.
227	227
228	228	**Maps to**: Architecture (REST API), NFR2 (Scalability), FR11 (Audit Trail)
...	...	@@ -230,22 +230,15 @@
230	230	== 7. Understanding Evolution & Trust Labels ==
231	231
232	232	=== UN-15: Verdict Evolution Timeline ===
233		-
234		-{{warning}}
235		-**Status:** Deferred (Not in V1.0)
236		-
237		-Full verdict evolution timeline has been **dropped from V1.0**. The system will track edit history only. Versioned entities and full evolution tracking are deferred to future releases.
238		-{{/warning}}
239		-
240		-**As** an article reader,
241		-**I want** to see how a claim's verdict has evolved over time with clear timestamps,
	205	+**As** an article reader,
	206	+**I want** to see how a claim's verdict has evolved over time with clear timestamps,
242	242	**so that** I can understand whether the current assessment is stable or recently changed based on new evidence.
243	243
244		-**Maps to**: ~~FR8 (Deferred)~~, Data Model (Versioned entities), NFR3 (Transparency)
	209	+**Maps to**: FR8 (Time Evolution), Data Model (Versioned entities), NFR3 (Transparency)
245	245
246	246	=== UN-16: AI vs. Human Review Status ===
247		-**As** an article reader,
248		-**I want** to know if the verdict was AI-generated, human-reviewed, or expert-validated,
	212	+**As** an article reader,
	213	+**I want** to know if the verdict was AI-generated, human-reviewed, or expert-validated,
249	249	**so that** I can gauge the appropriate level of trust and understand the review process used.
250	250
251	251	**Maps to**: AKEL (Publication Modes), Section 5 (Risk Tiers), Data Model (AuthorType field)
...	...	@@ -262,17 +262,16 @@
262	262	|(% style="width:10%" %)FR4|(% style="width:35%" %)Scenario Generation|(% style="width:55%" %)UN-2, UN-3
263	263	|(% style="width:10%" %)FR5|(% style="width:35%" %)Evidence Linking|(% style="width:55%" %)UN-5, UN-7
264	264	|(% style="width:10%" %)FR6|(% style="width:35%" %)Scenario Comparison|(% style="width:55%" %)UN-3, UN-8
265		-|(% style="width:10%" %)FR7|(% style="width:35%" %)Automated Verdicts|(% style="width:55%" %)UN-1, UN-2, UN-3, UN-4, UN-13, UN-17
	230	+|(% style="width:10%" %)FR7|(% style="width:35%" %)Automated Verdicts|(% style="width:55%" %)UN-1, UN-2, UN-3, UN-4, UN-13
266	266	|(% style="width:10%" %)FR8|(% style="width:35%" %)Time Evolution|(% style="width:55%" %)UN-15
267	267	|(% style="width:10%" %)FR11|(% style="width:35%" %)Audit Trail|(% style="width:55%" %)UN-14, UN-16
268	268	|(% style="width:10%" %)FR12|(% style="width:35%" %)Two-Panel Summary View|(% style="width:55%" %)UN-3
269		-|(% style="width:10%" %)FR13|(% style="width:35%" %)In-Article Claim Highlighting|(% style="width:55%" %)UN-17
270	270
271	271	=== 8.2 Non-Functional Requirements Coverage ===
272	272
273	273	(% style="width:100%" %)
274	274	|=(% style="width:10%" %)NFR#|=(% style="width:35%" %)Requirement|=(% style="width:55%" %)Fulfills User Needs
275		-|(% 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)
	239	+|(% style="width:10%" %)NFR1|(% style="width:35%" %)Performance|(% style="width:55%" %)UN-4 (fast fact-checking), UN-11 (responsive filtering)
276	276	|(% style="width:10%" %)NFR2|(% style="width:35%" %)Scalability|(% style="width:55%" %)UN-14 (API access at scale)
277	277	|(% style="width:10%" %)NFR3|(% style="width:35%" %)Transparency|(% style="width:55%" %)UN-1, UN-7, UN-9, UN-13, UN-15
278	278
...	...	@@ -321,30 +321,3 @@
321	321	* [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Data structures supporting user needs
322	322	* [[AKEL (AI Knowledge Extraction Layer)>>FactHarbor.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system fulfilling automation needs
323	323	* [[Workflows>>FactHarbor.Specification.Workflows.WebHome]] - User interaction workflows
324		-
325		-== Additional User Needs (V0.9.70) ==
326		-
327		-=== UN-26: Search Engine Visibility ===
328		-
329		-**As a** content consumer
330		-**I want** FactHarbor analyses to appear in Google search results
331		-**So that** I can find fact-checks when searching
332		-
333		-**Requirements:** FR44 (ClaimReview schema)
334		-
335		-=== UN-27: Visual Claim Verification ===
336		-
337		-**As a** social media user
338		-**I want** to verify images shared with claims
339		-**So that** I can detect manipulated photos
340		-
341		-**Requirements:** FR46 (Image Verification)
342		-
343		-=== UN-28: Safe Contribution Environment ===
344		-
345		-**As a** fact-checking contributor
346		-**I want** protection from harassment
347		-**So that** I can contribute without fear
348		-
349		-**Requirements:** FR48 (Safety Framework)
350		-