How 54m54m/tlahtolli works
Tlahtolli is a gamified web platform for learning Indigenous languages. The user journey runs from sign-in and language selection through levels, units, interactive lessons, and recorded progress; a quick-level assessment offers an alternate progression route. The Vue client communicates with a Spring Boot API, which applies course and progress rules and persists account and learning state. The README also describes achievements, energy, statistics, vocabulary support, and pronunciation. Some backend routes and frontend views were not sampled, so only documented or indexed relationships are shown; unsampled subsystem paths use exact enclosing directories.
Main entry points: controller Spring API · repository Learning repositories · App.vue App startup · LearningService.java Course content
Components 22
Web client
- App startup
f/src/App.vue - Session and language
f/src/stores/auth.js - API client
f/src/api/apiClient.js
Learning experience
- Course navigation
f/src/views - Interactive lessons
f/src/views/learn/LessonView.vue - Quick level
f/src/views/learn/QuickLevelView.vue - Vocabulary tools
f/src/views/glossary - Pronunciation
f/src/data/services/SpeechService.js
Backend services
- Course content
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/LearningService.java - Course access
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/CourseAccess.java - Progress rules
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/ProgressService.java - Achievements
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/AchievementService.java - Energy and stats
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service - User endpoints
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/controller/UserController.java - Google sign-in
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/GoogleAuthService.java - JWT tokens
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/security/TokenService.java - Spring API
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/controller
Accounts and state
- Learning repositories
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/repository - Account repository
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/repository/UserRepository.java - Course cache
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/config/CacheConfig.java - Relational database
Other components
- Learner
Connections 22
- Learner → App startup: uses
- App startup → Session and language: initializes
f/src/App.vue - App startup → API client: loads
f/src/App.vue - Session and language → API client: calls
f/src/stores/auth.js - Learner → Course navigation: selects language
- Course navigation → Interactive lessons: opens lessons
- Learner → Quick level: tests knowledge
- Learner → Vocabulary tools: explores vocabulary
- Vocabulary tools → Pronunciation: uses pronunciation
- API client → Spring API: sends requests
f/src/api/apiClient.js - Spring API → Course content: serves course data
- Spring API → Progress rules: records completion
- Spring API → Achievements: supports achievements
- User endpoints → Course access: checks language
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/controller/UserController.java - User endpoints → Account repository: delegates user work
- Course content → Learning repositories: reads course data
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/LearningService.java - Progress rules → Learning repositories: updates progress
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/ProgressService.java - Achievements → Learning repositories: reads and updates
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/AchievementService.java - Course content → Course cache: uses cache
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/LearningService.java - Learning repositories → Relational database: persists records
- Google sign-in → Account repository: finds and saves users
b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/GoogleAuthService.java - Google sign-in → JWT tokens: issues session