# luisfer-king/juego21cartas architecture

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

## Overview

Es una aplicación de escritorio Tkinter para realizar el truco de las 21 cartas y enseñar paso a paso por qué funciona. El flujo principal va desde iniciar una partida y, en su caso, marcar una carta, hasta elegir su columna en tres rondas, recoger los paquetes y revelar la carta en la posición 11. La demostración añade reparto gradual, seguimiento de candidatas, explicación del código, mazo final y retroceso. Los vínculos se basan en el README y los archivos fuente excerptados.

Main entry points: [`interfaz.py`](https://github.com/luisfer-king/juego21cartas/blob/master/interfaz.py) (Control de partida), [`mesa.py`](https://github.com/luisfer-king/juego21cartas/blob/master/mesa.py) (Mesa y cartas), [`juego.py`](https://github.com/luisfer-king/juego21cartas/blob/master/juego.py) (Estado y rondas), [`main.py`](https://github.com/luisfer-king/juego21cartas/blob/master/main.py) (Arranque Tkinter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Interfaz y mesa"]
  node_launcher["Arranque Tkinter<br/>[main.py]"]
  node_controller["Control de partida<br/>[interfaz.py]"]
  node_board["Mesa y cartas<br/>[mesa.py]"]
end

subgraph group_game["Lógica del truco"]
  node_deck["Mazo aleatorio<br/>[juego.py]"]
  node_round["Estado y rondas<br/>[juego.py]"]
  node_deal["Reparto en columnas<br/>[juego.py]"]
  node_collect["Recogida ordenada<br/>[juego.py]"]
  node_result["Carta revelada<br/>[juego.py]"]
end

node_player(("Jugador"))
node_tk["Tkinter"]

node_player -->|"inicia juego"| node_launcher
node_launcher -->|"crea ventana"| node_controller
node_controller -->|"ejecuta eventos"| node_tk
node_controller -->|"crea mazo"| node_deck
node_controller -->|"inicia y avanza"| node_round
node_controller -->|"actualiza vista"| node_board
node_board -->|"reparte para dibujar"| node_deal
node_player -->|"marca carta"| node_board
node_board -->|"envía selección"| node_controller
node_controller -->|"valida elección"| node_round
node_round -->|"obtiene columnas"| node_deal
node_round -->|"agrupa mazo"| node_collect
node_controller -->|"retrocede estado"| node_round
node_board -->|"muestra posición 11"| node_result
node_player -->|"elige modo"| node_controller

click node_launcher "https://github.com/luisfer-king/juego21cartas/blob/master/main.py"
click node_controller "https://github.com/luisfer-king/juego21cartas/blob/master/interfaz.py"
click node_board "https://github.com/luisfer-king/juego21cartas/blob/master/mesa.py"
click node_deck "https://github.com/luisfer-king/juego21cartas/blob/master/juego.py"
click node_round "https://github.com/luisfer-king/juego21cartas/blob/master/juego.py"
click node_deal "https://github.com/luisfer-king/juego21cartas/blob/master/juego.py"
click node_collect "https://github.com/luisfer-king/juego21cartas/blob/master/juego.py"
click node_result "https://github.com/luisfer-king/juego21cartas/blob/master/juego.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_launcher,node_controller,node_board toneBlue
class node_deck,node_round,node_deal,node_collect,node_result toneAmber
class node_player,node_tk toneIndigo
```

## Components

### Interfaz y mesa

- [Arranque Tkinter](https://github.com/luisfer-king/juego21cartas/blob/master/main.py): `main.py`
- [Control de partida](https://github.com/luisfer-king/juego21cartas/blob/master/interfaz.py): `interfaz.py`
- [Mesa y cartas](https://github.com/luisfer-king/juego21cartas/blob/master/mesa.py): `mesa.py`

### Lógica del truco

- [Mazo aleatorio](https://github.com/luisfer-king/juego21cartas/blob/master/juego.py): `juego.py`
- [Estado y rondas](https://github.com/luisfer-king/juego21cartas/blob/master/juego.py): `juego.py`
- [Reparto en columnas](https://github.com/luisfer-king/juego21cartas/blob/master/juego.py): `juego.py`
- [Recogida ordenada](https://github.com/luisfer-king/juego21cartas/blob/master/juego.py): `juego.py`
- [Carta revelada](https://github.com/luisfer-king/juego21cartas/blob/master/juego.py): `juego.py`

### Other components

- **Jugador**
- **Tkinter**

## Connections

- Jugador → Arranque Tkinter: inicia juego (evidence: `README.md`)
- Arranque Tkinter → Control de partida: crea ventana (evidence: `main.py`)
- Control de partida → Tkinter: ejecuta eventos
- Control de partida → Mazo aleatorio: crea mazo (evidence: `interfaz.py`)
- Control de partida → Estado y rondas: inicia y avanza (evidence: `interfaz.py`)
- Control de partida → Mesa y cartas: actualiza vista (evidence: `interfaz.py`)
- Mesa y cartas → Reparto en columnas: reparte para dibujar (evidence: `mesa.py`)
- Jugador → Mesa y cartas: marca carta (evidence: `mesa.py`)
- Mesa y cartas → Control de partida: envía selección (evidence: `interfaz.py`)
- Control de partida → Estado y rondas: valida elección (evidence: `interfaz.py`)
- Estado y rondas → Reparto en columnas: obtiene columnas (evidence: `juego.py`)
- Estado y rondas → Recogida ordenada: agrupa mazo (evidence: `juego.py`)
- Control de partida → Estado y rondas: retrocede estado (evidence: `interfaz.py`)
- Mesa y cartas → Carta revelada: muestra posición 11 (evidence: `mesa.py`)
- Jugador → Control de partida: elige modo (evidence: `README.md`)
