# uditkumar08/final_assessment_gen architecture

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

## Overview

This is a PDF-grounded question-answering application. A user uploads a PDF through the Streamlit UI; the backend extracts page text, chunks it, embeds and indexes it in Qdrant, then answers document-specific questions with retrieved passages and page references. The graph also preserves the separately exposed extraction, chunking, and indexing endpoints and the documented Prometheus metrics capability. Some service implementations and application wiring were not sampled, so documented workflow edges cite the README; uncertain links are omitted.

Main entry points: [`enterprise-ai-knowledge-assistant/backend/app/services/indexing_service.py`](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/indexing_service.py) (Indexing service), [`enterprise-ai-knowledge-assistant/backend/app/services/rag_service.py`](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/rag_service.py) (RAG answering), [`enterprise-ai-knowledge-assistant/frontend/ui_app.py`](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/frontend/ui_app.py) (Streamlit UI), [`enterprise-ai-knowledge-assistant/backend/app/api/documents.py`](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/api/documents.py) (Upload endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User interface"]
  node_ui["Streamlit UI<br/>[ui_app.py]"]
end

subgraph group_api["Backend API"]
  node_api_app["FastAPI app<br/>[main.py]"]
  node_documents_api["Upload endpoint<br/>[documents.py]"]
  node_extraction_api["Extraction endpoint<br/>[extraction.py]"]
  node_chunking_api["Chunking endpoint<br/>[chunking.py]"]
  node_indexing_api["Indexing endpoint<br/>[indexing.py]"]
  node_chat_api["Chat endpoint<br/>[chat.py]"]
end

subgraph group_ingestion["Document preparation"]
  node_pdf["PDF extraction<br/>[pdf_service.py]"]
  node_chunking["Document chunking"]
  node_splitter["Text splitter<br/>[chunk_service.py]"]
  node_indexing["Indexing service"]
  node_embedding["Embedding model"]
end

subgraph group_qa["Retrieval and operations"]
  node_rag["RAG answering<br/>[rag_service.py]"]
  node_vector_store[("Qdrant vectors<br/>[qdrant_service.py]")]
  node_prometheus["Prometheus metrics<br/>[prometheus.yml]"]
end

node_user(("PDF user"))
node_groq{{"Groq language model"}}

node_user -->|"uploads and asks"| node_ui
node_ui -->|"uploads PDF"| node_documents_api
node_ui -->|"sends question"| node_chat_api
node_documents_api -->|"extracts pages"| node_pdf
node_documents_api -->|"starts indexing"| node_indexing
node_extraction_api -->|"extracts PDF"| node_pdf
node_chunking_api -->|"chunks document"| node_chunking
node_chunking -->|"splits text"| node_splitter
node_indexing -->|"creates chunks"| node_chunking
node_indexing -->|"embeds chunks"| node_embedding
node_indexing -->|"stores vectors"| node_vector_store
node_indexing_api -.->|"indexes document"| node_indexing
node_chat_api -->|"answers question"| node_rag
node_rag -->|"embeds query"| node_embedding
node_rag -->|"retrieves passages"| node_vector_store
node_rag -->|"generates answer"| node_groq
node_prometheus -->|"scrapes metrics"| node_api_app

click node_ui "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/frontend/ui_app.py"
click node_api_app "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/main.py"
click node_documents_api "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/api/documents.py"
click node_extraction_api "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/api/extraction.py"
click node_chunking_api "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/api/chunking.py"
click node_indexing_api "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/api/indexing.py"
click node_chat_api "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/api/chat.py"
click node_pdf "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/pdf_service.py"
click node_chunking "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/document_chunking.py"
click node_splitter "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/chunk_service.py"
click node_indexing "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/indexing_service.py"
click node_embedding "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/embedding_service.py"
click node_rag "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/rag_service.py"
click node_vector_store "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/qdrant_service.py"
click node_prometheus "https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/monitoring/prometheus.yml"

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_ui,node_user toneBlue
class node_api_app,node_documents_api,node_extraction_api,node_chunking_api,node_indexing_api,node_chat_api toneAmber
class node_pdf,node_chunking,node_splitter,node_indexing,node_embedding toneMint
class node_rag,node_vector_store,node_prometheus toneRose
class node_groq toneIndigo
```

## Components

### User interface

- [Streamlit UI](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/frontend/ui_app.py): `enterprise-ai-knowledge-assistant/frontend/ui_app.py`

### Backend API

- [FastAPI app](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/main.py): `enterprise-ai-knowledge-assistant/backend/app/main.py`
- [Upload endpoint](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/api/documents.py): `enterprise-ai-knowledge-assistant/backend/app/api/documents.py`
- [Extraction endpoint](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/api/extraction.py): `enterprise-ai-knowledge-assistant/backend/app/api/extraction.py`
- [Chunking endpoint](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/api/chunking.py): `enterprise-ai-knowledge-assistant/backend/app/api/chunking.py`
- [Indexing endpoint](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/api/indexing.py): `enterprise-ai-knowledge-assistant/backend/app/api/indexing.py`
- [Chat endpoint](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/api/chat.py): `enterprise-ai-knowledge-assistant/backend/app/api/chat.py`

### Document preparation

- [PDF extraction](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/pdf_service.py): `enterprise-ai-knowledge-assistant/backend/app/services/pdf_service.py`
- [Document chunking](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/document_chunking.py): `enterprise-ai-knowledge-assistant/backend/app/services/document_chunking.py`
- [Text splitter](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/chunk_service.py): `enterprise-ai-knowledge-assistant/backend/app/services/chunk_service.py`
- [Indexing service](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/indexing_service.py): `enterprise-ai-knowledge-assistant/backend/app/services/indexing_service.py`
- [Embedding model](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/embedding_service.py): `enterprise-ai-knowledge-assistant/backend/app/services/embedding_service.py`

### Retrieval and operations

- [RAG answering](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/rag_service.py): `enterprise-ai-knowledge-assistant/backend/app/services/rag_service.py`
- [Qdrant vectors](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/backend/app/services/qdrant_service.py): `enterprise-ai-knowledge-assistant/backend/app/services/qdrant_service.py`
- [Prometheus metrics](https://github.com/uditkumar08/final_assessment_gen/blob/main/enterprise-ai-knowledge-assistant/monitoring/prometheus.yml): `enterprise-ai-knowledge-assistant/monitoring/prometheus.yml`

### Other components

- **PDF user**
- **Groq language model**

## Connections

- PDF user → Streamlit UI: uploads and asks (evidence: `README.md`)
- Streamlit UI → Upload endpoint: uploads PDF (evidence: `enterprise-ai-knowledge-assistant/frontend/ui_app.py`)
- Streamlit UI → Chat endpoint: sends question (evidence: `enterprise-ai-knowledge-assistant/frontend/ui_app.py`)
- Upload endpoint → PDF extraction: extracts pages (evidence: `enterprise-ai-knowledge-assistant/backend/app/api/documents.py`)
- Upload endpoint → Indexing service: starts indexing (evidence: `enterprise-ai-knowledge-assistant/backend/app/api/documents.py`)
- Extraction endpoint → PDF extraction: extracts PDF (evidence: `enterprise-ai-knowledge-assistant/backend/app/api/extraction.py`)
- Chunking endpoint → Document chunking: chunks document (evidence: `enterprise-ai-knowledge-assistant/backend/app/api/chunking.py`)
- Document chunking → Text splitter: splits text (evidence: `enterprise-ai-knowledge-assistant/backend/app/services/document_chunking.py`)
- Indexing service → Document chunking: creates chunks (evidence: `README.md`)
- Indexing service → Embedding model: embeds chunks (evidence: `README.md`)
- Indexing service → Qdrant vectors: stores vectors (evidence: `README.md`)
- Indexing endpoint → Indexing service: indexes document
- Chat endpoint → RAG answering: answers question (evidence: `enterprise-ai-knowledge-assistant/backend/app/api/chat.py`)
- RAG answering → Embedding model: embeds query (evidence: `README.md`)
- RAG answering → Qdrant vectors: retrieves passages (evidence: `README.md`)
- RAG answering → Groq language model: generates answer (evidence: `README.md`)
- Prometheus metrics → FastAPI app: scrapes metrics (evidence: `README.md`)
