# aljolandaalhandhali/inventory-order-management-api architecture

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

- Interactive diagram: https://gitdiagram.com/aljolandaalhandhali/inventory-order-management-api
- Repository: https://github.com/aljolandaalhandhali/inventory-order-management-api

## Overview

This is a Spring Boot REST API for inventory, customers, and order lifecycle management. Clients create catalog and customer records, open draft orders, add items, confirm orders (which validates and deducts stock), then ship, deliver, or cancel them; status history records transitions. Separate product operations adjust stock and report low-stock items. The sampled services show repository-backed persistence and transactional order handling; the README documents Oracle as the database. Edges into controllers are based on the endpoint documentation and indexed references; unsampled implementation details are not inferred.

Main entry points: [`src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java`](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java) (Order Lifecycle), [`src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CustomerController.java`](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CustomerController.java) (Customer API), [`src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/OrderController.java`](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/OrderController.java) (Order API), [`src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/ProductService.java`](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/ProductService.java) (Inventory Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_category_api["Category API"]
  node_product_api["Product API"]
  node_customer_api["Customer API"]
  node_order_api["Order API"]
  node_exception_handler["Error Mapping"]
end

subgraph group_services["Business Services"]
  node_category_service["Category Management"]
  node_product_service["Inventory Operations"]
  node_customer_service["Customer Records"]
  node_order_service["Order Lifecycle<br/>[OrderService.java]"]
end

subgraph group_persistence["Persistence"]
  node_category_repo["Category Repository"]
  node_product_repo["Product Repository"]
  node_customer_repo["Customer Repository"]
  node_phone_repo["Phone Repository"]
  node_order_repo["Order Repository"]
  node_item_repo["Order Item Repository"]
  node_history_repo["Status History Repository"]
end

subgraph group_domain["Domain Model"]
  node_catalog_model["Catalog Entities<br/>[Category.java]"]
  node_product_model["Product Entity<br/>[Product.java]"]
  node_customer_model["Customer Entity<br/>[Customer.java]"]
  node_phone_model["Customer Phone Entity<br/>[CustomerPhone.java]"]
  node_order_model["Order Entity<br/>[Order.java]"]
  node_item_model["Order Item Entity<br/>[OrderItem.java]"]
  node_status_model["Order Status<br/>[OrderStatus.java]"]
  node_history_model["Status History Entity"]
end

node_client(("API Client"))
node_oracle[("Oracle Database")]

node_client -->|"calls category endpoints"| node_category_api
node_client -->|"calls product endpoints"| node_product_api
node_client -->|"calls customer endpoints"| node_customer_api
node_client -->|"calls order endpoints"| node_order_api
node_category_api -->|"delegates to"| node_category_service
node_product_api -->|"delegates to"| node_product_service
node_customer_api -->|"delegates to"| node_customer_service
node_customer_api -->|"creates draft orders"| node_order_service
node_order_api -->|"delegates to"| node_order_service
node_category_service -->|"saves and lists"| node_category_repo
node_product_service -->|"loads category"| node_category_repo
node_product_service -->|"saves and queries"| node_product_repo
node_customer_service -->|"saves and loads"| node_customer_repo
node_customer_service -->|"saves phones"| node_phone_repo
node_order_service -->|"loads and saves orders"| node_order_repo
node_order_service -->|"loads customer"| node_customer_repo
node_order_service -->|"reads and updates stock"| node_product_repo
node_order_service -->|"saves order items"| node_item_repo
node_order_service -->|"records status changes"| node_history_repo
node_category_repo -->|"persists entities"| node_oracle
node_product_repo -->|"persists entities"| node_oracle
node_customer_repo -->|"persists entities"| node_oracle
node_phone_repo -->|"persists entities"| node_oracle
node_order_repo -->|"persists entities"| node_oracle
node_item_repo -->|"persists entities"| node_oracle
node_history_repo -->|"persists entities"| node_oracle
node_order_api -.->|"errors handled by"| node_exception_handler

click node_category_api "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CategoryController.java"
click node_product_api "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/ProductController.java"
click node_customer_api "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CustomerController.java"
click node_order_api "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/OrderController.java"
click node_category_service "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CategoryService.java"
click node_product_service "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/ProductService.java"
click node_customer_service "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CustomerService.java"
click node_order_service "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java"
click node_category_repo "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/CategoryRepository.java"
click node_product_repo "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/ProductRepository.java"
click node_customer_repo "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/CustomerRepository.java"
click node_phone_repo "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/CustomerPhoneRepository.java"
click node_order_repo "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/OrderRepository.java"
click node_item_repo "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/OrderItemRepository.java"
click node_history_repo "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/OrderStatusHistoryRepository.java"
click node_catalog_model "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Category.java"
click node_product_model "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Product.java"
click node_customer_model "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Customer.java"
click node_phone_model "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/CustomerPhone.java"
click node_order_model "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Order.java"
click node_item_model "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/OrderItem.java"
click node_status_model "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/OrderStatus.java"
click node_history_model "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/OrderStatusHistory.java"
click node_exception_handler "https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/exception/GlobalExceptionHandler.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_category_api,node_product_api,node_customer_api,node_order_api,node_exception_handler,node_client toneBlue
class node_category_service,node_product_service,node_customer_service,node_order_service,node_oracle toneAmber
class node_category_repo,node_product_repo,node_customer_repo,node_phone_repo,node_order_repo,node_item_repo,node_history_repo toneMint
class node_catalog_model,node_product_model,node_customer_model,node_phone_model,node_order_model,node_item_model,node_status_model,node_history_model toneRose
```

## Components

### REST API

- [Category API](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CategoryController.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CategoryController.java`
- [Product API](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/ProductController.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/ProductController.java`
- [Customer API](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CustomerController.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CustomerController.java`
- [Order API](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/OrderController.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/OrderController.java`
- [Error Mapping](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/exception/GlobalExceptionHandler.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/exception/GlobalExceptionHandler.java`

### Business Services

- [Category Management](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CategoryService.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CategoryService.java`
- [Inventory Operations](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/ProductService.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/ProductService.java`
- [Customer Records](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CustomerService.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CustomerService.java`
- [Order Lifecycle](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java`

### Persistence

- [Category Repository](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/CategoryRepository.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/CategoryRepository.java`
- [Product Repository](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/ProductRepository.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/ProductRepository.java`
- [Customer Repository](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/CustomerRepository.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/CustomerRepository.java`
- [Phone Repository](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/CustomerPhoneRepository.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/CustomerPhoneRepository.java`
- [Order Repository](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/OrderRepository.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/OrderRepository.java`
- [Order Item Repository](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/OrderItemRepository.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/OrderItemRepository.java`
- [Status History Repository](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/OrderStatusHistoryRepository.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/repository/OrderStatusHistoryRepository.java`

### Domain Model

- [Catalog Entities](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Category.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Category.java`
- [Product Entity](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Product.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Product.java`
- [Customer Entity](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Customer.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Customer.java`
- [Customer Phone Entity](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/CustomerPhone.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/CustomerPhone.java`
- [Order Entity](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Order.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/Order.java`
- [Order Item Entity](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/OrderItem.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/OrderItem.java`
- [Order Status](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/OrderStatus.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/OrderStatus.java`
- [Status History Entity](https://github.com/aljolandaalhandhali/inventory-order-management-api/blob/main/src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/OrderStatusHistory.java): `src/main/java/com/Invetory/mangment/Inventory/Order/Management/entity/OrderStatusHistory.java`

### Other components

- **API Client**
- **Oracle Database**

## Connections

- API Client → Category API: calls category endpoints (evidence: `README.md`)
- API Client → Product API: calls product endpoints (evidence: `README.md`)
- API Client → Customer API: calls customer endpoints (evidence: `README.md`)
- API Client → Order API: calls order endpoints (evidence: `README.md`)
- Category API → Category Management: delegates to (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CategoryController.java`)
- Product API → Inventory Operations: delegates to (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/ProductController.java`)
- Customer API → Customer Records: delegates to (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CustomerController.java`)
- Customer API → Order Lifecycle: creates draft orders (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/CustomerController.java`)
- Order API → Order Lifecycle: delegates to (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/controller/OrderController.java`)
- Category Management → Category Repository: saves and lists (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CategoryService.java`)
- Inventory Operations → Category Repository: loads category (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/ProductService.java`)
- Inventory Operations → Product Repository: saves and queries (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/ProductService.java`)
- Customer Records → Customer Repository: saves and loads (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CustomerService.java`)
- Customer Records → Phone Repository: saves phones (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/CustomerService.java`)
- Order Lifecycle → Order Repository: loads and saves orders (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java`)
- Order Lifecycle → Customer Repository: loads customer (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java`)
- Order Lifecycle → Product Repository: reads and updates stock (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java`)
- Order Lifecycle → Order Item Repository: saves order items (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java`)
- Order Lifecycle → Status History Repository: records status changes (evidence: `src/main/java/com/Invetory/mangment/Inventory/Order/Management/service/OrderService.java`)
- Category Repository → Oracle Database: persists entities (evidence: `README.md`)
- Product Repository → Oracle Database: persists entities (evidence: `README.md`)
- Customer Repository → Oracle Database: persists entities (evidence: `README.md`)
- Phone Repository → Oracle Database: persists entities (evidence: `README.md`)
- Order Repository → Oracle Database: persists entities (evidence: `README.md`)
- Order Item Repository → Oracle Database: persists entities (evidence: `README.md`)
- Status History Repository → Oracle Database: persists entities (evidence: `README.md`)
- Order API → Error Mapping: errors handled by
