# baeyoju/talinturo architecture

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

- Interactive diagram: https://gitdiagram.com/baeyoju/talinturo
- Repository: https://github.com/baeyoju/talinturo

## Overview

Talinturo is an FSL learning product for learners, families, instructors, and administrators. Learners authenticate, complete profile onboarding, then navigate learning paths and lessons, practice and activity experiences, and review vocabulary and progress; instructors manage learners and classrooms, while administrators manage content and the experimental Sign Lab. The React app routes these workflows through a shared HTTP client to Flask, which owns authentication, API behavior, and PostgreSQL access. Arrows are limited to relationships explicit in the README or shown excerpts; several feature-to-API relationships are documented only at a high level.

Main entry points: [`frontend/src/app/routes.jsx`](https://github.com/baeyoju/talinturo/blob/main/frontend/src/app/routes.jsx) (Role-based routes), [`frontend/src/adapters/http/api.js`](https://github.com/baeyoju/talinturo/blob/main/frontend/src/adapters/http/api.js) (HTTP API client), [`frontend/src/features/auth/pages/LearnerAuthPage.jsx`](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/auth/pages/LearnerAuthPage.jsx) (Sign-in and signup), [`frontend/src/features/lesson/pages/LessonViewerPage.jsx`](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/lesson/pages/LessonViewerPage.jsx) (Video lessons and quizzes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_app["React app shell<br/>[App.jsx]"]
  node_routes["Role-based routes<br/>[routes.jsx]"]
  node_auth["Sign-in and signup"]
  node_session["Session restoration<br/>[useSession.js]"]
  node_onboarding["Profile onboarding"]
end

subgraph group_learning["Learner experiences"]
  node_paths["Learning paths"]
  node_lessons["Video lessons and quizzes"]
  node_landmarks["Camera landmarks<br/>[LandmarkCamera.jsx]"]
  node_vocabulary["Vocabulary and saved signs<br/>[VocabularyPage.jsx]"]
  node_practice["Practice activities<br/>[PracticePage.jsx]"]
  node_scenarios["Scenarios and challenges"]
  node_progress["Progress dashboard<br/>[ProgressPage.jsx]"]
end

subgraph group_people["Classroom management"]
  node_instructor_tools["Instructor workspace"]
  node_classrooms["Classroom membership"]
end

subgraph group_operations["Admin tools"]
  node_admin_workspace["Content and account admin<br/>[AdminWorkspace.jsx]"]
  node_sign_lab["Landmark Sign Lab<br/>[SignLabPage.jsx]"]
end

subgraph group_services["API and persistence"]
  node_http["HTTP API client<br/>[api.js]"]
  node_flask["Flask API<br/>[app.py]"]
  node_postgres[("PostgreSQL")]
end

node_learner(("Learner"))
node_instructor(("Instructor"))
node_admin(("Administrator"))

node_learner -->|"signs in"| node_auth
node_instructor -->|"signs in"| node_auth
node_admin -->|"signs in"| node_auth
node_app -->|"restores session"| node_session
node_app -->|"renders routes"| node_routes
node_routes -->|"routes to"| node_auth
node_auth -->|"submits credentials"| node_http
node_session -->|"checks session"| node_http
node_learner -->|"sets up profile"| node_onboarding
node_routes -->|"routes to"| node_paths
node_routes -->|"routes to"| node_lessons
node_routes -->|"routes to"| node_practice
node_routes -->|"routes to"| node_scenarios
node_routes -->|"routes to"| node_vocabulary
node_routes -.->|"routes to"| node_progress
node_lessons -->|"uses camera"| node_landmarks
node_routes -->|"routes to"| node_instructor_tools
node_routes -->|"routes to"| node_classrooms
node_routes -->|"routes to"| node_admin_workspace
node_routes -->|"routes to"| node_sign_lab
node_paths -.->|"loads content"| node_http
node_lessons -.->|"loads lessons"| node_http
node_practice -.->|"submits practice"| node_http
node_scenarios -.->|"loads activities"| node_http
node_vocabulary -.->|"loads signs"| node_http
node_progress -.->|"loads progress"| node_http
node_instructor_tools -.->|"manages learners"| node_http
node_classrooms -.->|"manages membership"| node_http
node_admin_workspace -.->|"manages content"| node_http
node_sign_lab -.->|"uses API"| node_http
node_http -.->|"sends requests"| node_flask
node_flask -->|"reads and writes"| node_postgres

click node_app "https://github.com/baeyoju/talinturo/blob/main/frontend/src/app/App.jsx"
click node_routes "https://github.com/baeyoju/talinturo/blob/main/frontend/src/app/routes.jsx"
click node_auth "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/auth/pages/LearnerAuthPage.jsx"
click node_session "https://github.com/baeyoju/talinturo/blob/main/frontend/src/app/hooks/useSession.js"
click node_onboarding "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/onboarding/pages/ProfileSetupPage.jsx"
click node_paths "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/path/pages/LearningPathsPage.jsx"
click node_lessons "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/lesson/pages/LessonViewerPage.jsx"
click node_landmarks "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/lesson/components/LandmarkCamera.jsx"
click node_vocabulary "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/vocabulary/pages/VocabularyPage.jsx"
click node_practice "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/practice/pages/PracticePage.jsx"
click node_scenarios "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/activities/pages/ScenarioActivityPage.jsx"
click node_progress "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/progress/pages/ProgressPage.jsx"
click node_instructor_tools "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/instructor/pages/InstructorHomePage.jsx"
click node_classrooms "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/classroom/pages/LearnerClassroomsPage.jsx"
click node_admin_workspace "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/admin/pages/AdminWorkspace.jsx"
click node_sign_lab "https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/admin/pages/SignLabPage.jsx"
click node_http "https://github.com/baeyoju/talinturo/blob/main/frontend/src/adapters/http/api.js"
click node_flask "https://github.com/baeyoju/talinturo/blob/main/backend/app.py"

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_routes,node_auth,node_session,node_onboarding toneBlue
class node_paths,node_lessons,node_landmarks,node_vocabulary,node_practice,node_scenarios,node_progress toneAmber
class node_instructor_tools,node_classrooms toneMint
class node_admin_workspace,node_sign_lab toneRose
class node_http,node_flask,node_postgres,node_learner,node_instructor,node_admin toneIndigo
```

## Components

### App shell

- [React app shell](https://github.com/baeyoju/talinturo/blob/main/frontend/src/app/App.jsx): `frontend/src/app/App.jsx`
- [Role-based routes](https://github.com/baeyoju/talinturo/blob/main/frontend/src/app/routes.jsx): `frontend/src/app/routes.jsx`
- [Sign-in and signup](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/auth/pages/LearnerAuthPage.jsx): `frontend/src/features/auth/pages/LearnerAuthPage.jsx`
- [Session restoration](https://github.com/baeyoju/talinturo/blob/main/frontend/src/app/hooks/useSession.js): `frontend/src/app/hooks/useSession.js`
- [Profile onboarding](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/onboarding/pages/ProfileSetupPage.jsx): `frontend/src/features/onboarding/pages/ProfileSetupPage.jsx`

### Learner experiences

- [Learning paths](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/path/pages/LearningPathsPage.jsx): `frontend/src/features/path/pages/LearningPathsPage.jsx`
- [Video lessons and quizzes](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/lesson/pages/LessonViewerPage.jsx): `frontend/src/features/lesson/pages/LessonViewerPage.jsx`
- [Camera landmarks](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/lesson/components/LandmarkCamera.jsx): `frontend/src/features/lesson/components/LandmarkCamera.jsx`
- [Vocabulary and saved signs](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/vocabulary/pages/VocabularyPage.jsx): `frontend/src/features/vocabulary/pages/VocabularyPage.jsx`
- [Practice activities](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/practice/pages/PracticePage.jsx): `frontend/src/features/practice/pages/PracticePage.jsx`
- [Scenarios and challenges](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/activities/pages/ScenarioActivityPage.jsx): `frontend/src/features/activities/pages/ScenarioActivityPage.jsx`
- [Progress dashboard](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/progress/pages/ProgressPage.jsx): `frontend/src/features/progress/pages/ProgressPage.jsx`

### Classroom management

- [Instructor workspace](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/instructor/pages/InstructorHomePage.jsx): `frontend/src/features/instructor/pages/InstructorHomePage.jsx`
- [Classroom membership](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/classroom/pages/LearnerClassroomsPage.jsx): `frontend/src/features/classroom/pages/LearnerClassroomsPage.jsx`

### Admin tools

- [Content and account admin](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/admin/pages/AdminWorkspace.jsx): `frontend/src/features/admin/pages/AdminWorkspace.jsx`
- [Landmark Sign Lab](https://github.com/baeyoju/talinturo/blob/main/frontend/src/features/admin/pages/SignLabPage.jsx): `frontend/src/features/admin/pages/SignLabPage.jsx`

### API and persistence

- [HTTP API client](https://github.com/baeyoju/talinturo/blob/main/frontend/src/adapters/http/api.js): `frontend/src/adapters/http/api.js`
- [Flask API](https://github.com/baeyoju/talinturo/blob/main/backend/app.py): `backend/app.py`
- **PostgreSQL**

### Other components

- **Learner**
- **Instructor**
- **Administrator**

## Connections

- Learner → Sign-in and signup: signs in
- Instructor → Sign-in and signup: signs in
- Administrator → Sign-in and signup: signs in (evidence: `README.md`)
- React app shell → Session restoration: restores session (evidence: `frontend/src/app/App.jsx`)
- React app shell → Role-based routes: renders routes (evidence: `frontend/src/app/App.jsx`)
- Role-based routes → Sign-in and signup: routes to (evidence: `frontend/src/app/routes.jsx`)
- Sign-in and signup → HTTP API client: submits credentials (evidence: `frontend/src/features/auth/pages/LearnerAuthPage.jsx`)
- Session restoration → HTTP API client: checks session (evidence: `frontend/src/app/hooks/useSession.js`)
- Learner → Profile onboarding: sets up profile
- Role-based routes → Learning paths: routes to (evidence: `frontend/src/app/routes.jsx`)
- Role-based routes → Video lessons and quizzes: routes to (evidence: `frontend/src/app/routes.jsx`)
- Role-based routes → Practice activities: routes to (evidence: `frontend/src/app/routes.jsx`)
- Role-based routes → Scenarios and challenges: routes to (evidence: `frontend/src/app/routes.jsx`)
- Role-based routes → Vocabulary and saved signs: routes to (evidence: `frontend/src/app/routes.jsx`)
- Role-based routes → Progress dashboard: routes to
- Video lessons and quizzes → Camera landmarks: uses camera (evidence: `frontend/src/features/lesson/pages/LessonViewerPage.jsx`)
- Role-based routes → Instructor workspace: routes to (evidence: `frontend/src/app/routes.jsx`)
- Role-based routes → Classroom membership: routes to (evidence: `frontend/src/app/routes.jsx`)
- Role-based routes → Content and account admin: routes to (evidence: `frontend/src/app/routes.jsx`)
- Role-based routes → Landmark Sign Lab: routes to (evidence: `frontend/src/app/routes.jsx`)
- Learning paths → HTTP API client: loads content
- Video lessons and quizzes → HTTP API client: loads lessons
- Practice activities → HTTP API client: submits practice
- Scenarios and challenges → HTTP API client: loads activities
- Vocabulary and saved signs → HTTP API client: loads signs
- Progress dashboard → HTTP API client: loads progress
- Instructor workspace → HTTP API client: manages learners
- Classroom membership → HTTP API client: manages membership
- Content and account admin → HTTP API client: manages content
- Landmark Sign Lab → HTTP API client: uses API
- HTTP API client → Flask API: sends requests
- Flask API → PostgreSQL: reads and writes (evidence: `README.md`)
