Changes for page User Needs

Summary

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

Details

Page properties

Content

...	...	@@ -9,45 +9,169 @@
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	+
	13	+**As** an article reader (any content type),
	14	+**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,
	20	+
	21	+**As** an article reader,
	22	+**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		-=== UN-3: Summary with Verdict Context ===
26		-**As** an article reader,
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.
	27	+=== UN-3: Article Summary with FactHarbor Analysis Summary ===
29	29
30		-**Maps to**: FR7 (Automated Verdicts), FR6 (Scenario Comparison)
	29	+**As** an article reader,
	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	+**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.
31	31
	33	+**Maps to**: FR7 (Automated Verdicts), FR6 (Scenario Comparison), FR12 (Two-Panel Summary View - Article Summary with FactHarbor Analysis Summary)
	34	+
	35	+==== Example: Two-Panel Summary Layout ====
	36	+
	37	+|=**ARTICLE SUMMARY**|=**FACTHARBOR ANALYSIS SUMMARY**
	38	+|(((
	39	+**FactHarbor Summary: AHA Alcohol & Heart Health Statement (2025)**
	40	+
	41	+**Source:** American Heart Association Scientific Statement, //Circulation//, June 2025
	42	+**Credibility:** Very High (peer-reviewed expert consensus)
	43	+
	44	+=== The Big Picture ===
	45	+
	46	+**Old belief:** "A glass of wine is good for your heart"
	47	+**New position:** We're no longer sure that's true
	48	+
	49	+=== Key Findings ===
	50	+
	51	+|=**Drinking Level**|=**Verdict**
	52	+|Heavy (≥3 drinks/day)|(% style="color:red" %)❌ **Harmful** – consistent across ALL studies
	53	+|Moderate (1-2 drinks/day)|(% style="color:orange" %)❓ **Uncertain** – benefits may have been overstated
	54	+|None|(% style="color:green" %)✅ **Don't start drinking for heart health**
	55	+
	56	+=== Why the Shift? ===
	57	+
	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	+
	60	+=== AHA Bottom Line ===
	61	+
	62	+(% class="box" %)
	63	+(((
	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.
	65	+
	66	+//The "wine for heart health" era appears to be over.//
	67	+)))
	68	+)))|(((
	69	+**FactHarbor Analysis Summary**
	70	+
	71	+**Document:** AHA Scientific Statement on Alcohol and Cardiovascular Disease (2025)
	72	+
	73	+=== Source Assessment ===
	74	+
	75	+**Credibility:** (% style="color:green" %)**VERY HIGH**(%%) – Official AHA statement, peer-reviewed, expert panel, published in top journal (//Circulation//)
	76	+
	77	+=== Analysis Findings ===
	78	+
	79	+|=**Claim in Document**|=**FactHarbor Verdict**|=**Confidence**
	80	+|Heavy drinking harms heart health|(% style="color:green" %)**STRONGLY SUPPORTED**|(% style="color:green" %)**95%**
	81	+|Moderate drinking benefits uncertain|(% style="color:green" %)**WELL SUPPORTED**|(% style="color:green" %)**85%**
	82	+|Prior "cardioprotective" claims overstated|(% style="color:green" %)**SUPPORTED**|(% style="color:green" %)**80%**
	83	+|More research needed|**APPROPRIATE**|N/A
	84	+
	85	+=== Assessment ===
	86	+
	87	+(% style="color:green" %)✅(%%) **Strengths:** Transparent about methodological limitations, incorporates newer Mendelian randomization evidence, appropriately cautious, avoids overstatement
	88	+
	89	+(% style="color:green" %)✅(%%) **Methodology:** Sound synthesis of observational and genetic evidence
	90	+
	91	+(% style="color:orange" %)⚠️(%%) **Limitation:** Still relies heavily on observational data; RCT evidence limited
	92	+
	93	+=== Verdict on the Statement Itself ===
	94	+
	95	+(% class="box successmessage" %)
	96	+(((
	97	+**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.
	98	+)))
	99	+
	100	+**Analysis ID:** FH-AHA-ALCO-2025-12-17
	101	+)))
	102	+
	103	+**Key Elements of Two-Panel Layout**:
	104	+
	105	+**Left Panel (Article Summary)**:
	106	+
	107	+* Document title and source
	108	+* Source credibility (document's own authority)
	109	+* "The Big Picture" - old belief vs. new position
	110	+* "Key Findings" - document's main claims in structured format
	111	+* "Why the Shift?" - document's reasoning
	112	+* "Bottom Line" - document's conclusion
	113	+
	114	+**Right Panel (FactHarbor Analysis Summary)**:
	115	+
	116	+* FactHarbor's source assessment (independent credibility check)
	117	+* Claim-by-claim analysis with verdicts and confidence scores
	118	+* Assessment of methodology (strengths/limitations)
	119	+* Overall verdict on the document itself
	120	+* Analysis ID for reference
	121	+
	122	+**Design Principle**: User sees **what they claim** and **FactHarbor's complete analysis** side-by-side without scrolling.
	123	+
32	32	=== UN-4: Social Media Fact-Checking ===
33		-**As** a social media user,
34		-**I want** to check claims in posts before sharing,
	125	+
	126	+**As** a social media user,
	127	+**I want** to check claims in posts before sharing,
35	35	**so that** I can avoid spreading misinformation.
36	36
37	37	**Maps to**: FR1 (Claim Intake), FR7 (Automated Verdicts), NFR1 (Performance - fast processing)
38	38
	132	+=== UN-17: In-Article Claim Highlighting ===
	133	+
	134	+**As** a reader viewing an article,
	135	+**I want** to see factual claims highlighted with color-coded credibility indicators (green for well-supported, yellow for uncertain, red for refuted),
	136	+**so that** I can immediately identify which statements are trustworthy and which require skepticism without interrupting my reading flow.
	137	+
	138	+**Maps to**: FR7 (Automated Verdicts), FR13 (In-Article Claim Highlighting), NFR1 (Performance - real-time highlighting)
	139	+
	140	+==== Visual Concept ====
	141	+
	142	+When reading an article on FactHarbor:
	143	+
	144	+(% style="font-family:monospace; background-color:#f5f5f5; padding:10px; display:block;" %)
	145	+(((
	146	+Regular article text flows normally...
	147	+
	148	+(% style="background-color:#90EE90; padding:2px 5px;" %)This claim is well-supported by evidence(%%) and you can continue reading...
	149	+
	150	+More context and explanation...
	151	+
	152	+(% style="background-color:#FFD700; padding:2px 5px;" %)This claim is uncertain with conflicting evidence(%%) but the article continues...
	153	+
	154	+Additional information...
	155	+
	156	+(% style="background-color:#FFB6C6; padding:2px 5px;" %)This claim has been refuted by research(%%) and understanding that helps readers...
	157	+)))
	158	+
	159	+**Hover/Click on any highlighted claim** → See verdict, confidence score, and evidence summary
	160	+
39	39	== 2. Source Tracing & Credibility ==
40	40
41	41	=== UN-5: Source Provenance and Track Records ===
42		-**As** an article reader,
43		-**I want** to trace each piece of evidence back to its original source and see that source's historical track record,
	164	+
	165	+**As** an article reader,
	166	+**I want** to trace each piece of evidence back to its original source and see that source's historical track record,
44	44	**so that** I can assess the reliability of the information chain and learn which sources are consistently trustworthy.
45	45
46	46	**Maps to**: FR5 (Evidence Linking), Section 4.1 (Source Requirements - track record system)
47	47
48	48	=== UN-6: Publisher Reliability History ===
49		-**As** an article reader,
50		-**I want** to see historical accuracy track records for sources and publishers,
	172	+
	173	+**As** an article reader,
	174	+**I want** to see historical accuracy track records for sources and publishers,
51	51	**so that** I can learn which outlets are consistently reliable over time.
52	52
53	53	**Maps to**: Section 4.1 (Source Requirements), Data Model (Source entity with track_record_score)
...	...	@@ -55,22 +55,25 @@
55	55	== 3. Understanding the Analysis ==
56	56
57	57	=== UN-7: Evidence Transparency ===
58		-**As** a skeptical reader,
59		-**I want** to see the evidence and reasoning behind each verdict,
	182	+
	183	+**As** a skeptical reader,
	184	+**I want** to see the evidence and reasoning behind each verdict,
60	60	**so that** I can judge whether I agree with the assessment and form my own conclusions.
61	61
62	62	**Maps to**: FR5 (Evidence Linking), NFR3 (Transparency)
63	63
64	64	=== UN-8: Understanding Disagreement and Consensus ===
65		-**As** an article reader,
66		-**I want** to see which scenarios have strong supporting evidence versus which have conflicting evidence or high uncertainty,
	190	+
	191	+**As** an article reader,
	192	+**I want** to see which scenarios have strong supporting evidence versus which have conflicting evidence or high uncertainty,
67	67	**so that** I can understand where legitimate disagreement exists versus where consensus is clear.
68	68
69	69	**Maps to**: FR6 (Scenario Comparison), FR7 (Automated Verdicts - uncertainty factors), AKEL Gate 2 (Contradiction Search)
70	70
71	71	=== UN-9: Methodology Transparency ===
72		-**As** an article reader,
73		-**I want** to understand how likelihood ranges and confidence scores are calculated,
	198	+
	199	+**As** an article reader,
	200	+**I want** to understand how likelihood ranges and confidence scores are calculated,
74	74	**so that** I can trust the verification process itself.
75	75
76	76	**Maps to**: NFR3 (Transparency), Architecture (documented algorithms), AKEL (Quality Gates)
...	...	@@ -78,15 +78,17 @@
78	78	== 4. Pattern Recognition & Learning ==
79	79
80	80	=== UN-10: Manipulation Tactics Detection ===
81		-**As** an article reader,
82		-**I want** to see common manipulation tactics or logical fallacies identified in content,
	208	+
	209	+**As** an article reader,
	210	+**I want** to see common manipulation tactics or logical fallacies identified in content,
83	83	**so that** I can recognize them elsewhere and become a more critical consumer of information.
84	84
85	85	**Maps to**: AKEL (Bubble Detection), Section 5 (Automated Risk Scoring)
86	86
87	87	=== UN-11: Filtered Research ===
88		-**As** a researcher,
89		-**I want** to filter content by verification status, confidence levels, and source quality,
	216	+
	217	+**As** a researcher,
	218	+**I want** to filter content by verification status, confidence levels, and source quality,
90	90	**so that** I can work only with reliable information appropriate for my research needs.
91	91
92	92	**Maps to**: FR1 (Claim Classification), Section 4.4 (Confidence Scoring), NFR1 (Performance)
...	...	@@ -94,15 +94,17 @@
94	94	== 5. Taking Action ==
95	95
96	96	=== UN-12: Submit Unchecked Claims ===
97		-**As** a reader who finds unchecked claims,
98		-**I want** to submit them for verification,
	226	+
	227	+**As** a reader who finds unchecked claims,
	228	+**I want** to submit them for verification,
99	99	**so that** I can help expand fact-checking coverage and contribute to the knowledge base.
100	100
101	101	**Maps to**: FR1 (Claim Intake), Section 1.1 (Reader role)
102	102
103	103	=== UN-13: Cite FactHarbor Verdicts ===
104		-**As** a content creator,
105		-**I want** to cite FactHarbor verdicts when sharing content,
	234	+
	235	+**As** a content creator,
	236	+**I want** to cite FactHarbor verdicts when sharing content,
106	106	**so that** I can add credibility to what I publish and help my audience distinguish fact from speculation.
107	107
108	108	**Maps to**: FR7 (Automated Verdicts), NFR3 (Transparency - exportable data)
...	...	@@ -110,8 +110,9 @@
110	110	== 6. Professional Use ==
111	111
112	112	=== UN-14: API Access for Integration ===
113		-**As** a journalist/researcher,
114		-**I want** API access to verification data and claim histories,
	244	+
	245	+**As** a journalist/researcher,
	246	+**I want** API access to verification data and claim histories,
115	115	**so that** I can integrate fact-checking into my professional workflow without manual lookups.
116	116
117	117	**Maps to**: Architecture (REST API), NFR2 (Scalability), FR11 (Audit Trail)
...	...	@@ -119,15 +119,23 @@
119	119	== 7. Understanding Evolution & Trust Labels ==
120	120
121	121	=== UN-15: Verdict Evolution Timeline ===
122		-**As** an article reader,
123		-**I want** to see how a claim's verdict has evolved over time with clear timestamps,
	254	+
	255	+{{warning}}
	256	+**Status:** Deferred (Not in V1.0)
	257	+
	258	+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.
	259	+{{/warning}}
	260	+
	261	+**As** an article reader,
	262	+**I want** to see how a claim's verdict has evolved over time with clear timestamps,
124	124	**so that** I can understand whether the current assessment is stable or recently changed based on new evidence.
125	125
126		-**Maps to**: FR8 (Time Evolution), Data Model (Versioned entities), NFR3 (Transparency)
	265	+**Maps to**: ~~FR8 (Deferred)~~, Data Model (Versioned entities), NFR3 (Transparency)
127	127
128	128	=== UN-16: AI vs. Human Review Status ===
129		-**As** an article reader,
130		-**I want** to know if the verdict was AI-generated, human-reviewed, or expert-validated,
	268	+
	269	+**As** an article reader,
	270	+**I want** to know if the verdict was AI-generated, human-reviewed, or expert-validated,
131	131	**so that** I can gauge the appropriate level of trust and understand the review process used.
132	132
133	133	**Maps to**: AKEL (Publication Modes), Section 5 (Risk Tiers), Data Model (AuthorType field)
...	...	@@ -138,43 +138,45 @@
138	138
139	139	=== 8.1 Functional Requirements Coverage ===
140	140
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 |
	281	+(% style="width:100%" %)
	282	+|=(% style="width:10%" %)FR#|=(% style="width:35%" %)Requirement|=(% style="width:55%" %)Fulfills User Needs
	283	+|(% style="width:10%" %)FR1|(% style="width:35%" %)Claim Intake|(% style="width:55%" %)UN-2, UN-4, UN-12
	284	+|(% style="width:10%" %)FR4|(% style="width:35%" %)Scenario Generation|(% style="width:55%" %)UN-2, UN-3
	285	+|(% style="width:10%" %)FR5|(% style="width:35%" %)Evidence Linking|(% style="width:55%" %)UN-5, UN-7
	286	+|(% style="width:10%" %)FR6|(% style="width:35%" %)Scenario Comparison|(% style="width:55%" %)UN-3, UN-8
	287	+|(% style="width:10%" %)FR7|(% style="width:35%" %)Automated Verdicts|(% style="width:55%" %)UN-1, UN-2, UN-3, UN-4, UN-13, UN-17
	288	+|(% style="width:10%" %)FR8|(% style="width:35%" %)Time Evolution|(% style="width:55%" %)UN-15
	289	+|(% style="width:10%" %)FR11|(% style="width:35%" %)Audit Trail|(% style="width:55%" %)UN-14, UN-16
	290	+|(% style="width:10%" %)FR12|(% style="width:35%" %)Two-Panel Summary View|(% style="width:55%" %)UN-3
	291	+|(% style="width:10%" %)FR13|(% style="width:35%" %)In-Article Claim Highlighting|(% style="width:55%" %)UN-17
150	150
151	151	=== 8.2 Non-Functional Requirements Coverage ===
152	152
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 |
	295	+(% style="width:100%" %)
	296	+|=(% style="width:10%" %)NFR#|=(% style="width:35%" %)Requirement|=(% style="width:55%" %)Fulfills User Needs
	297	+|(% 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)
	298	+|(% style="width:10%" %)NFR2|(% style="width:35%" %)Scalability|(% style="width:55%" %)UN-14 (API access at scale)
	299	+|(% style="width:10%" %)NFR3|(% style="width:35%" %)Transparency|(% style="width:55%" %)UN-1, UN-7, UN-9, UN-13, UN-15
158	158
159	159	=== 8.3 AKEL System Coverage ===
160	160
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) |
	303	+(% style="width:100%" %)
	304	+|=(% style="width:45%" %)AKEL Component|=(% style="width:55%" %)Fulfills User Needs
	305	+|(% style="width:45%" %)Quality Gates|(% style="width:55%" %)UN-9 (methodology transparency)
	306	+|(% style="width:45%" %)Contradiction Search (Gate 2)|(% style="width:55%" %)UN-8 (understanding disagreement)
	307	+|(% style="width:45%" %)Bubble Detection|(% style="width:55%" %)UN-10 (manipulation tactics)
	308	+|(% style="width:45%" %)Publication Modes|(% style="width:55%" %)UN-16 (AI vs. human review status)
	309	+|(% style="width:45%" %)Risk Tiers|(% style="width:55%" %)UN-16 (appropriate review level)
168	168
169	169	=== 8.4 Data Model Coverage ===
170	170
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) |
	313	+(% style="width:100%" %)
	314	+|=(% style="width:45%" %)Entity|=(% style="width:55%" %)Fulfills User Needs
	315	+|(% style="width:45%" %)Source (with track_record_score)|(% style="width:55%" %)UN-5, UN-6 (source reliability)
	316	+|(% style="width:45%" %)Scenario|(% style="width:55%" %)UN-2, UN-3, UN-8 (context-dependent truth)
	317	+|(% style="width:45%" %)Verdict (with likelihood_range, uncertainty_factors)|(% style="width:55%" %)UN-1, UN-2, UN-3, UN-8 (detailed assessment)
	318	+|(% style="width:45%" %)Versioned entities|(% style="width:55%" %)UN-15 (evolution timeline)
	319	+|(% style="width:45%" %)AuthorType field|(% style="width:55%" %)UN-16 (AI vs. human status)
178	178
179	179	== 9. User Need Gaps & Future Considerations ==
180	180
...	...	@@ -181,6 +181,7 @@
181	181	This section identifies user needs that may emerge as the platform matures:
182	182
183	183	**Potential Future Needs**:
	326	+
184	184	* **Collaborative annotation**: Users want to discuss verdicts with others
185	185	* **Personal tracking**: Users want to track claims they're following
186	186	* **Custom alerts**: Users want notifications when tracked claims are updated
...	...	@@ -188,6 +188,7 @@
188	188	* **Comparative analysis**: Users want to compare how different fact-checkers rate the same claim
189	189
190	190	**When to address**: These needs should be considered when:
	334	+
191	191	1. User feedback explicitly requests them
192	192	2. Usage metrics show users attempting these workflows
193	193	3. Competitive analysis shows these as differentiators
...	...	@@ -199,5 +199,31 @@
199	199	* [[Requirements>>FactHarbor.Specification.Requirements.WebHome]] - Parent page with roles, rules, and functional requirements
200	200	* [[Architecture>>FactHarbor.Specification.Architecture.WebHome]] - How requirements are implemented
201	201	* [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Data structures supporting user needs
202		-* [[AKEL (AI Knowledge Extraction Layer)>>FactHarbor.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system fulfilling automation needs
	346	+* [[AKEL (AI Knowledge Extraction Layer)>>Archive.FactHarbor.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system fulfilling automation needs
203	203	* [[Workflows>>FactHarbor.Specification.Workflows.WebHome]] - User interaction workflows
	348	+
	349	+== Additional User Needs (V0.9.70) ==
	350	+
	351	+=== UN-26: Search Engine Visibility ===
	352	+
	353	+**As a** content consumer
	354	+**I want** FactHarbor analyses to appear in Google search results
	355	+**So that** I can find fact-checks when searching
	356	+
	357	+**Requirements:** FR44 (ClaimReview schema)
	358	+
	359	+=== UN-27: Visual Claim Verification ===
	360	+
	361	+**As a** social media user
	362	+**I want** to verify images shared with claims
	363	+**So that** I can detect manipulated photos
	364	+
	365	+**Requirements:** FR46 (Image Verification)
	366	+
	367	+=== UN-28: Safe Contribution Environment ===
	368	+
	369	+**As a** fact-checking contributor
	370	+**I want** protection from harassment
	371	+**So that** I can contribute without fear
	372	+
	373	+**Requirements:** FR48 (Safety Framework)