How vizsoft-global/mg-go works
Musallam Delivery Partner is an Android-focused Flutter app for delivery drivers. Drivers authenticate with a driver code and passcode, then use the app’s dashboard and tabs for duty, delivery, and other operational tasks. The documented delivery workflow records a pickup with order ID, photo, GPS, and a proximity check, then records delivery or cancellation with finish proof. The graph preserves major documented capabilities; sampled source is limited to native platform code, so Flutter-internal call paths are not asserted where they are not shown.
Main entry points: add_delivery_flow.dart Pickup capture · finish_delivery_screen.dart Delivery finish · rider_auth_service.dart Rider authentication · login_screen.dart Passcode login
Components 25
App experience
- Passcode login
lib/features/auth/login_screen.dart - Rider authentication
lib/features/auth/rider_auth_service.dart - Navigation shell
lib/features/shell/main_shell.dart - Driver dashboard
lib/features/home/home_screen.dart - App branding
lib/core/branding/app_branding_service.dart - Maintenance gate
lib/features/maintenance/maintenance_screen.dart
Driver operations
- Duty tracking
lib/features/duty/location_tracking_service.dart - Delivery workflow
lib/features/deliveries/delivery_service.dart - Pickup capture
lib/features/deliveries/add_delivery_flow.dart - Delivery finish
lib/features/deliveries/finish_delivery_screen.dart - Proof uploads
lib/core/storage/driver_upload_service.dart - Earnings
lib/features/earnings/earnings_service.dart - Attendance
lib/features/attendance/attendance_screen.dart - Support services
lib/features/support/support_service.dart - Vehicle services
lib/features/vehicle/vehicle_service.dart
Shared services
- Notifications
lib/core/notifications/push_notification_controller.dart - Security controls
lib/core/security/security_guard_controller.dart - Offline sync
lib/core/offline/sync_controller.dart
Platform integration
- Android channels
android/app/src/main/kotlin/com/musallam_delivery/app/MainActivity.kt - Duty overlays
android/app/src/main/kotlin/com/musallam_delivery/app/duty_overlay/DutyOverlayController.kt - Overlay plugin
android/app/src/main/kotlin/com/musallam_delivery/app/duty_overlay/DutyOverlayPlugin.kt
Other components
- Driver
- Supabase backend
- Admin API
- Firebase services
Connections 25
- Driver → Passcode login: signs in
README.md - Passcode login → Rider authentication: submits credentials
- Rider authentication → Supabase backend: passcode lookup
README.md - Rider authentication → Admin API: verifies passcode
README.md - Driver → Navigation shell: uses app tabs
README.md - App branding → Supabase backend: reads settings
README.md - Maintenance gate → Supabase backend: checks maintenance
README.md - Driver → Pickup capture: records pickup
README.md - Pickup capture → Delivery workflow: creates pickup
README.md - Pickup capture → Proof uploads: uploads proof
README.md - Pickup capture → Admin API: sends photo
README.md - Driver → Delivery finish: completes order
README.md - Delivery finish → Delivery workflow: completes or cancels
README.md - Delivery finish → Proof uploads: uploads proof
README.md - Delivery finish → Admin API: sends photo
README.md - Duty tracking → Android channels: uses native channels
- Android channels → Overlay plugin: registers plugin
android/app/src/main/kotlin/com/musallam_delivery/app/MainActivity.kt - Overlay plugin → Duty overlays: controls overlay
android/app/src/main/kotlin/com/musallam_delivery/app/duty_overlay/DutyOverlayPlugin.kt - Security controls → Supabase backend: logs events
README.md - Offline sync → Supabase backend: syncs queued events
README.md - Notifications → Firebase services: receives push
- Driver → Earnings: views earnings
- Driver → Attendance: views attendance
- Driver → Support services: requests support
- Driver → Vehicle services: manages vehicle