Skip to Content

Wiki source code of System Design

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