# bespin-core/petclinic-final architecture

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

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

## Overview

Spring PetClinic is a Spring Boot and Thymeleaf web application for managing clinic owners, pets, visits, and veterinarians. A user visits the application in a browser; its web layer presents domain pages backed by persistence, with H2 as the documented default and MySQL/PostgreSQL as profile-based alternatives. The tree identifies the relevant controllers, repositories, templates, models, and database resources, but their source was not excerpted, so internal call relationships are shown as unverified rather than asserted.

Main entry points: [`src/main/resources/templates`](https://github.com/bespin-core/petclinic-final/tree/main/src/main/resources/templates) (Thymeleaf pages), [`src/main/java/org/springframework/samples/petclinic/owner/PetController.java`](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetController.java) (Pet workflows), [`src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java`](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java) (Owner persistence), [`src/main/resources/application.properties`](https://github.com/bespin-core/petclinic-final/blob/main/src/main/resources/application.properties) (Database profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web presentation"]
  node_app["Spring Boot application"]
  node_system_web["Web configuration"]
  node_welcome["Welcome and errors"]
  node_templates["Thymeleaf pages"]
end

subgraph group_owners["Owner and pet care"]
  node_owner_flow["Owner workflows"]
  node_pet_flow["Pet workflows<br/>[PetController.java]"]
  node_visit_flow["Visit workflows"]
  node_owner_repo["Owner persistence"]
  node_pet_types["Pet type lookup"]
  node_pet_validation["Pet validation<br/>[PetValidator.java]"]
end

subgraph group_vets["Veterinary directory"]
  node_vet_flow["Veterinarian listing<br/>[VetController.java]"]
  node_vet_repo["Veterinarian persistence<br/>[VetRepository.java]"]
end

subgraph group_domain["Clinic domain"]
  node_entities["Clinic entities"]
  node_owner_entities["Owner pet visit entities"]
  node_vet_entities["Veterinarian entities"]
end

subgraph group_persistence["Persistence and profiles"]
  node_cache["Caching configuration"]
  node_db_config["Database profiles"]
  node_db_schema["Database schemas and seeds"]
end

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

node_browser -->|"opens application"| node_app
node_app -->|"serves pages"| node_browser
node_owner_flow -.->|"uses repository"| node_owner_repo
node_pet_flow -.->|"uses repository"| node_owner_repo
node_pet_flow -.->|"looks up types"| node_pet_types
node_pet_flow -.->|"validates input"| node_pet_validation
node_visit_flow -.->|"uses repository"| node_owner_repo
node_vet_flow -.->|"uses repository"| node_vet_repo
node_owner_flow -.->|"renders pages"| node_templates
node_pet_flow -.->|"renders pages"| node_templates
node_visit_flow -.->|"renders pages"| node_templates
node_vet_flow -.->|"renders pages"| node_templates
node_welcome -.->|"renders pages"| node_templates
node_owner_repo -.->|"stores entities"| node_owner_entities
node_vet_repo -.->|"stores entities"| node_vet_entities
node_db_config -->|"selects default"| node_h2
node_db_config -->|"selects profile"| node_mysql
node_db_config -->|"selects profile"| node_postgres
node_db_schema -.->|"initializes schema"| node_h2
node_db_schema -.->|"initializes schema"| node_mysql
node_db_schema -.->|"initializes schema"| node_postgres

click node_app "https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java"
click node_system_web "https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/system/WebConfiguration.java"
click node_welcome "https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/system/WelcomeController.java"
click node_templates "https://github.com/bespin-core/petclinic-final/tree/main/src/main/resources/templates"
click node_owner_flow "https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java"
click node_pet_flow "https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetController.java"
click node_visit_flow "https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/VisitController.java"
click node_owner_repo "https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java"
click node_pet_types "https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java"
click node_pet_validation "https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetValidator.java"
click node_vet_flow "https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/vet/VetController.java"
click node_vet_repo "https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/vet/VetRepository.java"
click node_entities "https://github.com/bespin-core/petclinic-final/tree/main/src/main/java/org/springframework/samples/petclinic/model"
click node_owner_entities "https://github.com/bespin-core/petclinic-final/tree/main/src/main/java/org/springframework/samples/petclinic/owner"
click node_vet_entities "https://github.com/bespin-core/petclinic-final/tree/main/src/main/java/org/springframework/samples/petclinic/vet"
click node_cache "https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java"
click node_db_config "https://github.com/bespin-core/petclinic-final/blob/main/src/main/resources/application.properties"
click node_db_schema "https://github.com/bespin-core/petclinic-final/tree/main/src/main/resources/db"

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_web,node_welcome,node_templates,node_browser toneBlue
class node_owner_flow,node_pet_flow,node_visit_flow,node_owner_repo,node_pet_types,node_pet_validation,node_h2,node_mysql,node_postgres toneAmber
class node_vet_flow,node_vet_repo toneMint
class node_entities,node_owner_entities,node_vet_entities toneRose
class node_cache,node_db_config,node_db_schema toneIndigo
```

## Components

### Web presentation

- [Spring Boot application](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java): `src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java`
- [Web configuration](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/system/WebConfiguration.java): `src/main/java/org/springframework/samples/petclinic/system/WebConfiguration.java`
- [Welcome and errors](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/system/WelcomeController.java): `src/main/java/org/springframework/samples/petclinic/system/WelcomeController.java`
- [Thymeleaf pages](https://github.com/bespin-core/petclinic-final/tree/main/src/main/resources/templates): `src/main/resources/templates`

### Owner and pet care

- [Owner workflows](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java): `src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java`
- [Pet workflows](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetController.java): `src/main/java/org/springframework/samples/petclinic/owner/PetController.java`
- [Visit workflows](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/VisitController.java): `src/main/java/org/springframework/samples/petclinic/owner/VisitController.java`
- [Owner persistence](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java): `src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java`
- [Pet type lookup](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java): `src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java`
- [Pet validation](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetValidator.java): `src/main/java/org/springframework/samples/petclinic/owner/PetValidator.java`

### Veterinary directory

- [Veterinarian listing](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/vet/VetController.java): `src/main/java/org/springframework/samples/petclinic/vet/VetController.java`
- [Veterinarian persistence](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/vet/VetRepository.java): `src/main/java/org/springframework/samples/petclinic/vet/VetRepository.java`

### Clinic domain

- [Clinic entities](https://github.com/bespin-core/petclinic-final/tree/main/src/main/java/org/springframework/samples/petclinic/model): `src/main/java/org/springframework/samples/petclinic/model`
- [Owner pet visit entities](https://github.com/bespin-core/petclinic-final/tree/main/src/main/java/org/springframework/samples/petclinic/owner): `src/main/java/org/springframework/samples/petclinic/owner`
- [Veterinarian entities](https://github.com/bespin-core/petclinic-final/tree/main/src/main/java/org/springframework/samples/petclinic/vet): `src/main/java/org/springframework/samples/petclinic/vet`

### Persistence and profiles

- [Caching configuration](https://github.com/bespin-core/petclinic-final/blob/main/src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java): `src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java`
- [Database profiles](https://github.com/bespin-core/petclinic-final/blob/main/src/main/resources/application.properties): `src/main/resources/application.properties`
- [Database schemas and seeds](https://github.com/bespin-core/petclinic-final/tree/main/src/main/resources/db): `src/main/resources/db`

### Other components

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

## Connections

- Browser user → Spring Boot application: opens application (evidence: `README.md`)
- Spring Boot application → Browser user: serves pages (evidence: `README.md`)
- Owner workflows → Owner persistence: uses repository
- Pet workflows → Owner persistence: uses repository
- Pet workflows → Pet type lookup: looks up types
- Pet workflows → Pet validation: validates input
- Visit workflows → Owner persistence: uses repository
- Veterinarian listing → Veterinarian persistence: uses repository
- Owner workflows → Thymeleaf pages: renders pages
- Pet workflows → Thymeleaf pages: renders pages
- Visit workflows → Thymeleaf pages: renders pages
- Veterinarian listing → Thymeleaf pages: renders pages
- Welcome and errors → Thymeleaf pages: renders pages
- Owner persistence → Owner pet visit entities: stores entities
- Veterinarian persistence → Veterinarian entities: stores entities
- Database profiles → H2 database: selects default (evidence: `README.md`)
- Database profiles → MySQL database: selects profile (evidence: `README.md`)
- Database profiles → PostgreSQL database: selects profile (evidence: `README.md`)
- Database schemas and seeds → H2 database: initializes schema
- Database schemas and seeds → MySQL database: initializes schema
- Database schemas and seeds → PostgreSQL database: initializes schema
