Natnael-Alemayehu/logistics

Offline-first logistics tracking and proof-of-delivery platform specifically designed for Ethiopian conditions. # Ethiopian Logistics Tracking Platform An **offline-first logistics tracking and proof-of-delivery (POD) platform** built for the Ethiopian market. Dispatchers get real-time fleet visibility, drivers operate fully offline in rural areas with unreliable connectivity, and customers can track shipments and confirm deliveries with digital proof. The platform tackles three core pain points in Ethiopian trucking: **no visibility** (dispatchers calling drivers all day), **no proof of delivery** (costly delivery disputes), and **customer anxiety** (no delivery status visibility). Everything is designed around Ethiopia's network reality — stable in major cities, unreliable on highways, and non-existent in rural areas. --- ## Key Features - **Real-time GPS tracking** — live fleet map with last-known locations via WebSockets when connectivity is available - **Offline-first tracking** — checkpoint-based status updates work without network; data syncs automatically when connection returns - **Proof of delivery (POD)** — digital signature capture + geotagged, timestamped photo evidence with recipient verification - **Adaptive battery-conscious GPS** — tracking frequency adjusts based on power level and movement detection - **Background sync & conflict resolution** — offline changes queue locally (SQLite) and sync with server-side conflict resolution - **SMS fallback** — critical status updates via SMS (Twilio or Ethio Telecom providers, mock in dev) - **Dispatcher dashboard** — fleet overview map, shipment lifecycle, driver/vehicle management, alerts, analytics & reporting - **Customer tracking portal** — track shipments by tracking number, SMS notifications on status changes - **Multi-tenant & RBAC** — driver, dispatcher, and admin roles with tenant isolation --- ## Architecture ``` ┌──────────────────────────────────────────────────────────────┐ │ BACKEND │ │ Go 1.25 · chi · PostgreSQL (PostGIS) · Redis · sqlc …