Changes for page Requirements

Last modified by Robert Schaub on 2025/12/23 11:03

From 4.1 to 5.1

From version 1.1

edited by Robert Schaub
on 2025/12/22 19:12

Change comment: Imported from XAR

To version 4.1

edited by Robert Schaub
on 2025/12/22 20:32

Change comment: Imported from XAR

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -306,7 +306,7 @@
 . How common is this pattern?
 . Store in ErrorPattern table (improvement queue)
--=== 6.2 Weekly Improvement Cycle ===
++=== 6.2 Continuous Improvement Cycle ===
 . **Review**: Analyze top error patterns
 . **Develop**: Create fix (prompt, model, validation)
@@ -326,7 +326,7 @@
  * Re-work rate
  * Claims processed per hour
--**Goal**: 10% monthly improvement in error rate
++**Goal**: continuous improvement in error rate
  == 7. Automated Quality Monitoring ==
@@ -826,162 +826,8 @@
  **Milestone:** POC2 (internal), Beta 0 (public), V1.0 (real-time)
--== 10. Requirements Priority Matrix ==
--This table shows all functional and non-functional requirements ordered by urgency and priority.
--**Note:** Implementation phases (POC1, POC2, Beta 0, V1.0) are defined in [[POC Requirements>>FactHarbor.Specification.POC.Requirements]] and [[Implementation Roadmap>>FactHarbor.Implementation-Roadmap.WebHome]], not in this priority matrix.
--
--**Priority Levels:**
--* **CRITICAL** - System doesn't work without it, or major safety/legal risk
--* **HIGH** - Core functionality, essential for success
--* **MEDIUM** - Important but not blocking
--* **LOW** - Nice to have, can be deferred
--
--**Urgency Levels:**
--* **HIGH** - Immediate need (critical for proof of concept)
--* **MEDIUM** - Important but not immediate
--* **LOW** - Future enhancement
--
--|= ID |= Title |= Priority |= Urgency
--| **HIGH URGENCY** |||
--| **FR1** | Claim Intake | CRITICAL | HIGH
--| **FR5** | Evidence Collection | CRITICAL | HIGH
--| **FR7** | Verdict Computation | CRITICAL | HIGH
--| **NFR11** | Quality Assurance Framework | CRITICAL | HIGH
--| **FR2** | Claim Normalization | HIGH | HIGH
--| **FR3** | Claim Classification | HIGH | HIGH
--| **FR4** | Scenario Generation | HIGH | HIGH
--| **FR6** | Evidence Evaluation | HIGH | HIGH
--| **MEDIUM URGENCY** |||
--| **NFR12** | Security Controls | CRITICAL | MEDIUM
--| **FR9** | Corrections | HIGH | MEDIUM
--| **FR44** | ClaimReview Schema | HIGH | MEDIUM
--| **FR45** | Corrections Notification | HIGH | MEDIUM
--| **FR48** | Safety Framework | HIGH | MEDIUM
--| **NFR3** | Transparency | HIGH | MEDIUM
--| **NFR13** | Quality Metrics | HIGH | MEDIUM
--| **FR8** | User Contribution | MEDIUM | MEDIUM
--| **FR10** | Publishing | MEDIUM | MEDIUM
--| **FR13** | API | MEDIUM | MEDIUM
--| **FR46** | Image Verification | MEDIUM | MEDIUM
--| **FR47** | Archive.org Integration | MEDIUM | MEDIUM
--| **NFR1** | Performance | MEDIUM | MEDIUM
--| **NFR2** | Scalability | MEDIUM | MEDIUM
--| **NFR4** | Security & Privacy | MEDIUM | MEDIUM
--| **NFR5** | Maintainability | MEDIUM | MEDIUM
--| **LOW URGENCY** |||
--| **FR11** | Social Sharing | LOW | LOW
--| **FR12** | Notifications | LOW | LOW
--| **FR49** | A/B Testing | LOW | LOW
--| **FR50** | OSINT Toolkit Integration | LOW | LOW
--| **FR51** | Video Verification System | LOW | LOW
--| **FR52** | Interactive Detection Training | LOW | LOW
--| **FR53** | Cross-Organizational Sharing | LOW | LOW
--
--**Total:** 31 requirements (23 Functional, 8 Non-Functional)
--
--**See also:**
--* [[POC Requirements>>FactHarbor.Specification.POC.Requirements]] - POC1 scope and simplifications
--* [[Implementation Roadmap>>FactHarbor.Implementation-Roadmap.WebHome]] - Phase-by-phase implementation plan
--* [[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]] - Foundation that drives these requirements
--
--=== 10.1 User Needs Priority ===
--
--User Needs (UN) are the foundation that drives functional and non-functional requirements. They are not independently prioritized; instead, their priority is inherited from the FR/NFR requirements they drive.
--
--|= ID |= Title |= Drives Requirements
--| **UN-1** | Trust Assessment at a Glance | Multiple FR/NFR
--| **UN-2** | Claim Extraction and Verification | FR1-7
--| **UN-3** | Article Summary with FactHarbor Analysis Summary | FR4
--| **UN-4** | Social Media Fact-Checking | FR1, FR4
--| **UN-5** | Source Provenance and Track Records | FR6
--| **UN-6** | Publisher Reliability History | FR6
--| **UN-7** | Evidence Transparency | NFR3
--| **UN-8** | Understanding Disagreement and Consensus | FR4
--| **UN-9** | Methodology Transparency | NFR3, NFR11
--| **UN-10** | Manipulation Tactics Detection | FR48
--| **UN-11** | Filtered Research | FR3
--| **UN-12** | Submit Unchecked Claims | FR8
--| **UN-13** | Cite FactHarbor Verdicts | FR10
--| **UN-14** | API Access for Integration | FR13
--| **UN-15** | Verdict Evolution Timeline | FR7
--| **UN-16** | AI vs. Human Review Status | FR9
--| **UN-17** | In-Article Claim Highlighting | FR1
--| **UN-26** | Search Engine Visibility | FR44
--| **UN-27** | Visual Claim Verification | FR46
--| **UN-28** | Safe Contribution Environment | FR48
--
--**Total:** 20 User Needs
--
--**Note:** Each User Need inherits priority from the requirements it drives. For example, UN-2 (Claim Extraction and Verification) drives FR1-7, which are CRITICAL/HIGH priority, therefore UN-2 is also critical to the project.
--
--== 11. MVP Scope ==
--
--**Phase 1 (Months 1-3): Read-Only MVP**
--
--Build:
--* Automated claim analysis
--* Confidence scoring
--* Source evaluation
--* Browse/search interface
--* User flagging system
--
--**Goal**: Prove AI quality before adding user editing
--
--**User Needs fulfilled in Phase 1**: UN-1, UN-2, UN-3, UN-4, UN-5, UN-6, UN-7, UN-8, UN-9, UN-12
--
--**Phase 2 (Months 4-6): User Contributions**
--
--Add only if needed:
--* Simple editing (Wikipedia-style)
--* Reputation system
--* Basic moderation
--* In-article claim highlighting (FR13)
--
--**Additional User Needs fulfilled**: UN-13, UN-17
--
--**Phase 3 (Months 7-12): Refinement**
--
--* Continuous quality improvement
--* Feature additions based on real usage
--* Scale infrastructure
--
--**Additional User Needs fulfilled**: UN-14 (API access), UN-15 (Full evolution tracking)
--
--**Deferred**:
--* Federation (until multiple successful instances exist)
--* Complex contribution workflows (focus on automation)
--* Extensive role hierarchy (keep simple)
--
--== 12. Success Metrics ==
--
--**System Quality** (track weekly):
--* Error rate by category (target: -10%/month)
--* Average confidence score (target: increase)
--* Source quality distribution (target: more high-quality)
--* Contradiction detection rate (target: increase)
--
--**Efficiency** (track monthly):
--* Claims processed per hour (target: increase)
--* Human hours per claim (target: decrease)
--* Automation coverage (target: >90%)
--* Re-work rate (target: <5%)
--
--**User Satisfaction** (track quarterly):
--* User flag rate (issues found)
--* Correction acceptance rate (flags valid)
--* Return user rate
--* Trust indicators (surveys)
--
--**User Needs Metrics** (track quarterly):
--* UN-1: % users who understand trust scores
--* UN-4: Time to verify social media claim (target: <30s)
--* UN-7: % users who access evidence details
--* UN-8: % users who view multiple scenarios
--* UN-15: % users who check evolution timeline
--* UN-17: % users who enable in-article highlighting; avg. time spent on highlighted vs. non-highlighted articles
--
  == 13. Requirements Traceability ==
  For full traceability matrix showing which requirements fulfill which user needs, see:
@@ -1065,19 +1065,150 @@
  **Milestone:** V1.0
--=== FR50-FR53: Future Enhancements (V2.0+) ===
++=== FR50: OSINT Toolkit Integration ===
--* **FR50:** OSINT Toolkit Integration
--* **FR51:** Video Verification System
--* **FR52:** Interactive Detection Training
--* **FR53:** Cross-Organizational Sharing
--**Milestone:** V2.0+ (12-18 months post-launch)
--== Enhanced Existing Requirements ==
++**Priority:** HIGH (V1.1)
++**Fulfills:** Advanced media verification
++**Phase:** V1.1
--=== FR7: Automated Verdicts (Enhanced with Quality Gates) ===
++**Purpose:** Integrate open-source intelligence tools for advanced verification.
++**Tools to Integrate:**
++* InVID/WeVerify (video verification)
++* Bellingcat toolkit
++* Additional TBD based on V1.0 learnings
++
++=== FR51: Video Verification System ===
++
++
++
++**Priority:** HIGH (V1.1)
++**Fulfills:** UN-27 (Visual claims), advanced media verification
++**Phase:** V1.1
++
++**Purpose:** Verify video-based claims.
++
++**Specification:**
++* Keyframe extraction
++* Reverse video search
++* Deepfake detection (AI-powered)
++* Metadata analysis
++* Acoustic signature analysis
++
++=== FR52: Interactive Detection Training ===
++
++
++
++**Priority:** MEDIUM (V1.5)
++**Fulfills:** Media literacy education
++**Phase:** V1.5
++
++**Purpose:** Teach users to identify misinformation.
++
++**Specification:**
++* Interactive tutorials
++* Practice exercises
++* Detection quizzes
++* Gamification elements
++
++=== FR53: Cross-Organizational Sharing ===
++
++
++
++**Priority:** MEDIUM (V1.5)
++**Fulfills:** Collaboration with other fact-checkers
++**Phase:** V1.5
++
++**Purpose:** Share findings with IFCN/EFCSN members.
++
++**Specification:**
++* API for fact-checking organizations
++* Structured data exchange
++* Privacy controls
++* Attribution requirements
++
++
++== Summary ==
++
++**V1.0 Critical Requirements (Must Have):**
++
++* FR44: ClaimReview Schema ✅
++* FR45: Corrections Notification ✅
++* FR46: Image Verification ✅
++* FR47: Archive.org Integration ✅
++* FR48: Contributor Safety ✅
++* FR49: A/B Testing ✅
++* FR54: Evidence Deduplication ✅
++* NFR11: Quality Assurance Framework ✅
++* NFR12: Security Controls ✅
++* NFR13: Quality Metrics Dashboard ✅
++
++**V1.1+ (Future):**
++
++* FR50: OSINT Integration
++* FR51: Video Verification
++* FR52: Detection Training
++* FR53: Cross-Org Sharing
++
++
++**Total:** 11 critical requirements for V1.0
++
++=== FR54: Evidence Deduplication ===
++
++
++
++**Priority:** CRITICAL (POC2/Beta)
++**Fulfills:** Accurate evidence counting, quality metrics
++**Phase:** POC2, Beta 0, V1.0
++
++**Purpose:** Avoid counting the same source multiple times when it appears in different forms.
++
++**Specification:**
++
++**Deduplication Logic:**
++
++1. **URL Normalization:**
++   * Remove tracking parameters (?utm_source=...)
++   * Normalize http/https
++   * Normalize www/non-www
++   * Handle redirects
++
++2. **Content Similarity:**
++   * If two sources have >90% text similarity → Same source
++   * If one is subset of other → Same source
++   * Use fuzzy matching for minor differences
++
++3. **Cross-Domain Syndication:**
++   * Detect wire service content (AP, Reuters)
++   * Mark as single source if syndicated
++   * Count original publication only
++
++**Display:**
++
++{{code}}
++Evidence Sources (3 unique, 5 total):
++
++1. Original Article (NYTimes)
++   - Also appeared in: WashPost, Guardian (syndicated)
++
++2. Research Paper (Nature)
++
++3. Official Statement (WHO)
++{{/code}}
++
++**Acceptance Criteria:**
++
++* ✅ URL normalization works
++* ✅ Content similarity detected
++* ✅ Syndicated content identified
++* ✅ Unique vs. total counts accurate
++* ✅ Improves evidence quality metrics
++
++
++== Additional Requirements (Lower Priority) ===== FR7: Automated Verdicts (Enhanced with Quality Gates) ===
++
  **POC1+ Enhancement:**
  After AKEL generates verdict, it passes through quality gates:

Changes for page Requirements

Summary

Details

Applications

Navigation

Need help?