# andreis111/fleetmate architecture

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

- Interactive diagram: https://gitdiagram.com/andreis111/fleetmate
- Repository: https://github.com/andreis111/fleetmate

## Overview

FleetMate is a fleet-management web app for administrators and drivers. Administrators create and assign trucks and drivers, then review submitted trip spreadsheets and repair reports; drivers view their assigned truck, record weekly trips, and report repairs with photos. Express routes dispatch requests to controllers, which read and update MongoDB-backed models and render EJS pages. The excerpts show route dispatch, controller/model references, and photo-upload calls; some administration behavior and model relationships are known only from the source index or README, so those links are limited accordingly.

Main entry points: [`controllers/admin.js`](https://github.com/andreis111/fleetmate/blob/main/controllers/admin.js) (Admin workflows), [`controllers/driver.js`](https://github.com/andreis111/fleetmate/blob/main/controllers/driver.js) (Driver workflows), [`server.js`](https://github.com/andreis111/fleetmate/blob/main/server.js) (Express server), [`routes/admin.js`](https://github.com/andreis111/fleetmate/blob/main/routes/admin.js) (Admin routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and access"]
  node_server["Express server<br/>[server.js]"]
  node_mainroutes["Main routes<br/>[main.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_passport["Passport strategies<br/>[passport.js]"]
  node_access["Access middleware<br/>[checkRole.js]"]
  node_uploads["Upload handling<br/>[multer.js]"]
  node_cloudinary["Photo storage<br/>[cloudinary.js]"]
end

subgraph group_admin["Fleet administration"]
  node_adminroutes["Admin routes<br/>[admin.js]"]
  node_adminctrl["Admin workflows<br/>[admin.js]"]
  node_adminui["Admin pages"]
end

subgraph group_driver["Driver operations"]
  node_driverroutes["Driver routes<br/>[driver.js]"]
  node_driverctrl["Driver workflows<br/>[driver.js]"]
  node_driverui["Driver pages"]
end

subgraph group_data["Fleet data"]
  node_admins[("Admin records<br/>[Admin.js]")]
  node_drivers[("Driver records<br/>[Driver.js]")]
  node_trucks[("Truck records<br/>[Truck.js]")]
  node_weekly[("Weekly spreadsheets<br/>[WeeklySs.js]")]
  node_trips[("Individual trips<br/>[IndividualTrip.js]")]
  node_repairs[("Repair reports<br/>[Repair.js]")]
  node_customoptions[("Truck options")]
  node_company[("Company records<br/>[Company.js]")]
end

node_user(("User"))
node_mongodb[("MongoDB")]

node_user -->|"uses"| node_server
node_server -->|"mounts"| node_mainroutes
node_server -->|"mounts"| node_adminroutes
node_server -->|"mounts"| node_driverroutes
node_server -->|"configures"| node_passport
node_server -->|"connects"| node_mongodb
node_mainroutes -->|"dispatches"| node_auth
node_auth -->|"authenticates"| node_passport
node_passport -->|"loads"| node_admins
node_passport -->|"loads"| node_drivers
node_auth -->|"creates"| node_admins
node_auth -->|"creates"| node_drivers
node_adminroutes -->|"dispatches"| node_adminctrl
node_adminroutes -->|"dispatches"| node_auth
node_adminroutes -->|"checks role"| node_access
node_adminctrl -->|"renders"| node_adminui
node_adminctrl -->|"queries"| node_admins
node_adminctrl -->|"queries"| node_drivers
node_adminctrl -->|"manages"| node_trucks
node_adminctrl -->|"reviews"| node_weekly
node_adminctrl -->|"queries"| node_trips
node_adminctrl -->|"reviews"| node_repairs
node_adminctrl -->|"manages"| node_customoptions
node_driverroutes -->|"dispatches"| node_driverctrl
node_driverroutes -->|"checks role"| node_access
node_driverctrl -->|"renders"| node_driverui
node_driverctrl -->|"reads"| node_drivers
node_driverctrl -->|"reads"| node_trucks
node_driverctrl -->|"manages"| node_weekly
node_driverctrl -->|"records"| node_trips
node_driverctrl -->|"records"| node_repairs
node_driverctrl -->|"reads"| node_company
node_adminroutes -->|"uses"| node_uploads
node_driverroutes -->|"uses"| node_uploads
node_adminctrl -->|"uploads photos"| node_cloudinary
node_driverctrl -->|"uploads photos"| node_cloudinary
node_admins -.->|"persists in"| node_mongodb
node_drivers -.->|"persists in"| node_mongodb
node_trucks -.->|"persists in"| node_mongodb
node_weekly -.->|"persists in"| node_mongodb
node_trips -.->|"persists in"| node_mongodb
node_repairs -.->|"persists in"| node_mongodb
node_customoptions -.->|"persists in"| node_mongodb
node_company -.->|"persists in"| node_mongodb

click node_server "https://github.com/andreis111/fleetmate/blob/main/server.js"
click node_mainroutes "https://github.com/andreis111/fleetmate/blob/main/routes/main.js"
click node_auth "https://github.com/andreis111/fleetmate/blob/main/controllers/auth.js"
click node_passport "https://github.com/andreis111/fleetmate/blob/main/config/passport.js"
click node_access "https://github.com/andreis111/fleetmate/blob/main/middleware/checkRole.js"
click node_adminroutes "https://github.com/andreis111/fleetmate/blob/main/routes/admin.js"
click node_adminctrl "https://github.com/andreis111/fleetmate/blob/main/controllers/admin.js"
click node_adminui "https://github.com/andreis111/fleetmate/tree/main/views"
click node_driverroutes "https://github.com/andreis111/fleetmate/blob/main/routes/driver.js"
click node_driverctrl "https://github.com/andreis111/fleetmate/blob/main/controllers/driver.js"
click node_driverui "https://github.com/andreis111/fleetmate/tree/main/views"
click node_uploads "https://github.com/andreis111/fleetmate/blob/main/middleware/multer.js"
click node_cloudinary "https://github.com/andreis111/fleetmate/blob/main/middleware/cloudinary.js"
click node_admins "https://github.com/andreis111/fleetmate/blob/main/models/Admin.js"
click node_drivers "https://github.com/andreis111/fleetmate/blob/main/models/Driver.js"
click node_trucks "https://github.com/andreis111/fleetmate/blob/main/models/Truck.js"
click node_weekly "https://github.com/andreis111/fleetmate/blob/main/models/WeeklySs.js"
click node_trips "https://github.com/andreis111/fleetmate/blob/main/models/IndividualTrip.js"
click node_repairs "https://github.com/andreis111/fleetmate/blob/main/models/Repair.js"
click node_customoptions "https://github.com/andreis111/fleetmate/blob/main/models/CustomOptionTruck.js"
click node_company "https://github.com/andreis111/fleetmate/blob/main/models/Company.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_server,node_mainroutes,node_auth,node_passport,node_access,node_uploads,node_cloudinary,node_user toneBlue
class node_adminroutes,node_adminctrl,node_adminui,node_mongodb toneAmber
class node_driverroutes,node_driverctrl,node_driverui toneMint
class node_admins,node_drivers,node_trucks,node_weekly,node_trips,node_repairs,node_customoptions,node_company toneRose
```

## Components

### Web and access

- [Express server](https://github.com/andreis111/fleetmate/blob/main/server.js): `server.js`
- [Main routes](https://github.com/andreis111/fleetmate/blob/main/routes/main.js): `routes/main.js`
- [Authentication](https://github.com/andreis111/fleetmate/blob/main/controllers/auth.js): `controllers/auth.js`
- [Passport strategies](https://github.com/andreis111/fleetmate/blob/main/config/passport.js): `config/passport.js`
- [Access middleware](https://github.com/andreis111/fleetmate/blob/main/middleware/checkRole.js): `middleware/checkRole.js`
- [Upload handling](https://github.com/andreis111/fleetmate/blob/main/middleware/multer.js): `middleware/multer.js`
- [Photo storage](https://github.com/andreis111/fleetmate/blob/main/middleware/cloudinary.js): `middleware/cloudinary.js`

### Fleet administration

- [Admin routes](https://github.com/andreis111/fleetmate/blob/main/routes/admin.js): `routes/admin.js`
- [Admin workflows](https://github.com/andreis111/fleetmate/blob/main/controllers/admin.js): `controllers/admin.js`
- [Admin pages](https://github.com/andreis111/fleetmate/tree/main/views): `views`

### Driver operations

- [Driver routes](https://github.com/andreis111/fleetmate/blob/main/routes/driver.js): `routes/driver.js`
- [Driver workflows](https://github.com/andreis111/fleetmate/blob/main/controllers/driver.js): `controllers/driver.js`
- [Driver pages](https://github.com/andreis111/fleetmate/tree/main/views): `views`

### Fleet data

- [Admin records](https://github.com/andreis111/fleetmate/blob/main/models/Admin.js): `models/Admin.js`
- [Driver records](https://github.com/andreis111/fleetmate/blob/main/models/Driver.js): `models/Driver.js`
- [Truck records](https://github.com/andreis111/fleetmate/blob/main/models/Truck.js): `models/Truck.js`
- [Weekly spreadsheets](https://github.com/andreis111/fleetmate/blob/main/models/WeeklySs.js): `models/WeeklySs.js`
- [Individual trips](https://github.com/andreis111/fleetmate/blob/main/models/IndividualTrip.js): `models/IndividualTrip.js`
- [Repair reports](https://github.com/andreis111/fleetmate/blob/main/models/Repair.js): `models/Repair.js`
- [Truck options](https://github.com/andreis111/fleetmate/blob/main/models/CustomOptionTruck.js): `models/CustomOptionTruck.js`
- [Company records](https://github.com/andreis111/fleetmate/blob/main/models/Company.js): `models/Company.js`

### Other components

- **User**
- **MongoDB**

## Connections

- User → Express server: uses (evidence: `README.md`)
- Express server → Main routes: mounts (evidence: `server.js`)
- Express server → Admin routes: mounts (evidence: `server.js`)
- Express server → Driver routes: mounts (evidence: `server.js`)
- Express server → Passport strategies: configures (evidence: `server.js`)
- Express server → MongoDB: connects (evidence: `server.js`)
- Main routes → Authentication: dispatches (evidence: `routes/main.js`)
- Authentication → Passport strategies: authenticates (evidence: `controllers/auth.js`)
- Passport strategies → Admin records: loads (evidence: `config/passport.js`)
- Passport strategies → Driver records: loads (evidence: `config/passport.js`)
- Authentication → Admin records: creates (evidence: `controllers/auth.js`)
- Authentication → Driver records: creates (evidence: `controllers/auth.js`)
- Admin routes → Admin workflows: dispatches (evidence: `routes/admin.js`)
- Admin routes → Authentication: dispatches (evidence: `routes/admin.js`)
- Admin routes → Access middleware: checks role (evidence: `routes/admin.js`)
- Admin workflows → Admin pages: renders (evidence: `controllers/admin.js`)
- Admin workflows → Admin records: queries (evidence: `controllers/admin.js`)
- Admin workflows → Driver records: queries (evidence: `controllers/admin.js`)
- Admin workflows → Truck records: manages (evidence: `controllers/admin.js`)
- Admin workflows → Weekly spreadsheets: reviews (evidence: `controllers/admin.js`)
- Admin workflows → Individual trips: queries (evidence: `controllers/admin.js`)
- Admin workflows → Repair reports: reviews (evidence: `controllers/admin.js`)
- Admin workflows → Truck options: manages (evidence: `controllers/admin.js`)
- Driver routes → Driver workflows: dispatches (evidence: `routes/driver.js`)
- Driver routes → Access middleware: checks role (evidence: `routes/driver.js`)
- Driver workflows → Driver pages: renders (evidence: `controllers/driver.js`)
- Driver workflows → Driver records: reads (evidence: `controllers/driver.js`)
- Driver workflows → Truck records: reads (evidence: `controllers/driver.js`)
- Driver workflows → Weekly spreadsheets: manages (evidence: `controllers/driver.js`)
- Driver workflows → Individual trips: records (evidence: `controllers/driver.js`)
- Driver workflows → Repair reports: records (evidence: `controllers/driver.js`)
- Driver workflows → Company records: reads (evidence: `controllers/driver.js`)
- Admin routes → Upload handling: uses (evidence: `routes/admin.js`)
- Driver routes → Upload handling: uses (evidence: `routes/driver.js`)
- Admin workflows → Photo storage: uploads photos (evidence: `controllers/admin.js`)
- Driver workflows → Photo storage: uploads photos (evidence: `controllers/driver.js`)
- Admin records → MongoDB: persists in
- Driver records → MongoDB: persists in
- Truck records → MongoDB: persists in
- Weekly spreadsheets → MongoDB: persists in
- Individual trips → MongoDB: persists in
- Repair reports → MongoDB: persists in
- Truck options → MongoDB: persists in
- Company records → MongoDB: persists in
