Skip to main content

Architecture Overview

FacilFlow is a full-stack data pipeline platform built with modern technologies and designed for scalability, reliability, and ease of use.

System Architecture​

Technology Stack​

Frontend​

TechnologyPurpose
React 19UI framework with concurrent features
TypeScriptType safety and developer experience
TailwindCSSUtility-first styling
shadcn/uiAccessible component library
React FlowVisual pipeline builder
ZustandLightweight state management
TanStack QueryServer state and caching
Socket.IO ClientReal-time WebSocket communication

Backend​

TechnologyPurpose
Node.js 20JavaScript runtime
Express.jsHTTP server framework
Drizzle ORMType-safe database queries
Socket.IOReal-time bidirectional events
VitestFast unit testing

Data Storage​

TechnologyPurpose
PostgreSQLRelational data (users, pipelines, configs)
InfluxDB 3Time-series data (metrics, telemetry)
MinIO/S3/Azure/GCSObject storage (files, artifacts)

External Services​

ServicePurpose
Firebase AuthAuthentication and identity
Claude AIJarvis assistant intelligence
FacilEdgeEdge data collection agents

Component Relationships​

API Structure​

The backend exposes 31 route modules:

CategoryRoutes
Corepipelines, agents, health
Datacatalog, quality, lineage, schema-registry
Storagebuckets, bucket-objects, storage-providers
Edgeedge-registry, edge-status, edge-config
AI/MLml, ml-inference, assistant
Adminusers, tenants, api-keys, audit
Integrationsairbyte, telegraf, connectors
Otheralerts, dashboards, scheduler, clusters

Real-time Communication​

Security Architecture​

Authentication Flow​

Authorization (RBAC)​

RolePermissions
AdminFull access to all features
OperatorManage pipelines, agents, data
ViewerRead-only access

Deployment Architecture​