Changes for page Requirements

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

From version 2.1
edited by Robert Schaub
on 2025/12/22 19:46
Change comment: Imported from XAR
To version 5.1
edited by Robert Schaub
on 2025/12/22 20:48
Change comment: Imported from XAR

Summary

Details

Page properties
Content
... ... @@ -306,7 +306,7 @@
306 306  4. How common is this pattern?
307 307  5. Store in ErrorPattern table (improvement queue)
308 308  
309 -=== 6.2 Weekly Improvement Cycle ===
309 +=== 6.2 Continuous Improvement Cycle ===
310 310  
311 311  1. **Review**: Analyze top error patterns
312 312  2. **Develop**: Create fix (prompt, model, validation)
... ... @@ -326,7 +326,7 @@
326 326  * Re-work rate
327 327  * Claims processed per hour
328 328  
329 -**Goal**: 10% monthly improvement in error rate
329 +**Goal**: continuous improvement in error rate
330 330  
331 331  == 7. Automated Quality Monitoring ==
332 332  
... ... @@ -826,162 +826,8 @@
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 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 -== 11. MVP Scope ==
920 -
921 -**Phase 1 (Months 1-3): Read-Only MVP**
922 -
923 -Build:
924 -* Automated claim analysis
925 -* Confidence scoring
926 -* Source evaluation
927 -* Browse/search interface
928 -* User flagging system
929 -
930 -**Goal**: Prove AI quality before adding user editing
931 -
932 -**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
933 -
934 -**Phase 2 (Months 4-6): User Contributions**
935 -
936 -Add only if needed:
937 -* Simple editing (Wikipedia-style)
938 -* Reputation system
939 -* Basic moderation
940 -* In-article claim highlighting (FR13)
941 -
942 -**Additional User Needs fulfilled**: UN-13, UN-17
943 -
944 -**Phase 3 (Months 7-12): Refinement**
945 -
946 -* Continuous quality improvement
947 -* Feature additions based on real usage
948 -* Scale infrastructure
949 -
950 -**Additional User Needs fulfilled**: UN-14 (API access), UN-15 (Full evolution tracking)
951 -
952 -**Deferred**:
953 -* Federation (until multiple successful instances exist)
954 -* Complex contribution workflows (focus on automation)
955 -* Extensive role hierarchy (keep simple)
956 -
957 -== 12. Success Metrics ==
958 -
959 -**System Quality** (track weekly):
960 -* Error rate by category (target: -10%/month)
961 -* Average confidence score (target: increase)
962 -* Source quality distribution (target: more high-quality)
963 -* Contradiction detection rate (target: increase)
964 -
965 -**Efficiency** (track monthly):
966 -* Claims processed per hour (target: increase)
967 -* Human hours per claim (target: decrease)
968 -* Automation coverage (target: >90%)
969 -* Re-work rate (target: <5%)
970 -
971 -**User Satisfaction** (track quarterly):
972 -* User flag rate (issues found)
973 -* Correction acceptance rate (flags valid)
974 -* Return user rate
975 -* Trust indicators (surveys)
976 -
977 -**User Needs Metrics** (track quarterly):
978 -* UN-1: % users who understand trust scores
979 -* UN-4: Time to verify social media claim (target: <30s)
980 -* UN-7: % users who access evidence details
981 -* UN-8: % users who view multiple scenarios
982 -* UN-15: % users who check evolution timeline
983 -* UN-17: % users who enable in-article highlighting; avg. time spent on highlighted vs. non-highlighted articles
984 -
985 985  == 13. Requirements Traceability ==
986 986  
987 987  For full traceability matrix showing which requirements fulfill which user needs, see:
... ... @@ -1069,7 +1069,6 @@
1069 1069  
1070 1070  
1071 1071  
1072 -**Priority:** HIGH (V1.1)
1073 1073  **Fulfills:** Advanced media verification
1074 1074  **Phase:** V1.1
1075 1075  
... ... @@ -1084,7 +1084,6 @@
1084 1084  
1085 1085  
1086 1086  
1087 -**Priority:** HIGH (V1.1)
1088 1088  **Fulfills:** UN-27 (Visual claims), advanced media verification
1089 1089  **Phase:** V1.1
1090 1090  
... ... @@ -1101,7 +1101,6 @@
1101 1101  
1102 1102  
1103 1103  
1104 -**Priority:** MEDIUM (V1.5)
1105 1105  **Fulfills:** Media literacy education
1106 1106  **Phase:** V1.5
1107 1107  
... ... @@ -1117,7 +1117,6 @@
1117 1117  
1118 1118  
1119 1119  
1120 -**Priority:** MEDIUM (V1.5)
1121 1121  **Fulfills:** Collaboration with other fact-checkers
1122 1122  **Phase:** V1.5
1123 1123  
... ... @@ -1159,7 +1159,6 @@
1159 1159  
1160 1160  
1161 1161  
1162 -**Priority:** CRITICAL (POC2/Beta)
1163 1163  **Fulfills:** Accurate evidence counting, quality metrics
1164 1164  **Phase:** POC2, Beta 0, V1.0
1165 1165