# springboardmentor93924a-prog/medical-platform architecture

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

- Interactive diagram: https://gitdiagram.com/springboardmentor93924a-prog/medical-platform
- Repository: https://github.com/springboardmentor93924a-prog/medical-platform

## Overview

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: [`frontend/src/App.jsx`](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/App.jsx) (React application), [`backend/src/main/java/com/medistock/controller/SupplierController.java`](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/SupplierController.java) (Supplier governance), [`frontend/src/routes/AppRoutes.jsx`](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/routes/AppRoutes.jsx) (Role-based routes), [`frontend/src/context/AuthContext.jsx`](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/context/AuthContext.jsx) (Auth context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["React application<br/>[App.jsx]"]
  node_routes["Role-based routes<br/>[AppRoutes.jsx]"]
  node_authui["Auth context<br/>[AuthContext.jsx]"]
  node_notifyui["Notification context"]
  node_apis["API clients<br/>[api.js]"]
  node_authsvcui["Auth client<br/>[authService.js]"]
  node_posvcui["Order client"]
  node_procurementui["Procurement screens"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication"]
  node_authcontroller["Auth endpoints"]
  node_userstore[("User records<br/>[User.java]")]
end

subgraph group_operations["Inventory operations"]
  node_inventory["Medicine inventory"]
  node_medicine[("Medicine batches<br/>[Medicine.java]")]
  node_stock["Stock movements"]
  node_fefo["FEFO guidance<br/>[FefoService.java]"]
  node_wastage["Wastage review"]
end

subgraph group_procurement["Supplier procurement"]
  node_orders["Purchase orders"]
  node_orderlogic["Order lifecycle"]
  node_supplier["Supplier governance"]
  node_supplierdata[("Supplier records<br/>[Supplier.java]")]
end

subgraph group_oversight["Administration and insight"]
  node_dashboard["Dashboards"]
  node_reports["Reports and exports"]
  node_audit["Audit trail"]
  node_backup["Backup recovery"]
  node_notifications["Notifications"]
  node_feedback["Feedback handling"]
  node_monitoring["Expiry and stock alerts"]
end

node_user(("Platform users"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_routes
node_app -->|"provides context"| node_authui
node_app -->|"provides context"| node_notifyui
node_routes -->|"checks identity"| node_authui
node_routes -->|"routes to"| node_procurementui
node_authui -.->|"uses"| node_authsvcui
node_notifyui -->|"fetches notifications"| node_apis
node_authsvcui -->|"uses"| node_apis
node_posvcui -->|"uses"| node_apis
node_authcontroller -.->|"delegates to"| node_auth
node_auth -.->|"authenticates users"| node_userstore
node_inventory -->|"manages batches"| node_medicine
node_orders -->|"delegates to"| node_orderlogic
node_orders -->|"checks supplier"| node_supplier
node_supplier -->|"manages supplier orders"| node_orderlogic
node_supplier -.->|"manages suppliers"| node_supplierdata
node_procurementui -.->|"loads and updates orders"| node_posvcui
node_user -.->|"manages inventory"| node_inventory
node_user -.->|"records movements"| node_stock
node_user -.->|"checks batches"| node_fefo
node_user -.->|"reports wastage"| node_wastage
node_user -.->|"governs suppliers"| node_supplier
node_user -.->|"views status"| node_dashboard
node_user -.->|"exports reports"| node_reports
node_user -.->|"reviews activity"| node_audit
node_user -.->|"manages backups"| node_backup
node_user -.->|"views alerts"| node_notifications
node_user -.->|"submits feedback"| node_feedback
node_monitoring -.->|"alerts users"| node_user

click node_app "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/App.jsx"
click node_routes "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/routes/AppRoutes.jsx"
click node_authui "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/context/AuthContext.jsx"
click node_notifyui "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/context/NotificationContext.jsx"
click node_apis "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/services/api.js"
click node_authsvcui "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/services/authService.js"
click node_posvcui "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/services/purchaseOrderService.js"
click node_auth "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/service/impl/AuthServiceImpl.java"
click node_authcontroller "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/AuthController.java"
click node_userstore "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/entity/User.java"
click node_inventory "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/MedicineController.java"
click node_medicine "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/entity/Medicine.java"
click node_stock "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/StockMovementController.java"
click node_fefo "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/service/FefoService.java"
click node_wastage "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/WastageController.java"
click node_procurementui "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/pages/purchase-orders/PurchaseOrdersPage.jsx"
click node_orders "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/PurchaseOrderController.java"
click node_orderlogic "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/service/PurchaseOrderService.java"
click node_supplier "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/SupplierController.java"
click node_supplierdata "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/entity/Supplier.java"
click node_dashboard "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/DashboardController.java"
click node_reports "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/ReportController.java"
click node_audit "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/service/AuditLogService.java"
click node_backup "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/BackupController.java"
click node_notifications "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/NotificationController.java"
click node_feedback "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/FeedbackController.java"
click node_monitoring "https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/scheduler/ExpiryMonitoringScheduler.java"

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_app,node_routes,node_authui,node_notifyui,node_apis,node_authsvcui,node_posvcui,node_procurementui,node_user toneBlue
class node_auth,node_authcontroller,node_userstore toneAmber
class node_inventory,node_medicine,node_stock,node_fefo,node_wastage toneMint
class node_orders,node_orderlogic,node_supplier,node_supplierdata toneRose
class node_dashboard,node_reports,node_audit,node_backup,node_notifications,node_feedback,node_monitoring toneIndigo
```

## Components

### Web application

- [React application](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Role-based routes](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/routes/AppRoutes.jsx): `frontend/src/routes/AppRoutes.jsx`
- [Auth context](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Notification context](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/context/NotificationContext.jsx): `frontend/src/context/NotificationContext.jsx`
- [API clients](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Auth client](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/services/authService.js): `frontend/src/services/authService.js`
- [Order client](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/services/purchaseOrderService.js): `frontend/src/services/purchaseOrderService.js`
- [Procurement screens](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/frontend/src/pages/purchase-orders/PurchaseOrdersPage.jsx): `frontend/src/pages/purchase-orders/PurchaseOrdersPage.jsx`

### Identity and access

- [Authentication](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/service/impl/AuthServiceImpl.java): `backend/src/main/java/com/medistock/service/impl/AuthServiceImpl.java`
- [Auth endpoints](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/AuthController.java): `backend/src/main/java/com/medistock/controller/AuthController.java`
- [User records](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/entity/User.java): `backend/src/main/java/com/medistock/entity/User.java`

### Inventory operations

- [Medicine inventory](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/MedicineController.java): `backend/src/main/java/com/medistock/controller/MedicineController.java`
- [Medicine batches](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/entity/Medicine.java): `backend/src/main/java/com/medistock/entity/Medicine.java`
- [Stock movements](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/StockMovementController.java): `backend/src/main/java/com/medistock/controller/StockMovementController.java`
- [FEFO guidance](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/service/FefoService.java): `backend/src/main/java/com/medistock/service/FefoService.java`
- [Wastage review](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/WastageController.java): `backend/src/main/java/com/medistock/controller/WastageController.java`

### Supplier procurement

- [Purchase orders](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/PurchaseOrderController.java): `backend/src/main/java/com/medistock/controller/PurchaseOrderController.java`
- [Order lifecycle](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/service/PurchaseOrderService.java): `backend/src/main/java/com/medistock/service/PurchaseOrderService.java`
- [Supplier governance](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/SupplierController.java): `backend/src/main/java/com/medistock/controller/SupplierController.java`
- [Supplier records](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/entity/Supplier.java): `backend/src/main/java/com/medistock/entity/Supplier.java`

### Administration and insight

- [Dashboards](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/DashboardController.java): `backend/src/main/java/com/medistock/controller/DashboardController.java`
- [Reports and exports](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/ReportController.java): `backend/src/main/java/com/medistock/controller/ReportController.java`
- [Audit trail](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/service/AuditLogService.java): `backend/src/main/java/com/medistock/service/AuditLogService.java`
- [Backup recovery](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/BackupController.java): `backend/src/main/java/com/medistock/controller/BackupController.java`
- [Notifications](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/NotificationController.java): `backend/src/main/java/com/medistock/controller/NotificationController.java`
- [Feedback handling](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/controller/FeedbackController.java): `backend/src/main/java/com/medistock/controller/FeedbackController.java`
- [Expiry and stock alerts](https://github.com/springboardmentor93924a-prog/medical-platform/blob/main/backend/src/main/java/com/medistock/scheduler/ExpiryMonitoringScheduler.java): `backend/src/main/java/com/medistock/scheduler/ExpiryMonitoringScheduler.java`

### Other components

- **Platform users**

## Connections

- Platform users → React application: uses (evidence: `frontend/src/App.jsx`)
- React application → Role-based routes: renders (evidence: `frontend/src/App.jsx`)
- React application → Auth context: provides context (evidence: `frontend/src/App.jsx`)
- React application → Notification context: provides context (evidence: `frontend/src/App.jsx`)
- Role-based routes → Auth context: checks identity (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routes → Procurement screens: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Auth context → Auth client: uses (evidence: `frontend/src/context/AuthContext.jsx`)
- Notification context → API clients: fetches notifications (evidence: `frontend/src/context/NotificationContext.jsx`)
- Auth client → API clients: uses (evidence: `frontend/src/services/authService.js`)
- Order client → API clients: uses (evidence: `frontend/src/services/purchaseOrderService.js`)
- Auth endpoints → Authentication: delegates to
- Authentication → User records: authenticates users (evidence: `backend/src/main/java/com/medistock/service/impl/AuthServiceImpl.java`)
- Medicine inventory → Medicine batches: manages batches (evidence: `backend/src/main/java/com/medistock/controller/MedicineController.java`)
- Purchase orders → Order lifecycle: delegates to (evidence: `backend/src/main/java/com/medistock/controller/PurchaseOrderController.java`)
- Purchase orders → Supplier governance: checks supplier (evidence: `backend/src/main/java/com/medistock/controller/PurchaseOrderController.java`)
- Supplier governance → Order lifecycle: manages supplier orders (evidence: `backend/src/main/java/com/medistock/controller/SupplierController.java`)
- Supplier governance → Supplier records: manages suppliers (evidence: `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
