# spring-projects/spring-petclinic architecture

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

- Interactive diagram: https://gitdiagram.com/spring-projects/spring-petclinic
- Repository: https://github.com/spring-projects/spring-petclinic
- Video tour (about a minute): https://gitdiagram.com/spring-projects/spring-petclinic/video

## Overview

Spring PetClinic is a Spring Boot veterinary-clinic sample application. A browser user accesses the application, which presents clinic pages and supports owner, pet, visit, and veterinarian workflows. The README documents Thymeleaf, an H2 database populated at startup by default, and MySQL/PostgreSQL profiles. Source excerpts were limited to the build file, so the domain components are identified from the repository tree; their internal call relationships are not asserted.

Main entry points: [`src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java`](https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java) (Spring Boot app), [`src/main/resources/application.properties`](https://github.com/spring-projects/spring-petclinic/blob/main/src/main/resources/application.properties) (Database profiles), [`src/main/resources/db/h2/data.sql`](https://github.com/spring-projects/spring-petclinic/blob/main/src/main/resources/db/h2/data.sql) (H2 startup data), [`src/main/resources/db`](https://github.com/spring-projects/spring-petclinic/tree/main/src/main/resources/db) (MySQL and PostgreSQL setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Spring Boot app"]
  node_webconfig["Web configuration"]
  node_welcome["Welcome page"]
  node_templates["Thymeleaf pages"]
end

subgraph group_clinic["Clinic workflows"]
  node_owner["Owner workflows"]
  node_pet["Pet workflows<br/>[PetController.java]"]
  node_visit["Visit workflows"]
  node_vet["Veterinarian listing<br/>[VetController.java]"]
  node_domain["Clinic domain model"]
end

subgraph group_persistence["Persistence and configuration"]
  node_ownerrepo["Owner repository"]
  node_pettypes["Pet type lookup"]
  node_vetrepo["Veterinarian repository<br/>[VetRepository.java]"]
  node_cache["Caching configuration"]
  node_dbconfig["Database profiles"]
  node_database[("Clinic database")]
  node_h2data["H2 startup data<br/>[data.sql]"]
  node_sqlprofiles["MySQL and PostgreSQL setup"]
end

node_user(("Browser user"))

node_user -->|"opens"| node_app
node_app -.->|"serves pages"| node_welcome
node_app -->|"renders"| node_templates
node_dbconfig -->|"selects profile"| node_database
node_h2data -->|"populates at startup"| node_database
node_sqlprofiles -->|"supports alternatives"| node_database

click node_app "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java"
click node_webconfig "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/system/WebConfiguration.java"
click node_welcome "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/system/WelcomeController.java"
click node_templates "https://github.com/spring-projects/spring-petclinic/tree/main/src/main/resources/templates"
click node_owner "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java"
click node_pet "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetController.java"
click node_visit "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/owner/VisitController.java"
click node_vet "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/vet/VetController.java"
click node_domain "https://github.com/spring-projects/spring-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/model"
click node_ownerrepo "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java"
click node_pettypes "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java"
click node_vetrepo "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/vet/VetRepository.java"
click node_cache "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java"
click node_dbconfig "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/resources/application.properties"
click node_h2data "https://github.com/spring-projects/spring-petclinic/blob/main/src/main/resources/db/h2/data.sql"
click node_sqlprofiles "https://github.com/spring-projects/spring-petclinic/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_webconfig,node_welcome,node_templates,node_user toneBlue
class node_owner,node_pet,node_visit,node_vet,node_domain toneAmber
class node_ownerrepo,node_pettypes,node_vetrepo,node_cache,node_dbconfig,node_database,node_h2data,node_sqlprofiles toneMint
```

## Components

### Web application

- [Spring Boot app](https://github.com/spring-projects/spring-petclinic/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/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/system/WebConfiguration.java): `src/main/java/org/springframework/samples/petclinic/system/WebConfiguration.java`
- [Welcome page](https://github.com/spring-projects/spring-petclinic/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/spring-projects/spring-petclinic/tree/main/src/main/resources/templates): `src/main/resources/templates`

### Clinic workflows

- [Owner workflows](https://github.com/spring-projects/spring-petclinic/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/spring-projects/spring-petclinic/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/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/owner/VisitController.java): `src/main/java/org/springframework/samples/petclinic/owner/VisitController.java`
- [Veterinarian listing](https://github.com/spring-projects/spring-petclinic/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/spring-projects/spring-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/model): `src/main/java/org/springframework/samples/petclinic/model`

### Persistence and configuration

- [Owner repository](https://github.com/spring-projects/spring-petclinic/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/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java): `src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java`
- [Veterinarian repository](https://github.com/spring-projects/spring-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/vet/VetRepository.java): `src/main/java/org/springframework/samples/petclinic/vet/VetRepository.java`
- [Caching configuration](https://github.com/spring-projects/spring-petclinic/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/spring-projects/spring-petclinic/blob/main/src/main/resources/application.properties): `src/main/resources/application.properties`
- **Clinic database**
- [H2 startup data](https://github.com/spring-projects/spring-petclinic/blob/main/src/main/resources/db/h2/data.sql): `src/main/resources/db/h2/data.sql`
- [MySQL and PostgreSQL setup](https://github.com/spring-projects/spring-petclinic/tree/main/src/main/resources/db): `src/main/resources/db`

### Other components

- **Browser user**

## Connections

- Browser user → Spring Boot app: opens (evidence: `README.md`)
- Spring Boot app → Welcome page: serves pages
- Spring Boot app → Thymeleaf pages: renders (evidence: `README.md`)
- Database profiles → Clinic database: selects profile (evidence: `README.md`)
- H2 startup data → Clinic database: populates at startup (evidence: `README.md`)
- MySQL and PostgreSQL setup → Clinic database: supports alternatives (evidence: `README.md`)
