# zum-it/vms architecture

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

- Interactive diagram: https://gitdiagram.com/zum-it/vms
- Repository: https://github.com/zum-it/vms

## Overview

1. **What this repo is**
   - A single-service Java application for a **Visitor Management System (VMS)**.
   - The structure is typical of a **Spring Boot monolith** with layered HTTP, domain, repository, and utility packages.

2. **Application entrypoint and runtime**
   - `com.zum.vms.VmsApplication` is the bootstrapping class.
   - The build is Maven-based (`pom.xml`, `mvnw`, Maven wrapper), so the app is designed to run as a packaged Java service.
   - Docker support is built in via `Dockerfile` and `docker-compose.yml`.

3. **Core business model**
   - The main domain concepts are:
     - `Company`
     - `Domain`
     - `Office`
   - These live under `model/domain` and represent the business data the system manages.
   - The overall system name and model suggest these entities form the organizational hierarchy used to manage visitors by company/domain/office context.

4. **Persistence boundary**
   - `repository/CompanyRepository`, `DomainRepository`, and `OfficeRepository` form the data-access layer.
   - This is the boundary between the application and the backing database.
   - Database initialization is externalized into SQL scripts:
     - `scripts/01_schema.sql`
     - `scripts/02_data.sql`
   - That suggests the schema and seed data are provisioned separately from application code.

5. **HTTP/API layer**
   - There are two controller packages:
     - `ctrl/*Controller.java`
     - `web/*WebController.java`
   - This strongly suggests two presentation modes:
     - one set of controllers for programmatic HTTP access / CRUD endpoints
     - one set for browser-facing web pages or server-rendered views
   - The split is important for the architecture diagram because it shows the app exposes the same domain through distinct interface layers.

6. **Shared CRUD abstraction**
   - `service/CrudController.java` appears to be a shared abstraction for controller behavior rather than a classic service implementation.
   - That implies controller logic is standardized around CRUD operations and likely reused across the entity-specific controllers.

7. **DTO and mapping layer**
   - The `model/dto` package contains `CompanyDto`, `DomainDto`, `OfficeDto`, plus `Identifiable`.
   - DTOs indicate the app does not expose domain entities directly everywhere; it has a separate transport shape.
   - `util/MapperUtils` is likely responsible for converting between domain entities and DTOs, which is a key transformation boundary in the request/response flow.

8. **Business rules and helper utilities**
   - `util/CompanyUtils` and `util/PaginationUtils` hold reusable domain/helper logic.
   - `PaginationUtils` suggests list endpoints are paginated.
   - `CompanyUtils` likely contains company-specific validation or lookup behavior that is shared across controllers.

9. **Error handling**
   - Two explicit exception types define the main failure modes:
     - `ResourceAlreadyExists`
     - `ResourceNotFoundException`
   - This gives the API a clear conflict/not-found boundary for CRUD operations.
   - In a diagram, these are downstream from controllers and repositories, used when requested entities cannot be created or retrieved.

10. **Web request normalization**
    - `config/TrailingSlashRedirectFilter.java` is a request filter that normalizes URLs with trailing slashes.
    - This is a small but important HTTP boundary component because it affects how all incoming requests are routed.

11. **Configuration and environment**
    - `src/main/resources/application.properties` plus environment-specific configs:
      - `application-test.properties`
      - `application-docker.properties`
    - `vms-config.xml` indicates there is also XML-based configuration in the application.
    - The repo includes `.env`, which suggests environment-driven configuration in containerized or deployed runs.

12. **Testing and CI/CD**
    - There is at least one test class: `VmsApplicationTests`.
    - GitHub Actions workflows exist for:
      - `test.yaml`
      - `docker-deploy.yaml`
    - So the delivery flow is automated: build/test in CI, then container deploy.

13. **Operational artifacts**
    - `manage.sh`, `start.cmd`, and `stop.cmd` indicate local/runtime lifecycle helpers.
    - The presence of Docker Compose plus scripts implies the system can be run both locally and in containerized environments with minimal setup.

14. **How the data flows end to end**
    - A request enters through a controller or web controller.
    - The controller uses DTOs and utility mappers to translate input/output.
    - It reads or writes entities through the repository layer.
    - Repository operations hit the database initialized from SQL scripts.
    - Errors are surfaced through the custom exception types, while pagination and trailing-slash handling shape request behavior before/around controller execution.

Main entry points: [`src/main/java/com/zum/vms/ctrl/CompanyController.java`](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/ctrl/CompanyController.java) (API controllers), [`src/main/java/com/zum/vms/web/CompanyWebController.java`](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/web/CompanyWebController.java) (Web controllers), [`src/main/java/com/zum/vms/util/MapperUtils.java`](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/util/MapperUtils.java) (Mapper utils), [`src/main/java/com/zum/vms/repository/CompanyRepository.java`](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/repository/CompanyRepository.java) (Company repo)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime"]
  node_app(("VMS app<br/>Spring Boot entrypoint"))
end

subgraph group_presentation["Presentation"]
  node_api_ctrl["API controllers<br/>HTTP CRUD"]
  node_web_ctrl["Web controllers<br/>Server views"]
  node_crud_base["CRUD base<br/>Controller abstraction"]
end

subgraph group_domain["Domain"]
  node_company{{"Company<br/>Domain entity<br/>[Company.java]"}}
  node_domain_entity{{"Domain<br/>[Domain.java]"}}
  node_office{{"Office<br/>Domain entity<br/>[Office.java]"}}
  node_company_dto["Company DTO<br/>Transport model<br/>[CompanyDto.java]"]
  node_domain_dto["Domain DTO<br/>Transport model<br/>[DomainDto.java]"]
  node_office_dto["Office DTO<br/>Transport model<br/>[OfficeDto.java]"]
  node_identifiable["Identifiable<br/>DTO contract<br/>[Identifiable.java]"]
end

subgraph group_persistence["Persistence"]
  node_company_repo[("Company repo")]
  node_domain_repo[("Domain repo")]
  node_office_repo[("Office repo")]
  node_schema["Schema script<br/>SQL init<br/>[01_schema.sql]"]
  node_seed["Seed data<br/>SQL init<br/>[02_data.sql]"]
end

subgraph group_support["Support"]
  node_mapper["Mapper utils<br/>DTO mapping<br/>[MapperUtils.java]"]
  node_company_utils["Company utils<br/>Business helper<br/>[CompanyUtils.java]"]
  node_pagination["Pagination<br/>List helper"]
  node_trail_filter["Slash filter<br/>HTTP filter"]
  node_notfound["Not found<br/>Exception"]
  node_exists["Already exists<br/>Exception"]
  node_app_props["App config<br/>Runtime config"]
  node_docker_props["Docker config<br/>Runtime config"]
  node_test_props["Test config<br/>Runtime config"]
  node_xml_cfg["XML config<br/>Legacy config<br/>[vms-config.xml]"]
end

subgraph group_delivery["Delivery"]
  node_dockerfile["Dockerfile<br/>Container build"]
  node_compose["Compose<br/>Local runtime<br/>[docker-compose.yml]"]
  node_ci_test["Test workflow<br/>CI pipeline<br/>[test.yaml]"]
  node_ci_deploy["Deploy workflow<br/>CD pipeline<br/>[docker-deploy.yaml]"]
  node_wrapper["Maven wrapper<br/>Build tooling"]
  node_pom["Maven pom<br/>Build descriptor<br/>[pom.xml]"]
  node_ops["Ops scripts<br/>Lifecycle scripts<br/>[manage.sh]"]
end

node_app -->|"starts"| node_api_ctrl
node_app -->|"starts"| node_web_ctrl
node_api_ctrl -->|"uses"| node_crud_base
node_web_ctrl -->|"uses"| node_crud_base
node_api_ctrl -->|"maps"| node_mapper
node_web_ctrl -->|"maps"| node_mapper
node_api_ctrl -->|"reads/writes"| node_company_repo
node_api_ctrl -->|"reads/writes"| node_domain_repo
node_api_ctrl -->|"reads/writes"| node_office_repo
node_web_ctrl -->|"reads/writes"| node_company_repo
node_web_ctrl -->|"reads/writes"| node_domain_repo
node_web_ctrl -->|"reads/writes"| node_office_repo
node_company_repo -->|"stores"| node_company
node_domain_repo -->|"stores"| node_domain_entity
node_office_repo -->|"stores"| node_office
node_mapper -->|"produces"| node_company_dto
node_mapper -->|"produces"| node_domain_dto
node_mapper -->|"produces"| node_office_dto
node_company_dto -->|"implements"| node_identifiable
node_domain_dto -->|"implements"| node_identifiable
node_office_dto -->|"implements"| node_identifiable
node_company_utils -->|"supports"| node_company
node_pagination -->|"supports"| node_api_ctrl
node_trail_filter -->|"preprocesses"| node_api_ctrl
node_trail_filter -->|"preprocesses"| node_web_ctrl
node_api_ctrl -->|"throws"| node_notfound
node_api_ctrl -->|"throws"| node_exists
node_web_ctrl -->|"throws"| node_notfound
node_web_ctrl -->|"throws"| node_exists
node_schema -.->|"supports"| node_company_repo
node_seed -.->|"supports"| node_company_repo
node_app_props -.->|"configures"| node_app
node_docker_props -.->|"configures"| node_compose
node_test_props -.->|"configures"| node_ci_test
node_xml_cfg -.->|"configures"| node_app
node_pom -.->|"drives"| node_wrapper
node_pom -.->|"builds"| node_dockerfile
node_dockerfile -.->|"used by"| node_compose
node_ci_test -.->|"uses"| node_pom
node_ci_deploy -.->|"uses"| node_dockerfile
node_ops -.->|"orchestrates"| node_compose

click node_app "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/VmsApplication.java"
click node_api_ctrl "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/ctrl/CompanyController.java"
click node_web_ctrl "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/web/CompanyWebController.java"
click node_crud_base "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/service/CrudController.java"
click node_company "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/domain/Company.java"
click node_domain_entity "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/domain/Domain.java"
click node_office "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/domain/Office.java"
click node_company_dto "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/dto/CompanyDto.java"
click node_domain_dto "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/dto/DomainDto.java"
click node_office_dto "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/dto/OfficeDto.java"
click node_identifiable "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/dto/Identifiable.java"
click node_company_repo "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/repository/CompanyRepository.java"
click node_domain_repo "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/repository/DomainRepository.java"
click node_office_repo "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/repository/OfficeRepository.java"
click node_schema "https://github.com/zum-it/vms/blob/main/scripts/01_schema.sql"
click node_seed "https://github.com/zum-it/vms/blob/main/scripts/02_data.sql"
click node_mapper "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/util/MapperUtils.java"
click node_company_utils "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/util/CompanyUtils.java"
click node_pagination "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/util/PaginationUtils.java"
click node_trail_filter "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/config/TrailingSlashRedirectFilter.java"
click node_notfound "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/exception/ResourceNotFoundException.java"
click node_exists "https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/exception/ResourceAlreadyExists.java"
click node_app_props "https://github.com/zum-it/vms/blob/main/src/main/resources/application.properties"
click node_docker_props "https://github.com/zum-it/vms/blob/main/src/main/resources/application-docker.properties"
click node_test_props "https://github.com/zum-it/vms/blob/main/src/main/resources/application-test.properties"
click node_xml_cfg "https://github.com/zum-it/vms/blob/main/src/main/resources/vms-config.xml"
click node_dockerfile "https://github.com/zum-it/vms/tree/main/Dockerfile"
click node_compose "https://github.com/zum-it/vms/blob/main/docker-compose.yml"
click node_ci_test "https://github.com/zum-it/vms/blob/main/.github/workflows/test.yaml"
click node_ci_deploy "https://github.com/zum-it/vms/blob/main/.github/workflows/docker-deploy.yaml"
click node_wrapper "https://github.com/zum-it/vms/tree/main/mvnw"
click node_pom "https://github.com/zum-it/vms/blob/main/pom.xml"
click node_ops "https://github.com/zum-it/vms/blob/main/manage.sh"

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_app toneBlue
class node_api_ctrl,node_web_ctrl,node_crud_base toneAmber
class node_company,node_domain_entity,node_office,node_company_dto,node_domain_dto,node_office_dto,node_identifiable toneMint
class node_company_repo,node_domain_repo,node_office_repo,node_schema,node_seed toneRose
class node_mapper,node_company_utils,node_pagination,node_trail_filter,node_notfound,node_exists,node_app_props,node_docker_props,node_test_props,node_xml_cfg toneIndigo
class node_dockerfile,node_compose,node_ci_test,node_ci_deploy,node_wrapper,node_pom,node_ops toneTeal
```

## Components

### Runtime

Application bootstrap, packaging, and deployment artifacts

- [VMS app](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/VmsApplication.java): Spring Boot entrypoint · Bootstraps the Visitor Management System service · `src/main/java/com/zum/vms/VmsApplication.java`

### Presentation

HTTP entrypoints for API and web views

- [API controllers](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/ctrl/CompanyController.java): HTTP CRUD · Programmatic CRUD endpoints for core entities · `src/main/java/com/zum/vms/ctrl/CompanyController.java`
- [Web controllers](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/web/CompanyWebController.java): Server views · Browser-facing controllers for rendered pages · `src/main/java/com/zum/vms/web/CompanyWebController.java`
- [CRUD base](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/service/CrudController.java): Controller abstraction · Shared CRUD behavior reused by controllers · `src/main/java/com/zum/vms/service/CrudController.java`

### Domain

Core business entities and transport models

- [Company](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/domain/Company.java): Domain entity · Top-level organizational entity · `src/main/java/com/zum/vms/model/domain/Company.java`
- [Domain](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/domain/Domain.java): Domain entity · Company-scoped organizational domain · `src/main/java/com/zum/vms/model/domain/Domain.java`
- [Office](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/domain/Office.java): Domain entity · Physical office or location context · `src/main/java/com/zum/vms/model/domain/Office.java`
- [Company DTO](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/dto/CompanyDto.java): Transport model · API shape for company data · `src/main/java/com/zum/vms/model/dto/CompanyDto.java`
- [Domain DTO](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/dto/DomainDto.java): Transport model · API shape for domain data · `src/main/java/com/zum/vms/model/dto/DomainDto.java`
- [Office DTO](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/dto/OfficeDto.java): Transport model · API shape for office data · `src/main/java/com/zum/vms/model/dto/OfficeDto.java`
- [Identifiable](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/model/dto/Identifiable.java): DTO contract · Shared identity contract for DTOs · `src/main/java/com/zum/vms/model/dto/Identifiable.java`

### Persistence

Repositories and database initialization

- [Company repo](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/repository/CompanyRepository.java): Repository · Persistence access for companies · `src/main/java/com/zum/vms/repository/CompanyRepository.java`
- [Domain repo](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/repository/DomainRepository.java): Repository · Persistence access for domains · `src/main/java/com/zum/vms/repository/DomainRepository.java`
- [Office repo](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/repository/OfficeRepository.java): Repository · Persistence access for offices · `src/main/java/com/zum/vms/repository/OfficeRepository.java`
- [Schema script](https://github.com/zum-it/vms/blob/main/scripts/01_schema.sql): SQL init · Creates database structure · `scripts/01_schema.sql`
- [Seed data](https://github.com/zum-it/vms/blob/main/scripts/02_data.sql): SQL init · Loads initial database rows · `scripts/02_data.sql`

### Support

Shared utilities, filters, configuration, and errors

- [Mapper utils](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/util/MapperUtils.java): DTO mapping · Converts between entities and DTOs · `src/main/java/com/zum/vms/util/MapperUtils.java`
- [Company utils](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/util/CompanyUtils.java): Business helper · Shared company-specific helper logic · `src/main/java/com/zum/vms/util/CompanyUtils.java`
- [Pagination](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/util/PaginationUtils.java): List helper · Shared paging behavior for list endpoints · `src/main/java/com/zum/vms/util/PaginationUtils.java`
- [Slash filter](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/config/TrailingSlashRedirectFilter.java): HTTP filter · Normalizes trailing-slash requests · `src/main/java/com/zum/vms/config/TrailingSlashRedirectFilter.java`
- [Not found](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/exception/ResourceNotFoundException.java): Exception · Raised when a resource cannot be located · `src/main/java/com/zum/vms/exception/ResourceNotFoundException.java`
- [Already exists](https://github.com/zum-it/vms/blob/main/src/main/java/com/zum/vms/exception/ResourceAlreadyExists.java): Exception · Raised on duplicate resource creation · `src/main/java/com/zum/vms/exception/ResourceAlreadyExists.java`
- [App config](https://github.com/zum-it/vms/blob/main/src/main/resources/application.properties): Runtime config · Primary application properties · `src/main/resources/application.properties`
- [Docker config](https://github.com/zum-it/vms/blob/main/src/main/resources/application-docker.properties): Runtime config · Container-specific application properties · `src/main/resources/application-docker.properties`
- [Test config](https://github.com/zum-it/vms/blob/main/src/main/resources/application-test.properties): Runtime config · Test-specific application properties · `src/main/resources/application-test.properties`
- [XML config](https://github.com/zum-it/vms/blob/main/src/main/resources/vms-config.xml): Legacy config · Additional XML-based application configuration · `src/main/resources/vms-config.xml`

### Delivery

Build, test, and operational scripts

- [Dockerfile](https://github.com/zum-it/vms/tree/main/Dockerfile): Container build · Builds the application image · `Dockerfile`
- [Compose](https://github.com/zum-it/vms/blob/main/docker-compose.yml): Local runtime · Container orchestration for local runs · `docker-compose.yml`
- [Test workflow](https://github.com/zum-it/vms/blob/main/.github/workflows/test.yaml): CI pipeline · Runs automated build and tests · `.github/workflows/test.yaml`
- [Deploy workflow](https://github.com/zum-it/vms/blob/main/.github/workflows/docker-deploy.yaml): CD pipeline · Builds and deploys container image · `.github/workflows/docker-deploy.yaml`
- [Maven wrapper](https://github.com/zum-it/vms/tree/main/mvnw): Build tooling · Maven wrapper entrypoint for builds · `mvnw`
- [Maven pom](https://github.com/zum-it/vms/blob/main/pom.xml): Build descriptor · Defines dependencies and build configuration · `pom.xml`
- [Ops scripts](https://github.com/zum-it/vms/blob/main/manage.sh): Lifecycle scripts · Local start and stop helpers · `manage.sh`

## Connections

- VMS app → API controllers: starts · Application exposes API controllers
- VMS app → Web controllers: starts · Application exposes web controllers
- API controllers → CRUD base: uses · Controllers share CRUD behavior
- Web controllers → CRUD base: uses · Web controllers reuse CRUD behavior
- API controllers → Mapper utils: maps · Transforms request and response models
- Web controllers → Mapper utils: maps · Transforms data for views
- API controllers → Company repo: reads/writes · API layer persists company data
- API controllers → Domain repo: reads/writes · API layer persists domain data
- API controllers → Office repo: reads/writes · API layer persists office data
- Web controllers → Company repo: reads/writes · Web layer persists company data
- Web controllers → Domain repo: reads/writes · Web layer persists domain data
- Web controllers → Office repo: reads/writes · Web layer persists office data
- Company repo → Company: stores · Repository manages company entities
- Domain repo → Domain: stores · Repository manages domain entities
- Office repo → Office: stores · Repository manages office entities
- Mapper utils → Company DTO: produces · Maps company entity data to transport shape
- Mapper utils → Domain DTO: produces · Maps domain entity data to transport shape
- Mapper utils → Office DTO: produces · Maps office entity data to transport shape
- Company DTO → Identifiable: implements · DTOs share an identity contract
- Domain DTO → Identifiable: implements · DTOs share an identity contract
- Office DTO → Identifiable: implements · DTOs share an identity contract
- Company utils → Company: supports · Encapsulates company-specific rules
- Pagination → API controllers: supports · Shapes paginated list responses
- Slash filter → API controllers: preprocesses · Normalizes request paths before controller handling
- Slash filter → Web controllers: preprocesses · Normalizes request paths before controller handling
- API controllers → Not found: throws · Missing resources surface as not found
- API controllers → Already exists: throws · Duplicate resources surface as conflicts
- Web controllers → Not found: throws · Missing resources surface as not found
- Web controllers → Already exists: throws · Duplicate resources surface as conflicts
- Schema script → Company repo: supports · Database schema underpins repository access
- Seed data → Company repo: supports · Seeded data underpins repository access
- App config → VMS app: configures · Primary runtime configuration
- Docker config → Compose: configures · Container runtime configuration
- Test config → Test workflow: configures · Test-time application configuration
- XML config → VMS app: configures · Legacy XML configuration used by the app
- Maven pom → Maven wrapper: drives · Maven build is executed through the wrapper
- Maven pom → Dockerfile: builds · Build descriptor feeds container image creation
- Dockerfile → Compose: used by · Compose runs the built image
- Test workflow → Maven pom: uses · CI workflow builds and tests via Maven
- Deploy workflow → Dockerfile: uses · Deploy workflow builds container image
- Ops scripts → Compose: orchestrates · Helper scripts manage local container lifecycle
