Skip to Content

Changes for page System Architecture

Last modified by Robert Schaub on 2025/12/22 14:39
From version 1.1
edited by Robert Schaub
on 2025/12/22 14:34
Change comment: Imported from XAR
To version 1.4
edited by Robert Schaub
on 2025/12/22 14:38
Change comment: Renamed back-links.

Summary

Details

Page properties
Content
... ... @@ -1,5 +1,6 @@
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 -┌─────────────┐
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}}┌─────────────┐
3 3  │ User Input │
4 4  │ (Text/URL) │
5 5  └──────┬──────┘ │ ▼
... ... @@ -13,13 +13,12 @@
13 13  │ │ Verdict │ │
14 14  │ │ Generation │ │
15 15  │ └────────┬────────┘ │
16 -└──────────┼──────────┘ │ ▼ ┌──────────────┐ │ Quality Gates│ │ (Gates 1 & 4)│ └──────┬───────┘ │ ┌─────┴─────┐ │ Pass? │ └─┬───────┬─┘ YES │ │ NO ▼ ▼ ┌─────┐ ┌──────────┐ │Show │ │ Block │ │User │ │+ Explain │ └─────┘ └──────────┘
17 -{{/diagram}} **Components:**
17 +└──────────┼──────────┘ │ ▼ ┌──────────────┐ │ Quality Gates│ │ (Gates 1 & 4)│ └──────┬───────┘ │ ┌─────┴─────┐ │ Pass? │ └─┬───────┬─┘ YES │ │ NO ▼ ▼ ┌─────┐ ┌──────────┐ │Show │ │ Block │ │User │ │+ Explain │ └─────┘ └──────────┘{{/diagram}} **Components:**
18 +
18 18  * Single AKEL API call (Claude Sonnet 4.5)
19 19  * Gates 1 & 4 (claim validation, verdict confidence)
20 20  * Basic UI display
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 -┌─────────────┐
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}}┌─────────────┐
23 23  │ User Input │
24 24  └──────┬──────┘ │ ▼
25 25  ┌──────────────────────────┐
... ... @@ -40,13 +40,11 @@
40 40  │ ┌──────────────────────┐ │
41 41  │ │ Verdict Generation │ │
42 42  │ └──────┬───────────────┘ │
43 -└────────┼──────────────────┘ │ ▼ ┌──────────────────┐ │ All Quality Gates│ │ (Gates 1-4) │ └────────┬─────────┘ │ ▼ ┌─────────────┐ │ Display │ │+ Metrics │ └─────────────┘
44 -{{/diagram}} **New Components:**
43 +└────────┼──────────────────┘ │ ▼ ┌──────────────────┐ │ All Quality Gates│ │ (Gates 1-4) │ └────────┬─────────┘ │ ▼ ┌─────────────┐ │ Display │ │+ Metrics │ └─────────────┘{{/diagram}} **New Components:**
45 45  * Scenario generation
46 46  * Evidence deduplication system
47 47  * Gates 2 & 3 (evidence relevance, scenario coherence)
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 -┌────────────────────┐
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}}┌────────────────────┐
50 50  │ Input Layer │
51 51  │ API / UI / Bot │
52 52  └─────────┬──────────┘ │ ▼
... ... @@ -61,14 +61,12 @@
61 61  │ │ 5. Contradiction Detector │ │
62 62  │ │ 6. Verdict Generator │ │
63 63  │ └─────────────────────────────────┘ │
64 -└──────────────┬──────────────────────┘ │ ▼ ┌──────────────┐ │Quality Gates │ │(All 4 Gates) │ └──────┬───────┘ │ ┌─────┴─────┐ │Publication│ │ Decision │ └─┬───────┬─┘ AI │ │ Review Ready │ │ Needed ▼ ▼ ┌────────┐ ┌───────────┐ │ Public │ │Review │ │Display │ │Queue │ └────────┘ │(Human) │ └─────┬─────┘ │ ▼ ┌──────────┐ │ Publish │ └──────────┘
65 -{{/diagram}} **Production Components:**
62 +└──────────────┬──────────────────────┘ │ ▼ ┌──────────────┐ │Quality Gates │ │(All 4 Gates) │ └──────┬───────┘ │ ┌─────┴─────┐ │Publication│ │ Decision │ └─┬───────┬─┘ AI │ │ Review Ready │ │ Needed ▼ ▼ ┌────────┐ ┌───────────┐ │ Public │ │Review │ │Display │ │Queue │ └────────┘ │(Human) │ └─────┬─────┘ │ ▼ ┌──────────┐ │ Publish │ └──────────┘{{/diagram}} **Production Components:**
66 66  * Multi-component AKEL pipeline
67 67  * Review workflow system
68 68  * Audit sampling framework
69 69  * Federation architecture
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 │ ▼
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 │ ▼
72 72  ┌─────────────────┐
73 73  │ Gate 1: │ Validates claim is factual
74 74  │ Claim Validation│ (not opinion/prediction)
... ... @@ -87,12 +87,13 @@
87 87  │ Gate 4: │ Validates sufficient
88 88  │ Verdict │ evidence + confidence
89 89  │ Confidence │
90 -└────────┬────────┘ │ PASS ▼ Publication (Any gate FAIL → Block + Explain)
91 -{{/diagram}} === 2.2 Gate Implementation by Phase === |=Gate|=POC1|=POC2|=Beta 0|=V1.0
86 +└────────┬────────┘ │ PASS ▼ Publication (Any gate FAIL → Block + Explain){{/diagram}} === 2.2 Gate Implementation by Phase === |=Gate|=POC1|=POC2|=Beta 0|=V1.0
87 +
92 92  |Gate 1: Claim Validation|✅ Basic|✅ Enhanced|✅ Enhanced|✅ Hardened
93 93  |Gate 2: Evidence Relevance|❌|✅ Implemented|✅ Enhanced|✅ Hardened
94 94  |Gate 3: Scenario Coherence|❌|✅ Implemented|✅ Enhanced|✅ Hardened
95 95  |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 +
96 96  * Articles (input text/URL)
97 97  * Claims (extracted from articles)
98 98  * Verdicts (per claim)
... ... @@ -130,6 +130,5 @@
130 130  * Supports federation (multiple FactHarbor instances) **Trade-off:** More complexity, more to maintain == 6. Related Pages == * [[Requirements>>Test.FactHarbor.Specification.Requirements.WebHome]] - System requirements
131 131  * [[Design>>Test.FactHarbor.Specification.Design.WebHome]] - UI/UX design
132 132  * [[Roadmap>>Test.FactHarbor.Roadmap.WebHome]] - Implementation phases
133 -* [[POC1>>Test.FactHarbor.Roadmap.POC1.WebHome]] - POC1 details
130 +* [[POC1>>Test.FactHarbor pre13 V0\.9\.70.Roadmap.POC1.WebHome]] - POC1 details
134 134  * [[POC2>>Test.FactHarbor.Roadmap.POC2.WebHome]] - POC2 details **Document Status:** ✅ Architecture Specified (POC1, POC2, Full System) **Version:** V0.9.70
135 -