How spaceurgent/pet-clinic-cloud-microservices works
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: ApiGateway.java API gateway · RoleBasedRoute.jsx Role routes · App.js React application · PetController.java Customer and pet API
Components 21
Web client
- React application
frontend/src/App.js - Role routes
frontend/src/shared/components/RoleBasedRoute.jsx - Customer pages
frontend/src/customer/components/pages - Vet pages
frontend/src/vet/components/pages - Admin pages
frontend/src/admin/component/pages - Authenticated API client
frontend/src/shared/api/useApiClient.js
Access and platform
- API gateway
api-gateway/src/main/java/io/spaceurgent/clinic/api/gateway/ApiGateway.java - OAuth2 authorization
auth-server/src/main/java/io/spaceurgent/clinic/auth/server/infrastructure/configuration/auth/AuthorizationServerConfiguration.java - Config server
config-server/src/main/java/io/spaceurgent/clinic/config/server/ConfigServer.java - Service discovery
discovery-server/src/main/java/io/spaceurgent/clinic/discovery/server/DiscoveryServer.java - Monitoring and logging
Customer and vet domains
- Customer and pet API
customer-service/src/main/java/io/spaceurgent/clinic/customer/service/api/PetController.java - Customer and pet services
customer-service/src/main/java/io/spaceurgent/clinic/customer/service/application/service/impl - Customer data
customer-service/src/main/java/io/spaceurgent/clinic/customer/service/domain/repository/CustomerRepository.java - Vet management API
vet-service/src/main/java/io/spaceurgent/clinic/vet/service/api/VetController.java - Vet and specialty services
vet-service/src/main/java/io/spaceurgent/clinic/vet/service/application/service/impl
Visit management
- Visit and availability API
visit-service/src/main/java/io/spaceurgent/clinic/visit/service/api/VisitController.java - Visit scheduling
visit-service/src/main/java/io/spaceurgent/clinic/visit/service/application/service/impl - Visit data
visit-service/src/main/java/io/spaceurgent/clinic/visit/service/domain/repository/VisitRepository.java
Other components
- Clinic user
- PostgreSQL
Connections 23
- Clinic user → React application: uses
- React application → Role routes: selects routes
- Role routes → Customer pages: guards customer pages
frontend/src/customer/CustomerRoutes.jsx - Role routes → Vet pages: guards vet pages
frontend/src/vet/VetRoutes.jsx - Role routes → Admin pages: guards admin pages
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
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
vet-service/src/main/java/io/spaceurgent/clinic/vet/service/api/VetController.java - Visit and availability API → Visit scheduling: dispatches visit actions
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