# ojas2005/eduquiz architecture

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

- Interactive diagram: https://gitdiagram.com/ojas2005/eduquiz
- Repository: https://github.com/ojas2005/eduquiz

## Overview

EduQuiz is an adaptive-learning app: learners choose a topic, study missions, submit quizzes, review skill feedback, optionally take focused remediation, and track progress. The React app coordinates pages and API requests; FastAPI owns the domain operations, with learning generation, authentication, and persistence behind it. The README documents reports, practice, account/model settings, and administration as additional product branches. Some backend route details and storage wiring were not excerpted, so uncertain connections are omitted; optional model-provider integration is marked dashed.

Main entry points: [`frontend/src/main.tsx`](https://github.com/ojas2005/eduquiz/blob/main/frontend/src/main.tsx) (App coordinator), [`backend/app/main.py`](https://github.com/ojas2005/eduquiz/blob/main/backend/app/main.py) (HTTP API), [`frontend/src/api.ts`](https://github.com/ojas2005/eduquiz/blob/main/frontend/src/api.ts) (API client), [`backend/app/learning.py`](https://github.com/ojas2005/eduquiz/blob/main/backend/app/learning.py) (Mission generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Learner app"]
  node_app["App coordinator<br/>[main.tsx]"]
  node_api["API client<br/>[api.ts]"]
  node_dashboard["Learning desk<br/>[Dashboard.tsx]"]
  node_mission_ui["Mission and quiz<br/>[Mission.tsx]"]
  node_reports_ui["Growth report<br/>[Reports.tsx]"]
  node_settings_ui["Account settings<br/>[Settings.tsx]"]
  node_admin_ui["Admin console<br/>[Admin.tsx]"]
end

subgraph group_learning["Learning workflow"]
  node_backend["HTTP API<br/>[main.py]"]
  node_generator["Mission generation<br/>[learning.py]"]
end

subgraph group_account["Accounts and operations"]
  node_auth["Authentication and policy<br/>[security.py]"]
end

subgraph group_state["Persistence and services"]
  node_models["Domain records<br/>[models.py]"]
  node_postgres[("PostgreSQL")]
  node_redis[("Rate-limit store")]
  node_blob[("Blob storage")]
end

node_learner(("Learner"))
node_provider["OpenAI / Anthropic"]

node_learner -->|"uses"| node_app
node_app -->|"requests through"| node_api
node_app -->|"renders"| node_dashboard
node_app -->|"renders"| node_mission_ui
node_app -->|"renders"| node_reports_ui
node_app -->|"renders"| node_settings_ui
node_app -->|"renders"| node_admin_ui
node_api -->|"sends HTTP requests"| node_backend
node_backend -->|"uses auth controls"| node_auth
node_backend -->|"queries and updates"| node_models
node_backend -->|"generates missions"| node_generator
node_models -->|"persists records"| node_postgres
node_auth -->|"rate limits via"| node_redis
node_generator -.->|"uses model"| node_provider
node_backend -.->|"uses storage"| node_blob

click node_app "https://github.com/ojas2005/eduquiz/blob/main/frontend/src/main.tsx"
click node_api "https://github.com/ojas2005/eduquiz/blob/main/frontend/src/api.ts"
click node_dashboard "https://github.com/ojas2005/eduquiz/blob/main/frontend/src/pages/Dashboard.tsx"
click node_mission_ui "https://github.com/ojas2005/eduquiz/blob/main/frontend/src/pages/Mission.tsx"
click node_reports_ui "https://github.com/ojas2005/eduquiz/blob/main/frontend/src/pages/Reports.tsx"
click node_settings_ui "https://github.com/ojas2005/eduquiz/blob/main/frontend/src/pages/Settings.tsx"
click node_admin_ui "https://github.com/ojas2005/eduquiz/blob/main/frontend/src/pages/Admin.tsx"
click node_backend "https://github.com/ojas2005/eduquiz/blob/main/backend/app/main.py"
click node_generator "https://github.com/ojas2005/eduquiz/blob/main/backend/app/learning.py"
click node_auth "https://github.com/ojas2005/eduquiz/blob/main/backend/app/security.py"
click node_models "https://github.com/ojas2005/eduquiz/blob/main/backend/app/models.py"

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_api,node_dashboard,node_mission_ui,node_reports_ui,node_settings_ui,node_admin_ui toneBlue
class node_backend,node_generator toneAmber
class node_auth toneMint
class node_models,node_postgres,node_redis,node_blob toneRose
class node_learner,node_provider toneIndigo
```

## Components

### Learner app

- [App coordinator](https://github.com/ojas2005/eduquiz/blob/main/frontend/src/main.tsx): `frontend/src/main.tsx`
- [API client](https://github.com/ojas2005/eduquiz/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [Learning desk](https://github.com/ojas2005/eduquiz/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [Mission and quiz](https://github.com/ojas2005/eduquiz/blob/main/frontend/src/pages/Mission.tsx): `frontend/src/pages/Mission.tsx`
- [Growth report](https://github.com/ojas2005/eduquiz/blob/main/frontend/src/pages/Reports.tsx): `frontend/src/pages/Reports.tsx`
- [Account settings](https://github.com/ojas2005/eduquiz/blob/main/frontend/src/pages/Settings.tsx): `frontend/src/pages/Settings.tsx`
- [Admin console](https://github.com/ojas2005/eduquiz/blob/main/frontend/src/pages/Admin.tsx): `frontend/src/pages/Admin.tsx`

### Learning workflow

- [HTTP API](https://github.com/ojas2005/eduquiz/blob/main/backend/app/main.py): `backend/app/main.py`
- [Mission generation](https://github.com/ojas2005/eduquiz/blob/main/backend/app/learning.py): `backend/app/learning.py`

### Accounts and operations

- [Authentication and policy](https://github.com/ojas2005/eduquiz/blob/main/backend/app/security.py): `backend/app/security.py`

### Persistence and services

- [Domain records](https://github.com/ojas2005/eduquiz/blob/main/backend/app/models.py): `backend/app/models.py`
- **PostgreSQL**
- **Rate-limit store**
- **Blob storage**

### Other components

- **Learner**
- **OpenAI / Anthropic**

## Connections

- Learner → App coordinator: uses (evidence: `README.md`)
- App coordinator → API client: requests through (evidence: `frontend/src/main.tsx`)
- App coordinator → Learning desk: renders (evidence: `frontend/src/main.tsx`)
- App coordinator → Mission and quiz: renders (evidence: `frontend/src/main.tsx`)
- App coordinator → Growth report: renders (evidence: `frontend/src/main.tsx`)
- App coordinator → Account settings: renders (evidence: `frontend/src/main.tsx`)
- App coordinator → Admin console: renders (evidence: `frontend/src/main.tsx`)
- API client → HTTP API: sends HTTP requests (evidence: `frontend/src/api.ts`)
- HTTP API → Authentication and policy: uses auth controls (evidence: `backend/app/main.py`)
- HTTP API → Domain records: queries and updates (evidence: `backend/app/main.py`)
- HTTP API → Mission generation: generates missions (evidence: `backend/app/main.py`)
- Domain records → PostgreSQL: persists records (evidence: `backend/app/models.py`)
- Authentication and policy → Rate-limit store: rate limits via (evidence: `backend/app/security.py`)
- Mission generation → OpenAI / Anthropic: uses model (evidence: `README.md`)
- HTTP API → Blob storage: uses storage
