Skip to Content

Wiki source code of System Design

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