Changes for page User Needs

Summary

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

Details

Page properties

Content

...	...	@@ -9,45 +9,156 @@
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		-=== 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.
	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),
	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		-**Maps to**: FR7 (Automated Verdicts), FR6 (Scenario Comparison)
	30	+**Maps to**: FR7 (Automated Verdicts), FR6 (Scenario Comparison), FR12 (Two-Panel Summary View - Article Summary with FactHarbor Analysis Summary)
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	+
32	32	=== UN-4: Social Media Fact-Checking ===
33		-**As** a social media user,
34		-**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,
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
	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	+
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,
	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,
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,
	160	+**As** an article reader,
	161	+**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,22 @@
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,
	169	+**As** a skeptical reader,
	170	+**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,
	176	+**As** an article reader,
	177	+**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,
	183	+**As** an article reader,
	184	+**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,15 @@
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,
	192	+**As** an article reader,
	193	+**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,
	199	+**As** a researcher,
	200	+**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,15 @@
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,
	208	+**As** a reader who finds unchecked claims,
	209	+**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,
	215	+**As** a content creator,
	216	+**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,8 @@
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,
	224	+**As** a journalist/researcher,
	225	+**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,22 @@
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,
	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,
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)
	244	+**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,
	247	+**As** an article reader,
	248	+**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 |
	259	+(% style="width:100%" %)
	260	+|=(% style="width:10%" %)FR#|=(% style="width:35%" %)Requirement|=(% style="width:55%" %)Fulfills User Needs
	261	+|(% style="width:10%" %)FR1|(% style="width:35%" %)Claim Intake|(% style="width:55%" %)UN-2, UN-4, UN-12
	262	+|(% style="width:10%" %)FR4|(% style="width:35%" %)Scenario Generation|(% style="width:55%" %)UN-2, UN-3
	263	+|(% style="width:10%" %)FR5|(% style="width:35%" %)Evidence Linking|(% style="width:55%" %)UN-5, UN-7
	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
	266	+|(% style="width:10%" %)FR8|(% style="width:35%" %)Time Evolution|(% style="width:55%" %)UN-15
	267	+|(% style="width:10%" %)FR11|(% style="width:35%" %)Audit Trail|(% style="width:55%" %)UN-14, UN-16
	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
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 |
	273	+(% style="width:100%" %)
	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)
	276	+|(% style="width:10%" %)NFR2|(% style="width:35%" %)Scalability|(% style="width:55%" %)UN-14 (API access at scale)
	277	+|(% 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) |
	281	+(% style="width:100%" %)
	282	+|=(% style="width:45%" %)AKEL Component|=(% style="width:55%" %)Fulfills User Needs
	283	+|(% style="width:45%" %)Quality Gates|(% style="width:55%" %)UN-9 (methodology transparency)
	284	+|(% style="width:45%" %)Contradiction Search (Gate 2)|(% style="width:55%" %)UN-8 (understanding disagreement)
	285	+|(% style="width:45%" %)Bubble Detection|(% style="width:55%" %)UN-10 (manipulation tactics)
	286	+|(% style="width:45%" %)Publication Modes|(% style="width:55%" %)UN-16 (AI vs. human review status)
	287	+|(% 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) |
	291	+(% style="width:100%" %)
	292	+|=(% style="width:45%" %)Entity|=(% style="width:55%" %)Fulfills User Needs
	293	+|(% style="width:45%" %)Source (with track_record_score)|(% style="width:55%" %)UN-5, UN-6 (source reliability)
	294	+|(% style="width:45%" %)Scenario|(% style="width:55%" %)UN-2, UN-3, UN-8 (context-dependent truth)
	295	+|(% style="width:45%" %)Verdict (with likelihood_range, uncertainty_factors)|(% style="width:55%" %)UN-1, UN-2, UN-3, UN-8 (detailed assessment)
	296	+|(% style="width:45%" %)Versioned entities|(% style="width:55%" %)UN-15 (evolution timeline)
	297	+|(% 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
...	...	@@ -201,3 +201,30 @@
201	201	* [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Data structures supporting user needs
202	202	* [[AKEL (AI Knowledge Extraction Layer)>>FactHarbor.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system fulfilling automation needs
203	203	* [[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	+