# tsireledzo2/ai-powered-chatbot architecture

> Architecture diagram of the GitHub repository tsireledzo2/ai-powered-chatbot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tsireledzo2/ai-powered-chatbot
- Repository: https://github.com/tsireledzo2/ai-powered-chatbot

## Overview

This is a Java chatbot application with REST controllers, CRUD-oriented services, domain entities, response factories, and repository abstractions. The visible runtime is primarily entity and response-pattern management; the README describes NLP and real-time chat as planned rather than implemented capabilities. The sampled sources show controller-to-service and service-to-repository relationships, but do not establish a complete message-processing request path or repository-factory wiring.

Main entry points: [`ChatbotApplication/src/main/java/chat/bot/repository`](https://github.com/tsireledzo2/ai-powered-chatbot/tree/master/ChatbotApplication/src/main/java/chat/bot/repository) (Repository interfaces), [`ChatbotApplication/src/main/java/chat/bot/controller/ChatBotController.java`](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/ChatBotController.java) (Chatbot API), [`ChatbotApplication/src/main/java/chat/bot/controller/ChatBotSesssionController.java`](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/ChatBotSesssionController.java) (Session API), [`ChatbotApplication/src/main/java/chat/bot/controller/IntentController.java`](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/IntentController.java) (Intent API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_chatbot_api["Chatbot API"]
  node_session_api["Session API"]
  node_intent_api["Intent API"]
  node_message_api["Message API"]
  node_pattern_api["Response pattern API"]
  node_user_api["User API"]
end

subgraph group_services["Application Services"]
  node_chatbot_service["Chatbot service"]
  node_session_service["Session service"]
  node_intent_service["Intent service<br/>[IntentService.java]"]
  node_message_service["Message service"]
  node_pattern_service["Response pattern service"]
  node_user_service["User service<br/>[UserService.java]"]
end

subgraph group_domain["Chatbot Domain"]
  node_domain_models["Chatbot entities"]
end

subgraph group_storage["Repository Storage"]
  node_repositories["Repository interfaces"]
  node_memory_repos[("In-memory stores")]
  node_database_user_repo[("Database user store")]
  node_repository_factory["Repository factory"]
end

subgraph group_factories["Factories"]
  node_response_factory["Response factories"]
  node_message_processor["Text message processor"]
  node_user_factory["User factory<br/>[UserFactory.java]"]
end

node_user(("API user"))

node_user -.->|"sends requests"| node_chatbot_api
node_user -.->|"sends requests"| node_session_api
node_user -.->|"sends requests"| node_intent_api
node_user -.->|"sends requests"| node_message_api
node_user -->|"sends requests"| node_pattern_api
node_user -.->|"sends requests"| node_user_api
node_chatbot_api -->|"delegates"| node_chatbot_service
node_session_api -->|"delegates"| node_session_service
node_intent_api -->|"delegates"| node_intent_service
node_message_api -->|"delegates"| node_message_service
node_pattern_api -->|"delegates"| node_pattern_service
node_user_api -->|"delegates"| node_user_service
node_chatbot_service -->|"uses chatbot repository"| node_repositories
node_session_service -->|"uses session repository"| node_repositories
node_intent_service -->|"uses intent repository"| node_repositories
node_message_service -->|"uses message repository"| node_repositories
node_pattern_service -->|"uses pattern repository"| node_repositories
node_user_service -->|"uses user repository"| node_repositories
node_response_factory -->|"creates patterns"| node_domain_models
node_message_processor -.->|"processes messages"| node_repositories
node_user_factory -->|"creates users"| node_domain_models
node_repositories -.->|"selects backend"| node_memory_repos
node_repositories -.->|"selects backend"| node_database_user_repo
node_repository_factory -.->|"constructs repositories"| node_repositories

click node_chatbot_api "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/ChatBotController.java"
click node_session_api "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/ChatBotSesssionController.java"
click node_intent_api "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/IntentController.java"
click node_message_api "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/MessageController.java"
click node_pattern_api "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/ResponsePatternController.java"
click node_user_api "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/UserController.java"
click node_chatbot_service "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/service/ChatbotService.java"
click node_session_service "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/service/ChatBotSessionService.java"
click node_intent_service "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/service/IntentService.java"
click node_message_service "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/service/MessageService.java"
click node_pattern_service "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/service/ResponsePatternService.java"
click node_user_service "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/service/UserService.java"
click node_domain_models "https://github.com/tsireledzo2/ai-powered-chatbot/tree/master/ChatbotApplication/src/main/java/chat/bot/models"
click node_repositories "https://github.com/tsireledzo2/ai-powered-chatbot/tree/master/ChatbotApplication/src/main/java/chat/bot/repository"
click node_memory_repos "https://github.com/tsireledzo2/ai-powered-chatbot/tree/master/ChatbotApplication/src/main/java/chat/bot/repository/inmemory"
click node_database_user_repo "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/repository/databases/DatabaseUserRepository.java"
click node_repository_factory "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/repository/factories/RepositoryFactory.java"
click node_response_factory "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/factory/ResponseFactory.java"
click node_message_processor "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/factory/TextMessageProcessor.java"
click node_user_factory "https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/factory/UserFactory.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_chatbot_api,node_session_api,node_intent_api,node_message_api,node_pattern_api,node_user_api,node_user toneBlue
class node_chatbot_service,node_session_service,node_intent_service,node_message_service,node_pattern_service,node_user_service toneAmber
class node_domain_models toneMint
class node_repositories,node_memory_repos,node_database_user_repo,node_repository_factory toneRose
class node_response_factory,node_message_processor,node_user_factory toneIndigo
```

## Components

### REST API

- [Chatbot API](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/ChatBotController.java): `ChatbotApplication/src/main/java/chat/bot/controller/ChatBotController.java`
- [Session API](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/ChatBotSesssionController.java): `ChatbotApplication/src/main/java/chat/bot/controller/ChatBotSesssionController.java`
- [Intent API](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/IntentController.java): `ChatbotApplication/src/main/java/chat/bot/controller/IntentController.java`
- [Message API](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/MessageController.java): `ChatbotApplication/src/main/java/chat/bot/controller/MessageController.java`
- [Response pattern API](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/ResponsePatternController.java): `ChatbotApplication/src/main/java/chat/bot/controller/ResponsePatternController.java`
- [User API](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/controller/UserController.java): `ChatbotApplication/src/main/java/chat/bot/controller/UserController.java`

### Application Services

- [Chatbot service](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/service/ChatbotService.java): `ChatbotApplication/src/main/java/chat/bot/service/ChatbotService.java`
- [Session service](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/service/ChatBotSessionService.java): `ChatbotApplication/src/main/java/chat/bot/service/ChatBotSessionService.java`
- [Intent service](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/service/IntentService.java): `ChatbotApplication/src/main/java/chat/bot/service/IntentService.java`
- [Message service](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/service/MessageService.java): `ChatbotApplication/src/main/java/chat/bot/service/MessageService.java`
- [Response pattern service](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/service/ResponsePatternService.java): `ChatbotApplication/src/main/java/chat/bot/service/ResponsePatternService.java`
- [User service](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/service/UserService.java): `ChatbotApplication/src/main/java/chat/bot/service/UserService.java`

### Chatbot Domain

- [Chatbot entities](https://github.com/tsireledzo2/ai-powered-chatbot/tree/master/ChatbotApplication/src/main/java/chat/bot/models): `ChatbotApplication/src/main/java/chat/bot/models`

### Repository Storage

- [Repository interfaces](https://github.com/tsireledzo2/ai-powered-chatbot/tree/master/ChatbotApplication/src/main/java/chat/bot/repository): `ChatbotApplication/src/main/java/chat/bot/repository`
- [In-memory stores](https://github.com/tsireledzo2/ai-powered-chatbot/tree/master/ChatbotApplication/src/main/java/chat/bot/repository/inmemory): `ChatbotApplication/src/main/java/chat/bot/repository/inmemory`
- [Database user store](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/repository/databases/DatabaseUserRepository.java): `ChatbotApplication/src/main/java/chat/bot/repository/databases/DatabaseUserRepository.java`
- [Repository factory](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/repository/factories/RepositoryFactory.java): `ChatbotApplication/src/main/java/chat/bot/repository/factories/RepositoryFactory.java`

### Factories

- [Response factories](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/factory/ResponseFactory.java): `ChatbotApplication/src/main/java/chat/bot/factory/ResponseFactory.java`
- [Text message processor](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/factory/TextMessageProcessor.java): `ChatbotApplication/src/main/java/chat/bot/factory/TextMessageProcessor.java`
- [User factory](https://github.com/tsireledzo2/ai-powered-chatbot/blob/master/ChatbotApplication/src/main/java/chat/bot/factory/UserFactory.java): `ChatbotApplication/src/main/java/chat/bot/factory/UserFactory.java`

### Other components

- **API user**

## Connections

- API user → Chatbot API: sends requests
- API user → Session API: sends requests
- API user → Intent API: sends requests
- API user → Message API: sends requests
- API user → Response pattern API: sends requests (evidence: `ChatbotApplication/src/main/java/chat/bot/controller/ResponsePatternController.java`)
- API user → User API: sends requests
- Chatbot API → Chatbot service: delegates (evidence: `ChatbotApplication/src/main/java/chat/bot/controller/ChatBotController.java`)
- Session API → Session service: delegates (evidence: `ChatbotApplication/src/main/java/chat/bot/controller/ChatBotSesssionController.java`)
- Intent API → Intent service: delegates (evidence: `ChatbotApplication/src/main/java/chat/bot/controller/IntentController.java`)
- Message API → Message service: delegates (evidence: `ChatbotApplication/src/main/java/chat/bot/controller/MessageController.java`)
- Response pattern API → Response pattern service: delegates (evidence: `ChatbotApplication/src/main/java/chat/bot/controller/ResponsePatternController.java`)
- User API → User service: delegates (evidence: `ChatbotApplication/src/main/java/chat/bot/controller/UserController.java`)
- Chatbot service → Repository interfaces: uses chatbot repository (evidence: `ChatbotApplication/src/main/java/chat/bot/service/ChatbotService.java`)
- Session service → Repository interfaces: uses session repository (evidence: `ChatbotApplication/src/main/java/chat/bot/service/ChatBotSessionService.java`)
- Intent service → Repository interfaces: uses intent repository (evidence: `ChatbotApplication/src/main/java/chat/bot/service/IntentService.java`)
- Message service → Repository interfaces: uses message repository (evidence: `ChatbotApplication/src/main/java/chat/bot/service/MessageService.java`)
- Response pattern service → Repository interfaces: uses pattern repository (evidence: `ChatbotApplication/src/main/java/chat/bot/service/ResponsePatternService.java`)
- User service → Repository interfaces: uses user repository (evidence: `ChatbotApplication/src/main/java/chat/bot/service/UserService.java`)
- Response factories → Chatbot entities: creates patterns (evidence: `ChatbotApplication/src/main/java/chat/bot/factory/ResponseFactory.java`)
- Text message processor → Repository interfaces: processes messages
- User factory → Chatbot entities: creates users (evidence: `ChatbotApplication/src/main/java/chat/bot/factory/UserFactory.java`)
- Repository interfaces → In-memory stores: selects backend
- Repository interfaces → Database user store: selects backend
- Repository factory → Repository interfaces: constructs repositories
