# roldophe/spring-boot-mvc-app-demo architecture

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

- Interactive diagram: https://gitdiagram.com/roldophe/spring-boot-mvc-app-demo
- Repository: https://github.com/roldophe/spring-boot-mvc-app-demo

## Overview

This Spring Boot MVC demo manages company records through a server-rendered web interface: users browse or search companies, view details, and submit forms to create, edit, or delete records. The controller delegates company operations to a service backed by an in-memory list; results and form data use DTOs, while Thymeleaf templates render the pages. The README documents the UI capabilities and MVC flow; the source excerpts confirm controller-to-service calls and the service’s in-memory CRUD behavior.

Main entry points: [`src/main/java/com/tmane/springbootmvcdemo/controller/CompanyController.java`](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/controller/CompanyController.java) (Company Controller), [`src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java`](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java) (Company Operations), [`src/main/java/com/tmane/springbootmvcdemo/service/CompanyService.java`](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/service/CompanyService.java) (Company Service), [`src/main/java/com/tmane/springbootmvcdemo/dto/CompanyDTO.java`](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/dto/CompanyDTO.java) (Company DTO)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web Interface"]
  node_controller["Company Controller"]
  node_views["Company Pages"]
  node_layout["Shared Layout"]
  node_constants["Page Constants<br/>[Constants.java]"]
end

subgraph group_business["Company Operations"]
  node_service_api["Company Service"]
  node_service_impl["Company Operations"]
  node_company_store["In-Memory Companies"]
end

subgraph group_domain["Company Data"]
  node_company_model["Company Model<br/>[Company.java]"]
  node_company_dto["Company DTO<br/>[CompanyDTO.java]"]
  node_sector["Sector Options<br/>[Sector.java]"]
end

node_user(("Web User"))
node_application["Application Entry"]

node_user -->|"requests pages"| node_controller
node_controller -->|"delegates operations"| node_service_api
node_controller -->|"selects views"| node_views
node_controller -->|"binds form data"| node_company_dto
node_controller -->|"supplies options"| node_sector
node_controller -->|"uses page names"| node_constants
node_service_api -->|"exchanges DTOs"| node_company_dto
node_service_impl -->|"converts records"| node_company_model
node_service_impl -->|"converts DTOs"| node_company_dto
node_service_impl -->|"uses sector values"| node_sector
node_service_impl -->|"reads and writes"| node_company_store
node_service_impl -->|"implements contract"| node_service_api
node_views -.->|"uses shared layout"| node_layout

click node_controller "https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/controller/CompanyController.java"
click node_views "https://github.com/roldophe/spring-boot-mvc-app-demo/tree/main/src/main/resources/templates/companies"
click node_layout "https://github.com/roldophe/spring-boot-mvc-app-demo/tree/main/src/main/resources/templates"
click node_service_api "https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/service/CompanyService.java"
click node_service_impl "https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java"
click node_company_store "https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java"
click node_company_model "https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/model/Company.java"
click node_company_dto "https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/dto/CompanyDTO.java"
click node_sector "https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/enums/Sector.java"
click node_constants "https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/util/Constants.java"
click node_application "https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/SpringBootMvcDemoApplication.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_controller,node_views,node_layout,node_constants,node_user toneBlue
class node_service_api,node_service_impl,node_company_store toneAmber
class node_company_model,node_company_dto,node_sector toneMint
class node_application toneTeal
```

## Components

### Web Interface

- [Company Controller](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/controller/CompanyController.java): `src/main/java/com/tmane/springbootmvcdemo/controller/CompanyController.java`
- [Company Pages](https://github.com/roldophe/spring-boot-mvc-app-demo/tree/main/src/main/resources/templates/companies): `src/main/resources/templates/companies`
- [Shared Layout](https://github.com/roldophe/spring-boot-mvc-app-demo/tree/main/src/main/resources/templates): `src/main/resources/templates`
- [Page Constants](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/util/Constants.java): `src/main/java/com/tmane/springbootmvcdemo/util/Constants.java`

### Company Operations

- [Company Service](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/service/CompanyService.java): `src/main/java/com/tmane/springbootmvcdemo/service/CompanyService.java`
- [Company Operations](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java): `src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java`
- [In-Memory Companies](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java): `src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java`

### Company Data

- [Company Model](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/model/Company.java): `src/main/java/com/tmane/springbootmvcdemo/model/Company.java`
- [Company DTO](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/dto/CompanyDTO.java): `src/main/java/com/tmane/springbootmvcdemo/dto/CompanyDTO.java`
- [Sector Options](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/enums/Sector.java): `src/main/java/com/tmane/springbootmvcdemo/enums/Sector.java`

### Other components

- **Web User**
- [Application Entry](https://github.com/roldophe/spring-boot-mvc-app-demo/blob/main/src/main/java/com/tmane/springbootmvcdemo/SpringBootMvcDemoApplication.java): `src/main/java/com/tmane/springbootmvcdemo/SpringBootMvcDemoApplication.java`

## Connections

- Web User → Company Controller: requests pages (evidence: `README.md`)
- Company Controller → Company Service: delegates operations (evidence: `src/main/java/com/tmane/springbootmvcdemo/controller/CompanyController.java`)
- Company Controller → Company Pages: selects views (evidence: `src/main/java/com/tmane/springbootmvcdemo/controller/CompanyController.java`)
- Company Controller → Company DTO: binds form data (evidence: `src/main/java/com/tmane/springbootmvcdemo/controller/CompanyController.java`)
- Company Controller → Sector Options: supplies options (evidence: `src/main/java/com/tmane/springbootmvcdemo/controller/CompanyController.java`)
- Company Controller → Page Constants: uses page names (evidence: `src/main/java/com/tmane/springbootmvcdemo/controller/CompanyController.java`)
- Company Service → Company DTO: exchanges DTOs (evidence: `src/main/java/com/tmane/springbootmvcdemo/service/CompanyService.java`)
- Company Operations → Company Model: converts records (evidence: `src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java`)
- Company Operations → Company DTO: converts DTOs (evidence: `src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java`)
- Company Operations → Sector Options: uses sector values (evidence: `src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java`)
- Company Operations → In-Memory Companies: reads and writes (evidence: `src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java`)
- Company Operations → Company Service: implements contract (evidence: `src/main/java/com/tmane/springbootmvcdemo/service/Impl/CompanyServiceImpl.java`)
- Company Pages → Shared Layout: uses shared layout
