# hai05senpai/warehouse-mangement-system architecture

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

- Interactive diagram: https://gitdiagram.com/hai05senpai/warehouse-mangement-system
- Repository: https://github.com/hai05senpai/warehouse-mangement-system

## Overview

This is a warehouse-management system: administrators use the React interface to manage catalog and stock, record receipts, issues, transfers and counts, then inspect operational reports. The frontend routes pages through a shared API client to a Spring REST backend; backend services implement transaction workflows against persistent inventory and order records. README-described features are retained where source excerpts are absent; dashed, uncited links mark relationships not verified in the sampled code.

Main entry points: [`frontend/src/App.tsx`](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/App.tsx) (Route and auth), [`backend/src/main/java/com/logistic/backend/controller`](https://github.com/hai05senpai/warehouse-mangement-system/tree/main/backend/src/main/java/com/logistic/backend/controller) (REST controllers), [`backend/src/main/java/com/logistic/backend/repository`](https://github.com/hai05senpai/warehouse-mangement-system/tree/main/backend/src/main/java/com/logistic/backend/repository) (JPA repositories), [`backend/src/main/java/com/logistic/backend/service/AuthService.java`](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/AuthService.java) (Session authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Admin interface"]
  node_app["Route and auth<br/>[App.tsx]"]
  node_login["Login<br/>[Login.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_products["Products<br/>[Products.tsx]"]
  node_inventory["Inventory and transfers<br/>[Inventory.tsx]"]
  node_receipts["Receipts<br/>[Receipts.tsx]"]
  node_issues["Issue orders<br/>[Issues.tsx]"]
  node_counts["Stock takes<br/>[StockTakes.tsx]"]
  node_reportsui["Reports<br/>[Reports.tsx]"]
  node_client["API client<br/>[api.ts]"]
end

subgraph group_api["REST workflows"]
  node_rest["REST controllers"]
  node_auth["Session authentication<br/>[AuthService.java]"]
end

subgraph group_stock["Stock operations"]
  node_inventoryservice["Inventory and transfer"]
  node_receiving["Receipt processing"]
  node_issuing["Issue reservation"]
  node_countservice["Count adjustment"]
end

subgraph group_insights["Catalog and insight"]
  node_productservice["Product catalog"]
  node_reportservice["Reporting and trace<br/>[ReportService.java]"]
end

subgraph group_state["Persistent state"]
  node_repositories["JPA repositories"]
  node_entities["Warehouse records"]
  node_postgres[("PostgreSQL")]
  node_redis[("Redis")]
end

node_admin(("Warehouse admin"))

node_admin -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_products
node_app -->|"routes to"| node_inventory
node_app -->|"routes to"| node_receipts
node_app -->|"routes to"| node_issues
node_app -->|"routes to"| node_counts
node_app -->|"routes to"| node_reportsui
node_app -->|"reads token"| node_client
node_inventory -->|"requests data"| node_client
node_client -->|"HTTP API"| node_rest
node_rest -.->|"delegates auth"| node_auth
node_rest -.->|"delegates catalog"| node_productservice
node_rest -->|"delegates inventory"| node_inventoryservice
node_rest -.->|"delegates receipts"| node_receiving
node_rest -->|"delegates issues"| node_issuing
node_rest -->|"delegates counts"| node_countservice
node_rest -->|"delegates reports"| node_reportservice
node_inventoryservice -->|"reads and writes"| node_repositories
node_receiving -->|"reads and writes"| node_repositories
node_issuing -->|"locks and updates"| node_repositories
node_countservice -->|"reads and adjusts"| node_repositories
node_reportservice -.->|"queries reports"| node_repositories
node_repositories -->|"maps records"| node_entities
node_repositories -->|"persists"| node_postgres
node_auth -->|"loads admins"| node_repositories
node_auth -.->|"session cache"| node_redis

click node_app "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/App.tsx"
click node_login "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Login.tsx"
click node_dashboard "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Dashboard.tsx"
click node_products "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Products.tsx"
click node_inventory "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Inventory.tsx"
click node_receipts "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Receipts.tsx"
click node_issues "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Issues.tsx"
click node_counts "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/StockTakes.tsx"
click node_reportsui "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Reports.tsx"
click node_client "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/api.ts"
click node_rest "https://github.com/hai05senpai/warehouse-mangement-system/tree/main/backend/src/main/java/com/logistic/backend/controller"
click node_auth "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/AuthService.java"
click node_productservice "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/ProductService.java"
click node_inventoryservice "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/InventoryService.java"
click node_receiving "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/ReceiptService.java"
click node_issuing "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/IssueOrderService.java"
click node_countservice "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/StockTakeService.java"
click node_reportservice "https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/ReportService.java"
click node_repositories "https://github.com/hai05senpai/warehouse-mangement-system/tree/main/backend/src/main/java/com/logistic/backend/repository"
click node_entities "https://github.com/hai05senpai/warehouse-mangement-system/tree/main/backend/src/main/java/com/logistic/backend/entity"

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_dashboard,node_products,node_inventory,node_receipts,node_issues,node_counts,node_reportsui,node_client toneBlue
class node_rest,node_auth toneAmber
class node_inventoryservice,node_receiving,node_issuing,node_countservice toneMint
class node_productservice,node_reportservice toneRose
class node_repositories,node_entities,node_postgres,node_redis,node_admin toneIndigo
```

## Components

### Admin interface

- [Route and auth](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Login](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [Dashboard](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [Products](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Products.tsx): `frontend/src/pages/Products.tsx`
- [Inventory and transfers](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Inventory.tsx): `frontend/src/pages/Inventory.tsx`
- [Receipts](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Receipts.tsx): `frontend/src/pages/Receipts.tsx`
- [Issue orders](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Issues.tsx): `frontend/src/pages/Issues.tsx`
- [Stock takes](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/StockTakes.tsx): `frontend/src/pages/StockTakes.tsx`
- [Reports](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/pages/Reports.tsx): `frontend/src/pages/Reports.tsx`
- [API client](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/frontend/src/api.ts): `frontend/src/api.ts`

### REST workflows

- [REST controllers](https://github.com/hai05senpai/warehouse-mangement-system/tree/main/backend/src/main/java/com/logistic/backend/controller): `backend/src/main/java/com/logistic/backend/controller`
- [Session authentication](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/AuthService.java): `backend/src/main/java/com/logistic/backend/service/AuthService.java`

### Stock operations

- [Inventory and transfer](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/InventoryService.java): `backend/src/main/java/com/logistic/backend/service/InventoryService.java`
- [Receipt processing](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/ReceiptService.java): `backend/src/main/java/com/logistic/backend/service/ReceiptService.java`
- [Issue reservation](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/IssueOrderService.java): `backend/src/main/java/com/logistic/backend/service/IssueOrderService.java`
- [Count adjustment](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/StockTakeService.java): `backend/src/main/java/com/logistic/backend/service/StockTakeService.java`

### Catalog and insight

- [Product catalog](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/ProductService.java): `backend/src/main/java/com/logistic/backend/service/ProductService.java`
- [Reporting and trace](https://github.com/hai05senpai/warehouse-mangement-system/blob/main/backend/src/main/java/com/logistic/backend/service/ReportService.java): `backend/src/main/java/com/logistic/backend/service/ReportService.java`

### Persistent state

- [JPA repositories](https://github.com/hai05senpai/warehouse-mangement-system/tree/main/backend/src/main/java/com/logistic/backend/repository): `backend/src/main/java/com/logistic/backend/repository`
- [Warehouse records](https://github.com/hai05senpai/warehouse-mangement-system/tree/main/backend/src/main/java/com/logistic/backend/entity): `backend/src/main/java/com/logistic/backend/entity`
- **PostgreSQL**
- **Redis**

### Other components

- **Warehouse admin**

## Connections

- Warehouse admin → Route and auth: uses (evidence: `README.md`)
- Route and auth → Login: routes to (evidence: `frontend/src/App.tsx`)
- Route and auth → Dashboard: routes to (evidence: `frontend/src/App.tsx`)
- Route and auth → Products: routes to (evidence: `frontend/src/App.tsx`)
- Route and auth → Inventory and transfers: routes to (evidence: `frontend/src/App.tsx`)
- Route and auth → Receipts: routes to (evidence: `frontend/src/App.tsx`)
- Route and auth → Issue orders: routes to (evidence: `frontend/src/App.tsx`)
- Route and auth → Stock takes: routes to (evidence: `frontend/src/App.tsx`)
- Route and auth → Reports: routes to (evidence: `frontend/src/App.tsx`)
- Route and auth → API client: reads token (evidence: `frontend/src/App.tsx`)
- Inventory and transfers → API client: requests data (evidence: `frontend/src/pages/Inventory.tsx`)
- API client → REST controllers: HTTP API (evidence: `frontend/src/api.ts`)
- REST controllers → Session authentication: delegates auth (evidence: `backend/src/main/java/com/logistic/backend/controller/AuthController.java`)
- REST controllers → Product catalog: delegates catalog
- REST controllers → Inventory and transfer: delegates inventory (evidence: `backend/src/main/java/com/logistic/backend/controller/InventoryController.java`)
- REST controllers → Receipt processing: delegates receipts
- REST controllers → Issue reservation: delegates issues (evidence: `backend/src/main/java/com/logistic/backend/controller/IssueOrderController.java`)
- REST controllers → Count adjustment: delegates counts (evidence: `backend/src/main/java/com/logistic/backend/controller/StockTakeController.java`)
- REST controllers → Reporting and trace: delegates reports (evidence: `backend/src/main/java/com/logistic/backend/controller/ReportController.java`)
- Inventory and transfer → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/logistic/backend/service/InventoryService.java`)
- Receipt processing → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/logistic/backend/service/ReceiptService.java`)
- Issue reservation → JPA repositories: locks and updates (evidence: `backend/src/main/java/com/logistic/backend/service/IssueOrderService.java`)
- Count adjustment → JPA repositories: reads and adjusts (evidence: `backend/src/main/java/com/logistic/backend/service/StockTakeService.java`)
- Reporting and trace → JPA repositories: queries reports
- JPA repositories → Warehouse records: maps records (evidence: `backend/src/main/java/com/logistic/backend/repository/InventoryRepository.java`)
- JPA repositories → PostgreSQL: persists (evidence: `README.md`)
- Session authentication → JPA repositories: loads admins (evidence: `backend/src/main/java/com/logistic/backend/service/AuthService.java`)
- Session authentication → Redis: session cache
