How ngothitho2021-byte/ngo_thi_tho_cong_nghe_phan_mem_24ct2_learn-english-web works
Học Từ Đầu is an English-learning website whose main learner workflow is choosing a skill and lesson, then practicing vocabulary, listening, speaking, or writing. Speaking uses browser speech recognition and AI feedback; writing receives AI feedback through the backend. The backend also handles registration, login, profile lookup, and level updates. The README documents the frontend-to-API workflows; sampled backend source confirms routing, authentication, persistence, and AI calls. Lesson-page wiring was not sampled, so frontend relationships are based on README descriptions rather than inspected page code.
Main entry points: auth.py Account endpoints · main.py FastAPI application · database.py Database sessions · ai.py AI endpoints
Components 26
Learning experience
- Home page
index.html - Vocabulary lessons
pages/tu-vung.html - Vocabulary practice
pages/tu-vung-bai-hoc.html - Vocabulary interactions
assets/js/tu-vung-bai-hoc.js - Listening lessons
pages/nghe.html - Listening practice
pages/nghe-bai-hoc.html - Listening interactions
assets/js/nghe-bai-hoc.js - Speaking lessons
pages/noi.html - Speaking practice
pages/noi-bai-hoc.html - Speech and answers
assets/js/noi-bai-hoc.js - Writing lessons
pages/viet.html - Writing practice
pages/viet-bai-hoc.html - Writing interactions
assets/js/viet-bai-hoc.js
Account frontend
- Login and signup
login.html - Auth and token client
assets/js/auth.js
API services
- FastAPI application
backend/main.py - Account endpoints
backend/routes/auth.py - Account schemas
backend/schemas.py
Identity and storage
- Password and JWT
backend/security.py - User model
backend/models.py - Database sessions
backend/database.py - SQLite database
AI feedback
- AI endpoints
backend/routes/ai.py
Other components
- Learner
- Web Speech API
- Groq AI service
Connections 28
- Learner → Home page: opens
README.md - Learner → Vocabulary lessons: chooses vocabulary
README.md - Learner → Listening lessons: chooses listening
README.md - Learner → Speaking lessons: chooses speaking
README.md - Learner → Writing lessons: chooses writing
README.md - Vocabulary lessons → Vocabulary practice: opens lesson
README.md - Vocabulary practice → Vocabulary interactions: uses interactions
README.md - Listening lessons → Listening practice: opens lesson
README.md - Listening practice → Listening interactions: uses interactions
README.md - Speaking lessons → Speaking practice: opens lesson
README.md - Speaking practice → Speech and answers: uses interactions
README.md - Speech and answers → Web Speech API: recognizes speech
README.md - Writing lessons → Writing practice: opens lesson
README.md - Writing practice → Writing interactions: uses interactions
README.md - Login and signup → Auth and token client: submits credentials
README.md - Auth and token client → FastAPI application: sends REST requests
README.md - Speech and answers → AI endpoints: sends answer
README.md - Writing interactions → AI endpoints: sends writing
README.md - FastAPI application → Account endpoints: registers router
backend/main.py - FastAPI application → AI endpoints: registers router
backend/main.py - FastAPI application → Database sessions: creates tables
backend/main.py - Account endpoints → Account schemas: validates and returns
backend/routes/auth.py - Account endpoints → Password and JWT: hashes and verifies
backend/routes/auth.py - Account endpoints → User model: queries and updates
backend/routes/auth.py - Account endpoints → Database sessions: opens sessions
backend/routes/auth.py - User model → Database sessions: uses Base
backend/models.py - Database sessions → SQLite database: connects to
backend/database.py - AI endpoints → Groq AI service: calls API
backend/routes/ai.py