Skip to Content

Wiki source code of System Design

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