# iharinisri/eduseal1 architecture

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

- Interactive diagram: https://gitdiagram.com/iharinisri/eduseal1
- Repository: https://github.com/iharinisri/eduseal1

## Overview

Eduseal Tutor supports JEE/NEET exam practice and doubt answering. Learners sign in, choose a test, answer timed questions, submit for evaluation, and can view summaries and progress; a separate authenticated workflow sends doubts to an AI service. The frontend uses Firebase services for identity and user data, while the backend exposes authenticated question and AI routes. The excerpts establish route orchestration and question evaluation, but do not show all frontend navigation, persistence, or external-service calls, so those connections are limited or omitted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/App.jsx) (App routes), [`frontend/src/pages/TestPage.jsx`](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/TestPage.jsx) (Timed test), [`frontend/src/firebase.js`](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/firebase.js) (Firebase client), [`backend/src/routes/aiRoutes.js`](https://github.com/iharinisri/eduseal1/blob/main/backend/src/routes/aiRoutes.js) (AI route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Learner app"]
  node_app["App routes<br/>[App.jsx]"]
  node_navbar["User navigation<br/>[Navbar.jsx]"]
  node_doubt_page["Ask a doubt<br/>[AskDoubt.jsx]"]
  node_toast["Toast feedback<br/>[ToastContext.jsx]"]
end

subgraph group_identity["Identity and profiles"]
  node_login["Sign in<br/>[Login.jsx]"]
  node_signup["Sign up<br/>[Signup.jsx]"]
  node_firebase_client["Firebase client<br/>[firebase.js]"]
  node_profile["Profile settings<br/>[SettingsModal.jsx]"]
  node_protected["Route guard<br/>[ProtectedRoute.jsx]"]
end

subgraph group_practice["Test practice"]
  node_take_test["Test setup<br/>[TakeTest.jsx]"]
  node_test_page["Timed test<br/>[TestPage.jsx]"]
  node_question_bank["Question bank<br/>[questionBank.js]"]
  node_question_card["Question display<br/>[QuestionCard.jsx]"]
  node_question_navigator["Question navigator"]
  node_confirm_modal["Confirmation modal<br/>[ConfirmModal.jsx]"]
  node_summary["Test summary<br/>[TestSummary.jsx]"]
  node_progress["Progress view<br/>[Progress.jsx]"]
end

subgraph group_backend["API backend"]
  node_api_client["API client<br/>[api.js]"]
  node_backend_server["HTTP server<br/>[server.js]"]
  node_question_routes["Question routes<br/>[questionRoutes.js]"]
  node_ai_routes["AI route<br/>[aiRoutes.js]"]
  node_auth_middleware["Token verification<br/>[requireAuth.js]"]
end

subgraph group_services["Backend services"]
  node_firebase_admin["Firebase Admin<br/>[firebaseAdmin.js]"]
  node_question_service["Question operations<br/>[questionService.js]"]
  node_database_config["SQL connection<br/>[database.js]"]
  node_ai_service["AI generation<br/>[groqService.js]"]
  node_usage_service["AI usage limits<br/>[usageService.js]"]
end

node_learner(("Learner"))
node_mysql[("MySQL")]

node_learner -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_signup
node_app -->|"routes to"| node_take_test
node_app -->|"routes to"| node_test_page
node_app -->|"routes to"| node_summary
node_app -->|"routes to"| node_progress
node_app -->|"routes to"| node_doubt_page
node_app -->|"guards pages"| node_protected
node_login -->|"uses"| node_firebase_client
node_signup -->|"uses"| node_firebase_client
node_protected -->|"checks session"| node_firebase_client
node_navbar -->|"reads profile"| node_firebase_client
node_navbar -->|"opens"| node_profile
node_take_test -->|"renders"| node_navbar
node_test_page -->|"uses fallback"| node_question_bank
node_test_page -->|"renders"| node_question_card
node_test_page -->|"renders"| node_question_navigator
node_test_page -->|"renders"| node_confirm_modal
node_test_page -->|"requests evaluation"| node_api_client
node_test_page -->|"saves results"| node_firebase_client
node_test_page -->|"shows feedback"| node_toast
node_backend_server -->|"mounts"| node_question_routes
node_backend_server -->|"mounts"| node_ai_routes
node_question_routes -->|"requires auth"| node_auth_middleware
node_question_routes -->|"delegates"| node_question_service
node_ai_routes -->|"requires auth"| node_auth_middleware
node_ai_routes -->|"requests answer"| node_ai_service
node_ai_routes -->|"checks quota"| node_usage_service
node_auth_middleware -->|"verifies tokens"| node_firebase_admin
node_question_service -->|"queries"| node_database_config
node_database_config -->|"executes SQL"| node_mysql

click node_app "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/App.jsx"
click node_login "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/Login.jsx"
click node_signup "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/Signup.jsx"
click node_firebase_client "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/firebase.js"
click node_profile "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/components/SettingsModal.jsx"
click node_navbar "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/components/Navbar.jsx"
click node_protected "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/components/ProtectedRoute.jsx"
click node_take_test "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/TakeTest.jsx"
click node_test_page "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/TestPage.jsx"
click node_question_bank "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/data/questionBank.js"
click node_question_card "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/components/QuestionCard.jsx"
click node_question_navigator "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/components/QuestionNavigator.jsx"
click node_confirm_modal "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/components/ConfirmModal.jsx"
click node_api_client "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/services/api.js"
click node_summary "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/TestSummary.jsx"
click node_progress "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/Progress.jsx"
click node_doubt_page "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/AskDoubt.jsx"
click node_backend_server "https://github.com/iharinisri/eduseal1/blob/main/backend/src/server.js"
click node_question_routes "https://github.com/iharinisri/eduseal1/blob/main/backend/src/routes/questionRoutes.js"
click node_ai_routes "https://github.com/iharinisri/eduseal1/blob/main/backend/src/routes/aiRoutes.js"
click node_auth_middleware "https://github.com/iharinisri/eduseal1/blob/main/backend/src/middleware/requireAuth.js"
click node_firebase_admin "https://github.com/iharinisri/eduseal1/blob/main/backend/src/config/firebaseAdmin.js"
click node_question_service "https://github.com/iharinisri/eduseal1/blob/main/backend/src/services/questionService.js"
click node_database_config "https://github.com/iharinisri/eduseal1/blob/main/backend/src/config/database.js"
click node_ai_service "https://github.com/iharinisri/eduseal1/blob/main/backend/src/services/groqService.js"
click node_usage_service "https://github.com/iharinisri/eduseal1/blob/main/backend/src/services/usageService.js"
click node_toast "https://github.com/iharinisri/eduseal1/blob/main/frontend/src/context/ToastContext.jsx"

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_navbar,node_doubt_page,node_toast toneBlue
class node_login,node_signup,node_firebase_client,node_profile,node_protected,node_mysql toneAmber
class node_take_test,node_test_page,node_question_bank,node_question_card,node_question_navigator,node_confirm_modal,node_summary,node_progress toneMint
class node_api_client,node_backend_server,node_question_routes,node_ai_routes,node_auth_middleware toneRose
class node_firebase_admin,node_question_service,node_database_config,node_ai_service,node_usage_service,node_learner toneIndigo
```

## Components

### Learner app

- [App routes](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [User navigation](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/components/Navbar.jsx): `frontend/src/components/Navbar.jsx`
- [Ask a doubt](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/AskDoubt.jsx): `frontend/src/pages/AskDoubt.jsx`
- [Toast feedback](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/context/ToastContext.jsx): `frontend/src/context/ToastContext.jsx`

### Identity and profiles

- [Sign in](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Sign up](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/Signup.jsx): `frontend/src/pages/Signup.jsx`
- [Firebase client](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/firebase.js): `frontend/src/firebase.js`
- [Profile settings](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/components/SettingsModal.jsx): `frontend/src/components/SettingsModal.jsx`
- [Route guard](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/components/ProtectedRoute.jsx): `frontend/src/components/ProtectedRoute.jsx`

### Test practice

- [Test setup](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/TakeTest.jsx): `frontend/src/pages/TakeTest.jsx`
- [Timed test](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/TestPage.jsx): `frontend/src/pages/TestPage.jsx`
- [Question bank](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/data/questionBank.js): `frontend/src/data/questionBank.js`
- [Question display](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/components/QuestionCard.jsx): `frontend/src/components/QuestionCard.jsx`
- [Question navigator](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/components/QuestionNavigator.jsx): `frontend/src/components/QuestionNavigator.jsx`
- [Confirmation modal](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/components/ConfirmModal.jsx): `frontend/src/components/ConfirmModal.jsx`
- [Test summary](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/TestSummary.jsx): `frontend/src/pages/TestSummary.jsx`
- [Progress view](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/pages/Progress.jsx): `frontend/src/pages/Progress.jsx`

### API backend

- [API client](https://github.com/iharinisri/eduseal1/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [HTTP server](https://github.com/iharinisri/eduseal1/blob/main/backend/src/server.js): `backend/src/server.js`
- [Question routes](https://github.com/iharinisri/eduseal1/blob/main/backend/src/routes/questionRoutes.js): `backend/src/routes/questionRoutes.js`
- [AI route](https://github.com/iharinisri/eduseal1/blob/main/backend/src/routes/aiRoutes.js): `backend/src/routes/aiRoutes.js`
- [Token verification](https://github.com/iharinisri/eduseal1/blob/main/backend/src/middleware/requireAuth.js): `backend/src/middleware/requireAuth.js`

### Backend services

- [Firebase Admin](https://github.com/iharinisri/eduseal1/blob/main/backend/src/config/firebaseAdmin.js): `backend/src/config/firebaseAdmin.js`
- [Question operations](https://github.com/iharinisri/eduseal1/blob/main/backend/src/services/questionService.js): `backend/src/services/questionService.js`
- [SQL connection](https://github.com/iharinisri/eduseal1/blob/main/backend/src/config/database.js): `backend/src/config/database.js`
- [AI generation](https://github.com/iharinisri/eduseal1/blob/main/backend/src/services/groqService.js): `backend/src/services/groqService.js`
- [AI usage limits](https://github.com/iharinisri/eduseal1/blob/main/backend/src/services/usageService.js): `backend/src/services/usageService.js`

### Other components

- **Learner**
- **MySQL**

## Connections

- Learner → App routes: uses (evidence: `frontend/src/App.jsx`)
- App routes → Sign in: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Sign up: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Test setup: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Timed test: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Test summary: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Progress view: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Ask a doubt: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Route guard: guards pages (evidence: `frontend/src/App.jsx`)
- Sign in → Firebase client: uses (evidence: `frontend/src/pages/Login.jsx`)
- Sign up → Firebase client: uses (evidence: `frontend/src/pages/Signup.jsx`)
- Route guard → Firebase client: checks session (evidence: `frontend/src/components/ProtectedRoute.jsx`)
- User navigation → Firebase client: reads profile (evidence: `frontend/src/components/Navbar.jsx`)
- User navigation → Profile settings: opens (evidence: `frontend/src/components/Navbar.jsx`)
- Test setup → User navigation: renders (evidence: `frontend/src/pages/TakeTest.jsx`)
- Timed test → Question bank: uses fallback (evidence: `frontend/src/pages/TestPage.jsx`)
- Timed test → Question display: renders (evidence: `frontend/src/pages/TestPage.jsx`)
- Timed test → Question navigator: renders (evidence: `frontend/src/pages/TestPage.jsx`)
- Timed test → Confirmation modal: renders (evidence: `frontend/src/pages/TestPage.jsx`)
- Timed test → API client: requests evaluation (evidence: `frontend/src/pages/TestPage.jsx`)
- Timed test → Firebase client: saves results (evidence: `frontend/src/pages/TestPage.jsx`)
- Timed test → Toast feedback: shows feedback (evidence: `frontend/src/pages/TestPage.jsx`)
- HTTP server → Question routes: mounts (evidence: `backend/src/server.js`)
- HTTP server → AI route: mounts (evidence: `backend/src/server.js`)
- Question routes → Token verification: requires auth (evidence: `backend/src/routes/questionRoutes.js`)
- Question routes → Question operations: delegates (evidence: `backend/src/routes/questionRoutes.js`)
- AI route → Token verification: requires auth (evidence: `backend/src/routes/aiRoutes.js`)
- AI route → AI generation: requests answer (evidence: `backend/src/routes/aiRoutes.js`)
- AI route → AI usage limits: checks quota (evidence: `backend/src/routes/aiRoutes.js`)
- Token verification → Firebase Admin: verifies tokens (evidence: `backend/src/middleware/requireAuth.js`)
- Question operations → SQL connection: queries (evidence: `backend/src/services/questionService.js`)
- SQL connection → MySQL: executes SQL (evidence: `backend/src/config/database.js`)
