# vinodambarapu267/b2b-procurement-supply-chain-management-platform architecture

> Architecture diagram of the GitHub repository vinodambarapu267/b2b-procurement-supply-chain-management-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform
- Repository: https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform

## Overview

This repository is a set of Spring-based B2B procurement services. The visible user-facing workflows cover supplier maintenance, purchase-order creation and status changes, and recording or retrieving approval decisions. Sampled source shows controllers delegating to service interfaces and implementations, with persistence through repositories; inventory, audit, notification, and reporting are also present in the tree, but their runtime behavior is not shown. The README is empty, so cross-service orchestration and integrations are not asserted.

Main entry points: [`purchase-order-service/src/main/java/com/vinod/b2b/controller/PurchaseOrderController.java`](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/controller/PurchaseOrderController.java) (Order API), [`purchase-order-service/src/main/java/com/vinod/b2b/repository/PurchaseOrderRepository.java`](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/repository/PurchaseOrderRepository.java) (Order repository), [`approval-service/src/main/java/com/vinod/b2b/controller/ApprovalController.java`](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/controller/ApprovalController.java) (Approval API), [`approval-service/src/main/java/com/vinod/b2b/repository/ApprovalRepository.java`](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/repository/ApprovalRepository.java) (Approval repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orders["Purchase Orders"]
  node_po_api["Order API"]
  node_po_service["Order service"]
  node_po_impl["Order logic"]
  node_po_repo["Order repository"]
  node_po_data[("Purchase orders")]
  node_order_status["Order status<br/>[OrderStatus.java]"]
end

subgraph group_approvals["Approvals"]
  node_approval_api["Approval API"]
  node_approval_service["Approval service"]
  node_approval_impl["Approval logic"]
  node_approval_repo["Approval repository"]
  node_approval_data[("Approval decisions")]
  node_approval_dto["Decision input"]
  node_approval_error["Approval errors"]
  node_decision["Decision values<br/>[Decision.java]"]
  node_response_message["Response message"]
  node_response_status["Response status"]
end

subgraph group_suppliers["Suppliers"]
  node_supplier_api["Supplier API"]
  node_supplier_service["Supplier service"]
  node_supplier_impl["Supplier logic"]
  node_supplier_repo["Supplier repository"]
  node_supplier_data[("Suppliers<br/>[Supplier.java]")]
  node_supplier_errors["Supplier errors"]
end

subgraph group_shared["Other Services"]
  node_inventory["Inventory service"]
  node_inventory_items[("Inventory items<br/>[InventoryItem.java]")]
  node_inventory_receipts[("Inventory receipts")]
  node_inventory_item_repo["Item repository"]
  node_inventory_receipt_repo["Receipt repository"]
  node_audit["Audit service"]
  node_notifications["Notification service"]
  node_reporting["Reporting service"]
end

node_user(("API caller"))

node_user -->|"submits requests"| node_po_api
node_po_api -->|"delegates"| node_po_service
node_po_impl -->|"persists orders"| node_po_repo
node_po_repo -->|"stores"| node_po_data
node_user -->|"submits requests"| node_approval_api
node_approval_api -->|"delegates"| node_approval_service
node_approval_impl -->|"saves and queries"| node_approval_repo
node_approval_repo -->|"stores"| node_approval_data
node_user -->|"submits requests"| node_supplier_api
node_supplier_api -->|"delegates"| node_supplier_service
node_supplier_impl -->|"persists suppliers"| node_supplier_repo
node_supplier_repo -->|"stores"| node_supplier_data
node_inventory_item_repo -->|"stores"| node_inventory_items
node_inventory_receipt_repo -->|"stores"| node_inventory_receipts

click node_po_api "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/controller/PurchaseOrderController.java"
click node_po_service "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/service/PurchaseOrderService.java"
click node_po_impl "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/serviceimpl/PurchaseOrderServiceImpl.java"
click node_po_repo "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/repository/PurchaseOrderRepository.java"
click node_po_data "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/entity/PurchaseOrders.java"
click node_order_status "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/utility/OrderStatus.java"
click node_approval_api "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/controller/ApprovalController.java"
click node_approval_service "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/service/ApprovalService.java"
click node_approval_impl "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/serviceImpl/ApprovalServiceImpl.java"
click node_approval_repo "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/repository/ApprovalRepository.java"
click node_approval_data "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/entity/ApprovalDecisions.java"
click node_approval_dto "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/dto/ApprovalDecisionDto.java"
click node_approval_error "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/exceptions/ApproverNotFoundException.java"
click node_decision "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/utility/Decision.java"
click node_response_message "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/utility/ResponseMessage.java"
click node_response_status "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/utility/ResponseStatus.java"
click node_supplier_api "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/supplier-service/src/main/java/com/vinod/b2b/controller/SupplierController.java"
click node_supplier_service "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/supplier-service/src/main/java/com/vinod/b2b/service/SupplierService.java"
click node_supplier_impl "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/supplier-service/src/main/java/com/vinod/b2b/serviceimpl/SupplierServiceImpl.java"
click node_supplier_repo "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/supplier-service/src/main/java/com/vinod/b2b/repository/SupplierRepository.java"
click node_supplier_data "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/supplier-service/src/main/java/com/vinod/b2b/entity/Supplier.java"
click node_supplier_errors "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/supplier-service/src/main/java/com/vinod/b2b/exceptions/SupplierAlreadyExistException.java"
click node_inventory "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/inventory-service/src/main/java/com/vinod/b2b/InventoryServiceApplication.java"
click node_inventory_items "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/inventory-service/src/main/java/com/vinod/b2b/entity/InventoryItem.java"
click node_inventory_receipts "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/inventory-service/src/main/java/com/vinod/b2b/entity/InventoryReceipt.java"
click node_inventory_item_repo "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/inventory-service/src/main/java/com/vinod/b2b/repository/InventoryItemsRepository.java"
click node_inventory_receipt_repo "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/inventory-service/src/main/java/com/vinod/b2b/repository/InventoryReceiptsRepository.java"
click node_audit "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/audit-service/src/main/java/com/vinod/b2b/AuditServiceApplication.java"
click node_notifications "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/notification-service/src/main/java/com/vinod/b2b/NotificationServiceApplication.java"
click node_reporting "https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/reporting-service/src/main/java/com/vinod/b2b/ReportingServiceApplication.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_po_api,node_po_service,node_po_impl,node_po_repo,node_po_data,node_order_status toneBlue
class node_approval_api,node_approval_service,node_approval_impl,node_approval_repo,node_approval_data,node_approval_dto,node_approval_error,node_decision,node_response_message,node_response_status toneAmber
class node_supplier_api,node_supplier_service,node_supplier_impl,node_supplier_repo,node_supplier_data,node_supplier_errors,node_user toneMint
class node_inventory,node_inventory_items,node_inventory_receipts,node_inventory_item_repo,node_inventory_receipt_repo,node_audit,node_notifications,node_reporting toneRose
```

## Components

### Purchase Orders

- [Order API](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/controller/PurchaseOrderController.java): `purchase-order-service/src/main/java/com/vinod/b2b/controller/PurchaseOrderController.java`
- [Order service](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/service/PurchaseOrderService.java): `purchase-order-service/src/main/java/com/vinod/b2b/service/PurchaseOrderService.java`
- [Order logic](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/serviceimpl/PurchaseOrderServiceImpl.java): `purchase-order-service/src/main/java/com/vinod/b2b/serviceimpl/PurchaseOrderServiceImpl.java`
- [Order repository](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/repository/PurchaseOrderRepository.java): `purchase-order-service/src/main/java/com/vinod/b2b/repository/PurchaseOrderRepository.java`
- [Purchase orders](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/entity/PurchaseOrders.java): `purchase-order-service/src/main/java/com/vinod/b2b/entity/PurchaseOrders.java`
- [Order status](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/purchase-order-service/src/main/java/com/vinod/b2b/utility/OrderStatus.java): `purchase-order-service/src/main/java/com/vinod/b2b/utility/OrderStatus.java`

### Approvals

- [Approval API](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/controller/ApprovalController.java): `approval-service/src/main/java/com/vinod/b2b/controller/ApprovalController.java`
- [Approval service](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/service/ApprovalService.java): `approval-service/src/main/java/com/vinod/b2b/service/ApprovalService.java`
- [Approval logic](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/serviceImpl/ApprovalServiceImpl.java): `approval-service/src/main/java/com/vinod/b2b/serviceImpl/ApprovalServiceImpl.java`
- [Approval repository](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/repository/ApprovalRepository.java): `approval-service/src/main/java/com/vinod/b2b/repository/ApprovalRepository.java`
- [Approval decisions](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/entity/ApprovalDecisions.java): `approval-service/src/main/java/com/vinod/b2b/entity/ApprovalDecisions.java`
- [Decision input](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/dto/ApprovalDecisionDto.java): `approval-service/src/main/java/com/vinod/b2b/dto/ApprovalDecisionDto.java`
- [Approval errors](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/exceptions/ApproverNotFoundException.java): `approval-service/src/main/java/com/vinod/b2b/exceptions/ApproverNotFoundException.java`
- [Decision values](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/utility/Decision.java): `approval-service/src/main/java/com/vinod/b2b/utility/Decision.java`
- [Response message](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/utility/ResponseMessage.java): `approval-service/src/main/java/com/vinod/b2b/utility/ResponseMessage.java`
- [Response status](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/approval-service/src/main/java/com/vinod/b2b/utility/ResponseStatus.java): `approval-service/src/main/java/com/vinod/b2b/utility/ResponseStatus.java`

### Suppliers

- [Supplier API](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/supplier-service/src/main/java/com/vinod/b2b/controller/SupplierController.java): `supplier-service/src/main/java/com/vinod/b2b/controller/SupplierController.java`
- [Supplier service](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/supplier-service/src/main/java/com/vinod/b2b/service/SupplierService.java): `supplier-service/src/main/java/com/vinod/b2b/service/SupplierService.java`
- [Supplier logic](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/supplier-service/src/main/java/com/vinod/b2b/serviceimpl/SupplierServiceImpl.java): `supplier-service/src/main/java/com/vinod/b2b/serviceimpl/SupplierServiceImpl.java`
- [Supplier repository](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/supplier-service/src/main/java/com/vinod/b2b/repository/SupplierRepository.java): `supplier-service/src/main/java/com/vinod/b2b/repository/SupplierRepository.java`
- [Suppliers](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/supplier-service/src/main/java/com/vinod/b2b/entity/Supplier.java): `supplier-service/src/main/java/com/vinod/b2b/entity/Supplier.java`
- [Supplier errors](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/supplier-service/src/main/java/com/vinod/b2b/exceptions/SupplierAlreadyExistException.java): `supplier-service/src/main/java/com/vinod/b2b/exceptions/SupplierAlreadyExistException.java`

### Other Services

- [Inventory service](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/inventory-service/src/main/java/com/vinod/b2b/InventoryServiceApplication.java): `inventory-service/src/main/java/com/vinod/b2b/InventoryServiceApplication.java`
- [Inventory items](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/inventory-service/src/main/java/com/vinod/b2b/entity/InventoryItem.java): `inventory-service/src/main/java/com/vinod/b2b/entity/InventoryItem.java`
- [Inventory receipts](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/inventory-service/src/main/java/com/vinod/b2b/entity/InventoryReceipt.java): `inventory-service/src/main/java/com/vinod/b2b/entity/InventoryReceipt.java`
- [Item repository](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/inventory-service/src/main/java/com/vinod/b2b/repository/InventoryItemsRepository.java): `inventory-service/src/main/java/com/vinod/b2b/repository/InventoryItemsRepository.java`
- [Receipt repository](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/inventory-service/src/main/java/com/vinod/b2b/repository/InventoryReceiptsRepository.java): `inventory-service/src/main/java/com/vinod/b2b/repository/InventoryReceiptsRepository.java`
- [Audit service](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/audit-service/src/main/java/com/vinod/b2b/AuditServiceApplication.java): `audit-service/src/main/java/com/vinod/b2b/AuditServiceApplication.java`
- [Notification service](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/notification-service/src/main/java/com/vinod/b2b/NotificationServiceApplication.java): `notification-service/src/main/java/com/vinod/b2b/NotificationServiceApplication.java`
- [Reporting service](https://github.com/vinodambarapu267/b2b-procurement-supply-chain-management-platform/blob/main/reporting-service/src/main/java/com/vinod/b2b/ReportingServiceApplication.java): `reporting-service/src/main/java/com/vinod/b2b/ReportingServiceApplication.java`

### Other components

- **API caller**

## Connections

- API caller → Order API: submits requests (evidence: `purchase-order-service/src/main/java/com/vinod/b2b/controller/PurchaseOrderController.java`)
- Order API → Order service: delegates (evidence: `purchase-order-service/src/main/java/com/vinod/b2b/controller/PurchaseOrderController.java`)
- Order logic → Order repository: persists orders (evidence: `purchase-order-service/src/main/java/com/vinod/b2b/serviceimpl/PurchaseOrderServiceImpl.java`)
- Order repository → Purchase orders: stores (evidence: `purchase-order-service/src/main/java/com/vinod/b2b/repository/PurchaseOrderRepository.java`)
- API caller → Approval API: submits requests (evidence: `approval-service/src/main/java/com/vinod/b2b/controller/ApprovalController.java`)
- Approval API → Approval service: delegates (evidence: `approval-service/src/main/java/com/vinod/b2b/controller/ApprovalController.java`)
- Approval logic → Approval repository: saves and queries (evidence: `approval-service/src/main/java/com/vinod/b2b/serviceImpl/ApprovalServiceImpl.java`)
- Approval repository → Approval decisions: stores (evidence: `approval-service/src/main/java/com/vinod/b2b/repository/ApprovalRepository.java`)
- API caller → Supplier API: submits requests (evidence: `supplier-service/src/main/java/com/vinod/b2b/controller/SupplierController.java`)
- Supplier API → Supplier service: delegates (evidence: `supplier-service/src/main/java/com/vinod/b2b/controller/SupplierController.java`)
- Supplier logic → Supplier repository: persists suppliers (evidence: `supplier-service/src/main/java/com/vinod/b2b/serviceimpl/SupplierServiceImpl.java`)
- Supplier repository → Suppliers: stores (evidence: `supplier-service/src/main/java/com/vinod/b2b/repository/SupplierRepository.java`)
- Item repository → Inventory items: stores (evidence: `inventory-service/src/main/java/com/vinod/b2b/repository/InventoryItemsRepository.java`)
- Receipt repository → Inventory receipts: stores (evidence: `inventory-service/src/main/java/com/vinod/b2b/repository/InventoryReceiptsRepository.java`)
