# andregnicoletti/spring-boot-cloud-ms-course architecture

> Architecture diagram of the GitHub repository andregnicoletti/spring-boot-cloud-ms-course, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/andregnicoletti/spring-boot-cloud-ms-course
- Repository: https://github.com/andregnicoletti/spring-boot-cloud-ms-course

## Overview

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: [`hr-gateway/src/main/java/com/nicoletti/gateway/HrGatewayApplication.java`](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-gateway/src/main/java/com/nicoletti/gateway/HrGatewayApplication.java) (API Gateway), [`hr-config-server/src/main/java/com/nicoletti/hrconfigserver/HrConfigServerApplication.java`](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-config-server/src/main/java/com/nicoletti/hrconfigserver/HrConfigServerApplication.java) (Config Server), [`hr-auth/src/main/java/com/nicoletti/hrauth/services/UserService.java`](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-auth/src/main/java/com/nicoletti/hrauth/services/UserService.java) (Auth Service), [`hr-user/src/main/java/com/nicoletti/hruser/resources/UserResource.java`](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-user/src/main/java/com/nicoletti/hruser/resources/UserResource.java) (User Endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["Cloud Platform"]
  node_gateway["API Gateway"]
  node_config["Config Server"]
  node_eureka["Eureka Discovery"]
end

subgraph group_security["Authentication"]
  node_auth["Auth Service<br/>[UserService.java]"]
  node_authresource["Auth User Endpoint<br/>[UserResources.java]"]
  node_authclient["User Feign Client"]
  node_userdto["Auth User DTO<br/>[UserDTO.java]"]
  node_roledto["Auth Role DTO<br/>[RoleDTO.java]"]
end

subgraph group_payroll["Payroll"]
  node_paymentresource["Payment Endpoint"]
  node_paymentservice["Payment Calculator"]
  node_payment["Payment Model<br/>[Payment.java]"]
  node_workerclient["Worker Feign Client"]
  node_workerdto["Worker DTO<br/>[WorkerDTO.java]"]
  node_workerfallback["Worker Fallback"]
end

subgraph group_users["User Accounts"]
  node_userresource["User Endpoint<br/>[UserResource.java]"]
  node_userrepo["User Repository"]
  node_userentity["User Entity<br/>[User.java]"]
  node_roleentity["Role Entity<br/>[Role.java]"]
  node_userdb[("User Database")]
end

subgraph group_workers["Worker Records"]
  node_workerresource["Worker Endpoint<br/>[WorkResource.java]"]
  node_workerrepo["Worker Repository"]
  node_workerentity["Worker Entity<br/>[Worker.java]"]
  node_workerdb[("Worker Database")]
end

node_client(("API Client"))
node_gitconfig[("Git Config Repo")]

node_client -->|"sends requests"| node_gateway
node_gateway -->|"routes requests"| node_auth
node_gateway -->|"routes requests"| node_paymentresource
node_gateway -->|"routes requests"| node_userresource
node_gateway -->|"routes requests"| node_workerresource
node_config -->|"loads config"| node_gitconfig
node_config -.->|"provides config"| node_gateway
node_config -.->|"provides config"| node_auth
node_config -.->|"provides config"| node_paymentresource
node_config -.->|"provides config"| node_userresource
node_config -.->|"provides config"| node_workerresource
node_gateway -.->|"discovers services"| node_eureka
node_auth -.->|"registers with"| node_eureka
node_paymentresource -.->|"registers with"| node_eureka
node_userresource -.->|"registers with"| node_eureka
node_workerresource -.->|"registers with"| node_eureka
node_authresource -->|"delegates to"| node_auth
node_auth -->|"looks up user"| node_authclient
node_authclient -->|"requests user"| node_userresource
node_auth -->|"returns user data"| node_userdto
node_userdto -->|"contains roles"| node_roledto
node_paymentresource -->|"delegates to"| node_paymentservice
node_paymentservice -->|"fetches worker"| node_workerclient
node_workerclient -->|"requests worker"| node_workerresource
node_paymentservice -->|"builds payment"| node_payment
node_paymentservice -->|"uses worker data"| node_workerdto
node_workerfallback -->|"implements fallback"| node_workerclient
node_userresource -->|"queries"| node_userrepo
node_userrepo -->|"persists"| node_userentity
node_userentity -->|"has roles"| node_roleentity
node_userrepo -.->|"reads and writes"| node_userdb
node_workerresource -->|"queries"| node_workerrepo
node_workerrepo -->|"persists"| node_workerentity
node_workerrepo -.->|"reads and writes"| node_workerdb

click node_gateway "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-gateway/src/main/java/com/nicoletti/gateway/HrGatewayApplication.java"
click node_config "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-config-server/src/main/java/com/nicoletti/hrconfigserver/HrConfigServerApplication.java"
click node_eureka "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-eureka-server/src/main/java/com/nicoletti/hreurekaserver/HrEurekaServerApplication.java"
click node_auth "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-auth/src/main/java/com/nicoletti/hrauth/services/UserService.java"
click node_authresource "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-auth/src/main/java/com/nicoletti/hrauth/resources/UserResources.java"
click node_authclient "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-auth/src/main/java/com/nicoletti/hrauth/feignclients/UserFeignClients.java"
click node_userdto "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-auth/src/main/java/com/nicoletti/hrauth/dto/UserDTO.java"
click node_roledto "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-auth/src/main/java/com/nicoletti/hrauth/dto/RoleDTO.java"
click node_paymentresource "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-payroll/src/main/java/com/nicoletti/hrpayroll/resources/PaymentResource.java"
click node_paymentservice "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-payroll/src/main/java/com/nicoletti/hrpayroll/services/PaymentService.java"
click node_payment "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-payroll/src/main/java/com/nicoletti/hrpayroll/entities/Payment.java"
click node_workerclient "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-payroll/src/main/java/com/nicoletti/hrpayroll/feignclients/WorkerFeignClient.java"
click node_workerdto "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-payroll/src/main/java/com/nicoletti/hrpayroll/dto/WorkerDTO.java"
click node_workerfallback "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-payroll/src/main/java/com/nicoletti/hrpayroll/feignclients/fallback/WorkerFallback.java"
click node_userresource "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-user/src/main/java/com/nicoletti/hruser/resources/UserResource.java"
click node_userrepo "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-user/src/main/java/com/nicoletti/hruser/repositories/UserRepository.java"
click node_userentity "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-user/src/main/java/com/nicoletti/hruser/entities/User.java"
click node_roleentity "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-user/src/main/java/com/nicoletti/hruser/entities/Role.java"
click node_userdb "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-user/src/main/resources/application.properties"
click node_workerresource "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-worker/src/main/java/com/nicoletti/hrworker/resources/WorkResource.java"
click node_workerrepo "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-worker/src/main/java/com/nicoletti/hrworker/repositories/WorkerRepository.java"
click node_workerentity "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-worker/src/main/java/com/nicoletti/hrworker/entities/Worker.java"
click node_workerdb "https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-worker/src/main/resources/application.properties"

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_gateway,node_config,node_eureka,node_client toneBlue
class node_auth,node_authresource,node_authclient,node_userdto,node_roledto,node_gitconfig toneAmber
class node_paymentresource,node_paymentservice,node_payment,node_workerclient,node_workerdto,node_workerfallback toneMint
class node_userresource,node_userrepo,node_userentity,node_roleentity,node_userdb toneRose
class node_workerresource,node_workerrepo,node_workerentity,node_workerdb toneIndigo
```

## Components

### Cloud Platform

- [API Gateway](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-gateway/src/main/java/com/nicoletti/gateway/HrGatewayApplication.java): `hr-gateway/src/main/java/com/nicoletti/gateway/HrGatewayApplication.java`
- [Config Server](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-config-server/src/main/java/com/nicoletti/hrconfigserver/HrConfigServerApplication.java): `hr-config-server/src/main/java/com/nicoletti/hrconfigserver/HrConfigServerApplication.java`
- [Eureka Discovery](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-eureka-server/src/main/java/com/nicoletti/hreurekaserver/HrEurekaServerApplication.java): `hr-eureka-server/src/main/java/com/nicoletti/hreurekaserver/HrEurekaServerApplication.java`

### Authentication

- [Auth Service](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-auth/src/main/java/com/nicoletti/hrauth/services/UserService.java): `hr-auth/src/main/java/com/nicoletti/hrauth/services/UserService.java`
- [Auth User Endpoint](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-auth/src/main/java/com/nicoletti/hrauth/resources/UserResources.java): `hr-auth/src/main/java/com/nicoletti/hrauth/resources/UserResources.java`
- [User Feign Client](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-auth/src/main/java/com/nicoletti/hrauth/feignclients/UserFeignClients.java): `hr-auth/src/main/java/com/nicoletti/hrauth/feignclients/UserFeignClients.java`
- [Auth User DTO](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-auth/src/main/java/com/nicoletti/hrauth/dto/UserDTO.java): `hr-auth/src/main/java/com/nicoletti/hrauth/dto/UserDTO.java`
- [Auth Role DTO](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-auth/src/main/java/com/nicoletti/hrauth/dto/RoleDTO.java): `hr-auth/src/main/java/com/nicoletti/hrauth/dto/RoleDTO.java`

### Payroll

- [Payment Endpoint](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-payroll/src/main/java/com/nicoletti/hrpayroll/resources/PaymentResource.java): `hr-payroll/src/main/java/com/nicoletti/hrpayroll/resources/PaymentResource.java`
- [Payment Calculator](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-payroll/src/main/java/com/nicoletti/hrpayroll/services/PaymentService.java): `hr-payroll/src/main/java/com/nicoletti/hrpayroll/services/PaymentService.java`
- [Payment Model](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-payroll/src/main/java/com/nicoletti/hrpayroll/entities/Payment.java): `hr-payroll/src/main/java/com/nicoletti/hrpayroll/entities/Payment.java`
- [Worker Feign Client](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-payroll/src/main/java/com/nicoletti/hrpayroll/feignclients/WorkerFeignClient.java): `hr-payroll/src/main/java/com/nicoletti/hrpayroll/feignclients/WorkerFeignClient.java`
- [Worker DTO](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-payroll/src/main/java/com/nicoletti/hrpayroll/dto/WorkerDTO.java): `hr-payroll/src/main/java/com/nicoletti/hrpayroll/dto/WorkerDTO.java`
- [Worker Fallback](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-payroll/src/main/java/com/nicoletti/hrpayroll/feignclients/fallback/WorkerFallback.java): `hr-payroll/src/main/java/com/nicoletti/hrpayroll/feignclients/fallback/WorkerFallback.java`

### User Accounts

- [User Endpoint](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-user/src/main/java/com/nicoletti/hruser/resources/UserResource.java): `hr-user/src/main/java/com/nicoletti/hruser/resources/UserResource.java`
- [User Repository](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-user/src/main/java/com/nicoletti/hruser/repositories/UserRepository.java): `hr-user/src/main/java/com/nicoletti/hruser/repositories/UserRepository.java`
- [User Entity](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-user/src/main/java/com/nicoletti/hruser/entities/User.java): `hr-user/src/main/java/com/nicoletti/hruser/entities/User.java`
- [Role Entity](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-user/src/main/java/com/nicoletti/hruser/entities/Role.java): `hr-user/src/main/java/com/nicoletti/hruser/entities/Role.java`
- [User Database](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-user/src/main/resources/application.properties): `hr-user/src/main/resources/application.properties`

### Worker Records

- [Worker Endpoint](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-worker/src/main/java/com/nicoletti/hrworker/resources/WorkResource.java): `hr-worker/src/main/java/com/nicoletti/hrworker/resources/WorkResource.java`
- [Worker Repository](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-worker/src/main/java/com/nicoletti/hrworker/repositories/WorkerRepository.java): `hr-worker/src/main/java/com/nicoletti/hrworker/repositories/WorkerRepository.java`
- [Worker Entity](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-worker/src/main/java/com/nicoletti/hrworker/entities/Worker.java): `hr-worker/src/main/java/com/nicoletti/hrworker/entities/Worker.java`
- [Worker Database](https://github.com/andregnicoletti/spring-boot-cloud-ms-course/blob/main/hr-worker/src/main/resources/application.properties): `hr-worker/src/main/resources/application.properties`

### Other components

- **API Client**
- **Git Config Repo**

## Connections

- API Client → API Gateway: sends requests (evidence: `README.md`)
- API Gateway → Auth Service: routes requests (evidence: `README.md`)
- API Gateway → Payment Endpoint: routes requests (evidence: `README.md`)
- API Gateway → User Endpoint: routes requests (evidence: `README.md`)
- API Gateway → Worker Endpoint: routes requests (evidence: `README.md`)
- Config Server → Git Config Repo: loads config (evidence: `README.md`)
- Config Server → API Gateway: provides config (evidence: `README.md`)
- Config Server → Auth Service: provides config (evidence: `README.md`)
- Config Server → Payment Endpoint: provides config (evidence: `README.md`)
- Config Server → User Endpoint: provides config (evidence: `README.md`)
- Config Server → Worker Endpoint: provides config (evidence: `README.md`)
- API Gateway → Eureka Discovery: discovers services (evidence: `README.md`)
- Auth Service → Eureka Discovery: registers with (evidence: `README.md`)
- Payment Endpoint → Eureka Discovery: registers with (evidence: `README.md`)
- User Endpoint → Eureka Discovery: registers with (evidence: `README.md`)
- Worker Endpoint → Eureka Discovery: registers with (evidence: `README.md`)
- Auth User Endpoint → Auth Service: delegates to (evidence: `hr-auth/src/main/java/com/nicoletti/hrauth/resources/UserResources.java`)
- Auth Service → User Feign Client: looks up user (evidence: `hr-auth/src/main/java/com/nicoletti/hrauth/services/UserService.java`)
- User Feign Client → User Endpoint: requests user (evidence: `hr-auth/src/main/java/com/nicoletti/hrauth/feignclients/UserFeignClients.java`)
- Auth Service → Auth User DTO: returns user data (evidence: `hr-auth/src/main/java/com/nicoletti/hrauth/services/UserService.java`)
- Auth User DTO → Auth Role DTO: contains roles (evidence: `hr-auth/src/main/java/com/nicoletti/hrauth/dto/UserDTO.java`)
- Payment Endpoint → Payment Calculator: delegates to (evidence: `hr-payroll/src/main/java/com/nicoletti/hrpayroll/resources/PaymentResource.java`)
- Payment Calculator → Worker Feign Client: fetches worker (evidence: `hr-payroll/src/main/java/com/nicoletti/hrpayroll/services/PaymentService.java`)
- Worker Feign Client → Worker Endpoint: requests worker (evidence: `hr-payroll/src/main/java/com/nicoletti/hrpayroll/feignclients/WorkerFeignClient.java`)
- Payment Calculator → Payment Model: builds payment (evidence: `hr-payroll/src/main/java/com/nicoletti/hrpayroll/services/PaymentService.java`)
- Payment Calculator → Worker DTO: uses worker data (evidence: `hr-payroll/src/main/java/com/nicoletti/hrpayroll/services/PaymentService.java`)
- Worker Fallback → Worker Feign Client: implements fallback (evidence: `hr-payroll/src/main/java/com/nicoletti/hrpayroll/feignclients/fallback/WorkerFallback.java`)
- User Endpoint → User Repository: queries (evidence: `hr-user/src/main/java/com/nicoletti/hruser/resources/UserResource.java`)
- User Repository → User Entity: persists (evidence: `hr-user/src/main/java/com/nicoletti/hruser/repositories/UserRepository.java`)
- User Entity → Role Entity: has roles (evidence: `hr-user/src/main/java/com/nicoletti/hruser/entities/User.java`)
- User Repository → User Database: reads and writes
- Worker Endpoint → Worker Repository: queries (evidence: `hr-worker/src/main/java/com/nicoletti/hrworker/resources/WorkResource.java`)
- Worker Repository → Worker Entity: persists (evidence: `hr-worker/src/main/java/com/nicoletti/hrworker/repositories/WorkerRepository.java`)
- Worker Repository → Worker Database: reads and writes
