# ayoubdammaq/enterprise-ai-assistant architecture

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

- Interactive diagram: https://gitdiagram.com/ayoubdammaq/enterprise-ai-assistant
- Repository: https://github.com/ayoubdammaq/enterprise-ai-assistant

## Overview

This is the backend of an enterprise AI assistant. Authenticated users can chat normally or ask document-grounded questions: the API delegates to chat/RAG services, which retrieve and screen document chunks before generating an answer with sources. A separate hosted indexing path loads and indexes documents. Authentication issues and refreshes JWTs; chat also supports memory and model tools. The source excerpts establish these principal calls, but leave much indexing and storage implementation detail unsampled.

Main entry points: [`backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelChatService.cs`](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelChatService.cs) (AI chat service), [`backend/src/EnterpriseAIAssistant.Application/Services/RagService.cs`](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Application/Services/RagService.cs) (RAG orchestration), [`backend/src/EnterpriseAIAssistant.Infrastructure/Identity/AuthService.cs`](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Identity/AuthService.cs) (Auth service), [`backend/src/EnterpriseAIAssistant.API/Controllers/ChatController.cs`](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.API/Controllers/ChatController.cs) (Chat endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api_identity["API and identity"]
  node_auth_api["Auth endpoints<br/>[AuthController.cs]"]
  node_auth_service["Auth service<br/>[AuthService.cs]"]
  node_jwt["JWT tokens<br/>[JwtTokenService.cs]"]
  node_identity_db[("Identity database<br/>[AuthDbContext.cs]")]
end

subgraph group_assistant["Assistant and memory"]
  node_chat_api["Chat endpoints<br/>[ChatController.cs]"]
  node_rag_service["RAG orchestration<br/>[RagService.cs]"]
  node_chat_service["AI chat service"]
  node_prompt_builder["RAG prompt builder"]
  node_memory_service["Memory service"]
  node_memory_context["Memory user context"]
  node_memory_plugin["Memory plugin<br/>[MemoryPlugin.cs]"]
  node_calculator["Calculator tool"]
  node_datetime["Date/time tool<br/>[DateTimePlugin.cs]"]
end

subgraph group_knowledge["Knowledge and retrieval"]
  node_retriever["Knowledge retriever"]
  node_relevance["Context evaluator"]
  node_index_host["Indexing host"]
  node_doc_loader["Document loader"]
  node_chunking["Text chunking<br/>[TextChunker.cs]"]
  node_indexer["Knowledge indexer"]
end

subgraph group_providers["Infrastructure providers"]
  node_embedding["Ollama embeddings"]
  node_vector_store[("Vector store")]
end

node_user(("User"))
node_ollama{{"Ollama service"}}

node_user -->|"registers or signs in"| node_auth_api
node_auth_api -->|"delegates auth"| node_auth_service
node_auth_service -->|"creates tokens"| node_jwt
node_auth_service -->|"reads and writes"| node_identity_db
node_user -->|"sends chat request"| node_chat_api
node_chat_api -->|"generates response"| node_chat_service
node_chat_api -->|"asks with RAG"| node_rag_service
node_rag_service -->|"searches chunks"| node_retriever
node_rag_service -->|"checks sufficiency"| node_relevance
node_rag_service -->|"generates grounded answer"| node_chat_service
node_chat_service -->|"builds RAG prompt"| node_prompt_builder
node_chat_service -->|"uses memory"| node_memory_service
node_chat_service -->|"sets user scope"| node_memory_context
node_chat_service -->|"registers memory tool"| node_memory_plugin
node_chat_service -->|"registers tool"| node_calculator
node_chat_service -->|"registers tool"| node_datetime
node_index_host -->|"loads documents"| node_doc_loader
node_index_host -->|"indexes documents"| node_indexer
node_retriever -->|"embeds query"| node_embedding
node_retriever -->|"searches vectors"| node_vector_store
node_embedding -->|"requests embeddings"| node_ollama
node_doc_loader -.->|"chunks text"| node_chunking
node_indexer -.->|"embeds chunks"| node_embedding
node_indexer -.->|"stores vectors"| node_vector_store

click node_auth_api "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.API/Controllers/AuthController.cs"
click node_auth_service "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Identity/AuthService.cs"
click node_jwt "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Identity/JwtTokenService.cs"
click node_identity_db "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Identity/AuthDbContext.cs"
click node_chat_api "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.API/Controllers/ChatController.cs"
click node_rag_service "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Application/Services/RagService.cs"
click node_chat_service "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelChatService.cs"
click node_prompt_builder "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/AI/RagPromptBuilder.cs"
click node_memory_service "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Memory/InMemoryMemoryService.cs"
click node_memory_context "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Memory/MemoryUserContext.cs"
click node_memory_plugin "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Memory/MemoryPlugin.cs"
click node_retriever "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/KnowledgeRetriever.cs"
click node_relevance "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelContextRelevanceEvaluator.cs"
click node_index_host "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.API/HostedServices/DocumentIndexingHostedService.cs"
click node_doc_loader "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Documents/FileSystemDocumentLoader.cs"
click node_chunking "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Documents/TextChunker.cs"
click node_indexer "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/KnowledgeIndexer.cs"
click node_embedding "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/OllamaEmbeddingService.cs"
click node_vector_store "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/InMemoryVectorStore.cs"
click node_calculator "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/AI/Plugins/CalculatorPlugin.cs"
click node_datetime "https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/AI/Plugins/DateTimePlugin.cs"

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_auth_api,node_auth_service,node_jwt,node_identity_db,node_user toneBlue
class node_chat_api,node_rag_service,node_chat_service,node_prompt_builder,node_memory_service,node_memory_context,node_memory_plugin,node_calculator,node_datetime toneAmber
class node_retriever,node_relevance,node_index_host,node_doc_loader,node_chunking,node_indexer toneMint
class node_embedding,node_vector_store toneRose
class node_ollama toneIndigo
```

## Components

### API and identity

- [Auth endpoints](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.API/Controllers/AuthController.cs): `backend/src/EnterpriseAIAssistant.API/Controllers/AuthController.cs`
- [Auth service](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Identity/AuthService.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/Identity/AuthService.cs`
- [JWT tokens](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Identity/JwtTokenService.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/Identity/JwtTokenService.cs`
- [Identity database](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Identity/AuthDbContext.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/Identity/AuthDbContext.cs`

### Assistant and memory

- [Chat endpoints](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.API/Controllers/ChatController.cs): `backend/src/EnterpriseAIAssistant.API/Controllers/ChatController.cs`
- [RAG orchestration](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Application/Services/RagService.cs): `backend/src/EnterpriseAIAssistant.Application/Services/RagService.cs`
- [AI chat service](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelChatService.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelChatService.cs`
- [RAG prompt builder](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/AI/RagPromptBuilder.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/AI/RagPromptBuilder.cs`
- [Memory service](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Memory/InMemoryMemoryService.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/Memory/InMemoryMemoryService.cs`
- [Memory user context](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Memory/MemoryUserContext.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/Memory/MemoryUserContext.cs`
- [Memory plugin](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Memory/MemoryPlugin.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/Memory/MemoryPlugin.cs`
- [Calculator tool](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/AI/Plugins/CalculatorPlugin.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/AI/Plugins/CalculatorPlugin.cs`
- [Date/time tool](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/AI/Plugins/DateTimePlugin.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/AI/Plugins/DateTimePlugin.cs`

### Knowledge and retrieval

- [Knowledge retriever](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/KnowledgeRetriever.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/KnowledgeRetriever.cs`
- [Context evaluator](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelContextRelevanceEvaluator.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelContextRelevanceEvaluator.cs`
- [Indexing host](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.API/HostedServices/DocumentIndexingHostedService.cs): `backend/src/EnterpriseAIAssistant.API/HostedServices/DocumentIndexingHostedService.cs`
- [Document loader](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Documents/FileSystemDocumentLoader.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/Documents/FileSystemDocumentLoader.cs`
- [Text chunking](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Documents/TextChunker.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/Documents/TextChunker.cs`
- [Knowledge indexer](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/KnowledgeIndexer.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/KnowledgeIndexer.cs`

### Infrastructure providers

- [Ollama embeddings](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/OllamaEmbeddingService.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/OllamaEmbeddingService.cs`
- [Vector store](https://github.com/ayoubdammaq/enterprise-ai-assistant/blob/main/backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/InMemoryVectorStore.cs): `backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/InMemoryVectorStore.cs`

### Other components

- **User**
- **Ollama service**

## Connections

- User → Auth endpoints: registers or signs in (evidence: `backend/src/EnterpriseAIAssistant.API/Controllers/AuthController.cs`)
- Auth endpoints → Auth service: delegates auth (evidence: `backend/src/EnterpriseAIAssistant.API/Controllers/AuthController.cs`)
- Auth service → JWT tokens: creates tokens (evidence: `backend/src/EnterpriseAIAssistant.Infrastructure/Identity/AuthService.cs`)
- Auth service → Identity database: reads and writes (evidence: `backend/src/EnterpriseAIAssistant.Infrastructure/Identity/AuthService.cs`)
- User → Chat endpoints: sends chat request (evidence: `backend/src/EnterpriseAIAssistant.API/Controllers/ChatController.cs`)
- Chat endpoints → AI chat service: generates response (evidence: `backend/src/EnterpriseAIAssistant.API/Controllers/ChatController.cs`)
- Chat endpoints → RAG orchestration: asks with RAG (evidence: `backend/src/EnterpriseAIAssistant.API/Controllers/ChatController.cs`)
- RAG orchestration → Knowledge retriever: searches chunks (evidence: `backend/src/EnterpriseAIAssistant.Application/Services/RagService.cs`)
- RAG orchestration → Context evaluator: checks sufficiency (evidence: `backend/src/EnterpriseAIAssistant.Application/Services/RagService.cs`)
- RAG orchestration → AI chat service: generates grounded answer (evidence: `backend/src/EnterpriseAIAssistant.Application/Services/RagService.cs`)
- AI chat service → RAG prompt builder: builds RAG prompt (evidence: `backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelChatService.cs`)
- AI chat service → Memory service: uses memory (evidence: `backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelChatService.cs`)
- AI chat service → Memory user context: sets user scope (evidence: `backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelChatService.cs`)
- AI chat service → Memory plugin: registers memory tool (evidence: `backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelChatService.cs`)
- AI chat service → Calculator tool: registers tool (evidence: `backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelChatService.cs`)
- AI chat service → Date/time tool: registers tool (evidence: `backend/src/EnterpriseAIAssistant.Infrastructure/AI/SemanticKernelChatService.cs`)
- Indexing host → Document loader: loads documents (evidence: `backend/src/EnterpriseAIAssistant.API/HostedServices/DocumentIndexingHostedService.cs`)
- Indexing host → Knowledge indexer: indexes documents (evidence: `backend/src/EnterpriseAIAssistant.API/HostedServices/DocumentIndexingHostedService.cs`)
- Knowledge retriever → Ollama embeddings: embeds query (evidence: `backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/KnowledgeRetriever.cs`)
- Knowledge retriever → Vector store: searches vectors (evidence: `backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/KnowledgeRetriever.cs`)
- Ollama embeddings → Ollama service: requests embeddings (evidence: `backend/src/EnterpriseAIAssistant.Infrastructure/Retrieval/OllamaEmbeddingService.cs`)
- Document loader → Text chunking: chunks text (evidence: `backend/src/EnterpriseAIAssistant.Infrastructure/Documents/FileSystemDocumentLoader.cs`)
- Knowledge indexer → Ollama embeddings: embeds chunks
- Knowledge indexer → Vector store: stores vectors
