Skip to content

Real-Time Infrastructure

CalcBridge provides real-time capabilities through WebSocket connections and a notification system for instant updates and alerts.

Architecture

flowchart TD
    subgraph Clients["Clients"]
        WEB["Web App"]
        API_CLIENT["API Client"]
    end

    subgraph WebSocket["WebSocket Layer"]
        WS["WebSocket\nServer"]
        ROOMS["Room\nManager"]
    end

    subgraph Events["Event Sources"]
        WORKBOOK["Workbook\nProcessing"]
        JOBS["Background\nJobs"]
        ALERTS["Compliance\nAlerts"]
    end

    subgraph Notifications["Notification System"]
        NOTIF["Notification\nService"]
        PREFS["User\nPreferences"]
        DELIVERY["Delivery\nChannels"]
    end

    WEB --> WS
    API_CLIENT --> WS
    WS --> ROOMS

    WORKBOOK --> ROOMS
    JOBS --> ROOMS
    ALERTS --> NOTIF

    NOTIF --> PREFS
    PREFS --> DELIVERY
    DELIVERY --> ROOMS

    style WS fill:#DBEAFE,stroke:#3B82F6
    style NOTIF fill:#DCFCE7,stroke:#22C55E

Components

WebSocket

Real-time bidirectional communication for:

  • Workbook processing progress
  • Background job status updates
  • Live notification delivery

See WebSocket for details.

Notifications

Structured notification system with:

  • Priority-based delivery
  • Per-user preference configuration
  • Multiple notification types
  • Batch operations

See Notifications for details.

Page Description
WebSocket Connection lifecycle, events, rooms, authentication
Notifications Types, preferences, delivery channels

API Reference