# 54m54m/tlahtolli architecture

> Architecture diagram of the GitHub repository 54m54m/tlahtolli, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/54m54m/tlahtolli
- Repository: https://github.com/54m54m/tlahtolli

## Overview

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: [`b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/controller`](https://github.com/54m54m/tlahtolli/tree/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/controller) (Spring API), [`b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/repository`](https://github.com/54m54m/tlahtolli/tree/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/repository) (Learning repositories), [`f/src/App.vue`](https://github.com/54m54m/tlahtolli/blob/v4/f/src/App.vue) (App startup), [`b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/LearningService.java`](https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/LearningService.java) (Course content)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App startup<br/>[App.vue]"]
  node_auth["Session and language<br/>[auth.js]"]
  node_clientapi["API client<br/>[apiClient.js]"]
end

subgraph group_learning["Learning experience"]
  node_courseviews["Course navigation"]
  node_lesson["Interactive lessons<br/>[LessonView.vue]"]
  node_quicklevel["Quick level<br/>[QuickLevelView.vue]"]
  node_glossary["Vocabulary tools"]
  node_speech["Pronunciation<br/>[SpeechService.js]"]
end

subgraph group_backend["Backend services"]
  node_learningapi["Course content"]
  node_courseaccess["Course access<br/>[CourseAccess.java]"]
  node_progress["Progress rules"]
  node_achievement["Achievements"]
  node_gamification["Energy and stats"]
  node_usercontroller["User endpoints"]
  node_googleauth["Google sign-in"]
  node_token["JWT tokens<br/>[TokenService.java]"]
  node_backendapi["Spring API"]
end

subgraph group_state["Accounts and state"]
  node_repository["Learning repositories"]
  node_userrepo["Account repository"]
  node_catalogcache["Course cache<br/>[CacheConfig.java]"]
  node_database[("Relational database")]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_app
node_app -->|"initializes"| node_auth
node_app -->|"loads"| node_clientapi
node_auth -->|"calls"| node_clientapi
node_learner -->|"selects language"| node_courseviews
node_courseviews -->|"opens lessons"| node_lesson
node_learner -->|"tests knowledge"| node_quicklevel
node_learner -->|"explores vocabulary"| node_glossary
node_glossary -.->|"uses pronunciation"| node_speech
node_clientapi -->|"sends requests"| node_backendapi
node_backendapi -.->|"serves course data"| node_learningapi
node_backendapi -.->|"records completion"| node_progress
node_backendapi -.->|"supports achievements"| node_achievement
node_usercontroller -->|"checks language"| node_courseaccess
node_usercontroller -.->|"delegates user work"| node_userrepo
node_learningapi -->|"reads course data"| node_repository
node_progress -->|"updates progress"| node_repository
node_achievement -->|"reads and updates"| node_repository
node_learningapi -->|"uses cache"| node_catalogcache
node_repository -.->|"persists records"| node_database
node_googleauth -->|"finds and saves users"| node_userrepo
node_googleauth -.->|"issues session"| node_token

click node_app "https://github.com/54m54m/tlahtolli/blob/v4/f/src/App.vue"
click node_auth "https://github.com/54m54m/tlahtolli/blob/v4/f/src/stores/auth.js"
click node_clientapi "https://github.com/54m54m/tlahtolli/blob/v4/f/src/api/apiClient.js"
click node_courseviews "https://github.com/54m54m/tlahtolli/tree/v4/f/src/views"
click node_lesson "https://github.com/54m54m/tlahtolli/blob/v4/f/src/views/learn/LessonView.vue"
click node_quicklevel "https://github.com/54m54m/tlahtolli/blob/v4/f/src/views/learn/QuickLevelView.vue"
click node_glossary "https://github.com/54m54m/tlahtolli/tree/v4/f/src/views/glossary"
click node_speech "https://github.com/54m54m/tlahtolli/blob/v4/f/src/data/services/SpeechService.js"
click node_learningapi "https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/LearningService.java"
click node_courseaccess "https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/CourseAccess.java"
click node_progress "https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/ProgressService.java"
click node_achievement "https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/AchievementService.java"
click node_gamification "https://github.com/54m54m/tlahtolli/tree/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service"
click node_usercontroller "https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/controller/UserController.java"
click node_googleauth "https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/GoogleAuthService.java"
click node_token "https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/security/TokenService.java"
click node_repository "https://github.com/54m54m/tlahtolli/tree/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/repository"
click node_userrepo "https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/repository/UserRepository.java"
click node_catalogcache "https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/config/CacheConfig.java"
click node_backendapi "https://github.com/54m54m/tlahtolli/tree/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/controller"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth,node_clientapi toneBlue
class node_courseviews,node_lesson,node_quicklevel,node_glossary,node_speech toneAmber
class node_learningapi,node_courseaccess,node_progress,node_achievement,node_gamification,node_usercontroller,node_googleauth,node_token,node_backendapi toneMint
class node_repository,node_userrepo,node_catalogcache,node_database toneRose
class node_learner toneIndigo
```

## Components

### Web client

- [App startup](https://github.com/54m54m/tlahtolli/blob/v4/f/src/App.vue): `f/src/App.vue`
- [Session and language](https://github.com/54m54m/tlahtolli/blob/v4/f/src/stores/auth.js): `f/src/stores/auth.js`
- [API client](https://github.com/54m54m/tlahtolli/blob/v4/f/src/api/apiClient.js): `f/src/api/apiClient.js`

### Learning experience

- [Course navigation](https://github.com/54m54m/tlahtolli/tree/v4/f/src/views): `f/src/views`
- [Interactive lessons](https://github.com/54m54m/tlahtolli/blob/v4/f/src/views/learn/LessonView.vue): `f/src/views/learn/LessonView.vue`
- [Quick level](https://github.com/54m54m/tlahtolli/blob/v4/f/src/views/learn/QuickLevelView.vue): `f/src/views/learn/QuickLevelView.vue`
- [Vocabulary tools](https://github.com/54m54m/tlahtolli/tree/v4/f/src/views/glossary): `f/src/views/glossary`
- [Pronunciation](https://github.com/54m54m/tlahtolli/blob/v4/f/src/data/services/SpeechService.js): `f/src/data/services/SpeechService.js`

### Backend services

- [Course content](https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/LearningService.java): `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/LearningService.java`
- [Course access](https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/CourseAccess.java): `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/CourseAccess.java`
- [Progress rules](https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/ProgressService.java): `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/ProgressService.java`
- [Achievements](https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/AchievementService.java): `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/AchievementService.java`
- [Energy and stats](https://github.com/54m54m/tlahtolli/tree/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service): `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service`
- [User endpoints](https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/controller/UserController.java): `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/controller/UserController.java`
- [Google sign-in](https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/GoogleAuthService.java): `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/GoogleAuthService.java`
- [JWT tokens](https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/security/TokenService.java): `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/security/TokenService.java`
- [Spring API](https://github.com/54m54m/tlahtolli/tree/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/controller): `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/controller`

### Accounts and state

- [Learning repositories](https://github.com/54m54m/tlahtolli/tree/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/repository): `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/repository`
- [Account repository](https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/repository/UserRepository.java): `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/repository/UserRepository.java`
- [Course cache](https://github.com/54m54m/tlahtolli/blob/v4/b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/config/CacheConfig.java): `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/config/CacheConfig.java`
- **Relational database**

### Other components

- **Learner**

## Connections

- Learner → App startup: uses
- App startup → Session and language: initializes (evidence: `f/src/App.vue`)
- App startup → API client: loads (evidence: `f/src/App.vue`)
- Session and language → API client: calls (evidence: `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 (evidence: `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 (evidence: `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 (evidence: `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/LearningService.java`)
- Progress rules → Learning repositories: updates progress (evidence: `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/ProgressService.java`)
- Achievements → Learning repositories: reads and updates (evidence: `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/AchievementService.java`)
- Course content → Course cache: uses cache (evidence: `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 (evidence: `b/ar-cs-tlahtolcalli/src/main/java/com/tlahtolli/api/service/GoogleAuthService.java`)
- Google sign-in → JWT tokens: issues session
