Skip to Content

Changes for page Requirements

Last modified by Robert Schaub on 2026/02/08 21:32
From version 4.1
edited by Robert Schaub
on 2025/12/19 10:02
Change comment: There is no comment for this version
To version 6.3
edited by Robert Schaub
on 2026/01/20 20:21
Change comment: Renamed back-links.

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,1 @@
1 -FactHarbor.Specification.WebHome
1 +Archive.FactHarbor V0\.9\.50 Plus (Prev Rel).Specification.WebHome
Content
... ... @@ -32,6 +32,7 @@
32 32  **Who**: Anyone (no login required)
33 33  
34 34  **Can**:
35 +
35 35  * Browse and search claims
36 36  * View scenarios, evidence, verdicts, and confidence scores
37 37  * Flag issues or errors
... ... @@ -39,10 +39,11 @@
39 39  * Submit claims automatically (new claims added if not duplicates)
40 40  
41 41  **Cannot**:
43 +
42 42  * Modify content
43 43  * Access edit history details
44 44  
45 -**User Needs served**: UN-1 (Trust assessment), UN-2 (Claim verification), UN-3 (Article summary with FactHarbor analysis summary), UN-4 (Social media fact-checking), UN-5 (Source tracing), UN-7 (Evidence transparency), UN-8 (Understanding disagreement), UN-12 (Submit claims)
47 +**User Needs served**: UN-1 (Trust assessment), UN-2 (Claim verification), UN-3 (Article summary with FactHarbor analysis summary), UN-4 (Social media fact-checking), UN-5 (Source tracing), UN-7 (Evidence transparency), UN-8 (Understanding disagreement), UN-12 (Submit claims), UN-17 (In-article highlighting)
46 46  
47 47  === 1.2 Contributor ===
48 48  
... ... @@ -49,6 +49,7 @@
49 49  **Who**: Registered users (earns reputation through contributions)
50 50  
51 51  **Can**:
54 +
52 52  * Everything a Reader can do
53 53  * Edit claims, evidence, and scenarios
54 54  * Add sources and citations
... ... @@ -57,6 +57,7 @@
57 57  * Earn reputation points for quality contributions
58 58  
59 59  **Reputation System**:
63 +
60 60  * New contributors: Limited edit privileges
61 61  * Established contributors (established reputation): Full edit access
62 62  * Trusted contributors (substantial reputation): Can approve certain changes
... ... @@ -64,6 +64,7 @@
64 64  * Reputation lost through: Reverted edits, invalid flags, abuse
65 65  
66 66  **Cannot**:
71 +
67 67  * Delete or hide content (only moderators)
68 68  * Override moderation decisions
69 69  
... ... @@ -74,6 +74,7 @@
74 74  **Who**: Trusted community members with proven track record, appointed by governance board
75 75  
76 76  **Can**:
82 +
77 77  * Review flagged content
78 78  * Hide harmful or abusive content
79 79  * Resolve disputes between contributors
... ... @@ -82,6 +82,7 @@
82 82  * Access full audit logs
83 83  
84 84  **Cannot**:
91 +
85 85  * Change governance rules
86 86  * Permanently ban users without board approval
87 87  * Override technical quality gates
... ... @@ -95,6 +95,7 @@
95 95  **Not a permanent role**: Contacted externally when needed for contested claims in their domain
96 96  
97 97  **When used**:
105 +
98 98  * Medical claims with life/safety implications
99 99  * Legal interpretations with significant impact
100 100  * Scientific claims with high controversy
... ... @@ -101,6 +101,7 @@
101 101  * Technical claims requiring specialized knowledge
102 102  
103 103  **Process**:
112 +
104 104  * Moderator identifies need for expert input
105 105  * Contact expert externally (don't require them to be users)
106 106  * Trusted Contributor provides written opinion with sources
... ... @@ -120,11 +120,13 @@
120 120  **Status**: Visible to all users
121 121  
122 122  **Includes**:
132 +
123 123  * AI-generated analyses (default state)
124 124  * User-contributed content
125 125  * Edited/improved content
126 126  
127 127  **Quality Indicators** (displayed with content):
138 +
128 128  * **Confidence Score**: 0-100% (AI's confidence in analysis)
129 129  * **Source Quality Score**: 0-100% (based on source track record)
130 130  * **Controversy Flag**: If high dispute/edit activity
... ... @@ -134,6 +134,7 @@
134 134  * **Review Status**: AI-generated / Human-reviewed / Expert-validated
135 135  
136 136  **Automatic Warnings**:
148 +
137 137  * Confidence < 60%: "Low confidence - use caution"
138 138  * Source quality < 40%: "Sources may be unreliable"
139 139  * High controversy: "Disputed - multiple interpretations exist"
... ... @@ -146,6 +146,7 @@
146 146  **Status**: Not visible to regular users (only to moderators)
147 147  
148 148  **Reasons**:
161 +
149 149  * Spam or advertising
150 150  * Personal attacks or harassment
151 151  * Illegal content
... ... @@ -154,6 +154,7 @@
154 154  * Abuse or harmful content
155 155  
156 156  **Process**:
170 +
157 157  * Automated detection flags for moderator review
158 158  * Moderator confirms and hides
159 159  * Original author notified with reason
... ... @@ -176,6 +176,7 @@
176 176  **AKEL is the primary system**. Human contributions supplement and train AKEL.
177 177  
178 178  **AKEL Must**:
193 +
179 179  * Mark all outputs as AI-generated
180 180  * Display confidence scores prominently
181 181  * Provide source citations
... ... @@ -184,6 +184,7 @@
184 184  * Learn from human corrections
185 185  
186 186  **When AKEL Makes Errors**:
202 +
187 187  1. Capture the error pattern (what, why, how common)
188 188  2. Improve the system (better prompt, model, validation)
189 189  3. Re-process affected claims automatically
... ... @@ -214,6 +214,7 @@
214 214  === 4.1 Source Requirements ===
215 215  
216 216  **Track Record Over Credentials**:
233 +
217 217  * Sources evaluated by historical accuracy
218 218  * Correction policy matters
219 219  * Independence from conflicts of interest
... ... @@ -220,6 +220,7 @@
220 220  * Methodology transparency
221 221  
222 222  **Source Quality Database**:
240 +
223 223  * Automated tracking of source accuracy
224 224  * Correction frequency
225 225  * Reliability score (updated continuously)
... ... @@ -251,6 +251,7 @@
251 251  === 4.4 Confidence Scoring ===
252 252  
253 253  **Automated confidence calculation based on**:
272 +
254 254  * Source quality scores
255 255  * Evidence consistency
256 256  * Contradiction detection
... ... @@ -258,6 +258,7 @@
258 258  * Historical accuracy of similar claims
259 259  
260 260  **Thresholds**:
280 +
261 261  * < 40%: Too low to publish (needs improvement)
262 262  * 40-60%: Published with "Low confidence" warning
263 263  * 60-80%: Published as standard
... ... @@ -274,6 +274,7 @@
274 274  === 5.1 Risk Score Calculation ===
275 275  
276 276  **Factors** (weighted algorithm):
297 +
277 277  * **Domain sensitivity**: Medical, legal, safety auto-flagged higher
278 278  * **Potential impact**: Views, citations, spread
279 279  * **Controversy level**: Flags, disputes, edit wars
... ... @@ -300,6 +300,7 @@
300 300  === 6.1 Error Capture ===
301 301  
302 302  **When users flag errors or make corrections**:
324 +
303 303  1. What was wrong? (categorize)
304 304  2. What should it have been?
305 305  3. Why did the system fail? (root cause)
... ... @@ -318,6 +318,7 @@
318 318  === 6.3 Quality Metrics Dashboard ===
319 319  
320 320  **Track continuously**:
343 +
321 321  * Error rate by category
322 322  * Source quality distribution
323 323  * Confidence score trends
... ... @@ -343,6 +343,7 @@
343 343  === 7.2 Anomaly Detection ===
344 344  
345 345  **Automated alerts for**:
369 +
346 346  * Sudden quality drops
347 347  * Unusual patterns
348 348  * Contradiction clusters
... ... @@ -395,6 +395,7 @@
395 395  **Fulfills**: UN-2 (Context-dependent verification), UN-3 (Article summary with FactHarbor analysis summary), UN-8 (Understanding disagreement)
396 396  
397 397  **Automated scenario creation**:
422 +
398 398  * AKEL analyzes claim and generates likely scenarios (use-cases and contexts)
399 399  * Each scenario includes: assumptions, definitions, boundaries, evidence context
400 400  * Users can flag incorrect scenarios
... ... @@ -455,6 +455,7 @@
455 455  **Purpose**: Provide side-by-side comparison of what a document claims vs. FactHarbor's complete analysis of its credibility
456 456  
457 457  **Left Panel: Article Summary**:
483 +
458 458  * Document title, source, and claimed credibility
459 459  * "The Big Picture" - main thesis or position change
460 460  * "Key Findings" - structured summary of document's main claims
... ... @@ -462,6 +462,7 @@
462 462  * "Conclusion" - document's bottom line
463 463  
464 464  **Right Panel: FactHarbor Analysis Summary**:
491 +
465 465  * FactHarbor's independent source credibility assessment
466 466  * Claim-by-claim verdicts with confidence scores
467 467  * Methodology assessment (strengths, limitations)
... ... @@ -469,6 +469,7 @@
469 469  * Analysis ID for reference
470 470  
471 471  **Design Principles**:
499 +
472 472  * No scrolling required - both panels visible simultaneously
473 473  * Visual distinction between "what they say" and "FactHarbor's analysis"
474 474  * Color coding for verdicts (supported, uncertain, refuted)
... ... @@ -476,11 +476,200 @@
476 476  * Mobile responsive (panels stack vertically on small screens)
477 477  
478 478  **Implementation Notes**:
507 +
479 479  * Generated automatically by AKEL for every analyzed document
480 480  * Updates when verdict evolves (maintains version history)
481 481  * Exportable as standalone summary report
482 482  * Shareable via permanent URL
483 483  
513 +==== FR13 — In-Article Claim Highlighting ====
514 +
515 +**Fulfills**: UN-17 (In-article claim highlighting)
516 +
517 +**Purpose**: Enable readers to quickly assess claim credibility while reading by visually highlighting factual claims with color-coded indicators
518 +
519 +==== Visual Example: Article with Highlighted Claims ====
520 +
521 +(% class="box" %)
522 +(((
523 +**Article: "New Study Shows Benefits of Mediterranean Diet"**
524 +
525 +A recent study published in the Journal of Nutrition has revealed new findings about the Mediterranean diet.
526 +
527 +(% class="box successmessage" style="margin:10px 0;" %)
528 +(((
529 +🟢 **Researchers found that Mediterranean diet followers had a 25% lower risk of heart disease compared to control groups**
530 +
531 +(% style="font-size:0.9em; color:#666;" %)
532 +↑ WELL SUPPORTED • 87% confidence
533 +[[Click for evidence details →]]
534 +
535 +
536 +)))
537 +
538 +The study, which followed 10,000 participants over five years, showed significant improvements in cardiovascular health markers.
539 +
540 +(% class="box warningmessage" style="margin:10px 0;" %)
541 +(((
542 +🟡 **Some experts believe this diet can completely prevent heart attacks**
543 +
544 +(% style="font-size:0.9em; color:#666;" %)
545 +↑ UNCERTAIN • 45% confidence
546 +Overstated - evidence shows risk reduction, not prevention
547 +[[Click for details →]]
548 +
549 +
550 +)))
551 +
552 +Dr. Maria Rodriguez, lead researcher, recommends incorporating more olive oil, fish, and vegetables into daily meals.
553 +
554 +(% class="box errormessage" style="margin:10px 0;" %)
555 +(((
556 +🔴 **The study proves that saturated fats cause heart disease**
557 +
558 +(% style="font-size:0.9em; color:#666;" %)
559 +↑ REFUTED • 15% confidence
560 +Claim not supported by study design; correlation ≠ causation
561 +[[Click for counter-evidence →]]
562 +
563 +
564 +)))
565 +
566 +Participants also reported feeling more energetic and experiencing better sleep quality, though these were secondary measures.
567 +)))
568 +
569 +**Legend:**
570 +
571 +* 🟢 = Well-supported claim (confidence ≥75%)
572 +* 🟡 = Uncertain claim (confidence 40-74%)
573 +* 🔴 = Refuted/unsupported claim (confidence <40%)
574 +* Plain text = Non-factual content (context, opinions, recommendations)
575 +
576 +==== Tooltip on Hover/Click ====
577 +
578 +(% class="box infomessage" %)
579 +(((
580 +**FactHarbor Analysis**
581 +
582 +**Claim:**
583 +"Researchers found that Mediterranean diet followers had a 25% lower risk of heart disease"
584 +
585 +**Verdict:** WELL SUPPORTED
586 +**Confidence:** 87%
587 +
588 +**Evidence Summary:**
589 +
590 +* Meta-analysis of 12 RCTs confirms 23-28% risk reduction
591 +* Consistent findings across multiple populations
592 +* Published in peer-reviewed journal (high credibility)
593 +
594 +**Uncertainty Factors:**
595 +
596 +* Exact percentage varies by study (20-30% range)
597 +
598 +[[View Full Analysis →]]
599 +)))
600 +
601 +**Color-Coding System**:
602 +
603 +* **Green**: Well-supported claims (confidence ≥75%, strong evidence)
604 +* **Yellow/Orange**: Uncertain claims (confidence 40-74%, conflicting or limited evidence)
605 +* **Red**: Refuted or unsupported claims (confidence <40%, contradicted by evidence)
606 +* **Gray/Neutral**: Non-factual content (opinions, questions, procedural text)
607 +
608 +==== Interactive Highlighting Example (Detailed View) ====
609 +
610 +(% style="width:100%; border-collapse:collapse;" %)
611 +|=**Article Text**|=**Status**|=**Analysis**
612 +|(((
613 +A recent study published in the Journal of Nutrition has revealed new findings about the Mediterranean diet.
614 +)))|(% style="text-align:center;" %)Plain text|(% style="font-style:italic; color:#888;" %)Context - no highlighting
615 +|(((
616 +//Researchers found that Mediterranean diet followers had a 25% lower risk of heart disease compared to control groups//
617 +)))|(% style="background-color:#D4EDDA; text-align:center; padding:8px;" %)🟢 **WELL SUPPORTED**|(((
618 +**87% confidence**
619 +
620 +Meta-analysis of 12 RCTs confirms 23-28% risk reduction
621 +
622 +[[View Full Analysis]]
623 +)))
624 +|(((
625 +The study, which followed 10,000 participants over five years, showed significant improvements in cardiovascular health markers.
626 +)))|(% style="text-align:center;" %)Plain text|(% style="font-style:italic; color:#888;" %)Methodology - no highlighting
627 +|(((
628 +//Some experts believe this diet can completely prevent heart attacks//
629 +)))|(% style="background-color:#FFF3CD; text-align:center; padding:8px;" %)🟡 **UNCERTAIN**|(((
630 +**45% confidence**
631 +
632 +Overstated - evidence shows risk reduction, not prevention
633 +
634 +[[View Details]]
635 +)))
636 +|(((
637 +Dr. Rodriguez recommends incorporating more olive oil, fish, and vegetables into daily meals.
638 +)))|(% style="text-align:center;" %)Plain text|(% style="font-style:italic; color:#888;" %)Recommendation - no highlighting
639 +|(((
640 +//The study proves that saturated fats cause heart disease//
641 +)))|(% style="background-color:#F8D7DA; text-align:center; padding:8px;" %)🔴 **REFUTED**|(((
642 +**15% confidence**
643 +
644 +Claim not supported by study; correlation ≠ causation
645 +
646 +[[View Counter-Evidence]]
647 +)))
648 +
649 +**Design Notes:**
650 +
651 +* Highlighted claims use italics to distinguish from plain text
652 +* Color backgrounds match XWiki message box colors (success/warning/error)
653 +* Status column shows verdict prominently
654 +* Analysis column provides quick summary with link to details
655 +
656 +**User Actions**:
657 +
658 +* **Hover** over highlighted claim → Tooltip appears
659 +* **Click** highlighted claim → Detailed analysis modal/panel
660 +* **Toggle** button to turn highlighting on/off
661 +* **Keyboard**: Tab through highlighted claims
662 +
663 +**Interaction Design**:
664 +
665 +* Hover/click on highlighted claim → Show tooltip with:
666 +* Claim text
667 +* Verdict (e.g., "WELL SUPPORTED")
668 +* Confidence score (e.g., "85%")
669 +* Brief evidence summary
670 +* Link to detailed analysis
671 +* Toggle highlighting on/off (user preference)
672 +* Adjustable color intensity for accessibility
673 +
674 +**Technical Requirements**:
675 +
676 +* Real-time highlighting as page loads (non-blocking)
677 +* Claim boundary detection (start/end of assertion)
678 +* Handle nested or overlapping claims
679 +* Preserve original article formatting
680 +* Work with various content formats (HTML, plain text, PDFs)
681 +
682 +**Performance Requirements**:
683 +
684 +* Highlighting renders within 500ms of page load
685 +* No perceptible delay in reading experience
686 +* Efficient DOM manipulation (avoid reflows)
687 +
688 +**Accessibility**:
689 +
690 +* Color-blind friendly palette (use patterns/icons in addition to color)
691 +* Screen reader compatible (ARIA labels for claim credibility)
692 +* Keyboard navigation to highlighted claims
693 +
694 +**Implementation Notes**:
695 +
696 +* Claims extracted and analyzed by AKEL during initial processing
697 +* Highlighting data stored as annotations with byte offsets
698 +* Client-side rendering of highlights based on verdict data
699 +* Mobile responsive (tap instead of hover)
700 +
484 484  === 8.5 Workflow & Moderation ===
485 485  
486 486  ==== FR9 — Publication Workflow ====
... ... @@ -488,6 +488,7 @@
488 488  **Fulfills**: UN-1 (Fast access to verified content), UN-16 (Clear review status)
489 489  
490 490  **Simple flow**:
708 +
491 491  1. Claim submitted
492 492  2. AKEL processes (automated)
493 493  3. If confidence > threshold: Publish (labeled as AI-generated)
... ... @@ -499,6 +499,7 @@
499 499  ==== FR10 — Moderation ====
500 500  
501 501  **Focus on abuse, not routine quality**:
720 +
502 502  * Automated abuse detection
503 503  * Moderators handle flags
504 504  * Quick response to harmful content
... ... @@ -561,6 +561,7 @@
561 561  **Phase 1 (Months 1-3): Read-Only MVP**
562 562  
563 563  Build:
783 +
564 564  * Automated claim analysis
565 565  * Confidence scoring
566 566  * Source evaluation
... ... @@ -574,11 +574,13 @@
574 574  **Phase 2 (Months 4-6): User Contributions**
575 575  
576 576  Add only if needed:
797 +
577 577  * Simple editing (Wikipedia-style)
578 578  * Reputation system
579 579  * Basic moderation
801 +* In-article claim highlighting (FR13)
580 580  
581 -**Additional User Needs fulfilled**: UN-13
803 +**Additional User Needs fulfilled**: UN-13, UN-17
582 582  
583 583  **Phase 3 (Months 7-12): Refinement**
584 584  
... ... @@ -589,6 +589,7 @@
589 589  **Additional User Needs fulfilled**: UN-14 (API access), UN-15 (Full evolution tracking)
590 590  
591 591  **Deferred**:
814 +
592 592  * Federation (until multiple successful instances exist)
593 593  * Complex contribution workflows (focus on automation)
594 594  * Extensive role hierarchy (keep simple)
... ... @@ -596,6 +596,7 @@
596 596  == 11. Success Metrics ==
597 597  
598 598  **System Quality** (track weekly):
822 +
599 599  * Error rate by category (target: -10%/month)
600 600  * Average confidence score (target: increase)
601 601  * Source quality distribution (target: more high-quality)
... ... @@ -602,6 +602,7 @@
602 602  * Contradiction detection rate (target: increase)
603 603  
604 604  **Efficiency** (track monthly):
829 +
605 605  * Claims processed per hour (target: increase)
606 606  * Human hours per claim (target: decrease)
607 607  * Automation coverage (target: >90%)
... ... @@ -608,6 +608,7 @@
608 608  * Re-work rate (target: <5%)
609 609  
610 610  **User Satisfaction** (track quarterly):
836 +
611 611  * User flag rate (issues found)
612 612  * Correction acceptance rate (flags valid)
613 613  * Return user rate
... ... @@ -614,11 +614,13 @@
614 614  * Trust indicators (surveys)
615 615  
616 616  **User Needs Metrics** (track quarterly):
843 +
617 617  * UN-1: % users who understand trust scores
618 618  * UN-4: Time to verify social media claim (target: <30s)
619 619  * UN-7: % users who access evidence details
620 620  * UN-8: % users who view multiple scenarios
621 621  * UN-15: % users who check evolution timeline
849 +* UN-17: % users who enable in-article highlighting; avg. time spent on highlighted vs. non-highlighted articles
622 622  
623 623  == 12. Requirements Traceability ==
624 624  
... ... @@ -633,5 +633,5 @@
633 633  * [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Data structures supporting requirements
634 634  * [[Workflows>>FactHarbor.Specification.Workflows.WebHome]] - User interaction workflows
635 635  * [[AKEL>>FactHarbor.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system fulfilling automation requirements
636 -* [[Global Rules>>FactHarbor.Organisation.How-We-Work-Together.GlobalRules.WebHome]]
864 +* [[Global Rules>>Archive.FactHarbor.Organisation.How-We-Work-Together.GlobalRules.WebHome]]
637 637  * [[Privacy Policy>>FactHarbor.Organisation.How-We-Work-Together.Privacy-Policy]]