How vanminhdang0405-web/ai-learning-assistant works
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: App.js App navigation · db.js Application database · documents.js Document routes · requireAuth.js Auth guard
Components 29
Mobile app
- App navigation
mobile/App.js - Sign-in screens
mobile/src/screen/AuthScreen.js - Document screens
mobile/src/screen/DocumentsScreen.js - Document workspace
mobile/src/screen/DocumentTextScreen.js - Summary screen
mobile/src/screen/DocumentSummaryScreen.js - Question panel
mobile/src/screen/DocumentQuestionsPanel.js - Exercise panel
mobile/src/screen/StudyExercisePanel.js - Auth client
mobile/src/services/auth.js - Document client
mobile/src/services/documents.js - Question client
mobile/src/services/questions.js - Exercise client
mobile/src/services/exercises.js
API and accounts
- API server
backend/server.js - Account routes
backend/routes/auth.js - Auth guard
backend/middleware/requireAuth.js
Document processing
- Document routes
backend/routes/documents.js - File extraction
backend/services/pdfText.js - Extracted text
backend/services/documentTextStore.js
AI study tools
- Summary routes
backend/routes/documentSummaries.js - Summary generation
backend/services/geminiSummary.js - Question routes
backend/routes/documentQuestions.js - Question generation
backend/services/geminiQuestions.js - Exercise routes
backend/routes/exercises.js - Exercise generation
backend/services/geminiExercises.js
Persistence
- Application database
backend/db.js - Summary storage
backend/services/documentSummaryStore.js - Conversation storage
backend/services/documentConversationStore.js - Exercise storage
backend/services/exerciseStore.js
Other components
- Learner
- Gemini API
Connections 38
- Learner → App navigation: uses
mobile/App.js - App navigation → Sign-in screens: navigates
mobile/App.js - App navigation → Document screens: navigates
mobile/App.js - App navigation → Document workspace: navigates
mobile/App.js - App navigation → Summary screen: navigates
mobile/App.js - Sign-in screens → Auth client: submits credentials
mobile/src/screen/AuthScreen.js - Auth client → Account routes: calls API
mobile/src/services/auth.js - Document screens → Document client: manages documents
mobile/src/services/documents.js - Summary screen → Document client: requests summaries
mobile/src/services/documents.js - Document client → Document routes: calls API
mobile/src/services/documents.js - App navigation → API server: connects to API
- API server → Account routes: mounts
backend/server.js - API server → Document routes: mounts
backend/server.js - API server → Exercise routes: mounts
backend/server.js - Account routes → Application database: reads and writes
backend/routes/auth.js - Account routes → Auth guard: protects routes
backend/routes/auth.js - Auth guard → Application database: checks session
backend/middleware/requireAuth.js - Document routes → Auth guard: authenticates
backend/routes/documents.js - Document routes → File extraction: extracts content
backend/routes/documents.js - Document routes → Extracted text: loads and saves text
backend/routes/documents.js - Document routes → Application database: stores documents
backend/routes/documents.js - Summary routes → Auth guard: authenticates
backend/routes/documentSummaries.js - Summary routes → Summary generation: generates summaries
backend/routes/documentSummaries.js - Summary routes → Summary storage: reads and saves
backend/routes/documentSummaries.js - Question routes → Auth guard: authenticates
backend/routes/documentQuestions.js - Question routes → Question generation: generates answers
backend/routes/documentQuestions.js - Question routes → Conversation storage: manages history
backend/routes/documentQuestions.js - Exercise routes → Auth guard: authenticates
backend/routes/exercises.js - Exercise routes → Exercise generation: generates exercises
backend/routes/exercises.js - Exercise routes → Exercise storage: uses exercise data
backend/routes/exercises.js - Summary generation → Gemini API: requests generation
backend/services/geminiSummary.js - Question routes → Summary storage: loads source
backend/routes/documentQuestions.js - Summary storage → Application database: persists summaries
backend/services/documentSummaryStore.js - Extracted text → Application database: persists extraction
backend/services/documentTextStore.js - Conversation storage → Application database: persists conversations
backend/services/documentConversationStore.js - Exercise storage → Application database: persists exercises
backend/services/exerciseStore.js - Question panel → Question client: requests answers
mobile/src/screen/DocumentQuestionsPanel.js - Exercise panel → Exercise client: requests exercises