# jonish96/java-engineering-labs architecture

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

- Interactive diagram: https://gitdiagram.com/jonish96/java-engineering-labs
- Repository: https://github.com/jonish96/java-engineering-labs

## Overview

This repository is a small Java learning project, not a connected web application: it contains a standalone order-management demo, a Spring Boot application entry point, and a separate HashMap example. In the order workflow, the demo creates and queries orders through OrderService; the service creates Order objects and reads or writes them through an in-memory repository. Order enforces lifecycle rules using OrderStatus and can reject invalid operations. The excerpts establish these calls; the Spring entry point’s connection to the order demo is not shown.

Main entry points: [`src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/service/OrderService.java`](https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/service/OrderService.java) (Order Service), [`src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderManagementDemo.java`](https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderManagementDemo.java) (Order Demo), [`src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderRepository/OrderRepository.java`](https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderRepository/OrderRepository.java) (In-Memory Repository), [`src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/model/Order.java`](https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/model/Order.java) (Order Lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_order["Order Management"]
  node_order_demo["Order Demo"]
  node_order_service["Order Service<br/>[OrderService.java]"]
  node_order_repo[("In-Memory Repository")]
  node_order_model["Order Lifecycle<br/>[Order.java]"]
  node_order_status["Order Statuses<br/>[OrderStatus.java]"]
  node_not_found["Missing Order Error"]
end

subgraph group_runtime["Application Runtime"]
  node_spring_launcher["Spring Boot Launcher"]
end

subgraph group_learning["Java Examples"]
  node_hashmap_example["HashMap Example<br/>[HashMapBasics.java]"]
end

node_demo_user(("Demo Runner"))
node_java_user(("Example Runner"))

node_demo_user -->|"runs"| node_order_demo
node_order_demo -->|"calls"| node_order_service
node_order_demo -->|"constructs"| node_order_repo
node_order_service -->|"reads and saves"| node_order_repo
node_order_service -->|"creates and transitions"| node_order_model
node_order_service -->|"throws"| node_not_found
node_order_repo -->|"stores"| node_order_model
node_order_model -->|"uses"| node_order_status
node_java_user -->|"starts"| node_spring_launcher
node_java_user -->|"runs"| node_hashmap_example

click node_order_demo "https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderManagementDemo.java"
click node_order_service "https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/service/OrderService.java"
click node_order_repo "https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderRepository/OrderRepository.java"
click node_order_model "https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/model/Order.java"
click node_order_status "https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/enums/OrderStatus.java"
click node_not_found "https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/exception/OrderNotFoundException.java"
click node_spring_launcher "https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/JavaEngineeringLabsApplication.java"
click node_hashmap_example "https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/collections/HashMapBasics.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_order_demo,node_order_service,node_order_repo,node_order_model,node_order_status,node_not_found toneBlue
class node_spring_launcher toneAmber
class node_hashmap_example toneMint
class node_demo_user,node_java_user toneIndigo
```

## Components

### Order Management

- [Order Demo](https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderManagementDemo.java): `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderManagementDemo.java`
- [Order Service](https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/service/OrderService.java): `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/service/OrderService.java`
- [In-Memory Repository](https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderRepository/OrderRepository.java): `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderRepository/OrderRepository.java`
- [Order Lifecycle](https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/model/Order.java): `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/model/Order.java`
- [Order Statuses](https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/enums/OrderStatus.java): `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/enums/OrderStatus.java`
- [Missing Order Error](https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/exception/OrderNotFoundException.java): `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/exception/OrderNotFoundException.java`

### Application Runtime

- [Spring Boot Launcher](https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/JavaEngineeringLabsApplication.java): `src/main/java/com/paryogsaala/javaengineeringlabs/JavaEngineeringLabsApplication.java`

### Java Examples

- [HashMap Example](https://github.com/jonish96/java-engineering-labs/blob/main/src/main/java/com/paryogsaala/javaengineeringlabs/collections/HashMapBasics.java): `src/main/java/com/paryogsaala/javaengineeringlabs/collections/HashMapBasics.java`

### Other components

- **Demo Runner**
- **Example Runner**

## Connections

- Demo Runner → Order Demo: runs (evidence: `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderManagementDemo.java`)
- Order Demo → Order Service: calls (evidence: `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderManagementDemo.java`)
- Order Demo → In-Memory Repository: constructs (evidence: `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderManagementDemo.java`)
- Order Service → In-Memory Repository: reads and saves (evidence: `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/service/OrderService.java`)
- Order Service → Order Lifecycle: creates and transitions (evidence: `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/service/OrderService.java`)
- Order Service → Missing Order Error: throws (evidence: `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/service/OrderService.java`)
- In-Memory Repository → Order Lifecycle: stores (evidence: `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/OrderRepository/OrderRepository.java`)
- Order Lifecycle → Order Statuses: uses (evidence: `src/main/java/com/paryogsaala/javaengineeringlabs/ordermanagement/model/Order.java`)
- Example Runner → Spring Boot Launcher: starts (evidence: `src/main/java/com/paryogsaala/javaengineeringlabs/JavaEngineeringLabsApplication.java`)
- Example Runner → HashMap Example: runs (evidence: `src/main/java/com/paryogsaala/javaengineeringlabs/collections/HashMapBasics.java`)
