# joseisaias-ai/vanguardia architecture

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

- Interactive diagram: https://gitdiagram.com/joseisaias-ai/vanguardia
- Repository: https://github.com/joseisaias-ai/vanguardia

## Overview

Vanguardia is a browser-based educational game about artificial intelligence. The player follows Sophia through narrative scenes and playable phases, learning AI concepts through exploration and minigames. The graph shows the Phaser scene registry, the documented AI-learning topics, and shared gameplay systems. The excerpts establish several utility calls and a few transitions; other scene-to-scene progression is not inferred. README capabilities are included, but unsampled phase implementations are represented by their exact paths.

Main entry points: [`public/src/scenes/caixasDialogo.js`](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/caixasDialogo.js) (Dialogue system), [`public/src/scenes/sceneLbPassado.js`](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/sceneLbPassado.js) (Past laboratory), [`public/src/scenes/sceneLbFuturo.js`](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/sceneLbFuturo.js) (Future laboratory), [`public/src/scenes/scenePreFase4.js`](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/scenePreFase4.js) (Crystal hub)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game runtime"]
  node_phaser["Phaser game"]
end

subgraph group_story["Story scenes"]
  node_welcome["Welcome<br/>[welcome.js]"]
  node_initial["Initial scene<br/>[sceneInicial.js]"]
  node_pastlab["Past laboratory<br/>[sceneLbPassado.js]"]
  node_futurelab["Future laboratory<br/>[sceneLbFuturo.js]"]
  node_transition["Lab transition<br/>[transicao1Para2.js]"]
  node_pre4["Crystal hub<br/>[scenePreFase4.js]"]
  node_restoration["Restoration scene"]
  node_credits["Credits<br/>[sceneCreditos.js]"]
end

subgraph group_gameplay["Learning gameplay"]
  node_phase1["Phase one<br/>[faseUm.js]"]
  node_phase2["Neural network<br/>[faseDois.js]"]
  node_phase3["Crystal platforming<br/>[faseTres.js]"]
  node_phase4["Phase four<br/>[faseQuatro.js]"]
  node_phase5["Phase five<br/>[faseCinco.js]"]
  node_falling["Falling floor<br/>[chaoCaindo.js]"]
end

subgraph group_shared["Shared systems"]
  node_dialogue["Dialogue system<br/>[caixasDialogo.js]"]
  node_keyhud["Interaction prompt<br/>[hudTeclaE.js]"]
  node_movement["Character movement<br/>[movimentacao.js]"]
  node_snow["Snow effect<br/>[efeitoNeve.js]"]
  node_menu["Pause menu<br/>[menu.js]"]
  node_music["Background music<br/>[bgMusic.js]"]
end

node_player(("Player"))

node_phaser -->|"registers scene"| node_welcome
node_phaser -->|"registers scene"| node_initial
node_phaser -->|"registers scene"| node_pastlab
node_phaser -->|"registers scene"| node_futurelab
node_phaser -->|"registers scene"| node_phase1
node_phaser -->|"registers scene"| node_transition
node_phaser -->|"registers scene"| node_phase2
node_phaser -->|"registers scene"| node_falling
node_phaser -->|"registers scene"| node_phase3
node_phaser -->|"registers scene"| node_pre4
node_phaser -->|"registers scene"| node_phase4
node_phaser -->|"registers scene"| node_restoration
node_phaser -->|"registers scene"| node_phase5
node_phaser -->|"registers scene"| node_credits
node_phaser -->|"registers scene"| node_menu
node_phaser -->|"registers scene"| node_music
node_player -.->|"plays game"| node_phaser
node_transition -->|"starts scene"| node_phase2
node_futurelab -->|"starts scene"| node_phase1
node_pre4 -->|"starts scene"| node_phase4
node_pastlab -->|"calls movement"| node_movement
node_pastlab -->|"uses dialogue"| node_dialogue
node_pastlab -->|"creates effect"| node_snow
node_pastlab -->|"registers shortcut"| node_menu
node_futurelab -->|"calls movement"| node_movement
node_futurelab -->|"uses dialogue"| node_dialogue
node_futurelab -->|"creates effect"| node_snow
node_pre4 -->|"calls movement"| node_movement
node_pre4 -->|"uses dialogue"| node_dialogue
node_pre4 -->|"creates effect"| node_snow
node_phase2 -->|"registers shortcut"| node_menu
node_phase2 -->|"uses dialogue"| node_dialogue
node_phase1 -->|"registers shortcut"| node_menu
node_transition -->|"uses dialogue"| node_dialogue
node_transition -->|"creates effect"| node_snow
node_dialogue -->|"creates prompt"| node_keyhud
node_menu -->|"launches scene"| node_music
node_player -.->|"learns neural networks"| node_phase2
node_player -.->|"practices AI concepts"| node_phase3

click node_welcome "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/welcome.js"
click node_initial "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/sceneInicial.js"
click node_pastlab "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/sceneLbPassado.js"
click node_futurelab "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/sceneLbFuturo.js"
click node_transition "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/transicao1Para2.js"
click node_pre4 "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/scenePreFase4.js"
click node_restoration "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/sceneRestauracao.js"
click node_credits "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/sceneCreditos.js"
click node_phase1 "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/faseUm.js"
click node_phase2 "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/faseDois.js"
click node_phase3 "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/faseTres.js"
click node_phase4 "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/faseQuatro.js"
click node_phase5 "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/faseCinco.js"
click node_falling "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/chaoCaindo.js"
click node_dialogue "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/caixasDialogo.js"
click node_keyhud "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/hudTeclaE.js"
click node_movement "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/movimentacao.js"
click node_snow "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/efeitoNeve.js"
click node_menu "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/menu.js"
click node_music "https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/bgMusic.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_phaser toneBlue
class node_welcome,node_initial,node_pastlab,node_futurelab,node_transition,node_pre4,node_restoration,node_credits toneAmber
class node_phase1,node_phase2,node_phase3,node_phase4,node_phase5,node_falling toneMint
class node_dialogue,node_keyhud,node_movement,node_snow,node_menu,node_music toneRose
class node_player toneIndigo
```

## Components

### Game runtime

- **Phaser game**

### Story scenes

- [Welcome](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/welcome.js): `public/src/scenes/welcome.js`
- [Initial scene](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/sceneInicial.js): `public/src/scenes/sceneInicial.js`
- [Past laboratory](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/sceneLbPassado.js): `public/src/scenes/sceneLbPassado.js`
- [Future laboratory](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/sceneLbFuturo.js): `public/src/scenes/sceneLbFuturo.js`
- [Lab transition](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/transicao1Para2.js): `public/src/scenes/transicao1Para2.js`
- [Crystal hub](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/scenePreFase4.js): `public/src/scenes/scenePreFase4.js`
- [Restoration scene](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/sceneRestauracao.js): `public/src/scenes/sceneRestauracao.js`
- [Credits](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/sceneCreditos.js): `public/src/scenes/sceneCreditos.js`

### Learning gameplay

- [Phase one](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/faseUm.js): `public/src/scenes/faseUm.js`
- [Neural network](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/faseDois.js): `public/src/scenes/faseDois.js`
- [Crystal platforming](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/faseTres.js): `public/src/scenes/faseTres.js`
- [Phase four](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/faseQuatro.js): `public/src/scenes/faseQuatro.js`
- [Phase five](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/faseCinco.js): `public/src/scenes/faseCinco.js`
- [Falling floor](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/chaoCaindo.js): `public/src/scenes/chaoCaindo.js`

### Shared systems

- [Dialogue system](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/caixasDialogo.js): `public/src/scenes/caixasDialogo.js`
- [Interaction prompt](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/hudTeclaE.js): `public/src/scenes/hudTeclaE.js`
- [Character movement](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/movimentacao.js): `public/src/scenes/movimentacao.js`
- [Snow effect](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/efeitoNeve.js): `public/src/scenes/efeitoNeve.js`
- [Pause menu](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/menu.js): `public/src/menu.js`
- [Background music](https://github.com/joseisaias-ai/vanguardia/blob/main/public/src/scenes/bgMusic.js): `public/src/scenes/bgMusic.js`

### Other components

- **Player**

## Connections

- Phaser game → Welcome: registers scene
- Phaser game → Initial scene: registers scene
- Phaser game → Past laboratory: registers scene
- Phaser game → Future laboratory: registers scene
- Phaser game → Phase one: registers scene
- Phaser game → Lab transition: registers scene
- Phaser game → Neural network: registers scene
- Phaser game → Falling floor: registers scene
- Phaser game → Crystal platforming: registers scene
- Phaser game → Crystal hub: registers scene
- Phaser game → Phase four: registers scene
- Phaser game → Restoration scene: registers scene
- Phaser game → Phase five: registers scene
- Phaser game → Credits: registers scene
- Phaser game → Pause menu: registers scene
- Phaser game → Background music: registers scene
- Player → Phaser game: plays game (evidence: `README.md`)
- Lab transition → Neural network: starts scene (evidence: `public/src/scenes/transicao1Para2.js`)
- Future laboratory → Phase one: starts scene (evidence: `public/src/scenes/sceneLbFuturo.js`)
- Crystal hub → Phase four: starts scene (evidence: `public/src/scenes/scenePreFase4.js`)
- Past laboratory → Character movement: calls movement (evidence: `public/src/scenes/sceneLbPassado.js`)
- Past laboratory → Dialogue system: uses dialogue (evidence: `public/src/scenes/sceneLbPassado.js`)
- Past laboratory → Snow effect: creates effect (evidence: `public/src/scenes/sceneLbPassado.js`)
- Past laboratory → Pause menu: registers shortcut (evidence: `public/src/scenes/sceneLbPassado.js`)
- Future laboratory → Character movement: calls movement (evidence: `public/src/scenes/sceneLbFuturo.js`)
- Future laboratory → Dialogue system: uses dialogue (evidence: `public/src/scenes/sceneLbFuturo.js`)
- Future laboratory → Snow effect: creates effect (evidence: `public/src/scenes/sceneLbFuturo.js`)
- Crystal hub → Character movement: calls movement (evidence: `public/src/scenes/scenePreFase4.js`)
- Crystal hub → Dialogue system: uses dialogue (evidence: `public/src/scenes/scenePreFase4.js`)
- Crystal hub → Snow effect: creates effect (evidence: `public/src/scenes/scenePreFase4.js`)
- Neural network → Pause menu: registers shortcut (evidence: `public/src/scenes/faseDois.js`)
- Neural network → Dialogue system: uses dialogue (evidence: `public/src/scenes/faseDois.js`)
- Phase one → Pause menu: registers shortcut (evidence: `public/src/scenes/faseUm.js`)
- Lab transition → Dialogue system: uses dialogue (evidence: `public/src/scenes/transicao1Para2.js`)
- Lab transition → Snow effect: creates effect (evidence: `public/src/scenes/transicao1Para2.js`)
- Dialogue system → Interaction prompt: creates prompt (evidence: `public/src/scenes/caixasDialogo.js`)
- Pause menu → Background music: launches scene (evidence: `public/src/menu.js`)
- Player → Neural network: learns neural networks (evidence: `README.md`)
- Player → Crystal platforming: practices AI concepts (evidence: `README.md`)
