How oilycaptain/soilsense-web-admin works
SoilSense Admin Web combines a public product landing page, verified administrator sign-in, a Firestore-backed operations portal, and a small HTTP API. The main admin workflow is sign in and verify admin access, then inspect or manage accounts, device ownership and health, support tickets, analytics, audit activity, and saved preferences. Firestore is the operational data source; farmers and technicians use the separate mobile app, and the device is managed rather than operated through this web portal. Some unsampled page-to-data links are supported by the SOURCE INDEX; no mobile or device implementation is included.
Main entry points: AdminLayout.jsx Admin navigation · adminFirestore.js Admin data access · router.js Request router · App.jsx Web app routes
Components 29
Public site
- Landing page
frontend/src/landing/LandingPage.jsx - Web app routes
frontend/src/App.jsx
Admin identity
- Sign-in and signup
frontend/src/auth/pages - Admin session
frontend/src/auth/context/AuthContext.jsx - Route protection
frontend/src/auth/components/ProtectedRoute.jsx - Firebase client
frontend/src/services/firebase.js
Admin operations
- Admin navigation
frontend/src/admin/AdminLayout.jsx - Dashboard and alerts
frontend/src/admin/pages/AdminDashboard.jsx - Farmer management
frontend/src/admin/pages/Farmers.jsx - Device management
frontend/src/admin/pages/Devices.jsx - Support tickets
frontend/src/admin/pages/Support.jsx - Reports analytics
frontend/src/admin/pages/ReportsAnalytics.jsx - Audit activity
frontend/src/admin/pages/ActivityLog.jsx - Admin settings
frontend/src/admin/pages/AdminSettings.jsx - Saved preferences
frontend/src/admin/context/AdminPreferencesContext.jsx - Admin data access
frontend/src/admin/services/adminFirestore.js
HTTP API
- API server
backend/server.js - Request router
backend/router.js - Admin identity route
backend/routes/auth.js - Admin data routes
backend/routes/adminData.js - Device route
backend/routes/device.js - Health route
backend/routes/health.js - Firebase token check
backend/auth/firebaseToken.js
Other components
- Public visitor
- Administrator
- SoilSense Firestore
- Firebase Identity
- SoilSense device
- Farmer mobile app
Connections 37
- Public visitor → Landing page: visits
- Landing page → Web app routes: links to signup
frontend/src/landing/LandingPage.jsx - Web app routes → Sign-in and signup: routes to
frontend/src/App.jsx - Web app routes → Admin navigation: routes admin
frontend/src/App.jsx - Administrator → Sign-in and signup: signs in
- Sign-in and signup → Admin session: uses session
frontend/src/auth/pages/Login.jsx - Admin session → Firebase client: authenticates with
frontend/src/auth/context/AuthContext.jsx - Admin session → SoilSense Firestore: checks admin profile
frontend/src/auth/context/AuthContext.jsx - Admin navigation → Route protection: guards portal
frontend/src/App.jsx - Admin navigation → Dashboard and alerts: routes to
frontend/src/App.jsx - Admin navigation → Farmer management: routes to
frontend/src/App.jsx - Admin navigation → Device management: routes to
frontend/src/App.jsx - Admin navigation → Support tickets: routes to
frontend/src/App.jsx - Admin navigation → Reports analytics: routes to
frontend/src/App.jsx - Admin navigation → Audit activity: routes to
frontend/src/App.jsx - Admin navigation → Admin settings: routes to
frontend/src/App.jsx - Admin navigation → Saved preferences: provides preferences
frontend/src/App.jsx - Dashboard and alerts → Admin data access: loads operational stats
frontend/src/admin/pages/AdminDashboard.jsx - Farmer management → Admin data access: manages accounts
frontend/src/admin/pages/Farmers.jsx - Device management → Admin data access: manages ownership
frontend/src/admin/pages/Devices.jsx - Support tickets → Admin data access: manages tickets
frontend/src/admin/pages/Support.jsx - Reports analytics → Admin data access: loads aggregates
frontend/src/admin/pages/ReportsAnalytics.jsx - Audit activity → Admin data access: loads audit trail
frontend/src/admin/pages/ActivityLog.jsx - Saved preferences → Admin data access: reads and saves
frontend/src/admin/context/AdminPreferencesContext.jsx - Admin settings → Firebase client: uses password reset
frontend/src/admin/pages/AdminSettings.jsx - Admin data access → Firebase client: uses Firestore client
frontend/src/admin/services/adminFirestore.js - Admin data access → SoilSense Firestore: reads and writes
frontend/src/admin/services/adminFirestore.js - SoilSense device → SoilSense Firestore: reports device state
README.md - Farmer mobile app → SoilSense Firestore: provides account and scan data
README.md - API server → Request router: dispatches requests
backend/server.js - Request router → Health route: dispatches health
backend/router.js - Request router → Admin identity route: dispatches auth
backend/router.js - Request router → Admin data routes: dispatches admin data
backend/router.js - Request router → Device route: dispatches device
backend/router.js - Admin identity route → Firebase token check: requires admin
backend/routes/auth.js - Admin data routes → Firebase token check: checks admin token
backend/routes/adminData.js - Firebase token check → Firebase Identity: looks up token
backend/auth/firebaseToken.js