System Architecture

Built on a modular Domain-Driven Design (DDD) to ensure scalability, type safety, and rigorous logic validation.

Modular Backend (NestJS)

IngestionModule

Handles unstructured data parsing (PDF/XML). Contains the Strategy Pattern logic for P6 XML parsing.

ProjectModule

Core logic for the Project Graph. Manages the Link Analysis between Context Nodes and Activities.

AIModule

Orchestrates OpenAI integration, embedding generation via pgvector, and semantic similarity search using cosine distance for schedule activities.

DefenseModule

Specialized logic for Claims Analysis, comparing "Claimed Events" vs "Ground Truth" using the verified observation record.

Vector Memory Layer

Stores Project Constraints (LDs, weather rules) as high-dimensional vectors. Enables semantic reasoning (duplicate detection, amendment tracking) while keeping financial exposure calculations strictly deterministic.

Critical Logic Validation

We treat construction schedules as directed graphs.

Cycle Detection: We run a Depth-First-Search (DFS) Topological Sort on every upload to detect circular logic loops (A → B → A) that would break the critical path.
CPM Calculation: Includes full Forward/Backward pass algorithms to calculate Total Float, Early/Late dates, independent of the source file's metadata.