Skip to Content

Wiki source code of System Design

Last modified by Robert Schaub on 2025/12/24 20:35
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
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
17 ----
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:**
43
44 * Simple, single-purpose interface
45 * Clear POC disclaimer
46 * No authentication/accounts needed
47
48 ----
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:**
90
91 * Quality score prominently displayed
92 * Color coding for verdict confidence
93 * Expandable details (progressive disclosure)
94 * Clear blocked claims with explanations
95
96 ----
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
131 ----
132
133 == 3. POC2 Interface Enhancements ==
134
135 === 3.1 Added Features ===
136
137 **Scenario Display:**
138 {{code}}┌──────────────────────────────────────┐
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 │ │
152 └──────────────────────────────────────┘{{/code}}
153
154 **Evidence Provenance:**
155
156 * Show if multiple sources cite same underlying evidence
157 * Display deduplication results
158 * Provenance chain visualization
159
160 **Quality Metrics Dashboard:**
161
162 * Internal view showing all 4 gates
163 * Historical performance trends
164 * Hallucination rate tracking
165
166 ----
167
168 == 4. Full System Design (V1.0+) ==
169
170 === 4.1 Additional Features ===
171
172 **User Accounts:**
173
174 * Save analyses
175 * Track corrections
176 * Contribute feedback
177
178 **Advanced Search:**
179
180 * Find previous analyses
181 * Filter by topic, verdict type
182 * Sort by date, relevance
183
184 **Corrections Banner:**
185 {{code}}┌──────────────────────────────────────┐
186 │ ⚠️ This analysis was corrected │
187 │ [View correction log →] │
188 └──────────────────────────────────────┘{{/code}}
189
190 **Public Quality Dashboard:**
191
192 * Real-time metrics
193 * Transparency reports
194 * Historical trends
195
196 ----
197
198 == 5. Responsive Design ==
199
200 **Mobile-First Approach:**
201
202 * Single column layout
203 * Touch-friendly targets
204 * Collapsible sections by default
205 * Fast load times
206
207 **Desktop Enhancements:**
208
209 * Multi-column layout where appropriate
210 * Side-by-side evidence comparison
211 * Advanced filters always visible
212
213 ----
214
215 == 6. Accessibility ==
216
217 **WCAG 2.1 AA Compliance:**
218
219 * Keyboard navigation
220 * Screen reader support
221 * Color contrast ratios
222 * Alternative text for icons
223 * Focus indicators
224
225 ----
226
227 == 7. Related Pages ==
228
229 * [[Architecture>>Archive.FactHarbor delta for V0\.9\.70.Specification.Architecture.WebHome]] - System architecture
230 * [[Requirements>>Archive.FactHarbor delta for V0\.9\.70.Specification.Requirements.WebHome]] - UI requirements
231 * [[Roadmap>>Archive.FactHarbor delta for V0\.9\.70.Roadmap.WebHome]] - Implementation phases
232
233 ----
234
235 **Document Status:** ✅ Design Specified (POC1, POC2, V1.0)
236 **Version:** V0.9.70