# casasdev/terrivial architecture

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

## Overview

Terrivial is an Android trivia game with question categories, player/game state, power-ups and a casino of mini-games. The apparent user journey is entering the app, answering category questions and optionally using power-ups or playing mini-games. The tree supports these product areas, but no README or application source excerpts were provided; the connections below are therefore tentative and have no evidence path. The tree alone does not establish detailed runtime calls or data flow.

Main entry points: [`app/src/main/java/com/example/terrivial/vista/MainActivity2.kt`](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/MainActivity2.kt) (Game screen), [`app/src/main/java/com/example/terrivial/vista/Respondeme.kt`](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/Respondeme.kt) (Answer screen), [`app/src/main/java/com/example/terrivial/modelo/Categoria.java`](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Categoria.java) (Category model), [`app/src/main/java/com/example/terrivial/vista/casino/JuegoView.kt`](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/JuegoView.kt) (Mini-game view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Trivia gameplay"]
  node_main["Main screen<br/>[MainActivity.kt]"]
  node_main2["Game screen<br/>[MainActivity2.kt]"]
  node_answer["Answer screen<br/>[Respondeme.kt]"]
  node_correct["Correct answer"]
  node_skip["Skip question<br/>[PasarPregunta.kt]"]
  node_strategy["Answer strategy<br/>[Strategy.kt]"]
end

subgraph group_domain["Game domain"]
  node_match["Match state<br/>[Partida.java]"]
  node_player["Player state<br/>[Jugador.java]"]
  node_question["Question<br/>[Pregunta.java]"]
  node_category["Category model<br/>[Categoria.java]"]
  node_science["Science questions<br/>[Ciencia.java]"]
  node_entertainment["Entertainment questions"]
  node_geopolitics["Geopolitics questions<br/>[Geopolitica.java]"]
  node_question_assets["Question files"]
end

subgraph group_shop["Power-up shop"]
  node_boost["Power-up model<br/>[Potenciador.java]"]
  node_shop_screen["Power-up shop<br/>[Tienda.kt]"]
  node_shop_adapter["Shop display"]
end

subgraph group_casino["Casino mini-games"]
  node_casino_screen["Casino screen<br/>[Casino.kt]"]
  node_game_picker["Mini-game selector<br/>[JuegoFactory.kt]"]
  node_game_view["Mini-game view<br/>[JuegoView.kt]"]
  node_minigames["Mini-game models<br/>[Minijuegos.java]"]
  node_hangman_ui["Hangman screen<br/>[Ahorcadito.kt]"]
  node_number_ui["Number screen<br/>[AdivinaNumero.kt]"]
  node_battleship_ui["Battleship screen<br/>[BattleshipGUI.kt]"]
  node_battleship_model["Battleship model<br/>[Battleship.java]"]
end

node_user(("Player"))

node_user -.->|"opens app"| node_main
node_main -.->|"starts play"| node_main2
node_main2 -.->|"presents question"| node_answer
node_answer -.->|"answers"| node_question
node_answer -.->|"shows result"| node_correct
node_answer -.->|"may skip"| node_skip
node_main2 -.->|"uses state"| node_match
node_match -.->|"tracks player"| node_player
node_question -.->|"has category"| node_category
node_category -.->|"includes"| node_science
node_category -.->|"includes"| node_entertainment
node_category -.->|"includes"| node_geopolitics
node_question -.->|"draws from"| node_question_assets
node_main2 -.->|"opens shop"| node_shop_screen
node_shop_screen -.->|"offers"| node_boost
node_shop_screen -.->|"displays items"| node_shop_adapter
node_main -.->|"opens casino"| node_casino_screen
node_casino_screen -.->|"selects game"| node_game_picker
node_game_picker -.->|"presents game"| node_game_view
node_game_picker -.->|"uses models"| node_minigames
node_game_view -.->|"may launch"| node_hangman_ui
node_game_view -.->|"may launch"| node_number_ui
node_game_view -.->|"may launch"| node_battleship_ui
node_battleship_ui -.->|"uses model"| node_battleship_model

click node_main "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/MainActivity.kt"
click node_main2 "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/MainActivity2.kt"
click node_answer "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/Respondeme.kt"
click node_correct "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/RespuestaCorrecta.kt"
click node_skip "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/PasarPregunta.kt"
click node_strategy "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/Strategy.kt"
click node_match "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Partida.java"
click node_player "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Jugador.java"
click node_question "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Pregunta.java"
click node_category "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Categoria.java"
click node_science "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Ciencia.java"
click node_entertainment "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Entretenimiento.java"
click node_geopolitics "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Geopolitica.java"
click node_question_assets "https://github.com/casasdev/terrivial/tree/master/app/src/main/assets/Pregunticas"
click node_boost "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Potenciador.java"
click node_shop_screen "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/Tienda.kt"
click node_shop_adapter "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/AdapterRecyclerTienda.kt"
click node_casino_screen "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/Casino.kt"
click node_game_picker "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/JuegoFactory.kt"
click node_game_view "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/JuegoView.kt"
click node_minigames "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/casino/Minijuegos.java"
click node_hangman_ui "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/Ahorcadito.kt"
click node_number_ui "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/AdivinaNumero.kt"
click node_battleship_ui "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/BattleshipGUI.kt"
click node_battleship_model "https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/casino/battleship/Battleship.java"

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_main,node_main2,node_answer,node_correct,node_skip,node_strategy toneBlue
class node_match,node_player,node_question,node_category,node_science,node_entertainment,node_geopolitics,node_question_assets toneAmber
class node_boost,node_shop_screen,node_shop_adapter toneMint
class node_casino_screen,node_game_picker,node_game_view,node_minigames,node_hangman_ui,node_number_ui,node_battleship_ui,node_battleship_model toneRose
class node_user toneIndigo
```

## Components

### Trivia gameplay

- [Main screen](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/MainActivity.kt): `app/src/main/java/com/example/terrivial/vista/MainActivity.kt`
- [Game screen](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/MainActivity2.kt): `app/src/main/java/com/example/terrivial/vista/MainActivity2.kt`
- [Answer screen](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/Respondeme.kt): `app/src/main/java/com/example/terrivial/vista/Respondeme.kt`
- [Correct answer](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/RespuestaCorrecta.kt): `app/src/main/java/com/example/terrivial/vista/RespuestaCorrecta.kt`
- [Skip question](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/PasarPregunta.kt): `app/src/main/java/com/example/terrivial/vista/PasarPregunta.kt`
- [Answer strategy](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/Strategy.kt): `app/src/main/java/com/example/terrivial/vista/Strategy.kt`

### Game domain

- [Match state](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Partida.java): `app/src/main/java/com/example/terrivial/modelo/Partida.java`
- [Player state](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Jugador.java): `app/src/main/java/com/example/terrivial/modelo/Jugador.java`
- [Question](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Pregunta.java): `app/src/main/java/com/example/terrivial/modelo/Pregunta.java`
- [Category model](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Categoria.java): `app/src/main/java/com/example/terrivial/modelo/Categoria.java`
- [Science questions](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Ciencia.java): `app/src/main/java/com/example/terrivial/modelo/Ciencia.java`
- [Entertainment questions](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Entretenimiento.java): `app/src/main/java/com/example/terrivial/modelo/Entretenimiento.java`
- [Geopolitics questions](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Geopolitica.java): `app/src/main/java/com/example/terrivial/modelo/Geopolitica.java`
- [Question files](https://github.com/casasdev/terrivial/tree/master/app/src/main/assets/Pregunticas): `app/src/main/assets/Pregunticas`

### Power-up shop

- [Power-up model](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/Potenciador.java): `app/src/main/java/com/example/terrivial/modelo/Potenciador.java`
- [Power-up shop](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/Tienda.kt): `app/src/main/java/com/example/terrivial/vista/Tienda.kt`
- [Shop display](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/AdapterRecyclerTienda.kt): `app/src/main/java/com/example/terrivial/vista/AdapterRecyclerTienda.kt`

### Casino mini-games

- [Casino screen](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/Casino.kt): `app/src/main/java/com/example/terrivial/vista/casino/Casino.kt`
- [Mini-game selector](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/JuegoFactory.kt): `app/src/main/java/com/example/terrivial/vista/casino/JuegoFactory.kt`
- [Mini-game view](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/JuegoView.kt): `app/src/main/java/com/example/terrivial/vista/casino/JuegoView.kt`
- [Mini-game models](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/casino/Minijuegos.java): `app/src/main/java/com/example/terrivial/modelo/casino/Minijuegos.java`
- [Hangman screen](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/Ahorcadito.kt): `app/src/main/java/com/example/terrivial/vista/casino/Ahorcadito.kt`
- [Number screen](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/AdivinaNumero.kt): `app/src/main/java/com/example/terrivial/vista/casino/AdivinaNumero.kt`
- [Battleship screen](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/vista/casino/BattleshipGUI.kt): `app/src/main/java/com/example/terrivial/vista/casino/BattleshipGUI.kt`
- [Battleship model](https://github.com/casasdev/terrivial/blob/master/app/src/main/java/com/example/terrivial/modelo/casino/battleship/Battleship.java): `app/src/main/java/com/example/terrivial/modelo/casino/battleship/Battleship.java`

### Other components

- **Player**

## Connections

- Player → Main screen: opens app
- Main screen → Game screen: starts play
- Game screen → Answer screen: presents question
- Answer screen → Question: answers
- Answer screen → Correct answer: shows result
- Answer screen → Skip question: may skip
- Game screen → Match state: uses state
- Match state → Player state: tracks player
- Question → Category model: has category
- Category model → Science questions: includes
- Category model → Entertainment questions: includes
- Category model → Geopolitics questions: includes
- Question → Question files: draws from
- Game screen → Power-up shop: opens shop
- Power-up shop → Power-up model: offers
- Power-up shop → Shop display: displays items
- Main screen → Casino screen: opens casino
- Casino screen → Mini-game selector: selects game
- Mini-game selector → Mini-game view: presents game
- Mini-game selector → Mini-game models: uses models
- Mini-game view → Hangman screen: may launch
- Mini-game view → Number screen: may launch
- Mini-game view → Battleship screen: may launch
- Battleship screen → Battleship model: uses model
