How ishwar-123/assets-flow-app works
AssetFlow is an enterprise asset inventory and lifecycle platform. Users authenticate into a role-aware React workspace, then register and track assets, allocate or book them, manage maintenance and audits, and review analytics and activity logs. Express routes dispatch these operations to controllers backed by MongoDB models; controllers also record activity and create notifications. The README documents the broader capabilities, while several frontend pages and backend modules were not sampled, so their detailed request flows are not asserted here.
Main entry points: App.js React application · routes REST route modules · dashboardController.js Dashboard summaries · automationJobs.js Scheduled automation
Components 31
User workspace
- React application
frontend/src/App.js - Sign-in and session
frontend/src/pages/Auth.jsx - Asset directory
frontend/src/pages/AssetDirectory.jsx - Allocations
frontend/src/pages/Allocation.jsx - Bookings
frontend/src/pages/Booking.jsx - Maintenance
frontend/src/pages/Maintenance.jsx - Audits
frontend/src/pages/Audit.jsx - Analytics and logs
frontend/src/pages/Analytics.jsx - Organization setup
frontend/src/pages/OrganizationSetup.jsx - Auth context
frontend/src/context/AuthContext.js
API and access
- Express API
backend/server.js - REST route modules
backend/routes - JWT and role checks
backend/middleware/authMiddleware.js
Asset lifecycle
- Asset management
backend/controllers/assetController.js - Allocation workflows
backend/controllers/allocationController.js - Booking workflows
backend/controllers/bookingController.js - Maintenance workflows
backend/controllers/maintenanceController.js
Operations and insight
- Audit workflows
backend/controllers/auditController.js - Dashboard summaries
backend/controllers/dashboardController.js - Scheduled automation
backend/cron/automationJobs.js - Activity logging
backend/utils/activityLogger.js - Notifications
backend/utils/notify.js
Persistent records
- Asset records
backend/models/Asset.js - Allocation records
backend/models/Allocation.js - Booking records
backend/models/Booking.js - Maintenance records
backend/models/Maintenance.js - Audit records
backend/models/Audit.js - User records
backend/models/User.js - Notification records
backend/models/Notification.js - Activity log records
backend/models/ActivityLog.js
Other components
- Employee or admin
Connections 48
- Employee or admin → React application: uses
- React application → Sign-in and session: routes to
frontend/src/App.js - React application → Asset directory: routes to
frontend/src/App.js - React application → Allocations: routes to
frontend/src/App.js - React application → Bookings: routes to
frontend/src/App.js - React application → Maintenance: routes to
frontend/src/App.js - React application → Audits: routes to
frontend/src/App.js - React application → Analytics and logs: routes to
frontend/src/App.js - React application → Organization setup: routes to
frontend/src/App.js - React application → Auth context: provides session
frontend/src/App.js - Auth context → Express API: posts login
frontend/src/context/AuthContext.js - Express API → REST route modules: mounts
backend/server.js - REST route modules → JWT and role checks: guards requests
backend/routes/assetRoutes.js - REST route modules → Asset management: dispatches assets
backend/routes/assetRoutes.js - REST route modules → Allocation workflows: dispatches allocations
backend/routes/allocationRoutes.js - REST route modules → Booking workflows: dispatches bookings
backend/routes/bookingRoutes.js - REST route modules → Maintenance workflows: dispatches maintenance
backend/routes/maintenanceRoutes.js - REST route modules → Audit workflows: dispatches audits
backend/routes/auditRoutes.js - REST route modules → Dashboard summaries: dispatches dashboard
- Asset management → Asset records: reads and writes
backend/controllers/assetController.js - Asset management → Allocation records: reads history
backend/controllers/assetController.js - Asset management → Booking records: reads history
backend/controllers/assetController.js - Asset management → Maintenance records: reads history
backend/controllers/assetController.js - Allocation workflows → Asset records: updates status
backend/controllers/allocationController.js - Allocation workflows → Allocation records: creates and updates
backend/controllers/allocationController.js - Allocation workflows → Activity logging: logs actions
backend/controllers/allocationController.js - Allocation workflows → Notifications: creates notices
backend/controllers/allocationController.js - Maintenance workflows → Maintenance records: creates and updates
backend/controllers/maintenanceController.js - Maintenance workflows → Asset records: updates status
backend/controllers/maintenanceController.js - Maintenance workflows → Activity logging: logs actions
backend/controllers/maintenanceController.js - Maintenance workflows → Notifications: creates notices
backend/controllers/maintenanceController.js - Booking workflows → Booking records: reads and writes
backend/controllers/bookingController.js - Booking workflows → Asset records: checks asset
backend/controllers/bookingController.js - Audit workflows → Audit records: reads and writes
backend/controllers/auditController.js - Audit workflows → Asset records: checks assets
backend/controllers/auditController.js - Audit workflows → Activity logging: logs actions
backend/controllers/auditController.js - Audit workflows → Notifications: creates notices
backend/controllers/auditController.js - Dashboard summaries → Asset records: summarizes
backend/controllers/dashboardController.js - Dashboard summaries → Allocation records: summarizes
backend/controllers/dashboardController.js - Dashboard summaries → Maintenance records: summarizes
backend/controllers/dashboardController.js - Dashboard summaries → Booking records: summarizes
backend/controllers/dashboardController.js - Dashboard summaries → User records: counts users
backend/controllers/dashboardController.js - Express API → Scheduled automation: starts after database connects
backend/server.js - Scheduled automation → Asset records: checks records
backend/cron/automationJobs.js - Scheduled automation → Allocation records: checks records
backend/cron/automationJobs.js - Scheduled automation → Booking records: checks records
backend/cron/automationJobs.js - Scheduled automation → Notification records: creates records
backend/cron/automationJobs.js - Scheduled automation → User records: checks users
backend/cron/automationJobs.js