LogiTrack is a Tracking & Notification Service designed to monitor shipment deliveries from expedition/logistics services and notify users in real time when shipment statuses change.
This project aims to provide a centralized and extensible tracking system, independent of any single expedition provider, making it suitable for integration with multiple logistics services.
⚠️ Status: Under active development
Features, APIs, and architecture may evolve over time.
- 📍 Track shipments using tracking numbers
- 🔔 Real-time notifications on shipment status updates
- 🔄 Scheduled polling or webhook-based tracking updates
- 🧩 Pluggable expedition/logistics provider integration
- 📊 Shipment status timeline & history
- 🔐 Authentication & authorization (optional)
- Provide a unified tracking interface for multiple expedition services
- Decouple tracking logic from expedition-specific implementations
- Enable scalable and reliable notification delivery
- Serve as a backend service for web or mobile applications
LogiTrack works as a backend service that:
- Accepts shipment tracking requests
- Retrieves shipment status from expedition providers
- Normalizes and stores tracking data
- Detects shipment status changes
- Sends notifications to subscribed users
Supported (planned) notification channels:
- Push notification
- Webhook
- Messaging services
-
API Service
Handles client requests and exposes tracking endpoints -
Worker / Scheduler
Periodically checks shipment statuses -
Notification Service
Sends notifications based on tracking events -
Database
Stores shipment data and status history
- Backend: Go / Node.js / Java (TBD)
- Database: PostgreSQL / MySQL
- Messaging: Kafka / RabbitMQ (optional)
- Deployment: Docker & Docker Compose
- E-commerce shipment tracking
- Internal logistics monitoring
- Customer notification automation
- Logistics analytics & reporting (future)
This project is licensed under the Apache 2.0 License.