# nithyasree0412/dentiq architecture

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

- Interactive diagram: https://gitdiagram.com/nithyasree0412/dentiq
- Repository: https://github.com/nithyasree0412/dentiq

## Overview

This repository implements a study-assistance product: users can register and log in, access subject and test features, ask questions grounded in study PDFs, and generate practice questions. The Python service exposes PDF ingestion, doubt-answering, and test-generation endpoints; the Node backend provides user, subject, AI, and admin routes. The shown frontend is minimal and does not establish a connection to either backend. Some backend route internals and integrations were not sampled, so those relationships are omitted rather than inferred.

Main entry points: [`backend/routes/user.js`](https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/user.js) (User routes), [`backend/routes/index.js`](https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/index.js) (Route registry), [`app/routes/rag.py`](https://github.com/nithyasree0412/dentiq/blob/main/app/routes/rag.py) (RAG endpoints), [`backend/routes/admin.js`](https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/admin.js) (Admin routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_web_entry["React entry<br/>[main.jsx]"]
  node_app_routes["App routes<br/>[App.jsx]"]
  node_input_box["Input box<br/>[inputbox.jsx]"]
end

subgraph group_api["Application API"]
  node_node_server["Node server<br/>[index.js]"]
  node_api_routes["Route registry<br/>[index.js]"]
  node_user_routes["User routes<br/>[user.js]"]
  node_subject_routes["Subject routes<br/>[subject.js]"]
  node_ai_routes["AI routes<br/>[ai.js]"]
  node_admin_routes["Admin routes<br/>[admin.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_admin_auth["Admin authorization<br/>[admin.js]"]
  node_jwt["Token utility<br/>[jwt.js]"]
  node_streak["Streak tracking<br/>[streak.js]"]
  node_validation["User validation<br/>[user.js]"]
end

subgraph group_rag["Study AI"]
  node_rag_api["RAG endpoints<br/>[rag.py]"]
  node_pdf_processing["PDF processing<br/>[pdf_service.py]"]
  node_embeddings["Embedding service"]
  node_rag_logic["Retrieval and generation<br/>[rag_service.py]"]
  node_vector_store["Milvus service<br/>[milvus_service.py]"]
  node_llm["Language model<br/>[llm_service.py]"]
  node_rag_server["FastAPI server<br/>[main.py]"]
end

subgraph group_storage["Persistence and models"]
  node_mongo_models["Mongo models<br/>[db.js]"]
  node_mongo_connection["Database setup<br/>[dbs.js]"]
  node_milvus_data[("Milvus collection<br/>[bds_rag.db]")]
end

node_learner(("Learner"))

node_learner -->|"opens"| node_web_entry
node_web_entry -->|"renders"| node_app_routes
node_app_routes -->|"routes to"| node_input_box
node_node_server -->|"mounts"| node_api_routes
node_api_routes -->|"dispatches"| node_user_routes
node_api_routes -->|"dispatches"| node_ai_routes
node_api_routes -->|"dispatches"| node_subject_routes
node_api_routes -->|"dispatches"| node_admin_routes
node_user_routes -->|"reads and writes"| node_mongo_models
node_user_routes -->|"validates with"| node_validation
node_user_routes -->|"creates tokens"| node_jwt
node_user_routes -->|"updates"| node_streak
node_user_routes -->|"protects route"| node_auth
node_auth -->|"verifies with"| node_jwt
node_subject_routes -->|"uses models"| node_mongo_models
node_ai_routes -.->|"uses middleware"| node_auth
node_ai_routes -.->|"uses models"| node_mongo_models
node_admin_routes -.->|"uses middleware"| node_auth
node_admin_routes -.->|"uses middleware"| node_admin_auth
node_admin_routes -.->|"uses models"| node_mongo_models
node_rag_server -->|"mounts"| node_rag_api
node_rag_api -->|"extracts and splits"| node_pdf_processing
node_rag_api -->|"embeds chunks"| node_embeddings
node_rag_api -->|"prepares and inserts"| node_vector_store
node_rag_api -->|"delegates questions"| node_rag_logic
node_rag_logic -->|"embeds queries"| node_embeddings
node_rag_logic -->|"searches candidates"| node_vector_store
node_rag_logic -->|"generates answers"| node_llm
node_vector_store -.->|"stores vectors"| node_milvus_data

click node_web_entry "https://github.com/nithyasree0412/dentiq/blob/main/frontend/src/main.jsx"
click node_app_routes "https://github.com/nithyasree0412/dentiq/blob/main/frontend/src/App.jsx"
click node_input_box "https://github.com/nithyasree0412/dentiq/blob/main/frontend/src/components/inputbox.jsx"
click node_node_server "https://github.com/nithyasree0412/dentiq/blob/main/backend/index.js"
click node_api_routes "https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/index.js"
click node_user_routes "https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/user.js"
click node_subject_routes "https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/subject.js"
click node_ai_routes "https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/ai.js"
click node_admin_routes "https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/admin.js"
click node_auth "https://github.com/nithyasree0412/dentiq/blob/main/backend/middleware/auth.js"
click node_admin_auth "https://github.com/nithyasree0412/dentiq/blob/main/backend/middleware/admin.js"
click node_jwt "https://github.com/nithyasree0412/dentiq/blob/main/backend/utils/jwt.js"
click node_streak "https://github.com/nithyasree0412/dentiq/blob/main/backend/utils/streak.js"
click node_validation "https://github.com/nithyasree0412/dentiq/blob/main/backend/validations/user.js"
click node_mongo_models "https://github.com/nithyasree0412/dentiq/blob/main/backend/db.js"
click node_mongo_connection "https://github.com/nithyasree0412/dentiq/blob/main/backend/dbs.js"
click node_rag_api "https://github.com/nithyasree0412/dentiq/blob/main/app/routes/rag.py"
click node_pdf_processing "https://github.com/nithyasree0412/dentiq/blob/main/app/services/pdf_service.py"
click node_embeddings "https://github.com/nithyasree0412/dentiq/blob/main/app/services/embedding_service.py"
click node_rag_logic "https://github.com/nithyasree0412/dentiq/blob/main/app/services/rag_service.py"
click node_vector_store "https://github.com/nithyasree0412/dentiq/blob/main/app/services/milvus_service.py"
click node_llm "https://github.com/nithyasree0412/dentiq/blob/main/app/services/llm_service.py"
click node_milvus_data "https://github.com/nithyasree0412/dentiq/tree/main/bds_rag.db"
click node_rag_server "https://github.com/nithyasree0412/dentiq/blob/main/app/main.py"

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_web_entry,node_app_routes,node_input_box toneBlue
class node_node_server,node_api_routes,node_user_routes,node_subject_routes,node_ai_routes,node_admin_routes,node_auth,node_admin_auth,node_jwt,node_streak,node_validation toneAmber
class node_rag_api,node_pdf_processing,node_embeddings,node_rag_logic,node_vector_store,node_llm,node_rag_server toneMint
class node_mongo_models,node_mongo_connection,node_milvus_data toneRose
class node_learner toneIndigo
```

## Components

### Web client

- [React entry](https://github.com/nithyasree0412/dentiq/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [App routes](https://github.com/nithyasree0412/dentiq/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Input box](https://github.com/nithyasree0412/dentiq/blob/main/frontend/src/components/inputbox.jsx): `frontend/src/components/inputbox.jsx`

### Application API

- [Node server](https://github.com/nithyasree0412/dentiq/blob/main/backend/index.js): `backend/index.js`
- [Route registry](https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/index.js): `backend/routes/index.js`
- [User routes](https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/user.js): `backend/routes/user.js`
- [Subject routes](https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/subject.js): `backend/routes/subject.js`
- [AI routes](https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/ai.js): `backend/routes/ai.js`
- [Admin routes](https://github.com/nithyasree0412/dentiq/blob/main/backend/routes/admin.js): `backend/routes/admin.js`
- [Authentication](https://github.com/nithyasree0412/dentiq/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Admin authorization](https://github.com/nithyasree0412/dentiq/blob/main/backend/middleware/admin.js): `backend/middleware/admin.js`
- [Token utility](https://github.com/nithyasree0412/dentiq/blob/main/backend/utils/jwt.js): `backend/utils/jwt.js`
- [Streak tracking](https://github.com/nithyasree0412/dentiq/blob/main/backend/utils/streak.js): `backend/utils/streak.js`
- [User validation](https://github.com/nithyasree0412/dentiq/blob/main/backend/validations/user.js): `backend/validations/user.js`

### Study AI

- [RAG endpoints](https://github.com/nithyasree0412/dentiq/blob/main/app/routes/rag.py): `app/routes/rag.py`
- [PDF processing](https://github.com/nithyasree0412/dentiq/blob/main/app/services/pdf_service.py): `app/services/pdf_service.py`
- [Embedding service](https://github.com/nithyasree0412/dentiq/blob/main/app/services/embedding_service.py): `app/services/embedding_service.py`
- [Retrieval and generation](https://github.com/nithyasree0412/dentiq/blob/main/app/services/rag_service.py): `app/services/rag_service.py`
- [Milvus service](https://github.com/nithyasree0412/dentiq/blob/main/app/services/milvus_service.py): `app/services/milvus_service.py`
- [Language model](https://github.com/nithyasree0412/dentiq/blob/main/app/services/llm_service.py): `app/services/llm_service.py`
- [FastAPI server](https://github.com/nithyasree0412/dentiq/blob/main/app/main.py): `app/main.py`

### Persistence and models

- [Mongo models](https://github.com/nithyasree0412/dentiq/blob/main/backend/db.js): `backend/db.js`
- [Database setup](https://github.com/nithyasree0412/dentiq/blob/main/backend/dbs.js): `backend/dbs.js`
- [Milvus collection](https://github.com/nithyasree0412/dentiq/tree/main/bds_rag.db): `bds_rag.db`

### Other components

- **Learner**

## Connections

- Learner → React entry: opens
- React entry → App routes: renders (evidence: `frontend/src/main.jsx`)
- App routes → Input box: routes to (evidence: `frontend/src/App.jsx`)
- Node server → Route registry: mounts (evidence: `backend/index.js`)
- Route registry → User routes: dispatches (evidence: `backend/routes/index.js`)
- Route registry → AI routes: dispatches (evidence: `backend/routes/index.js`)
- Route registry → Subject routes: dispatches (evidence: `backend/routes/index.js`)
- Route registry → Admin routes: dispatches (evidence: `backend/routes/index.js`)
- User routes → Mongo models: reads and writes (evidence: `backend/routes/user.js`)
- User routes → User validation: validates with (evidence: `backend/routes/user.js`)
- User routes → Token utility: creates tokens (evidence: `backend/routes/user.js`)
- User routes → Streak tracking: updates (evidence: `backend/routes/user.js`)
- User routes → Authentication: protects route (evidence: `backend/routes/user.js`)
- Authentication → Token utility: verifies with (evidence: `backend/middleware/auth.js`)
- Subject routes → Mongo models: uses models (evidence: `backend/routes/subject.js`)
- AI routes → Authentication: uses middleware (evidence: `backend/routes/ai.js`)
- AI routes → Mongo models: uses models (evidence: `backend/routes/ai.js`)
- Admin routes → Authentication: uses middleware (evidence: `backend/routes/admin.js`)
- Admin routes → Admin authorization: uses middleware (evidence: `backend/routes/admin.js`)
- Admin routes → Mongo models: uses models (evidence: `backend/routes/admin.js`)
- FastAPI server → RAG endpoints: mounts (evidence: `app/main.py`)
- RAG endpoints → PDF processing: extracts and splits (evidence: `app/routes/rag.py`)
- RAG endpoints → Embedding service: embeds chunks (evidence: `app/routes/rag.py`)
- RAG endpoints → Milvus service: prepares and inserts (evidence: `app/routes/rag.py`)
- RAG endpoints → Retrieval and generation: delegates questions (evidence: `app/routes/rag.py`)
- Retrieval and generation → Embedding service: embeds queries (evidence: `app/services/rag_service.py`)
- Retrieval and generation → Milvus service: searches candidates (evidence: `app/services/rag_service.py`)
- Retrieval and generation → Language model: generates answers (evidence: `app/services/rag_service.py`)
- Milvus service → Milvus collection: stores vectors
