Terminal Security

Terminal Security is Turqoa's AI-driven surveillance and monitoring module for port and terminal facilities. It transforms existing camera networks into an intelligent security layer that detects threats, monitors restricted areas, and provides operators with real-time situational awareness.

Architecture

Terminal Security operates as a distributed system with edge-based video analytics and centralized alert management:

Camera Network (50-500+)
    │ RTSP streams
    ▼
Edge Analytics (GPU)
  → Object Detection
  → Behavior Analysis
  → Zone Monitoring
    │ Events
    ▼
Alert Management
  → Correlate
  → Escalate
  → Notify
    │
    ▼
Command Center Dashboard

Zone Types and Configuration

Terminal Security organizes physical space into zones, each with its own detection policies and alert rules. Three zone types are supported:

Zone Type	Purpose	Example Areas
Restricted	Areas requiring authorization for entry	Control rooms, fuel depots, customs bonded areas
Monitored	Areas under continuous surveillance	Yard blocks, reefer stacks, parking areas
Geofenced	GPS-defined boundaries for mobile asset tracking	Terminal perimeter, berth areas, rail corridors

Zones are defined as polygons over the terminal map and can overlap. When zones overlap, the most restrictive policy applies.

# ~/.turqoa/sites/my-terminal/security-zones.yaml
zones:
  - id: zone-fuel-depot
    name: "Fuel Storage Depot"
    type: restricted
    polygon:
      - [31.2001, 29.9187]
      - [31.2001, 29.9192]
      - [31.2006, 29.9192]
      - [31.2006, 29.9187]
    cameras:
      - cam-fuel-north
      - cam-fuel-south
      - cam-fuel-entrance
    detection_rules:
      - unauthorized_entry
      - loitering
      - unattended_object
    alert_priority: critical

Camera Network Setup

Camera Distribution

A typical terminal security deployment requires cameras positioned to provide overlapping coverage:

Area	Camera Density	Camera Type
Perimeter fence line	1 per 50m	PTZ with IR, 4K
Gate areas	3-6 per lane	Fixed, 5 MP+
Yard blocks	1 per 4 rows	PTZ with IR, 4K
Building entrances	1-2 per entrance	Fixed, 2 MP+
Berth area	1 per 100m	PTZ with IR, 4K

Network Requirements

network:
  camera_vlan: 192.168.10.0/24
  analytics_vlan: 192.168.20.0/24
  bandwidth_per_camera: 8 Mbps    # At 4K, H.265, 15 FPS
  total_bandwidth: 4 Gbps          # For 500 cameras
  redundancy: dual_path
  storage:
    retention: 30d
    resolution: original
    format: h265

Note: Camera streams for analytics are processed at reduced resolution (720p) on edge nodes. Full-resolution streams are recorded separately for evidentiary purposes.

Detection Capabilities

Terminal Security provides four primary detection capabilities:

Perimeter Breach Detection

Identifies unauthorized crossing of perimeter boundaries using virtual tripwires and zone-entry detection. Effective day and night with thermal/IR camera support.

Behavioral Analysis

Detects anomalous behavior patterns including:

Loitering — Person remaining in an area beyond a time threshold
Crowd formation — Unusual gathering of people
Running — Rapid movement indicating emergency or pursuit
Erratic movement — Non-standard path patterns

Object Detection

Classifies and tracks objects within camera views:

Personnel (with optional PPE compliance detection)
Vehicles (type classification: truck, car, forklift, straddle carrier)
Containers (position verification against yard plan)
Unattended objects (bags, packages left in restricted areas)

Environmental Monitoring

Detects environmental hazards visible on camera:

Smoke or fire indicators
Flooding or water intrusion
Lighting failures (dark zones)
Debris or obstruction on roadways

Getting Started

Zone Management — Define security zones and policies
Detection Rules — Configure detection types and sensitivity

Warning: Terminal Security should be deployed in monitoring-only mode for an initial period of at least 7 days. This allows the system to establish baseline activity patterns and reduces false positive rates during initial operation.