# spring-petclinic/spring-framework-petclinic architecture

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

- Interactive diagram: https://gitdiagram.com/spring-petclinic/spring-framework-petclinic
- Repository: https://github.com/spring-petclinic/spring-framework-petclinic

## Overview

Spring PetClinic is a Spring Framework sample clinic app with a documented presentation–service–repository architecture. A browser uses the presentation layer to manage clinic records; the service layer mediates operations before repository persistence. The README documents JPA, JDBC, and Spring Data JPA as selectable persistence implementations, plus H2 startup data and optional MySQL/PostgreSQL configurations. Source excerpts were unavailable, so the graph limits relationships to those documented in the README; implementation-specific calls and routes are not asserted.

Main entry points: [`src/main/java/org/springframework/samples/petclinic/repository`](https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository) (Repository layer), [`src/main/java/org/springframework/samples/petclinic/web`](https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/web) (Spring MVC), [`src/main/java/org/springframework/samples/petclinic/service/ClinicServiceImpl.java`](https://github.com/spring-petclinic/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/service/ClinicServiceImpl.java) (Clinic service), [`src/main/java/org/springframework/samples/petclinic/repository/jpa`](https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository/jpa) (JPA repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Presentation"]
  node_web["Spring MVC"]
  node_views["JSP views"]
  node_webconfig["MVC configuration"]
end

subgraph group_domain["Clinic domain"]
  node_clinicdata["Clinic records"]
end

subgraph group_services["Service layer"]
  node_service["Clinic service"]
end

subgraph group_persistence["Persistence"]
  node_repository["Repository layer"]
  node_jpa["JPA repositories"]
  node_jdbc["JDBC repositories"]
  node_springdata["Spring Data JPA"]
  node_dbconfig["Data access config"]
  node_seeddata["Startup seed data<br/>[data.sql]"]
end

node_browser(("Clinic user"))
node_database[("Clinic database")]

node_browser -->|"uses clinic"| node_web
node_web -->|"renders views"| node_views
node_web -->|"calls service"| node_service
node_service -->|"uses repositories"| node_repository
node_repository -->|"persists records"| node_clinicdata
node_webconfig -->|"configures MVC"| node_web
node_repository -->|"selects implementation"| node_jpa
node_repository -->|"selects implementation"| node_jdbc
node_repository -->|"selects implementation"| node_springdata
node_jpa -->|"persists data"| node_database
node_jdbc -->|"persists data"| node_database
node_springdata -->|"persists data"| node_database
node_dbconfig -->|"configures connection"| node_database
node_seeddata -->|"populates at startup"| node_database

click node_web "https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/web"
click node_views "https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/webapp/WEB-INF/jsp"
click node_webconfig "https://github.com/spring-petclinic/spring-framework-petclinic/blob/main/src/main/resources/spring/mvc-view-config.xml"
click node_clinicdata "https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/model"
click node_service "https://github.com/spring-petclinic/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/service/ClinicServiceImpl.java"
click node_repository "https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository"
click node_jpa "https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository/jpa"
click node_jdbc "https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository/jdbc"
click node_springdata "https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository/springdatajpa"
click node_dbconfig "https://github.com/spring-petclinic/spring-framework-petclinic/blob/main/src/main/resources/spring/datasource-config.xml"
click node_seeddata "https://github.com/spring-petclinic/spring-framework-petclinic/blob/main/src/main/resources/db/h2/data.sql"

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_web,node_views,node_webconfig,node_browser toneBlue
class node_clinicdata,node_database toneAmber
class node_service toneMint
class node_repository,node_jpa,node_jdbc,node_springdata,node_dbconfig,node_seeddata toneRose
```

## Components

### Presentation

- [Spring MVC](https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/web): `src/main/java/org/springframework/samples/petclinic/web`
- [JSP views](https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/webapp/WEB-INF/jsp): `src/main/webapp/WEB-INF/jsp`
- [MVC configuration](https://github.com/spring-petclinic/spring-framework-petclinic/blob/main/src/main/resources/spring/mvc-view-config.xml): `src/main/resources/spring/mvc-view-config.xml`

### Clinic domain

- [Clinic records](https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/model): `src/main/java/org/springframework/samples/petclinic/model`

### Service layer

- [Clinic service](https://github.com/spring-petclinic/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/service/ClinicServiceImpl.java): `src/main/java/org/springframework/samples/petclinic/service/ClinicServiceImpl.java`

### Persistence

- [Repository layer](https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository): `src/main/java/org/springframework/samples/petclinic/repository`
- [JPA repositories](https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository/jpa): `src/main/java/org/springframework/samples/petclinic/repository/jpa`
- [JDBC repositories](https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository/jdbc): `src/main/java/org/springframework/samples/petclinic/repository/jdbc`
- [Spring Data JPA](https://github.com/spring-petclinic/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository/springdatajpa): `src/main/java/org/springframework/samples/petclinic/repository/springdatajpa`
- [Data access config](https://github.com/spring-petclinic/spring-framework-petclinic/blob/main/src/main/resources/spring/datasource-config.xml): `src/main/resources/spring/datasource-config.xml`
- [Startup seed data](https://github.com/spring-petclinic/spring-framework-petclinic/blob/main/src/main/resources/db/h2/data.sql): `src/main/resources/db/h2/data.sql`

### Other components

- **Clinic user**
- **Clinic database**

## Connections

- Clinic user → Spring MVC: uses clinic (evidence: `readme.md`)
- Spring MVC → JSP views: renders views (evidence: `readme.md`)
- Spring MVC → Clinic service: calls service (evidence: `readme.md`)
- Clinic service → Repository layer: uses repositories (evidence: `readme.md`)
- Repository layer → Clinic records: persists records (evidence: `readme.md`)
- MVC configuration → Spring MVC: configures MVC (evidence: `readme.md`)
- Repository layer → JPA repositories: selects implementation (evidence: `readme.md`)
- Repository layer → JDBC repositories: selects implementation (evidence: `readme.md`)
- Repository layer → Spring Data JPA: selects implementation (evidence: `readme.md`)
- JPA repositories → Clinic database: persists data (evidence: `readme.md`)
- JDBC repositories → Clinic database: persists data (evidence: `readme.md`)
- Spring Data JPA → Clinic database: persists data (evidence: `readme.md`)
- Data access config → Clinic database: configures connection (evidence: `readme.md`)
- Startup seed data → Clinic database: populates at startup (evidence: `readme.md`)
