How blesson7777/tripmate works
TripMate is a transport-operations platform: drivers and transporters use separate mobile apps, while operators also work through a Django-rendered admin console. The main operational flow covers account access, driver/vehicle allocation, daily attendance and run sessions, then vehicle-fuel or tower-diesel logging and reporting; salary, notifications, and app releases are supporting capabilities. The tree contains no Flutter Dart application sources, so mobile clients are represented as external actors. Some subsystem links reflect README documentation because their implementation files were not sampled.
Main entry points: urls.py REST API · admin_dashboard_views.py Admin console · diesel/views.py Tower diesel · users/views.py Accounts and OTP
Components 25
Accounts and operations
- Admin console
tripmate/admin_dashboard_views.py - REST API
tripmate/urls.py - Accounts and OTP
users/views.py
Run operations
- Driver profiles
drivers/models.py - Vehicle records
vehicles/models.py - Attendance
attendance/models.py - Run sessions
trips/models.py
Fuel and routing
- Vehicle fuel
fuel/models.py - Fuel analytics
fuel/analytics.py - Tower diesel
diesel/views.py - Tower sites
diesel/models.py - Site validation
diesel/site_utils.py - Diesel route planning
diesel/route_planner.py - Route optimizer
services/route_optimizer.py
Business support
- Salary processing
salary/views.py - Reports and PDFs
reports/views.py - Vehicle bill PDF
reports/vehicle_bill_pdf.py - Notifications
users/notification_utils.py - Push delivery
users/push_service.py - App releases
users/models.py
Other components
- Driver app
- Transporter app
- PostgreSQL
- Firebase messaging
- Email service
Connections 26
- Driver app → REST API: uses API
- Transporter app → REST API: uses API
- Admin console → Accounts and OTP: manages accounts
- REST API → Accounts and OTP: serves account flows
- Admin console → Driver profiles: allocates drivers
tripmate/admin_dashboard_views.py - Admin console → Vehicle records: manages vehicles
tripmate/admin_dashboard_views.py - REST API → Attendance: marks attendance
- REST API → Run sessions: opens and closes
- Attendance → Run sessions: associates sessions
- REST API → Vehicle fuel: records fills
- Vehicle fuel → Fuel analytics: feeds metrics
fuel/analytics.py - REST API → Tower diesel: serves diesel flows
- Tower diesel → Tower sites: uses site records
diesel/views.py - Tower diesel → Site validation: validates sites
diesel/views.py - REST API → Route optimizer: dispatches optimization
- Tower diesel → Route optimizer: optimizes stops
diesel/views.py - REST API → Salary processing: serves salary flows
- REST API → Reports and PDFs: serves report requests
- Reports and PDFs → Vehicle bill PDF: builds bill PDFs
reports/views.py - Admin console → Reports and PDFs: supports reporting
- REST API → Notifications: serves notification feeds
- Notifications → Push delivery: sends push notices
- Push delivery → Firebase messaging: delivers messages
users/push_service.py - Accounts and OTP → Email service: emails OTPs
- Admin console → App releases: publishes releases
tripmate/admin_dashboard_views.py - REST API → PostgreSQL: reads and writes