# rildoreis/adescubrir architecture

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

- Interactive diagram: https://gitdiagram.com/rildoreis/adescubrir
- Repository: https://github.com/rildoreis/adescubrir

## Overview

ADESCUBRIR is a Ren’Py Spanish-language educational game with narrated, accessible interactive scenes. The tree indicates an onboarding/avatar-calibration stage, room-based object activities, and a Frida Kahlo museum experience with audio description and word games. Source excerpts were not provided for the game scripts, so chapter connections and detailed control flow are inferred only from filenames; the graph avoids asserting specific calls between them.

Main entry points: [`game/audio`](https://github.com/rildoreis/adescubrir/tree/main/game/audio) (Narration and effects), [`game/images`](https://github.com/rildoreis/adescubrir/tree/main/game/images) (Character and scene art), [`game/script.rpy`](https://github.com/rildoreis/adescubrir/blob/main/game/script.rpy) (Game entry), [`game/03_capitulo1_prologo.rpy`](https://github.com/rildoreis/adescubrir/blob/main/game/03_capitulo1_prologo.rpy) (Prologue)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game runtime"]
  node_entry["Game entry<br/>[script.rpy]"]
  node_state["Definitions and state<br/>[01_definicoes.rpy]"]
  node_screens["Screens and UI<br/>[02_screens.rpy]"]
end

subgraph group_story["Story chapters"]
  node_prologue["Prologue"]
  node_calibration["Avatar calibration"]
  node_room["Room activities"]
  node_roomgames["Room mini-games"]
  node_museum["Museum chapter<br/>[07_capitulo3.rpy]"]
  node_chapter4["Chapter four<br/>[08_capitulo4.rpy]"]
end

subgraph group_assets["Game assets"]
  node_audio["Narration and effects"]
  node_visuals["Character and scene art"]
end

node_player(("Player"))

node_player -->|"starts game"| node_entry
node_entry -->|"shows interface"| node_screens
node_entry -->|"uses definitions"| node_state
node_entry -->|"starts story"| node_prologue
node_prologue -->|"continues to"| node_calibration
node_room -->|"continues to"| node_roomgames
node_prologue -->|"uses narration"| node_audio
node_calibration -->|"uses narration"| node_audio
node_room -->|"uses narration"| node_audio
node_roomgames -->|"uses narration"| node_audio
node_museum -->|"uses narration"| node_audio
node_chapter4 -->|"uses narration"| node_audio
node_prologue -->|"uses artwork"| node_visuals
node_calibration -->|"uses artwork"| node_visuals
node_room -->|"uses artwork"| node_visuals
node_roomgames -->|"uses artwork"| node_visuals
node_museum -->|"uses artwork"| node_visuals
node_chapter4 -->|"uses artwork"| node_visuals

click node_entry "https://github.com/rildoreis/adescubrir/blob/main/game/script.rpy"
click node_state "https://github.com/rildoreis/adescubrir/blob/main/game/01_definicoes.rpy"
click node_screens "https://github.com/rildoreis/adescubrir/blob/main/game/02_screens.rpy"
click node_prologue "https://github.com/rildoreis/adescubrir/blob/main/game/03_capitulo1_prologo.rpy"
click node_calibration "https://github.com/rildoreis/adescubrir/blob/main/game/04_capitulo1_calibracion.rpy"
click node_room "https://github.com/rildoreis/adescubrir/blob/main/game/05_capitulo2_cena1.rpy"
click node_roomgames "https://github.com/rildoreis/adescubrir/blob/main/game/06_capitulo2_cena2.rpy"
click node_museum "https://github.com/rildoreis/adescubrir/blob/main/game/07_capitulo3.rpy"
click node_chapter4 "https://github.com/rildoreis/adescubrir/blob/main/game/08_capitulo4.rpy"
click node_audio "https://github.com/rildoreis/adescubrir/tree/main/game/audio"
click node_visuals "https://github.com/rildoreis/adescubrir/tree/main/game/images"

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_entry,node_state,node_screens toneBlue
class node_prologue,node_calibration,node_room,node_roomgames,node_museum,node_chapter4 toneAmber
class node_audio,node_visuals toneMint
class node_player toneIndigo
```

## Components

### Game runtime

- [Game entry](https://github.com/rildoreis/adescubrir/blob/main/game/script.rpy): `game/script.rpy`
- [Definitions and state](https://github.com/rildoreis/adescubrir/blob/main/game/01_definicoes.rpy): `game/01_definicoes.rpy`
- [Screens and UI](https://github.com/rildoreis/adescubrir/blob/main/game/02_screens.rpy): `game/02_screens.rpy`

### Story chapters

- [Prologue](https://github.com/rildoreis/adescubrir/blob/main/game/03_capitulo1_prologo.rpy): `game/03_capitulo1_prologo.rpy`
- [Avatar calibration](https://github.com/rildoreis/adescubrir/blob/main/game/04_capitulo1_calibracion.rpy): `game/04_capitulo1_calibracion.rpy`
- [Room activities](https://github.com/rildoreis/adescubrir/blob/main/game/05_capitulo2_cena1.rpy): `game/05_capitulo2_cena1.rpy`
- [Room mini-games](https://github.com/rildoreis/adescubrir/blob/main/game/06_capitulo2_cena2.rpy): `game/06_capitulo2_cena2.rpy`
- [Museum chapter](https://github.com/rildoreis/adescubrir/blob/main/game/07_capitulo3.rpy): `game/07_capitulo3.rpy`
- [Chapter four](https://github.com/rildoreis/adescubrir/blob/main/game/08_capitulo4.rpy): `game/08_capitulo4.rpy`

### Game assets

- [Narration and effects](https://github.com/rildoreis/adescubrir/tree/main/game/audio): `game/audio`
- [Character and scene art](https://github.com/rildoreis/adescubrir/tree/main/game/images): `game/images`

### Other components

- **Player**

## Connections

- Player → Game entry: starts game
- Game entry → Screens and UI: shows interface
- Game entry → Definitions and state: uses definitions
- Game entry → Prologue: starts story
- Prologue → Avatar calibration: continues to
- Room activities → Room mini-games: continues to
- Prologue → Narration and effects: uses narration
- Avatar calibration → Narration and effects: uses narration
- Room activities → Narration and effects: uses narration
- Room mini-games → Narration and effects: uses narration
- Museum chapter → Narration and effects: uses narration
- Chapter four → Narration and effects: uses narration
- Prologue → Character and scene art: uses artwork
- Avatar calibration → Character and scene art: uses artwork
- Room activities → Character and scene art: uses artwork
- Room mini-games → Character and scene art: uses artwork
- Museum chapter → Character and scene art: uses artwork
- Chapter four → Character and scene art: uses artwork