Command Center

The Turqoa Command Center is the unified operations hub where security operators monitor events, manage responses, and maintain situational awareness across all facility systems. It provides real-time visibility into gate operations, perimeter security, maritime threats, and drone missions from a single interface.

Architecture

The Command Center aggregates data from all Turqoa modules and presents it through operator-optimized workstations:

Gate OS ──────────┐
Terminal Security ─┤
Drone Fleet ───────┼──→ Event Bus ──→ Command Center Backend ──→ Operator Stations
Maritime Security ─┤                        │
Decision Engine ───┘                        ├──→ Alert Manager
                                            ├──→ Incident Tracker
                                            └──→ System Health Monitor

Operator Stations

Each operator station is a role-based workspace with configurable layouts. Stations are assigned to operators based on their role and active shift.

Station Types

Station Configuration

stations:
  - id: station_gate_01
    type: gate_operator
    displays: 3
    layout:
      primary:
        widget: camera_grid
        cameras: [gate_1_approach, gate_1_overhead, gate_1_rear]
      secondary:
        widget: transaction_queue
        filters:
          status: [pending_review, flagged]
          max_age_minutes: 30
      tertiary:
        widget: event_feed
        sources: [gate_os]

  - id: station_maritime_01
    type: maritime_operator
    displays: 3
    layout:
      primary:
        widget: maritime_chart
        layers: [ais_tracks, threat_zones, radar_overlay]
        default_zoom: 12
      secondary:
        widget: vessel_table
        sort: risk_score_desc
        columns: [name, mmsi, type, speed, risk_score, zone, dwell_time]
      tertiary:
        widget: alert_queue
        sources: [maritime_security]
        min_severity: medium

Multi-Monitor Support

The Command Center supports up to 6 displays per station. Widgets can be dragged across displays and layouts are saved per operator profile.

Real-Time Event Stream

The Command Center consumes the unified event stream and presents it as a filterable, prioritized feed.

Event Categories

Event Stream Configuration

event_stream:
  source: kafka
  topics:
    - turqoa.events.gate
    - turqoa.events.perimeter
    - turqoa.events.maritime
    - turqoa.events.drone
    - turqoa.events.system
    - turqoa.events.decision

  display:
    max_visible: 100
    auto_scroll: true
    group_by: category
    highlight_rules:
      - severity: critical
        color: "#FF4444"
        sound: alert_critical.wav
        flash: true
      - severity: high
        color: "#FF8800"
        sound: alert_high.wav
      - severity: medium
        color: "#FFBB00"
      - severity: low
        color: "#888888"

  filters:
    presets:
      - name: Gates Only
        categories: [gate]
      - name: High Priority
        min_severity: high
      - name: Maritime Active
        categories: [maritime]
        min_severity: medium

Event Schema

Every event in the stream follows a consistent schema:

interface TurqoaEvent {
  id: string;
  timestamp: string;          // ISO 8601
  category: "gate" | "perimeter" | "maritime" | "drone" | "system" | "decision";
  severity: "low" | "medium" | "high" | "critical";
  source_module: string;
  source_device?: string;
  title: string;
  description: string;
  location?: {
    lat: number;
    lng: number;
    zone?: string;
  };
  metadata: Record<string, unknown>;
  requires_action: boolean;
  assigned_to?: string;
  incident_id?: string;
}

Incident Management

When an event requires a coordinated response, operators create or auto-generate incidents.

Incident Lifecycle

Detection → Triage → Investigation → Response → Resolution → Review

Auto-Incident Rules

auto_incident:
  rules:
    - trigger:
        event_type: perimeter_breach
        severity: [high, critical]
      action:
        create_incident: true
        priority: high
        assign_to: on_duty_supervisor
        auto_dispatch_drone: true

    - trigger:
        event_type: maritime_zone_breach
        zone_type: exclusion
      action:
        create_incident: true
        priority: critical
        assign_to: maritime_operator
        notify: [security_manager, port_authority]

System Health Monitoring

The Command Center continuously monitors the health of all Turqoa components and displays status on a dedicated dashboard.

Monitored Components

Health Dashboard Configuration

health_monitoring:
  check_interval_seconds: 30
  alert_on:
    - component_offline: true
      grace_period_seconds: 60
    - degraded_performance: true
      threshold_percent: 80
    - storage_warning: true
      threshold_percent: 85

  display:
    widget: system_health_grid
    group_by: component_type
    show_history: true
    history_hours: 24

Health API

curl https://api.turqoa.com/v1/system/health \
  -H "Authorization: Bearer $TURQOA_API_KEY"

{
  "status": "healthy",
  "timestamp": "2026-04-06T10:45:00Z",
  "components": {
    "gate_os": { "status": "healthy", "latency_ms": 12 },
    "terminal_security": { "status": "healthy", "cameras_online": 24, "cameras_total": 24 },
    "maritime_security": { "status": "healthy", "vessels_tracked": 47 },
    "drone_fleet": { "status": "degraded", "drones_available": 2, "drones_total": 4, "message": "2 drones charging" },
    "decision_engine": { "status": "healthy", "rules_active": 156, "avg_latency_ms": 3 }
  }
}

Keyboard Shortcuts