How madhanaskeva/kongunadu works
This is a frontend transport-management system for head-office administrators and field supervisors. Users sign in, enter an admin or supervisor portal, and manage fleet operations, trips, attendance, notifications, and reporting. The supervisor app supports trip and attendance workflows; administrators monitor operations and maintain records and access. The sampled code shows a frontend data/context layer and local-storage behavior, not a backend service. Connections to unsampled screens are included only where the router or source index documents them.
Main entry points: AppRouter.jsx Portal router · TMSAdminContext.jsx TMS state and actions · reportEngine.js Report builder · SupervisorApp.jsx Supervisor portal
Components 23
Entry and access
- Application entry
frontend/src/App.jsx - Portal router
frontend/src/routes/AppRouter.jsx - Sign-in and sessions
frontend/src/hooks/useAuth.js - Module permissions
frontend/src/hooks/useModuleAccess.js
Admin operations
- Admin portal shell
frontend/src/layouts/AdminLayout/AdminLayout.jsx - Operations dashboard
frontend/src/pages/admin/Dashboard/Dashboard.jsx - Fleet monitoring
frontend/src/pages/admin/Fleet/FleetMonitor.jsx - Trip administration
frontend/src/pages/admin/Trips/TripDetail.jsx - Business records
frontend/src/pages/admin/Masters/MasterManager.jsx - Attendance management
frontend/src/pages/admin/Attendance/Attendance.jsx - Admin notifications
frontend/src/pages/admin/Notifications/Notifications.jsx - Report builder
frontend/src/pages/admin/Reports/reportEngine.js - Analytics views
frontend/src/pages/admin/Analytics/Analytics.jsx - User administration
frontend/src/pages/admin/Users/UserList.jsx
Supervisor workflows
- Supervisor portal
frontend/src/pages/supervisor/SupervisorApp.jsx - Supervisor screens
frontend/src/pages/supervisor/SupervisorScreens.jsx
Shared data and rules
- TMS state and actions
frontend/src/context/TMSAdminContext.jsx - TMS data utilities
frontend/src/utils/tms-data.js - Trip status rules
frontend/src/utils/tripStatus.js - Trip verification
frontend/src/utils/tripVerification.js - Report utilities
frontend/src/utils/tms-report-builder.js - Portal user records
frontend/src/utils/moduleAccess.js
Other components
- Portal user
Connections 29
- Portal user → Sign-in and sessions: signs in
frontend/src/hooks/useAuth.js - Sign-in and sessions → Portal user records: reads accounts
frontend/src/hooks/useAuth.js - Portal user → Application entry: opens portal
- Application entry → Portal router: renders
frontend/src/App.jsx - Portal router → Admin portal shell: routes admin
frontend/src/routes/AppRouter.jsx - Portal router → Supervisor portal: routes supervisor
frontend/src/routes/AppRouter.jsx - Portal router → Operations dashboard: routes dashboard
frontend/src/routes/AppRouter.jsx - Portal router → Trip administration: routes trips
frontend/src/routes/AppRouter.jsx - Portal router → Fleet monitoring: routes fleet
frontend/src/routes/AppRouter.jsx - Portal router → Business records: routes masters
frontend/src/routes/AppRouter.jsx - Portal router → Attendance management: routes attendance
frontend/src/routes/AppRouter.jsx - Portal router → Report builder: routes reports
frontend/src/routes/AppRouter.jsx - Portal router → Analytics views: routes analytics
frontend/src/routes/AppRouter.jsx - Portal router → Admin notifications: routes notifications
frontend/src/routes/AppRouter.jsx - Portal router → User administration: routes users
frontend/src/routes/AppRouter.jsx - Admin portal shell → Module permissions: checks access
- Operations dashboard → TMS state and actions: reads TMS state
frontend/src/pages/admin/Dashboard/Dashboard.jsx - Fleet monitoring → TMS state and actions: reads TMS state
frontend/src/pages/admin/Fleet/FleetMonitor.jsx - Trip administration → TMS state and actions: uses TMS actions
frontend/src/pages/admin/Trips/TripDetail.jsx - Business records → TMS state and actions: uses TMS actions
frontend/src/pages/admin/Masters/MasterManager.jsx - Attendance management → TMS state and actions: uses TMS state
frontend/src/pages/admin/Attendance/Attendance.jsx - Admin notifications → TMS state and actions: uses TMS state
- Report builder → Trip verification: resolves trip routes
frontend/src/pages/admin/Reports/reportEngine.js - Report builder → Trip status rules: uses trip rules
frontend/src/pages/admin/Reports/reportEngine.js - Report builder → Report utilities: uses report utilities
- Supervisor portal → Supervisor screens: renders screens
frontend/src/pages/supervisor/SupervisorApp.jsx - Supervisor portal → Trip status rules: uses trip rules
frontend/src/pages/supervisor/SupervisorApp.jsx - TMS state and actions → TMS data utilities: loads data helpers
frontend/src/context/TMSAdminContext.jsx - TMS state and actions → Trip status rules: uses trip rules
frontend/src/context/TMSAdminContext.jsx