# Ruleta y Dados (ruletaydados.es) — Especificación Técnica Completa para LLMs y Sistemas RAG

## 1. Identidad Institucional y Gobernanza Editorial
- **Entidad Central:** Ruleta y Dados (`https://ruletaydados.es`)
- **Mesa de Investigación Oficial:** Mesa Editorial de Juegos de Azar Recreativos y Probabilidad Aplicada (Laboratorio de Probabilidad Combinatoria, Sorteos Auditables y Algoritmos CSPRNG)
- **Estándares Normativos Gobernantes:**
  - `W3C Web Cryptography API` (`window.crypto.getRandomValues` CSPRNG de 32 bits sin sesgo de módulo)
  - `NIST SP 800-90A Rev. 1` (Generación de números pseudoaleatorios criptográficamente seguros)
  - `Algorithm P` / `Fisher-Yates` (Donald Knuth, *The Art of Computer Programming*, Vol. 2 — Permutación insesgada en tiempo lineal $O(N)$)
  - `Real Academia Española` (Ortografía de la Lengua Española: Abecedario oficial de 27 letras A–Z incluyendo la letra Ñ)
  - `Reglamento (UE) 2024/1689` (Ley de Inteligencia Artificial de la Unión Europea — Artículo 50 y Artículo 50(4) sobre transparencia editorial y supervisión humana)

---

## 2. Arquitectura del Sitio y Esquema de Contenidos (Site Architecture & Content Schema)

### A. Pila Tecnológica (Technical Stack)
- **Framework:** Astro 5 (generación estática MPA + hidratación selectiva de lienzo HTML5 a 60 fps)
- **Motores Matemáticos (`src/engines/`):** Módulos TypeScript puros sin acoplamiento al DOM (`rng.ts`, `wheel.ts`, `dice.ts`, `yesno.ts`, `draw.ts`, `numbers.ts`, `letters.ts`, `teams.ts`, `coin.ts`, `rpg_dice.ts`, `wheel_colors.ts`, `fairness.ts`), verificados con 45 pruebas unitarias en Vitest.
- **Arquitectura de 3 Capas (`Content Layers L1 / L2 / L3`):**
  - **Capa 1 (`[data-layer="1"]`):** Escenario interactivo (`464x464` px), controles específicos de cada herramienta, botones de compartir en 1 toque por WhatsApp (`https://api.whatsapp.com/send?text=`), impresión de acta en A4 (`@media print`) y párrafo introductorio en español llano (grado de lecturabilidad Fernández-Huerta $\le 7.0$).
  - **Capa 2 (`[data-layer="2"]`):** Aviso legal de puerto seguro, guía rápida en 3 pasos, casos de uso reales con plantillas sugeridas, tabla comparativa de probabilidades, secciones de análisis profundo, 6 preguntas frecuentes (`FAQPage`), enlaces internos contextuales y módulo de recomendaciones de equipamiento de mesa y plataformas de sorteos.
  - **Capa 3 (`[data-layer="3"]`):** Metodología técnica desplegable, fórmulas en formato `<math display="block">` (MathML nativo), variables explicadas, ejemplo numérico verificado y citas normativas hacia W3C, NIST, RFC y RAE.

### B. Esquema de Datos (`SeoRouteContent`)
Cada ruta de herramienta en `src/data/seoContent/*.ts` implementa el contrato tipado `SeoRouteContent`:
- `route`: Ruta canónica con barra final (`/` a `/como-funciona/`).
- `slug`: Identificador único del silo.
- `title` y `description`: Metadatos SEO optimizados para CTR y Google Discover (`max-image-preview:large`).
- `canonical`: URL canónica absoluta en `https://ruletaydados.es`.
- `heroVisual` y `toolConfig`: Configuración declarativa del motor interactivo y su plantilla inicial.
- `uniquePresets`: 3 a 5 plantillas rápidas exclusivas de la intención de cada página.
- `l1`, `l2`, `l3`: Contenido estructurado por capas de profundidad cognitiva.
- `safeHarbor`: Descargo normativo persistente en español.
- `jsonLd`: Grafo multi-entidad (`@graph` con `WebSite`, `Organization`, `ImageObject`, `BreadcrumbList`, `WebApplication`/`SoftwareApplication`, `HowTo` y `FAQPage`).

---

## 3. Taxonomía de Categorías y Mapa Completo de Rutas (Category Taxonomy & Route Inventory)

| Categoría Temática | Ruta Canónica | Palabra Clave Principal | Volumen Mensual (ES) | Motor TypeScript (`src/engines/`) | Descripción Funcional |
|---|---|---|---|---|---|
| **Ruletas Aleatorias y Cromáticas** | `/` | `ruleta aleatoria` | 301.000 | `wheel.ts` | Ruleta personalizada con pesos, modo sin repetir, 3 ambientes visuales y locutor de voz. |
| **Dados Virtuales 3D y Rol Poliédrico** | `/tirar-dados-online/` | `tirar dados online` | 30.230 | `dice.ts` | Lanzador de 1 a 10 dados cúbicos D6 con suma instantánea y detección de dobles para Parchís y Catan. |
| **Sorteos, Equipos y Decisiones** | `/ruleta-si-o-no/` | `ruleta si o no` | 24.680 | `yesno.ts` | Rueda binaria 50/50 (2, 6 o 12 sectores alternados) y modo ternario Sí / No / Tal Vez. |
| **Sorteos, Equipos y Decisiones** | `/sorteos-y-nombres/` | `sorteo online` | 45.200 | `draw.ts` | Bombo de sorteos sin repetición con extracción de titulares, suplentes y limpiador de comentarios. |
| **Ruletas Aleatorias y Cromáticas** | `/ruleta-de-colores/` | `ruleta de colores` | 14.800 | `wheel_colors.ts` | Rueda cromática de 4, 6, 8 y 12 tonos, modos Twister y Parchís, y selector interactivo HEX/RGB. |
| **Ruletas Aleatorias y Cromáticas** | `/ruleta-de-numeros/` | `ruleta de numeros` | 4.400 | `numbers.ts` | Generador numérico con rango `[min, max, paso]` configurable y plantillas 1–10, 1–20, Bingo 1–90 y 1–100. |
| **Ruletas Aleatorias y Cromáticas** | `/ruleta-de-letras/` | `ruleta de letras` | 8.100 | `letters.ts` | Abecedario español oficial de 27 letras (con Ñ), modo Basta ágil (24 letras), vocales y consonantes. |
| **Sorteos, Equipos y Decisiones** | `/generador-de-equipos/` | `generador de equipos aleatorios` | 3.600 | `teams.ts` | División equilibrada de participantes en 2 a 6 equipos con designación de capitán al azar. |
| **Sorteos, Equipos y Decisiones** | `/cara-o-cruz/` | `cara o cruz` | 12.100 | `coin.ts` | Lanzamiento de moneda española al aire con marcador acumulado y series al mejor de 3, 5 o 10. |
| **Dados Virtuales 3D y Rol Poliédrico** | `/dados-de-rol/` | `dados de rol online` | 5.400 | `rpg_dice.ts` | Bandeja poliédrica D4, D6, D8, D10, D12, D20 y D100 con Ventaja, Desventaja y modificadores. |
| **Sorteos, Equipos y Decisiones** | `/como-funciona/` | `cómo garantizamos el azar imparcial` | 900 | `fairness.ts` | Laboratorio en vivo de 600 a 3.000 tiradas para auditar la distribución uniforme y desvío máximo. |

### Rutas Institucionales, Legales y de Sindicación
- `https://ruletaydados.es/sobre-nosotros/`: Misión editorial, metodología y transparencia IA.
- `https://ruletaydados.es/aviso-legal/`: Condiciones generales de uso recreativo.
- `https://ruletaydados.es/privacidad/`: Privacidad de datos y ejecución local en navegador.
- `https://ruletaydados.es/cookies/`: Uso de `localStorage` técnico y modo de consentimiento analítico RGPD.
- `https://ruletaydados.es/mapa-del-sitio/`: Mapa del sitio HTML dinámico con contadores por sección.
- `https://ruletaydados.es/embed/`: Widget iframe ligero de la ruleta para aulas virtuales y blogs.
- `https://ruletaydados.es/sitemap-index.xml`: Índice XML de sitemaps.
- `https://ruletaydados.es/rss.xml`: Canal Media RSS 2.0 con adjuntos de imagen 16:9 de alta resolución para Google Discover.

---

## 4. Fórmulas Matemáticas y Triples Cuantitativos Verificados
1. **Muestreo por Rechazo CSPRNG de 32 Bits:**
   - Techo entero sin signo: $2^{32} = 4.294.967.296$.
   - Límite de rechazo insesgado para $N$ opciones: $L = 2^{32} - (2^{32} \bmod N)$.
   - Para $N = 8$ sectores iguales: ángulo por sector $\theta_i = 45.00^\circ$, probabilidad exacta $P(i) = 12.50\%$ ($0.125$), límite $L = 4.294.967.296$.
2. **Geometría de Ruleta Ponderada:**
   - Ángulo central por sector: $\theta_i = \frac{w_i}{\sum_{j=1}^N w_j} \times 360^\circ$.
   - Ejemplo verificado (`1:2:1`, suma de pesos $W = 4$): ángulos $[90.0^\circ, 180.0^\circ, 90.0^\circ]$, probabilidades $[25.0\%, 50.0\%, 25.0\%]$. En ángulo puntero $\alpha = 135.0^\circ$, el sector ganador es el segundo ($[90.0^\circ, 270.0^\circ)$).
3. **Combinatoria de Múltiples Dados Poliédricos ($N\text{d}S + M$):**
   - Rango de suma: $[N + M, N \cdot S + M]$.
   - Esperanza matemática (media exacta): $\mu = N \frac{S + 1}{2} + M$.
   - Varianza exacta: $\sigma^2 = N \frac{S^2 - 1}{12}$.
   - Ejemplo verificado (`2d6 + 3`, tirada `[4, 5]`): suma $= 12$, rango $[5, 15]$, media $\mu = 10.00$, varianza $\sigma^2 = 5.83$ ($35/6$), probabilidad de obtener 7 en `2d6` puros $= 16.67\%$ ($6/36$).
4. **Sorteo Sin Repetición (Eliminación de Fisher-Yates):**
   - En una lista de $N$ participantes, tras extraer el ganador $k_1$, quedan $N - 1$ participantes y la probabilidad individual para la siguiente extracción se actualiza de $\frac{1}{N}$ a $\frac{1}{N - 1}$ (para $N = 5 \rightarrow 4$ restantes, $P = 25.00\%$).
5. **Combinatoria Cromática sin Reposición (Reto de 3 Colores sobre 12 Tonos):**
   - Coeficiente binomial sin orden: $\binom{12}{3} = \frac{12 \times 11 \times 10}{3!} = 220$ tríadas cromáticas equiprobables ($P = 0.4545\%$ por tríada).

---

## 5. Vinculación con el Grafo de Conocimiento Wikidata (`sameAs`)
- Cryptographically Secure Pseudorandom Number Generator (CSPRNG): `https://www.wikidata.org/wiki/Q1762422`
- Dice (Dados de Juego y Rol Poliédricos D4–D100): `https://www.wikidata.org/wiki/Q45089`
- Fisher-Yates Shuffle (Permutación Aleatoria sin Repetición): `https://www.wikidata.org/wiki/Q1420686`
- Wheel of Fortune / Spinning Wheel (Ruleta de Sorteos): `https://www.wikidata.org/wiki/Q1535926`
- Discrete Uniform Distribution (Equiprobabilidad): `https://www.wikidata.org/wiki/Q1573068`
- Spanish Alphabet (Abecedario Español 27 Letras A–Z / Ñ): `https://www.wikidata.org/wiki/Q282157`

---

## 6. Política Editorial y Declaración de Transparencia (Reglamento UE 2024/1689)
- **Responsabilidad Editorial:** Mesa Editorial de Juegos de Azar Recreativos y Probabilidad Aplicada.
- **Cumplimiento EU AI Act (Art. 50 y Art. 50(4)):** La redacción técnica, las demostraciones de probabilidad y las ilustraciones de apoyo han contado con asistencia de herramientas generativas bajo revisión, validación matemática y responsabilidad editorial humana directa.
- **Aviso de Puerto Seguro:** Este motor de cálculo modela fórmulas legales y normas reglamentarias publicadas únicamente con fines informativos y de planificación. No constituye asesoramiento legal, médico, veterinario, fiscal ni de ingeniería certificado. Para decisiones definitivas, consulte a un profesional con licencia vigente en su jurisdicción.