# volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring architecture

> Architecture diagram of the GitHub repository volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring
- Repository: https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring

## Overview

This is a permitting and fleet-management application with a Next.js frontend and Express/Prisma backend. Its main workflow is submitting a service application, then assigning and reviewing it through approval or rejection; the product also manages users, inspectors, audit logs, vehicles, schedules, and trip tickets. The graph emphasizes backend request handling and the sampled database/service calls. Frontend pages and several backend subsystems are represented from the tree, but their runtime connections are omitted where the excerpts do not establish them.

Main entry points: [`backend/src/lib/prisma.js`](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/lib/prisma.js) (PostgreSQL Database), [`backend/src/server.js`](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/server.js) (Express Server), [`backend/src/controller/applications/admin.controller.js`](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/controller/applications/admin.controller.js) (Review Controller), [`backend/src/controller/vehicle/vehicle.controller.js`](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/controller/vehicle/vehicle.controller.js) (Vehicle Controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_permitting["Permitting Workflow"]
  node_applicant_ui["Applicant Portal"]
  node_application_routes["Application Routes"]
  node_application_controllers["Application Controllers"]
  node_application_services["Application Services"]
  node_application_status["Application Status"]
  node_application_admin_ui["Review Console"]
  node_admin_routes["Review Routes<br/>[admin.routes.js]"]
  node_admin_controller["Review Controller"]
  node_admin_service["Review Service<br/>[admin.service.js]"]
end

subgraph group_governance["Administration"]
  node_superadmin_ui["Super Admin Console"]
  node_superadmin_routes["Super Admin Routes"]
  node_superadmin_controller["Super Admin Controller"]
  node_superadmin_service["Super Admin Service<br/>[super-admin.js]"]
  node_audit["Audit Logging<br/>[audit.service.js]"]
end

subgraph group_fleet["Fleet Operations"]
  node_vehicle_ui["Vehicle Console"]
  node_vehicle_routes["Vehicle Routes<br/>[vehicle.routes.js]"]
  node_vehicle_controller["Vehicle Controller"]
  node_vehicle_service["Vehicle Service<br/>[vehicle.service.js]"]
end

subgraph group_platform["Platform Services"]
  node_email["Status Email<br/>[sendEmail.js]"]
  node_auth_middleware["Authentication"]
  node_authorization["Role Authorization"]
  node_service_guard["Service Access Guard"]
  node_auth["Auth Library<br/>[auth.js]"]
  node_database[("PostgreSQL Database<br/>[prisma.js]")]
  node_server["Express Server<br/>[server.js]"]
end

node_applicant(("Applicant"))

node_application_routes -->|"routes to"| node_application_controllers
node_application_controllers -->|"uses services"| node_application_services
node_application_status -->|"queries"| node_database
node_admin_routes -->|"routes to"| node_admin_controller
node_admin_controller -->|"calls"| node_admin_service
node_admin_controller -->|"sends status"| node_email
node_admin_controller -->|"records actions"| node_audit
node_admin_service -->|"queries"| node_database
node_superadmin_routes -->|"routes to"| node_superadmin_controller
node_superadmin_controller -->|"calls"| node_superadmin_service
node_superadmin_controller -->|"records actions"| node_audit
node_superadmin_service -.->|"queries"| node_database
node_vehicle_routes -->|"routes to"| node_vehicle_controller
node_vehicle_controller -->|"calls"| node_vehicle_service
node_vehicle_controller -->|"queries"| node_database
node_vehicle_controller -->|"records actions"| node_audit
node_vehicle_service -->|"queries"| node_database
node_auth_middleware -->|"checks session"| node_auth
node_service_guard -->|"checks assignments"| node_database
node_server -->|"mounts routes"| node_application_routes
node_server -->|"mounts routes"| node_admin_routes
node_server -->|"mounts routes"| node_superadmin_routes
node_server -->|"mounts routes"| node_vehicle_routes

click node_applicant_ui "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/frontend/src/app/applicant"
click node_application_routes "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/backend/src/routes/applications"
click node_application_controllers "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/backend/src/controller/applications"
click node_application_services "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/backend/src/services/applications"
click node_application_status "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/services/applications/application.service.js"
click node_application_admin_ui "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/frontend/src/app/application-admin"
click node_admin_routes "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/routes/applications/admin.routes.js"
click node_admin_controller "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/controller/applications/admin.controller.js"
click node_admin_service "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/services/applications/admin.service.js"
click node_email "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/email/sendEmail.js"
click node_superadmin_ui "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/frontend/src/app/super-admin"
click node_superadmin_routes "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/routes/super-admin/super-admin.routes.js"
click node_superadmin_controller "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/controller/super-admin/super-admin.controller.js"
click node_superadmin_service "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/services/super-admin/super-admin.js"
click node_audit "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/services/audit.service.js"
click node_vehicle_ui "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/frontend/src/app/vehicle"
click node_vehicle_routes "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/routes/vehicle/vehicle.routes.js"
click node_vehicle_controller "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/controller/vehicle/vehicle.controller.js"
click node_vehicle_service "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/services/vehicle/vehicle.service.js"
click node_auth_middleware "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/middleware/requireAuthentication.js"
click node_authorization "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/middleware/requireAuthorization.js"
click node_service_guard "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/middleware/requireAppAdminServices.js"
click node_auth "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/lib/auth.js"
click node_database "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/lib/prisma.js"
click node_server "https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/server.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_applicant_ui,node_application_routes,node_application_controllers,node_application_services,node_application_status,node_application_admin_ui,node_admin_routes,node_admin_controller,node_admin_service toneBlue
class node_superadmin_ui,node_superadmin_routes,node_superadmin_controller,node_superadmin_service,node_audit toneAmber
class node_vehicle_ui,node_vehicle_routes,node_vehicle_controller,node_vehicle_service toneMint
class node_email,node_auth_middleware,node_authorization,node_service_guard,node_auth,node_database,node_server toneRose
class node_applicant toneIndigo
```

## Components

### Permitting Workflow

- [Applicant Portal](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/frontend/src/app/applicant): `frontend/src/app/applicant`
- [Application Routes](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/backend/src/routes/applications): `backend/src/routes/applications`
- [Application Controllers](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/backend/src/controller/applications): `backend/src/controller/applications`
- [Application Services](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/backend/src/services/applications): `backend/src/services/applications`
- [Application Status](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/services/applications/application.service.js): `backend/src/services/applications/application.service.js`
- [Review Console](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/frontend/src/app/application-admin): `frontend/src/app/application-admin`
- [Review Routes](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/routes/applications/admin.routes.js): `backend/src/routes/applications/admin.routes.js`
- [Review Controller](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/controller/applications/admin.controller.js): `backend/src/controller/applications/admin.controller.js`
- [Review Service](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/services/applications/admin.service.js): `backend/src/services/applications/admin.service.js`

### Administration

- [Super Admin Console](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/frontend/src/app/super-admin): `frontend/src/app/super-admin`
- [Super Admin Routes](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/routes/super-admin/super-admin.routes.js): `backend/src/routes/super-admin/super-admin.routes.js`
- [Super Admin Controller](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/controller/super-admin/super-admin.controller.js): `backend/src/controller/super-admin/super-admin.controller.js`
- [Super Admin Service](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/services/super-admin/super-admin.js): `backend/src/services/super-admin/super-admin.js`
- [Audit Logging](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/services/audit.service.js): `backend/src/services/audit.service.js`

### Fleet Operations

- [Vehicle Console](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/tree/main/frontend/src/app/vehicle): `frontend/src/app/vehicle`
- [Vehicle Routes](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/routes/vehicle/vehicle.routes.js): `backend/src/routes/vehicle/vehicle.routes.js`
- [Vehicle Controller](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/controller/vehicle/vehicle.controller.js): `backend/src/controller/vehicle/vehicle.controller.js`
- [Vehicle Service](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/services/vehicle/vehicle.service.js): `backend/src/services/vehicle/vehicle.service.js`

### Platform Services

- [Status Email](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/email/sendEmail.js): `backend/src/email/sendEmail.js`
- [Authentication](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/middleware/requireAuthentication.js): `backend/src/middleware/requireAuthentication.js`
- [Role Authorization](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/middleware/requireAuthorization.js): `backend/src/middleware/requireAuthorization.js`
- [Service Access Guard](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/middleware/requireAppAdminServices.js): `backend/src/middleware/requireAppAdminServices.js`
- [Auth Library](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/lib/auth.js): `backend/src/lib/auth.js`
- [PostgreSQL Database](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/lib/prisma.js): `backend/src/lib/prisma.js`
- [Express Server](https://github.com/volfnirr/web-based-regulation-and-permit-system-with-optimized-field-vehicle-scheduling-and-monitoring/blob/main/backend/src/server.js): `backend/src/server.js`

### Other components

- **Applicant**

## Connections

- Application Routes → Application Controllers: routes to (evidence: `backend/src/routes/applications/residential.routes.js`)
- Application Controllers → Application Services: uses services (evidence: `backend/src/controller/applications/residential.controller.js`)
- Application Status → PostgreSQL Database: queries (evidence: `backend/src/services/applications/application.service.js`)
- Review Routes → Review Controller: routes to (evidence: `backend/src/routes/applications/admin.routes.js`)
- Review Controller → Review Service: calls (evidence: `backend/src/controller/applications/admin.controller.js`)
- Review Controller → Status Email: sends status (evidence: `backend/src/controller/applications/admin.controller.js`)
- Review Controller → Audit Logging: records actions (evidence: `backend/src/controller/applications/admin.controller.js`)
- Review Service → PostgreSQL Database: queries (evidence: `backend/src/services/applications/admin.service.js`)
- Super Admin Routes → Super Admin Controller: routes to (evidence: `backend/src/routes/super-admin/super-admin.routes.js`)
- Super Admin Controller → Super Admin Service: calls (evidence: `backend/src/controller/super-admin/super-admin.controller.js`)
- Super Admin Controller → Audit Logging: records actions (evidence: `backend/src/controller/super-admin/super-admin.controller.js`)
- Super Admin Service → PostgreSQL Database: queries
- Vehicle Routes → Vehicle Controller: routes to (evidence: `backend/src/routes/vehicle/vehicle.routes.js`)
- Vehicle Controller → Vehicle Service: calls (evidence: `backend/src/controller/vehicle/vehicle.controller.js`)
- Vehicle Controller → PostgreSQL Database: queries (evidence: `backend/src/controller/vehicle/vehicle.controller.js`)
- Vehicle Controller → Audit Logging: records actions (evidence: `backend/src/controller/vehicle/vehicle.controller.js`)
- Vehicle Service → PostgreSQL Database: queries (evidence: `backend/src/services/vehicle/vehicle.service.js`)
- Authentication → Auth Library: checks session (evidence: `backend/src/middleware/requireAuthentication.js`)
- Service Access Guard → PostgreSQL Database: checks assignments (evidence: `backend/src/middleware/requireAppAdminServices.js`)
- Express Server → Application Routes: mounts routes (evidence: `backend/src/server.js`)
- Express Server → Review Routes: mounts routes (evidence: `backend/src/server.js`)
- Express Server → Super Admin Routes: mounts routes (evidence: `backend/src/server.js`)
- Express Server → Vehicle Routes: mounts routes (evidence: `backend/src/server.js`)
