How nishantdasari-hub/speakforge works
SpeakForge is a learner assessment and administration platform. Learners register and verify accounts, take text or audio tests, then review scored answers, reports, and progress; administrators manage tests/questions and inspect analytics. The frontend routes users to these experiences and calls a FastAPI backend, which handles authentication, assessment, and persistence. The README documents the evaluation stages, but the test routes and scoring implementation were not excerpted, so their internal call sequence is not asserted here.
Main entry points: App.jsx Route application · ai_scoring.py AI scoring · main.py FastAPI application · api.js API client
Components 21
Web application
- Route application
frontend/src/App.jsx - Account pages
frontend/src/pages/Login.jsx - Test-taking pages
frontend/src/pages/TestDetail.jsx - Reports and progress
frontend/src/pages/TestReport.jsx - Admin pages
frontend/src/pages/AdminQuestions.jsx - API client
frontend/src/api.js
Backend workflows
- FastAPI application
backend/app/main.py - Authentication routes
backend/app/routes/auth.py - Test routes
backend/app/routes/test.py - Report routes
backend/app/routes/report.py - Auth service
backend/app/services/auth_service.py - Test service
backend/app/services/test_service.py
Assessment evaluation
- AI scoring
backend/app/services/ai_scoring.py - Audio transcription
backend/app/services/ai_scoring.py - Grammar analysis
backend/app/services/ai_scoring.py
Persistence and services
- Database session
backend/app/database.py - Assessment records
backend/app/models.py - Email delivery
backend/app/utils/email.py
Other components
- Learner
- Administrator
- Email service
Connections 29
- Learner → Route application: uses
frontend/src/App.jsx - Administrator → Route application: uses
frontend/src/App.jsx - Route application → Account pages: routes to
frontend/src/App.jsx - Route application → Test-taking pages: routes to
frontend/src/App.jsx - Route application → Reports and progress: routes to
frontend/src/App.jsx - Route application → Admin pages: routes to
frontend/src/App.jsx - Account pages → API client: authenticates via
- Test-taking pages → API client: requests tests
- Reports and progress → API client: loads results
frontend/src/api.js - Admin pages → FastAPI application: manages questions
frontend/src/pages/AdminQuestions.jsx - API client → FastAPI application: calls API
frontend/src/api.js - FastAPI application → Authentication routes: mounts
backend/app/main.py - FastAPI application → Test routes: mounts
backend/app/main.py - FastAPI application → Report routes: mounts
backend/app/main.py - Authentication routes → Auth service: delegates to
backend/app/routes/auth.py - Authentication routes → Email delivery: sends messages
backend/app/routes/auth.py - Email delivery → Email service: delivers through
backend/app/utils/email.py - Auth service → Database session: opens sessions
backend/app/services/auth_service.py - Auth service → Assessment records: queries users
backend/app/services/auth_service.py - Test routes → Test service: delegates to
- Test service → AI scoring: evaluates responses
- AI scoring → Audio transcription: transcribes audio
README.md - Audio transcription → Grammar analysis: passes transcript
README.md - AI scoring → Grammar analysis: analyzes text
README.md - AI scoring → Database session: uses persistence
backend/app/services/ai_scoring.py - AI scoring → Assessment records: records evaluations
backend/app/services/ai_scoring.py - Report routes → Database session: loads reports
backend/app/routes/report.py - Report routes → Assessment records: reads results
backend/app/routes/report.py - Database session → Assessment records: maps records
backend/app/models.py