Changes for page Requirements

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

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

Summary

Details

Page properties
Content
... ... @@ -826,7 +826,96 @@
826 826  
827 827  **Milestone:** POC2 (internal), Beta 0 (public), V1.0 (real-time)
828 828  
829 +== 10. Requirements Priority Matrix ==
829 829  
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 +
830 830  == 11. MVP Scope ==
831 831  
832 832  **Phase 1 (Months 1-3): Read-Only MVP**
... ... @@ -976,150 +976,19 @@
976 976  
977 977  **Milestone:** V1.0
978 978  
979 -=== FR50: OSINT Toolkit Integration ===
1068 +=== FR50-FR53: Future Enhancements (V2.0+) ===
980 980  
1070 +* **FR50:** OSINT Toolkit Integration
1071 +* **FR51:** Video Verification System
1072 +* **FR52:** Interactive Detection Training
1073 +* **FR53:** Cross-Organizational Sharing
981 981  
1075 +**Milestone:** V2.0+ (12-18 months post-launch)
982 982  
983 -**Priority:** HIGH (V1.1)
984 -**Fulfills:** Advanced media verification
985 -**Phase:** V1.1
1077 +== Enhanced Existing Requirements ==
986 986  
987 -**Purpose:** Integrate open-source intelligence tools for advanced verification.
1079 +=== FR7: Automated Verdicts (Enhanced with Quality Gates) ===
988 988  
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 -
1123 1123  **POC1+ Enhancement:**
1124 1124  
1125 1125  After AKEL generates verdict, it passes through quality gates: