DOC: ARCH-001
STATUS: ACTIVE
RUNES: FORGE ⛬ | RIGOR ⚖︎

System Topology

Layer 1: Interface & Portals
GC Command Center
Web / iPad
Subcontractor App
Mobile Native (iOS/Android)
Supplier Terminal
Web Desktop
Owner/Client View
Read-Only Web
Layer 2: Core Engines (The Brains)
Adaptive Scheduler
DAG + Weather State Machine
Estimator Matrix
Labor/Material Pricing Alg
Trust Commons
Double-Blind Rating Engine
Financial Router
Draws & Lien Waivers
Layer 3: Data & Infrastructure
PostgreSQL
Users, Projects, Financials
Neo4j (Graph DB)
Task Dependencies & Network
Redis
API Caching & Webhooks
AWS S3
Photo Docs & Permits
Layer 4: External Integrations (The Oxygen)
Tomorrow.io API
Microclimate Ingestion
Procore / ERP
Legacy Master Sync
QuickBooks Online
Draws & Invoicing
Twilio
SMS Confirmation Cascade

Database Schema (Core Entities)

User/Identity Node

Handles multi-sided authentication and the Ecosystem Score.

uuid role_type ecosystem_score verification_status insurance_coi_url

Project Node

The container for schedules, budgets, and team access.

project_id gc_uuid lat_long total_budget critical_path_status

Activity (DAG Node)

Individual schedule items with weather sensitivity bindings.

activity_id parent_project_id dependencies[] weather_critical_flag assigned_sub_uuid

Engineering Rollout Phases

Phase Focus Area Core Deliverables Validation Metric
PHASE 1 The Wedge (Single-Player Utility) Adaptive Scheduler + Estimator V1. GC Command Center only. Weather API ingestion. Twilio SMS cascade to subs (no app needed yet). 10 GCs running live schedules; 0 lost days to unmanaged weather.
PHASE 2 The Network (Trust Commons) Subcontractor App launch. Double-blind rating engine. GPS clock-in. Procore schedule sync integration. 500 Sub profiles created; 1,000 double-blind ratings submitted.
PHASE 3 The Marketplace (Financials) Supplier Portal launch. Automated Draw Requests + QuickBooks sync. Digital Lien Waivers. Tier-based PO routing. $5M in draw requests processed through platform; 3 major suppliers integrated.
PHASE 4 The Oracle (Predictive AI) Machine Learning applied to historical schedule deviations. Auto-optimization of labor matrix based on actual sub performance. Platform predicts schedule slips 2 weeks before critical path impact.