How jopaferreira/pei-mta works
Musical Theory Trainer is a browser-based practice app: learners choose a training filter, request an interval, scale/mode, or key-signature exercise, answer it, and receive feedback and a theoretical explanation. Registered users can review per-topic and daily performance; guest use is also supported. The graph reflects documented API calls and sampled backend ownership. Frontend rendering/audio libraries and some dashboard behavior are described in the README or excerpts, but unsampled implementation details are not inferred.
Main entry points: app.js Practice interface · main.py Exercise API · models.py Attempt history · music_logic.py Interval generator
Components 20
Musical practice
- Practice interface
src/frontend/app.js - Exercise API
src/backend/main.py - Interval generator
src/backend/music_logic.py - Scale and mode generator
src/backend/music_logic.py - Key signature generator
src/backend/music_logic.py - Staff notation
src/frontend/app.js - Audio playback
src/frontend/app.js - Answer explanations
src/backend/music_logic.py
Accounts and progress
- Login and guest mode
src/frontend/app.js - Registration and login
src/backend/main.py - Attempt recording
src/backend/main.py - Metrics aggregation
src/backend/main.py - Progress dashboard
src/frontend/app.js - User profiles
src/backend/models.py - Attempt history
src/backend/models.py
Application platform
- FastAPI app
src/backend/main.py - Static frontend
src/backend/main.py
Other components
- Learner
- Browser
- SQLite
Connections 22
- Learner → Practice interface: uses
README.md - Practice interface → Registration and login: submits credentials
src/frontend/app.js - Registration and login → User profiles: reads and writes
src/backend/main.py - Practice interface → Exercise API: requests exercise
src/frontend/app.js - Exercise API → Interval generator: generates interval
src/backend/main.py - Exercise API → Scale and mode generator: generates scale
src/backend/main.py - Exercise API → Key signature generator: generates key
src/backend/main.py - Exercise API → Practice interface: returns exercise
src/frontend/app.js - Practice interface → Staff notation: renders staff
src/frontend/app.js - Practice interface → Audio playback: plays notes
src/frontend/app.js - Learner → Practice interface: answers
src/frontend/app.js - Practice interface → Answer explanations: shows feedback
README.md - Practice interface → Attempt recording: records attempt
src/frontend/app.js - Attempt recording → Attempt history: writes attempt
src/backend/main.py - Practice interface → Metrics aggregation: requests metrics
src/frontend/app.js - Metrics aggregation → Attempt history: reads history
src/backend/main.py - Practice interface → Progress dashboard: displays progress
README.md - Practice interface → FastAPI app: calls API
src/frontend/app.js - FastAPI app → Static frontend: serves frontend
src/backend/main.py - User profiles → SQLite: persists in
src/backend/models.py - Attempt history → SQLite: persists in
src/backend/models.py - Browser → Practice interface: loads
README.md