# jraversbcn21/mycampusistqb_26 architecture

> Architecture diagram of the GitHub repository jraversbcn21/mycampusistqb_26, 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/jraversbcn21/mycampusistqb_26
- Repository: https://github.com/jraversbcn21/mycampusistqb_26

## Overview

MyCampus is a bilingual ISTQB CTFL study web app. A learner enters through the app, studies the syllabus through lessons, glossary, and flashcards, practices with exam questions, and can track progress and achievements. Accounts enable cloud-synced progress, with localStorage fallback; ranking is an additional online feature. The README documents the capabilities, while sampled source confirms lesson data access and ranking queries. Several UI-to-module calls are not visible in the excerpts, so those relationships are omitted or marked unverified.

Main entry points: [`js/app.js`](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/app.js) (App Controller), [`js/auth.js`](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/auth.js) (Authentication), [`js/sync.js`](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/sync.js) (Progress Sync), [`js/config.js`](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/config.js) (Service Config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_study["Study and Practice"]
  node_course["Lessons and Glossary<br/>[content.js]"]
  node_flashcards["Flashcards<br/>[content.js]"]
  node_questions["Question Bank<br/>[questions.js]"]
  node_exam["Exam Practice<br/>[app.js]"]
  node_gamification["XP and Achievements<br/>[gamification.js]"]
end

subgraph group_experience["App Experience"]
  node_app["App Controller<br/>[app.js]"]
  node_translations["ES/EN Text<br/>[i18n.js]"]
  node_onboarding["Onboarding Tour<br/>[onboarding.js]"]
  node_monitoring["Error Monitoring<br/>[monitoring.js]"]
end

subgraph group_identity["Identity and Progress"]
  node_auth["Authentication<br/>[auth.js]"]
  node_avatar["Avatar Profile<br/>[avatar.js]"]
  node_sync["Progress Sync<br/>[sync.js]"]
  node_local[("Local Progress")]
  node_ranking["Leaderboard<br/>[app.js]"]
end

subgraph group_services["External Services"]
  node_cloud[("Supabase Data")]
  node_config["Service Config<br/>[config.js]"]
  node_speech["Web Speech API"]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_app
node_app -->|"reads lesson data"| node_course
node_learner -.->|"reviews"| node_flashcards
node_learner -.->|"practices"| node_exam
node_exam -.->|"uses question bank"| node_questions
node_app -.->|"updates rewards"| node_gamification
node_app -.->|"uses translations"| node_translations
node_auth -->|"authenticates"| node_cloud
node_auth -->|"starts app"| node_app
node_auth -->|"initializes"| node_avatar
node_auth -->|"starts tour"| node_onboarding
node_app -.->|"saves progress"| node_sync
node_sync -->|"falls back"| node_local
node_sync -->|"syncs progress"| node_cloud
node_app -->|"queries leaderboard"| node_cloud
node_learner -->|"signs in"| node_auth
node_app -.->|"speaks flashcards"| node_speech
node_config -->|"configures access"| node_cloud
node_app -.->|"reports errors"| node_monitoring

click node_app "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/app.js"
click node_translations "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/i18n.js"
click node_onboarding "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/onboarding.js"
click node_monitoring "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/monitoring.js"
click node_course "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/content.js"
click node_flashcards "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/content.js"
click node_questions "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/questions.js"
click node_exam "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/app.js"
click node_gamification "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/gamification.js"
click node_auth "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/auth.js"
click node_avatar "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/avatar.js"
click node_sync "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/sync.js"
click node_ranking "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/app.js"
click node_config "https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/config.js"

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_course,node_flashcards,node_questions,node_exam,node_gamification toneBlue
class node_app,node_translations,node_onboarding,node_monitoring toneAmber
class node_auth,node_avatar,node_sync,node_local,node_ranking toneMint
class node_cloud,node_config,node_speech toneRose
class node_learner toneIndigo
```

## Components

### Study and Practice

- [Lessons and Glossary](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/content.js): `js/content.js`
- [Flashcards](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/content.js): `js/content.js`
- [Question Bank](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/questions.js): `js/questions.js`
- [Exam Practice](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/app.js): `js/app.js`
- [XP and Achievements](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/gamification.js): `js/gamification.js`

### App Experience

- [App Controller](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/app.js): `js/app.js`
- [ES/EN Text](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/i18n.js): `js/i18n.js`
- [Onboarding Tour](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/onboarding.js): `js/onboarding.js`
- [Error Monitoring](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/monitoring.js): `js/monitoring.js`

### Identity and Progress

- [Authentication](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/auth.js): `js/auth.js`
- [Avatar Profile](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/avatar.js): `js/avatar.js`
- [Progress Sync](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/sync.js): `js/sync.js`
- **Local Progress**
- [Leaderboard](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/app.js): `js/app.js`

### External Services

- **Supabase Data**
- [Service Config](https://github.com/jraversbcn21/mycampusistqb_26/blob/master/js/config.js): `js/config.js`
- **Web Speech API**

### Other components

- **Learner**

## Connections

- Learner → App Controller: uses (evidence: `README.md`)
- App Controller → Lessons and Glossary: reads lesson data (evidence: `js/app.js`)
- Learner → Flashcards: reviews
- Learner → Exam Practice: practices
- Exam Practice → Question Bank: uses question bank
- App Controller → XP and Achievements: updates rewards
- App Controller → ES/EN Text: uses translations
- Authentication → Supabase Data: authenticates (evidence: `README.md`)
- Authentication → App Controller: starts app (evidence: `js/auth.js`)
- Authentication → Avatar Profile: initializes (evidence: `js/auth.js`)
- Authentication → Onboarding Tour: starts tour (evidence: `js/auth.js`)
- App Controller → Progress Sync: saves progress
- Progress Sync → Local Progress: falls back (evidence: `README.md`)
- Progress Sync → Supabase Data: syncs progress (evidence: `README.md`)
- App Controller → Supabase Data: queries leaderboard (evidence: `js/app.js`)
- Learner → Authentication: signs in (evidence: `README.md`)
- App Controller → Web Speech API: speaks flashcards
- Service Config → Supabase Data: configures access (evidence: `README.md`)
- App Controller → Error Monitoring: reports errors
