How noah35802/edugen works
EduGen AI is a role-based learning platform: students, teachers, and administrators use the React app, which calls an Express API backed by PostgreSQL; AI tutoring delegates course-material ingestion and cited Q&A to a separate FastAPI RAG service. The README confirms these core technologies and tutoring capability. The tree and excerpts also show quiz generation, study planning, recommendations, and other AI features, but their internal service wiring is largely unsampled, so those branches are shown without speculative call chains.
Main entry points: App.tsx Role-based pages · routes.py RAG API · vector_store.py Vector index · AIFeaturePages.tsx Quiz and study features
Components 29
Learning application
- Role-based pages
src/routes/App.tsx - Authentication UI
src/pages/auth/AuthPages.tsx - Auth state
src/store/slices/authSlice.ts - Auth requests
src/services/authService.ts - API client
src/api/axiosClient.ts - Student learning
src/pages/student/StudentUtilityPages.tsx - Tutor and materials
src/pages/student/AITutorPage.tsx - Shared materials
src/components/courses/CourseMaterialsManager.tsx - Tutor requests
src/services/aiTutorService.ts - Quiz and study features
src/pages/student/AIFeaturePages.tsx
Platform API
- Express API
backend/src/server.js - Auth routes
backend/src/routes/auth.js - Auth controller
backend/src/controllers/authController.js - Tutor routes
backend/src/routes/aiTutor.js - Tutor controller
backend/src/controllers/aiTutorController.js - RAG adapter
backend/src/services/ragService.js
RAG tutoring
- RAG API
rag_service/app/api/routes.py - Document ingestion
rag_service/app/ingestion/pipeline.py - File loaders
rag_service/app/ingestion/loaders.py - Vector index
rag_service/app/retrieval/vector_store.py - Question answering
rag_service/app/generation/chain.py - Language model
rag_service/app/generation/llm.py - Embeddings
rag_service/app/retrieval/embeddings.py
AI learning services
- Quiz generation API
quiz-service/app/main.py - Quiz generator
quiz-service/app/generator.py - AI feature routes
ai-service/routes
Persistence and models
- PostgreSQL
backend/src/db.js - User records
backend/src/models/userModel.js
Other components
- Learners and staff
Connections 31
- Learners and staff → Role-based pages: uses
src/routes/App.tsx - Role-based pages → Authentication UI: routes to
src/routes/App.tsx - Authentication UI → Auth state: dispatches
src/pages/auth/AuthPages.tsx - Auth state → Auth requests: calls
src/store/slices/authSlice.ts - Auth requests → API client: sends requests
src/services/authService.ts - Role-based pages → Student learning: routes to
src/routes/App.tsx - Role-based pages → Tutor and materials: routes to
src/routes/App.tsx - Role-based pages → Quiz and study features: routes to
src/routes/App.tsx - Shared materials → Tutor requests: calls
src/components/courses/CourseMaterialsManager.tsx - Tutor and materials → Tutor requests: uses
- Tutor requests → API client: sends requests
src/services/aiTutorService.ts - API client → Express API: calls API
- Express API → Auth routes: mounts
backend/src/server.js - Auth routes → Auth controller: dispatches
backend/src/routes/auth.js - Auth controller → User records: uses
backend/src/controllers/authController.js - User records → PostgreSQL: queries
backend/src/models/userModel.js - Express API → Tutor routes: mounts
- Tutor routes → Tutor controller: dispatches
- Tutor controller → RAG adapter: calls
backend/src/controllers/aiTutorController.js - RAG adapter → RAG API: HTTP requests
backend/src/services/ragService.js - RAG API → Document ingestion: calls
rag_service/app/api/routes.py - Document ingestion → File loaders: loads files
rag_service/app/ingestion/pipeline.py - Document ingestion → Vector index: stores chunks
rag_service/app/ingestion/pipeline.py - RAG API → Vector index: lists and deletes
rag_service/app/api/routes.py - RAG API → Question answering: calls
rag_service/app/api/routes.py - Question answering → Vector index: retrieves context
rag_service/app/generation/chain.py - Question answering → Language model: calls
rag_service/app/generation/chain.py - Vector index → Embeddings: embeds queries
rag_service/app/retrieval/vector_store.py - Quiz and study features → Quiz generation API: uses service
- Quiz generation API → Quiz generator: calls
quiz-service/app/main.py - Quiz and study features → AI feature routes: AI features