# nexarobs/cabin_management_app architecture

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

- Interactive diagram: https://gitdiagram.com/nexarobs/cabin_management_app
- Repository: https://github.com/nexarobs/cabin_management_app

## Overview

Cabin Management is a role-based web application for administering users and tracking current and forecast installation progress across four Sahara regions. Users enter through role-specific dashboards: administrators manage accounts, project managers review regional/site progress and forecasts, and the general director has consolidated views. The backend exposes authentication, user, current-site, and forecast-site routes, with controllers delegating to MySQL-backed models; user creation also sends a welcome email. README capabilities include CSV export and saved progress history, but their implementing source was not sampled. Frontend-to-API wiring is likewise not established by the excerpts, so that connection is omitted.

Main entry points: [`frontend/src/project_manager/PmDashboard.jsx`](https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/project_manager/PmDashboard.jsx) (Project manager dashboard), [`backend/db.js`](https://github.com/nexarobs/cabin_management_app/blob/master/backend/db.js) (MySQL pool), [`backend/server.js`](https://github.com/nexarobs/cabin_management_app/blob/master/backend/server.js) (Express API server), [`backend/controllers/userController.js`](https://github.com/nexarobs/cabin_management_app/blob/master/backend/controllers/userController.js) (User management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Role dashboards"]
  node_users["Admin users<br/>[usersList.jsx]"]
  node_admin["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_pm["Project manager dashboard<br/>[PmDashboard.jsx]"]
  node_pmviews["Current and forecast views<br/>[PMLandingp.jsx]"]
  node_piecard["Progress cards<br/>[PieCard.jsx]"]
  node_charts["Regional charts<br/>[PieCharts4.jsx]"]
  node_gauges["Progress gauges<br/>[Gauge.jsx]"]
  node_director["Director dashboard<br/>[BossDashboard.jsx]"]
  node_csv["CSV reporting"]
end

subgraph group_api["Backend API"]
  node_usersroutes["User routes<br/>[userRoutes.js]"]
  node_usercontroller["User management<br/>[userController.js]"]
  node_authroutes["Authentication routes<br/>[auth.js]"]
  node_authcontroller["Authentication<br/>[auth.js]"]
  node_token["JWT verification"]
  node_currentroutes["Current site routes<br/>[siteRoutes.js]"]
  node_server["Express API server<br/>[server.js]"]
end

subgraph group_domain["Site progress data"]
  node_forecastcontroller["Regional forecast operations"]
  node_currentcontroller["Regional current operations"]
  node_forecastmodel["Forecast site data<br/>[siteModelPrevGD.js]"]
  node_currentmodel["Current site data<br/>[siteModelGD.js]"]
end

subgraph group_persistence["Persistence and email"]
  node_user_model["User records<br/>[userModel.js]"]
  node_authmodel["Credential records<br/>[auth.js]"]
  node_mysql[("MySQL pool<br/>[db.js]")]
  node_email["Welcome email sender<br/>[emailService.js]"]
end

node_smtp{{"Gmail SMTP"}}
node_adminuser_actor(("Administrator"))
node_pm_actor(("Project manager"))
node_director_actor(("Director general"))

node_adminuser_actor -->|"uses"| node_admin
node_admin -->|"renders"| node_users
node_pm_actor -->|"uses"| node_pm
node_pm -->|"renders"| node_pmviews
node_pm -->|"renders"| node_charts
node_pm -->|"renders"| node_piecard
node_pmviews -->|"renders"| node_charts
node_piecard -->|"renders"| node_gauges
node_director_actor -->|"uses"| node_director
node_server -->|"mounts"| node_usersroutes
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_currentroutes
node_usersroutes -->|"routes to"| node_usercontroller
node_authroutes -->|"routes to"| node_authcontroller
node_authroutes -->|"verifies with"| node_token
node_currentroutes -->|"routes to"| node_currentcontroller
node_usercontroller -->|"calls"| node_user_model
node_usercontroller -->|"sends welcome email"| node_email
node_authcontroller -->|"calls"| node_authmodel
node_authcontroller -->|"uses"| node_email
node_currentcontroller -->|"calls"| node_currentmodel
node_forecastcontroller -->|"calls"| node_forecastmodel
node_user_model -->|"queries"| node_mysql
node_authmodel -->|"queries"| node_mysql
node_currentmodel -->|"queries"| node_mysql
node_forecastmodel -->|"queries"| node_mysql
node_email -->|"sends through"| node_smtp
node_csv -.->|"supports reporting"| node_pm

click node_users "https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/admin/usersList.jsx"
click node_admin "https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/admin/AdminDashboard.jsx"
click node_pm "https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/project_manager/PmDashboard.jsx"
click node_pmviews "https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/Content-Components/PMLandingp.jsx"
click node_piecard "https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/Content-Components/PieCard.jsx"
click node_charts "https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/Content-Components/PieCharts4.jsx"
click node_gauges "https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/Gauge-MUI/Gauge.jsx"
click node_director "https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/boss/BossDashboard.jsx"
click node_csv "https://github.com/nexarobs/cabin_management_app/tree/master/frontend/src"
click node_usersroutes "https://github.com/nexarobs/cabin_management_app/blob/master/backend/routes/userRoutes.js"
click node_usercontroller "https://github.com/nexarobs/cabin_management_app/blob/master/backend/controllers/userController.js"
click node_authroutes "https://github.com/nexarobs/cabin_management_app/blob/master/backend/routes/auth.js"
click node_authcontroller "https://github.com/nexarobs/cabin_management_app/blob/master/backend/controllers/auth.js"
click node_token "https://github.com/nexarobs/cabin_management_app/blob/master/backend/middleware/tokenVerification.js"
click node_currentroutes "https://github.com/nexarobs/cabin_management_app/blob/master/backend/routes/siteRoutes.js"
click node_forecastcontroller "https://github.com/nexarobs/cabin_management_app/blob/master/backend/controllers/siteControllerPrevGD.js"
click node_currentcontroller "https://github.com/nexarobs/cabin_management_app/blob/master/backend/controllers/siteControllerGD.js"
click node_forecastmodel "https://github.com/nexarobs/cabin_management_app/blob/master/backend/models/siteModelPrevGD.js"
click node_currentmodel "https://github.com/nexarobs/cabin_management_app/blob/master/backend/models/siteModelGD.js"
click node_user_model "https://github.com/nexarobs/cabin_management_app/blob/master/backend/models/userModel.js"
click node_authmodel "https://github.com/nexarobs/cabin_management_app/blob/master/backend/models/auth.js"
click node_mysql "https://github.com/nexarobs/cabin_management_app/blob/master/backend/db.js"
click node_email "https://github.com/nexarobs/cabin_management_app/blob/master/backend/services/emailService.js"
click node_server "https://github.com/nexarobs/cabin_management_app/blob/master/backend/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_users,node_admin,node_pm,node_pmviews,node_piecard,node_charts,node_gauges,node_director,node_csv toneBlue
class node_usersroutes,node_usercontroller,node_authroutes,node_authcontroller,node_token,node_currentroutes,node_server toneAmber
class node_forecastcontroller,node_currentcontroller,node_forecastmodel,node_currentmodel toneMint
class node_user_model,node_authmodel,node_mysql,node_email toneRose
class node_smtp,node_adminuser_actor,node_pm_actor,node_director_actor toneIndigo
```

## Components

### Role dashboards

- [Admin users](https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/admin/usersList.jsx): `frontend/src/admin/usersList.jsx`
- [Admin dashboard](https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/admin/AdminDashboard.jsx): `frontend/src/admin/AdminDashboard.jsx`
- [Project manager dashboard](https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/project_manager/PmDashboard.jsx): `frontend/src/project_manager/PmDashboard.jsx`
- [Current and forecast views](https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/Content-Components/PMLandingp.jsx): `frontend/src/Content-Components/PMLandingp.jsx`
- [Progress cards](https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/Content-Components/PieCard.jsx): `frontend/src/Content-Components/PieCard.jsx`
- [Regional charts](https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/Content-Components/PieCharts4.jsx): `frontend/src/Content-Components/PieCharts4.jsx`
- [Progress gauges](https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/Gauge-MUI/Gauge.jsx): `frontend/src/Gauge-MUI/Gauge.jsx`
- [Director dashboard](https://github.com/nexarobs/cabin_management_app/blob/master/frontend/src/boss/BossDashboard.jsx): `frontend/src/boss/BossDashboard.jsx`
- [CSV reporting](https://github.com/nexarobs/cabin_management_app/tree/master/frontend/src): `frontend/src`

### Backend API

- [User routes](https://github.com/nexarobs/cabin_management_app/blob/master/backend/routes/userRoutes.js): `backend/routes/userRoutes.js`
- [User management](https://github.com/nexarobs/cabin_management_app/blob/master/backend/controllers/userController.js): `backend/controllers/userController.js`
- [Authentication routes](https://github.com/nexarobs/cabin_management_app/blob/master/backend/routes/auth.js): `backend/routes/auth.js`
- [Authentication](https://github.com/nexarobs/cabin_management_app/blob/master/backend/controllers/auth.js): `backend/controllers/auth.js`
- [JWT verification](https://github.com/nexarobs/cabin_management_app/blob/master/backend/middleware/tokenVerification.js): `backend/middleware/tokenVerification.js`
- [Current site routes](https://github.com/nexarobs/cabin_management_app/blob/master/backend/routes/siteRoutes.js): `backend/routes/siteRoutes.js`
- [Express API server](https://github.com/nexarobs/cabin_management_app/blob/master/backend/server.js): `backend/server.js`

### Site progress data

- [Regional forecast operations](https://github.com/nexarobs/cabin_management_app/blob/master/backend/controllers/siteControllerPrevGD.js): `backend/controllers/siteControllerPrevGD.js`
- [Regional current operations](https://github.com/nexarobs/cabin_management_app/blob/master/backend/controllers/siteControllerGD.js): `backend/controllers/siteControllerGD.js`
- [Forecast site data](https://github.com/nexarobs/cabin_management_app/blob/master/backend/models/siteModelPrevGD.js): `backend/models/siteModelPrevGD.js`
- [Current site data](https://github.com/nexarobs/cabin_management_app/blob/master/backend/models/siteModelGD.js): `backend/models/siteModelGD.js`

### Persistence and email

- [User records](https://github.com/nexarobs/cabin_management_app/blob/master/backend/models/userModel.js): `backend/models/userModel.js`
- [Credential records](https://github.com/nexarobs/cabin_management_app/blob/master/backend/models/auth.js): `backend/models/auth.js`
- [MySQL pool](https://github.com/nexarobs/cabin_management_app/blob/master/backend/db.js): `backend/db.js`
- [Welcome email sender](https://github.com/nexarobs/cabin_management_app/blob/master/backend/services/emailService.js): `backend/services/emailService.js`

### Other components

- **Gmail SMTP**
- **Administrator**
- **Project manager**
- **Director general**

## Connections

- Administrator → Admin dashboard: uses
- Admin dashboard → Admin users: renders (evidence: `frontend/src/admin/AdminDashboard.jsx`)
- Project manager → Project manager dashboard: uses
- Project manager dashboard → Current and forecast views: renders (evidence: `frontend/src/project_manager/PmDashboard.jsx`)
- Project manager dashboard → Regional charts: renders (evidence: `frontend/src/project_manager/PmDashboard.jsx`)
- Project manager dashboard → Progress cards: renders (evidence: `frontend/src/project_manager/PmDashboard.jsx`)
- Current and forecast views → Regional charts: renders (evidence: `frontend/src/Content-Components/PMLandingp.jsx`)
- Progress cards → Progress gauges: renders (evidence: `frontend/src/Content-Components/PieCard.jsx`)
- Director general → Director dashboard: uses
- Express API server → User routes: mounts (evidence: `backend/server.js`)
- Express API server → Authentication routes: mounts (evidence: `backend/server.js`)
- Express API server → Current site routes: mounts (evidence: `backend/server.js`)
- User routes → User management: routes to (evidence: `backend/routes/userRoutes.js`)
- Authentication routes → Authentication: routes to (evidence: `backend/routes/auth.js`)
- Authentication routes → JWT verification: verifies with (evidence: `backend/routes/auth.js`)
- Current site routes → Regional current operations: routes to (evidence: `backend/routes/siteRoutes.js`)
- User management → User records: calls (evidence: `backend/controllers/userController.js`)
- User management → Welcome email sender: sends welcome email (evidence: `backend/controllers/userController.js`)
- Authentication → Credential records: calls (evidence: `backend/controllers/auth.js`)
- Authentication → Welcome email sender: uses (evidence: `backend/controllers/auth.js`)
- Regional current operations → Current site data: calls (evidence: `backend/controllers/siteControllerGD.js`)
- Regional forecast operations → Forecast site data: calls (evidence: `backend/controllers/siteControllerPrevGD.js`)
- User records → MySQL pool: queries (evidence: `backend/models/userModel.js`)
- Credential records → MySQL pool: queries (evidence: `backend/models/auth.js`)
- Current site data → MySQL pool: queries (evidence: `backend/models/siteModelGD.js`)
- Forecast site data → MySQL pool: queries (evidence: `backend/models/siteModelPrevGD.js`)
- Welcome email sender → Gmail SMTP: sends through (evidence: `backend/services/emailService.js`)
- CSV reporting → Project manager dashboard: supports reporting (evidence: `frontend/src/App.jsx`)
