# heinzdanner/shopserviceerweitert architecture

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

- Interactive diagram: https://gitdiagram.com/heinzdanner/shopserviceerweitert
- Repository: https://github.com/heinzdanner/shopserviceerweitert

## Overview

ShopService is a small Java shop-order application driven by commands in `transactions.txt`. Main reads the commands, delegates order creation and status updates to ShopService, and prints orders. Order creation validates requested quantities and stock, updates inventory, assigns an ID and stores a timestamped order. In-memory repositories hold products and orders; the map-backed order repository is selected by Main, while a list-backed alternative also exists. The graph reflects the excerpts and README; no persistent database or external service is shown.

Main entry points: [`src/main/java/ShopService.java`](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/ShopService.java) (Shop service), [`src/main/java/Main.java`](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/Main.java) (Command runner), [`src/main/java/Order.java`](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/Order.java) (Order record), [`src/main/java/OrderRepo.java`](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/OrderRepo.java) (Order repository API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Command runtime"]
  node_transactions["Transaction file<br/>[transactions.txt]"]
  node_main["Command runner<br/>[Main.java]"]
end

subgraph group_domain["Order domain"]
  node_service["Shop service<br/>[ShopService.java]"]
  node_ids["ID service<br/>[IdService.java]"]
  node_order["Order record<br/>[Order.java]"]
  node_item["Order item<br/>[OrderItem.java]"]
  node_status["Order status<br/>[OrderStatus.java]"]
  node_product["Product record<br/>[Product.java]"]
end

subgraph group_repositories["In-memory repositories"]
  node_productrepo[("Product repository<br/>[ProductRepo.java]")]
  node_orderrepo["Order repository API<br/>[OrderRepo.java]"]
  node_maprepo[("Map order store<br/>[OrderMapRepo.java]")]
  node_listrepo[("List order store<br/>[OrderListRepo.java]")]
end

node_operator(("Command author"))

node_operator -->|"writes commands"| node_transactions
node_main -->|"reads commands"| node_transactions
node_main -->|"dispatches orders"| node_service
node_main -->|"prints orders"| node_orderrepo
node_main -->|"looks up names"| node_productrepo
node_main -->|"selects implementation"| node_maprepo
node_service -->|"checks and updates stock"| node_productrepo
node_service -->|"stores and queries orders"| node_orderrepo
node_service -->|"generates ID"| node_ids
node_service -->|"creates order"| node_order
node_service -->|"validates items"| node_item
node_service -->|"creates updated product"| node_product
node_service -->|"sets initial status"| node_status
node_main -->|"parses quantities"| node_item
node_main -->|"parses status"| node_status
node_productrepo -->|"stores products"| node_product
node_maprepo -->|"implements"| node_orderrepo
node_listrepo -->|"implements"| node_orderrepo
node_maprepo -->|"stores orders"| node_order
node_listrepo -->|"stores orders"| node_order
node_order -->|"contains"| node_item
node_order -->|"has status"| node_status

click node_transactions "https://github.com/heinzdanner/shopserviceerweitert/blob/main/transactions.txt"
click node_main "https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/Main.java"
click node_service "https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/ShopService.java"
click node_ids "https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/IdService.java"
click node_order "https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/Order.java"
click node_item "https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/OrderItem.java"
click node_status "https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/OrderStatus.java"
click node_product "https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/Product.java"
click node_productrepo "https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/ProductRepo.java"
click node_orderrepo "https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/OrderRepo.java"
click node_maprepo "https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/OrderMapRepo.java"
click node_listrepo "https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/OrderListRepo.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_transactions,node_main toneBlue
class node_service,node_ids,node_order,node_item,node_status,node_product toneAmber
class node_productrepo,node_orderrepo,node_maprepo,node_listrepo toneMint
class node_operator toneIndigo
```

## Components

### Command runtime

- [Transaction file](https://github.com/heinzdanner/shopserviceerweitert/blob/main/transactions.txt): `transactions.txt`
- [Command runner](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/Main.java): `src/main/java/Main.java`

### Order domain

- [Shop service](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/ShopService.java): `src/main/java/ShopService.java`
- [ID service](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/IdService.java): `src/main/java/IdService.java`
- [Order record](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/Order.java): `src/main/java/Order.java`
- [Order item](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/OrderItem.java): `src/main/java/OrderItem.java`
- [Order status](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/OrderStatus.java): `src/main/java/OrderStatus.java`
- [Product record](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/Product.java): `src/main/java/Product.java`

### In-memory repositories

- [Product repository](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/ProductRepo.java): `src/main/java/ProductRepo.java`
- [Order repository API](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/OrderRepo.java): `src/main/java/OrderRepo.java`
- [Map order store](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/OrderMapRepo.java): `src/main/java/OrderMapRepo.java`
- [List order store](https://github.com/heinzdanner/shopserviceerweitert/blob/main/src/main/java/OrderListRepo.java): `src/main/java/OrderListRepo.java`

### Other components

- **Command author**

## Connections

- Command author → Transaction file: writes commands (evidence: `README.md`)
- Command runner → Transaction file: reads commands (evidence: `src/main/java/Main.java`)
- Command runner → Shop service: dispatches orders (evidence: `src/main/java/Main.java`)
- Command runner → Order repository API: prints orders (evidence: `src/main/java/Main.java`)
- Command runner → Product repository: looks up names (evidence: `src/main/java/Main.java`)
- Command runner → Map order store: selects implementation (evidence: `src/main/java/Main.java`)
- Shop service → Product repository: checks and updates stock (evidence: `src/main/java/ShopService.java`)
- Shop service → Order repository API: stores and queries orders (evidence: `src/main/java/ShopService.java`)
- Shop service → ID service: generates ID (evidence: `src/main/java/ShopService.java`)
- Shop service → Order record: creates order (evidence: `src/main/java/ShopService.java`)
- Shop service → Order item: validates items (evidence: `src/main/java/ShopService.java`)
- Shop service → Product record: creates updated product (evidence: `src/main/java/ShopService.java`)
- Shop service → Order status: sets initial status (evidence: `src/main/java/ShopService.java`)
- Command runner → Order item: parses quantities (evidence: `src/main/java/Main.java`)
- Command runner → Order status: parses status (evidence: `src/main/java/Main.java`)
- Product repository → Product record: stores products (evidence: `src/main/java/ProductRepo.java`)
- Map order store → Order repository API: implements (evidence: `src/main/java/OrderMapRepo.java`)
- List order store → Order repository API: implements (evidence: `src/main/java/OrderListRepo.java`)
- Map order store → Order record: stores orders (evidence: `src/main/java/OrderMapRepo.java`)
- List order store → Order record: stores orders (evidence: `src/main/java/OrderListRepo.java`)
- Order record → Order item: contains (evidence: `src/main/java/Order.java`)
- Order record → Order status: has status (evidence: `src/main/java/Order.java`)
