# josevalverde/against-the-darkmaster-generador-pj architecture

> Architecture diagram of the GitHub repository josevalverde/against-the-darkmaster-generador-pj, 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/josevalverde/against-the-darkmaster-generador-pj
- Repository: https://github.com/josevalverde/against-the-darkmaster-generador-pj

## Overview

Es un generador web de personajes de Against the Darkmaster. El flujo principal va del jugador por los siete pasos del asistente; la interfaz mantiene el personaje y el motor aplica reglas para producir una hoja calculada, revisar problemas y generar la hoja imprimible. También se muestran la generación aleatoria, la progresión, la magia y el equipo, junto con las funciones de mesa y guardado. Las conexiones se basan en el README y las referencias visibles del índice; algunas capacidades documentadas tienen implementación no muestreada.

Main entry points: [`js/ui/app.js`](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/app.js) (Aplicación), [`js/engine/aleatorio.js`](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/aleatorio.js) (Generación aleatoria), [`js/engine/calculo.js`](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/calculo.js) (Cálculo y validación), [`js/ui/biblioteca.js`](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/biblioteca.js) (Biblioteca local)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creation["Creación guiada"]
  node_app["Aplicación<br/>[app.js]"]
  node_characteristics["Características<br/>[caracteristicas.js]"]
  node_lineage["Linaje y cultura<br/>[linaje.js]"]
  node_vocation["Vocación y habilidades<br/>[vocacion.js]"]
  node_backgrounds["Trasfondos y equipo<br/>[trasfondos.js]"]
  node_derived["Atributos derivados<br/>[derivados.js]"]
  node_passions["Pasiones<br/>[pasiones.js]"]
  node_name["Nombre<br/>[nombre.js]"]
end

subgraph group_rules["Motor y reglas"]
  node_data["Datos de reglas"]
  node_model["Modelo de personaje<br/>[modelo.js]"]
  node_rulesformulas["Fórmulas<br/>[reglas.js]"]
  node_calculation["Cálculo y validación<br/>[calculo.js]"]
  node_random["Generación aleatoria<br/>[aleatorio.js]"]
  node_equipment["Equipo y sortilegios<br/>[equipo.js]"]
  node_progression["Progresión de nivel<br/>[progresion.js]"]
end

subgraph group_output["Salida y progreso"]
  node_summary["Resumen de personaje<br/>[resumen.js]"]
  node_print["Hoja imprimible<br/>[hoja.js]"]
end

subgraph group_persistence["Mesa y biblioteca"]
  node_table["Configuración de mesa<br/>[mesa.js]"]
  node_library["Biblioteca local<br/>[biblioteca.js]"]
  node_state["Estado y borrador<br/>[estado.js]"]
end

node_player(("Jugador"))
node_browser[("Almacenamiento navegador")]

node_player -->|"edita personaje"| node_app
node_app -->|"carga reglas"| node_data
node_app -->|"recupera borrador"| node_state
node_app -->|"muestra paso"| node_characteristics
node_app -->|"muestra paso"| node_lineage
node_app -->|"muestra paso"| node_vocation
node_app -->|"muestra paso"| node_backgrounds
node_app -->|"muestra paso"| node_derived
node_app -->|"muestra paso"| node_passions
node_app -->|"muestra paso"| node_name
node_app -->|"rehace paso"| node_random
node_characteristics -->|"actualiza personaje"| node_app
node_lineage -->|"actualiza personaje"| node_app
node_vocation -->|"gestiona niveles"| node_progression
node_backgrounds -->|"elige equipo"| node_equipment
node_app -->|"calcula hoja"| node_calculation
node_calculation -->|"usa modelo"| node_model
node_calculation -->|"aplica fórmulas"| node_rulesformulas
node_calculation -->|"calcula equipo y magia"| node_equipment
node_random -->|"valida generación"| node_calculation
node_random -->|"crea personaje"| node_model
node_random -->|"consulta tiradas"| node_rulesformulas
node_random -->|"deriva atuendo"| node_equipment
node_app -->|"pinta resumen"| node_summary
node_app -->|"ofrece hoja"| node_print
node_player -->|"configura mesa"| node_table
node_table -->|"guarda configuración"| node_state
node_player -->|"guarda o carga"| node_library
node_library -->|"persiste personajes"| node_browser
node_state -.->|"guarda borrador"| node_browser
node_library -->|"importa personaje"| node_app

click node_app "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/app.js"
click node_characteristics "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/caracteristicas.js"
click node_lineage "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/linaje.js"
click node_vocation "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/vocacion.js"
click node_backgrounds "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/trasfondos.js"
click node_derived "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/derivados.js"
click node_passions "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/pasiones.js"
click node_name "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/nombre.js"
click node_data "https://github.com/josevalverde/against-the-darkmaster-generador-pj/tree/main/data"
click node_model "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/modelo.js"
click node_rulesformulas "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/reglas.js"
click node_calculation "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/calculo.js"
click node_random "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/aleatorio.js"
click node_equipment "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/equipo.js"
click node_progression "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/progresion.js"
click node_summary "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/resumen.js"
click node_print "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/hoja.js"
click node_table "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/mesa.js"
click node_library "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/biblioteca.js"
click node_state "https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/estado.js"

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_app,node_characteristics,node_lineage,node_vocation,node_backgrounds,node_derived,node_passions,node_name toneBlue
class node_data,node_model,node_rulesformulas,node_calculation,node_random,node_equipment,node_progression,node_browser toneAmber
class node_summary,node_print toneMint
class node_table,node_library,node_state toneRose
class node_player toneIndigo
```

## Components

### Creación guiada

- [Aplicación](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/app.js): `js/ui/app.js`
- [Características](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/caracteristicas.js): `js/ui/pasos/caracteristicas.js`
- [Linaje y cultura](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/linaje.js): `js/ui/pasos/linaje.js`
- [Vocación y habilidades](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/vocacion.js): `js/ui/pasos/vocacion.js`
- [Trasfondos y equipo](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/trasfondos.js): `js/ui/pasos/trasfondos.js`
- [Atributos derivados](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/derivados.js): `js/ui/pasos/derivados.js`
- [Pasiones](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/pasiones.js): `js/ui/pasos/pasiones.js`
- [Nombre](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/pasos/nombre.js): `js/ui/pasos/nombre.js`

### Motor y reglas

- [Datos de reglas](https://github.com/josevalverde/against-the-darkmaster-generador-pj/tree/main/data): `data`
- [Modelo de personaje](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/modelo.js): `js/engine/modelo.js`
- [Fórmulas](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/reglas.js): `js/engine/reglas.js`
- [Cálculo y validación](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/calculo.js): `js/engine/calculo.js`
- [Generación aleatoria](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/aleatorio.js): `js/engine/aleatorio.js`
- [Equipo y sortilegios](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/equipo.js): `js/engine/equipo.js`
- [Progresión de nivel](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/engine/progresion.js): `js/engine/progresion.js`

### Salida y progreso

- [Resumen de personaje](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/resumen.js): `js/ui/resumen.js`
- [Hoja imprimible](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/hoja.js): `js/ui/hoja.js`

### Mesa y biblioteca

- [Configuración de mesa](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/mesa.js): `js/ui/mesa.js`
- [Biblioteca local](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/biblioteca.js): `js/ui/biblioteca.js`
- [Estado y borrador](https://github.com/josevalverde/against-the-darkmaster-generador-pj/blob/main/js/ui/estado.js): `js/ui/estado.js`

### Other components

- **Jugador**
- **Almacenamiento navegador**

## Connections

- Jugador → Aplicación: edita personaje (evidence: `README.md`)
- Aplicación → Datos de reglas: carga reglas (evidence: `js/ui/app.js`)
- Aplicación → Estado y borrador: recupera borrador (evidence: `js/ui/app.js`)
- Aplicación → Características: muestra paso (evidence: `js/ui/app.js`)
- Aplicación → Linaje y cultura: muestra paso (evidence: `js/ui/app.js`)
- Aplicación → Vocación y habilidades: muestra paso (evidence: `js/ui/app.js`)
- Aplicación → Trasfondos y equipo: muestra paso (evidence: `js/ui/app.js`)
- Aplicación → Atributos derivados: muestra paso (evidence: `js/ui/app.js`)
- Aplicación → Pasiones: muestra paso (evidence: `js/ui/app.js`)
- Aplicación → Nombre: muestra paso (evidence: `js/ui/app.js`)
- Aplicación → Generación aleatoria: rehace paso (evidence: `js/ui/app.js`)
- Características → Aplicación: actualiza personaje (evidence: `README.md`)
- Linaje y cultura → Aplicación: actualiza personaje (evidence: `README.md`)
- Vocación y habilidades → Progresión de nivel: gestiona niveles (evidence: `js/ui/pasos/vocacion.js`)
- Trasfondos y equipo → Equipo y sortilegios: elige equipo (evidence: `js/ui/pasos/trasfondos.js`)
- Aplicación → Cálculo y validación: calcula hoja (evidence: `js/ui/app.js`)
- Cálculo y validación → Modelo de personaje: usa modelo (evidence: `js/engine/calculo.js`)
- Cálculo y validación → Fórmulas: aplica fórmulas (evidence: `js/engine/calculo.js`)
- Cálculo y validación → Equipo y sortilegios: calcula equipo y magia (evidence: `js/engine/calculo.js`)
- Generación aleatoria → Cálculo y validación: valida generación (evidence: `js/engine/aleatorio.js`)
- Generación aleatoria → Modelo de personaje: crea personaje (evidence: `js/engine/aleatorio.js`)
- Generación aleatoria → Fórmulas: consulta tiradas (evidence: `js/engine/aleatorio.js`)
- Generación aleatoria → Equipo y sortilegios: deriva atuendo (evidence: `js/engine/aleatorio.js`)
- Aplicación → Resumen de personaje: pinta resumen (evidence: `js/ui/app.js`)
- Aplicación → Hoja imprimible: ofrece hoja (evidence: `js/ui/app.js`)
- Jugador → Configuración de mesa: configura mesa (evidence: `README.md`)
- Configuración de mesa → Estado y borrador: guarda configuración (evidence: `js/ui/app.js`)
- Jugador → Biblioteca local: guarda o carga (evidence: `README.md`)
- Biblioteca local → Almacenamiento navegador: persiste personajes (evidence: `README.md`)
- Estado y borrador → Almacenamiento navegador: guarda borrador
- Biblioteca local → Aplicación: importa personaje (evidence: `js/ui/biblioteca.js`)
