# vanminhdang0405-web/ai-learning-assistant architecture

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

- Interactive diagram: https://gitdiagram.com/vanminhdang0405-web/ai-learning-assistant
- Repository: https://github.com/vanminhdang0405-web/ai-learning-assistant

## Overview

This is an AI-assisted study app: learners authenticate, upload and organize documents, extract readable text, request scoped summaries, ask document questions, and generate study exercises. The mobile app presents these workflows and calls an authenticated Express API; backend services parse files, coordinate Gemini requests, and persist user, document, summary, conversation, and exercise data. The principal path is upload → extraction → summary or questions, with account and exercise branches. Some unsampled mobile screens and backend integrations are represented at their directory or route level; unverified links are omitted.

Main entry points: [`mobile/App.js`](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/App.js) (App navigation), [`backend/db.js`](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/db.js) (Application database), [`backend/routes/documents.js`](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/routes/documents.js) (Document routes), [`backend/middleware/requireAuth.js`](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/middleware/requireAuth.js) (Auth guard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile app"]
  node_app["App navigation<br/>[App.js]"]
  node_authscreen["Sign-in screens<br/>[AuthScreen.js]"]
  node_docsscreen["Document screens<br/>[DocumentsScreen.js]"]
  node_textscreen["Document workspace"]
  node_summaryscreen["Summary screen"]
  node_questionsscreen["Question panel"]
  node_exercisescreen["Exercise panel"]
  node_authclient["Auth client<br/>[auth.js]"]
  node_docclient["Document client<br/>[documents.js]"]
  node_questionclient["Question client<br/>[questions.js]"]
  node_exerciseclient["Exercise client<br/>[exercises.js]"]
end

subgraph group_api["API and accounts"]
  node_server["API server<br/>[server.js]"]
  node_authroutes["Account routes<br/>[auth.js]"]
  node_authguard["Auth guard<br/>[requireAuth.js]"]
end

subgraph group_documents["Document processing"]
  node_docroutes["Document routes<br/>[documents.js]"]
  node_extractors["File extraction<br/>[pdfText.js]"]
  node_textstore["Extracted text"]
end

subgraph group_study["AI study tools"]
  node_summaryroutes["Summary routes"]
  node_summaryai["Summary generation<br/>[geminiSummary.js]"]
  node_questionroutes["Question routes"]
  node_questionai["Question generation<br/>[geminiQuestions.js]"]
  node_exerciseroutes["Exercise routes<br/>[exercises.js]"]
  node_exerciseai["Exercise generation<br/>[geminiExercises.js]"]
end

subgraph group_data["Persistence"]
  node_db[("Application database<br/>[db.js]")]
  node_summarydata["Summary storage"]
  node_conversationdata["Conversation storage"]
  node_exercisedata["Exercise storage<br/>[exerciseStore.js]"]
end

node_learner(("Learner"))
node_gemini{{"Gemini API"}}

node_learner -->|"uses"| node_app
node_app -->|"navigates"| node_authscreen
node_app -->|"navigates"| node_docsscreen
node_app -->|"navigates"| node_textscreen
node_app -->|"navigates"| node_summaryscreen
node_authscreen -->|"submits credentials"| node_authclient
node_authclient -->|"calls API"| node_authroutes
node_docsscreen -->|"manages documents"| node_docclient
node_summaryscreen -->|"requests summaries"| node_docclient
node_docclient -->|"calls API"| node_docroutes
node_app -.->|"connects to API"| node_server
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_docroutes
node_server -->|"mounts"| node_exerciseroutes
node_authroutes -->|"reads and writes"| node_db
node_authroutes -->|"protects routes"| node_authguard
node_authguard -->|"checks session"| node_db
node_docroutes -->|"authenticates"| node_authguard
node_docroutes -->|"extracts content"| node_extractors
node_docroutes -->|"loads and saves text"| node_textstore
node_docroutes -->|"stores documents"| node_db
node_summaryroutes -->|"authenticates"| node_authguard
node_summaryroutes -->|"generates summaries"| node_summaryai
node_summaryroutes -->|"reads and saves"| node_summarydata
node_questionroutes -->|"authenticates"| node_authguard
node_questionroutes -->|"generates answers"| node_questionai
node_questionroutes -->|"manages history"| node_conversationdata
node_exerciseroutes -->|"authenticates"| node_authguard
node_exerciseroutes -->|"generates exercises"| node_exerciseai
node_exerciseroutes -->|"uses exercise data"| node_exercisedata
node_summaryai -->|"requests generation"| node_gemini
node_questionroutes -->|"loads source"| node_summarydata
node_summarydata -->|"persists summaries"| node_db
node_textstore -->|"persists extraction"| node_db
node_conversationdata -->|"persists conversations"| node_db
node_exercisedata -->|"persists exercises"| node_db
node_questionsscreen -.->|"requests answers"| node_questionclient
node_exercisescreen -.->|"requests exercises"| node_exerciseclient

click node_app "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/App.js"
click node_authscreen "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/screen/AuthScreen.js"
click node_docsscreen "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/screen/DocumentsScreen.js"
click node_textscreen "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/screen/DocumentTextScreen.js"
click node_summaryscreen "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/screen/DocumentSummaryScreen.js"
click node_questionsscreen "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/screen/DocumentQuestionsPanel.js"
click node_exercisescreen "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/screen/StudyExercisePanel.js"
click node_authclient "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/services/auth.js"
click node_docclient "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/services/documents.js"
click node_questionclient "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/services/questions.js"
click node_exerciseclient "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/services/exercises.js"
click node_server "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/server.js"
click node_authroutes "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/routes/auth.js"
click node_authguard "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/middleware/requireAuth.js"
click node_docroutes "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/routes/documents.js"
click node_extractors "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/pdfText.js"
click node_textstore "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/documentTextStore.js"
click node_summaryroutes "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/routes/documentSummaries.js"
click node_summaryai "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/geminiSummary.js"
click node_questionroutes "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/routes/documentQuestions.js"
click node_questionai "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/geminiQuestions.js"
click node_exerciseroutes "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/routes/exercises.js"
click node_exerciseai "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/geminiExercises.js"
click node_db "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/db.js"
click node_summarydata "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/documentSummaryStore.js"
click node_conversationdata "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/documentConversationStore.js"
click node_exercisedata "https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/exerciseStore.js"

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_app,node_authscreen,node_docsscreen,node_textscreen,node_summaryscreen,node_questionsscreen,node_exercisescreen,node_authclient,node_docclient,node_questionclient,node_exerciseclient toneBlue
class node_server,node_authroutes,node_authguard toneAmber
class node_docroutes,node_extractors,node_textstore,node_gemini toneMint
class node_summaryroutes,node_summaryai,node_questionroutes,node_questionai,node_exerciseroutes,node_exerciseai toneRose
class node_db,node_summarydata,node_conversationdata,node_exercisedata,node_learner toneIndigo
```

## Components

### Mobile app

- [App navigation](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/App.js): `mobile/App.js`
- [Sign-in screens](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/screen/AuthScreen.js): `mobile/src/screen/AuthScreen.js`
- [Document screens](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/screen/DocumentsScreen.js): `mobile/src/screen/DocumentsScreen.js`
- [Document workspace](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/screen/DocumentTextScreen.js): `mobile/src/screen/DocumentTextScreen.js`
- [Summary screen](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/screen/DocumentSummaryScreen.js): `mobile/src/screen/DocumentSummaryScreen.js`
- [Question panel](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/screen/DocumentQuestionsPanel.js): `mobile/src/screen/DocumentQuestionsPanel.js`
- [Exercise panel](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/screen/StudyExercisePanel.js): `mobile/src/screen/StudyExercisePanel.js`
- [Auth client](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/services/auth.js): `mobile/src/services/auth.js`
- [Document client](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/services/documents.js): `mobile/src/services/documents.js`
- [Question client](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/services/questions.js): `mobile/src/services/questions.js`
- [Exercise client](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/mobile/src/services/exercises.js): `mobile/src/services/exercises.js`

### API and accounts

- [API server](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/server.js): `backend/server.js`
- [Account routes](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Auth guard](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/middleware/requireAuth.js): `backend/middleware/requireAuth.js`

### Document processing

- [Document routes](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/routes/documents.js): `backend/routes/documents.js`
- [File extraction](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/pdfText.js): `backend/services/pdfText.js`
- [Extracted text](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/documentTextStore.js): `backend/services/documentTextStore.js`

### AI study tools

- [Summary routes](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/routes/documentSummaries.js): `backend/routes/documentSummaries.js`
- [Summary generation](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/geminiSummary.js): `backend/services/geminiSummary.js`
- [Question routes](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/routes/documentQuestions.js): `backend/routes/documentQuestions.js`
- [Question generation](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/geminiQuestions.js): `backend/services/geminiQuestions.js`
- [Exercise routes](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/routes/exercises.js): `backend/routes/exercises.js`
- [Exercise generation](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/geminiExercises.js): `backend/services/geminiExercises.js`

### Persistence

- [Application database](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/db.js): `backend/db.js`
- [Summary storage](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/documentSummaryStore.js): `backend/services/documentSummaryStore.js`
- [Conversation storage](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/documentConversationStore.js): `backend/services/documentConversationStore.js`
- [Exercise storage](https://github.com/vanminhdang0405-web/ai-learning-assistant/blob/main/backend/services/exerciseStore.js): `backend/services/exerciseStore.js`

### Other components

- **Learner**
- **Gemini API**

## Connections

- Learner → App navigation: uses (evidence: `mobile/App.js`)
- App navigation → Sign-in screens: navigates (evidence: `mobile/App.js`)
- App navigation → Document screens: navigates (evidence: `mobile/App.js`)
- App navigation → Document workspace: navigates (evidence: `mobile/App.js`)
- App navigation → Summary screen: navigates (evidence: `mobile/App.js`)
- Sign-in screens → Auth client: submits credentials (evidence: `mobile/src/screen/AuthScreen.js`)
- Auth client → Account routes: calls API (evidence: `mobile/src/services/auth.js`)
- Document screens → Document client: manages documents (evidence: `mobile/src/services/documents.js`)
- Summary screen → Document client: requests summaries (evidence: `mobile/src/services/documents.js`)
- Document client → Document routes: calls API (evidence: `mobile/src/services/documents.js`)
- App navigation → API server: connects to API
- API server → Account routes: mounts (evidence: `backend/server.js`)
- API server → Document routes: mounts (evidence: `backend/server.js`)
- API server → Exercise routes: mounts (evidence: `backend/server.js`)
- Account routes → Application database: reads and writes (evidence: `backend/routes/auth.js`)
- Account routes → Auth guard: protects routes (evidence: `backend/routes/auth.js`)
- Auth guard → Application database: checks session (evidence: `backend/middleware/requireAuth.js`)
- Document routes → Auth guard: authenticates (evidence: `backend/routes/documents.js`)
- Document routes → File extraction: extracts content (evidence: `backend/routes/documents.js`)
- Document routes → Extracted text: loads and saves text (evidence: `backend/routes/documents.js`)
- Document routes → Application database: stores documents (evidence: `backend/routes/documents.js`)
- Summary routes → Auth guard: authenticates (evidence: `backend/routes/documentSummaries.js`)
- Summary routes → Summary generation: generates summaries (evidence: `backend/routes/documentSummaries.js`)
- Summary routes → Summary storage: reads and saves (evidence: `backend/routes/documentSummaries.js`)
- Question routes → Auth guard: authenticates (evidence: `backend/routes/documentQuestions.js`)
- Question routes → Question generation: generates answers (evidence: `backend/routes/documentQuestions.js`)
- Question routes → Conversation storage: manages history (evidence: `backend/routes/documentQuestions.js`)
- Exercise routes → Auth guard: authenticates (evidence: `backend/routes/exercises.js`)
- Exercise routes → Exercise generation: generates exercises (evidence: `backend/routes/exercises.js`)
- Exercise routes → Exercise storage: uses exercise data (evidence: `backend/routes/exercises.js`)
- Summary generation → Gemini API: requests generation (evidence: `backend/services/geminiSummary.js`)
- Question routes → Summary storage: loads source (evidence: `backend/routes/documentQuestions.js`)
- Summary storage → Application database: persists summaries (evidence: `backend/services/documentSummaryStore.js`)
- Extracted text → Application database: persists extraction (evidence: `backend/services/documentTextStore.js`)
- Conversation storage → Application database: persists conversations (evidence: `backend/services/documentConversationStore.js`)
- Exercise storage → Application database: persists exercises (evidence: `backend/services/exerciseStore.js`)
- Question panel → Question client: requests answers (evidence: `mobile/src/screen/DocumentQuestionsPanel.js`)
- Exercise panel → Exercise client: requests exercises
