# zluck4270/web_full_stack architecture

> Architecture diagram of the GitHub repository zluck4270/web_full_stack, 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/zluck4270/web_full_stack
- Repository: https://github.com/zluck4270/web_full_stack

## Overview

Botica Nova Salud is a pharmacy ERP/POS: staff authenticate, enter role-authorized modules, and use them to process sales, inventory, purchasing, cash, customers and oversight. The SPA routes users into these workflows; shared pharmacy state/API services communicate with the Express API, whose routes apply authentication and selected permission checks before controllers operate on the SQL adapter. The README documents FEFO, DCI substitutes, replenishment, alerts, audit, backups and staff access. Those capabilities are retained, but their exact internal call chains are not asserted where source excerpts do not show them.

Main entry points: [`src/App.tsx`](https://github.com/zluck4270/web_full_stack/blob/main/src/App.tsx) (Module navigation), [`backend/server.js`](https://github.com/zluck4270/web_full_stack/blob/main/backend/server.js) (REST API), [`src/context/PharmacyContext.tsx`](https://github.com/zluck4270/web_full_stack/blob/main/src/context/PharmacyContext.tsx) (Shared pharmacy state), [`backend/src/middleware/authMiddleware.js`](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/middleware/authMiddleware.js) (JWT authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Pharmacy interface"]
  node_app["Module navigation<br/>[App.tsx]"]
  node_login["Sign in<br/>[LoginView.tsx]"]
  node_sharedstate["Shared pharmacy state"]
  node_api_client["API client<br/>[pharmacyApi.js]"]
  node_i18n["Language context<br/>[I18nContext.tsx]"]
end

subgraph group_api["API and access"]
  node_api_server["REST API<br/>[server.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_sales_routes["Sales routes<br/>[salesRoutes.js]"]
  node_inventory_routes["Inventory routes<br/>[inventoryRoutes.js]"]
  node_cash_routes["Cash routes<br/>[cashRoutes.js]"]
  node_purchases_routes["Purchases routes<br/>[purchasesRoutes.js]"]
  node_users_routes["Users routes<br/>[usersRoutes.js]"]
  node_auth_mw["JWT authentication<br/>[authMiddleware.js]"]
  node_rbac_mw["Permission checks<br/>[rbacMiddleware.js]"]
end

subgraph group_operations["Pharmacy operations"]
  node_dashboard["Dashboard<br/>[DashboardView.tsx]"]
  node_pos["Point of sale"]
  node_sales["Sales history"]
  node_inventory["Inventory and FEFO"]
  node_purchases["Purchasing<br/>[PurchasesView.tsx]"]
  node_cash["Cash shifts"]
  node_alerts["Alerts"]
  node_customers["Customer directory<br/>[CustomersView.tsx]"]
  node_users["Staff and RBAC"]
  node_audit_view["Audit log view<br/>[AuditView.tsx]"]
  node_inventory_ctrl["Inventory operations"]
  node_user_ctrl["User administration<br/>[usersController.js]"]
  node_fefo["FEFO dispatch<br/>[fefoService.js]"]
end

subgraph group_platform["Data and controls"]
  node_backup["Backup service<br/>[backupService.js]"]
  node_db_adapter[("SQL adapter<br/>[db.js]")]
end

node_staff(("Pharmacy staff"))

node_staff -->|"signs in"| node_login
node_app -->|"shows when signed out"| node_login
node_app -->|"provides state"| node_sharedstate
node_app -->|"provides language"| node_i18n
node_app -->|"renders module"| node_dashboard
node_app -->|"renders module"| node_pos
node_app -->|"renders module"| node_sales
node_app -->|"renders module"| node_inventory
node_app -->|"renders module"| node_cash
node_app -->|"renders module"| node_purchases
node_app -->|"renders module"| node_alerts
node_app -->|"renders module"| node_customers
node_app -->|"renders module"| node_users
node_app -->|"renders module"| node_audit_view
node_pos -->|"uses operations"| node_sharedstate
node_sales -->|"uses operations"| node_sharedstate
node_inventory -->|"uses operations"| node_sharedstate
node_purchases -->|"uses operations"| node_sharedstate
node_cash -->|"uses operations"| node_sharedstate
node_dashboard -->|"uses metrics"| node_sharedstate
node_audit_view -->|"uses data"| node_sharedstate
node_users -->|"calls user API"| node_api_client
node_sharedstate -->|"calls endpoints"| node_api_client
node_api_client -.->|"requests API"| node_api_server
node_api_server -->|"mounts routes"| node_auth_routes
node_api_server -->|"mounts routes"| node_sales_routes
node_api_server -->|"mounts routes"| node_inventory_routes
node_api_server -->|"mounts routes"| node_cash_routes
node_api_server -->|"mounts routes"| node_purchases_routes
node_api_server -->|"mounts routes"| node_users_routes
node_inventory_routes -->|"authenticates requests"| node_auth_mw
node_inventory_routes -->|"checks permissions"| node_rbac_mw
node_inventory_routes -->|"dispatches handlers"| node_inventory_ctrl
node_users_routes -->|"authenticates requests"| node_auth_mw
node_users_routes -->|"dispatches handlers"| node_user_ctrl
node_rbac_mw -->|"reads permissions"| node_db_adapter
node_inventory_ctrl -->|"queries inventory"| node_db_adapter
node_user_ctrl -->|"queries user records"| node_db_adapter
node_inventory_ctrl -.->|"FEFO integration"| node_fefo
node_purchases_routes -->|"authenticates requests"| node_auth_mw
node_purchases_routes -->|"checks permissions"| node_rbac_mw
node_cash_routes -->|"authenticates requests"| node_auth_mw
node_cash_routes -->|"checks permissions"| node_rbac_mw
node_auth_routes -.->|"token middleware"| node_auth_mw
node_api_server -.->|"backup capability"| node_backup

click node_app "https://github.com/zluck4270/web_full_stack/blob/main/src/App.tsx"
click node_login "https://github.com/zluck4270/web_full_stack/blob/main/src/components/auth/LoginView.tsx"
click node_sharedstate "https://github.com/zluck4270/web_full_stack/blob/main/src/context/PharmacyContext.tsx"
click node_api_client "https://github.com/zluck4270/web_full_stack/blob/main/src/services/pharmacyApi.js"
click node_dashboard "https://github.com/zluck4270/web_full_stack/blob/main/src/components/dashboard/DashboardView.tsx"
click node_pos "https://github.com/zluck4270/web_full_stack/blob/main/src/components/pos/PointOfSaleView.tsx"
click node_sales "https://github.com/zluck4270/web_full_stack/blob/main/src/components/sales/SalesHistoryView.tsx"
click node_inventory "https://github.com/zluck4270/web_full_stack/blob/main/src/components/inventory/InventoryBatchesView.tsx"
click node_purchases "https://github.com/zluck4270/web_full_stack/blob/main/src/components/purchases/PurchasesView.tsx"
click node_cash "https://github.com/zluck4270/web_full_stack/blob/main/src/components/cash/CashRegisterView.tsx"
click node_alerts "https://github.com/zluck4270/web_full_stack/blob/main/src/components/alerts/ActiveAlertsView.tsx"
click node_customers "https://github.com/zluck4270/web_full_stack/blob/main/src/components/customers/CustomersView.tsx"
click node_users "https://github.com/zluck4270/web_full_stack/blob/main/src/components/users/UsersManagementView.tsx"
click node_audit_view "https://github.com/zluck4270/web_full_stack/blob/main/src/components/audit/AuditView.tsx"
click node_api_server "https://github.com/zluck4270/web_full_stack/blob/main/backend/server.js"
click node_auth_routes "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/routes/authRoutes.js"
click node_sales_routes "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/routes/salesRoutes.js"
click node_inventory_routes "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/routes/inventoryRoutes.js"
click node_cash_routes "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/routes/cashRoutes.js"
click node_purchases_routes "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/routes/purchasesRoutes.js"
click node_users_routes "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/routes/usersRoutes.js"
click node_auth_mw "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/middleware/authMiddleware.js"
click node_rbac_mw "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/middleware/rbacMiddleware.js"
click node_inventory_ctrl "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/controllers/inventoryController.js"
click node_user_ctrl "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/controllers/usersController.js"
click node_fefo "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/services/fefoService.js"
click node_backup "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/services/backupService.js"
click node_db_adapter "https://github.com/zluck4270/web_full_stack/blob/main/backend/src/config/db.js"
click node_i18n "https://github.com/zluck4270/web_full_stack/blob/main/src/i18n/I18nContext.tsx"

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_sharedstate,node_api_client,node_i18n toneBlue
class node_api_server,node_auth_routes,node_sales_routes,node_inventory_routes,node_cash_routes,node_purchases_routes,node_users_routes,node_auth_mw,node_rbac_mw toneAmber
class node_dashboard,node_pos,node_sales,node_inventory,node_purchases,node_cash,node_alerts,node_customers,node_users,node_audit_view,node_inventory_ctrl,node_user_ctrl,node_fefo toneMint
class node_backup,node_db_adapter toneRose
class node_staff toneIndigo
```

## Components

### Pharmacy interface

- [Module navigation](https://github.com/zluck4270/web_full_stack/blob/main/src/App.tsx): `src/App.tsx`
- [Sign in](https://github.com/zluck4270/web_full_stack/blob/main/src/components/auth/LoginView.tsx): `src/components/auth/LoginView.tsx`
- [Shared pharmacy state](https://github.com/zluck4270/web_full_stack/blob/main/src/context/PharmacyContext.tsx): `src/context/PharmacyContext.tsx`
- [API client](https://github.com/zluck4270/web_full_stack/blob/main/src/services/pharmacyApi.js): `src/services/pharmacyApi.js`
- [Language context](https://github.com/zluck4270/web_full_stack/blob/main/src/i18n/I18nContext.tsx): `src/i18n/I18nContext.tsx`

### API and access

- [REST API](https://github.com/zluck4270/web_full_stack/blob/main/backend/server.js): `backend/server.js`
- [Authentication routes](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Sales routes](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/routes/salesRoutes.js): `backend/src/routes/salesRoutes.js`
- [Inventory routes](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/routes/inventoryRoutes.js): `backend/src/routes/inventoryRoutes.js`
- [Cash routes](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/routes/cashRoutes.js): `backend/src/routes/cashRoutes.js`
- [Purchases routes](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/routes/purchasesRoutes.js): `backend/src/routes/purchasesRoutes.js`
- [Users routes](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/routes/usersRoutes.js): `backend/src/routes/usersRoutes.js`
- [JWT authentication](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/middleware/authMiddleware.js): `backend/src/middleware/authMiddleware.js`
- [Permission checks](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/middleware/rbacMiddleware.js): `backend/src/middleware/rbacMiddleware.js`

### Pharmacy operations

- [Dashboard](https://github.com/zluck4270/web_full_stack/blob/main/src/components/dashboard/DashboardView.tsx): `src/components/dashboard/DashboardView.tsx`
- [Point of sale](https://github.com/zluck4270/web_full_stack/blob/main/src/components/pos/PointOfSaleView.tsx): `src/components/pos/PointOfSaleView.tsx`
- [Sales history](https://github.com/zluck4270/web_full_stack/blob/main/src/components/sales/SalesHistoryView.tsx): `src/components/sales/SalesHistoryView.tsx`
- [Inventory and FEFO](https://github.com/zluck4270/web_full_stack/blob/main/src/components/inventory/InventoryBatchesView.tsx): `src/components/inventory/InventoryBatchesView.tsx`
- [Purchasing](https://github.com/zluck4270/web_full_stack/blob/main/src/components/purchases/PurchasesView.tsx): `src/components/purchases/PurchasesView.tsx`
- [Cash shifts](https://github.com/zluck4270/web_full_stack/blob/main/src/components/cash/CashRegisterView.tsx): `src/components/cash/CashRegisterView.tsx`
- [Alerts](https://github.com/zluck4270/web_full_stack/blob/main/src/components/alerts/ActiveAlertsView.tsx): `src/components/alerts/ActiveAlertsView.tsx`
- [Customer directory](https://github.com/zluck4270/web_full_stack/blob/main/src/components/customers/CustomersView.tsx): `src/components/customers/CustomersView.tsx`
- [Staff and RBAC](https://github.com/zluck4270/web_full_stack/blob/main/src/components/users/UsersManagementView.tsx): `src/components/users/UsersManagementView.tsx`
- [Audit log view](https://github.com/zluck4270/web_full_stack/blob/main/src/components/audit/AuditView.tsx): `src/components/audit/AuditView.tsx`
- [Inventory operations](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/controllers/inventoryController.js): `backend/src/controllers/inventoryController.js`
- [User administration](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/controllers/usersController.js): `backend/src/controllers/usersController.js`
- [FEFO dispatch](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/services/fefoService.js): `backend/src/services/fefoService.js`

### Data and controls

- [Backup service](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/services/backupService.js): `backend/src/services/backupService.js`
- [SQL adapter](https://github.com/zluck4270/web_full_stack/blob/main/backend/src/config/db.js): `backend/src/config/db.js`

### Other components

- **Pharmacy staff**

## Connections

- Pharmacy staff → Sign in: signs in
- Module navigation → Sign in: shows when signed out (evidence: `src/App.tsx`)
- Module navigation → Shared pharmacy state: provides state (evidence: `src/App.tsx`)
- Module navigation → Language context: provides language (evidence: `src/App.tsx`)
- Module navigation → Dashboard: renders module (evidence: `src/App.tsx`)
- Module navigation → Point of sale: renders module (evidence: `src/App.tsx`)
- Module navigation → Sales history: renders module (evidence: `src/App.tsx`)
- Module navigation → Inventory and FEFO: renders module (evidence: `src/App.tsx`)
- Module navigation → Cash shifts: renders module (evidence: `src/App.tsx`)
- Module navigation → Purchasing: renders module (evidence: `src/App.tsx`)
- Module navigation → Alerts: renders module (evidence: `src/App.tsx`)
- Module navigation → Customer directory: renders module (evidence: `src/App.tsx`)
- Module navigation → Staff and RBAC: renders module (evidence: `src/App.tsx`)
- Module navigation → Audit log view: renders module (evidence: `src/App.tsx`)
- Point of sale → Shared pharmacy state: uses operations (evidence: `src/components/pos/PointOfSaleView.tsx`)
- Sales history → Shared pharmacy state: uses operations (evidence: `src/components/sales/SalesHistoryView.tsx`)
- Inventory and FEFO → Shared pharmacy state: uses operations (evidence: `src/components/inventory/InventoryBatchesView.tsx`)
- Purchasing → Shared pharmacy state: uses operations (evidence: `src/components/purchases/PurchasesView.tsx`)
- Cash shifts → Shared pharmacy state: uses operations (evidence: `src/components/cash/CashRegisterView.tsx`)
- Dashboard → Shared pharmacy state: uses metrics (evidence: `src/components/dashboard/DashboardView.tsx`)
- Audit log view → Shared pharmacy state: uses data (evidence: `src/components/audit/AuditView.tsx`)
- Staff and RBAC → API client: calls user API (evidence: `src/components/users/UsersManagementView.tsx`)
- Shared pharmacy state → API client: calls endpoints (evidence: `src/context/PharmacyContext.tsx`)
- API client → REST API: requests API
- REST API → Authentication routes: mounts routes (evidence: `backend/server.js`)
- REST API → Sales routes: mounts routes (evidence: `backend/server.js`)
- REST API → Inventory routes: mounts routes (evidence: `backend/server.js`)
- REST API → Cash routes: mounts routes (evidence: `backend/server.js`)
- REST API → Purchases routes: mounts routes (evidence: `backend/server.js`)
- REST API → Users routes: mounts routes (evidence: `backend/server.js`)
- Inventory routes → JWT authentication: authenticates requests (evidence: `backend/src/routes/inventoryRoutes.js`)
- Inventory routes → Permission checks: checks permissions (evidence: `backend/src/routes/inventoryRoutes.js`)
- Inventory routes → Inventory operations: dispatches handlers (evidence: `backend/src/routes/inventoryRoutes.js`)
- Users routes → JWT authentication: authenticates requests (evidence: `backend/src/routes/usersRoutes.js`)
- Users routes → User administration: dispatches handlers (evidence: `backend/src/routes/usersRoutes.js`)
- Permission checks → SQL adapter: reads permissions (evidence: `backend/src/middleware/rbacMiddleware.js`)
- Inventory operations → SQL adapter: queries inventory (evidence: `backend/src/controllers/inventoryController.js`)
- User administration → SQL adapter: queries user records (evidence: `backend/src/controllers/usersController.js`)
- Inventory operations → FEFO dispatch: FEFO integration
- Purchases routes → JWT authentication: authenticates requests (evidence: `backend/src/routes/purchasesRoutes.js`)
- Purchases routes → Permission checks: checks permissions (evidence: `backend/src/routes/purchasesRoutes.js`)
- Cash routes → JWT authentication: authenticates requests (evidence: `backend/src/routes/cashRoutes.js`)
- Cash routes → Permission checks: checks permissions (evidence: `backend/src/routes/cashRoutes.js`)
- Authentication routes → JWT authentication: token middleware (evidence: `backend/src/routes/authRoutes.js`)
- REST API → Backup service: backup capability
