Skip to Content

Wiki source code of Requirements (V0.9.70)

Version 1.3 by Robert Schaub on 2025/12/21 13:38
Hide last authors
Robert Schaub 1.1 1 = Requirements =
2
3 **This page defines system requirements for FactHarbor V0.9.70**
4
5 **Note:** This is a test import showing V0.9.70 additions. For complete FR1-FR43 and NFR1-NFR5, see production Requirements.WebHome.
6
Robert Schaub 1.3 7 ----
Robert Schaub 1.1 8
9 == Non-Functional Requirements (V0.9.70 Additions) ==
10
11 === NFR11: AKEL Quality Assurance Framework ===
12
13 **Priority:** CRITICAL - Prevents hallucinations
14
15 **4-Gate Quality System:**
16
17 ==== Gate 1: Claim Validation ====
Robert Schaub 1.2 18
Robert Schaub 1.1 19 Ensure claims are factual, not opinions/predictions.
20
21 **Implementation:** POC1
22
Robert Schaub 1.3 23 ----
Robert Schaub 1.1 24
25 ==== Gate 2: Evidence Relevance ====
Robert Schaub 1.2 26
Robert Schaub 1.1 27 Ensure evidence actually relates to claim.
28
29 **Checks:**
Robert Schaub 1.2 30
Robert Schaub 1.1 31 * Semantic similarity ≥ 0.6
32 * Entity overlap ≥ 1
33 * Topic relevance ≥ 0.5
34
35 **Implementation:** POC2
36
Robert Schaub 1.3 37 ----
Robert Schaub 1.1 38
39 ==== Gate 3: Scenario Coherence ====
Robert Schaub 1.2 40
Robert Schaub 1.1 41 Validate scenario logic and completeness.
42
43 **Checks:**
Robert Schaub 1.2 44
Robert Schaub 1.1 45 * All fields complete
46 * Internal consistency > 0.7
47 * Scenarios distinct (similarity < 0.8)
48
49 **Implementation:** POC2
50
Robert Schaub 1.3 51 ----
Robert Schaub 1.1 52
53 ==== Gate 4: Verdict Confidence ====
Robert Schaub 1.2 54
Robert Schaub 1.1 55 Only publish high-confidence verdicts.
56
57 **Minimum Requirements:**
Robert Schaub 1.2 58
Robert Schaub 1.1 59 * ≥2 independent sources
60 * Average quality ≥ 0.6
61 * Evidence agreement ≥ 0.6
62
63 **Implementation:** POC1
64
Robert Schaub 1.3 65 ----
Robert Schaub 1.1 66
67 **Quality Targets:**
Robert Schaub 1.2 68
Robert Schaub 1.1 69 * POC1: <10% hallucinations (Gates 1 & 4)
70 * POC2: <5% hallucinations (All 4 gates)
71 * V1.0: <5% hallucinations sustained
72
Robert Schaub 1.3 73 ----
Robert Schaub 1.1 74
75 === NFR12: Security Controls ===
76
77 **Priority:** CRITICAL - V1.0 BLOCKER
78
79 **Requirements:**
Robert Schaub 1.2 80
Robert Schaub 1.1 81 1. Input Validation (SQL injection, XSS, CSRF)
82 2. Rate Limiting
83 3. Authentication & Authorization
84 4. Data Protection (HTTPS, encryption)
85 5. Security Audit (penetration testing)
86
87 **Implementation:**
Robert Schaub 1.2 88
Robert Schaub 1.1 89 * Beta 0: Essential controls
90 * V1.0: Full audit, 0 critical/high vulnerabilities
91
Robert Schaub 1.3 92 ----
Robert Schaub 1.1 93
94 === NFR13: Quality Metrics Transparency ===
95
96 **Priority:** HIGH - Production expectation
97
98 **Public Metrics:**
Robert Schaub 1.2 99
Robert Schaub 1.1 100 * Claims analyzed
101 * Quality gates performance
102 * Hallucination rate
103 * Evidence quality
104 * User feedback
105
106 **Implementation:**
Robert Schaub 1.2 107
Robert Schaub 1.1 108 * POC2: Internal dashboard
109 * Beta 0: Public page
110 * V1.0: Real-time dashboard
111
Robert Schaub 1.3 112 ----
Robert Schaub 1.1 113
114 == Functional Requirements (V0.9.70 Additions) ==
115
116 === FR44: ClaimReview Schema ===
117
118 **Priority:** CRITICAL - V1.0 BLOCKER
119
120 Generate valid ClaimReview structured data for Google/Bing visibility.
121
122 **Schema.org Mapping:**
Robert Schaub 1.2 123
Robert Schaub 1.1 124 * 80-100% → 5 (Highly Supported)
125 * 60-79% → 4 (Supported)
126 * 40-59% → 3 (Mixed)
127 * 20-39% → 2 (Questionable)
128 * 0-19% → 1 (Refuted)
129
130 **Implementation:** V1.0
131
Robert Schaub 1.3 132 ----
Robert Schaub 1.1 133
134 === FR45: Corrections Notification ===
135
136 **Priority:** CRITICAL - IFCN compliance
137
138 Notify users when analyses are corrected.
139
140 **Mechanisms:**
Robert Schaub 1.2 141
Robert Schaub 1.1 142 1. In-page banner
143 2. Public correction log
144 3. Email notifications
145 4. RSS/API feed
146
147 **Implementation:**
Robert Schaub 1.2 148
Robert Schaub 1.1 149 * Beta 0: Basic (banner, log)
150 * V1.0: Complete (all mechanisms)
151
Robert Schaub 1.3 152 ----
Robert Schaub 1.1 153
154 === FR46: Image Verification ===
155
156 **Priority:** HIGH
157
158 **Methods:**
Robert Schaub 1.2 159
Robert Schaub 1.1 160 1. Reverse image search
161 2. EXIF metadata analysis
162 3. Basic manipulation detection
163 4. Context verification
164
165 **Implementation:**
Robert Schaub 1.2 166
Robert Schaub 1.1 167 * Beta 0: Basic
168 * V1.0: Extended
169
Robert Schaub 1.3 170 ----
Robert Schaub 1.1 171
172 === FR47: Archive.org Integration ===
173
174 **Priority:** MEDIUM-HIGH
175
176 Auto-save all evidence sources to Wayback Machine.
177
178 **Implementation:** Beta 0
179
Robert Schaub 1.3 180 ----
Robert Schaub 1.1 181
182 === FR48: Safety Framework ===
183
184 **Priority:** HIGH
185
186 Protect contributors from harassment and legal threats.
187
188 **Implementation:** V1.x (post-launch)
189
Robert Schaub 1.3 190 ----
Robert Schaub 1.1 191
192 === FR49: A/B Testing ===
193
194 **Priority:** MEDIUM-HIGH
195
196 Test AKEL approaches and UI designs systematically.
197
198 **Implementation:** V1.0
199
Robert Schaub 1.3 200 ----
Robert Schaub 1.1 201
202 === FR50-FR53: Future (V2.0+) ===
203
204 * FR50: OSINT Toolkit
205 * FR51: Video Verification
206 * FR52: Interactive Training
207 * FR53: Cross-Org Sharing
208
209 **Implementation:** V2.0+
210
Robert Schaub 1.3 211 ----
Robert Schaub 1.1 212
213 === FR54: Evidence Deduplication ===
214
215 **Priority:** HIGH
216 **Fulfills:** Accurate evidence counting
217
218 Prevent counting same evidence multiple times when cited by different sources.
219
220 **Implementation:** POC2
221
Robert Schaub 1.3 222 ----
Robert Schaub 1.1 223
224 == Enhanced Existing Requirements ==
225
226 === FR7: Automated Verdicts (Quality Gate Integration) ===
227
228 **POC1+ Enhancement:**
229
230 Verdicts pass through quality gates:
231
232 {{code}}
233 1. Extract claims
234 2. [GATE 1] Validate factual
235 3. Generate verdicts
236 4. [GATE 4] Validate confidence
237 5. Display
238 {{/code}}
239
240 **New Verdict States:**
Robert Schaub 1.2 241
Robert Schaub 1.1 242 * PUBLISHED
243 * INSUFFICIENT_EVIDENCE
244 * NON_FACTUAL_CLAIM
245 * PROCESSING
246 * ERROR
247
Robert Schaub 1.3 248 ----
Robert Schaub 1.1 249
250 === FR4: Analysis Summary (Quality Metadata) ===
251
252 **POC1+ Enhancement:**
253
254 Display quality indicators:
255
256 {{code}}
257 Verifiable Claims: 3/5
258 High Confidence: 1
259 Medium Confidence: 2
260 Evidence Sources: 12
261 Quality Score: 8.5/10
262 {{/code}}
263
Robert Schaub 1.3 264 ----
Robert Schaub 1.1 265
266 == Related Pages ==
267
268 * [[User Needs>>Test.FactHarbor.Specification.Requirements.User Needs.WebHome]]
269 * [[Gap Analysis>>Test.FactHarbor.Specification.Requirements.GapAnalysis]]
Robert Schaub 1.3 270 * [[Architecture>>FactHarbor.Archive.FactHarbor delta for V0\.9\.70.Specification.Architecture.WebHome]]
Robert Schaub 1.2 271 * [[Roadmap>>FactHarbor.Archive.FactHarbor delta for V0\.9\.70.Roadmap.WebHome]]
Robert Schaub 1.1 272
Robert Schaub 1.3 273 ----
Robert Schaub 1.1 274
275 **Document Status:** ✅ V0.9.70 Requirements Complete
276 **Version:** V0.9.70