# chipsentinel/matamounstruos-app architecture

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

- Interactive diagram: https://gitdiagram.com/chipsentinel/matamounstruos-app
- Repository: https://github.com/chipsentinel/matamounstruos-app

## Overview

Matamounstruos is an educational web app for organizing users, barajas, cartas, and theory tarjetas, with a draw-and-review game flow. Users navigate React views, manage content through a shared API client, and can draw a random carta; non-APTO results lead to a random tarjeta from that baraja. Express routes dispatch requests to domain controllers, which query MariaDB. The graph preserves the README’s management, validation, and learning capabilities. Some controller and view details are indexed but not excerpted, so edges involving them rely on indexed references or README statements.

Main entry points: [`frontend/src/App.jsx`](https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/App.jsx) (App navigation), [`backend/src/routes`](https://github.com/chipsentinel/matamounstruos-app/tree/main/backend/src/routes) (Route dispatch), [`backend/src/config/db.js`](https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/config/db.js) (MariaDB pool), [`frontend/src/services/api.js`](https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/services/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_react_app["App navigation<br/>[App.jsx]"]
  node_navbar["Navbar<br/>[Navbar.jsx]"]
  node_user_view["User access<br/>[CardUsuario.jsx]"]
  node_home_view["Home view<br/>[HomeView.jsx]"]
  node_baraja_view["Baraja management<br/>[BarajaView.jsx]"]
  node_carta_view["Carta management<br/>[CartaView.jsx]"]
  node_tematica_view["Theory cards<br/>[TematicaView.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_backend["API and domain"]
  node_express_app["Express server<br/>[app.js]"]
  node_route_dispatch["Route dispatch"]
  node_usuarios["User operations"]
  node_barajas["Baraja operations"]
  node_cartas["Carta operations<br/>[cartaController.js]"]
  node_tarjetas["Tarjeta operations"]
  node_health["DB health check"]
end

subgraph group_data["Persistent data"]
  node_db_pool["MariaDB pool<br/>[db.js]"]
  node_mariadb[("MariaDB<br/>[schema.sql]")]
end

subgraph group_game["Learning game"]
  node_juego_view["Game view<br/>[JuegoView.jsx]"]
  node_juego["Game logic<br/>[juegoController.js]"]
end

node_visitor(("Visitor"))

node_visitor -->|"uses"| node_react_app
node_react_app -->|"renders"| node_navbar
node_react_app -->|"routes to"| node_user_view
node_react_app -->|"routes to"| node_home_view
node_react_app -->|"routes to"| node_baraja_view
node_react_app -->|"routes to"| node_carta_view
node_react_app -->|"routes to"| node_tematica_view
node_react_app -->|"routes to"| node_juego_view
node_user_view -->|"requests users"| node_api_client
node_baraja_view -->|"requests barajas"| node_api_client
node_carta_view -->|"requests cartas"| node_api_client
node_tematica_view -->|"requests tarjetas"| node_api_client
node_juego_view -->|"requests draws"| node_api_client
node_api_client -->|"HTTP requests"| node_express_app
node_express_app -->|"mounts routes"| node_route_dispatch
node_route_dispatch -->|"dispatches"| node_usuarios
node_route_dispatch -->|"dispatches"| node_barajas
node_route_dispatch -->|"dispatches"| node_cartas
node_route_dispatch -->|"dispatches"| node_tarjetas
node_route_dispatch -->|"dispatches"| node_health
node_route_dispatch -->|"dispatches"| node_juego
node_usuarios -->|"queries"| node_db_pool
node_barajas -->|"queries"| node_db_pool
node_cartas -->|"queries"| node_db_pool
node_tarjetas -->|"queries"| node_db_pool
node_health -->|"checks connection"| node_db_pool
node_juego -->|"selects draws"| node_db_pool
node_db_pool -->|"connects to"| node_mariadb
node_juego_view -->|"draw workflow"| node_juego
node_barajas -->|"deletes associated"| node_cartas
node_barajas -->|"deletes associated"| node_tarjetas
node_juego -->|"selects random"| node_cartas
node_juego -->|"selects review"| node_tarjetas

click node_react_app "https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/App.jsx"
click node_navbar "https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/components/Navbar.jsx"
click node_user_view "https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/components/CardUsuario.jsx"
click node_home_view "https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/views/HomeView.jsx"
click node_baraja_view "https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/views/BarajaView.jsx"
click node_carta_view "https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/views/CartaView.jsx"
click node_tematica_view "https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/views/TematicaView.jsx"
click node_juego_view "https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/views/JuegoView.jsx"
click node_api_client "https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/services/api.js"
click node_express_app "https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/app.js"
click node_route_dispatch "https://github.com/chipsentinel/matamounstruos-app/tree/main/backend/src/routes"
click node_usuarios "https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/controllers/usuarioController.js"
click node_barajas "https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/controllers/barajaController.js"
click node_cartas "https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/controllers/cartaController.js"
click node_tarjetas "https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/controllers/tarjetaController.js"
click node_health "https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/controllers/healthController.js"
click node_juego "https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/controllers/juegoController.js"
click node_db_pool "https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/config/db.js"
click node_mariadb "https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/db/schema.sql"

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_react_app,node_navbar,node_user_view,node_home_view,node_baraja_view,node_carta_view,node_tematica_view,node_api_client toneBlue
class node_express_app,node_route_dispatch,node_usuarios,node_barajas,node_cartas,node_tarjetas,node_health toneAmber
class node_db_pool,node_mariadb toneMint
class node_juego_view,node_juego toneRose
class node_visitor toneIndigo
```

## Components

### Web interface

- [App navigation](https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Navbar](https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/components/Navbar.jsx): `frontend/src/components/Navbar.jsx`
- [User access](https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/components/CardUsuario.jsx): `frontend/src/components/CardUsuario.jsx`
- [Home view](https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/views/HomeView.jsx): `frontend/src/views/HomeView.jsx`
- [Baraja management](https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/views/BarajaView.jsx): `frontend/src/views/BarajaView.jsx`
- [Carta management](https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/views/CartaView.jsx): `frontend/src/views/CartaView.jsx`
- [Theory cards](https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/views/TematicaView.jsx): `frontend/src/views/TematicaView.jsx`
- [API client](https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### API and domain

- [Express server](https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/app.js): `backend/src/app.js`
- [Route dispatch](https://github.com/chipsentinel/matamounstruos-app/tree/main/backend/src/routes): `backend/src/routes`
- [User operations](https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/controllers/usuarioController.js): `backend/src/controllers/usuarioController.js`
- [Baraja operations](https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/controllers/barajaController.js): `backend/src/controllers/barajaController.js`
- [Carta operations](https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/controllers/cartaController.js): `backend/src/controllers/cartaController.js`
- [Tarjeta operations](https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/controllers/tarjetaController.js): `backend/src/controllers/tarjetaController.js`
- [DB health check](https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/controllers/healthController.js): `backend/src/controllers/healthController.js`

### Persistent data

- [MariaDB pool](https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/config/db.js): `backend/src/config/db.js`
- [MariaDB](https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/db/schema.sql): `backend/db/schema.sql`

### Learning game

- [Game view](https://github.com/chipsentinel/matamounstruos-app/blob/main/frontend/src/views/JuegoView.jsx): `frontend/src/views/JuegoView.jsx`
- [Game logic](https://github.com/chipsentinel/matamounstruos-app/blob/main/backend/src/controllers/juegoController.js): `backend/src/controllers/juegoController.js`

### Other components

- **Visitor**

## Connections

- Visitor → App navigation: uses (evidence: `README.md`)
- App navigation → Navbar: renders (evidence: `frontend/src/App.jsx`)
- App navigation → User access: routes to (evidence: `frontend/src/App.jsx`)
- App navigation → Home view: routes to (evidence: `frontend/src/App.jsx`)
- App navigation → Baraja management: routes to (evidence: `frontend/src/App.jsx`)
- App navigation → Carta management: routes to (evidence: `frontend/src/App.jsx`)
- App navigation → Theory cards: routes to (evidence: `frontend/src/App.jsx`)
- App navigation → Game view: routes to (evidence: `frontend/src/App.jsx`)
- User access → API client: requests users (evidence: `frontend/src/components/CardUsuario.jsx`)
- Baraja management → API client: requests barajas (evidence: `frontend/src/views/BarajaView.jsx`)
- Carta management → API client: requests cartas (evidence: `frontend/src/views/CartaView.jsx`)
- Theory cards → API client: requests tarjetas (evidence: `frontend/src/views/TematicaView.jsx`)
- Game view → API client: requests draws (evidence: `frontend/src/views/JuegoView.jsx`)
- API client → Express server: HTTP requests (evidence: `frontend/src/services/api.js`)
- Express server → Route dispatch: mounts routes (evidence: `backend/src/app.js`)
- Route dispatch → User operations: dispatches (evidence: `backend/src/routes/usuarioRoutes.js`)
- Route dispatch → Baraja operations: dispatches (evidence: `backend/src/routes/barajaRoutes.js`)
- Route dispatch → Carta operations: dispatches (evidence: `backend/src/routes/cartaRoutes.js`)
- Route dispatch → Tarjeta operations: dispatches (evidence: `backend/src/routes/tarjetaRoutes.js`)
- Route dispatch → DB health check: dispatches (evidence: `backend/src/routes/healthRoutes.js`)
- Route dispatch → Game logic: dispatches (evidence: `backend/src/routes/juegoRoutes.js`)
- User operations → MariaDB pool: queries (evidence: `backend/src/controllers/usuarioController.js`)
- Baraja operations → MariaDB pool: queries (evidence: `backend/src/controllers/barajaController.js`)
- Carta operations → MariaDB pool: queries (evidence: `backend/src/controllers/cartaController.js`)
- Tarjeta operations → MariaDB pool: queries (evidence: `backend/src/controllers/tarjetaController.js`)
- DB health check → MariaDB pool: checks connection (evidence: `backend/src/controllers/healthController.js`)
- Game logic → MariaDB pool: selects draws (evidence: `backend/src/controllers/juegoController.js`)
- MariaDB pool → MariaDB: connects to (evidence: `backend/src/config/db.js`)
- Game view → Game logic: draw workflow
- Baraja operations → Carta operations: deletes associated (evidence: `backend/src/controllers/barajaController.js`)
- Baraja operations → Tarjeta operations: deletes associated (evidence: `backend/src/controllers/barajaController.js`)
- Game logic → Carta operations: selects random (evidence: `backend/src/controllers/juegoController.js`)
- Game logic → Tarjeta operations: selects review (evidence: `backend/src/controllers/juegoController.js`)
