Wiki source code of Requirements Roadmap Matrix
Version 1.1 by Robert Schaub on 2025/12/23 12:09
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | = Requirements Roadmap Matrix = |
| 2 | |||
| 3 | **Last Updated:** 2025-12-23 | ||
| 4 | **Version:** 1.0 | ||
| 5 | **Status:** Authoritative Source | ||
| 6 | |||
| 7 | {{info}} | ||
| 8 | **Purpose:** This is the single source of truth for requirement-to-phase mapping. All other documents reference this matrix rather than duplicating phase information. | ||
| 9 | {{/info}} | ||
| 10 | |||
| 11 | --- | ||
| 12 | |||
| 13 | == Phase Definitions == | ||
| 14 | |||
| 15 | |= Phase |= Goal |= Timeline |= Key Focus | ||
| 16 | | **POC1** | Prove AI can analyze claims automatically | Initial development | Core workflow + quality gates | ||
| 17 | | **POC2** | Improve reliability and robustness | After POC1 validation | Quality improvements, deduplication | ||
| 18 | | **Beta 0** | User testing with limited audience | Before public launch | Production readiness, user features | ||
| 19 | | **V1.0** | Public production launch | Initial release | IFCN compliance, search visibility | ||
| 20 | | **V1.1** | First major feature expansion | Post-launch | Advanced media verification | ||
| 21 | | **V1.5** | Second feature expansion | Later phase | Education and collaboration | ||
| 22 | | **V2.0** | Advanced capabilities | Future | Comprehensive toolset | ||
| 23 | |||
| 24 | **Phase Philosophy:** Each phase builds on proven capabilities from previous phases. We validate AI quality before adding production features. | ||
| 25 | |||
| 26 | |||
| 27 | |||
| 28 | == Requirement Categories == | ||
| 29 | |||
| 30 | **This matrix covers two types of requirements:** | ||
| 31 | |||
| 32 | **1. Formal System Requirements (16 requirements)** | ||
| 33 | |||
| 34 | These are the primary requirements with full specifications in the [[Requirements>>Test.FactHarbor.Specification.Requirements.WebHome]] page: | ||
| 35 | * **FR4, FR7** - Core claim analysis capabilities | ||
| 36 | * **FR44-FR54** - Advanced features and future enhancements | ||
| 37 | * **NFR11-NFR13** - Quality, security, and metrics | ||
| 38 | |||
| 39 | **2. POC-Specific Requirements (referenced for completeness)** | ||
| 40 | |||
| 41 | These are detailed in [[POC Requirements>>Test.FactHarbor.Specification.POC.Requirements]] for POC1 implementation but do not have separate formal specification sections: | ||
| 42 | * **FR1-FR3, FR5-FR6, FR8, FR11, FR13** - POC workflow requirements that map to formal requirements (e.g., FR1-FR6 → FR7, FR11 → NFR11) | ||
| 43 | * **NFR1-NFR3** - Basic quality attributes partially addressed in POC1 | ||
| 44 | |||
| 45 | **Mapping:** POC-specific requirements are implementation-level details of formal requirements. For example: | ||
| 46 | * FR1 (Claim Extraction), FR2 (Context), FR3 (Scenarios), FR5 (Evidence Collection), FR6 (Source Quality) → All part of **FR7 (Automated Verdicts)** | ||
| 47 | * FR11 (Audit Trail) → Part of **NFR11 (Quality Assurance)** | ||
| 48 | * NFR1-NFR3 (Explainability, Performance, Transparency) → Addressed in **NFR11 and NFR13** | ||
| 49 | |||
| 50 | {{info}} | ||
| 51 | **For phase planning:** Use the formal requirements (FR4, FR7, FR44-FR54, NFR11-NFR13) as the primary planning units. POC-specific requirements are implementation details within those formal requirements. | ||
| 52 | {{/info}} | ||
| 53 | |||
| 54 | --- | ||
| 55 | |||
| 56 | == Requirements by Phase == | ||
| 57 | |||
| 58 | **Note:** Implementation levels indicate progression: | ||
| 59 | * **Basic** - Minimal viable implementation | ||
| 60 | * **Enhanced** - Improved with additional capabilities | ||
| 61 | * **Extended** - Additional features added | ||
| 62 | * **Complete** - Full feature set as specified | ||
| 63 | * **Full** - Everything specified implemented | ||
| 64 | |||
| 65 | --- | ||
| 66 | |||
| 67 | === POC1: Core Workflow with Quality Gates === | ||
| 68 | |||
| 69 | **Goal:** Prove that AI can extract claims and determine verdicts automatically without human intervention | ||
| 70 | |||
| 71 | |= ID |= Title |= Level |= Notes | ||
| 72 | | **FR1** | Claim Extraction | Full | AKEL extracts factual claims from articles | ||
| 73 | | **FR2** | Claim Context | Basic | Context preserved with claim | ||
| 74 | | **FR3** | Multiple Scenarios | Full | AKEL generates interpretation scenarios | ||
| 75 | | **FR4** | Analysis Summary | Basic | Simple summary format; quality metadata deferred to POC2 | ||
| 76 | | **FR5** | Evidence Collection | Basic | AI searches for relevant evidence | ||
| 77 | | **FR6** | Source Quality Assessment | Basic | Basic source reliability scoring | ||
| 78 | | **FR7** | Automated Verdicts | Full | With 4 quality gates (NFR11) | ||
| 79 | | **NFR1** | Explainability | Partial | Basic explanations only | ||
| 80 | | **NFR2** | Performance | Partial | Functional but not optimized | ||
| 81 | | **NFR3** | Transparency | Partial | Basic transparency | ||
| 82 | | **NFR11** | AKEL Quality Assurance Framework | Basic | 4 quality gates implemented | ||
| 83 | |||
| 84 | **Total:** 8 full requirements + 3 partial NFRs | ||
| 85 | |||
| 86 | **User Needs Fulfilled in POC1:** | ||
| 87 | * UN-1: Trust Assessment at a Glance | ||
| 88 | * UN-2: Claim Extraction and Verification | ||
| 89 | * UN-3: Article Summary with FactHarbor Analysis Summary | ||
| 90 | * UN-4: Social Media Fact-Checking | ||
| 91 | * UN-5: Source Provenance and Track Records | ||
| 92 | * UN-6: Publisher Reliability History | ||
| 93 | * UN-7: Evidence Transparency | ||
| 94 | * UN-8: Understanding Disagreement and Consensus | ||
| 95 | * UN-9: Methodology Transparency | ||
| 96 | * UN-12: Submit Unchecked Claims | ||
| 97 | |||
| 98 | --- | ||
| 99 | |||
| 100 | === POC2: Robust Quality & Reliability === | ||
| 101 | |||
| 102 | **Goal:** Improve system reliability and add essential quality features | ||
| 103 | |||
| 104 | |= ID |= Title |= Level |= Notes | ||
| 105 | | **FR4** | Analysis Summary | Enhanced | Add quality metadata display | ||
| 106 | | **FR8** | Time Evolution Tracking | Basic | Track verdict changes over time | ||
| 107 | | **FR54** | Evidence Deduplication | Basic | Prevent duplicate evidence processing | ||
| 108 | | **NFR11** | AKEL Quality Assurance Framework | Enhanced | Add confidence thresholds and advanced validation | ||
| 109 | | **NFR13** | Quality Metrics Transparency | Internal | Quality dashboard for team only (not public yet) | ||
| 110 | |||
| 111 | **Total:** 5 requirements (4 new + 1 enhancement) | ||
| 112 | |||
| 113 | **Additional User Needs Fulfilled:** | ||
| 114 | * UN-11: Filtered Research (via FR54) | ||
| 115 | * UN-15: Verdict Evolution Timeline (via FR8) | ||
| 116 | |||
| 117 | --- | ||
| 118 | |||
| 119 | === Beta 0: User Testing & Production Readiness === | ||
| 120 | |||
| 121 | **Goal:** Prepare for public launch with essential user-facing features and security | ||
| 122 | |||
| 123 | |= ID |= Title |= Level |= Notes | ||
| 124 | | **FR11** | Audit Trail | Basic | Track all system changes | ||
| 125 | | **FR13** | In-Article Claim Highlighting | Basic | Highlight claims within articles | ||
| 126 | | **FR45** | User Corrections Notification System | Basic | Banner + correction log only; email and RSS deferred | ||
| 127 | | **FR46** | Image Verification System | Basic | Reverse image search only; manipulation detection deferred | ||
| 128 | | **FR47** | Archive.org Integration | Basic | Wayback Machine preservation | ||
| 129 | | **NFR12** | Security Controls | Essential | Core security (API limits, encryption, input sanitization) | ||
| 130 | | **NFR13** | Quality Metrics Transparency | Public | Public quality dashboard launched | ||
| 131 | |||
| 132 | **Total:** 7 requirements (6 new + 1 enhancement from POC2) | ||
| 133 | |||
| 134 | **Additional User Needs Fulfilled:** | ||
| 135 | * UN-13: Cite FactHarbor Verdicts (via FR13) | ||
| 136 | * UN-17: In-Article Claim Highlighting (via FR13) | ||
| 137 | * UN-27: Visual Claim Verification (partial, via FR46 basic) | ||
| 138 | |||
| 139 | --- | ||
| 140 | |||
| 141 | === V1.0: Public Production Launch === | ||
| 142 | |||
| 143 | **Goal:** Full production launch with IFCN compliance and search engine visibility | ||
| 144 | |||
| 145 | |= ID |= Title |= Level |= Notes | ||
| 146 | | **FR44** | ClaimReview Schema Implementation | Full | Google/Bing search visibility **BLOCKER** | ||
| 147 | | **FR45** | User Corrections Notification System | Complete | All 4 mechanisms: banner, log, email, RSS **BLOCKER** | ||
| 148 | | **FR46** | Image Verification System | Extended | Add manipulation detection and EXIF analysis | ||
| 149 | | **FR48** | Safety Framework for Contributors | Full | Harassment protection, pseudonymity, legal support | ||
| 150 | | **FR49** | A/B Testing Framework | Full | Systematic testing infrastructure | ||
| 151 | | **NFR12** | Security Controls | Complete | Full OWASP Top 10 compliance, security audits **BLOCKER** | ||
| 152 | |||
| 153 | **Total:** 6 requirements (3 new + 3 enhancements from Beta 0) | ||
| 154 | |||
| 155 | **Additional User Needs Fulfilled:** | ||
| 156 | * UN-14: API Access for Integration (via production infrastructure) | ||
| 157 | * UN-26: Search Engine Visibility (via FR44) | ||
| 158 | * UN-27: Visual Claim Verification (complete, via FR46 extended) | ||
| 159 | * UN-28: Safe Contribution Environment (via FR48) | ||
| 160 | |||
| 161 | **V1.0 Launch Criteria:** | ||
| 162 | * ✅ ClaimReview schema passes Google validator (FR44) | ||
| 163 | * ✅ IFCN Principle 5 compliant (FR45 complete) | ||
| 164 | * ✅ Security audit passed (NFR12 complete) | ||
| 165 | * ✅ Quality metrics public and stable (NFR13) | ||
| 166 | |||
| 167 | --- | ||
| 168 | |||
| 169 | === V1.1: First Major Feature Expansion === | ||
| 170 | |||
| 171 | **Goal:** Add advanced media verification capabilities | ||
| 172 | |||
| 173 | |= ID |= Title |= Level |= Notes | ||
| 174 | | **FR50** | OSINT Toolkit Integration | Full | Geolocation, chronolocation, social media analysis | ||
| 175 | | **FR51** | Video Verification System | Full | Deepfake detection, frame analysis, audio forensics | ||
| 176 | |||
| 177 | **Total:** 2 new requirements | ||
| 178 | |||
| 179 | **User Needs:** Enhances UN-27 (Visual Claim Verification) with video capabilities | ||
| 180 | |||
| 181 | --- | ||
| 182 | |||
| 183 | === V1.5: Second Feature Expansion === | ||
| 184 | |||
| 185 | **Goal:** Education and cross-organizational collaboration | ||
| 186 | |||
| 187 | |= ID |= Title |= Level |= Notes | ||
| 188 | | **FR52** | Interactive Detection Training | Full | Media literacy education modules | ||
| 189 | | **FR53** | Cross-Organizational Sharing | Full | Share claim databases and evidence with partner organizations | ||
| 190 | |||
| 191 | **Total:** 2 new requirements | ||
| 192 | |||
| 193 | **Additional User Needs Fulfilled:** | ||
| 194 | * UN-10: Manipulation Tactics Detection (via FR52 training) | ||
| 195 | |||
| 196 | --- | ||
| 197 | |||
| 198 | == Requirements Summary by Phase == | ||
| 199 | |||
| 200 | |= Phase |= New Requirements |= Enhancements |= Total Implemented |= Cumulative Total | ||
| 201 | | **POC1** | 11 (8 full + 3 partial) | 0 | 11 | 11 | ||
| 202 | | **POC2** | 4 | 1 (FR4) | 5 | 16 | ||
| 203 | | **Beta 0** | 6 | 1 (NFR13) | 7 | 23 | ||
| 204 | | **V1.0** | 3 | 3 (FR45, FR46, NFR12) | 6 | 29 | ||
| 205 | | **V1.1** | 2 | 0 | 2 | 31 | ||
| 206 | | **V1.5** | 2 | 0 | 2 | 33 | ||
| 207 | |||
| 208 | **Total Unique Requirements:** 17 (FR1-FR8, FR11, FR13, FR44-FR54, NFR1-NFR3, NFR11-NFR13) | ||
| 209 | |||
| 210 | --- | ||
| 211 | |||
| 212 | == User Needs by Phase == | ||
| 213 | |||
| 214 | **Summary of when each User Need is fulfilled:** | ||
| 215 | |||
| 216 | |= User Need |= Fulfilled in Phase |= Via Requirements | ||
| 217 | | **UN-1** | POC1 | FR7, NFR13 | ||
| 218 | | **UN-2** | POC1 | FR7 | ||
| 219 | | **UN-3** | POC1 | FR4 | ||
| 220 | | **UN-4** | POC1 | FR7 | ||
| 221 | | **UN-5** | POC1 | FR4, FR6 | ||
| 222 | | **UN-6** | POC1 | FR4, FR6 | ||
| 223 | | **UN-7** | POC1 | FR4, NFR13 | ||
| 224 | | **UN-8** | POC1 | FR7, FR3 | ||
| 225 | | **UN-9** | POC1 | NFR13 | ||
| 226 | | **UN-10** | V1.5 | FR52 | ||
| 227 | | **UN-11** | POC2 | FR54 | ||
| 228 | | **UN-12** | POC1 | FR7 | ||
| 229 | | **UN-13** | Beta 0 | FR13, FR44 | ||
| 230 | | **UN-14** | V1.0 | Production API infrastructure | ||
| 231 | | **UN-15** | POC2 | FR8, NFR13 | ||
| 232 | | **UN-16** | POC1 | NFR13 | ||
| 233 | | **UN-17** | Beta 0 | FR13 | ||
| 234 | | **UN-26** | V1.0 | FR44 | ||
| 235 | | **UN-27** | Beta 0 (basic), V1.0 (extended), V1.1 (video) | FR46, FR51 | ||
| 236 | | **UN-28** | V1.0 | FR48 | ||
| 237 | |||
| 238 | **Total User Needs:** 20 | ||
| 239 | |||
| 240 | --- | ||
| 241 | |||
| 242 | == Requirements Without Phase Assignments == | ||
| 243 | |||
| 244 | {{warning}} | ||
| 245 | If any requirements appear here, they need phase assignment. | ||
| 246 | {{/warning}} | ||
| 247 | |||
| 248 | **Current Status:** All 17 requirements have phase assignments ✅ | ||
| 249 | |||
| 250 | --- | ||
| 251 | |||
| 252 | == References == | ||
| 253 | |||
| 254 | **This matrix is referenced by:** | ||
| 255 | * [[Requirements>>Test.FactHarbor.Specification.Requirements.WebHome]] - Main requirements specification | ||
| 256 | * [[POC Requirements>>Test.FactHarbor.Specification.POC.Requirements]] - POC1 detailed specifications | ||
| 257 | * [[Implementation Roadmap>>Test.FactHarbor.Roadmap.WebHome]] - High-level phase descriptions | ||
| 258 | * [[Requirements Priority Matrix>>Test.FactHarbor.Specification.Requirements.Priority-Matrix.WebHome]] - Importance/Urgency prioritization | ||
| 259 | |||
| 260 | **Maintenance:** | ||
| 261 | * Update this matrix when adding new requirements | ||
| 262 | * Update this matrix when changing phase assignments | ||
| 263 | * Verify other documents still reference correctly after updates | ||
| 264 | |||
| 265 | --- | ||
| 266 | |||
| 267 | **Last Review:** 2025-12-23 | ||
| 268 | **Next Review:** After POC1 completion or when adding new requirements | ||
| 269 |