Skip to Content

Wiki source code of Requirements (V0.9.70)

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