# iam-senthilkumar/spring-framework-petclinic architecture

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

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

## Overview

Spring PetClinic is a Spring Framework sample for managing pet owners, pets, visits, and veterinarians. Its documented request architecture is presentation → service → repository. The README also documents JSP-based MVC, three selectable persistence implementations, and H2 by default with MySQL and PostgreSQL options. Source excerpts were unavailable, so relationships below are limited to those documented in the README; implementation details and finer-grained calls are not inferred.

Main entry points: [`src/main/java/org/springframework/samples/petclinic/repository`](https://github.com/iam-senthilkumar/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository) (Repository contracts), [`src/main/java/org/springframework/samples/petclinic/repository/jpa`](https://github.com/iam-senthilkumar/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository/jpa) (JPA repositories), [`src/main/java/org/springframework/samples/petclinic/web`](https://github.com/iam-senthilkumar/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/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/service/ClinicServiceImpl.java) (Clinic service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web presentation"]
  node_mvc["Spring MVC"]
  node_owner["Owner workflows"]
  node_pet["Pet workflows<br/>[PetController.java]"]
  node_visit["Visit workflows"]
  node_vet["Vet directory<br/>[VetController.java]"]
  node_jsp["JSP views"]
end

subgraph group_domain["Clinic domain"]
  node_ownerdata["Owner and person<br/>[Owner.java]"]
  node_petdata["Pet and type<br/>[Pet.java]"]
  node_visitdata["Visit records<br/>[Visit.java]"]
  node_vetdata["Veterinarians<br/>[Vet.java]"]
end

subgraph group_service["Service layer"]
  node_clinicservice["Clinic service"]
end

subgraph group_persistence["Persistence layer"]
  node_repositoryapi["Repository contracts"]
  node_jpa["JPA repositories"]
  node_jdbc["JDBC repositories"]
  node_springdata["Spring Data JPA"]
  node_h2[("H2 database<br/>[schema.sql]")]
  node_mysql[("MySQL database<br/>[schema.sql]")]
  node_postgres[("PostgreSQL database<br/>[schema.sql]")]
end

node_visitor(("Clinic user"))

node_visitor -->|"uses"| node_mvc
node_mvc -->|"presentation to service"| node_clinicservice
node_clinicservice -->|"service to repository"| node_repositoryapi
node_repositoryapi -->|"selects implementation"| node_jpa
node_repositoryapi -->|"selects implementation"| node_jdbc
node_repositoryapi -->|"selects implementation"| node_springdata
node_jpa -->|"uses by default"| node_h2
node_jpa -.->|"can use"| node_mysql
node_jpa -.->|"can use"| node_postgres

click node_mvc "https://github.com/iam-senthilkumar/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/web"
click node_owner "https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/web/OwnerController.java"
click node_pet "https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/web/PetController.java"
click node_visit "https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/web/VisitController.java"
click node_vet "https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/web/VetController.java"
click node_jsp "https://github.com/iam-senthilkumar/spring-framework-petclinic/tree/main/src/main/webapp/WEB-INF/jsp"
click node_ownerdata "https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/model/Owner.java"
click node_petdata "https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/model/Pet.java"
click node_visitdata "https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/model/Visit.java"
click node_vetdata "https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/model/Vet.java"
click node_clinicservice "https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/service/ClinicServiceImpl.java"
click node_repositoryapi "https://github.com/iam-senthilkumar/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository"
click node_jpa "https://github.com/iam-senthilkumar/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository/jpa"
click node_jdbc "https://github.com/iam-senthilkumar/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository/jdbc"
click node_springdata "https://github.com/iam-senthilkumar/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository/springdatajpa"
click node_h2 "https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/resources/db/h2/schema.sql"
click node_mysql "https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/resources/db/mysql/schema.sql"
click node_postgres "https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/resources/db/postgresql/schema.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_mvc,node_owner,node_pet,node_visit,node_vet,node_jsp,node_visitor toneBlue
class node_ownerdata,node_petdata,node_visitdata,node_vetdata toneAmber
class node_clinicservice toneMint
class node_repositoryapi,node_jpa,node_jdbc,node_springdata,node_h2,node_mysql,node_postgres toneRose
```

## Components

### Web presentation

- [Spring MVC](https://github.com/iam-senthilkumar/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/web): `src/main/java/org/springframework/samples/petclinic/web`
- [Owner workflows](https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/web/OwnerController.java): `src/main/java/org/springframework/samples/petclinic/web/OwnerController.java`
- [Pet workflows](https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/web/PetController.java): `src/main/java/org/springframework/samples/petclinic/web/PetController.java`
- [Visit workflows](https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/web/VisitController.java): `src/main/java/org/springframework/samples/petclinic/web/VisitController.java`
- [Vet directory](https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/web/VetController.java): `src/main/java/org/springframework/samples/petclinic/web/VetController.java`
- [JSP views](https://github.com/iam-senthilkumar/spring-framework-petclinic/tree/main/src/main/webapp/WEB-INF/jsp): `src/main/webapp/WEB-INF/jsp`

### Clinic domain

- [Owner and person](https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/model/Owner.java): `src/main/java/org/springframework/samples/petclinic/model/Owner.java`
- [Pet and type](https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/model/Pet.java): `src/main/java/org/springframework/samples/petclinic/model/Pet.java`
- [Visit records](https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/model/Visit.java): `src/main/java/org/springframework/samples/petclinic/model/Visit.java`
- [Veterinarians](https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/java/org/springframework/samples/petclinic/model/Vet.java): `src/main/java/org/springframework/samples/petclinic/model/Vet.java`

### Service layer

- [Clinic service](https://github.com/iam-senthilkumar/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 layer

- [Repository contracts](https://github.com/iam-senthilkumar/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/iam-senthilkumar/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/iam-senthilkumar/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/iam-senthilkumar/spring-framework-petclinic/tree/main/src/main/java/org/springframework/samples/petclinic/repository/springdatajpa): `src/main/java/org/springframework/samples/petclinic/repository/springdatajpa`
- [H2 database](https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/resources/db/h2/schema.sql): `src/main/resources/db/h2/schema.sql`
- [MySQL database](https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/resources/db/mysql/schema.sql): `src/main/resources/db/mysql/schema.sql`
- [PostgreSQL database](https://github.com/iam-senthilkumar/spring-framework-petclinic/blob/main/src/main/resources/db/postgresql/schema.sql): `src/main/resources/db/postgresql/schema.sql`

### Other components

- **Clinic user**

## Connections

- Clinic user → Spring MVC: uses (evidence: `readme.md`)
- Spring MVC → Clinic service: presentation to service (evidence: `readme.md`)
- Clinic service → Repository contracts: service to repository (evidence: `readme.md`)
- Repository contracts → JPA repositories: selects implementation (evidence: `readme.md`)
- Repository contracts → JDBC repositories: selects implementation (evidence: `readme.md`)
- Repository contracts → Spring Data JPA: selects implementation (evidence: `readme.md`)
- JPA repositories → H2 database: uses by default (evidence: `readme.md`)
- JPA repositories → MySQL database: can use (evidence: `readme.md`)
- JPA repositories → PostgreSQL database: can use (evidence: `readme.md`)
