yudamedia/tuktuk-management

Sunny TukTuk Management System - Frappe app for managing electric tuktuks, drivers, payments and operations in Diani Beach, Kenya # Sunny TukTuk Management System A comprehensive Frappe application for managing electric tuktuks, drivers, payments, and operations in Diani Beach, Kenya. ## Overview Sunny TukTuk is a fleet management system designed for electric-charged tuktuks operating as taxis in the Diani Beach area. The system handles everything from driver assignments and daily targets to Mpesa payment processing and battery management. ## System Architecture ### Core Components - **Fleet Management**: Track and manage electric tuktuks - **Driver Management**: Comprehensive driver profiles and performance tracking - **Payment Processing**: Automatic Mpesa integration with revenue splitting - **Battery Management**: Monitor charging cycles and optimize fleet availability - **Rental System**: Temporary vehicle assignments during charging periods - **Performance Analytics**: Daily targets, earnings tracking, and reporting ### Key Features #### Dynamic Revenue Sharing - **Pre-Target**: 50% to driver, 50% towards daily target - **Post-Target**: 100% to driver - Configurable percentages (global or individual) #### Smart Battery Management - Real-time battery level monitoring - 2-hour charging cycle management - Automatic low-battery notifications - Temporary vehicle reassignment during charging #### Performance Tracking - Daily target monitoring (default: 3000 KSH) - Rolling balance for unmet targets - Automatic termination after 3 consecutive misses - Bonus payments for target achievement #### Mpesa Integration - Real-time payment listening - Automatic driver payments - Transaction recording and audit trail - Customer payment association ## Installation ### Prerequisites - ERPNext 15 installation - Python 3.8+ - Frappe Framework ### Installation Steps 1. **Navigate to your apps directory** ```bash cd ~/frappe-bench/apps ``` 2. **Clone the repository** ```bash git clone github.com ``` 3. **Install the app** ```bash cd ~/frappe-bench bench i …