# madhanaskeva/kongunadu architecture

> Architecture diagram of the GitHub repository madhanaskeva/kongunadu, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/madhanaskeva/kongunadu
- Repository: https://github.com/madhanaskeva/kongunadu

## Overview

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: [`frontend/src/routes/AppRouter.jsx`](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/routes/AppRouter.jsx) (Portal router), [`frontend/src/context/TMSAdminContext.jsx`](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/context/TMSAdminContext.jsx) (TMS state and actions), [`frontend/src/pages/admin/Reports/reportEngine.js`](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Reports/reportEngine.js) (Report builder), [`frontend/src/pages/supervisor/SupervisorApp.jsx`](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/supervisor/SupervisorApp.jsx) (Supervisor portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and access"]
  node_app["Application entry<br/>[App.jsx]"]
  node_router["Portal router<br/>[AppRouter.jsx]"]
  node_auth["Sign-in and sessions<br/>[useAuth.js]"]
  node_access["Module permissions<br/>[useModuleAccess.js]"]
end

subgraph group_admin["Admin operations"]
  node_adminpages["Admin portal shell<br/>[AdminLayout.jsx]"]
  node_dashboard["Operations dashboard<br/>[Dashboard.jsx]"]
  node_fleet["Fleet monitoring<br/>[FleetMonitor.jsx]"]
  node_trips["Trip administration<br/>[TripDetail.jsx]"]
  node_masters["Business records<br/>[MasterManager.jsx]"]
  node_attendance["Attendance management<br/>[Attendance.jsx]"]
  node_notifications["Admin notifications<br/>[Notifications.jsx]"]
  node_reports["Report builder<br/>[reportEngine.js]"]
  node_analytics["Analytics views<br/>[Analytics.jsx]"]
  node_useradmin["User administration<br/>[UserList.jsx]"]
end

subgraph group_supervisor["Supervisor workflows"]
  node_superapp["Supervisor portal<br/>[SupervisorApp.jsx]"]
  node_superscreens["Supervisor screens"]
end

subgraph group_shared["Shared data and rules"]
  node_context["TMS state and actions"]
  node_data["TMS data utilities<br/>[tms-data.js]"]
  node_triprules["Trip status rules<br/>[tripStatus.js]"]
  node_verification["Trip verification"]
  node_reportutils["Report utilities"]
  node_store[("Portal user records<br/>[moduleAccess.js]")]
end

node_user(("Portal user"))

node_user -->|"signs in"| node_auth
node_auth -->|"reads accounts"| node_store
node_user -->|"opens portal"| node_app
node_app -->|"renders"| node_router
node_router -->|"routes admin"| node_adminpages
node_router -->|"routes supervisor"| node_superapp
node_router -->|"routes dashboard"| node_dashboard
node_router -->|"routes trips"| node_trips
node_router -->|"routes fleet"| node_fleet
node_router -->|"routes masters"| node_masters
node_router -->|"routes attendance"| node_attendance
node_router -->|"routes reports"| node_reports
node_router -->|"routes analytics"| node_analytics
node_router -->|"routes notifications"| node_notifications
node_router -->|"routes users"| node_useradmin
node_adminpages -.->|"checks access"| node_access
node_dashboard -->|"reads TMS state"| node_context
node_fleet -->|"reads TMS state"| node_context
node_trips -->|"uses TMS actions"| node_context
node_masters -->|"uses TMS actions"| node_context
node_attendance -->|"uses TMS state"| node_context
node_notifications -.->|"uses TMS state"| node_context
node_reports -->|"resolves trip routes"| node_verification
node_reports -->|"uses trip rules"| node_triprules
node_reports -.->|"uses report utilities"| node_reportutils
node_superapp -->|"renders screens"| node_superscreens
node_superapp -->|"uses trip rules"| node_triprules
node_context -->|"loads data helpers"| node_data
node_context -->|"uses trip rules"| node_triprules

click node_app "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/App.jsx"
click node_router "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/routes/AppRouter.jsx"
click node_auth "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/hooks/useAuth.js"
click node_access "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/hooks/useModuleAccess.js"
click node_adminpages "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/layouts/AdminLayout/AdminLayout.jsx"
click node_dashboard "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Dashboard/Dashboard.jsx"
click node_fleet "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Fleet/FleetMonitor.jsx"
click node_trips "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Trips/TripDetail.jsx"
click node_masters "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Masters/MasterManager.jsx"
click node_attendance "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Attendance/Attendance.jsx"
click node_notifications "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Notifications/Notifications.jsx"
click node_reports "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Reports/reportEngine.js"
click node_analytics "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Analytics/Analytics.jsx"
click node_useradmin "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Users/UserList.jsx"
click node_superapp "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/supervisor/SupervisorApp.jsx"
click node_superscreens "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/supervisor/SupervisorScreens.jsx"
click node_context "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/context/TMSAdminContext.jsx"
click node_data "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/utils/tms-data.js"
click node_triprules "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/utils/tripStatus.js"
click node_verification "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/utils/tripVerification.js"
click node_reportutils "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/utils/tms-report-builder.js"
click node_store "https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/utils/moduleAccess.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_router,node_auth,node_access,node_user toneBlue
class node_adminpages,node_dashboard,node_fleet,node_trips,node_masters,node_attendance,node_notifications,node_reports,node_analytics,node_useradmin toneAmber
class node_superapp,node_superscreens toneMint
class node_context,node_data,node_triprules,node_verification,node_reportutils,node_store toneRose
```

## Components

### Entry and access

- [Application entry](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Portal router](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/routes/AppRouter.jsx): `frontend/src/routes/AppRouter.jsx`
- [Sign-in and sessions](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/hooks/useAuth.js): `frontend/src/hooks/useAuth.js`
- [Module permissions](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/hooks/useModuleAccess.js): `frontend/src/hooks/useModuleAccess.js`

### Admin operations

- [Admin portal shell](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/layouts/AdminLayout/AdminLayout.jsx): `frontend/src/layouts/AdminLayout/AdminLayout.jsx`
- [Operations dashboard](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Dashboard/Dashboard.jsx): `frontend/src/pages/admin/Dashboard/Dashboard.jsx`
- [Fleet monitoring](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Fleet/FleetMonitor.jsx): `frontend/src/pages/admin/Fleet/FleetMonitor.jsx`
- [Trip administration](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Trips/TripDetail.jsx): `frontend/src/pages/admin/Trips/TripDetail.jsx`
- [Business records](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Masters/MasterManager.jsx): `frontend/src/pages/admin/Masters/MasterManager.jsx`
- [Attendance management](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Attendance/Attendance.jsx): `frontend/src/pages/admin/Attendance/Attendance.jsx`
- [Admin notifications](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Notifications/Notifications.jsx): `frontend/src/pages/admin/Notifications/Notifications.jsx`
- [Report builder](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Reports/reportEngine.js): `frontend/src/pages/admin/Reports/reportEngine.js`
- [Analytics views](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Analytics/Analytics.jsx): `frontend/src/pages/admin/Analytics/Analytics.jsx`
- [User administration](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/admin/Users/UserList.jsx): `frontend/src/pages/admin/Users/UserList.jsx`

### Supervisor workflows

- [Supervisor portal](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/supervisor/SupervisorApp.jsx): `frontend/src/pages/supervisor/SupervisorApp.jsx`
- [Supervisor screens](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/pages/supervisor/SupervisorScreens.jsx): `frontend/src/pages/supervisor/SupervisorScreens.jsx`

### Shared data and rules

- [TMS state and actions](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/context/TMSAdminContext.jsx): `frontend/src/context/TMSAdminContext.jsx`
- [TMS data utilities](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/utils/tms-data.js): `frontend/src/utils/tms-data.js`
- [Trip status rules](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/utils/tripStatus.js): `frontend/src/utils/tripStatus.js`
- [Trip verification](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/utils/tripVerification.js): `frontend/src/utils/tripVerification.js`
- [Report utilities](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/utils/tms-report-builder.js): `frontend/src/utils/tms-report-builder.js`
- [Portal user records](https://github.com/madhanaskeva/kongunadu/blob/main/frontend/src/utils/moduleAccess.js): `frontend/src/utils/moduleAccess.js`

### Other components

- **Portal user**

## Connections

- Portal user → Sign-in and sessions: signs in (evidence: `frontend/src/hooks/useAuth.js`)
- Sign-in and sessions → Portal user records: reads accounts (evidence: `frontend/src/hooks/useAuth.js`)
- Portal user → Application entry: opens portal
- Application entry → Portal router: renders (evidence: `frontend/src/App.jsx`)
- Portal router → Admin portal shell: routes admin (evidence: `frontend/src/routes/AppRouter.jsx`)
- Portal router → Supervisor portal: routes supervisor (evidence: `frontend/src/routes/AppRouter.jsx`)
- Portal router → Operations dashboard: routes dashboard (evidence: `frontend/src/routes/AppRouter.jsx`)
- Portal router → Trip administration: routes trips (evidence: `frontend/src/routes/AppRouter.jsx`)
- Portal router → Fleet monitoring: routes fleet (evidence: `frontend/src/routes/AppRouter.jsx`)
- Portal router → Business records: routes masters (evidence: `frontend/src/routes/AppRouter.jsx`)
- Portal router → Attendance management: routes attendance (evidence: `frontend/src/routes/AppRouter.jsx`)
- Portal router → Report builder: routes reports (evidence: `frontend/src/routes/AppRouter.jsx`)
- Portal router → Analytics views: routes analytics (evidence: `frontend/src/routes/AppRouter.jsx`)
- Portal router → Admin notifications: routes notifications (evidence: `frontend/src/routes/AppRouter.jsx`)
- Portal router → User administration: routes users (evidence: `frontend/src/routes/AppRouter.jsx`)
- Admin portal shell → Module permissions: checks access
- Operations dashboard → TMS state and actions: reads TMS state (evidence: `frontend/src/pages/admin/Dashboard/Dashboard.jsx`)
- Fleet monitoring → TMS state and actions: reads TMS state (evidence: `frontend/src/pages/admin/Fleet/FleetMonitor.jsx`)
- Trip administration → TMS state and actions: uses TMS actions (evidence: `frontend/src/pages/admin/Trips/TripDetail.jsx`)
- Business records → TMS state and actions: uses TMS actions (evidence: `frontend/src/pages/admin/Masters/MasterManager.jsx`)
- Attendance management → TMS state and actions: uses TMS state (evidence: `frontend/src/pages/admin/Attendance/Attendance.jsx`)
- Admin notifications → TMS state and actions: uses TMS state
- Report builder → Trip verification: resolves trip routes (evidence: `frontend/src/pages/admin/Reports/reportEngine.js`)
- Report builder → Trip status rules: uses trip rules (evidence: `frontend/src/pages/admin/Reports/reportEngine.js`)
- Report builder → Report utilities: uses report utilities
- Supervisor portal → Supervisor screens: renders screens (evidence: `frontend/src/pages/supervisor/SupervisorApp.jsx`)
- Supervisor portal → Trip status rules: uses trip rules (evidence: `frontend/src/pages/supervisor/SupervisorApp.jsx`)
- TMS state and actions → TMS data utilities: loads data helpers (evidence: `frontend/src/context/TMSAdminContext.jsx`)
- TMS state and actions → Trip status rules: uses trip rules (evidence: `frontend/src/context/TMSAdminContext.jsx`)
