Wiki source code of System Design

Last modified by Robert Schaub on 2025/12/24 20:35

version	line-number	content
1.1	1	= System Design =
	2
	3	UI/UX design for FactHarbor including POC and production interfaces
	4
1.3	5	----
1.1	6
	7	== 1. Design Philosophy ==
	8
	9	Core Principles:
1.2	10
1.1	11	1. Transparency First: Show how verdicts were reached
	12	2. Clarity Over Completeness: Don't overwhelm users
	13	3. Progressive Disclosure: Details available on demand
	14	4. Quality Indicators Visible: Users should see confidence levels immediately
	15	5. Mobile-First: Majority of users on mobile devices
	16
1.3	17	----
1.1	18
	19	== 2. POC1 Interface Design ==
	20
	21	=== 2.1 Input Screen ===
	22
	23	{{code}}
	24	┌──────────────────────────────────────┐
	25	│ FactHarbor - Fact Analysis POC │
	26	├──────────────────────────────────────┤
	27	│ │
	28	│ Paste article text or URL: │
	29	│ ┌─────────────────────────────────┐ │
	30	│ │ │ │
	31	│ │ (text input area) │ │
	32	│ │ │ │
	33	│ └─────────────────────────────────┘ │
	34	│ │
	35	│ [ Analyze ] │
	36	│ │
	37	│ Note: This is a POC. Results are │
	38	│ AI-generated and may contain errors.│
	39	└──────────────────────────────────────┘
	40	{{/code}}
	41
	42	Design Notes:
1.2	43
1.1	44	* Simple, single-purpose interface
	45	* Clear POC disclaimer
	46	* No authentication/accounts needed
	47
1.3	48	----
1.1	49
	50	=== 2.2 Results Display ===
	51
	52	{{code}}
	53	┌──────────────────────────────────────┐
	54	│ FactHarbor Analysis Results │
	55	├──────────────────────────────────────┤
	56	│ │
	57	│ Quality Score: 8.5/10 ✅ │
	58	│ Quality Gates: 2/2 Passed │
	59	│ │
	60	│ ═══════════════════════════════════ │
	61	│ │
	62	│ 📋 Claims Found: 3 verifiable │
	63	│ (2 non-verifiable filtered) │
	64	│ │
	65	│ ─────────────────────────────────── │
	66	│ │
	67	│ CLAIM 1: [claim text] │
	68	│ Verdict: ✅ WELL-SUPPORTED (85%) │
	69	│ Sources: 4 │
	70	│ [Show Details ▼] │
	71	│ │
	72	│ ─────────────────────────────────── │
	73	│ │
	74	│ CLAIM 2: [claim text] │
	75	│ Verdict: ⚠️ PARTIALLY SUPPORTED (65%)│
	76	│ Sources: 2 │
	77	│ [Show Details ▼] │
	78	│ │
	79	│ ─────────────────────────────────── │
	80	│ │
	81	│ BLOCKED CLAIM: [opinion text] │
	82	│ ❌ Non-factual (Opinion detected) │
	83	│ Explanation: Contains subjective │
	84	│ language ("best", "should") │
	85	│ │
	86	└──────────────────────────────────────┘
	87	{{/code}}
	88
	89	Design Features:
1.2	90
1.1	91	* Quality score prominently displayed
	92	* Color coding for verdict confidence
	93	* Expandable details (progressive disclosure)
	94	* Clear blocked claims with explanations
	95
1.3	96	----
1.1	97
	98	=== 2.3 Claim Detail View ===
	99
	100	{{code}}
	101	┌──────────────────────────────────────┐
	102	│ CLAIM: [full claim text] │
	103	├──────────────────────────────────────┤
	104	│ │
	105	│ Verdict: ✅ WELL-SUPPORTED │
	106	│ Confidence: 85% (HIGH) │
	107	│ │
	108	│ Evidence Sources: 4 │
	109	│ ┌──────────────────────────────────┐│
	110	│ │ 📄 Source 1: Reuters ││
	111	│ │ Quality: 0.9 (High) ││
	112	│ │ [Supports claim] ││
	113	│ │ [View source →] ││
	114	│ ├──────────────────────────────────┤│
	115	│ │ 📄 Source 2: BBC ││
	116	│ │ Quality: 0.8 (High) ││
	117	│ │ [Supports claim] ││
	118	│ │ [View source →] ││
	119	│ └──────────────────────────────────┘│
	120	│ │
	121	│ Reasoning: │
	122	│ [AI-generated explanation of verdict]│
	123	│ │
	124	│ Quality Checks: │
	125	│ ✅ Gate 1: Factual claim │
	126	│ ✅ Gate 4: Sufficient evidence │
	127	│ │
	128	└──────────────────────────────────────┘
	129	{{/code}}
	130
1.3	131	----
1.1	132
	133	== 3. POC2 Interface Enhancements ==
	134
	135	=== 3.1 Added Features ===
	136
	137	Scenario Display:
1.2	138	{{code}}┌──────────────────────────────────────┐
1.1	139	│ CLAIM: [text] │
	140	├──────────────────────────────────────┤
	141	│ │
	142	│ Scenarios Evaluated: 2 │
	143	│ │
	144	│ 📍 Scenario A: [interpretation] │
	145	│ Verdict: WELL-SUPPORTED (80%) │
	146	│ [Show details ▼] │
	147	│ │
	148	│ 📍 Scenario B: [interpretation] │
	149	│ Verdict: UNCERTAIN (45%) │
	150	│ [Show details ▼] │
	151	│ │
1.2	152	└──────────────────────────────────────┘{{/code}}
1.1	153
	154	Evidence Provenance:
1.2	155
1.1	156	* Show if multiple sources cite same underlying evidence
	157	* Display deduplication results
	158	* Provenance chain visualization
	159
	160	Quality Metrics Dashboard:
1.2	161
1.1	162	* Internal view showing all 4 gates
	163	* Historical performance trends
	164	* Hallucination rate tracking
	165
1.3	166	----
1.1	167
	168	== 4. Full System Design (V1.0+) ==
	169
	170	=== 4.1 Additional Features ===
	171
	172	User Accounts:
1.2	173
1.1	174	* Save analyses
	175	* Track corrections
	176	* Contribute feedback
	177
	178	Advanced Search:
1.2	179
1.1	180	* Find previous analyses
	181	* Filter by topic, verdict type
	182	* Sort by date, relevance
	183
	184	Corrections Banner:
1.2	185	{{code}}┌──────────────────────────────────────┐
1.1	186	│ ⚠️ This analysis was corrected │
	187	│ [View correction log →] │
1.2	188	└──────────────────────────────────────┘{{/code}}
1.1	189
	190	Public Quality Dashboard:
1.2	191
1.1	192	* Real-time metrics
	193	* Transparency reports
	194	* Historical trends
	195
1.3	196	----
1.1	197
	198	== 5. Responsive Design ==
	199
	200	Mobile-First Approach:
1.2	201
1.1	202	* Single column layout
	203	* Touch-friendly targets
	204	* Collapsible sections by default
	205	* Fast load times
	206
	207	Desktop Enhancements:
1.2	208
1.1	209	* Multi-column layout where appropriate
	210	* Side-by-side evidence comparison
	211	* Advanced filters always visible
	212
1.3	213	----
1.1	214
	215	== 6. Accessibility ==
	216
	217	WCAG 2.1 AA Compliance:
1.2	218
1.1	219	* Keyboard navigation
	220	* Screen reader support
	221	* Color contrast ratios
	222	* Alternative text for icons
	223	* Focus indicators
	224
1.3	225	----
1.1	226
	227	== 7. Related Pages ==
	228
1.7	229	* [[Architecture>>Archive.FactHarbor delta for V0\.9\.70.Specification.Architecture.WebHome]] - System architecture
1.9	230	* [[Requirements>>Archive.FactHarbor delta for V0\.9\.70.Specification.Requirements.WebHome]] - UI requirements
1.6	231	* [[Roadmap>>Archive.FactHarbor delta for V0\.9\.70.Roadmap.WebHome]] - Implementation phases
1.1	232
1.3	233	----
1.1	234
	235	Document Status: ✅ Design Specified (POC1, POC2, V1.0)
	236	Version: V0.9.70