Requirements

This page defines system requirements for FactHarbor V0.9.70

Note: This is a test import showing V0.9.70 additions. For complete FR1-FR43 and NFR1-NFR5, see production Requirements.WebHome.

Non-Functional Requirements (V0.9.70 Additions)

NFR11: AKEL Quality Assurance Framework

Priority: CRITICAL - Prevents hallucinations

4-Gate Quality System:

Gate 1: Claim Validation

Ensure claims are factual, not opinions/predictions.

Implementation: POC1

Gate 2: Evidence Relevance

Ensure evidence actually relates to claim.

Checks:

• Semantic similarity ≥ 0.6
• Entity overlap ≥ 1
• Topic relevance ≥ 0.5

Implementation: POC2

Gate 3: Scenario Coherence

Validate scenario logic and completeness.

Checks:

• All fields complete
• Internal consistency > 0.7
• Scenarios distinct (similarity < 0.8)

Implementation: POC2

Gate 4: Verdict Confidence

Only publish high-confidence verdicts.

Minimum Requirements:

• ≥2 independent sources
• Average quality ≥ 0.6
• Evidence agreement ≥ 0.6

Implementation: POC1

Quality Targets:

• POC1: <10% hallucinations (Gates 1 & 4)
• POC2: <5% hallucinations (All 4 gates)
• V1.0: <5% hallucinations sustained

NFR12: Security Controls

Priority: CRITICAL - V1.0 BLOCKER

Requirements:

1. Input Validation (SQL injection, XSS, CSRF)
   2. Rate Limiting
   3. Authentication & Authorization
   4. Data Protection (HTTPS, encryption)
   5. Security Audit (penetration testing)

Implementation:

• Beta 0: Essential controls
• V1.0: Full audit, 0 critical/high vulnerabilities

NFR13: Quality Metrics Transparency

Priority: HIGH - Production expectation

Public Metrics:

• Claims analyzed
• Quality gates performance
• Hallucination rate
• Evidence quality
• User feedback

Implementation:

• POC2: Internal dashboard
• Beta 0: Public page
• V1.0: Real-time dashboard

Functional Requirements (V0.9.70 Additions)

FR44: ClaimReview Schema

Priority: CRITICAL - V1.0 BLOCKER

Generate valid ClaimReview structured data for Google/Bing visibility.

Schema.org Mapping:

• 80-100% → 5 (Highly Supported)
• 60-79% → 4 (Supported)
• 40-59% → 3 (Mixed)
• 20-39% → 2 (Questionable)
• 0-19% → 1 (Refuted)

Implementation: V1.0

FR45: Corrections Notification

Priority: CRITICAL - IFCN compliance

Notify users when analyses are corrected.

Mechanisms:

1. In-page banner
   2. Public correction log
   3. Email notifications
   4. RSS/API feed

Implementation:

• Beta 0: Basic (banner, log)
• V1.0: Complete (all mechanisms)

FR46: Image Verification

Priority: HIGH

Methods:

1. Reverse image search
   2. EXIF metadata analysis
   3. Basic manipulation detection
   4. Context verification

Implementation:

• Beta 0: Basic
• V1.0: Extended

FR47: Archive.org Integration

Priority: MEDIUM-HIGH

Auto-save all evidence sources to Wayback Machine.

Implementation: Beta 0

FR48: Safety Framework

Priority: HIGH

Protect contributors from harassment and legal threats.

Implementation: V1.x (post-launch)

FR49: A/B Testing

Priority: MEDIUM-HIGH

Test AKEL approaches and UI designs systematically.

Implementation: V1.0

FR50-FR53: Future (V2.0+)

• FR50: OSINT Toolkit
• FR51: Video Verification
• FR52: Interactive Training
• FR53: Cross-Org Sharing

Implementation: V2.0+

FR54: Evidence Deduplication

Priority: HIGH  
Fulfills: Accurate evidence counting

Prevent counting same evidence multiple times when cited by different sources.

Implementation: POC2

Enhanced Existing Requirements

FR7: Automated Verdicts (Quality Gate Integration)

POC1+ Enhancement:

Verdicts pass through quality gates:

New Verdict States:

• PUBLISHED
• INSUFFICIENT_EVIDENCE
• NON_FACTUAL_CLAIM
• PROCESSING
• ERROR

FR4: Analysis Summary (Quality Metadata)

POC1+ Enhancement:

Display quality indicators:

Related Pages

• User Needs
• Gap Analysis
• Architecture
• Roadmap

Document Status: ✅ V0.9.70 Requirements Complete  
Version: V0.9.70