# pradeepsb-05/productinventory architecture

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

## Overview

This is a Spring-based product inventory and order-management API. Users authenticate, manage catalog/customer data, create and track orders through fulfillment, and generate invoices; inventory, warehouse stock, imports/exports, notifications, and access administration are supporting capabilities. The graph follows relationships visible in the supplied excerpts and SOURCE INDEX. Several listed subsystems were not sampled, so their internal call paths are intentionally left unspecified.

Main entry points: [`src/main/java/com/hepl/product/Repository`](https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/Repository) (Data repositories), [`src/main/java/com/hepl/product/Service/ServiceImpl/AuthServiceImpl.java`](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/ServiceImpl/AuthServiceImpl.java) (Authentication service), [`src/main/java/com/hepl/product/Controller/OrderController.java`](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Controller/OrderController.java) (Order API), [`src/main/java/com/hepl/product/Controller/WorkflowController.java`](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Controller/WorkflowController.java) (Order workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; access"]
  node_auth_api["Authentication API"]
  node_auth_logic["Authentication service"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
  node_roles["Roles &amp; permissions"]
end

subgraph group_catalog["Catalog &amp; customers"]
  node_product_api["Product API"]
  node_product_service["Product service"]
  node_product_import["Product import/export"]
  node_customer_division["Customer &amp; division"]
end

subgraph group_commerce["Orders &amp; fulfillment"]
  node_orders_api["Order API"]
  node_order_service["Order service<br/>[OrderService.java]"]
  node_workflow["Order workflow"]
  node_invoices_api["Invoice API"]
  node_invoice_service["Invoice service"]
end

subgraph group_inventory["Inventory &amp; operations"]
  node_stock_ops["Stock &amp; warehouse"]
  node_import_export["Data import/export"]
end

subgraph group_platform["Persistence &amp; integrations"]
  node_email["Email notifications<br/>[EmailService.java]"]
  node_socket["Socket notifications"]
  node_repositories[("Data repositories")]
  node_domain["Business entities"]
  node_api_response["API response DTO<br/>[ApiResponse.java]"]
end

node_client(("API client"))

node_client -->|"authenticates"| node_auth_api
node_auth_api -->|"delegates to"| node_auth_logic
node_auth_logic -->|"reads/writes login"| node_repositories
node_auth_logic -->|"generates tokens"| node_jwt
node_auth_logic -->|"sends reset email"| node_email
node_client -->|"manages catalog"| node_product_api
node_product_api -->|"delegates to"| node_product_service
node_product_api -->|"invokes transfer"| node_product_import
node_product_import -->|"uses product data"| node_repositories
node_client -->|"places orders"| node_orders_api
node_orders_api -->|"delegates to"| node_order_service
node_orders_api -->|"queries orders"| node_repositories
node_orders_api -->|"invokes transfer"| node_import_export
node_client -->|"updates fulfillment"| node_workflow
node_workflow -->|"records transitions"| node_repositories
node_workflow -->|"sends status email"| node_email
node_workflow -->|"publishes updates"| node_socket
node_client -->|"requests invoices"| node_invoices_api
node_invoices_api -->|"delegates to"| node_invoice_service
node_invoices_api -->|"accesses invoices"| node_repositories
node_invoice_service -->|"reads/writes invoices"| node_repositories
node_invoice_service -->|"uses order/customer data"| node_domain
node_client -.->|"manages inventory"| node_stock_ops
node_client -.->|"maintains records"| node_customer_division
node_client -.->|"administers access"| node_roles

click node_auth_api "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Controller/AuthController.java"
click node_auth_logic "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/ServiceImpl/AuthServiceImpl.java"
click node_jwt "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Util/JwtUtil.java"
click node_roles "https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/Service"
click node_product_api "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Controller/ProductController.java"
click node_product_service "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/ProductService.java"
click node_product_import "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/ServiceImpl/ProductImportExportServiceImpl.java"
click node_customer_division "https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/Service"
click node_orders_api "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Controller/OrderController.java"
click node_order_service "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/OrderService.java"
click node_workflow "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Controller/WorkflowController.java"
click node_invoices_api "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Controller/InvoiceController.java"
click node_invoice_service "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/ServiceImpl/InvoiceServiceImpl.java"
click node_stock_ops "https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/Controller"
click node_import_export "https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/Service"
click node_email "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/EmailService.java"
click node_socket "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/SocketIOService.java"
click node_repositories "https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/Repository"
click node_domain "https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/model"
click node_api_response "https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Payload/Response/ApiResponse.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_auth_api,node_auth_logic,node_jwt,node_roles,node_client toneBlue
class node_product_api,node_product_service,node_product_import,node_customer_division toneAmber
class node_orders_api,node_order_service,node_workflow,node_invoices_api,node_invoice_service toneMint
class node_stock_ops,node_import_export toneRose
class node_email,node_socket,node_repositories,node_domain,node_api_response toneIndigo
```

## Components

### Identity & access

- [Authentication API](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Controller/AuthController.java): `src/main/java/com/hepl/product/Controller/AuthController.java`
- [Authentication service](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/ServiceImpl/AuthServiceImpl.java): `src/main/java/com/hepl/product/Service/ServiceImpl/AuthServiceImpl.java`
- [JWT utilities](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Util/JwtUtil.java): `src/main/java/com/hepl/product/Util/JwtUtil.java`
- [Roles & permissions](https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/Service): `src/main/java/com/hepl/product/Service`

### Catalog & customers

- [Product API](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Controller/ProductController.java): `src/main/java/com/hepl/product/Controller/ProductController.java`
- [Product service](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/ProductService.java): `src/main/java/com/hepl/product/Service/ProductService.java`
- [Product import/export](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/ServiceImpl/ProductImportExportServiceImpl.java): `src/main/java/com/hepl/product/Service/ServiceImpl/ProductImportExportServiceImpl.java`
- [Customer & division](https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/Service): `src/main/java/com/hepl/product/Service`

### Orders & fulfillment

- [Order API](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Controller/OrderController.java): `src/main/java/com/hepl/product/Controller/OrderController.java`
- [Order service](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/OrderService.java): `src/main/java/com/hepl/product/Service/OrderService.java`
- [Order workflow](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Controller/WorkflowController.java): `src/main/java/com/hepl/product/Controller/WorkflowController.java`
- [Invoice API](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Controller/InvoiceController.java): `src/main/java/com/hepl/product/Controller/InvoiceController.java`
- [Invoice service](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/ServiceImpl/InvoiceServiceImpl.java): `src/main/java/com/hepl/product/Service/ServiceImpl/InvoiceServiceImpl.java`

### Inventory & operations

- [Stock & warehouse](https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/Controller): `src/main/java/com/hepl/product/Controller`
- [Data import/export](https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/Service): `src/main/java/com/hepl/product/Service`

### Persistence & integrations

- [Email notifications](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/EmailService.java): `src/main/java/com/hepl/product/Service/EmailService.java`
- [Socket notifications](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Service/SocketIOService.java): `src/main/java/com/hepl/product/Service/SocketIOService.java`
- [Data repositories](https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/Repository): `src/main/java/com/hepl/product/Repository`
- [Business entities](https://github.com/pradeepsb-05/productinventory/tree/main/src/main/java/com/hepl/product/model): `src/main/java/com/hepl/product/model`
- [API response DTO](https://github.com/pradeepsb-05/productinventory/blob/main/src/main/java/com/hepl/product/Payload/Response/ApiResponse.java): `src/main/java/com/hepl/product/Payload/Response/ApiResponse.java`

### Other components

- **API client**

## Connections

- API client → Authentication API: authenticates (evidence: `src/main/java/com/hepl/product/Controller/AuthController.java`)
- Authentication API → Authentication service: delegates to (evidence: `src/main/java/com/hepl/product/Controller/AuthController.java`)
- Authentication service → Data repositories: reads/writes login (evidence: `src/main/java/com/hepl/product/Service/ServiceImpl/AuthServiceImpl.java`)
- Authentication service → JWT utilities: generates tokens (evidence: `src/main/java/com/hepl/product/Service/ServiceImpl/AuthServiceImpl.java`)
- Authentication service → Email notifications: sends reset email (evidence: `src/main/java/com/hepl/product/Service/ServiceImpl/AuthServiceImpl.java`)
- API client → Product API: manages catalog (evidence: `src/main/java/com/hepl/product/Controller/ProductController.java`)
- Product API → Product service: delegates to (evidence: `src/main/java/com/hepl/product/Controller/ProductController.java`)
- Product API → Product import/export: invokes transfer (evidence: `src/main/java/com/hepl/product/Controller/ProductController.java`)
- Product import/export → Data repositories: uses product data (evidence: `src/main/java/com/hepl/product/Service/ServiceImpl/ProductImportExportServiceImpl.java`)
- API client → Order API: places orders (evidence: `src/main/java/com/hepl/product/Controller/OrderController.java`)
- Order API → Order service: delegates to (evidence: `src/main/java/com/hepl/product/Controller/OrderController.java`)
- Order API → Data repositories: queries orders (evidence: `src/main/java/com/hepl/product/Controller/OrderController.java`)
- Order API → Data import/export: invokes transfer (evidence: `src/main/java/com/hepl/product/Controller/OrderController.java`)
- API client → Order workflow: updates fulfillment (evidence: `src/main/java/com/hepl/product/Controller/WorkflowController.java`)
- Order workflow → Data repositories: records transitions (evidence: `src/main/java/com/hepl/product/Controller/WorkflowController.java`)
- Order workflow → Email notifications: sends status email (evidence: `src/main/java/com/hepl/product/Controller/WorkflowController.java`)
- Order workflow → Socket notifications: publishes updates (evidence: `src/main/java/com/hepl/product/Controller/WorkflowController.java`)
- API client → Invoice API: requests invoices (evidence: `src/main/java/com/hepl/product/Controller/InvoiceController.java`)
- Invoice API → Invoice service: delegates to (evidence: `src/main/java/com/hepl/product/Controller/InvoiceController.java`)
- Invoice API → Data repositories: accesses invoices (evidence: `src/main/java/com/hepl/product/Controller/InvoiceController.java`)
- Invoice service → Data repositories: reads/writes invoices (evidence: `src/main/java/com/hepl/product/Service/ServiceImpl/InvoiceServiceImpl.java`)
- Invoice service → Business entities: uses order/customer data (evidence: `src/main/java/com/hepl/product/Service/ServiceImpl/InvoiceServiceImpl.java`)
- API client → Stock & warehouse: manages inventory
- API client → Customer & division: maintains records
- API client → Roles & permissions: administers access
