# shivanandappa/java-ci-cd-pipeline architecture

> Architecture diagram of the GitHub repository shivanandappa/java-ci-cd-pipeline, 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/shivanandappa/java-ci-cd-pipeline
- Repository: https://github.com/shivanandappa/java-ci-cd-pipeline

## Overview

The repository combines a Spring Boot status/root web application with a JavaFX Pac-Man game. The principal game workflow is player input and frame updates through the UI controller, game orchestration, movement/collision/ghost logic, and rendering of session state. The sampled sources establish the game’s service calls; web details and some supporting behavior are represented conservatively from the source index, which does not expose all implementations.

Main entry points: [`src/main/java/com/javawebapp/pacman/service/GameService.java`](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/GameService.java) (Game orchestration), [`src/main/java/com/javawebapp/pacman/ui/GameController.java`](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/ui/GameController.java) (Game controller), [`src/main/java/com/javawebapp/pacman/service/MapService.java`](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/MapService.java) (Map and spawns), [`src/main/java/com/javawebapp/pacman/service/MovementService.java`](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/MovementService.java) (Movement rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_springapp["Spring Boot app"]
  node_root["Root endpoint"]
  node_status["Status endpoint"]
  node_response["API response DTOs"]
  node_exception["Error handling"]
  node_info["App info"]
end

subgraph group_ui["Game interface"]
  node_launcher["Game launcher"]
  node_fxapp["JavaFX app"]
  node_controller["Game controller"]
  node_renderer["Game renderer<br/>[GameRenderer.java]"]
end

subgraph group_runtime["Game runtime"]
  node_game["Game orchestration<br/>[GameService.java]"]
  node_map["Map and spawns<br/>[MapService.java]"]
  node_movement["Movement rules"]
  node_collision["Collisions and pellets"]
  node_ghostai["Ghost AI"]
  node_score["High scores<br/>[ScoreService.java]"]
  node_properties["Game settings"]
end

subgraph group_domain["Game domain"]
  node_session["Game session<br/>[GameSession.java]"]
  node_entities["Player and ghosts"]
  node_tiles["Map tiles<br/>[TileType.java]"]
  node_direction["Directions<br/>[Direction.java]"]
end

node_user(("Player"))
node_webclient(("HTTP client"))

node_launcher -->|"launches"| node_fxapp
node_fxapp -->|"starts UI"| node_controller
node_user -.->|"plays"| node_controller
node_controller -->|"handles game"| node_game
node_controller -->|"renders frames"| node_renderer
node_controller -->|"reads high score"| node_score
node_game -->|"creates session"| node_map
node_game -->|"moves actors"| node_movement
node_game -->|"gets ghost direction"| node_ghostai
node_game -->|"checks collisions"| node_collision
node_game -->|"records score"| node_score
node_collision -->|"resets spawns"| node_map
node_movement -->|"checks walkability"| node_map
node_ghostai -->|"converts coordinates"| node_map
node_game -->|"updates state"| node_session
node_renderer -->|"reads state"| node_session
node_collision -->|"reads scoring values"| node_properties
node_movement -->|"reads speeds"| node_properties
node_game -->|"reads starting lives"| node_properties
node_webclient -.->|"requests page"| node_root
node_webclient -.->|"checks status"| node_status
node_status -->|"builds response"| node_response
node_springapp -.->|"registers contributor"| node_info

click node_springapp "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/JavaWebappApplication.java"
click node_root "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/controller/RootController.java"
click node_status "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/controller/StatusController.java"
click node_response "https://github.com/shivanandappa/java-ci-cd-pipeline/tree/main/src/main/java/com/javawebapp/dto"
click node_exception "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/exception/GlobalExceptionHandler.java"
click node_info "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/config/ApplicationInfoContributor.java"
click node_launcher "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/PacManLauncher.java"
click node_fxapp "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/PacManFxApplication.java"
click node_controller "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/ui/GameController.java"
click node_renderer "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/ui/GameRenderer.java"
click node_game "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/GameService.java"
click node_map "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/MapService.java"
click node_movement "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/MovementService.java"
click node_collision "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/CollisionService.java"
click node_ghostai "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/GhostAIService.java"
click node_score "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/ScoreService.java"
click node_properties "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/config/PacManProperties.java"
click node_session "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/model/GameSession.java"
click node_entities "https://github.com/shivanandappa/java-ci-cd-pipeline/tree/main/src/main/java/com/javawebapp/pacman/model"
click node_tiles "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/model/TileType.java"
click node_direction "https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/model/Direction.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_springapp,node_root,node_status,node_response,node_exception,node_info,node_webclient toneBlue
class node_launcher,node_fxapp,node_controller,node_renderer toneAmber
class node_game,node_map,node_movement,node_collision,node_ghostai,node_score,node_properties toneMint
class node_session,node_entities,node_tiles,node_direction toneRose
class node_user toneIndigo
```

## Components

### Web application

- [Spring Boot app](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/JavaWebappApplication.java): `src/main/java/com/javawebapp/JavaWebappApplication.java`
- [Root endpoint](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/controller/RootController.java): `src/main/java/com/javawebapp/controller/RootController.java`
- [Status endpoint](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/controller/StatusController.java): `src/main/java/com/javawebapp/controller/StatusController.java`
- [API response DTOs](https://github.com/shivanandappa/java-ci-cd-pipeline/tree/main/src/main/java/com/javawebapp/dto): `src/main/java/com/javawebapp/dto`
- [Error handling](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/exception/GlobalExceptionHandler.java): `src/main/java/com/javawebapp/exception/GlobalExceptionHandler.java`
- [App info](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/config/ApplicationInfoContributor.java): `src/main/java/com/javawebapp/config/ApplicationInfoContributor.java`

### Game interface

- [Game launcher](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/PacManLauncher.java): `src/main/java/com/javawebapp/pacman/PacManLauncher.java`
- [JavaFX app](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/PacManFxApplication.java): `src/main/java/com/javawebapp/pacman/PacManFxApplication.java`
- [Game controller](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/ui/GameController.java): `src/main/java/com/javawebapp/pacman/ui/GameController.java`
- [Game renderer](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/ui/GameRenderer.java): `src/main/java/com/javawebapp/pacman/ui/GameRenderer.java`

### Game runtime

- [Game orchestration](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/GameService.java): `src/main/java/com/javawebapp/pacman/service/GameService.java`
- [Map and spawns](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/MapService.java): `src/main/java/com/javawebapp/pacman/service/MapService.java`
- [Movement rules](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/MovementService.java): `src/main/java/com/javawebapp/pacman/service/MovementService.java`
- [Collisions and pellets](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/CollisionService.java): `src/main/java/com/javawebapp/pacman/service/CollisionService.java`
- [Ghost AI](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/GhostAIService.java): `src/main/java/com/javawebapp/pacman/service/GhostAIService.java`
- [High scores](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/service/ScoreService.java): `src/main/java/com/javawebapp/pacman/service/ScoreService.java`
- [Game settings](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/config/PacManProperties.java): `src/main/java/com/javawebapp/pacman/config/PacManProperties.java`

### Game domain

- [Game session](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/model/GameSession.java): `src/main/java/com/javawebapp/pacman/model/GameSession.java`
- [Player and ghosts](https://github.com/shivanandappa/java-ci-cd-pipeline/tree/main/src/main/java/com/javawebapp/pacman/model): `src/main/java/com/javawebapp/pacman/model`
- [Map tiles](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/model/TileType.java): `src/main/java/com/javawebapp/pacman/model/TileType.java`
- [Directions](https://github.com/shivanandappa/java-ci-cd-pipeline/blob/main/src/main/java/com/javawebapp/pacman/model/Direction.java): `src/main/java/com/javawebapp/pacman/model/Direction.java`

### Other components

- **Player**
- **HTTP client**

## Connections

- Game launcher → JavaFX app: launches (evidence: `src/main/java/com/javawebapp/pacman/PacManLauncher.java`)
- JavaFX app → Game controller: starts UI (evidence: `src/main/java/com/javawebapp/pacman/PacManFxApplication.java`)
- Player → Game controller: plays
- Game controller → Game orchestration: handles game (evidence: `src/main/java/com/javawebapp/pacman/ui/GameController.java`)
- Game controller → Game renderer: renders frames (evidence: `src/main/java/com/javawebapp/pacman/ui/GameController.java`)
- Game controller → High scores: reads high score (evidence: `src/main/java/com/javawebapp/pacman/ui/GameController.java`)
- Game orchestration → Map and spawns: creates session (evidence: `src/main/java/com/javawebapp/pacman/service/GameService.java`)
- Game orchestration → Movement rules: moves actors (evidence: `src/main/java/com/javawebapp/pacman/service/GameService.java`)
- Game orchestration → Ghost AI: gets ghost direction (evidence: `src/main/java/com/javawebapp/pacman/service/GameService.java`)
- Game orchestration → Collisions and pellets: checks collisions (evidence: `src/main/java/com/javawebapp/pacman/service/GameService.java`)
- Game orchestration → High scores: records score (evidence: `src/main/java/com/javawebapp/pacman/service/GameService.java`)
- Collisions and pellets → Map and spawns: resets spawns (evidence: `src/main/java/com/javawebapp/pacman/service/CollisionService.java`)
- Movement rules → Map and spawns: checks walkability (evidence: `src/main/java/com/javawebapp/pacman/service/MovementService.java`)
- Ghost AI → Map and spawns: converts coordinates (evidence: `src/main/java/com/javawebapp/pacman/service/GhostAIService.java`)
- Game orchestration → Game session: updates state (evidence: `src/main/java/com/javawebapp/pacman/service/GameService.java`)
- Game renderer → Game session: reads state (evidence: `src/main/java/com/javawebapp/pacman/ui/GameRenderer.java`)
- Collisions and pellets → Game settings: reads scoring values (evidence: `src/main/java/com/javawebapp/pacman/service/CollisionService.java`)
- Movement rules → Game settings: reads speeds (evidence: `src/main/java/com/javawebapp/pacman/service/MovementService.java`)
- Game orchestration → Game settings: reads starting lives (evidence: `src/main/java/com/javawebapp/pacman/service/GameService.java`)
- HTTP client → Root endpoint: requests page
- HTTP client → Status endpoint: checks status
- Status endpoint → API response DTOs: builds response (evidence: `src/main/java/com/javawebapp/controller/StatusController.java`)
- Spring Boot app → App info: registers contributor
