Changes for page System Design

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

From version 1.1
edited by Robert Schaub
on 2025/12/21 11:25
Change comment: Imported from XAR
To version 1.2
edited by Robert Schaub
on 2025/12/21 13:38
Change comment: Renamed back-links.

Summary

Details

Page properties
Content
... ... @@ -2,11 +2,12 @@
2 2  
3 3  **UI/UX design for FactHarbor including POC and production interfaces**
4 4  
5 ----
5 +-----
6 6  
7 7  == 1. Design Philosophy ==
8 8  
9 9  **Core Principles:**
10 +
10 10  1. **Transparency First:** Show how verdicts were reached
11 11  2. **Clarity Over Completeness:** Don't overwhelm users
12 12  3. **Progressive Disclosure:** Details available on demand
... ... @@ -13,7 +13,7 @@
13 13  4. **Quality Indicators Visible:** Users should see confidence levels immediately
14 14  5. **Mobile-First:** Majority of users on mobile devices
15 15  
16 ----
17 +-----
17 17  
18 18  == 2. POC1 Interface Design ==
19 19  
... ... @@ -39,11 +39,12 @@
39 39  {{/code}}
40 40  
41 41  **Design Notes:**
43 +
42 42  * Simple, single-purpose interface
43 43  * Clear POC disclaimer
44 44  * No authentication/accounts needed
45 45  
46 ----
48 +-----
47 47  
48 48  === 2.2 Results Display ===
49 49  
... ... @@ -85,12 +85,13 @@
85 85  {{/code}}
86 86  
87 87  **Design Features:**
90 +
88 88  * Quality score prominently displayed
89 89  * Color coding for verdict confidence
90 90  * Expandable details (progressive disclosure)
91 91  * Clear blocked claims with explanations
92 92  
93 ----
96 +-----
94 94  
95 95  === 2.3 Claim Detail View ===
96 96  
... ... @@ -125,7 +125,7 @@
125 125  └──────────────────────────────────────┘
126 126  {{/code}}
127 127  
128 ----
131 +-----
129 129  
130 130  == 3. POC2 Interface Enhancements ==
131 131  
... ... @@ -132,8 +132,7 @@
132 132  === 3.1 Added Features ===
133 133  
134 134  **Scenario Display:**
135 -{{code}}
136 -┌──────────────────────────────────────┐
138 +{{code}}┌──────────────────────────────────────┐
137 137  │ CLAIM: [text] │
138 138  ├──────────────────────────────────────┤
139 139  │ │
... ... @@ -147,20 +147,21 @@
147 147  │ Verdict: UNCERTAIN (45%) │
148 148  │ [Show details ▼] │
149 149  │ │
150 -└──────────────────────────────────────┘
151 -{{/code}}
152 +└──────────────────────────────────────┘{{/code}}
152 152  
153 153  **Evidence Provenance:**
155 +
154 154  * Show if multiple sources cite same underlying evidence
155 155  * Display deduplication results
156 156  * Provenance chain visualization
157 157  
158 158  **Quality Metrics Dashboard:**
161 +
159 159  * Internal view showing all 4 gates
160 160  * Historical performance trends
161 161  * Hallucination rate tracking
162 162  
163 ----
166 +-----
164 164  
165 165  == 4. Full System Design (V1.0+) ==
166 166  
... ... @@ -167,33 +167,35 @@
167 167  === 4.1 Additional Features ===
168 168  
169 169  **User Accounts:**
173 +
170 170  * Save analyses
171 171  * Track corrections
172 172  * Contribute feedback
173 173  
174 174  **Advanced Search:**
179 +
175 175  * Find previous analyses
176 176  * Filter by topic, verdict type
177 177  * Sort by date, relevance
178 178  
179 179  **Corrections Banner:**
180 -{{code}}
181 -┌──────────────────────────────────────┐
185 +{{code}}┌──────────────────────────────────────┐
182 182  │ ⚠️ This analysis was corrected │
183 183  │ [View correction log →] │
184 -└──────────────────────────────────────┘
185 -{{/code}}
188 +└──────────────────────────────────────┘{{/code}}
186 186  
187 187  **Public Quality Dashboard:**
191 +
188 188  * Real-time metrics
189 189  * Transparency reports
190 190  * Historical trends
191 191  
192 ----
196 +-----
193 193  
194 194  == 5. Responsive Design ==
195 195  
196 196  **Mobile-First Approach:**
201 +
197 197  * Single column layout
198 198  * Touch-friendly targets
199 199  * Collapsible sections by default
... ... @@ -200,15 +200,17 @@
200 200  * Fast load times
201 201  
202 202  **Desktop Enhancements:**
208 +
203 203  * Multi-column layout where appropriate
204 204  * Side-by-side evidence comparison
205 205  * Advanced filters always visible
206 206  
207 ----
213 +-----
208 208  
209 209  == 6. Accessibility ==
210 210  
211 211  **WCAG 2.1 AA Compliance:**
218 +
212 212  * Keyboard navigation
213 213  * Screen reader support
214 214  * Color contrast ratios
... ... @@ -215,16 +215,15 @@
215 215  * Alternative text for icons
216 216  * Focus indicators
217 217  
218 ----
225 +-----
219 219  
220 220  == 7. Related Pages ==
221 221  
222 222  * [[Architecture>>Test.FactHarbor.Specification.Architecture.WebHome]] - System architecture
223 223  * [[Requirements>>Test.FactHarbor.Specification.Requirements.WebHome]] - UI requirements
224 -* [[Roadmap>>Test.FactHarbor.Roadmap.WebHome]] - Implementation phases
231 +* [[Roadmap>>FactHarbor.Archive.FactHarbor delta for V0\.9\.70.Roadmap.WebHome]] - Implementation phases
225 225  
226 ----
233 +-----
227 227  
228 228  **Document Status:** ✅ Design Specified (POC1, POC2, V1.0)
229 229  **Version:** V0.9.70
230 -