How ojas2005/eduquiz works
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: main.tsx App coordinator · main.py HTTP API · api.ts API client · learning.py Mission generation
Components 16
Learner app
- App coordinator
frontend/src/main.tsx - API client
frontend/src/api.ts - Learning desk
frontend/src/pages/Dashboard.tsx - Mission and quiz
frontend/src/pages/Mission.tsx - Growth report
frontend/src/pages/Reports.tsx - Account settings
frontend/src/pages/Settings.tsx - Admin console
frontend/src/pages/Admin.tsx
Learning workflow
- HTTP API
backend/app/main.py - Mission generation
backend/app/learning.py
Accounts and operations
- Authentication and policy
backend/app/security.py
Persistence and services
- Domain records
backend/app/models.py - PostgreSQL
- Rate-limit store
- Blob storage
Other components
- Learner
- OpenAI / Anthropic
Connections 15
- Learner → App coordinator: uses
README.md - App coordinator → API client: requests through
frontend/src/main.tsx - App coordinator → Learning desk: renders
frontend/src/main.tsx - App coordinator → Mission and quiz: renders
frontend/src/main.tsx - App coordinator → Growth report: renders
frontend/src/main.tsx - App coordinator → Account settings: renders
frontend/src/main.tsx - App coordinator → Admin console: renders
frontend/src/main.tsx - API client → HTTP API: sends HTTP requests
frontend/src/api.ts - HTTP API → Authentication and policy: uses auth controls
backend/app/main.py - HTTP API → Domain records: queries and updates
backend/app/main.py - HTTP API → Mission generation: generates missions
backend/app/main.py - Domain records → PostgreSQL: persists records
backend/app/models.py - Authentication and policy → Rate-limit store: rate limits via
backend/app/security.py - Mission generation → OpenAI / Anthropic: uses model
README.md - HTTP API → Blob storage: uses storage