How lingarobotics/lgc-concept-ai works
LGC Concept AI is a mode-based learning assistant for engineering students. Learners enter through the React app, choose Learn, Fast Learn, Doubt, or Teach-Back, provide a topic/question or explanation, and receive a mode-constrained AI response. The backend routes AI requests through prompt/model selection and provider fallback; separate flows support account verification, password recovery, and activity logging. The README documents the mode capabilities and multi-provider fallback, while some wiring is only established by documentation because its implementation was not sampled.
Main entry points: ai.js AI endpoint · App.jsx App routing · question.js Activity logging · LearnMode.jsx Learn mode
Components 29
Learning experience
- App routing
frontend/src/App.jsx - Home entry
frontend/src/Pages/Home.jsx - Mode navigation
frontend/src/components/ModeSwitchCTA.jsx - Learn mode
frontend/src/Pages/LearnMode.jsx - Fast Learn
frontend/src/Pages/FastLearnMode.jsx - Doubt mode
frontend/src/Pages/DoubtMode.jsx - Teach-Back
frontend/src/Pages/TeachBackMode.jsx - Subject context
frontend/src/components/SubjectInput.jsx - Mode guidance
frontend/src/Pages/Docs.jsx
Identity and activity
- Auth screen
frontend/src/Pages/AuthPage.jsx - Registration form
frontend/src/components/RegisterForm.jsx - Login form
frontend/src/components/LoginForm.jsx - Auth state
frontend/src/context/AuthContext.jsx - Auth endpoints
backend/routes/auth.js - Email delivery
backend/utils/sendEmail.js
AI orchestration
- AI endpoint
backend/routes/ai.js - AI service
backend/services/aiService.js - Mode prompts
backend/config/prompts.js - Model selection
backend/config/modelSelector.js - Express routing
backend/app.js - Request limits
backend/middleware/rateLimiter.js
Persistence
- User records
backend/models/User.js - Activity logging
backend/routes/question.js - Question history
backend/models/UserQuestions.js - Explanation history
backend/models/UserExplanations.js - Question log
backend/models/QuestionLog.js
Other components
- Student
- Model providers
- MongoDB
Connections 46
- Student → App routing: uses
frontend/src/App.jsx - App routing → Home entry: routes to
frontend/src/App.jsx - Home entry → Learn mode: launches
frontend/src/App.jsx - App routing → Learn mode: routes to
frontend/src/App.jsx - App routing → Fast Learn: routes to
frontend/src/App.jsx - App routing → Doubt mode: routes to
frontend/src/App.jsx - App routing → Teach-Back: routes to
frontend/src/App.jsx - Learn mode → Mode navigation: renders
frontend/src/Pages/LearnMode.jsx - Fast Learn → Mode navigation: renders
frontend/src/Pages/FastLearnMode.jsx - Doubt mode → Mode navigation: renders
frontend/src/Pages/DoubtMode.jsx - Teach-Back → Mode navigation: renders
frontend/src/Pages/TeachBackMode.jsx - Learn mode → Subject context: renders
frontend/src/Pages/LearnMode.jsx - Doubt mode → Subject context: renders
frontend/src/Pages/DoubtMode.jsx - Teach-Back → Subject context: renders
frontend/src/Pages/TeachBackMode.jsx - Student → Auth screen: opens
- Auth screen → Registration form: renders
frontend/src/Pages/AuthPage.jsx - Auth screen → Login form: renders
frontend/src/Pages/AuthPage.jsx - Auth screen → Auth state: updates
frontend/src/Pages/AuthPage.jsx - Registration form → Auth endpoints: registers via
- Login form → Auth endpoints: logs in via
- Auth endpoints → User records: reads/writes
backend/routes/auth.js - Auth endpoints → Email delivery: sends links
backend/routes/auth.js - Student → Learn mode: submits topic
README.md - Student → Fast Learn: requests summary
README.md - Student → Doubt mode: asks doubt
README.md - Student → Teach-Back: explains concept
README.md - Learn mode → AI endpoint: requests answer
- Fast Learn → AI endpoint: requests answer
- Doubt mode → AI endpoint: requests answer
- Teach-Back → AI endpoint: requests evaluation
- AI endpoint → AI service: calls
backend/routes/ai.js - AI endpoint → Request limits: applies
backend/routes/ai.js - AI service → Mode prompts: loads prompt
backend/services/aiService.js - AI service → Model selection: selects models
backend/services/aiService.js - AI service → Model providers: calls with fallback
backend/services/aiService.js - Express routing → AI endpoint: mounts
backend/app.js - Express routing → Request limits: applies globally
backend/app.js - Student → Activity logging: logs activity
- Express routing → Activity logging: mounts
backend/app.js - Activity logging → User records: checks user
backend/routes/question.js - Activity logging → Question history: writes questions
backend/routes/question.js - Activity logging → Explanation history: writes explanations
backend/routes/question.js - Activity logging → User records: updates count
backend/routes/question.js - User records → MongoDB: persists in
- Question history → MongoDB: persists in
- Explanation history → MongoDB: persists in