How nhungoc3052003/medequip works
MedEquip is an internal hospital system for managing medical-equipment inventory and reusable supplies. Staff authenticate under role-based permissions, then handle stock intake and removal, departmental requests and allocations, returns, maintenance, damage reports, and role-specific reporting. The README describes staged approvals for requests and returns, Excel-based stock intake/exports, QR-assisted return confirmation, and automated due-date alerts. Source excerpts show the API mounting route modules and several workflows sending notifications; many page and controller implementations were not sampled, so those capabilities are represented without guessing their internal calls.
Main entry points: routes API routes · notificationHelper.js Notification delivery · server.js Express API · App.tsx Web application
Components 25
Staff interface
- Web application
MedEquip/client/src/App.tsx - User session
MedEquip/client/src/contexts/AuthContext.tsx - Login service
MedEquip/client/src/services/authService.ts - Role-based pages
MedEquip/client/src/pages - REST client
MedEquip/client/src/services/api.ts
API and access
- Express API
MedEquip/server/server.js - API routes
MedEquip/server/routes - JWT and roles
MedEquip/server/middleware/auth.js - Authentication
MedEquip/server/controllers/authController.js - MySQL database
Stock operations
- Excel intake
MedEquip/server/controllers/importController.js - Stock exports
MedEquip/server/controllers/exportController.js - Inventory
MedEquip/server/controllers/inventoryController.js - Equipment catalog
MedEquip/server/controllers/equipmentController.js
Equipment workflows
- Allocations
MedEquip/server/controllers/allocationController.js - Department requests
MedEquip/server/controllers/requestController.js - Returns and QR
MedEquip/server/controllers/returnController.js - Damage reports
MedEquip/server/controllers/damageReportController.js - Maintenance
MedEquip/server/controllers/maintenanceController.js - Departments and suppliers
MedEquip/server/controllers/departmentController.js
Notifications and reports
- Notification delivery
MedEquip/server/utils/notificationHelper.js - Due-date checks
MedEquip/server/services/dueNotificationService.js - Notification inbox
MedEquip/server/controllers/notificationController.js - Reports and exports
MedEquip/server/controllers/reportController.js
Other components
- Hospital staff
Connections 27
- Hospital staff → Web application: uses
- Web application → Role-based pages: routes to
MedEquip/client/src/App.tsx - User session → Login service: uses
- Login service → REST client: calls
MedEquip/client/src/services/authService.ts - REST client → Express API: sends REST requests
MedEquip/client/src/services/api.ts - Express API → API routes: mounts
MedEquip/server/server.js - API routes → JWT and roles: applies access checks
MedEquip/server/routes/auth.js - API routes → Authentication: dispatches
MedEquip/server/routes/auth.js - API routes → Excel intake: dispatches
MedEquip/server/routes/imports.js - API routes → Stock exports: dispatches
MedEquip/server/routes/exports.js - API routes → Inventory: dispatches
MedEquip/server/routes/inventory.js - API routes → Equipment catalog: dispatches
MedEquip/server/routes/equipment.js - API routes → Allocations: dispatches
MedEquip/server/routes/allocations.js - API routes → Department requests: dispatches
- API routes → Returns and QR: dispatches
MedEquip/server/routes/returns.js - API routes → Damage reports: dispatches
MedEquip/server/routes/damageReports.js - API routes → Maintenance: dispatches
MedEquip/server/routes/maintenance.js - API routes → Departments and suppliers: dispatches
MedEquip/server/routes/departments.js - API routes → Notification inbox: dispatches
MedEquip/server/routes/notifications.js - API routes → Reports and exports: dispatches
MedEquip/server/routes/reports.js - Express API → Due-date checks: schedules
MedEquip/server/server.js - Department requests → Notification delivery: sends alerts
MedEquip/server/controllers/requestController.js - Returns and QR → Notification delivery: sends alerts
MedEquip/server/controllers/returnController.js - Excel intake → Notification delivery: sends alerts
MedEquip/server/controllers/importController.js - Stock exports → Notification delivery: sends alerts
MedEquip/server/controllers/exportController.js - Maintenance → Notification delivery: sends alerts
MedEquip/server/controllers/maintenanceController.js - Due-date checks → Notification delivery: sends reminders
MedEquip/server/services/dueNotificationService.js