Skip to Content

Changes for page Requirements

Last modified by Robert Schaub on 2025/12/24 21:46
From version 2.1
edited by Robert Schaub
on 2025/12/19 09:13
Change comment: There is no comment for this version
To version 4.1
edited by Robert Schaub
on 2025/12/19 10:02
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]]** - What users need from FactHarbor (drives these requirements)
9 +* **[[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]]** - 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]] for what users need
16 +1. **User Needs drive Requirements**: See [[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]] 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 (Summary + verdict), 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 (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)
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 (Summary with scenarios), UN-8 (Understanding disagreement)
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**:
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 (Summary with verdicts), UN-8 (Understanding disagreement)
416 +**Fulfills**: UN-3 (Article summary with FactHarbor analysis summary), 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 (Verdict summaries), UN-13 (Cite verdicts)
427 +**Fulfills**: UN-1 (Trust score), UN-2 (Verification verdicts), UN-3 (Article summary with FactHarbor analysis summary), 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,8 +446,43 @@
446 446  * Confidence score trends visible
447 447  * Users can see "as of date X, what did we know?"
448 448  
449 -=== 8.4 Workflow & Moderation ===
449 +=== 8.4 User Interface & Presentation ===
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 +
451 451  ==== FR9 — Publication Workflow ====
452 452  
453 453  **Fulfills**: UN-1 (Fast access to verified content), UN-16 (Clear review status)
... ... @@ -589,11 +589,11 @@
589 589  
590 590  For full traceability matrix showing which requirements fulfill which user needs, see:
591 591  
592 -* [[User Needs>>FactHarbor.Specification.Requirements.User-Needs]] - Section 8 includes comprehensive mapping tables
627 +* [[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]] - Section 8 includes comprehensive mapping tables
593 593  
594 594  == 13. Related Pages ==
595 595  
596 -* **[[User Needs>>FactHarbor.Specification.Requirements.User-Needs]]** - What users need (drives these requirements)
631 +* **[[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]]** - What users need (drives these requirements)
597 597  * [[Architecture>>FactHarbor.Specification.Architecture.WebHome]] - How requirements are implemented
598 598  * [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Data structures supporting requirements
599 599  * [[Workflows>>FactHarbor.Specification.Workflows.WebHome]] - User interaction workflows