# amirmahdimtz/multirag-clean architecture

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

- Interactive diagram: https://gitdiagram.com/amirmahdimtz/multirag-clean
- Repository: https://github.com/amirmahdimtz/multirag-clean

## Overview

MultiRAG Clean is a FastAPI service for dataset management, vector search, RAG systems, access control, and streamed chat. The principal workflow accepts a dataset through an API controller, delegates business operations, and uses configured persistence and processing providers; RAG endpoints search or answer questions against configured systems. The graph retains the documented chat, user-dataset, and provider capabilities. Some internals are represented by their exact source directories because their implementations were not sampled; those relationships are limited to documented layer flow.

Main entry points: [`src/core/dataset`](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/core/dataset) (Dataset operations), [`src/application/dataset/dataset_controller.py`](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/dataset/dataset_controller.py) (Dataset APIs), [`src/infrastructure/repositories`](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/infrastructure/repositories) (Repositories), [`src/core/rag_system`](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/core/rag_system) (RAG operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API and Host"]
  node_host["Web host<br/>[app.py]"]
  node_web["Web service<br/>[web.py]"]
  node_auth["API-key security"]
  node_datasets_api["Dataset APIs"]
  node_user_datasets_api["User dataset APIs"]
  node_rag_api["RAG system APIs"]
  node_access_api["RAG access APIs"]
  node_chat_api["Chat APIs<br/>[chat_controller.py]"]
  node_user_api["User APIs<br/>[user_controller.py]"]
end

subgraph group_usecases["Core Use Cases"]
  node_dataset_usecase["Dataset operations"]
  node_rag_usecase["RAG operations"]
  node_access_usecase["Access operations"]
  node_chat_usecase["Chat orchestration<br/>[chat_business.py]"]
  node_user_usecase["User operations"]
  node_llm["LLM selection"]
end

subgraph group_domain["Domain Data"]
  node_entities["Domain entities"]
end

subgraph group_providers["Infrastructure Providers"]
  node_database[("SQL database<br/>[db_context.py]")]
  node_repositories["Repositories"]
  node_processing["Document processing"]
  node_storage["File storage"]
  node_embeddings["Embedding providers"]
  node_vectors[("Vector stores")]
  node_chat_provider["Chat-model providers"]
end

node_caller(("API clients"))

node_caller -->|"sends request"| node_host
node_host -->|"starts"| node_web
node_web -.->|"registers routes"| node_datasets_api
node_web -.->|"registers routes"| node_rag_api
node_caller -.->|"invokes dataset API"| node_datasets_api
node_caller -.->|"invokes RAG API"| node_rag_api
node_datasets_api -->|"requires admin key"| node_auth
node_rag_api -->|"requires admin key"| node_auth
node_datasets_api -->|"delegates operations"| node_dataset_usecase
node_user_datasets_api -->|"delegates operations"| node_dataset_usecase
node_rag_api -->|"delegates queries"| node_rag_usecase
node_access_api -->|"delegates access"| node_access_usecase
node_chat_api -->|"delegates chat"| node_chat_usecase
node_user_api -->|"delegates user tasks"| node_user_usecase
node_datasets_api -.->|"processes documents"| node_processing
node_dataset_usecase -.->|"stores files"| node_storage
node_dataset_usecase -.->|"requests embeddings"| node_embeddings
node_dataset_usecase -.->|"vectorizes and searches"| node_vectors
node_rag_usecase -.->|"searches vectors"| node_vectors
node_rag_usecase -.->|"generates answers"| node_llm
node_chat_usecase -.->|"selects chat model"| node_llm
node_llm -.->|"uses provider"| node_chat_provider
node_dataset_usecase -.->|"uses contracts"| node_repositories
node_rag_usecase -.->|"uses contracts"| node_repositories
node_access_usecase -.->|"uses contracts"| node_repositories
node_repositories -->|"opens sessions"| node_database
node_repositories -.->|"reads and writes"| node_entities
node_access_usecase -.->|"manages access records"| node_entities

click node_host "https://github.com/amirmahdimtz/multirag-clean/blob/main/src/host/app.py"
click node_web "https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/web.py"
click node_auth "https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/security/api_key_dependencies.py"
click node_datasets_api "https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/dataset/dataset_controller.py"
click node_user_datasets_api "https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/dataset/user_dataset_controller.py"
click node_rag_api "https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/rag_system/rag_system_controller.py"
click node_access_api "https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/rag_access/rag_access_controller.py"
click node_chat_api "https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/chat/chat_controller.py"
click node_user_api "https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/user/user_controller.py"
click node_dataset_usecase "https://github.com/amirmahdimtz/multirag-clean/tree/main/src/core/dataset"
click node_rag_usecase "https://github.com/amirmahdimtz/multirag-clean/tree/main/src/core/rag_system"
click node_access_usecase "https://github.com/amirmahdimtz/multirag-clean/tree/main/src/core/rag_access"
click node_chat_usecase "https://github.com/amirmahdimtz/multirag-clean/blob/main/src/core/chat/chat_business.py"
click node_user_usecase "https://github.com/amirmahdimtz/multirag-clean/tree/main/src/core/user"
click node_llm "https://github.com/amirmahdimtz/multirag-clean/tree/main/src/core/llm"
click node_entities "https://github.com/amirmahdimtz/multirag-clean/tree/main/src/domain/models"
click node_database "https://github.com/amirmahdimtz/multirag-clean/blob/main/src/infrastructure/database/db_context.py"
click node_repositories "https://github.com/amirmahdimtz/multirag-clean/tree/main/src/infrastructure/repositories"
click node_processing "https://github.com/amirmahdimtz/multirag-clean/tree/main/src/infrastructure/document_processing"
click node_storage "https://github.com/amirmahdimtz/multirag-clean/blob/main/src/infrastructure/storage/file_storage_service.py"
click node_embeddings "https://github.com/amirmahdimtz/multirag-clean/tree/main/src/infrastructure/embedding"
click node_vectors "https://github.com/amirmahdimtz/multirag-clean/tree/main/src/infrastructure/vector_store"
click node_chat_provider "https://github.com/amirmahdimtz/multirag-clean/tree/main/src/infrastructure/llm"

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_host,node_web,node_auth,node_datasets_api,node_user_datasets_api,node_rag_api,node_access_api,node_chat_api,node_user_api,node_caller toneBlue
class node_dataset_usecase,node_rag_usecase,node_access_usecase,node_chat_usecase,node_user_usecase,node_llm toneAmber
class node_entities toneMint
class node_database,node_repositories,node_processing,node_storage,node_embeddings,node_vectors,node_chat_provider toneRose
```

## Components

### API and Host

- [Web host](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/host/app.py): `src/host/app.py`
- [Web service](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/web.py): `src/application/web.py`
- [API-key security](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/security/api_key_dependencies.py): `src/application/security/api_key_dependencies.py`
- [Dataset APIs](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/dataset/dataset_controller.py): `src/application/dataset/dataset_controller.py`
- [User dataset APIs](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/dataset/user_dataset_controller.py): `src/application/dataset/user_dataset_controller.py`
- [RAG system APIs](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/rag_system/rag_system_controller.py): `src/application/rag_system/rag_system_controller.py`
- [RAG access APIs](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/rag_access/rag_access_controller.py): `src/application/rag_access/rag_access_controller.py`
- [Chat APIs](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/chat/chat_controller.py): `src/application/chat/chat_controller.py`
- [User APIs](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/application/user/user_controller.py): `src/application/user/user_controller.py`

### Core Use Cases

- [Dataset operations](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/core/dataset): `src/core/dataset`
- [RAG operations](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/core/rag_system): `src/core/rag_system`
- [Access operations](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/core/rag_access): `src/core/rag_access`
- [Chat orchestration](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/core/chat/chat_business.py): `src/core/chat/chat_business.py`
- [User operations](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/core/user): `src/core/user`
- [LLM selection](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/core/llm): `src/core/llm`

### Domain Data

- [Domain entities](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/domain/models): `src/domain/models`

### Infrastructure Providers

- [SQL database](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/infrastructure/database/db_context.py): `src/infrastructure/database/db_context.py`
- [Repositories](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/infrastructure/repositories): `src/infrastructure/repositories`
- [Document processing](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/infrastructure/document_processing): `src/infrastructure/document_processing`
- [File storage](https://github.com/amirmahdimtz/multirag-clean/blob/main/src/infrastructure/storage/file_storage_service.py): `src/infrastructure/storage/file_storage_service.py`
- [Embedding providers](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/infrastructure/embedding): `src/infrastructure/embedding`
- [Vector stores](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/infrastructure/vector_store): `src/infrastructure/vector_store`
- [Chat-model providers](https://github.com/amirmahdimtz/multirag-clean/tree/main/src/infrastructure/llm): `src/infrastructure/llm`

### Other components

- **API clients**

## Connections

- API clients → Web host: sends request
- Web host → Web service: starts (evidence: `src/host/app.py`)
- Web service → Dataset APIs: registers routes
- Web service → RAG system APIs: registers routes
- API clients → Dataset APIs: invokes dataset API
- API clients → RAG system APIs: invokes RAG API
- Dataset APIs → API-key security: requires admin key (evidence: `src/application/dataset/dataset_controller.py`)
- RAG system APIs → API-key security: requires admin key (evidence: `src/application/rag_system/rag_system_controller.py`)
- Dataset APIs → Dataset operations: delegates operations (evidence: `src/application/dataset/dataset_controller.py`)
- User dataset APIs → Dataset operations: delegates operations (evidence: `src/application/dataset/user_dataset_controller.py`)
- RAG system APIs → RAG operations: delegates queries (evidence: `src/application/rag_system/rag_system_controller.py`)
- RAG access APIs → Access operations: delegates access (evidence: `src/application/rag_access/rag_access_controller.py`)
- Chat APIs → Chat orchestration: delegates chat (evidence: `src/application/chat/chat_controller.py`)
- User APIs → User operations: delegates user tasks (evidence: `src/application/user/user_controller.py`)
- Dataset APIs → Document processing: processes documents
- Dataset operations → File storage: stores files
- Dataset operations → Embedding providers: requests embeddings
- Dataset operations → Vector stores: vectorizes and searches
- RAG operations → Vector stores: searches vectors
- RAG operations → LLM selection: generates answers
- Chat orchestration → LLM selection: selects chat model
- LLM selection → Chat-model providers: uses provider
- Dataset operations → Repositories: uses contracts
- RAG operations → Repositories: uses contracts
- Access operations → Repositories: uses contracts
- Repositories → SQL database: opens sessions (evidence: `src/infrastructure/repositories/rag_access_repository.py`)
- Repositories → Domain entities: reads and writes (evidence: `src/infrastructure/repositories/rag_access_repository.py`)
- Access operations → Domain entities: manages access records
