# mervekardes/shopservice architecture

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

## Overview

ShopService is a small Java shop and inventory application. Its main workflow is to assemble product and order repositories plus an ID generator, then use ShopService to look up products, create orders, check and reduce stock, and persist orders. The service also manages order status and quantity changes, filters orders, finds the oldest order per status, and handles stock receipts and removals. Orders contain priced product quantities and timestamps. The README documents these capabilities; the graph shows the main runtime relationships evidenced by the sampled source and index.

Main entry points: [`src/main/java/de/mervekardes/ShopService.java`](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/ShopService.java) (Shop service), [`src/main/java/de/mervekardes/Main.java`](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/Main.java) (Application setup), [`src/main/java/de/mervekardes/Order.java`](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/Order.java) (Order), [`src/main/java/de/mervekardes/OrderRepo.java`](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/OrderRepo.java) (Order repository API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Application and services"]
  node_main["Application setup<br/>[Main.java]"]
  node_service["Shop service<br/>[ShopService.java]"]
  node_ids["Order ID service<br/>[IdService.java]"]
end

subgraph group_inventory["Products and inventory"]
  node_product["Product<br/>[Product.java]"]
  node_productrepo[("Product repository<br/>[ProductRepo.java]")]
  node_missing["Missing product error"]
end

subgraph group_orders["Orders and persistence"]
  node_order["Order<br/>[Order.java]"]
  node_item["Order item<br/>[OrderItem.java]"]
  node_status["Order status<br/>[OrderStatus.java]"]
  node_orderapi["Order repository API<br/>[OrderRepo.java]"]
  node_maprepo[("Map order store<br/>[OrderMapRepo.java]")]
  node_listrepo[("List order store<br/>[OrderListRepo.java]")]
end

node_user(("Shop operator"))

node_user -.->|"starts"| node_main
node_main -->|"creates"| node_productrepo
node_main -->|"seeds products"| node_product
node_main -->|"selects"| node_maprepo
node_main -->|"provides"| node_ids
node_main -->|"constructs"| node_service
node_service -->|"looks up"| node_productrepo
node_service -->|"reads and writes"| node_orderapi
node_service -->|"generates IDs"| node_ids
node_service -->|"creates and edits"| node_item
node_service -->|"creates and updates"| node_order
node_service -->|"filters and assigns"| node_status
node_service -->|"throws"| node_missing
node_productrepo -->|"stores"| node_product
node_orderapi -->|"operates on"| node_order
node_maprepo -->|"implements"| node_orderapi
node_listrepo -->|"implements"| node_orderapi
node_order -->|"contains"| node_item
node_order -->|"records"| node_status
node_item -->|"references"| node_product

click node_main "https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/Main.java"
click node_service "https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/ShopService.java"
click node_ids "https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/IdService.java"
click node_product "https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/Product.java"
click node_productrepo "https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/ProductRepo.java"
click node_missing "https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/ProductNotFoundException.java"
click node_order "https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/Order.java"
click node_item "https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/OrderItem.java"
click node_status "https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/OrderStatus.java"
click node_orderapi "https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/OrderRepo.java"
click node_maprepo "https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/OrderMapRepo.java"
click node_listrepo "https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/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_main,node_service,node_ids toneBlue
class node_product,node_productrepo,node_missing toneAmber
class node_order,node_item,node_status,node_orderapi,node_maprepo,node_listrepo toneMint
class node_user toneIndigo
```

## Components

### Application and services

- [Application setup](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/Main.java): `src/main/java/de/mervekardes/Main.java`
- [Shop service](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/ShopService.java): `src/main/java/de/mervekardes/ShopService.java`
- [Order ID service](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/IdService.java): `src/main/java/de/mervekardes/IdService.java`

### Products and inventory

- [Product](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/Product.java): `src/main/java/de/mervekardes/Product.java`
- [Product repository](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/ProductRepo.java): `src/main/java/de/mervekardes/ProductRepo.java`
- [Missing product error](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/ProductNotFoundException.java): `src/main/java/de/mervekardes/ProductNotFoundException.java`

### Orders and persistence

- [Order](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/Order.java): `src/main/java/de/mervekardes/Order.java`
- [Order item](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/OrderItem.java): `src/main/java/de/mervekardes/OrderItem.java`
- [Order status](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/OrderStatus.java): `src/main/java/de/mervekardes/OrderStatus.java`
- [Order repository API](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/OrderRepo.java): `src/main/java/de/mervekardes/OrderRepo.java`
- [Map order store](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/OrderMapRepo.java): `src/main/java/de/mervekardes/OrderMapRepo.java`
- [List order store](https://github.com/mervekardes/shopservice/blob/main/src/main/java/de/mervekardes/OrderListRepo.java): `src/main/java/de/mervekardes/OrderListRepo.java`

### Other components

- **Shop operator**

## Connections

- Shop operator → Application setup: starts
- Application setup → Product repository: creates (evidence: `src/main/java/de/mervekardes/Main.java`)
- Application setup → Product: seeds products (evidence: `src/main/java/de/mervekardes/Main.java`)
- Application setup → Map order store: selects (evidence: `src/main/java/de/mervekardes/Main.java`)
- Application setup → Order ID service: provides (evidence: `src/main/java/de/mervekardes/Main.java`)
- Application setup → Shop service: constructs (evidence: `src/main/java/de/mervekardes/Main.java`)
- Shop service → Product repository: looks up (evidence: `src/main/java/de/mervekardes/ShopService.java`)
- Shop service → Order repository API: reads and writes (evidence: `src/main/java/de/mervekardes/ShopService.java`)
- Shop service → Order ID service: generates IDs (evidence: `src/main/java/de/mervekardes/ShopService.java`)
- Shop service → Order item: creates and edits (evidence: `src/main/java/de/mervekardes/ShopService.java`)
- Shop service → Order: creates and updates (evidence: `src/main/java/de/mervekardes/ShopService.java`)
- Shop service → Order status: filters and assigns (evidence: `src/main/java/de/mervekardes/ShopService.java`)
- Shop service → Missing product error: throws (evidence: `src/main/java/de/mervekardes/ShopService.java`)
- Product repository → Product: stores (evidence: `src/main/java/de/mervekardes/ProductRepo.java`)
- Order repository API → Order: operates on (evidence: `src/main/java/de/mervekardes/OrderRepo.java`)
- Map order store → Order repository API: implements (evidence: `src/main/java/de/mervekardes/OrderMapRepo.java`)
- List order store → Order repository API: implements (evidence: `src/main/java/de/mervekardes/OrderListRepo.java`)
- Order → Order item: contains (evidence: `src/main/java/de/mervekardes/Order.java`)
- Order → Order status: records (evidence: `src/main/java/de/mervekardes/Order.java`)
- Order item → Product: references (evidence: `src/main/java/de/mervekardes/OrderItem.java`)
