# bespin-core/app architecture

> Architecture diagram of the GitHub repository bespin-core/app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bespin-core/app
- Repository: https://github.com/bespin-core/app

## Overview

Spring PetClinic is a Spring Boot web application for managing pet owners, pets, visits, and veterinarians. A browser user accesses the application, which presents domain-specific pages and persists clinic data; the README documents an in-memory H2 default and MySQL/PostgreSQL profiles. The tree identifies the domain controllers, entities, repositories, and Thymeleaf templates, but their source was not sampled, so internal call relationships are shown as unverified rather than asserted. The README names the application entry point and caching configuration.

Main entry points: [`src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java`](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java) (PetClinic application), [`src/main/java/org/springframework/samples/petclinic/owner/PetController.java`](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetController.java) (Pet management), [`src/main/resources/application.properties`](https://github.com/bespin-core/app/blob/main/src/main/resources/application.properties) (Configured database), [`src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java`](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java) (Owner and pet data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application and system"]
  node_app["PetClinic application"]
  node_system["System pages"]
  node_cache["Cache configuration"]
end

subgraph group_clinic["Clinic workflows"]
  node_owners["Owner management"]
  node_pets["Pet management<br/>[PetController.java]"]
  node_visits["Visit management"]
  node_vets["Veterinarian directory<br/>[VetController.java]"]
  node_domain["Clinic domain model<br/>[Person.java]"]
end

subgraph group_persistence["Persistence"]
  node_owner_data["Owner and pet data"]
  node_pet_types["Pet type data"]
  node_vet_data["Veterinarian data<br/>[VetRepository.java]"]
  node_database[("Configured database")]
end

subgraph group_presentation["Web presentation"]
  node_templates["Thymeleaf pages"]
  node_owner_pages["Owner and pet pages"]
  node_visit_pages["Visit form"]
  node_vet_pages["Veterinarian page<br/>[vetList.html]"]
end

node_browser(("Browser user"))
node_h2[("H2 database")]
node_mysql[("MySQL database")]
node_postgres[("PostgreSQL database")]

node_browser -->|"accesses"| node_app
node_app -.->|"routes to"| node_system
node_app -.->|"routes to"| node_owners
node_app -.->|"routes to"| node_pets
node_app -.->|"routes to"| node_visits
node_app -.->|"routes to"| node_vets
node_app -.->|"renders"| node_templates
node_owners -.->|"uses"| node_owner_data
node_pets -.->|"uses"| node_owner_data
node_pets -.->|"uses"| node_pet_types
node_visits -.->|"uses"| node_owner_data
node_vets -.->|"uses"| node_vet_data
node_owners -.->|"renders"| node_owner_pages
node_pets -.->|"renders"| node_owner_pages
node_visits -.->|"renders"| node_visit_pages
node_vets -.->|"renders"| node_vet_pages
node_owner_data -.->|"uses"| node_domain
node_vet_data -.->|"uses"| node_domain
node_app -.->|"configures"| node_database
node_database -->|"defaults to"| node_h2
node_database -->|"profile selects"| node_mysql
node_database -->|"profile selects"| node_postgres
node_app -.->|"configures"| node_cache

click node_app "https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java"
click node_system "https://github.com/bespin-core/app/tree/main/src/main/java/org/springframework/samples/petclinic/system"
click node_cache "https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java"
click node_owners "https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java"
click node_pets "https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetController.java"
click node_visits "https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/owner/VisitController.java"
click node_vets "https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/vet/VetController.java"
click node_domain "https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/model/Person.java"
click node_owner_data "https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java"
click node_pet_types "https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java"
click node_vet_data "https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/vet/VetRepository.java"
click node_database "https://github.com/bespin-core/app/blob/main/src/main/resources/application.properties"
click node_templates "https://github.com/bespin-core/app/tree/main/src/main/resources/templates"
click node_owner_pages "https://github.com/bespin-core/app/tree/main/src/main/resources/templates/owners"
click node_visit_pages "https://github.com/bespin-core/app/blob/main/src/main/resources/templates/pets/createOrUpdateVisitForm.html"
click node_vet_pages "https://github.com/bespin-core/app/blob/main/src/main/resources/templates/vets/vetList.html"

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,node_system,node_cache,node_browser toneBlue
class node_owners,node_pets,node_visits,node_vets,node_domain,node_h2,node_mysql,node_postgres toneAmber
class node_owner_data,node_pet_types,node_vet_data,node_database toneMint
class node_templates,node_owner_pages,node_visit_pages,node_vet_pages toneRose
```

## Components

### Application and system

- [PetClinic application](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java): `src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java`
- [System pages](https://github.com/bespin-core/app/tree/main/src/main/java/org/springframework/samples/petclinic/system): `src/main/java/org/springframework/samples/petclinic/system`
- [Cache configuration](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java): `src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java`

### Clinic workflows

- [Owner management](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java): `src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java`
- [Pet management](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetController.java): `src/main/java/org/springframework/samples/petclinic/owner/PetController.java`
- [Visit management](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/owner/VisitController.java): `src/main/java/org/springframework/samples/petclinic/owner/VisitController.java`
- [Veterinarian directory](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/vet/VetController.java): `src/main/java/org/springframework/samples/petclinic/vet/VetController.java`
- [Clinic domain model](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/model/Person.java): `src/main/java/org/springframework/samples/petclinic/model/Person.java`

### Persistence

- [Owner and pet data](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java): `src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java`
- [Pet type data](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java): `src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java`
- [Veterinarian data](https://github.com/bespin-core/app/blob/main/src/main/java/org/springframework/samples/petclinic/vet/VetRepository.java): `src/main/java/org/springframework/samples/petclinic/vet/VetRepository.java`
- [Configured database](https://github.com/bespin-core/app/blob/main/src/main/resources/application.properties): `src/main/resources/application.properties`

### Web presentation

- [Thymeleaf pages](https://github.com/bespin-core/app/tree/main/src/main/resources/templates): `src/main/resources/templates`
- [Owner and pet pages](https://github.com/bespin-core/app/tree/main/src/main/resources/templates/owners): `src/main/resources/templates/owners`
- [Visit form](https://github.com/bespin-core/app/blob/main/src/main/resources/templates/pets/createOrUpdateVisitForm.html): `src/main/resources/templates/pets/createOrUpdateVisitForm.html`
- [Veterinarian page](https://github.com/bespin-core/app/blob/main/src/main/resources/templates/vets/vetList.html): `src/main/resources/templates/vets/vetList.html`

### Other components

- **Browser user**
- **H2 database**
- **MySQL database**
- **PostgreSQL database**

## Connections

- Browser user → PetClinic application: accesses (evidence: `README.md`)
- PetClinic application → System pages: routes to
- PetClinic application → Owner management: routes to
- PetClinic application → Pet management: routes to
- PetClinic application → Visit management: routes to
- PetClinic application → Veterinarian directory: routes to
- PetClinic application → Thymeleaf pages: renders
- Owner management → Owner and pet data: uses
- Pet management → Owner and pet data: uses
- Pet management → Pet type data: uses
- Visit management → Owner and pet data: uses
- Veterinarian directory → Veterinarian data: uses
- Owner management → Owner and pet pages: renders
- Pet management → Owner and pet pages: renders
- Visit management → Visit form: renders
- Veterinarian directory → Veterinarian page: renders
- Owner and pet data → Clinic domain model: uses
- Veterinarian data → Clinic domain model: uses
- PetClinic application → Configured database: configures
- Configured database → H2 database: defaults to (evidence: `README.md`)
- Configured database → MySQL database: profile selects (evidence: `README.md`)
- Configured database → PostgreSQL database: profile selects (evidence: `README.md`)
- PetClinic application → Cache configuration: configures
