Skip to content

KabulaBenjamin/TractorManager-ShowCase

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 

Repository files navigation

TractorManager 🚜 | v3.0.1

TractorManager is an enterprise-grade fleet management ecosystem for modern agricultural operations. Version 3.0.1 introduces Cloud Connectivity, allowing you to synchronize your entire business across multiple devices and team members in real-time.

🌟 New in Version 3.0.1: The Cloud & Connectivity Update

☁️ Real-Time Cloud Synchronization

  • Firebase Integration: Your data is no longer limited to a single device. Records, bookings, and fleet status now sync instantly to the cloud.
  • Multi-Device Access: Log in on any smartphone to see your live business dashboard and current fleet status.
  • Seamless Data Safety: Cloud-based storage ensures you never lose your history during app upgrades or phone changes.

πŸ” Secure Team Authentication

  • User Roles: Log in as an Owner for full financial oversight or as a Driver/Manager to handle assigned bookings and daily logs.
  • Protected Access: Secure authentication via Firebase ensures your business data remains private.

πŸ“„ Digital Invoicing & Logistics

  • WhatsApp Receipts: Generate and send instant job summaries to customers directly from the app.
  • Hour Meter Tracking: Track engine hours alongside acreage for high-precision engine maintenance and fuel efficiency analysis.
  • Photo Expense Receipts: Attach photos of spare parts and fuel invoices directly to your records for paperless accounting.

🌀️ Live Weather Integration

  • Real-time Forecasts: View current weather conditions directly on the Dashboard and Add Customer screens to plan operations effectively.

✨ Core Features

🚜 Global Fleet Management

  • Machine-Specific Tracking: Every recordβ€”income, expenses, and maintenanceβ€”is tied to a specific tractor.
  • Dashboard Filtering: Toggle the entire app (Metrics, Charts, AI Insights) between "All Tractors" or a specific machine in your fleet.

πŸ’° Automated Payroll & Multi-Broker System

  • Comprehensive Logic: Automated pay for Driver (350/ac + 200/trip) and Two Assistants (300/500 base + 100/trip).
  • Broker Commissions: Link unlimited brokers to any job; the system logs a KES 100/acre commission for each automatically.
  • Manual Control: Review and add payroll entries to expenses with total financial oversight.

πŸ“‹ Precision GPS Surveying

  • Offline Acreage Tool: Measure field acreage by walking the perimeter. The app draws filled irregular shapes and uses the Shoelace Formula for engineering-grade accuracyβ€”no internet required.
  • GPS Integration: Save job-site coordinates (Latitude/Longitude) directly to the booking for easy navigation.

πŸ“Š Proactive AI Insights

  • Business Consultant: A dedicated AI row provides real-time reminders for refueling, debt collection, and predictive maintenance.
  • Efficiency Metrics: Dedicated screen monitoring Liters per Acre and Cost per Acre to identify high-performing machines.
  • Dynamic Charting: Toggle trends between Weekly (Sunday Start), Monthly, and Yearly.

πŸ›‘ Data Security & Safety

  • Backup & Restore: Manually package your database to Gmail or Google Drive for redundant safety.
  • Sync All History: Rebuild your entire financial summary from raw records with one click.
  • Unique Constraints: Advanced database logic prevents duplicate entries from affecting your business computing.

πŸ›  Tech Stack

  • Backend: Firebase (Authentication, Firestore, Analytics).
  • UI: Jetpack Compose (Material 3) with Modern Tonal Styling.
  • Language: Kotlin + Coroutines/Flow.
  • Database: Room (Local) + Firestore (Cloud Sync).
  • Networking: Retrofit + OkHttp for Weather API.
  • Geospatial: Android Location Services (Offline GPS).
  • Reporting: Apache POI (Multi-Sheet Excel).

πŸš€ Getting Started

Installation

  1. Download the latest TractorManager_V3.0.1.apk from the Releases section.
  2. Open the APK on your Android device (Min SDK 33 / Android 13+).
  3. Enable "Install from Unknown Sources" and start managing your fleet!

πŸ“Ί Watch the Demo Video: the video link is coming.

πŸ“œ License & Copyright

Β© 2026 Benjamin Kabula Koikoi. All rights reserved.
Precision management for the modern agricultural entrepreneur.

About

A specialized Android application for tractor fleet management. Features automated driver payroll calculations, real-time operational analytics, diesel tracking, and professional multi-sheet Excel reporting. Built with Kotlin, Jetpack Compose (Material 3), and MVVM architecture. πŸšœπŸ“Š

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors