How johnbenedictbolatin/seedrover works
SeedRover combines a farm-operations portal, mobile field workflows, Supabase services, and rover hardware. The documented field workflow includes planting sessions that can continue offline and synchronize receipts when connectivity returns; the portal covers operational management and read-only rover monitoring. The supplied tree omits the Dart app, firmware, database migrations, and contracts, so those major capabilities are represented only where README evidence supports them. Portal internals are grouped by their visible routes and libraries; unsampled implementation links are omitted.
Main entry points: (portal) Admin portal · SeedRoverMessagingService.kt Firebase messaging service · flutter_window.h Flutter window host · SeedRoverPushEvents.kt Push event relay
Components 30
Web administration
- Admin portal
web-admin/src/app/(portal) - Sales and customers
web-admin/src/app/(portal)/sales - Inventory workflows
web-admin/src/app/(portal)/inventory - Crop workflows
web-admin/src/app/(portal)/crops - Investments
web-admin/src/app/(portal)/investments - Reports and exports
web-admin/src/app/(portal)/reports - User administration
web-admin/src/app/(portal)/users - Rover monitoring
web-admin/src/app/(portal)/rover-monitor - Assistant API
web-admin/src/app/api/assistant/route.ts - Portal domain libraries
web-admin/src/lib
Supabase services
- Supabase project
- Assistant function
supabase/functions/assistant/index.ts - Crop monitoring
supabase/functions/crop-monitor/index.ts - Push notifications
supabase/functions/push-notification/index.ts - Rover device API
supabase/functions/rover-device/index.ts - User administration API
supabase/functions/user-admin/index.ts
Mobile and field
- Flutter field app
- Rover and camera
Platform integration
- Android platform bridge
android/app/src/main/kotlin/com/altf4/seedrover/MainActivity.kt - Push event relay
android/app/src/main/kotlin/com/altf4/seedrover/SeedRoverPushEvents.kt - Firebase messaging service
android/app/src/main/kotlin/com/altf4/seedrover/SeedRoverMessagingService.kt - Windows app entry
windows/runner/main.cpp - Flutter window host
windows/runner/flutter_window.h - Win32 window
windows/runner/win32_window.h - Windows plugin registration
windows/flutter/generated_plugin_registrant.cc - Plugin registration interface
windows/flutter/generated_plugin_registrant.h - macOS plugin registration
macos/Flutter/GeneratedPluginRegistrant.swift - iOS app entry
ios/Runner/AppDelegate.swift
Other components
- Farm operator
- Firebase Cloud Messaging
Connections 13
- Farm operator → Admin portal: manages operations
README.md - Farm operator → Flutter field app: performs field work
README.md - Flutter field app → Supabase project: syncs receipts
README.md - Flutter field app → Rover and camera: operates rover
README.md - Admin portal → Supabase project: uses backend
README.md - Rover monitoring → Rover and camera: monitors read-only
README.md - Android platform bridge → Push event relay: registers event streams
android/app/src/main/kotlin/com/altf4/seedrover/MainActivity.kt - Firebase messaging service → Push event relay: forwards push events
android/app/src/main/kotlin/com/altf4/seedrover/SeedRoverMessagingService.kt - Firebase Cloud Messaging → Firebase messaging service: delivers messages
- Windows app entry → Flutter window host: creates window
windows/runner/main.cpp - Flutter window host → Win32 window: inherits window host
windows/runner/flutter_window.h - Windows plugin registration → Plugin registration interface: implements interface
windows/flutter/generated_plugin_registrant.cc - iOS app entry → macOS plugin registration: registers plugins
ios/Runner/AppDelegate.swift