OptiTrack is a high-fidelity, AI-powered logistics management platform designed to revolutionize fleet operations and workforce performance. Built with a focus on real-time telemetry, predictive intelligence, and premium UI aesthetics, OptiTrack provides a comprehensive suite for modern logistical command centers.
- Ratnapura Hub Focus: Optimized real-time tracking centered on Bandaranayake Road, Ratnapura.
- Dynamic Telemetry: Live mapping of speed, fuel levels, and environmental conditions across 30+ vehicles.
- High-Fidelity UI: Interactive Leaflet-powered map with custom HUD overlays and night-mode aesthetics.
- AI Performance Insights: Google Gemini 1.5 Flash powered analysis of driver behavior and career trends.
- Safety Hub: Automated safety scoring (e.g., 9.4 / 10) and merit-based salary review generation.
- Full Dossier Control: Comprehensive CRUD management for a roster of 20+ specialized drivers.
- Mass Seeding: Authentic Sri Lankan operational data including vehicle makes (Toyota, Isuzu, etc.) and localized identities.
- Search Intelligence: Real-time filtering engines for instant asset discovery and crew management.
- Status Monitoring: Live tracking of maintenance states and operational availability.
- AI Recommendations: Real-time feedback loops for fuel optimization and route safety.
- Safety Scorecard: Historical performance tracking and automated merit evaluation reports.
| Layer | Technologies |
|---|---|
| Frontend | React, Tailwind CSS, Lucide Icons, Leaflet GIS, Recharts |
| Backend | Spring Boot, Spring Security, JPA / Hibernate, Azure PostgreSQL |
| Intelligence | Google Gemini 1.5 Flash AI API |
| Operations | Real-time Telemetry Simulation, JWT Authentication, GitHub Actions |
- JDK 17+
- Node.js 18+
- Google API Key (Set in
application.propertiesasGOOGLE_API_KEY) - Azure PostgreSQL Database (Configured via
DB_URLenvironment variable)
-
Clone the Repository
git clone https://github.com/BuddhikaBICT-UoR-FoT-6/OptiTrack.git cd OptiTrack -
Backend Setup
cd optitrack-backend # Ensure you have your local PostgreSQL running or pointed to Azure ./mvnw spring-boot:run
-
Frontend Setup
cd optitrack-frontend npm install npm run dev
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
For a detailed history of updates and milestones, please refer to the CHANGELOG.md.
This project is licensed under the MIT License - see the LICENSE file for details.
Developed for the high-fidelity logistics project viva. 🇱🇰✨🦾