# molinarix/blackjack-vite architecture

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

- Interactive diagram: https://gitdiagram.com/molinarix/blackjack-vite
- Repository: https://github.com/molinarix/blackjack-vite

## Overview

This is a browser-based Blackjack game. A player requests or stops drawing, the game updates the player’s hand, and the computer takes its turn to determine the winner; starting a new game resets the round. The central controller owns the UI events and coordinates separate deck, draw, scoring, card-rendering, and computer-turn logic. README describes running and building the app but no additional gameplay capabilities. The graph reflects the shown source; no external service or persistent store is present.

Main entry points: [`src/blackjack/index.js`](https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/index.js) (Game Controller), [`src/blackjack/usecases/turno-computadora.js`](https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/turno-computadora.js) (Computer Turn), [`src/blackjack/usecases/crear-carta-html.js`](https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/crear-carta-html.js) (Card Renderer), [`src/blackjack/usecases/pedir-carta.js`](https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/pedir-carta.js) (Draw Card)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_game["Game Control"]
  node_controller["Game Controller<br/>[index.js]"]
  node_computer["Computer Turn"]
end

subgraph group_logic["Card Logic"]
  node_deck["Deck Builder<br/>[crear-deck.js]"]
  node_draw["Draw Card<br/>[pedir-carta.js]"]
  node_score["Card Scoring<br/>[valor-carta.js]"]
end

subgraph group_ui["Browser UI"]
  node_render["Card Renderer"]
  node_browser["Game Page<br/>[index.html]"]
  node_assets["Card Images"]
end

node_player(("Player"))

node_player -->|"plays via"| node_controller
node_controller -->|"creates deck"| node_deck
node_controller -->|"draws card"| node_draw
node_controller -->|"scores card"| node_score
node_controller -->|"renders card"| node_render
node_controller -->|"starts turn"| node_computer
node_computer -->|"draws card"| node_draw
node_computer -->|"scores card"| node_score
node_computer -->|"renders card"| node_render
node_controller -->|"updates UI"| node_browser
node_computer -->|"reports result"| node_browser
node_render -->|"sets image path"| node_assets

click node_controller "https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/index.js"
click node_deck "https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/crear-deck.js"
click node_draw "https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/pedir-carta.js"
click node_score "https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/valor-carta.js"
click node_computer "https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/turno-computadora.js"
click node_render "https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/crear-carta-html.js"
click node_browser "https://github.com/molinarix/blackjack-vite/blob/main/index.html"
click node_assets "https://github.com/molinarix/blackjack-vite/tree/main/public/assets/cartas"

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_controller,node_computer toneBlue
class node_deck,node_draw,node_score toneAmber
class node_render,node_browser,node_assets toneMint
class node_player toneIndigo
```

## Components

### Game Control

- [Game Controller](https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/index.js): `src/blackjack/index.js`
- [Computer Turn](https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/turno-computadora.js): `src/blackjack/usecases/turno-computadora.js`

### Card Logic

- [Deck Builder](https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/crear-deck.js): `src/blackjack/usecases/crear-deck.js`
- [Draw Card](https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/pedir-carta.js): `src/blackjack/usecases/pedir-carta.js`
- [Card Scoring](https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/valor-carta.js): `src/blackjack/usecases/valor-carta.js`

### Browser UI

- [Card Renderer](https://github.com/molinarix/blackjack-vite/blob/main/src/blackjack/usecases/crear-carta-html.js): `src/blackjack/usecases/crear-carta-html.js`
- [Game Page](https://github.com/molinarix/blackjack-vite/blob/main/index.html): `index.html`
- [Card Images](https://github.com/molinarix/blackjack-vite/tree/main/public/assets/cartas): `public/assets/cartas`

### Other components

- **Player**

## Connections

- Player → Game Controller: plays via (evidence: `src/blackjack/index.js`)
- Game Controller → Deck Builder: creates deck (evidence: `src/blackjack/index.js`)
- Game Controller → Draw Card: draws card (evidence: `src/blackjack/index.js`)
- Game Controller → Card Scoring: scores card (evidence: `src/blackjack/index.js`)
- Game Controller → Card Renderer: renders card (evidence: `src/blackjack/index.js`)
- Game Controller → Computer Turn: starts turn (evidence: `src/blackjack/index.js`)
- Computer Turn → Draw Card: draws card (evidence: `src/blackjack/usecases/turno-computadora.js`)
- Computer Turn → Card Scoring: scores card (evidence: `src/blackjack/usecases/turno-computadora.js`)
- Computer Turn → Card Renderer: renders card (evidence: `src/blackjack/usecases/turno-computadora.js`)
- Game Controller → Game Page: updates UI (evidence: `src/blackjack/index.js`)
- Computer Turn → Game Page: reports result (evidence: `src/blackjack/usecases/turno-computadora.js`)
- Card Renderer → Card Images: sets image path (evidence: `src/blackjack/usecases/crear-carta-html.js`)
