Skip to Content

Wiki source code of System Design

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