Diagrams

Last modified by Robert Schaub on 2026/02/08 08:32

Diagrams

This section contains visual representations of the FactHarbor system architecture.

Information

All diagrams use Mermaid syntax for maintainability. Each diagram indicates whether it shows current implementation or target architecture.

Core Architecture (v2.6.33 - Implemented)

 Diagram  Description  Status
 High-Level Architecture  Two-service architecture (Next.js + .NET)  Current
 AKEL Triple-Path Architecture  Triple-Path pipeline dispatch overview  Current
 Core Data Model ERD  JSON blob data model  Current
 Storage Architecture  SQLite storage  Current
 LLM Abstraction  AI SDK multi-provider  Current

Pipeline Internals (v2.6.33 - Implemented)

 Diagram  Description  File
 Orchestrated Pipeline Internal  5-step staged workflow (default)  orchestrated.ts
 Monolithic Canonical Internal  Single-context with canonical output  monolithic-canonical.ts
 Monolithic Dynamic Internal  Flexible experimental output  monolithic-dynamic.ts

Workflows (v2.6.33 - Implemented)

 Diagram  Description  Status
 Claim Analysis Workflow  Understanding to Research to Verdict  Current
 Evidence and Verdict  7-point verdict scale  Current
 Quality Gates  Gates 1 and 4  Current

Target Architecture (Future)

 Diagram  Description  Status
 Audit Trail ERD  Entity versioning  Future
 Versioning Architecture  Edit history and restore  Future
 Human User Roles  User role hierarchy  Future
 User Class Diagram  User class structure  Future
 Technical Users  System services  Future
 Federation Architecture  Multi-instance sync  Future (V1.0+)

Design Philosophy

 Diagram  Description  Status
 Manual vs Automated Matrix  Human vs AKEL responsibilities  Design

Roadmap

 Diagram  Description  Status
 Automation Level  Maturity progression (Current: POC)  Roadmap
 Automation Roadmap  QA evolution  Roadmap

Back to Specification