# shubhampal24/rack_management architecture

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

- Interactive diagram: https://gitdiagram.com/shubhampal24/rack_management
- Repository: https://github.com/shubhampal24/rack_management

## Overview

RackOS is a warehouse inventory and rack-management application. Users sign in, load warehouse data, and use the dashboard and operational screens to manage racks, locations, materials, stock movements, and reference information. The frontend store and API service mediate data access; the Express backend authenticates requests and implements the domain operations over MongoDB models. The excerpts show frontend routing and backend dispatch, but not the page-level data calls or complete client-to-server wiring, so those links are omitted or marked unverified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/App.jsx) (App routing and loader), [`backend/server.js`](https://github.com/shubhampal24/rack_management/blob/main/backend/server.js) (Express API server), [`backend/routes/racks.js`](https://github.com/shubhampal24/rack_management/blob/main/backend/routes/racks.js) (Rack operations), [`backend/routes/materials.js`](https://github.com/shubhampal24/rack_management/blob/main/backend/routes/materials.js) (Material operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Warehouse frontend"]
  node_app["App routing and loader<br/>[App.jsx]"]
  node_authctx["Frontend authentication<br/>[AuthContext.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_rackmap["Rack map<br/>[RackMap.jsx]"]
  node_inventory["Inventory<br/>[Inventory.jsx]"]
  node_movementpage["Stock movement<br/>[StockMovement.jsx]"]
  node_materials["Material master<br/>[MaterialMaster.jsx]"]
  node_locations["Location master<br/>[LocationMaster.jsx]"]
  node_rackmanager["Rack manager<br/>[RackManager.jsx]"]
  node_labels["Rack labels<br/>[RackLabels.jsx]"]
  node_reference["Reference data<br/>[Reference.jsx]"]
end

subgraph group_clientdata["Client data access"]
  node_store["Warehouse store"]
  node_apiservice["API services<br/>[apiService.js]"]
  node_apiclient["HTTP API client<br/>[apiClient.js]"]
end

subgraph group_backend["API and domain operations"]
  node_server["Express API server<br/>[server.js]"]
  node_authroutes["Authentication routes<br/>[auth.js]"]
  node_rackroutes["Rack operations<br/>[racks.js]"]
  node_materialroutes["Material operations<br/>[materials.js]"]
  node_locationroutes["Location operations<br/>[locations.js]"]
  node_movementroutes["Movement operations<br/>[movements.js]"]
  node_authmw["Token authorization<br/>[auth.js]"]
end

subgraph group_persistence["Warehouse persistence"]
  node_user_model[("User records<br/>[User.js]")]
  node_rack_model[("Rack records<br/>[Rack.js]")]
  node_location_model[("Location records<br/>[Location.js]")]
  node_material_model[("Material records<br/>[Material.js]")]
  node_movement_model[("Movement records<br/>[Movement.js]")]
end

node_user(("Warehouse user"))
node_mongo[("MongoDB")]

node_user -->|"uses"| node_app
node_app -->|"provides auth"| node_authctx
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_rackmap
node_app -->|"routes to"| node_inventory
node_app -->|"routes to"| node_movementpage
node_app -->|"routes to"| node_materials
node_app -->|"routes to"| node_locations
node_app -->|"routes to"| node_rackmanager
node_app -->|"routes to"| node_labels
node_app -->|"routes to"| node_reference
node_app -->|"loads data"| node_store
node_store -->|"calls"| node_apiservice
node_apiservice -->|"uses"| node_apiclient
node_apiclient -.->|"sends HTTP requests"| node_server
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_rackroutes
node_server -->|"mounts"| node_materialroutes
node_server -->|"mounts"| node_locationroutes
node_server -->|"mounts"| node_movementroutes
node_authroutes -->|"queries"| node_user_model
node_authroutes -->|"requires token"| node_authmw
node_rackroutes -->|"requires token"| node_authmw
node_rackroutes -->|"queries"| node_rack_model
node_rackroutes -->|"creates and updates"| node_location_model
node_rackroutes -->|"checks stock"| node_movement_model
node_materialroutes -->|"requires token"| node_authmw
node_materialroutes -->|"queries"| node_material_model
node_materialroutes -->|"uses"| node_location_model
node_materialroutes -->|"uses"| node_movement_model
node_locationroutes -->|"requires token"| node_authmw
node_locationroutes -->|"queries"| node_location_model
node_locationroutes -->|"uses"| node_movement_model
node_movementroutes -->|"requires token"| node_authmw
node_movementroutes -->|"queries"| node_movement_model
node_movementroutes -->|"uses"| node_location_model
node_server -->|"connects at startup"| node_mongo

click node_app "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/App.jsx"
click node_authctx "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/context/AuthContext.jsx"
click node_dashboard "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/Dashboard.jsx"
click node_rackmap "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/RackMap.jsx"
click node_inventory "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/Inventory.jsx"
click node_movementpage "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/StockMovement.jsx"
click node_materials "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/MaterialMaster.jsx"
click node_locations "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/LocationMaster.jsx"
click node_rackmanager "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/RackManager.jsx"
click node_labels "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/RackLabels.jsx"
click node_reference "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/Reference.jsx"
click node_store "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/lib/store/useWarehouseStore.js"
click node_apiservice "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/lib/api/apiService.js"
click node_apiclient "https://github.com/shubhampal24/rack_management/blob/main/frontend/src/lib/api/apiClient.js"
click node_server "https://github.com/shubhampal24/rack_management/blob/main/backend/server.js"
click node_authroutes "https://github.com/shubhampal24/rack_management/blob/main/backend/routes/auth.js"
click node_rackroutes "https://github.com/shubhampal24/rack_management/blob/main/backend/routes/racks.js"
click node_materialroutes "https://github.com/shubhampal24/rack_management/blob/main/backend/routes/materials.js"
click node_locationroutes "https://github.com/shubhampal24/rack_management/blob/main/backend/routes/locations.js"
click node_movementroutes "https://github.com/shubhampal24/rack_management/blob/main/backend/routes/movements.js"
click node_authmw "https://github.com/shubhampal24/rack_management/blob/main/backend/middleware/auth.js"
click node_user_model "https://github.com/shubhampal24/rack_management/blob/main/backend/models/User.js"
click node_rack_model "https://github.com/shubhampal24/rack_management/blob/main/backend/models/Rack.js"
click node_location_model "https://github.com/shubhampal24/rack_management/blob/main/backend/models/Location.js"
click node_material_model "https://github.com/shubhampal24/rack_management/blob/main/backend/models/Material.js"
click node_movement_model "https://github.com/shubhampal24/rack_management/blob/main/backend/models/Movement.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_authctx,node_dashboard,node_rackmap,node_inventory,node_movementpage,node_materials,node_locations,node_rackmanager,node_labels,node_reference,node_user toneBlue
class node_store,node_apiservice,node_apiclient,node_mongo toneAmber
class node_server,node_authroutes,node_rackroutes,node_materialroutes,node_locationroutes,node_movementroutes,node_authmw toneMint
class node_user_model,node_rack_model,node_location_model,node_material_model,node_movement_model toneRose
```

## Components

### Warehouse frontend

- [App routing and loader](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Frontend authentication](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Dashboard](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Rack map](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/RackMap.jsx): `frontend/src/pages/RackMap.jsx`
- [Inventory](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/Inventory.jsx): `frontend/src/pages/Inventory.jsx`
- [Stock movement](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/StockMovement.jsx): `frontend/src/pages/StockMovement.jsx`
- [Material master](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/MaterialMaster.jsx): `frontend/src/pages/MaterialMaster.jsx`
- [Location master](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/LocationMaster.jsx): `frontend/src/pages/LocationMaster.jsx`
- [Rack manager](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/RackManager.jsx): `frontend/src/pages/RackManager.jsx`
- [Rack labels](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/RackLabels.jsx): `frontend/src/pages/RackLabels.jsx`
- [Reference data](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/pages/Reference.jsx): `frontend/src/pages/Reference.jsx`

### Client data access

- [Warehouse store](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/lib/store/useWarehouseStore.js): `frontend/src/lib/store/useWarehouseStore.js`
- [API services](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/lib/api/apiService.js): `frontend/src/lib/api/apiService.js`
- [HTTP API client](https://github.com/shubhampal24/rack_management/blob/main/frontend/src/lib/api/apiClient.js): `frontend/src/lib/api/apiClient.js`

### API and domain operations

- [Express API server](https://github.com/shubhampal24/rack_management/blob/main/backend/server.js): `backend/server.js`
- [Authentication routes](https://github.com/shubhampal24/rack_management/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Rack operations](https://github.com/shubhampal24/rack_management/blob/main/backend/routes/racks.js): `backend/routes/racks.js`
- [Material operations](https://github.com/shubhampal24/rack_management/blob/main/backend/routes/materials.js): `backend/routes/materials.js`
- [Location operations](https://github.com/shubhampal24/rack_management/blob/main/backend/routes/locations.js): `backend/routes/locations.js`
- [Movement operations](https://github.com/shubhampal24/rack_management/blob/main/backend/routes/movements.js): `backend/routes/movements.js`
- [Token authorization](https://github.com/shubhampal24/rack_management/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`

### Warehouse persistence

- [User records](https://github.com/shubhampal24/rack_management/blob/main/backend/models/User.js): `backend/models/User.js`
- [Rack records](https://github.com/shubhampal24/rack_management/blob/main/backend/models/Rack.js): `backend/models/Rack.js`
- [Location records](https://github.com/shubhampal24/rack_management/blob/main/backend/models/Location.js): `backend/models/Location.js`
- [Material records](https://github.com/shubhampal24/rack_management/blob/main/backend/models/Material.js): `backend/models/Material.js`
- [Movement records](https://github.com/shubhampal24/rack_management/blob/main/backend/models/Movement.js): `backend/models/Movement.js`

### Other components

- **Warehouse user**
- **MongoDB**

## Connections

- Warehouse user → App routing and loader: uses
- App routing and loader → Frontend authentication: provides auth (evidence: `frontend/src/App.jsx`)
- App routing and loader → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- App routing and loader → Rack map: routes to (evidence: `frontend/src/App.jsx`)
- App routing and loader → Inventory: routes to (evidence: `frontend/src/App.jsx`)
- App routing and loader → Stock movement: routes to (evidence: `frontend/src/App.jsx`)
- App routing and loader → Material master: routes to (evidence: `frontend/src/App.jsx`)
- App routing and loader → Location master: routes to (evidence: `frontend/src/App.jsx`)
- App routing and loader → Rack manager: routes to (evidence: `frontend/src/App.jsx`)
- App routing and loader → Rack labels: routes to (evidence: `frontend/src/App.jsx`)
- App routing and loader → Reference data: routes to (evidence: `frontend/src/App.jsx`)
- App routing and loader → Warehouse store: loads data (evidence: `frontend/src/App.jsx`)
- Warehouse store → API services: calls (evidence: `frontend/src/lib/store/useWarehouseStore.js`)
- API services → HTTP API client: uses (evidence: `frontend/src/lib/api/apiService.js`)
- HTTP API client → Express API server: sends HTTP requests
- Express API server → Authentication routes: mounts (evidence: `backend/server.js`)
- Express API server → Rack operations: mounts (evidence: `backend/server.js`)
- Express API server → Material operations: mounts (evidence: `backend/server.js`)
- Express API server → Location operations: mounts (evidence: `backend/server.js`)
- Express API server → Movement operations: mounts (evidence: `backend/server.js`)
- Authentication routes → User records: queries (evidence: `backend/routes/auth.js`)
- Authentication routes → Token authorization: requires token (evidence: `backend/routes/auth.js`)
- Rack operations → Token authorization: requires token (evidence: `backend/routes/racks.js`)
- Rack operations → Rack records: queries (evidence: `backend/routes/racks.js`)
- Rack operations → Location records: creates and updates (evidence: `backend/routes/racks.js`)
- Rack operations → Movement records: checks stock (evidence: `backend/routes/racks.js`)
- Material operations → Token authorization: requires token (evidence: `backend/routes/materials.js`)
- Material operations → Material records: queries (evidence: `backend/routes/materials.js`)
- Material operations → Location records: uses (evidence: `backend/routes/materials.js`)
- Material operations → Movement records: uses (evidence: `backend/routes/materials.js`)
- Location operations → Token authorization: requires token (evidence: `backend/routes/locations.js`)
- Location operations → Location records: queries (evidence: `backend/routes/locations.js`)
- Location operations → Movement records: uses (evidence: `backend/routes/locations.js`)
- Movement operations → Token authorization: requires token (evidence: `backend/routes/movements.js`)
- Movement operations → Movement records: queries (evidence: `backend/routes/movements.js`)
- Movement operations → Location records: uses (evidence: `backend/routes/movements.js`)
- Express API server → MongoDB: connects at startup (evidence: `backend/server.js`)
