# microsoft/partsunlimitedmrp architecture

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

## Overview

Parts Unlimited MRP is a web-based ordering application with a Java order service and a separate integration service. Users work through the web client to manage catalog, dealer, quote, order, and shipment information; the order service selects memory or MongoDB repositories. The integration service processes website messages through scheduled tasks and queue services, then calls MRP endpoints. The README documents the front-end and service roles; edges involving unsampled controllers or integrations are limited to documented or indexed relationships.

Main entry points: [`src/Clients/Web`](https://github.com/microsoft/partsunlimitedmrp/tree/master/src/Clients/Web) (Web interface), [`src/Backend/OrderService/src/main/java/smpl/ordering/repositories/RepositoryFactory.java`](https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/repositories/RepositoryFactory.java) (Repository selection), [`src/Backend/IntegrationService/src/main/java/integration/services/MrpConnectService.java`](https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/IntegrationService/src/main/java/integration/services/MrpConnectService.java) (MRP REST client), [`src/Backend/IntegrationService/src/main/java/integration/services/QueueService.java`](https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/IntegrationService/src/main/java/integration/services/QueueService.java) (Queue handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_web["Web interface"]
end

subgraph group_ordering["Order service"]
  node_catalog["Catalog API"]
  node_dealers["Dealer API"]
  node_quotes["Quote API"]
  node_orders["Order API"]
  node_shipments["Shipment API"]
  node_repositories["Repository selection"]
  node_repo_interfaces["Repository contracts"]
  node_mongo["Mongo repositories"]
end

subgraph group_integration["Integration service"]
  node_integration_main["Integration runner<br/>[Main.java]"]
  node_tasks["Scheduled processors"]
  node_queue_service["Queue handling<br/>[QueueService.java]"]
  node_mrp_client["MRP REST client"]
end

subgraph group_external["External systems"]
  node_mongodb[("MongoDB")]
  node_website["Parts Unlimited website"]
  node_azure_queue["Azure queue"]
end

node_user(("MRP user"))

node_user -->|"uses"| node_web
node_web -->|"HTTP requests"| node_catalog
node_web -->|"HTTP requests"| node_dealers
node_web -->|"HTTP requests"| node_quotes
node_web -->|"HTTP requests"| node_orders
node_web -->|"HTTP requests"| node_shipments
node_dealers -->|"selects repository"| node_repositories
node_orders -->|"selects repository"| node_repositories
node_shipments -->|"selects repository"| node_repositories
node_repositories -->|"returns implementations"| node_repo_interfaces
node_repositories -->|"constructs"| node_mongo
node_mongo -->|"reads and writes"| node_mongodb
node_integration_main -->|"references tasks"| node_tasks
node_tasks -.->|"dispatches messages"| node_queue_service
node_queue_service -->|"retrieves and enqueues"| node_azure_queue
node_queue_service -->|"uses MRP client"| node_mrp_client
node_mrp_client -->|"posts order data"| node_orders
node_mrp_client -->|"posts quote data"| node_quotes
node_mrp_client -->|"posts shipment data"| node_shipments
node_website -.->|"supplies messages"| node_azure_queue

click node_web "https://github.com/microsoft/partsunlimitedmrp/tree/master/src/Clients/Web"
click node_catalog "https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/controllers/CatalogController.java"
click node_dealers "https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/controllers/DealerController.java"
click node_quotes "https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/controllers/QuoteController.java"
click node_orders "https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/controllers/OrderController.java"
click node_shipments "https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/controllers/ShipmentController.java"
click node_repositories "https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/repositories/RepositoryFactory.java"
click node_repo_interfaces "https://github.com/microsoft/partsunlimitedmrp/tree/master/src/Backend/OrderService/src/main/java/smpl/ordering/repositories"
click node_mongo "https://github.com/microsoft/partsunlimitedmrp/tree/master/src/Backend/OrderService/src/main/java/smpl/ordering/repositories/mongodb"
click node_integration_main "https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/IntegrationService/src/main/java/integration/Main.java"
click node_tasks "https://github.com/microsoft/partsunlimitedmrp/tree/master/src/Backend/IntegrationService/src/main/java/integration/scheduled"
click node_queue_service "https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/IntegrationService/src/main/java/integration/services/QueueService.java"
click node_mrp_client "https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/IntegrationService/src/main/java/integration/services/MrpConnectService.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_web,node_user toneBlue
class node_catalog,node_dealers,node_quotes,node_orders,node_shipments,node_repositories,node_repo_interfaces,node_mongo toneAmber
class node_integration_main,node_tasks,node_queue_service,node_mrp_client toneMint
class node_mongodb,node_website,node_azure_queue toneRose
```

## Components

### Web client

- [Web interface](https://github.com/microsoft/partsunlimitedmrp/tree/master/src/Clients/Web): `src/Clients/Web`

### Order service

- [Catalog API](https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/controllers/CatalogController.java): `src/Backend/OrderService/src/main/java/smpl/ordering/controllers/CatalogController.java`
- [Dealer API](https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/controllers/DealerController.java): `src/Backend/OrderService/src/main/java/smpl/ordering/controllers/DealerController.java`
- [Quote API](https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/controllers/QuoteController.java): `src/Backend/OrderService/src/main/java/smpl/ordering/controllers/QuoteController.java`
- [Order API](https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/controllers/OrderController.java): `src/Backend/OrderService/src/main/java/smpl/ordering/controllers/OrderController.java`
- [Shipment API](https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/controllers/ShipmentController.java): `src/Backend/OrderService/src/main/java/smpl/ordering/controllers/ShipmentController.java`
- [Repository selection](https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/OrderService/src/main/java/smpl/ordering/repositories/RepositoryFactory.java): `src/Backend/OrderService/src/main/java/smpl/ordering/repositories/RepositoryFactory.java`
- [Repository contracts](https://github.com/microsoft/partsunlimitedmrp/tree/master/src/Backend/OrderService/src/main/java/smpl/ordering/repositories): `src/Backend/OrderService/src/main/java/smpl/ordering/repositories`
- [Mongo repositories](https://github.com/microsoft/partsunlimitedmrp/tree/master/src/Backend/OrderService/src/main/java/smpl/ordering/repositories/mongodb): `src/Backend/OrderService/src/main/java/smpl/ordering/repositories/mongodb`

### Integration service

- [Integration runner](https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/IntegrationService/src/main/java/integration/Main.java): `src/Backend/IntegrationService/src/main/java/integration/Main.java`
- [Scheduled processors](https://github.com/microsoft/partsunlimitedmrp/tree/master/src/Backend/IntegrationService/src/main/java/integration/scheduled): `src/Backend/IntegrationService/src/main/java/integration/scheduled`
- [Queue handling](https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/IntegrationService/src/main/java/integration/services/QueueService.java): `src/Backend/IntegrationService/src/main/java/integration/services/QueueService.java`
- [MRP REST client](https://github.com/microsoft/partsunlimitedmrp/blob/master/src/Backend/IntegrationService/src/main/java/integration/services/MrpConnectService.java): `src/Backend/IntegrationService/src/main/java/integration/services/MrpConnectService.java`

### External systems

- **MongoDB**
- **Parts Unlimited website**
- **Azure queue**

### Other components

- **MRP user**

## Connections

- MRP user → Web interface: uses (evidence: `README.md`)
- Web interface → Catalog API: HTTP requests (evidence: `README.md`)
- Web interface → Dealer API: HTTP requests (evidence: `README.md`)
- Web interface → Quote API: HTTP requests (evidence: `README.md`)
- Web interface → Order API: HTTP requests (evidence: `README.md`)
- Web interface → Shipment API: HTTP requests (evidence: `README.md`)
- Dealer API → Repository selection: selects repository (evidence: `src/Backend/OrderService/src/main/java/smpl/ordering/controllers/DealerController.java`)
- Order API → Repository selection: selects repository (evidence: `src/Backend/OrderService/src/main/java/smpl/ordering/controllers/OrderController.java`)
- Shipment API → Repository selection: selects repository (evidence: `src/Backend/OrderService/src/main/java/smpl/ordering/controllers/ShipmentController.java`)
- Repository selection → Repository contracts: returns implementations (evidence: `src/Backend/OrderService/src/main/java/smpl/ordering/repositories/RepositoryFactory.java`)
- Repository selection → Mongo repositories: constructs (evidence: `src/Backend/OrderService/src/main/java/smpl/ordering/repositories/RepositoryFactory.java`)
- Mongo repositories → MongoDB: reads and writes (evidence: `src/Backend/OrderService/src/main/java/smpl/ordering/repositories/mongodb/MongoOrderRepository.java`)
- Integration runner → Scheduled processors: references tasks (evidence: `src/Backend/IntegrationService/src/main/java/integration/Main.java`)
- Scheduled processors → Queue handling: dispatches messages
- Queue handling → Azure queue: retrieves and enqueues (evidence: `src/Backend/IntegrationService/src/main/java/integration/services/QueueService.java`)
- Queue handling → MRP REST client: uses MRP client (evidence: `src/Backend/IntegrationService/src/main/java/integration/services/QueueService.java`)
- MRP REST client → Order API: posts order data (evidence: `src/Backend/IntegrationService/src/main/java/integration/services/MrpConnectService.java`)
- MRP REST client → Quote API: posts quote data (evidence: `src/Backend/IntegrationService/src/main/java/integration/services/MrpConnectService.java`)
- MRP REST client → Shipment API: posts shipment data (evidence: `src/Backend/IntegrationService/src/main/java/integration/services/MrpConnectService.java`)
- Parts Unlimited website → Azure queue: supplies messages
