# prkhar2209/spring-ai architecture

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

## Overview

This repository is a Spring AI course collection: separate runnable examples demonstrate provider connections, prompt and chat patterns, retrieval, MCP, and support-agent workflows rather than one unified application. A typical request enters a sample controller and uses a configured chat client; the RAG example additionally configures a retriever, while help-desk examples expose ticket operations through tools and persistence. The tree documents further capabilities including streaming, structured output, memory, audio, images, and email handling. Connections between unsampled examples are omitted or marked unverified; the README describes course scope and referenced technologies, not application call flows.

Main entry points: [`section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/service/HelpDeskTicketService.java`](https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/service/HelpDeskTicketService.java) (Ticket service), [`section_11/support-agent-demo/support-agent/src/main/java/com/eazybytes/support/agent/service/SupportAgent.java`](https://github.com/prkhar2209/spring-ai/blob/2.x/section_11/support-agent-demo/support-agent/src/main/java/com/eazybytes/support/agent/service/SupportAgent.java) (Email support agent), [`section02/springai/src/main/java/com/eazybytes/springai/controller/StructuredOutPutController.java`](https://github.com/prkhar2209/spring-ai/blob/2.x/section02/springai/src/main/java/com/eazybytes/springai/controller/StructuredOutPutController.java) (Structured output), [`section05/springai/src/main/java/com/eazybytes/springai/config/WebSearchRAGChatClientConfig.java`](https://github.com/prkhar2209/spring-ai/blob/2.x/section05/springai/src/main/java/com/eazybytes/springai/config/WebSearchRAGChatClientConfig.java) (RAG chat setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_providers["Model providers"]
  node_provider_samples["Provider chat samples"]
  node_bedrock["Bedrock chat"]
  node_docker_model["Docker model chat"]
  node_ollama["Ollama chat"]
  node_multimodel["Multi-model chat"]
end

subgraph group_interactions["Chat patterns"]
  node_chat_patterns["Chat and prompt APIs"]
  node_structured_output["Structured output"]
  node_country_model["Country response model<br/>[CountryCities.java]"]
  node_audit_advisor["Token usage audit"]
  node_memory_chat["Memory chat"]
  node_self_evaluation["Self-evaluating chat"]
  node_audio["Audio interaction"]
  node_image["Image interaction"]
end

subgraph group_retrieval["Retrieval and RAG"]
  node_rag_api["RAG endpoint<br/>[RAGController.java]"]
  node_rag_config["RAG chat setup"]
  node_web_retriever["Web document retriever"]
  node_document_loaders["Document loading"]
end

subgraph group_mcp["MCP integrations"]
  node_mcp_client["MCP client"]
  node_mcp_remote["Remote MCP tools<br/>[HelpDeskTools.java]"]
  node_mcp_stdio["STDIO MCP tools<br/>[HelpDeskTools.java]"]
  node_mcp_extensions["MCP extensions"]
end

subgraph group_support["Support workflows"]
  node_ticket_service["Ticket service"]
  node_ticket_repository[("Ticket repository")]
  node_ticket_entity["Ticket record"]
  node_support_tools["Commerce support tools"]
  node_support_agent["Email support agent<br/>[SupportAgent.java]"]
  node_inbox_monitor["Inbox monitor<br/>[InboxMonitor.java]"]
end

node_learner(("API user"))
node_mailpit["Mailpit service"]

node_learner -.->|"submits chat"| node_bedrock
node_learner -.->|"submits chat"| node_docker_model
node_learner -.->|"submits chat"| node_ollama
node_learner -.->|"submits chat"| node_multimodel
node_structured_output -->|"uses response"| node_country_model
node_rag_config -->|"configures retriever"| node_web_retriever
node_ticket_service -->|"saves and queries"| node_ticket_repository
node_ticket_service -->|"builds tickets"| node_ticket_entity
node_mcp_remote -.->|"invokes service"| node_ticket_service
node_mcp_stdio -.->|"invokes service"| node_ticket_service
node_support_agent -.->|"uses support tools"| node_support_tools
node_inbox_monitor -.->|"dispatches email"| node_support_agent
node_support_agent -.->|"accesses inbox"| node_mailpit

click node_provider_samples "https://github.com/prkhar2209/spring-ai/tree/2.x/section01"
click node_bedrock "https://github.com/prkhar2209/spring-ai/blob/2.x/section01/bedrock/src/main/java/com/eazybytes/bedrock/controller/ChatController.java"
click node_docker_model "https://github.com/prkhar2209/spring-ai/blob/2.x/section01/dockermodel/src/main/java/com/eazybytes/dockermodel/controller/ChatController.java"
click node_ollama "https://github.com/prkhar2209/spring-ai/blob/2.x/section01/ollama/src/main/java/com/eazybytes/ollama/controller/ChatController.java"
click node_multimodel "https://github.com/prkhar2209/spring-ai/blob/2.x/section01/multimodel/src/main/java/com/eazybytes/multimodel/controller/MultiModelChatController.java"
click node_chat_patterns "https://github.com/prkhar2209/spring-ai/tree/2.x/section02/springai/src/main/java/com/eazybytes/springai/controller"
click node_structured_output "https://github.com/prkhar2209/spring-ai/blob/2.x/section02/springai/src/main/java/com/eazybytes/springai/controller/StructuredOutPutController.java"
click node_country_model "https://github.com/prkhar2209/spring-ai/blob/2.x/section02/springai/src/main/java/com/eazybytes/springai/model/CountryCities.java"
click node_audit_advisor "https://github.com/prkhar2209/spring-ai/blob/2.x/section02/springai/src/main/java/com/eazybytes/springai/advisors/TokenUsageAuditAdvisor.java"
click node_memory_chat "https://github.com/prkhar2209/spring-ai/blob/2.x/section04/springai/src/main/java/com/eazybytes/springai/controller/ChatMemoryController.java"
click node_self_evaluation "https://github.com/prkhar2209/spring-ai/blob/2.x/section08/springai/src/main/java/com/eazybytes/springai/controller/SelfEvaluatingChatController.java"
click node_audio "https://github.com/prkhar2209/spring-ai/blob/2.x/section_10/springai/src/main/java/com/eazybytes/springai/controller/AudioController.java"
click node_image "https://github.com/prkhar2209/spring-ai/blob/2.x/section_10/springai/src/main/java/com/eazybytes/springai/controller/ImageController.java"
click node_rag_api "https://github.com/prkhar2209/spring-ai/blob/2.x/section05/springai/src/main/java/com/eazybytes/springai/controller/RAGController.java"
click node_rag_config "https://github.com/prkhar2209/spring-ai/blob/2.x/section05/springai/src/main/java/com/eazybytes/springai/config/WebSearchRAGChatClientConfig.java"
click node_web_retriever "https://github.com/prkhar2209/spring-ai/blob/2.x/section05/springai/src/main/java/com/eazybytes/springai/rag/WebSearchDocumentRetriever.java"
click node_document_loaders "https://github.com/prkhar2209/spring-ai/tree/2.x/section05/springai/src/main/java/com/eazybytes/springai/rag"
click node_mcp_client "https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpclient/src/main/java/com/eazybytes/mcpclient/controller/MCPClientController.java"
click node_mcp_remote "https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/tool/HelpDeskTools.java"
click node_mcp_stdio "https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpserverstdio/src/main/java/com/eazybytes/mcpserverstdio/tool/HelpDeskTools.java"
click node_mcp_extensions "https://github.com/prkhar2209/spring-ai/tree/2.x/section07/mcp-elicitation"
click node_ticket_service "https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/service/HelpDeskTicketService.java"
click node_ticket_repository "https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/repository/HelpDeskTicketRepository.java"
click node_ticket_entity "https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/entity/HelpDeskTicket.java"
click node_support_tools "https://github.com/prkhar2209/spring-ai/tree/2.x/section_11/support-agent-demo/mcp-server/src/main/java/com/eazybytes/mcp/server/tool"
click node_support_agent "https://github.com/prkhar2209/spring-ai/blob/2.x/section_11/support-agent-demo/support-agent/src/main/java/com/eazybytes/support/agent/service/SupportAgent.java"
click node_inbox_monitor "https://github.com/prkhar2209/spring-ai/blob/2.x/section_11/support-agent-demo/support-agent/src/main/java/com/eazybytes/support/agent/service/InboxMonitor.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_provider_samples,node_bedrock,node_docker_model,node_ollama,node_multimodel,node_learner toneBlue
class node_chat_patterns,node_structured_output,node_country_model,node_audit_advisor,node_memory_chat,node_self_evaluation,node_audio,node_image toneAmber
class node_rag_api,node_rag_config,node_web_retriever,node_document_loaders toneMint
class node_mcp_client,node_mcp_remote,node_mcp_stdio,node_mcp_extensions toneRose
class node_ticket_service,node_ticket_repository,node_ticket_entity,node_support_tools,node_support_agent,node_inbox_monitor,node_mailpit toneIndigo
```

## Components

### Model providers

- [Provider chat samples](https://github.com/prkhar2209/spring-ai/tree/2.x/section01): `section01`
- [Bedrock chat](https://github.com/prkhar2209/spring-ai/blob/2.x/section01/bedrock/src/main/java/com/eazybytes/bedrock/controller/ChatController.java): `section01/bedrock/src/main/java/com/eazybytes/bedrock/controller/ChatController.java`
- [Docker model chat](https://github.com/prkhar2209/spring-ai/blob/2.x/section01/dockermodel/src/main/java/com/eazybytes/dockermodel/controller/ChatController.java): `section01/dockermodel/src/main/java/com/eazybytes/dockermodel/controller/ChatController.java`
- [Ollama chat](https://github.com/prkhar2209/spring-ai/blob/2.x/section01/ollama/src/main/java/com/eazybytes/ollama/controller/ChatController.java): `section01/ollama/src/main/java/com/eazybytes/ollama/controller/ChatController.java`
- [Multi-model chat](https://github.com/prkhar2209/spring-ai/blob/2.x/section01/multimodel/src/main/java/com/eazybytes/multimodel/controller/MultiModelChatController.java): `section01/multimodel/src/main/java/com/eazybytes/multimodel/controller/MultiModelChatController.java`

### Chat patterns

- [Chat and prompt APIs](https://github.com/prkhar2209/spring-ai/tree/2.x/section02/springai/src/main/java/com/eazybytes/springai/controller): `section02/springai/src/main/java/com/eazybytes/springai/controller`
- [Structured output](https://github.com/prkhar2209/spring-ai/blob/2.x/section02/springai/src/main/java/com/eazybytes/springai/controller/StructuredOutPutController.java): `section02/springai/src/main/java/com/eazybytes/springai/controller/StructuredOutPutController.java`
- [Country response model](https://github.com/prkhar2209/spring-ai/blob/2.x/section02/springai/src/main/java/com/eazybytes/springai/model/CountryCities.java): `section02/springai/src/main/java/com/eazybytes/springai/model/CountryCities.java`
- [Token usage audit](https://github.com/prkhar2209/spring-ai/blob/2.x/section02/springai/src/main/java/com/eazybytes/springai/advisors/TokenUsageAuditAdvisor.java): `section02/springai/src/main/java/com/eazybytes/springai/advisors/TokenUsageAuditAdvisor.java`
- [Memory chat](https://github.com/prkhar2209/spring-ai/blob/2.x/section04/springai/src/main/java/com/eazybytes/springai/controller/ChatMemoryController.java): `section04/springai/src/main/java/com/eazybytes/springai/controller/ChatMemoryController.java`
- [Self-evaluating chat](https://github.com/prkhar2209/spring-ai/blob/2.x/section08/springai/src/main/java/com/eazybytes/springai/controller/SelfEvaluatingChatController.java): `section08/springai/src/main/java/com/eazybytes/springai/controller/SelfEvaluatingChatController.java`
- [Audio interaction](https://github.com/prkhar2209/spring-ai/blob/2.x/section_10/springai/src/main/java/com/eazybytes/springai/controller/AudioController.java): `section_10/springai/src/main/java/com/eazybytes/springai/controller/AudioController.java`
- [Image interaction](https://github.com/prkhar2209/spring-ai/blob/2.x/section_10/springai/src/main/java/com/eazybytes/springai/controller/ImageController.java): `section_10/springai/src/main/java/com/eazybytes/springai/controller/ImageController.java`

### Retrieval and RAG

- [RAG endpoint](https://github.com/prkhar2209/spring-ai/blob/2.x/section05/springai/src/main/java/com/eazybytes/springai/controller/RAGController.java): `section05/springai/src/main/java/com/eazybytes/springai/controller/RAGController.java`
- [RAG chat setup](https://github.com/prkhar2209/spring-ai/blob/2.x/section05/springai/src/main/java/com/eazybytes/springai/config/WebSearchRAGChatClientConfig.java): `section05/springai/src/main/java/com/eazybytes/springai/config/WebSearchRAGChatClientConfig.java`
- [Web document retriever](https://github.com/prkhar2209/spring-ai/blob/2.x/section05/springai/src/main/java/com/eazybytes/springai/rag/WebSearchDocumentRetriever.java): `section05/springai/src/main/java/com/eazybytes/springai/rag/WebSearchDocumentRetriever.java`
- [Document loading](https://github.com/prkhar2209/spring-ai/tree/2.x/section05/springai/src/main/java/com/eazybytes/springai/rag): `section05/springai/src/main/java/com/eazybytes/springai/rag`

### MCP integrations

- [MCP client](https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpclient/src/main/java/com/eazybytes/mcpclient/controller/MCPClientController.java): `section07/mcpclient/src/main/java/com/eazybytes/mcpclient/controller/MCPClientController.java`
- [Remote MCP tools](https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/tool/HelpDeskTools.java): `section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/tool/HelpDeskTools.java`
- [STDIO MCP tools](https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpserverstdio/src/main/java/com/eazybytes/mcpserverstdio/tool/HelpDeskTools.java): `section07/mcpserverstdio/src/main/java/com/eazybytes/mcpserverstdio/tool/HelpDeskTools.java`
- [MCP extensions](https://github.com/prkhar2209/spring-ai/tree/2.x/section07/mcp-elicitation): `section07/mcp-elicitation`

### Support workflows

- [Ticket service](https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/service/HelpDeskTicketService.java): `section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/service/HelpDeskTicketService.java`
- [Ticket repository](https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/repository/HelpDeskTicketRepository.java): `section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/repository/HelpDeskTicketRepository.java`
- [Ticket record](https://github.com/prkhar2209/spring-ai/blob/2.x/section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/entity/HelpDeskTicket.java): `section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/entity/HelpDeskTicket.java`
- [Commerce support tools](https://github.com/prkhar2209/spring-ai/tree/2.x/section_11/support-agent-demo/mcp-server/src/main/java/com/eazybytes/mcp/server/tool): `section_11/support-agent-demo/mcp-server/src/main/java/com/eazybytes/mcp/server/tool`
- [Email support agent](https://github.com/prkhar2209/spring-ai/blob/2.x/section_11/support-agent-demo/support-agent/src/main/java/com/eazybytes/support/agent/service/SupportAgent.java): `section_11/support-agent-demo/support-agent/src/main/java/com/eazybytes/support/agent/service/SupportAgent.java`
- [Inbox monitor](https://github.com/prkhar2209/spring-ai/blob/2.x/section_11/support-agent-demo/support-agent/src/main/java/com/eazybytes/support/agent/service/InboxMonitor.java): `section_11/support-agent-demo/support-agent/src/main/java/com/eazybytes/support/agent/service/InboxMonitor.java`

### Other components

- **API user**
- **Mailpit service**

## Connections

- API user → Bedrock chat: submits chat
- API user → Docker model chat: submits chat
- API user → Ollama chat: submits chat
- API user → Multi-model chat: submits chat
- Structured output → Country response model: uses response (evidence: `section02/springai/src/main/java/com/eazybytes/springai/controller/StructuredOutPutController.java`)
- RAG chat setup → Web document retriever: configures retriever (evidence: `section05/springai/src/main/java/com/eazybytes/springai/config/WebSearchRAGChatClientConfig.java`)
- Ticket service → Ticket repository: saves and queries (evidence: `section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/service/HelpDeskTicketService.java`)
- Ticket service → Ticket record: builds tickets (evidence: `section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/service/HelpDeskTicketService.java`)
- Remote MCP tools → Ticket service: invokes service
- STDIO MCP tools → Ticket service: invokes service
- Email support agent → Commerce support tools: uses support tools
- Inbox monitor → Email support agent: dispatches email
- Email support agent → Mailpit service: accesses inbox
