# forezp/springcloudlearning architecture

> Architecture diagram of the GitHub repository forezp/springcloudlearning, 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/forezp/springcloudlearning
- Repository: https://github.com/forezp/springcloudlearning

## Overview

This repository is a collection of Spring Cloud tutorial examples, not one deployed application. Across successive versions, the principal demonstrated workflow is an HTTP request reaching a consumer controller, invoking a Feign client, and calling a provider; the sampled Feign code supports that flow. Other chapters demonstrate service discovery, gateways, centralized configuration, resilience, tracing, and monitoring. Many examples are unsampled and duplicated across versions, so those capabilities are represented by their exact enclosing directories; links whose runtime wiring is not shown are omitted.

Main entry points: [`chapter3/service-feign/src/main/java/com/forezp/service/SchedualServiceHi.java`](https://github.com/forezp/springcloudlearning/blob/master/chapter3/service-feign/src/main/java/com/forezp/service/SchedualServiceHi.java) (Feign service client), [`sc-f-gateway-first-sight/src/main/java/gateway/Application.java`](https://github.com/forezp/springcloudlearning/blob/master/sc-f-gateway-first-sight/src/main/java/gateway/Application.java) (Spring Cloud Gateway), [`sc-2020-chapter1/consumer/src/main/java/io/github/forezp/consumer/web/ConsumerController.java`](https://github.com/forezp/springcloudlearning/blob/master/sc-2020-chapter1/consumer/src/main/java/io/github/forezp/consumer/web/ConsumerController.java) (Consumer controller), [`sc-2020-chapter1/consumer/src/main/java/io/github/forezp/consumer/client/ProviderClient.java`](https://github.com/forezp/springcloudlearning/blob/master/sc-2020-chapter1/consumer/src/main/java/io/github/forezp/consumer/client/ProviderClient.java) (Feign provider client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_invocation["Service invocation"]
  node_consumer_controller["Consumer controller"]
  node_provider_client["Feign provider client"]
  node_provider["Service provider"]
  node_feign_controller["Feign demo controller<br/>[HiController.java]"]
  node_feign_client["Feign service client"]
end

subgraph group_platform["Service platform"]
  node_eureka["Eureka discovery"]
  node_nacos_provider["Nacos provider"]
  node_nacos_config["Nacos config demo"]
  node_config_server["Config server"]
  node_config_client["Config client"]
end

subgraph group_gateway["Gateway examples"]
  node_gateway["Spring Cloud Gateway<br/>[Application.java]"]
  node_gateway_filters["Gateway filters"]
  node_rate_keys["Rate-limit keys"]
end

subgraph group_operations["Resilience and observability"]
  node_hystrix["Circuit-breaker demos"]
  node_turbine["Turbine aggregation"]
  node_sleuth["Sleuth tracing demos"]
  node_zipkin["Zipkin server"]
  node_admin["Spring Boot Admin"]
end

node_caller(("HTTP caller"))

node_caller -->|"requests"| node_consumer_controller
node_consumer_controller -->|"invokes"| node_provider_client
node_caller -->|"requests"| node_feign_controller
node_feign_controller -->|"invokes"| node_feign_client
node_feign_client -->|"calls service-hi"| node_provider
node_provider_client -.->|"calls provider"| node_provider
node_eureka -.->|"discovery"| node_feign_client
node_nacos_config -.->|"configures"| node_nacos_provider
node_config_client -.->|"gets configuration"| node_config_server
node_caller -.->|"routes through"| node_gateway
node_gateway -.->|"applies"| node_gateway_filters
node_gateway -->|"resolves rate keys"| node_rate_keys
node_feign_client -.->|"fallback capability"| node_hystrix
node_hystrix -.->|"monitoring demos"| node_turbine
node_sleuth -.->|"traces to"| node_zipkin

click node_consumer_controller "https://github.com/forezp/springcloudlearning/blob/master/sc-2020-chapter1/consumer/src/main/java/io/github/forezp/consumer/web/ConsumerController.java"
click node_provider_client "https://github.com/forezp/springcloudlearning/blob/master/sc-2020-chapter1/consumer/src/main/java/io/github/forezp/consumer/client/ProviderClient.java"
click node_provider "https://github.com/forezp/springcloudlearning/blob/master/sc-2020-chapter1/provider/src/main/java/io/github/forezp/provider/ProviderApplication.java"
click node_feign_controller "https://github.com/forezp/springcloudlearning/blob/master/chapter3/service-feign/src/main/java/com/forezp/web/HiController.java"
click node_feign_client "https://github.com/forezp/springcloudlearning/blob/master/chapter3/service-feign/src/main/java/com/forezp/service/SchedualServiceHi.java"
click node_eureka "https://github.com/forezp/springcloudlearning/blob/master/chapter3/eureka-server/src/main/java/com/forezp/EurekaServerApplication.java"
click node_nacos_provider "https://github.com/forezp/springcloudlearning/blob/master/springcloud-alibaba/nacos-discovery/nacos-provider/src/main/java/com/forezp/web/ProviderController.java"
click node_nacos_config "https://github.com/forezp/springcloudlearning/tree/master/springcloud-alibaba/nacos-config"
click node_config_server "https://github.com/forezp/springcloudlearning/tree/master/chapter6/config-server"
click node_config_client "https://github.com/forezp/springcloudlearning/tree/master/chapter6/config-client"
click node_gateway "https://github.com/forezp/springcloudlearning/blob/master/sc-f-gateway-first-sight/src/main/java/gateway/Application.java"
click node_gateway_filters "https://github.com/forezp/springcloudlearning/blob/master/sc-f-gateway-filter/src/main/java/gateway/RequestTimeFilter.java"
click node_rate_keys "https://github.com/forezp/springcloudlearning/blob/master/sc-f-gateway-limiter/src/main/java/gateway/HostAddrKeyResolver.java"
click node_hystrix "https://github.com/forezp/springcloudlearning/blob/master/chapter4/service-feign/src/main/java/com/forezp/service/SchedualServiceHiHystric.java"
click node_turbine "https://github.com/forezp/springcloudlearning/blob/master/chapter13/service-turbine/src/main/java/com/forezp/ServiceTurbineApplication.java"
click node_sleuth "https://github.com/forezp/springcloudlearning/tree/master/chapter-sleuth"
click node_zipkin "https://github.com/forezp/springcloudlearning/blob/master/chapter-sleuth/zipkin-server/src/main/java/com/forezp/ZipkinServerApplication.java"
click node_admin "https://github.com/forezp/springcloudlearning/tree/master/sc-f-boot-admin"

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_consumer_controller,node_provider_client,node_provider,node_feign_controller,node_feign_client toneBlue
class node_eureka,node_nacos_provider,node_nacos_config,node_config_server,node_config_client toneAmber
class node_gateway,node_gateway_filters,node_rate_keys toneMint
class node_hystrix,node_turbine,node_sleuth,node_zipkin,node_admin toneRose
class node_caller toneIndigo
```

## Components

### Service invocation

- [Consumer controller](https://github.com/forezp/springcloudlearning/blob/master/sc-2020-chapter1/consumer/src/main/java/io/github/forezp/consumer/web/ConsumerController.java): `sc-2020-chapter1/consumer/src/main/java/io/github/forezp/consumer/web/ConsumerController.java`
- [Feign provider client](https://github.com/forezp/springcloudlearning/blob/master/sc-2020-chapter1/consumer/src/main/java/io/github/forezp/consumer/client/ProviderClient.java): `sc-2020-chapter1/consumer/src/main/java/io/github/forezp/consumer/client/ProviderClient.java`
- [Service provider](https://github.com/forezp/springcloudlearning/blob/master/sc-2020-chapter1/provider/src/main/java/io/github/forezp/provider/ProviderApplication.java): `sc-2020-chapter1/provider/src/main/java/io/github/forezp/provider/ProviderApplication.java`
- [Feign demo controller](https://github.com/forezp/springcloudlearning/blob/master/chapter3/service-feign/src/main/java/com/forezp/web/HiController.java): `chapter3/service-feign/src/main/java/com/forezp/web/HiController.java`
- [Feign service client](https://github.com/forezp/springcloudlearning/blob/master/chapter3/service-feign/src/main/java/com/forezp/service/SchedualServiceHi.java): `chapter3/service-feign/src/main/java/com/forezp/service/SchedualServiceHi.java`

### Service platform

- [Eureka discovery](https://github.com/forezp/springcloudlearning/blob/master/chapter3/eureka-server/src/main/java/com/forezp/EurekaServerApplication.java): `chapter3/eureka-server/src/main/java/com/forezp/EurekaServerApplication.java`
- [Nacos provider](https://github.com/forezp/springcloudlearning/blob/master/springcloud-alibaba/nacos-discovery/nacos-provider/src/main/java/com/forezp/web/ProviderController.java): `springcloud-alibaba/nacos-discovery/nacos-provider/src/main/java/com/forezp/web/ProviderController.java`
- [Nacos config demo](https://github.com/forezp/springcloudlearning/tree/master/springcloud-alibaba/nacos-config): `springcloud-alibaba/nacos-config`
- [Config server](https://github.com/forezp/springcloudlearning/tree/master/chapter6/config-server): `chapter6/config-server`
- [Config client](https://github.com/forezp/springcloudlearning/tree/master/chapter6/config-client): `chapter6/config-client`

### Gateway examples

- [Spring Cloud Gateway](https://github.com/forezp/springcloudlearning/blob/master/sc-f-gateway-first-sight/src/main/java/gateway/Application.java): `sc-f-gateway-first-sight/src/main/java/gateway/Application.java`
- [Gateway filters](https://github.com/forezp/springcloudlearning/blob/master/sc-f-gateway-filter/src/main/java/gateway/RequestTimeFilter.java): `sc-f-gateway-filter/src/main/java/gateway/RequestTimeFilter.java`
- [Rate-limit keys](https://github.com/forezp/springcloudlearning/blob/master/sc-f-gateway-limiter/src/main/java/gateway/HostAddrKeyResolver.java): `sc-f-gateway-limiter/src/main/java/gateway/HostAddrKeyResolver.java`

### Resilience and observability

- [Circuit-breaker demos](https://github.com/forezp/springcloudlearning/blob/master/chapter4/service-feign/src/main/java/com/forezp/service/SchedualServiceHiHystric.java): `chapter4/service-feign/src/main/java/com/forezp/service/SchedualServiceHiHystric.java`
- [Turbine aggregation](https://github.com/forezp/springcloudlearning/blob/master/chapter13/service-turbine/src/main/java/com/forezp/ServiceTurbineApplication.java): `chapter13/service-turbine/src/main/java/com/forezp/ServiceTurbineApplication.java`
- [Sleuth tracing demos](https://github.com/forezp/springcloudlearning/tree/master/chapter-sleuth): `chapter-sleuth`
- [Zipkin server](https://github.com/forezp/springcloudlearning/blob/master/chapter-sleuth/zipkin-server/src/main/java/com/forezp/ZipkinServerApplication.java): `chapter-sleuth/zipkin-server/src/main/java/com/forezp/ZipkinServerApplication.java`
- [Spring Boot Admin](https://github.com/forezp/springcloudlearning/tree/master/sc-f-boot-admin): `sc-f-boot-admin`

### Other components

- **HTTP caller**

## Connections

- HTTP caller → Consumer controller: requests (evidence: `sc-2020-chapter1/consumer/src/main/java/io/github/forezp/consumer/web/ConsumerController.java`)
- Consumer controller → Feign provider client: invokes (evidence: `sc-2020-chapter1/consumer/src/main/java/io/github/forezp/consumer/web/ConsumerController.java`)
- HTTP caller → Feign demo controller: requests (evidence: `chapter3/service-feign/src/main/java/com/forezp/web/HiController.java`)
- Feign demo controller → Feign service client: invokes (evidence: `chapter3/service-feign/src/main/java/com/forezp/web/HiController.java`)
- Feign service client → Service provider: calls service-hi (evidence: `chapter3/service-feign/src/main/java/com/forezp/service/SchedualServiceHi.java`)
- Feign provider client → Service provider: calls provider
- Eureka discovery → Feign service client: discovery
- Nacos config demo → Nacos provider: configures
- Config client → Config server: gets configuration
- HTTP caller → Spring Cloud Gateway: routes through
- Spring Cloud Gateway → Gateway filters: applies
- Spring Cloud Gateway → Rate-limit keys: resolves rate keys
- Feign service client → Circuit-breaker demos: fallback capability
- Circuit-breaker demos → Turbine aggregation: monitoring demos
- Sleuth tracing demos → Zipkin server: traces to
