How andregnicoletti/spring-boot-cloud-ms-course works
This is a Spring Cloud microservices learning system. A client request enters through the gateway and is routed to domain services; payroll obtains worker data, while auth looks up user data for OAuth2/JWT authentication. User and worker services expose persisted domain data. Config Server, Eureka, and Feign provide configuration, discovery, and service-to-service communication. The README documents the broad platform relationships; source excerpts show the payroll/auth calls and user/worker persistence links. Other runtime wiring is not fully sampled, so those links are documented rather than inferred from module names.
Main entry points: HrGatewayApplication.java API Gateway · HrConfigServerApplication.java Config Server · UserService.java Auth Service · UserResource.java User Endpoint
Components 25
Cloud Platform
- API Gateway
hr-gateway/src/main/java/com/nicoletti/gateway/HrGatewayApplication.java - Config Server
hr-config-server/src/main/java/com/nicoletti/hrconfigserver/HrConfigServerApplication.java - Eureka Discovery
hr-eureka-server/src/main/java/com/nicoletti/hreurekaserver/HrEurekaServerApplication.java
Authentication
- Auth Service
hr-auth/src/main/java/com/nicoletti/hrauth/services/UserService.java - Auth User Endpoint
hr-auth/src/main/java/com/nicoletti/hrauth/resources/UserResources.java - User Feign Client
hr-auth/src/main/java/com/nicoletti/hrauth/feignclients/UserFeignClients.java - Auth User DTO
hr-auth/src/main/java/com/nicoletti/hrauth/dto/UserDTO.java - Auth Role DTO
hr-auth/src/main/java/com/nicoletti/hrauth/dto/RoleDTO.java
Payroll
- Payment Endpoint
hr-payroll/src/main/java/com/nicoletti/hrpayroll/resources/PaymentResource.java - Payment Calculator
hr-payroll/src/main/java/com/nicoletti/hrpayroll/services/PaymentService.java - Payment Model
hr-payroll/src/main/java/com/nicoletti/hrpayroll/entities/Payment.java - Worker Feign Client
hr-payroll/src/main/java/com/nicoletti/hrpayroll/feignclients/WorkerFeignClient.java - Worker DTO
hr-payroll/src/main/java/com/nicoletti/hrpayroll/dto/WorkerDTO.java - Worker Fallback
hr-payroll/src/main/java/com/nicoletti/hrpayroll/feignclients/fallback/WorkerFallback.java
User Accounts
- User Endpoint
hr-user/src/main/java/com/nicoletti/hruser/resources/UserResource.java - User Repository
hr-user/src/main/java/com/nicoletti/hruser/repositories/UserRepository.java - User Entity
hr-user/src/main/java/com/nicoletti/hruser/entities/User.java - Role Entity
hr-user/src/main/java/com/nicoletti/hruser/entities/Role.java - User Database
hr-user/src/main/resources/application.properties
Worker Records
- Worker Endpoint
hr-worker/src/main/java/com/nicoletti/hrworker/resources/WorkResource.java - Worker Repository
hr-worker/src/main/java/com/nicoletti/hrworker/repositories/WorkerRepository.java - Worker Entity
hr-worker/src/main/java/com/nicoletti/hrworker/entities/Worker.java - Worker Database
hr-worker/src/main/resources/application.properties
Other components
- API Client
- Git Config Repo
Connections 34
- API Client → API Gateway: sends requests
README.md - API Gateway → Auth Service: routes requests
README.md - API Gateway → Payment Endpoint: routes requests
README.md - API Gateway → User Endpoint: routes requests
README.md - API Gateway → Worker Endpoint: routes requests
README.md - Config Server → Git Config Repo: loads config
README.md - Config Server → API Gateway: provides config
README.md - Config Server → Auth Service: provides config
README.md - Config Server → Payment Endpoint: provides config
README.md - Config Server → User Endpoint: provides config
README.md - Config Server → Worker Endpoint: provides config
README.md - API Gateway → Eureka Discovery: discovers services
README.md - Auth Service → Eureka Discovery: registers with
README.md - Payment Endpoint → Eureka Discovery: registers with
README.md - User Endpoint → Eureka Discovery: registers with
README.md - Worker Endpoint → Eureka Discovery: registers with
README.md - Auth User Endpoint → Auth Service: delegates to
hr-auth/src/main/java/com/nicoletti/hrauth/resources/UserResources.java - Auth Service → User Feign Client: looks up user
hr-auth/src/main/java/com/nicoletti/hrauth/services/UserService.java - User Feign Client → User Endpoint: requests user
hr-auth/src/main/java/com/nicoletti/hrauth/feignclients/UserFeignClients.java - Auth Service → Auth User DTO: returns user data
hr-auth/src/main/java/com/nicoletti/hrauth/services/UserService.java - Auth User DTO → Auth Role DTO: contains roles
hr-auth/src/main/java/com/nicoletti/hrauth/dto/UserDTO.java - Payment Endpoint → Payment Calculator: delegates to
hr-payroll/src/main/java/com/nicoletti/hrpayroll/resources/PaymentResource.java - Payment Calculator → Worker Feign Client: fetches worker
hr-payroll/src/main/java/com/nicoletti/hrpayroll/services/PaymentService.java - Worker Feign Client → Worker Endpoint: requests worker
hr-payroll/src/main/java/com/nicoletti/hrpayroll/feignclients/WorkerFeignClient.java - Payment Calculator → Payment Model: builds payment
hr-payroll/src/main/java/com/nicoletti/hrpayroll/services/PaymentService.java - Payment Calculator → Worker DTO: uses worker data
hr-payroll/src/main/java/com/nicoletti/hrpayroll/services/PaymentService.java - Worker Fallback → Worker Feign Client: implements fallback
hr-payroll/src/main/java/com/nicoletti/hrpayroll/feignclients/fallback/WorkerFallback.java - User Endpoint → User Repository: queries
hr-user/src/main/java/com/nicoletti/hruser/resources/UserResource.java - User Repository → User Entity: persists
hr-user/src/main/java/com/nicoletti/hruser/repositories/UserRepository.java - User Entity → Role Entity: has roles
hr-user/src/main/java/com/nicoletti/hruser/entities/User.java - User Repository → User Database: reads and writes
- Worker Endpoint → Worker Repository: queries
hr-worker/src/main/java/com/nicoletti/hrworker/resources/WorkResource.java - Worker Repository → Worker Entity: persists
hr-worker/src/main/java/com/nicoletti/hrworker/repositories/WorkerRepository.java - Worker Repository → Worker Database: reads and writes