How nexarobs/cabin_management_app works
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: PmDashboard.jsx Project manager dashboard · db.js MySQL pool · server.js Express API server · userController.js User management
Components 28
Role dashboards
- Admin users
frontend/src/admin/usersList.jsx - Admin dashboard
frontend/src/admin/AdminDashboard.jsx - Project manager dashboard
frontend/src/project_manager/PmDashboard.jsx - Current and forecast views
frontend/src/Content-Components/PMLandingp.jsx - Progress cards
frontend/src/Content-Components/PieCard.jsx - Regional charts
frontend/src/Content-Components/PieCharts4.jsx - Progress gauges
frontend/src/Gauge-MUI/Gauge.jsx - Director dashboard
frontend/src/boss/BossDashboard.jsx - CSV reporting
frontend/src
Backend API
- User routes
backend/routes/userRoutes.js - User management
backend/controllers/userController.js - Authentication routes
backend/routes/auth.js - Authentication
backend/controllers/auth.js - JWT verification
backend/middleware/tokenVerification.js - Current site routes
backend/routes/siteRoutes.js - Express API server
backend/server.js
Site progress data
- Regional forecast operations
backend/controllers/siteControllerPrevGD.js - Regional current operations
backend/controllers/siteControllerGD.js - Forecast site data
backend/models/siteModelPrevGD.js - Current site data
backend/models/siteModelGD.js
Persistence and email
- User records
backend/models/userModel.js - Credential records
backend/models/auth.js - MySQL pool
backend/db.js - Welcome email sender
backend/services/emailService.js
Other components
- Gmail SMTP
- Administrator
- Project manager
- Director general
Connections 28
- Administrator → Admin dashboard: uses
- Admin dashboard → Admin users: renders
frontend/src/admin/AdminDashboard.jsx - Project manager → Project manager dashboard: uses
- Project manager dashboard → Current and forecast views: renders
frontend/src/project_manager/PmDashboard.jsx - Project manager dashboard → Regional charts: renders
frontend/src/project_manager/PmDashboard.jsx - Project manager dashboard → Progress cards: renders
frontend/src/project_manager/PmDashboard.jsx - Current and forecast views → Regional charts: renders
frontend/src/Content-Components/PMLandingp.jsx - Progress cards → Progress gauges: renders
frontend/src/Content-Components/PieCard.jsx - Director general → Director dashboard: uses
- Express API server → User routes: mounts
backend/server.js - Express API server → Authentication routes: mounts
backend/server.js - Express API server → Current site routes: mounts
backend/server.js - User routes → User management: routes to
backend/routes/userRoutes.js - Authentication routes → Authentication: routes to
backend/routes/auth.js - Authentication routes → JWT verification: verifies with
backend/routes/auth.js - Current site routes → Regional current operations: routes to
backend/routes/siteRoutes.js - User management → User records: calls
backend/controllers/userController.js - User management → Welcome email sender: sends welcome email
backend/controllers/userController.js - Authentication → Credential records: calls
backend/controllers/auth.js - Authentication → Welcome email sender: uses
backend/controllers/auth.js - Regional current operations → Current site data: calls
backend/controllers/siteControllerGD.js - Regional forecast operations → Forecast site data: calls
backend/controllers/siteControllerPrevGD.js - User records → MySQL pool: queries
backend/models/userModel.js - Credential records → MySQL pool: queries
backend/models/auth.js - Current site data → MySQL pool: queries
backend/models/siteModelGD.js - Forecast site data → MySQL pool: queries
backend/models/siteModelPrevGD.js - Welcome email sender → Gmail SMTP: sends through
backend/services/emailService.js - CSV reporting → Project manager dashboard: supports reporting
frontend/src/App.jsx