# spaceurgent/pet-clinic-cloud-microservices architecture

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

- Interactive diagram: https://gitdiagram.com/spaceurgent/pet-clinic-cloud-microservices
- Repository: https://github.com/spaceurgent/pet-clinic-cloud-microservices

## Overview

Pet Clinic Cloud is a role-based veterinary clinic system. Customers register pets and book visits; vets manage visit completion; administrators maintain vets, specialties, and clinic services. The React frontend uses OAuth2-protected REST APIs through the gateway, while backend services own customer/pet, veterinary, and visit scheduling domains. Configuration, discovery, and authorization are separate infrastructure services. The README documents monitoring and logging capabilities, but their implementation is not in the supplied tree. Edges reflect shown route/service calls or README statements; unsampled wiring is omitted.

Main entry points: [`api-gateway/src/main/java/io/spaceurgent/clinic/api/gateway/ApiGateway.java`](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/api-gateway/src/main/java/io/spaceurgent/clinic/api/gateway/ApiGateway.java) (API gateway), [`frontend/src/shared/components/RoleBasedRoute.jsx`](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/frontend/src/shared/components/RoleBasedRoute.jsx) (Role routes), [`frontend/src/App.js`](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/frontend/src/App.js) (React application), [`customer-service/src/main/java/io/spaceurgent/clinic/customer/service/api/PetController.java`](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/customer-service/src/main/java/io/spaceurgent/clinic/customer/service/api/PetController.java) (Customer and pet API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_frontend["React application<br/>[App.js]"]
  node_role_routes["Role routes<br/>[RoleBasedRoute.jsx]"]
  node_customer_ui["Customer pages"]
  node_vet_ui["Vet pages"]
  node_admin_ui["Admin pages"]
  node_api_client["Authenticated API client<br/>[useApiClient.js]"]
end

subgraph group_access["Access and platform"]
  node_gateway["API gateway<br/>[ApiGateway.java]"]
  node_auth["OAuth2 authorization"]
  node_config["Config server<br/>[ConfigServer.java]"]
  node_discovery["Service discovery"]
  node_monitoring["Monitoring and logging"]
end

subgraph group_people["Customer and vet domains"]
  node_customer_api["Customer and pet API<br/>[PetController.java]"]
  node_customer_domain["Customer and pet services"]
  node_customer_store[("Customer data")]
  node_vet_api["Vet management API<br/>[VetController.java]"]
  node_vet_domain["Vet and specialty services"]
end

subgraph group_visits["Visit management"]
  node_visit_api["Visit and availability API"]
  node_visit_domain["Visit scheduling"]
  node_visit_store[("Visit data")]
end

node_user(("Clinic user"))
node_postgres[("PostgreSQL")]

node_user -->|"uses"| node_frontend
node_frontend -->|"selects routes"| node_role_routes
node_role_routes -->|"guards customer pages"| node_customer_ui
node_role_routes -->|"guards vet pages"| node_vet_ui
node_role_routes -->|"guards admin pages"| node_admin_ui
node_frontend -->|"uses secured APIs"| node_api_client
node_api_client -->|"sends bearer requests"| node_gateway
node_gateway -->|"validates tokens"| node_auth
node_gateway -->|"routes requests"| node_customer_api
node_gateway -->|"routes requests"| node_vet_api
node_gateway -->|"routes requests"| node_visit_api
node_customer_api -->|"calls pet service"| node_customer_domain
node_customer_domain -.->|"persists records"| node_customer_store
node_vet_api -->|"calls vet service"| node_vet_domain
node_visit_api -->|"dispatches visit actions"| node_visit_domain
node_visit_domain -.->|"persists visits"| node_visit_store
node_customer_api -.->|"registers accounts"| node_auth
node_vet_api -->|"registers accounts"| node_auth
node_config -.->|"centralizes configuration"| node_gateway
node_discovery -.->|"supports discovery"| node_gateway
node_postgres -.->|"stores domain data"| node_customer_domain
node_postgres -.->|"stores domain data"| node_visit_domain
node_monitoring -.->|"observes services"| node_gateway

click node_frontend "https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/frontend/src/App.js"
click node_role_routes "https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/frontend/src/shared/components/RoleBasedRoute.jsx"
click node_customer_ui "https://github.com/spaceurgent/pet-clinic-cloud-microservices/tree/main/frontend/src/customer/components/pages"
click node_vet_ui "https://github.com/spaceurgent/pet-clinic-cloud-microservices/tree/main/frontend/src/vet/components/pages"
click node_admin_ui "https://github.com/spaceurgent/pet-clinic-cloud-microservices/tree/main/frontend/src/admin/component/pages"
click node_api_client "https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/frontend/src/shared/api/useApiClient.js"
click node_gateway "https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/api-gateway/src/main/java/io/spaceurgent/clinic/api/gateway/ApiGateway.java"
click node_auth "https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/auth-server/src/main/java/io/spaceurgent/clinic/auth/server/infrastructure/configuration/auth/AuthorizationServerConfiguration.java"
click node_config "https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/config-server/src/main/java/io/spaceurgent/clinic/config/server/ConfigServer.java"
click node_discovery "https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/discovery-server/src/main/java/io/spaceurgent/clinic/discovery/server/DiscoveryServer.java"
click node_customer_api "https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/customer-service/src/main/java/io/spaceurgent/clinic/customer/service/api/PetController.java"
click node_customer_domain "https://github.com/spaceurgent/pet-clinic-cloud-microservices/tree/main/customer-service/src/main/java/io/spaceurgent/clinic/customer/service/application/service/impl"
click node_customer_store "https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/customer-service/src/main/java/io/spaceurgent/clinic/customer/service/domain/repository/CustomerRepository.java"
click node_vet_api "https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/vet-service/src/main/java/io/spaceurgent/clinic/vet/service/api/VetController.java"
click node_vet_domain "https://github.com/spaceurgent/pet-clinic-cloud-microservices/tree/main/vet-service/src/main/java/io/spaceurgent/clinic/vet/service/application/service/impl"
click node_visit_api "https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/visit-service/src/main/java/io/spaceurgent/clinic/visit/service/api/VisitController.java"
click node_visit_domain "https://github.com/spaceurgent/pet-clinic-cloud-microservices/tree/main/visit-service/src/main/java/io/spaceurgent/clinic/visit/service/application/service/impl"
click node_visit_store "https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/visit-service/src/main/java/io/spaceurgent/clinic/visit/service/domain/repository/VisitRepository.java"

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_frontend,node_role_routes,node_customer_ui,node_vet_ui,node_admin_ui,node_api_client,node_user toneBlue
class node_gateway,node_auth,node_config,node_discovery,node_monitoring,node_postgres toneAmber
class node_customer_api,node_customer_domain,node_customer_store,node_vet_api,node_vet_domain toneMint
class node_visit_api,node_visit_domain,node_visit_store toneRose
```

## Components

### Web client

- [React application](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Role routes](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/frontend/src/shared/components/RoleBasedRoute.jsx): `frontend/src/shared/components/RoleBasedRoute.jsx`
- [Customer pages](https://github.com/spaceurgent/pet-clinic-cloud-microservices/tree/main/frontend/src/customer/components/pages): `frontend/src/customer/components/pages`
- [Vet pages](https://github.com/spaceurgent/pet-clinic-cloud-microservices/tree/main/frontend/src/vet/components/pages): `frontend/src/vet/components/pages`
- [Admin pages](https://github.com/spaceurgent/pet-clinic-cloud-microservices/tree/main/frontend/src/admin/component/pages): `frontend/src/admin/component/pages`
- [Authenticated API client](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/frontend/src/shared/api/useApiClient.js): `frontend/src/shared/api/useApiClient.js`

### Access and platform

- [API gateway](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/api-gateway/src/main/java/io/spaceurgent/clinic/api/gateway/ApiGateway.java): `api-gateway/src/main/java/io/spaceurgent/clinic/api/gateway/ApiGateway.java`
- [OAuth2 authorization](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/auth-server/src/main/java/io/spaceurgent/clinic/auth/server/infrastructure/configuration/auth/AuthorizationServerConfiguration.java): `auth-server/src/main/java/io/spaceurgent/clinic/auth/server/infrastructure/configuration/auth/AuthorizationServerConfiguration.java`
- [Config server](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/config-server/src/main/java/io/spaceurgent/clinic/config/server/ConfigServer.java): `config-server/src/main/java/io/spaceurgent/clinic/config/server/ConfigServer.java`
- [Service discovery](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/discovery-server/src/main/java/io/spaceurgent/clinic/discovery/server/DiscoveryServer.java): `discovery-server/src/main/java/io/spaceurgent/clinic/discovery/server/DiscoveryServer.java`
- **Monitoring and logging**

### Customer and vet domains

- [Customer and pet API](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/customer-service/src/main/java/io/spaceurgent/clinic/customer/service/api/PetController.java): `customer-service/src/main/java/io/spaceurgent/clinic/customer/service/api/PetController.java`
- [Customer and pet services](https://github.com/spaceurgent/pet-clinic-cloud-microservices/tree/main/customer-service/src/main/java/io/spaceurgent/clinic/customer/service/application/service/impl): `customer-service/src/main/java/io/spaceurgent/clinic/customer/service/application/service/impl`
- [Customer data](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/customer-service/src/main/java/io/spaceurgent/clinic/customer/service/domain/repository/CustomerRepository.java): `customer-service/src/main/java/io/spaceurgent/clinic/customer/service/domain/repository/CustomerRepository.java`
- [Vet management API](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/vet-service/src/main/java/io/spaceurgent/clinic/vet/service/api/VetController.java): `vet-service/src/main/java/io/spaceurgent/clinic/vet/service/api/VetController.java`
- [Vet and specialty services](https://github.com/spaceurgent/pet-clinic-cloud-microservices/tree/main/vet-service/src/main/java/io/spaceurgent/clinic/vet/service/application/service/impl): `vet-service/src/main/java/io/spaceurgent/clinic/vet/service/application/service/impl`

### Visit management

- [Visit and availability API](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/visit-service/src/main/java/io/spaceurgent/clinic/visit/service/api/VisitController.java): `visit-service/src/main/java/io/spaceurgent/clinic/visit/service/api/VisitController.java`
- [Visit scheduling](https://github.com/spaceurgent/pet-clinic-cloud-microservices/tree/main/visit-service/src/main/java/io/spaceurgent/clinic/visit/service/application/service/impl): `visit-service/src/main/java/io/spaceurgent/clinic/visit/service/application/service/impl`
- [Visit data](https://github.com/spaceurgent/pet-clinic-cloud-microservices/blob/main/visit-service/src/main/java/io/spaceurgent/clinic/visit/service/domain/repository/VisitRepository.java): `visit-service/src/main/java/io/spaceurgent/clinic/visit/service/domain/repository/VisitRepository.java`

### Other components

- **Clinic user**
- **PostgreSQL**

## Connections

- Clinic user → React application: uses
- React application → Role routes: selects routes
- Role routes → Customer pages: guards customer pages (evidence: `frontend/src/customer/CustomerRoutes.jsx`)
- Role routes → Vet pages: guards vet pages (evidence: `frontend/src/vet/VetRoutes.jsx`)
- Role routes → Admin pages: guards admin pages (evidence: `frontend/src/admin/AdminRoutes.jsx`)
- React application → Authenticated API client: uses secured APIs
- Authenticated API client → API gateway: sends bearer requests
- API gateway → OAuth2 authorization: validates tokens
- API gateway → Customer and pet API: routes requests
- API gateway → Vet management API: routes requests
- API gateway → Visit and availability API: routes requests
- Customer and pet API → Customer and pet services: calls pet service (evidence: `customer-service/src/main/java/io/spaceurgent/clinic/customer/service/api/PetController.java`)
- Customer and pet services → Customer data: persists records
- Vet management API → Vet and specialty services: calls vet service (evidence: `vet-service/src/main/java/io/spaceurgent/clinic/vet/service/api/VetController.java`)
- Visit and availability API → Visit scheduling: dispatches visit actions (evidence: `visit-service/src/main/java/io/spaceurgent/clinic/visit/service/api/VisitController.java`)
- Visit scheduling → Visit data: persists visits
- Customer and pet API → OAuth2 authorization: registers accounts
- Vet management API → OAuth2 authorization: registers accounts
- Config server → API gateway: centralizes configuration
- Service discovery → API gateway: supports discovery
- PostgreSQL → Customer and pet services: stores domain data
- PostgreSQL → Visit scheduling: stores domain data
- Monitoring and logging → API gateway: observes services
