How 2026dts/sea_port works
Sea_port is a crane-control, power-monitoring, and RFID container-tracking system. The main workflow is the Flask backend polling one ESP32 over HTTP, storing telemetry and container data in SQLite, and serving dashboard tabs and widgets; dashboard commands also control the cranes and reader. The README documents container registration, bay assignment, missing-tag alerts, manifest editing, analytics, and reader diagnostics. These are documented capabilities, but the large app.py excerpt is incomplete, so internal links beyond the shown storage and polling behavior rely on the README. The two PC reader scripts are legacy standalone tools, not part of the main workflow.
Main entry points: app.py Flask API · Sea_port.ino ESP32 Firmware · sea_port.db Sea Port Database · Reader_Without_RM.py Legacy Reader Tool
Components 16
Crane Control
- ESP32 Firmware
Sea_port/Sea_port.ino - Crane Actuators
Sea_port/Sea_port.ino - Power Sensors
Sea_port/Sea_port.ino
Container Tracking
- RFID Inventory
Sea_port/Sea_port.ino - UHF Reader
- Container Registry
app.py - Vessel Bay Plan
app.py - Missing-Tag Alerts
app.py
Backend and Data
- Dashboard and Widgets
app.py - ESP32 Poller
app.py - Flask API
app.py - Sea Port Database
sea_port.db - Trends and Analytics
app.py
Legacy Reader Tools
- Legacy Reader Tool
Reader_Without_RM.py - Legacy Reader Tool
Reader_with_RM.py
Other components
- Operator
Connections 17
- Operator → Dashboard and Widgets: uses
README.md - Dashboard and Widgets → Flask API: requests data
README.md - Flask API → Sea Port Database: reads and writes
app.py - ESP32 Poller → ESP32 Firmware: polls over HTTP
README.md - ESP32 Firmware → Crane Actuators: controls
README.md - ESP32 Firmware → Power Sensors: reads sensors
README.md - ESP32 Firmware → RFID Inventory: runs inventory
README.md - RFID Inventory → UHF Reader: reads tags
README.md - Flask API → Container Registry: registers EPCs
README.md - Container Registry → Sea Port Database: stores manifest
README.md - Container Registry → Vessel Bay Plan: assigns slots
README.md - Flask API → Missing-Tag Alerts: tracks missing tags
README.md - Missing-Tag Alerts → Dashboard and Widgets: shows alarms
README.md - Flask API → Trends and Analytics: serves history
README.md - Trends and Analytics → Sea Port Database: reads telemetry
app.py - Operator → Legacy Reader Tool: runs separately
Reader_Without_RM.py - Operator → Legacy Reader Tool: runs separately
Reader_with_RM.py