Turqoa Docs

Introduction to Turqoa

Turqoa is an AI-powered port operations platform that automates gate transactions, terminal security, and maritime compliance through intelligent perception and decision-making. Built for the world's busiest ports and terminals, Turqoa replaces fragile manual workflows with a unified system that sees, understands, and acts — while keeping human operators firmly in control.

Platform Overview

Turqoa is organized into six core modules, each addressing a critical domain of port and terminal operations:

ModuleDescription
Gate OSAutomated gate transaction processing with OCR, damage detection, and decision logic
Terminal SecurityAI-driven perimeter monitoring, zone management, and intrusion detection
Decision EngineConfigurable rule engine that evaluates conditions and produces gate/security decisions
Command CenterUnified operator dashboard for real-time monitoring and manual intervention
Drone VerificationAerial inspection integration for yard audits and incident response
Maritime SecurityVessel tracking, berth monitoring, and waterside threat detection

These modules share a common data model, event bus, and audit infrastructure — meaning every action across the platform is traceable, explainable, and auditable.

Key Concepts

Decision Engine

At the heart of Turqoa is the Decision Engine, a rule-based evaluation system that processes sensor inputs and produces structured decisions. Rather than acting as a black box, the engine exposes its reasoning at every step:

  • Rules are declarative conditions evaluated against transaction data
  • Confidence scores from AI models feed into rule evaluation
  • Decision modes (Shadow, Advisory, Live) control whether decisions are informational or actionable

Operator-in-the-Loop

Turqoa is designed around the principle that AI should augment — not replace — human judgment. The operator-in-the-loop model ensures that:

  • High-confidence decisions can be auto-approved to reduce operator workload
  • Low-confidence or ambiguous cases are routed to operators with full context
  • Operators can override any automated decision with a recorded justification
  • Escalation paths ensure critical decisions reach the right personnel

Audit Trail

Every transaction, decision, and operator action in Turqoa produces an immutable audit record. The audit trail captures:

  • Raw sensor data (images, OCR reads, detection results)
  • Decision engine inputs, rule evaluations, and outputs
  • Operator actions and override justifications
  • Timestamps, session identifiers, and chain-of-custody metadata

Note: Audit records are append-only and cannot be modified or deleted through the application. This design satisfies regulatory requirements for port security record-keeping.

Who Is Turqoa For

Turqoa serves organizations operating in high-throughput, security-sensitive logistics environments:

  • Port operators managing container gate transactions at scale
  • Terminal security teams responsible for perimeter protection and access control
  • Maritime authorities monitoring vessel traffic and waterside threats
  • Logistics providers requiring automated documentation and compliance verification
  • Customs and border agencies integrating with national trade single-window systems

Next Steps

  • Architecture — Understand Turqoa's layered architecture
  • Quickstart — Install and run your first gate transaction
  • Core Concepts — Deep dive into decision modes, zones, and events