Changes for page Requirements

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

From version 1.1
edited by Robert Schaub
on 2025/12/22 19:12
Change comment: Imported from XAR
To version 3.1
edited by Robert Schaub
on 2025/12/22 20:11
Change comment: Imported from XAR

Summary

Details

Page properties
Content
... ... @@ -826,96 +826,7 @@
826 826  
827 827  **Milestone:** POC2 (internal), Beta 0 (public), V1.0 (real-time)
828 828  
829 -== 10. Requirements Priority Matrix ==
830 830  
831 -This table shows all functional and non-functional requirements ordered by urgency and priority.
832 -
833 -**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.
834 -
835 -**Priority Levels:**
836 -* **CRITICAL** - System doesn't work without it, or major safety/legal risk
837 -* **HIGH** - Core functionality, essential for success
838 -* **MEDIUM** - Important but not blocking
839 -* **LOW** - Nice to have, can be deferred
840 -
841 -**Urgency Levels:**
842 -* **HIGH** - Immediate need (critical for proof of concept)
843 -* **MEDIUM** - Important but not immediate
844 -* **LOW** - Future enhancement
845 -
846 -|= ID |= Title |= Priority |= Urgency
847 -| **HIGH URGENCY** |||
848 -| **FR1** | Claim Intake | CRITICAL | HIGH
849 -| **FR5** | Evidence Collection | CRITICAL | HIGH
850 -| **FR7** | Verdict Computation | CRITICAL | HIGH
851 -| **NFR11** | Quality Assurance Framework | CRITICAL | HIGH
852 -| **FR2** | Claim Normalization | HIGH | HIGH
853 -| **FR3** | Claim Classification | HIGH | HIGH
854 -| **FR4** | Scenario Generation | HIGH | HIGH
855 -| **FR6** | Evidence Evaluation | HIGH | HIGH
856 -| **MEDIUM URGENCY** |||
857 -| **NFR12** | Security Controls | CRITICAL | MEDIUM
858 -| **FR9** | Corrections | HIGH | MEDIUM
859 -| **FR44** | ClaimReview Schema | HIGH | MEDIUM
860 -| **FR45** | Corrections Notification | HIGH | MEDIUM
861 -| **FR48** | Safety Framework | HIGH | MEDIUM
862 -| **NFR3** | Transparency | HIGH | MEDIUM
863 -| **NFR13** | Quality Metrics | HIGH | MEDIUM
864 -| **FR8** | User Contribution | MEDIUM | MEDIUM
865 -| **FR10** | Publishing | MEDIUM | MEDIUM
866 -| **FR13** | API | MEDIUM | MEDIUM
867 -| **FR46** | Image Verification | MEDIUM | MEDIUM
868 -| **FR47** | Archive.org Integration | MEDIUM | MEDIUM
869 -| **NFR1** | Performance | MEDIUM | MEDIUM
870 -| **NFR2** | Scalability | MEDIUM | MEDIUM
871 -| **NFR4** | Security & Privacy | MEDIUM | MEDIUM
872 -| **NFR5** | Maintainability | MEDIUM | MEDIUM
873 -| **LOW URGENCY** |||
874 -| **FR11** | Social Sharing | LOW | LOW
875 -| **FR12** | Notifications | LOW | LOW
876 -| **FR49** | A/B Testing | LOW | LOW
877 -| **FR50** | OSINT Toolkit Integration | LOW | LOW
878 -| **FR51** | Video Verification System | LOW | LOW
879 -| **FR52** | Interactive Detection Training | LOW | LOW
880 -| **FR53** | Cross-Organizational Sharing | LOW | LOW
881 -
882 -**Total:** 31 requirements (23 Functional, 8 Non-Functional)
883 -
884 -**See also:**
885 -* [[POC Requirements>>FactHarbor.Specification.POC.Requirements]] - POC1 scope and simplifications
886 -* [[Implementation Roadmap>>FactHarbor.Implementation-Roadmap.WebHome]] - Phase-by-phase implementation plan
887 -* [[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]] - Foundation that drives these requirements
888 -
889 -=== 10.1 User Needs Priority ===
890 -
891 -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.
892 -
893 -|= ID |= Title |= Drives Requirements
894 -| **UN-1** | Trust Assessment at a Glance | Multiple FR/NFR
895 -| **UN-2** | Claim Extraction and Verification | FR1-7
896 -| **UN-3** | Article Summary with FactHarbor Analysis Summary | FR4
897 -| **UN-4** | Social Media Fact-Checking | FR1, FR4
898 -| **UN-5** | Source Provenance and Track Records | FR6
899 -| **UN-6** | Publisher Reliability History | FR6
900 -| **UN-7** | Evidence Transparency | NFR3
901 -| **UN-8** | Understanding Disagreement and Consensus | FR4
902 -| **UN-9** | Methodology Transparency | NFR3, NFR11
903 -| **UN-10** | Manipulation Tactics Detection | FR48
904 -| **UN-11** | Filtered Research | FR3
905 -| **UN-12** | Submit Unchecked Claims | FR8
906 -| **UN-13** | Cite FactHarbor Verdicts | FR10
907 -| **UN-14** | API Access for Integration | FR13
908 -| **UN-15** | Verdict Evolution Timeline | FR7
909 -| **UN-16** | AI vs. Human Review Status | FR9
910 -| **UN-17** | In-Article Claim Highlighting | FR1
911 -| **UN-26** | Search Engine Visibility | FR44
912 -| **UN-27** | Visual Claim Verification | FR46
913 -| **UN-28** | Safe Contribution Environment | FR48
914 -
915 -**Total:** 20 User Needs
916 -
917 -**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.
918 -
919 919  == 11. MVP Scope ==
920 920  
921 921  **Phase 1 (Months 1-3): Read-Only MVP**
... ... @@ -1065,19 +1065,150 @@
1065 1065  
1066 1066  **Milestone:** V1.0
1067 1067  
1068 -=== FR50-FR53: Future Enhancements (V2.0+) ===
979 +=== FR50: OSINT Toolkit Integration ===
1069 1069  
1070 -* **FR50:** OSINT Toolkit Integration
1071 -* **FR51:** Video Verification System
1072 -* **FR52:** Interactive Detection Training
1073 -* **FR53:** Cross-Organizational Sharing
1074 1074  
1075 -**Milestone:** V2.0+ (12-18 months post-launch)
1076 1076  
1077 -== Enhanced Existing Requirements ==
983 +**Priority:** HIGH (V1.1)
984 +**Fulfills:** Advanced media verification
985 +**Phase:** V1.1
1078 1078  
1079 -=== FR7: Automated Verdicts (Enhanced with Quality Gates) ===
987 +**Purpose:** Integrate open-source intelligence tools for advanced verification.
1080 1080  
989 +**Tools to Integrate:**
990 +* InVID/WeVerify (video verification)
991 +* Bellingcat toolkit
992 +* Additional TBD based on V1.0 learnings
993 +
994 +=== FR51: Video Verification System ===
995 +
996 +
997 +
998 +**Priority:** HIGH (V1.1)
999 +**Fulfills:** UN-27 (Visual claims), advanced media verification
1000 +**Phase:** V1.1
1001 +
1002 +**Purpose:** Verify video-based claims.
1003 +
1004 +**Specification:**
1005 +* Keyframe extraction
1006 +* Reverse video search
1007 +* Deepfake detection (AI-powered)
1008 +* Metadata analysis
1009 +* Acoustic signature analysis
1010 +
1011 +=== FR52: Interactive Detection Training ===
1012 +
1013 +
1014 +
1015 +**Priority:** MEDIUM (V1.5)
1016 +**Fulfills:** Media literacy education
1017 +**Phase:** V1.5
1018 +
1019 +**Purpose:** Teach users to identify misinformation.
1020 +
1021 +**Specification:**
1022 +* Interactive tutorials
1023 +* Practice exercises
1024 +* Detection quizzes
1025 +* Gamification elements
1026 +
1027 +=== FR53: Cross-Organizational Sharing ===
1028 +
1029 +
1030 +
1031 +**Priority:** MEDIUM (V1.5)
1032 +**Fulfills:** Collaboration with other fact-checkers
1033 +**Phase:** V1.5
1034 +
1035 +**Purpose:** Share findings with IFCN/EFCSN members.
1036 +
1037 +**Specification:**
1038 +* API for fact-checking organizations
1039 +* Structured data exchange
1040 +* Privacy controls
1041 +* Attribution requirements
1042 +
1043 +
1044 +== Summary ==
1045 +
1046 +**V1.0 Critical Requirements (Must Have):**
1047 +
1048 +* FR44: ClaimReview Schema ✅
1049 +* FR45: Corrections Notification ✅
1050 +* FR46: Image Verification ✅
1051 +* FR47: Archive.org Integration ✅
1052 +* FR48: Contributor Safety ✅
1053 +* FR49: A/B Testing ✅
1054 +* FR54: Evidence Deduplication ✅
1055 +* NFR11: Quality Assurance Framework ✅
1056 +* NFR12: Security Controls ✅
1057 +* NFR13: Quality Metrics Dashboard ✅
1058 +
1059 +**V1.1+ (Future):**
1060 +
1061 +* FR50: OSINT Integration
1062 +* FR51: Video Verification
1063 +* FR52: Detection Training
1064 +* FR53: Cross-Org Sharing
1065 +
1066 +
1067 +**Total:** 11 critical requirements for V1.0
1068 +
1069 +=== FR54: Evidence Deduplication ===
1070 +
1071 +
1072 +
1073 +**Priority:** CRITICAL (POC2/Beta)
1074 +**Fulfills:** Accurate evidence counting, quality metrics
1075 +**Phase:** POC2, Beta 0, V1.0
1076 +
1077 +**Purpose:** Avoid counting the same source multiple times when it appears in different forms.
1078 +
1079 +**Specification:**
1080 +
1081 +**Deduplication Logic:**
1082 +
1083 +1. **URL Normalization:**
1084 + * Remove tracking parameters (?utm_source=...)
1085 + * Normalize http/https
1086 + * Normalize www/non-www
1087 + * Handle redirects
1088 +
1089 +2. **Content Similarity:**
1090 + * If two sources have >90% text similarity → Same source
1091 + * If one is subset of other → Same source
1092 + * Use fuzzy matching for minor differences
1093 +
1094 +3. **Cross-Domain Syndication:**
1095 + * Detect wire service content (AP, Reuters)
1096 + * Mark as single source if syndicated
1097 + * Count original publication only
1098 +
1099 +**Display:**
1100 +
1101 +{{code}}
1102 +Evidence Sources (3 unique, 5 total):
1103 +
1104 +1. Original Article (NYTimes)
1105 + - Also appeared in: WashPost, Guardian (syndicated)
1106 +
1107 +2. Research Paper (Nature)
1108 +
1109 +3. Official Statement (WHO)
1110 +{{/code}}
1111 +
1112 +**Acceptance Criteria:**
1113 +
1114 +* ✅ URL normalization works
1115 +* ✅ Content similarity detected
1116 +* ✅ Syndicated content identified
1117 +* ✅ Unique vs. total counts accurate
1118 +* ✅ Improves evidence quality metrics
1119 +
1120 +
1121 +== Additional Requirements (Lower Priority) ===== FR7: Automated Verdicts (Enhanced with Quality Gates) ===
1122 +
1081 1081  **POC1+ Enhancement:**
1082 1082  
1083 1083  After AKEL generates verdict, it passes through quality gates: