VTOS - Container Inspection Gateway

A high-performance container inspection gateway API designed to capture, manage, and coordinate container traffic and inspections at port gates in real-time.

View on GitHub

Overview

VTOS Gateway API is a backend service developed using Python and FastAPI, tailored for managing container inspection sessions at port gates. It coordinates camera configurations, manages inspection sessions (DRAFT/SUBMITTED stages), captures and stores inspection images/videos, and interacts with core logistics services. The system emphasizes high code quality and strict architectural boundaries, enforced through custom Git pre-commit/pre-push hooks, Ruff linting, and automated Docker orchestration.

Architecture

Clean layered architecture built with FastAPI and PostgreSQL

Port Gate Client / Cameras

↓

FastAPI Gateway API

↓

PostgreSQL Database (SQLAlchemy ORM)

Key Features

Automated container inspection session tracking (DRAFT/SUBMITTED states)

Support for gate camera setups and inspection video metadata

FastAPI with SQLAlchemy ORM and PostgreSQL backend

Pre-commit and Pre-push hooks for strict architectural linting and workflow guardrails

Development containers configuration for zero-setup environment onboarding

Technologies

FastAPIPythonPostgreSQLSQLAlchemyDockerDev ContainersRuff LinterGit Hooks

Architecture

Clean layered architecture built with FastAPI and PostgreSQL

Source Code

Back to Projects