How springboardmentor93924a-prog/medical-platform works
MediStock is a role-based medical inventory and supplier-management platform: users enter through the React application, use role-specific workflows for inventory, procurement, dispensing, and administration, and receive results through the backend API. The sampled files confirm frontend routing and context setup, plus selected backend controller/service relationships. Other documented capabilities are retained as subsystems, but their internal calls are not asserted where source was not sampled.
Main entry points: App.jsx React application · SupplierController.java Supplier governance · AppRoutes.jsx Role-based routes · AuthContext.jsx Auth context
Components 28
Web application
- React application
frontend/src/App.jsx - Role-based routes
frontend/src/routes/AppRoutes.jsx - Auth context
frontend/src/context/AuthContext.jsx - Notification context
frontend/src/context/NotificationContext.jsx - API clients
frontend/src/services/api.js - Auth client
frontend/src/services/authService.js - Order client
frontend/src/services/purchaseOrderService.js - Procurement screens
frontend/src/pages/purchase-orders/PurchaseOrdersPage.jsx
Identity and access
- Authentication
backend/src/main/java/com/medistock/service/impl/AuthServiceImpl.java - Auth endpoints
backend/src/main/java/com/medistock/controller/AuthController.java - User records
backend/src/main/java/com/medistock/entity/User.java
Inventory operations
- Medicine inventory
backend/src/main/java/com/medistock/controller/MedicineController.java - Medicine batches
backend/src/main/java/com/medistock/entity/Medicine.java - Stock movements
backend/src/main/java/com/medistock/controller/StockMovementController.java - FEFO guidance
backend/src/main/java/com/medistock/service/FefoService.java - Wastage review
backend/src/main/java/com/medistock/controller/WastageController.java
Supplier procurement
- Purchase orders
backend/src/main/java/com/medistock/controller/PurchaseOrderController.java - Order lifecycle
backend/src/main/java/com/medistock/service/PurchaseOrderService.java - Supplier governance
backend/src/main/java/com/medistock/controller/SupplierController.java - Supplier records
backend/src/main/java/com/medistock/entity/Supplier.java
Administration and insight
- Dashboards
backend/src/main/java/com/medistock/controller/DashboardController.java - Reports and exports
backend/src/main/java/com/medistock/controller/ReportController.java - Audit trail
backend/src/main/java/com/medistock/service/AuditLogService.java - Backup recovery
backend/src/main/java/com/medistock/controller/BackupController.java - Notifications
backend/src/main/java/com/medistock/controller/NotificationController.java - Feedback handling
backend/src/main/java/com/medistock/controller/FeedbackController.java - Expiry and stock alerts
backend/src/main/java/com/medistock/scheduler/ExpiryMonitoringScheduler.java
Other components
- Platform users
Connections 30
- Platform users → React application: uses
frontend/src/App.jsx - React application → Role-based routes: renders
frontend/src/App.jsx - React application → Auth context: provides context
frontend/src/App.jsx - React application → Notification context: provides context
frontend/src/App.jsx - Role-based routes → Auth context: checks identity
frontend/src/routes/AppRoutes.jsx - Role-based routes → Procurement screens: routes to
frontend/src/routes/AppRoutes.jsx - Auth context → Auth client: uses
frontend/src/context/AuthContext.jsx - Notification context → API clients: fetches notifications
frontend/src/context/NotificationContext.jsx - Auth client → API clients: uses
frontend/src/services/authService.js - Order client → API clients: uses
frontend/src/services/purchaseOrderService.js - Auth endpoints → Authentication: delegates to
- Authentication → User records: authenticates users
backend/src/main/java/com/medistock/service/impl/AuthServiceImpl.java - Medicine inventory → Medicine batches: manages batches
backend/src/main/java/com/medistock/controller/MedicineController.java - Purchase orders → Order lifecycle: delegates to
backend/src/main/java/com/medistock/controller/PurchaseOrderController.java - Purchase orders → Supplier governance: checks supplier
backend/src/main/java/com/medistock/controller/PurchaseOrderController.java - Supplier governance → Order lifecycle: manages supplier orders
backend/src/main/java/com/medistock/controller/SupplierController.java - Supplier governance → Supplier records: manages suppliers
backend/src/main/java/com/medistock/controller/SupplierController.java - Procurement screens → Order client: loads and updates orders
- Platform users → Medicine inventory: manages inventory
- Platform users → Stock movements: records movements
- Platform users → FEFO guidance: checks batches
- Platform users → Wastage review: reports wastage
- Platform users → Supplier governance: governs suppliers
- Platform users → Dashboards: views status
- Platform users → Reports and exports: exports reports
- Platform users → Audit trail: reviews activity
- Platform users → Backup recovery: manages backups
- Platform users → Notifications: views alerts
- Platform users → Feedback handling: submits feedback
- Expiry and stock alerts → Platform users: alerts users