FactHarbor Architecture Overview

Version: 2.10.2
Schema Version: 2.7.0
Last Updated: February 7, 2026

This document provides a comprehensive technical overview of FactHarbor's architecture (POC Complete, Alpha Transition), including system flows, data models, component interactions, and current implementation status.

Contents

• Architecture Summary — Component overview (.NET API + Next.js), shared analyzer modules (Mermaid diagram), text analysis service, security model
• AKEL Pipeline Flow — 5-step pipeline flow diagram (Understand → Research → Verdict → Summary → Report), step-by-step detail
• Data Models — Analysis result ERD (Article, Claim, Evidence, Source entities), job lifecycle data model
• System Components — Component interaction diagram, key files, Unified Config Management (UCM) architecture
• Implementation Status and Quality — Spec alignment, working features, known gaps, quality gates, cost optimization, performance, testing infrastructure, environment variables, references

Related

• Architecture (Specification) — Target production architecture
• TriplePath Architecture — Pipeline variants
• Source Reliability System — Source scoring system
• KeyFactors Design — KeyFactor classification

Last Updated: February 8, 2026
Document Status: Living document - updated as architecture evolves