Skip to Content

Wiki source code of Requirements (V0.9.70)

Last modified by Robert Schaub on 2025/12/24 20:35
Show last authors
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
19 Ensure claims are factual, not opinions/predictions.
20
21 **Implementation:** POC1
22
23 ----
24
25 ==== Gate 2: Evidence Relevance ====
26
27 Ensure evidence actually relates to claim.
28
29 **Checks:**
30
31 * Semantic similarity ≥ 0.6
32 * Entity overlap ≥ 1
33 * Topic relevance ≥ 0.5
34
35 **Implementation:** POC2
36
37 ----
38
39 ==== Gate 3: Scenario Coherence ====
40
41 Validate scenario logic and completeness.
42
43 **Checks:**
44
45 * All fields complete
46 * Internal consistency > 0.7
47 * Scenarios distinct (similarity < 0.8)
48
49 **Implementation:** POC2
50
51 ----
52
53 ==== Gate 4: Verdict Confidence ====
54
55 Only publish high-confidence verdicts.
56
57 **Minimum Requirements:**
58
59 * ≥2 independent sources
60 * Average quality ≥ 0.6
61 * Evidence agreement ≥ 0.6
62
63 **Implementation:** POC1
64
65 ----
66
67 **Quality Targets:**
68
69 * POC1: <10% hallucinations (Gates 1 & 4)
70 * POC2: <5% hallucinations (All 4 gates)
71 * V1.0: <5% hallucinations sustained
72
73 ----
74
75 === NFR12: Security Controls ===
76
77 **Priority:** CRITICAL - V1.0 BLOCKER
78
79 **Requirements:**
80
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:**
88
89 * Beta 0: Essential controls
90 * V1.0: Full audit, 0 critical/high vulnerabilities
91
92 ----
93
94 === NFR13: Quality Metrics Transparency ===
95
96 **Priority:** HIGH - Production expectation
97
98 **Public Metrics:**
99
100 * Claims analyzed
101 * Quality gates performance
102 * Hallucination rate
103 * Evidence quality
104 * User feedback
105
106 **Implementation:**
107
108 * POC2: Internal dashboard
109 * Beta 0: Public page
110 * V1.0: Real-time dashboard
111
112 ----
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:**
123
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
132 ----
133
134 === FR45: Corrections Notification ===
135
136 **Priority:** CRITICAL - IFCN compliance
137
138 Notify users when analyses are corrected.
139
140 **Mechanisms:**
141
142 1. In-page banner
143 2. Public correction log
144 3. Email notifications
145 4. RSS/API feed
146
147 **Implementation:**
148
149 * Beta 0: Basic (banner, log)
150 * V1.0: Complete (all mechanisms)
151
152 ----
153
154 === FR46: Image Verification ===
155
156 **Priority:** HIGH
157
158 **Methods:**
159
160 1. Reverse image search
161 2. EXIF metadata analysis
162 3. Basic manipulation detection
163 4. Context verification
164
165 **Implementation:**
166
167 * Beta 0: Basic
168 * V1.0: Extended
169
170 ----
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
180 ----
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
190 ----
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
200 ----
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
211 ----
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
222 ----
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:**
241
242 * PUBLISHED
243 * INSUFFICIENT_EVIDENCE
244 * NON_FACTUAL_CLAIM
245 * PROCESSING
246 * ERROR
247
248 ----
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
264 ----
265
266 == Related Pages ==
267
268 * [[User Needs>>Archive.FactHarbor delta for V0\.9\.70.Specification.Requirements.User Needs.WebHome]]
269 * [[Gap Analysis>>Test.FactHarbor.Specification.Requirements.GapAnalysis]]
270 * [[Architecture>>Archive.FactHarbor delta for V0\.9\.70.Specification.Architecture.WebHome]]
271 * [[Roadmap>>Archive.FactHarbor delta for V0\.9\.70.Roadmap.WebHome]]
272
273 ----
274
275 **Document Status:** ✅ V0.9.70 Requirements Complete
276 **Version:** V0.9.70