# ravimahto69/medicalstore architecture

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

- Interactive diagram: https://gitdiagram.com/ravimahto69/medicalstore
- Repository: https://github.com/ravimahto69/medicalstore

## Overview

Medical Store is a pharmacy operations system with a React web app, Express API, and MySQL persistence. Staff authenticate, enter the role-permitted workspace, and perform pharmacy workflows such as purchasing stock, billing sales, managing customers and returns, and reviewing reports. The API routes requests through controllers into services and models; the sampled services show transactional sales-return handling and database-backed purchasing. The README documents additional product capabilities whose detailed wiring was not sampled, so those branches are shown without asserted call paths.

Main entry points: [`Frontend/src/App.jsx`](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/App.jsx) (Workspace shell), [`Backend/config/db.js`](https://github.com/ravimahto69/medicalstore/blob/main/Backend/config/db.js) (MySQL database), [`Backend/config/routes.js`](https://github.com/ravimahto69/medicalstore/blob/main/Backend/config/routes.js) (Route registry), [`Backend/middleware/auth.middleware.js`](https://github.com/ravimahto69/medicalstore/blob/main/Backend/middleware/auth.middleware.js) (Request protection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Workspace shell<br/>[App.jsx]"]
  node_login["Authentication view<br/>[LoginView.jsx]"]
  node_pos["POS billing<br/>[POSBillingView.jsx]"]
  node_catalogui["Medicine catalog<br/>[MedicinesView.jsx]"]
  node_inventoryui["Inventory view<br/>[InventoryView.jsx]"]
  node_purchaseui["Purchasing view<br/>[PurchasesView.jsx]"]
  node_customerui["Customer accounts<br/>[CustomersView.jsx]"]
  node_supplierui["Supplier view<br/>[SuppliersView.jsx]"]
  node_expenseui["Expense tracking<br/>[ExpensesView.jsx]"]
  node_reportsui["Financial reports<br/>[ReportsView.jsx]"]
  node_dashboardui["Dashboard<br/>[DashboardView.jsx]"]
  node_settingsui["Store settings<br/>[SettingsView.jsx]"]
  node_notificationsui["Notifications view"]
end

subgraph group_api["API and access"]
  node_api["Express API<br/>[app.js]"]
  node_routes["Route registry<br/>[routes.js]"]
  node_auth["JWT authentication<br/>[auth.service.js]"]
  node_authmw["Request protection<br/>[auth.middleware.js]"]
  node_db[("MySQL database<br/>[db.js]")]
end

subgraph group_commerce["Pharmacy operations"]
  node_batchroutes["Batch routes<br/>[batch.routes.js]"]
  node_batchcontroller["Batch controller"]
  node_inventoryroutes["Inventory routes"]
  node_purchasing["Purchase service"]
  node_purchasemodel["Purchase model<br/>[purchase.model.js]"]
  node_returns["Sales return service"]
  node_returnmodel["Sales return model"]
  node_inventorymodel["Inventory model<br/>[inventory.model.js]"]
end

subgraph group_insight["Monitoring and finance"]
  node_expenseroutes["Expense routes<br/>[expense.routes.js]"]
  node_expensecontroller["Expense controller"]
  node_notificationcontroller["Notification controller"]
  node_notifyservice["Notification service"]
  node_expense["Expense service<br/>[expense.service.js]"]
end

node_staff(("Store staff"))

node_staff -.->|"uses"| node_app
node_app -->|"renders"| node_login
node_app -->|"selects view"| node_pos
node_app -->|"selects view"| node_catalogui
node_app -->|"selects view"| node_inventoryui
node_app -->|"selects view"| node_purchaseui
node_app -->|"selects view"| node_customerui
node_app -->|"selects view"| node_supplierui
node_app -->|"selects view"| node_expenseui
node_app -->|"selects view"| node_reportsui
node_app -->|"selects view"| node_dashboardui
node_app -->|"selects view"| node_settingsui
node_app -->|"selects view"| node_notificationsui
node_app -.->|"sends API requests"| node_api
node_api -->|"loads routes"| node_routes
node_routes -->|"registers endpoints"| node_batchroutes
node_batchroutes -->|"protects routes"| node_authmw
node_batchroutes -->|"dispatches"| node_batchcontroller
node_routes -->|"registers endpoints"| node_inventoryroutes
node_inventoryroutes -->|"protects routes"| node_authmw
node_routes -->|"registers endpoints"| node_expenseroutes
node_expenseroutes -->|"protects routes"| node_authmw
node_expenseroutes -->|"dispatches"| node_expensecontroller
node_notificationcontroller -->|"calls"| node_notifyservice
node_expensecontroller -->|"calls"| node_expense
node_authmw -.->|"loads user"| node_db
node_auth -.->|"reads and writes users"| node_db
node_purchasing -->|"uses model"| node_purchasemodel
node_purchasing -->|"queries database"| node_db
node_returns -->|"calls model"| node_returnmodel
node_returns -->|"manages transactions"| node_db
node_inventorymodel -->|"queries database"| node_db

click node_app "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/App.jsx"
click node_login "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/auth/LoginView.jsx"
click node_pos "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/pos/POSBillingView.jsx"
click node_catalogui "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/medicines/MedicinesView.jsx"
click node_inventoryui "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/inventory/InventoryView.jsx"
click node_purchaseui "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/purchases/PurchasesView.jsx"
click node_customerui "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/customers/CustomersView.jsx"
click node_supplierui "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/suppliers/SuppliersView.jsx"
click node_expenseui "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/expenses/ExpensesView.jsx"
click node_reportsui "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/reports/ReportsView.jsx"
click node_dashboardui "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/dashboard/DashboardView.jsx"
click node_settingsui "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/settings/SettingsView.jsx"
click node_notificationsui "https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/notifications/NotificationsView.jsx"
click node_api "https://github.com/ravimahto69/medicalstore/blob/main/Backend/app.js"
click node_routes "https://github.com/ravimahto69/medicalstore/blob/main/Backend/config/routes.js"
click node_auth "https://github.com/ravimahto69/medicalstore/blob/main/Backend/services/auth.service.js"
click node_authmw "https://github.com/ravimahto69/medicalstore/blob/main/Backend/middleware/auth.middleware.js"
click node_batchroutes "https://github.com/ravimahto69/medicalstore/blob/main/Backend/routes/batch.routes.js"
click node_batchcontroller "https://github.com/ravimahto69/medicalstore/blob/main/Backend/controller/batch.controller.js"
click node_inventoryroutes "https://github.com/ravimahto69/medicalstore/blob/main/Backend/routes/inventory.routes.js"
click node_expenseroutes "https://github.com/ravimahto69/medicalstore/blob/main/Backend/routes/expense.routes.js"
click node_expensecontroller "https://github.com/ravimahto69/medicalstore/blob/main/Backend/controller/expense.controller.js"
click node_notificationcontroller "https://github.com/ravimahto69/medicalstore/blob/main/Backend/controller/notification.controller.js"
click node_purchasing "https://github.com/ravimahto69/medicalstore/blob/main/Backend/services/purchase.service.js"
click node_purchasemodel "https://github.com/ravimahto69/medicalstore/blob/main/Backend/models/purchase.model.js"
click node_returns "https://github.com/ravimahto69/medicalstore/blob/main/Backend/services/salesReturn.service.js"
click node_returnmodel "https://github.com/ravimahto69/medicalstore/blob/main/Backend/models/salesReturn.model.js"
click node_inventorymodel "https://github.com/ravimahto69/medicalstore/blob/main/Backend/models/inventory.model.js"
click node_db "https://github.com/ravimahto69/medicalstore/blob/main/Backend/config/db.js"
click node_notifyservice "https://github.com/ravimahto69/medicalstore/blob/main/Backend/services/notification.service.js"
click node_expense "https://github.com/ravimahto69/medicalstore/blob/main/Backend/services/expense.service.js"

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_login,node_pos,node_catalogui,node_inventoryui,node_purchaseui,node_customerui,node_supplierui,node_expenseui,node_reportsui,node_dashboardui,node_settingsui,node_notificationsui toneBlue
class node_api,node_routes,node_auth,node_authmw,node_db toneAmber
class node_batchroutes,node_batchcontroller,node_inventoryroutes,node_purchasing,node_purchasemodel,node_returns,node_returnmodel,node_inventorymodel toneMint
class node_expenseroutes,node_expensecontroller,node_notificationcontroller,node_notifyservice,node_expense toneRose
class node_staff toneIndigo
```

## Components

### Web application

- [Workspace shell](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Authentication view](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/auth/LoginView.jsx): `Frontend/src/features/auth/LoginView.jsx`
- [POS billing](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/pos/POSBillingView.jsx): `Frontend/src/features/pos/POSBillingView.jsx`
- [Medicine catalog](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/medicines/MedicinesView.jsx): `Frontend/src/features/medicines/MedicinesView.jsx`
- [Inventory view](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/inventory/InventoryView.jsx): `Frontend/src/features/inventory/InventoryView.jsx`
- [Purchasing view](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/purchases/PurchasesView.jsx): `Frontend/src/features/purchases/PurchasesView.jsx`
- [Customer accounts](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/customers/CustomersView.jsx): `Frontend/src/features/customers/CustomersView.jsx`
- [Supplier view](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/suppliers/SuppliersView.jsx): `Frontend/src/features/suppliers/SuppliersView.jsx`
- [Expense tracking](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/expenses/ExpensesView.jsx): `Frontend/src/features/expenses/ExpensesView.jsx`
- [Financial reports](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/reports/ReportsView.jsx): `Frontend/src/features/reports/ReportsView.jsx`
- [Dashboard](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/dashboard/DashboardView.jsx): `Frontend/src/features/dashboard/DashboardView.jsx`
- [Store settings](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/settings/SettingsView.jsx): `Frontend/src/features/settings/SettingsView.jsx`
- [Notifications view](https://github.com/ravimahto69/medicalstore/blob/main/Frontend/src/features/notifications/NotificationsView.jsx): `Frontend/src/features/notifications/NotificationsView.jsx`

### API and access

- [Express API](https://github.com/ravimahto69/medicalstore/blob/main/Backend/app.js): `Backend/app.js`
- [Route registry](https://github.com/ravimahto69/medicalstore/blob/main/Backend/config/routes.js): `Backend/config/routes.js`
- [JWT authentication](https://github.com/ravimahto69/medicalstore/blob/main/Backend/services/auth.service.js): `Backend/services/auth.service.js`
- [Request protection](https://github.com/ravimahto69/medicalstore/blob/main/Backend/middleware/auth.middleware.js): `Backend/middleware/auth.middleware.js`
- [MySQL database](https://github.com/ravimahto69/medicalstore/blob/main/Backend/config/db.js): `Backend/config/db.js`

### Pharmacy operations

- [Batch routes](https://github.com/ravimahto69/medicalstore/blob/main/Backend/routes/batch.routes.js): `Backend/routes/batch.routes.js`
- [Batch controller](https://github.com/ravimahto69/medicalstore/blob/main/Backend/controller/batch.controller.js): `Backend/controller/batch.controller.js`
- [Inventory routes](https://github.com/ravimahto69/medicalstore/blob/main/Backend/routes/inventory.routes.js): `Backend/routes/inventory.routes.js`
- [Purchase service](https://github.com/ravimahto69/medicalstore/blob/main/Backend/services/purchase.service.js): `Backend/services/purchase.service.js`
- [Purchase model](https://github.com/ravimahto69/medicalstore/blob/main/Backend/models/purchase.model.js): `Backend/models/purchase.model.js`
- [Sales return service](https://github.com/ravimahto69/medicalstore/blob/main/Backend/services/salesReturn.service.js): `Backend/services/salesReturn.service.js`
- [Sales return model](https://github.com/ravimahto69/medicalstore/blob/main/Backend/models/salesReturn.model.js): `Backend/models/salesReturn.model.js`
- [Inventory model](https://github.com/ravimahto69/medicalstore/blob/main/Backend/models/inventory.model.js): `Backend/models/inventory.model.js`

### Monitoring and finance

- [Expense routes](https://github.com/ravimahto69/medicalstore/blob/main/Backend/routes/expense.routes.js): `Backend/routes/expense.routes.js`
- [Expense controller](https://github.com/ravimahto69/medicalstore/blob/main/Backend/controller/expense.controller.js): `Backend/controller/expense.controller.js`
- [Notification controller](https://github.com/ravimahto69/medicalstore/blob/main/Backend/controller/notification.controller.js): `Backend/controller/notification.controller.js`
- [Notification service](https://github.com/ravimahto69/medicalstore/blob/main/Backend/services/notification.service.js): `Backend/services/notification.service.js`
- [Expense service](https://github.com/ravimahto69/medicalstore/blob/main/Backend/services/expense.service.js): `Backend/services/expense.service.js`

### Other components

- **Store staff**

## Connections

- Store staff → Workspace shell: uses
- Workspace shell → Authentication view: renders (evidence: `Frontend/src/App.jsx`)
- Workspace shell → POS billing: selects view (evidence: `Frontend/src/App.jsx`)
- Workspace shell → Medicine catalog: selects view (evidence: `Frontend/src/App.jsx`)
- Workspace shell → Inventory view: selects view (evidence: `Frontend/src/App.jsx`)
- Workspace shell → Purchasing view: selects view (evidence: `Frontend/src/App.jsx`)
- Workspace shell → Customer accounts: selects view (evidence: `Frontend/src/App.jsx`)
- Workspace shell → Supplier view: selects view (evidence: `Frontend/src/App.jsx`)
- Workspace shell → Expense tracking: selects view (evidence: `Frontend/src/App.jsx`)
- Workspace shell → Financial reports: selects view (evidence: `Frontend/src/App.jsx`)
- Workspace shell → Dashboard: selects view (evidence: `Frontend/src/App.jsx`)
- Workspace shell → Store settings: selects view (evidence: `Frontend/src/App.jsx`)
- Workspace shell → Notifications view: selects view (evidence: `Frontend/src/App.jsx`)
- Workspace shell → Express API: sends API requests
- Express API → Route registry: loads routes (evidence: `Backend/app.js`)
- Route registry → Batch routes: registers endpoints (evidence: `Backend/config/routes.js`)
- Batch routes → Request protection: protects routes (evidence: `Backend/routes/batch.routes.js`)
- Batch routes → Batch controller: dispatches (evidence: `Backend/routes/batch.routes.js`)
- Route registry → Inventory routes: registers endpoints (evidence: `Backend/config/routes.js`)
- Inventory routes → Request protection: protects routes (evidence: `Backend/routes/inventory.routes.js`)
- Route registry → Expense routes: registers endpoints (evidence: `Backend/config/routes.js`)
- Expense routes → Request protection: protects routes (evidence: `Backend/routes/expense.routes.js`)
- Expense routes → Expense controller: dispatches (evidence: `Backend/routes/expense.routes.js`)
- Notification controller → Notification service: calls (evidence: `Backend/controller/notification.controller.js`)
- Expense controller → Expense service: calls (evidence: `Backend/controller/expense.controller.js`)
- Request protection → MySQL database: loads user
- JWT authentication → MySQL database: reads and writes users
- Purchase service → Purchase model: uses model (evidence: `Backend/services/purchase.service.js`)
- Purchase service → MySQL database: queries database (evidence: `Backend/services/purchase.service.js`)
- Sales return service → Sales return model: calls model (evidence: `Backend/services/salesReturn.service.js`)
- Sales return service → MySQL database: manages transactions (evidence: `Backend/services/salesReturn.service.js`)
- Inventory model → MySQL database: queries database (evidence: `Backend/models/inventory.model.js`)
