# lingarobotics/lgc-concept-ai architecture

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

- Interactive diagram: https://gitdiagram.com/lingarobotics/lgc-concept-ai
- Repository: https://github.com/lingarobotics/lgc-concept-ai

## Overview

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: [`backend/routes/ai.js`](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/routes/ai.js) (AI endpoint), [`frontend/src/App.jsx`](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/App.jsx) (App routing), [`backend/routes/question.js`](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/routes/question.js) (Activity logging), [`frontend/src/Pages/LearnMode.jsx`](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/LearnMode.jsx) (Learn mode)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning experience"]
  node_app["App routing<br/>[App.jsx]"]
  node_home["Home entry<br/>[Home.jsx]"]
  node_mode_switch["Mode navigation<br/>[ModeSwitchCTA.jsx]"]
  node_learn["Learn mode<br/>[LearnMode.jsx]"]
  node_fast["Fast Learn<br/>[FastLearnMode.jsx]"]
  node_doubt["Doubt mode<br/>[DoubtMode.jsx]"]
  node_teachback["Teach-Back<br/>[TeachBackMode.jsx]"]
  node_subject["Subject context<br/>[SubjectInput.jsx]"]
  node_docs["Mode guidance<br/>[Docs.jsx]"]
end

subgraph group_identity["Identity and activity"]
  node_auth_ui["Auth screen<br/>[AuthPage.jsx]"]
  node_register["Registration form<br/>[RegisterForm.jsx]"]
  node_login["Login form<br/>[LoginForm.jsx]"]
  node_auth_state["Auth state<br/>[AuthContext.jsx]"]
  node_auth_routes["Auth endpoints<br/>[auth.js]"]
  node_email["Email delivery<br/>[sendEmail.js]"]
end

subgraph group_ai["AI orchestration"]
  node_ai_route["AI endpoint<br/>[ai.js]"]
  node_ai_service["AI service<br/>[aiService.js]"]
  node_prompts["Mode prompts<br/>[prompts.js]"]
  node_models_select["Model selection<br/>[modelSelector.js]"]
  node_api["Express routing<br/>[app.js]"]
  node_limiter["Request limits<br/>[rateLimiter.js]"]
end

subgraph group_data["Persistence"]
  node_user_store[("User records<br/>[User.js]")]
  node_question_route["Activity logging<br/>[question.js]"]
  node_questions_store[("Question history<br/>[UserQuestions.js]")]
  node_explanations_store[("Explanation history")]
  node_question_log[("Question log<br/>[QuestionLog.js]")]
end

node_learner(("Student"))
node_provider["Model providers"]
node_db[("MongoDB")]

node_learner -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_home -->|"launches"| node_learn
node_app -->|"routes to"| node_learn
node_app -->|"routes to"| node_fast
node_app -->|"routes to"| node_doubt
node_app -->|"routes to"| node_teachback
node_learn -->|"renders"| node_mode_switch
node_fast -->|"renders"| node_mode_switch
node_doubt -->|"renders"| node_mode_switch
node_teachback -->|"renders"| node_mode_switch
node_learn -->|"renders"| node_subject
node_doubt -->|"renders"| node_subject
node_teachback -->|"renders"| node_subject
node_learner -.->|"opens"| node_auth_ui
node_auth_ui -->|"renders"| node_register
node_auth_ui -->|"renders"| node_login
node_auth_ui -->|"updates"| node_auth_state
node_register -.->|"registers via"| node_auth_routes
node_login -.->|"logs in via"| node_auth_routes
node_auth_routes -->|"reads/writes"| node_user_store
node_auth_routes -->|"sends links"| node_email
node_learner -->|"submits topic"| node_learn
node_learner -->|"requests summary"| node_fast
node_learner -->|"asks doubt"| node_doubt
node_learner -->|"explains concept"| node_teachback
node_learn -.->|"requests answer"| node_ai_route
node_fast -.->|"requests answer"| node_ai_route
node_doubt -.->|"requests answer"| node_ai_route
node_teachback -.->|"requests evaluation"| node_ai_route
node_ai_route -->|"calls"| node_ai_service
node_ai_route -->|"applies"| node_limiter
node_ai_service -->|"loads prompt"| node_prompts
node_ai_service -->|"selects models"| node_models_select
node_ai_service -->|"calls with fallback"| node_provider
node_api -->|"mounts"| node_ai_route
node_api -->|"applies globally"| node_limiter
node_learner -.->|"logs activity"| node_question_route
node_api -->|"mounts"| node_question_route
node_question_route -->|"checks user"| node_user_store
node_question_route -->|"writes questions"| node_questions_store
node_question_route -->|"writes explanations"| node_explanations_store
node_question_route -->|"updates count"| node_user_store
node_user_store -.->|"persists in"| node_db
node_questions_store -.->|"persists in"| node_db
node_explanations_store -.->|"persists in"| node_db

click node_app "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/Home.jsx"
click node_mode_switch "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/components/ModeSwitchCTA.jsx"
click node_learn "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/LearnMode.jsx"
click node_fast "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/FastLearnMode.jsx"
click node_doubt "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/DoubtMode.jsx"
click node_teachback "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/TeachBackMode.jsx"
click node_subject "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/components/SubjectInput.jsx"
click node_docs "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/Docs.jsx"
click node_auth_ui "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/AuthPage.jsx"
click node_register "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/components/RegisterForm.jsx"
click node_login "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/components/LoginForm.jsx"
click node_auth_state "https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/context/AuthContext.jsx"
click node_auth_routes "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/routes/auth.js"
click node_email "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/utils/sendEmail.js"
click node_ai_route "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/routes/ai.js"
click node_ai_service "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/services/aiService.js"
click node_prompts "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/config/prompts.js"
click node_models_select "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/config/modelSelector.js"
click node_api "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/app.js"
click node_user_store "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/models/User.js"
click node_question_route "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/routes/question.js"
click node_questions_store "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/models/UserQuestions.js"
click node_explanations_store "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/models/UserExplanations.js"
click node_question_log "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/models/QuestionLog.js"
click node_limiter "https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/middleware/rateLimiter.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_home,node_mode_switch,node_learn,node_fast,node_doubt,node_teachback,node_subject,node_docs toneBlue
class node_auth_ui,node_register,node_login,node_auth_state,node_auth_routes,node_email,node_db toneAmber
class node_ai_route,node_ai_service,node_prompts,node_models_select,node_api,node_limiter toneMint
class node_user_store,node_question_route,node_questions_store,node_explanations_store,node_question_log toneRose
class node_learner,node_provider toneIndigo
```

## Components

### Learning experience

- [App routing](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Home entry](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/Home.jsx): `frontend/src/Pages/Home.jsx`
- [Mode navigation](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/components/ModeSwitchCTA.jsx): `frontend/src/components/ModeSwitchCTA.jsx`
- [Learn mode](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/LearnMode.jsx): `frontend/src/Pages/LearnMode.jsx`
- [Fast Learn](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/FastLearnMode.jsx): `frontend/src/Pages/FastLearnMode.jsx`
- [Doubt mode](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/DoubtMode.jsx): `frontend/src/Pages/DoubtMode.jsx`
- [Teach-Back](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/TeachBackMode.jsx): `frontend/src/Pages/TeachBackMode.jsx`
- [Subject context](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/components/SubjectInput.jsx): `frontend/src/components/SubjectInput.jsx`
- [Mode guidance](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/Docs.jsx): `frontend/src/Pages/Docs.jsx`

### Identity and activity

- [Auth screen](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/Pages/AuthPage.jsx): `frontend/src/Pages/AuthPage.jsx`
- [Registration form](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/components/RegisterForm.jsx): `frontend/src/components/RegisterForm.jsx`
- [Login form](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/components/LoginForm.jsx): `frontend/src/components/LoginForm.jsx`
- [Auth state](https://github.com/lingarobotics/lgc-concept-ai/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Auth endpoints](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Email delivery](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/utils/sendEmail.js): `backend/utils/sendEmail.js`

### AI orchestration

- [AI endpoint](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/routes/ai.js): `backend/routes/ai.js`
- [AI service](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/services/aiService.js): `backend/services/aiService.js`
- [Mode prompts](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/config/prompts.js): `backend/config/prompts.js`
- [Model selection](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/config/modelSelector.js): `backend/config/modelSelector.js`
- [Express routing](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/app.js): `backend/app.js`
- [Request limits](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/middleware/rateLimiter.js): `backend/middleware/rateLimiter.js`

### Persistence

- [User records](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/models/User.js): `backend/models/User.js`
- [Activity logging](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/routes/question.js): `backend/routes/question.js`
- [Question history](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/models/UserQuestions.js): `backend/models/UserQuestions.js`
- [Explanation history](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/models/UserExplanations.js): `backend/models/UserExplanations.js`
- [Question log](https://github.com/lingarobotics/lgc-concept-ai/blob/main/backend/models/QuestionLog.js): `backend/models/QuestionLog.js`

### Other components

- **Student**
- **Model providers**
- **MongoDB**

## Connections

- Student → App routing: uses (evidence: `frontend/src/App.jsx`)
- App routing → Home entry: routes to (evidence: `frontend/src/App.jsx`)
- Home entry → Learn mode: launches (evidence: `frontend/src/App.jsx`)
- App routing → Learn mode: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Fast Learn: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Doubt mode: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Teach-Back: routes to (evidence: `frontend/src/App.jsx`)
- Learn mode → Mode navigation: renders (evidence: `frontend/src/Pages/LearnMode.jsx`)
- Fast Learn → Mode navigation: renders (evidence: `frontend/src/Pages/FastLearnMode.jsx`)
- Doubt mode → Mode navigation: renders (evidence: `frontend/src/Pages/DoubtMode.jsx`)
- Teach-Back → Mode navigation: renders (evidence: `frontend/src/Pages/TeachBackMode.jsx`)
- Learn mode → Subject context: renders (evidence: `frontend/src/Pages/LearnMode.jsx`)
- Doubt mode → Subject context: renders (evidence: `frontend/src/Pages/DoubtMode.jsx`)
- Teach-Back → Subject context: renders (evidence: `frontend/src/Pages/TeachBackMode.jsx`)
- Student → Auth screen: opens
- Auth screen → Registration form: renders (evidence: `frontend/src/Pages/AuthPage.jsx`)
- Auth screen → Login form: renders (evidence: `frontend/src/Pages/AuthPage.jsx`)
- Auth screen → Auth state: updates (evidence: `frontend/src/Pages/AuthPage.jsx`)
- Registration form → Auth endpoints: registers via
- Login form → Auth endpoints: logs in via
- Auth endpoints → User records: reads/writes (evidence: `backend/routes/auth.js`)
- Auth endpoints → Email delivery: sends links (evidence: `backend/routes/auth.js`)
- Student → Learn mode: submits topic (evidence: `README.md`)
- Student → Fast Learn: requests summary (evidence: `README.md`)
- Student → Doubt mode: asks doubt (evidence: `README.md`)
- Student → Teach-Back: explains concept (evidence: `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 (evidence: `backend/routes/ai.js`)
- AI endpoint → Request limits: applies (evidence: `backend/routes/ai.js`)
- AI service → Mode prompts: loads prompt (evidence: `backend/services/aiService.js`)
- AI service → Model selection: selects models (evidence: `backend/services/aiService.js`)
- AI service → Model providers: calls with fallback (evidence: `backend/services/aiService.js`)
- Express routing → AI endpoint: mounts (evidence: `backend/app.js`)
- Express routing → Request limits: applies globally (evidence: `backend/app.js`)
- Student → Activity logging: logs activity
- Express routing → Activity logging: mounts (evidence: `backend/app.js`)
- Activity logging → User records: checks user (evidence: `backend/routes/question.js`)
- Activity logging → Question history: writes questions (evidence: `backend/routes/question.js`)
- Activity logging → Explanation history: writes explanations (evidence: `backend/routes/question.js`)
- Activity logging → User records: updates count (evidence: `backend/routes/question.js`)
- User records → MongoDB: persists in
- Question history → MongoDB: persists in
- Explanation history → MongoDB: persists in
