How goldmangrey/aluaielts works
Alua is a language-learning product with iOS and web clients backed by a FastAPI service. The principal learner flow is to use a client to access learning activities, submit practice or review outcomes, and consult plans and progress; the backend exposes distinct curriculum, exercise, vocabulary-review, reading, listening, and writing capabilities. Planning and progress aggregation form a useful internal layer. The source index confirms API router registration and several module dependencies; client-to-server and many unsampled module interactions are shown only as unverified links, not inspected call chains.
Main entry points: api.py API router · engine.py Progress aggregation · page.tsx Web learning app · main.py FastAPI application
Components 23
Learner clients
- iOS app
frontend/Alua/App/AluaApp.swift - iOS API client
frontend/Alua/Core/Networking/APIClient.swift - Web learning app
web/src/app/page.tsx - Web API proxy
web/src/app/api/alua/[...path]/route.ts
API platform
- FastAPI application
backend/app/main.py - API router
backend/app/api.py - Authentication
backend/app/core/auth.py - Device enrollment
backend/app/modules/enrollment - Database models
backend/app/db/models.py
Learning content
- Curriculum
backend/app/modules/curriculum - Grammar lessons
backend/app/modules/grammar - Vocabulary review
backend/app/modules/vocabulary_review/service.py - Study content
backend/app/modules/study/service.py
Practice and assessment
- Exercises
backend/app/modules/exercises/service.py - Reading exams
backend/app/modules/reading/service.py - Listening practice
backend/app/modules/listening - Writing assessment
backend/app/modules/writing/router.py - AI review routes
web/src/app/api/reading/explain/route.ts
Planning and progress
- Learning events
backend/app/modules/learning_events - Daily planning
backend/app/modules/daily_plan/engine.py - Mastery tracking
backend/app/modules/mastery/engine.py - Progress aggregation
backend/app/modules/progress/engine.py
Other components
- Learner
Connections 27
- Learner → iOS app: uses
- Learner → Web learning app: uses
- iOS app → iOS API client: requests through
- iOS API client → FastAPI application: sends API requests
- Web learning app → Web API proxy: uses routes
- Web API proxy → FastAPI application: forwards requests
- FastAPI application → API router: includes
backend/app/main.py - API router → Curriculum: registers routes
backend/app/api.py - API router → Grammar lessons: registers routes
backend/app/api.py - API router → Vocabulary review: registers routes
- API router → Study content: registers routes
- API router → Exercises: registers routes
backend/app/api.py - API router → Reading exams: registers routes
backend/app/api.py - API router → Listening practice: registers routes
backend/app/api.py - API router → Writing assessment: registers routes
backend/app/api.py - API router → Device enrollment: registers routes
backend/app/api.py - API router → Authentication: uses
- Vocabulary review → Database models: uses persistence
- Reading exams → Database models: uses persistence
- Daily planning → Progress aggregation: provides plan models
backend/app/modules/progress/engine.py - Learning events → Progress aggregation: provides event models
backend/app/modules/progress/engine.py - Mastery tracking → Progress aggregation: provides mastery models
backend/app/modules/progress/engine.py - API router → Learning events: registers routes
backend/app/api.py - API router → Daily planning: registers routes
backend/app/api.py - API router → Mastery tracking: registers routes
backend/app/api.py - API router → Progress aggregation: registers routes
backend/app/api.py - Web learning app → AI review routes: uses AI review