Architecture

FactHarbor uses a modular-monolith architecture (POC → Beta 0) designed to evolve into a distributed, federated, multi-node system (Release 1.0+).
Modules are strongly separated, versioned, and auditable. All logic is transparent and deterministic.

High-Level System Architecture

FactHarbor is composed of the following major modules:

• UI Frontend
• REST API Layer
• Core Logic Layer
  • Claim Processing  
  • Scenario Engine  
  • Evidence Repository  
  • Verdict Engine  
  • Re-evaluation Engine  
  • Roles / Identity / Reputation
• AKEL (AI Knowledge Extraction Layer)
• Federation Layer
• Workers & Background Jobs
• Storage Layer (Postgres + VectorDB + ObjectStore)

High-Level Architecture

graph TD
    User((User)) <--> UI[UI Frontend]
    UI <--> API[REST API]
    
    subgraph Backend
        API <--> Core[FactHarbor Core
- Claims/Scenarios
- Evidence/Verdicts
- Identity]
        
        Core <--> AKEL[AKEL - AI Layer]
        Core <--> Workers[Background Workers]
        Core <--> Fed[Federation Layer]
    end

    subgraph Storage
        Core --> PG[(PostgreSQL)]
        Core --> Vector[(Vector DB)]
        Core --> Obj[(Object Store)]
    end

    Fed -.-> OtherNodes((Other Nodes))
    AKEL -.-> Storage
    Workers -.-> Storage