Skip to Content

Changes for page System Architecture

Last modified by Robert Schaub on 2025/12/22 14:16
From version 1.2
edited by Robert Schaub
on 2025/12/22 14:15
Change comment: Renamed back-links.
To version 1.1
edited by Robert Schaub
on 2025/12/22 14:10
Change comment: Imported from XAR

Summary

Details

Page properties
Content
... ... @@ -1,6 +1,5 @@
1 -= System Architecture =
2 -
3 - **FactHarbor system architecture including POC simplifications and full system design** == 1. Architecture Evolution == FactHarbor will be built in phases, with architecture complexity increasing as we validate core capabilities. === 1.1 POC1 Architecture (Simplified) === **Goal:** Validate core AI capability with minimal complexity {{diagram}}┌─────────────┐
1 += System Architecture = **FactHarbor system architecture including POC simplifications and full system design** == 1. Architecture Evolution == FactHarbor will be built in phases, with architecture complexity increasing as we validate core capabilities. === 1.1 POC1 Architecture (Simplified) === **Goal:** Validate core AI capability with minimal complexity {{diagram}}
2 +┌─────────────┐
4 4  │ User Input │
5 5  │ (Text/URL) │
6 6  └──────┬──────┘ │ ▼
... ... @@ -14,12 +14,13 @@
14 14  │ │ Verdict │ │
15 15  │ │ Generation │ │
16 16  │ └────────┬────────┘ │
17 -└──────────┼──────────┘ │ ▼ ┌──────────────┐ │ Quality Gates│ │ (Gates 1 & 4)│ └──────┬───────┘ │ ┌─────┴─────┐ │ Pass? │ └─┬───────┬─┘ YES │ │ NO ▼ ▼ ┌─────┐ ┌──────────┐ │Show │ │ Block │ │User │ │+ Explain │ └─────┘ └──────────┘{{/diagram}} **Components:**
18 -
16 +└──────────┼──────────┘ │ ▼ ┌──────────────┐ │ Quality Gates│ │ (Gates 1 & 4)│ └──────┬───────┘ │ ┌─────┴─────┐ │ Pass? │ └─┬───────┬─┘ YES │ │ NO ▼ ▼ ┌─────┐ ┌──────────┐ │Show │ │ Block │ │User │ │+ Explain │ └─────┘ └──────────┘
17 +{{/diagram}} **Components:**
19 19  * Single AKEL API call (Claude Sonnet 4.5)
20 20  * Gates 1 & 4 (claim validation, verdict confidence)
21 21  * Basic UI display
22 -* Manual quality tracking **Data Storage:** Minimal (stateless or simple SQLite) === 1.2 POC2 Architecture (Enhanced) === **Goal:** Add complete quality framework and evidence deduplication {{diagram}}┌─────────────┐
21 +* Manual quality tracking **Data Storage:** Minimal (stateless or simple SQLite) === 1.2 POC2 Architecture (Enhanced) === **Goal:** Add complete quality framework and evidence deduplication {{diagram}}
22 +┌─────────────┐
23 23  │ User Input │
24 24  └──────┬──────┘ │ ▼
25 25  ┌──────────────────────────┐
... ... @@ -40,11 +40,13 @@
40 40  │ ┌──────────────────────┐ │
41 41  │ │ Verdict Generation │ │
42 42  │ └──────┬───────────────┘ │
43 -└────────┼──────────────────┘ │ ▼ ┌──────────────────┐ │ All Quality Gates│ │ (Gates 1-4) │ └────────┬─────────┘ │ ▼ ┌─────────────┐ │ Display │ │+ Metrics │ └─────────────┘{{/diagram}} **New Components:**
43 +└────────┼──────────────────┘ │ ▼ ┌──────────────────┐ │ All Quality Gates│ │ (Gates 1-4) │ └────────┬─────────┘ │ ▼ ┌─────────────┐ │ Display │ │+ Metrics │ └─────────────┘
44 +{{/diagram}} **New Components:**
44 44  * Scenario generation
45 45  * Evidence deduplication system
46 46  * Gates 2 & 3 (evidence relevance, scenario coherence)
47 -* Quality metrics dashboard **Data Storage:** Enhanced (claims, scenarios, evidence, metrics) === 1.3 Full System Architecture (V1.0+) === **Goal:** Production-ready multi-component system {{diagram}}┌────────────────────┐
48 +* Quality metrics dashboard **Data Storage:** Enhanced (claims, scenarios, evidence, metrics) === 1.3 Full System Architecture (V1.0+) === **Goal:** Production-ready multi-component system {{diagram}}
49 +┌────────────────────┐
48 48  │ Input Layer │
49 49  │ API / UI / Bot │
50 50  └─────────┬──────────┘ │ ▼
... ... @@ -59,12 +59,14 @@
59 59  │ │ 5. Contradiction Detector │ │
60 60  │ │ 6. Verdict Generator │ │
61 61  │ └─────────────────────────────────┘ │
62 -└──────────────┬──────────────────────┘ │ ▼ ┌──────────────┐ │Quality Gates │ │(All 4 Gates) │ └──────┬───────┘ │ ┌─────┴─────┐ │Publication│ │ Decision │ └─┬───────┬─┘ AI │ │ Review Ready │ │ Needed ▼ ▼ ┌────────┐ ┌───────────┐ │ Public │ │Review │ │Display │ │Queue │ └────────┘ │(Human) │ └─────┬─────┘ │ ▼ ┌──────────┐ │ Publish │ └──────────┘{{/diagram}} **Production Components:**
64 +└──────────────┬──────────────────────┘ │ ▼ ┌──────────────┐ │Quality Gates │ │(All 4 Gates) │ └──────┬───────┘ │ ┌─────┴─────┐ │Publication│ │ Decision │ └─┬───────┬─┘ AI │ │ Review Ready │ │ Needed ▼ ▼ ┌────────┐ ┌───────────┐ │ Public │ │Review │ │Display │ │Queue │ └────────┘ │(Human) │ └─────┬─────┘ │ ▼ ┌──────────┐ │ Publish │ └──────────┘
65 +{{/diagram}} **Production Components:**
63 63  * Multi-component AKEL pipeline
64 64  * Review workflow system
65 65  * Audit sampling framework
66 66  * Federation architecture
67 -* Full data model (PostgreSQL + Redis + S3) == 2. Quality Gate Architecture == === 2.1 Quality Gate System === **Purpose:** Prevent low-quality/hallucinated content from publication {{diagram}}Quality Gate Pipeline: Claim/Verdict Input │ ▼
70 +* Full data model (PostgreSQL + Redis + S3) == 2. Quality Gate Architecture == === 2.1 Quality Gate System === **Purpose:** Prevent low-quality/hallucinated content from publication {{diagram}}
71 +Quality Gate Pipeline: Claim/Verdict Input │ ▼
68 68  ┌─────────────────┐
69 69  │ Gate 1: │ Validates claim is factual
70 70  │ Claim Validation│ (not opinion/prediction)
... ... @@ -83,13 +83,12 @@
83 83  │ Gate 4: │ Validates sufficient
84 84  │ Verdict │ evidence + confidence
85 85  │ Confidence │
86 -└────────┬────────┘ │ PASS ▼ Publication (Any gate FAIL → Block + Explain){{/diagram}} === 2.2 Gate Implementation by Phase === |=Gate|=POC1|=POC2|=Beta 0|=V1.0
87 -
90 +└────────┬────────┘ │ PASS ▼ Publication (Any gate FAIL → Block + Explain)
91 +{{/diagram}} === 2.2 Gate Implementation by Phase === |=Gate|=POC1|=POC2|=Beta 0|=V1.0
88 88  |Gate 1: Claim Validation|✅ Basic|✅ Enhanced|✅ Enhanced|✅ Hardened
89 89  |Gate 2: Evidence Relevance|❌|✅ Implemented|✅ Enhanced|✅ Hardened
90 90  |Gate 3: Scenario Coherence|❌|✅ Implemented|✅ Enhanced|✅ Hardened
91 91  |Gate 4: Verdict Confidence|✅ Basic|✅ Enhanced|✅ Enhanced|✅ Hardened **Hardening** means: Thresholds validated, edge cases handled, <5% failure rate == 3. Data Architecture == === 3.1 POC Data Model (Simplified) === **Storage:** SQLite or minimal database **Entities:**
92 -
93 93  * Articles (input text/URL)
94 94  * Claims (extracted from articles)
95 95  * Verdicts (per claim)
... ... @@ -127,5 +127,6 @@
127 127  * Supports federation (multiple FactHarbor instances) **Trade-off:** More complexity, more to maintain == 6. Related Pages == * [[Requirements>>Test.FactHarbor.Specification.Requirements.WebHome]] - System requirements
128 128  * [[Design>>Test.FactHarbor.Specification.Design.WebHome]] - UI/UX design
129 129  * [[Roadmap>>Test.FactHarbor.Roadmap.WebHome]] - Implementation phases
130 -* [[POC1>>Test.FactHarbor pre11 V0\.9\.70.Roadmap.POC1.WebHome]] - POC1 details
133 +* [[POC1>>Test.FactHarbor.Roadmap.POC1.WebHome]] - POC1 details
131 131  * [[POC2>>Test.FactHarbor.Roadmap.POC2.WebHome]] - POC2 details **Document Status:** ✅ Architecture Specified (POC1, POC2, Full System) **Version:** V0.9.70
135 +