Skip to Content

Changes for page Requirements

Last modified by Robert Schaub on 2025/12/24 21:46
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 2.1
edited by Robert Schaub
on 2025/12/19 09:13
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -6,7 +6,7 @@
6 6  
7 7  == Navigation ==
8 8  
9 -* **[[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]]** - What users need from FactHarbor (drives these requirements)
9 +* **[[User Needs>>FactHarbor.Specification.Requirements.User-Needs]]** - What users need from FactHarbor (drives these requirements)
10 10  * **This page** - How we fulfill those needs through system design
11 11  
12 12  (% class="box infomessage" %)
... ... @@ -13,7 +13,7 @@
13 13  (((
14 14  **How to read this page:**
15 15  
16 -1. **User Needs drive Requirements**: See [[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]] for what users need
16 +1. **User Needs drive Requirements**: See [[User Needs>>FactHarbor.Specification.Requirements.User-Needs]] for what users need
17 17  2. **Requirements define implementation**: This page shows how we fulfill those needs
18 18  3. **Functional Requirements (FR)**: Specific features and capabilities
19 19  4. **Non-Functional Requirements (NFR)**: Quality attributes (performance, security, etc.)
... ... @@ -42,7 +42,7 @@
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)
45 +**User Needs served**: UN-1 (Trust assessment), UN-2 (Claim verification), UN-3 (Summary + verdict), UN-4 (Social media fact-checking), UN-5 (Source tracing), UN-7 (Evidence transparency), UN-8 (Understanding disagreement), UN-12 (Submit claims)
46 46  
47 47  === 1.2 Contributor ===
48 48  
... ... @@ -392,7 +392,7 @@
392 392  
393 393  ==== FR4 — Scenario Generation ====
394 394  
395 -**Fulfills**: UN-2 (Context-dependent verification), UN-3 (Article summary with FactHarbor analysis summary), UN-8 (Understanding disagreement)
395 +**Fulfills**: UN-2 (Context-dependent verification), UN-3 (Summary with scenarios), UN-8 (Understanding disagreement)
396 396  
397 397  **Automated scenario creation**:
398 398  * AKEL analyzes claim and generates likely scenarios (use-cases and contexts)
... ... @@ -413,7 +413,7 @@
413 413  
414 414  ==== FR6 — Scenario Comparison ====
415 415  
416 -**Fulfills**: UN-3 (Article summary with FactHarbor analysis summary), UN-8 (Understanding disagreement)
416 +**Fulfills**: UN-3 (Summary with verdicts), UN-8 (Understanding disagreement)
417 417  
418 418  * Side-by-side comparison interface
419 419  * Highlight key differences between scenarios
... ... @@ -424,7 +424,7 @@
424 424  
425 425  ==== FR7 — Automated Verdicts ====
426 426  
427 -**Fulfills**: UN-1 (Trust score), UN-2 (Verification verdicts), UN-3 (Article summary with FactHarbor analysis summary), UN-13 (Cite verdicts)
427 +**Fulfills**: UN-1 (Trust score), UN-2 (Verification verdicts), UN-3 (Verdict summaries), UN-13 (Cite verdicts)
428 428  
429 429  * AKEL generates verdict based on evidence within each scenario
430 430  * **Likelihood range** displayed (e.g., "0.70-0.85 (likely true)") - NOT binary true/false
... ... @@ -446,43 +446,8 @@
446 446  * Confidence score trends visible
447 447  * Users can see "as of date X, what did we know?"
448 448  
449 -=== 8.4 User Interface & Presentation ===
449 +=== 8.4 Workflow & Moderation ===
450 450  
451 -==== FR12 — Two-Panel Summary View (Article Summary with FactHarbor Analysis Summary) ====
452 -
453 -**Fulfills**: UN-3 (Article Summary with FactHarbor Analysis Summary)
454 -
455 -**Purpose**: Provide side-by-side comparison of what a document claims vs. FactHarbor's complete analysis of its credibility
456 -
457 -**Left Panel: Article Summary**:
458 -* Document title, source, and claimed credibility
459 -* "The Big Picture" - main thesis or position change
460 -* "Key Findings" - structured summary of document's main claims
461 -* "Reasoning" - document's explanation for positions
462 -* "Conclusion" - document's bottom line
463 -
464 -**Right Panel: FactHarbor Analysis Summary**:
465 -* FactHarbor's independent source credibility assessment
466 -* Claim-by-claim verdicts with confidence scores
467 -* Methodology assessment (strengths, limitations)
468 -* Overall verdict on document quality
469 -* Analysis ID for reference
470 -
471 -**Design Principles**:
472 -* No scrolling required - both panels visible simultaneously
473 -* Visual distinction between "what they say" and "FactHarbor's analysis"
474 -* Color coding for verdicts (supported, uncertain, refuted)
475 -* Confidence percentages clearly visible
476 -* Mobile responsive (panels stack vertically on small screens)
477 -
478 -**Implementation Notes**:
479 -* Generated automatically by AKEL for every analyzed document
480 -* Updates when verdict evolves (maintains version history)
481 -* Exportable as standalone summary report
482 -* Shareable via permanent URL
483 -
484 -=== 8.5 Workflow & Moderation ===
485 -
486 486  ==== FR9 — Publication Workflow ====
487 487  
488 488  **Fulfills**: UN-1 (Fast access to verified content), UN-16 (Clear review status)
... ... @@ -624,11 +624,11 @@
624 624  
625 625  For full traceability matrix showing which requirements fulfill which user needs, see:
626 626  
627 -* [[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]] - Section 8 includes comprehensive mapping tables
592 +* [[User Needs>>FactHarbor.Specification.Requirements.User-Needs]] - Section 8 includes comprehensive mapping tables
628 628  
629 629  == 13. Related Pages ==
630 630  
631 -* **[[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]]** - What users need (drives these requirements)
596 +* **[[User Needs>>FactHarbor.Specification.Requirements.User-Needs]]** - What users need (drives these requirements)
632 632  * [[Architecture>>FactHarbor.Specification.Architecture.WebHome]] - How requirements are implemented
633 633  * [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Data structures supporting requirements
634 634  * [[Workflows>>FactHarbor.Specification.Workflows.WebHome]] - User interaction workflows