Changes for page User Needs

Summary

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

Details

Page properties

Content

...	...	@@ -22,13 +22,96 @@
22	22
23	23	**Maps to**: FR1 (Claim Intake), FR4 (Scenario Generation), FR7 (Automated Verdicts)
24	24
25		-=== UN-3: Summary with Verdict Context ===
	25	+=== UN-3: Article Summary with FactHarbor Analysis Summary ===
26	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	+**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	33	**As** a social media user,
34	34	**I want** to check claims in posts before sharing,
...	...	@@ -138,43 +138,44 @@
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 |
	224	+(% style="width:100%" %)
	225	+|=(% style="width:10%" %)FR#|=(% style="width:35%" %)Requirement|=(% style="width:55%" %)Fulfills User Needs
	226	+|(% style="width:10%" %)FR1|(% style="width:35%" %)Claim Intake|(% style="width:55%" %)UN-2, UN-4, UN-12
	227	+|(% style="width:10%" %)FR4|(% style="width:35%" %)Scenario Generation|(% style="width:55%" %)UN-2, UN-3
	228	+|(% style="width:10%" %)FR5|(% style="width:35%" %)Evidence Linking|(% style="width:55%" %)UN-5, UN-7
	229	+|(% style="width:10%" %)FR6|(% style="width:35%" %)Scenario Comparison|(% style="width:55%" %)UN-3, UN-8
	230	+|(% style="width:10%" %)FR7|(% style="width:35%" %)Automated Verdicts|(% style="width:55%" %)UN-1, UN-2, UN-3, UN-4, UN-13
	231	+|(% style="width:10%" %)FR8|(% style="width:35%" %)Time Evolution|(% style="width:55%" %)UN-15
	232	+|(% style="width:10%" %)FR11|(% style="width:35%" %)Audit Trail|(% style="width:55%" %)UN-14, UN-16
	233	+|(% style="width:10%" %)FR12|(% style="width:35%" %)Two-Panel Summary View|(% style="width:55%" %)UN-3
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 |
	237	+(% style="width:100%" %)
	238	+|=(% style="width:10%" %)NFR#|=(% style="width:35%" %)Requirement|=(% style="width:55%" %)Fulfills User Needs
	239	+|(% style="width:10%" %)NFR1|(% style="width:35%" %)Performance|(% style="width:55%" %)UN-4 (fast fact-checking), UN-11 (responsive filtering)
	240	+|(% style="width:10%" %)NFR2|(% style="width:35%" %)Scalability|(% style="width:55%" %)UN-14 (API access at scale)
	241	+|(% 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) |
	245	+(% style="width:100%" %)
	246	+|=(% style="width:45%" %)AKEL Component|=(% style="width:55%" %)Fulfills User Needs
	247	+|(% style="width:45%" %)Quality Gates|(% style="width:55%" %)UN-9 (methodology transparency)
	248	+|(% style="width:45%" %)Contradiction Search (Gate 2)|(% style="width:55%" %)UN-8 (understanding disagreement)
	249	+|(% style="width:45%" %)Bubble Detection|(% style="width:55%" %)UN-10 (manipulation tactics)
	250	+|(% style="width:45%" %)Publication Modes|(% style="width:55%" %)UN-16 (AI vs. human review status)
	251	+|(% 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) |
	255	+(% style="width:100%" %)
	256	+|=(% style="width:45%" %)Entity|=(% style="width:55%" %)Fulfills User Needs
	257	+|(% style="width:45%" %)Source (with track_record_score)|(% style="width:55%" %)UN-5, UN-6 (source reliability)
	258	+|(% style="width:45%" %)Scenario|(% style="width:55%" %)UN-2, UN-3, UN-8 (context-dependent truth)
	259	+|(% style="width:45%" %)Verdict (with likelihood_range, uncertainty_factors)|(% style="width:55%" %)UN-1, UN-2, UN-3, UN-8 (detailed assessment)
	260	+|(% style="width:45%" %)Versioned entities|(% style="width:55%" %)UN-15 (evolution timeline)
	261	+|(% 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