How mearslanahmed/agriguard works
AgriGuard lets farmers authenticate in the mobile app, submit crop images for two-stage disease classification, and receive pesticide guidance; it also provides scan history and ESP32 irrigation controls. The Express backend routes requests to domain controllers, persists user, scan, advisory, OTP, and device data in MongoDB, and proxies ML and IoT operations. The README documents several cross-service links and capabilities; unsampled implementation details are represented only where that documentation supports them.
Main entry points: server.js API server · AppNavigator.js App navigation · DetectScreen.js Image capture · authController.js Auth operations
Components 33
Mobile app
- App navigation
mobile_app/src/navigation/AppNavigator.js - Login and registration
mobile_app/src/screens/LoginScreen.js - Session state
mobile_app/src/context/AuthContext.js - Auth requests
mobile_app/src/services/authService.js - Image capture
mobile_app/src/screens/DetectScreen.js - Detection requests
mobile_app/src/services/detectService.js - Detection results
mobile_app/src/screens/ResultScreen.js - Scan history
mobile_app/src/screens/HistoryScreen.js - Profile management
mobile_app/src/screens/ProfileScreen.js - Edit profile
mobile_app/src/screens/EditProfileScreen.js - Farm dashboard
mobile_app/src/screens/HomeScreen.js - Water controls
mobile_app/src/screens/WaterControlScreen.js
Express backend
- API server
backend/server.js - Auth routes
backend/routes/authRoutes.js - Auth operations
backend/controllers/authController.js - JWT protection
backend/middleware/authMiddleware.js - Scan routes
backend/routes/scanRoutes.js - Scan records
backend/controllers/scanController.js - Advisory routes
backend/routes/pesticideRoutes.js - Pesticide lookup
backend/controllers/pesticideController.js
Disease detection
- Two-stage classifier
flask_api/app.py
Persistence and advice
- MongoDB
- User records
backend/models/User.js - OTP records
backend/models/OTP.js - Scan records
backend/models/Scan.js - Advisory records
backend/models/Pesticide.js - Device registry
backend/models/EspDevice.js
IoT irrigation
- IoT routes
backend/routes/espRoutes.js - IoT proxy
backend/controllers/espController.js - Device requests
backend/services/espService.js - ESP32 devices
Other components
- Farmer
- Email delivery
Connections 45
- Farmer → App navigation: uses
README.md - App navigation → Login and registration: routes to
mobile_app/src/navigation/AppNavigator.js - App navigation → Image capture: routes to
mobile_app/src/navigation/AppNavigator.js - App navigation → Scan history: routes to
mobile_app/src/navigation/AppNavigator.js - App navigation → Profile management: routes to
mobile_app/src/navigation/AppNavigator.js - App navigation → Edit profile: routes to
mobile_app/src/navigation/AppNavigator.js - App navigation → Detection results: routes to
mobile_app/src/navigation/AppNavigator.js - App navigation → Water controls: routes to
mobile_app/src/navigation/AppNavigator.js - Login and registration → Session state: updates session
mobile_app/src/screens/LoginScreen.js - Login and registration → Auth requests: submits credentials
mobile_app/src/services/authService.js - Auth requests → API server: sends auth requests
mobile_app/src/services/authService.js - API server → Auth routes: mounts routes
backend/server.js - Auth routes → Auth operations: dispatches
backend/routes/authRoutes.js - Auth routes → JWT protection: protects routes
backend/routes/authRoutes.js - Auth operations → User records: reads and writes
backend/controllers/authController.js - Auth operations → OTP records: reads and writes
backend/controllers/authController.js - Auth operations → Email delivery: sends OTP
backend/controllers/authController.js - Image capture → Detection requests: requests classification
mobile_app/src/screens/DetectScreen.js - Detection requests → Two-stage classifier: uploads image
README.md - Image capture → API server: saves scan
README.md - API server → Scan routes: mounts routes
backend/server.js - Scan routes → Scan records: dispatches
backend/routes/scanRoutes.js - Scan routes → JWT protection: protects routes
backend/routes/scanRoutes.js - Scan records → Scan records: reads and writes
backend/controllers/scanController.js - Scan records → MongoDB: persists in
README.md - Image capture → Detection results: shows result
mobile_app/src/navigation/AppNavigator.js - Detection results → API server: requests advisory
- API server → Advisory routes: mounts routes
backend/server.js - Advisory routes → Pesticide lookup: dispatches
backend/routes/pesticideRoutes.js - Advisory routes → JWT protection: protects routes
backend/routes/pesticideRoutes.js - Pesticide lookup → Advisory records: looks up advisory
backend/controllers/pesticideController.js - Advisory records → MongoDB: persists in
README.md - Scan history → API server: loads scan history
README.md - Profile management → API server: requests profile
- Edit profile → API server: updates profile
- API server → IoT routes: mounts routes
backend/server.js - Water controls → API server: controls irrigation
README.md - IoT routes → IoT proxy: dispatches
backend/routes/espRoutes.js - IoT routes → JWT protection: protects routes
backend/routes/espRoutes.js - IoT proxy → Device requests: calls device operations
backend/controllers/espController.js - Device requests → ESP32 devices: proxies commands
README.md - IoT proxy → Device registry: registers devices
backend/controllers/espController.js - Device registry → MongoDB: persists in
README.md - User records → MongoDB: persists in
README.md - OTP records → MongoDB: persists in
README.md