TableGameAssistant
Web-asistente para juegos de mesa complejos, pensada para usarse en una tablet apoyada junto a la partida: eliges el juego, indicas nº de jugadores y dificultad, y pulsas «Siguiente» paso a paso hasta terminar la preparación de mesa. Primer juego soportado: Marvel Champions (Warhammer 40.000 llegará después).
Requisitos
- Node 22 (probado con 22.17.1; Nuxt/Nitro declaran un rango de motor ligeramente superior,
npm install puede emitir warnings EBADENGINE — no bloquean nada).
- npm (incluido con Node).
Comandos
npm install # instala dependencias
npm run dev # servidor de desarrollo en http://localhost:3000
npm run test # suite de Vitest (motor + contenido) — debe terminar en verde antes de cualquier commit
npm run generate # build estático de producción (SSG) en .output/public
Despliegue
La app está publicada en https://tabletop-assistant.vercel.app/
El despliegue es automático por push: Vercel detecta Nuxt y construye con el preset vercel de Nitro, así que cada push a main se publica solo. El gate de CI (.github/workflows/ci.yml) ejecuta npm run test en paralelo; si la validación de contenido falla, el fallo es visible en el commit.
Las cabeceras de caché no viven en configuración del host, sino en nitro.routeRules dentro de nuxt.config.ts: Nitro las traduce al preset de destino, de modo que hay una única fuente de verdad y cambiar de hosting no obliga a reescribirlas. Ahí está declarado el Cache-Control: no-cache de /sw.js y /manifest.webmanifest que evita que la tablet se quede con una versión vieja cuando llegue el service worker en la Fase 4.
Estructura relevante
engine/ — motor de flujo puro en TypeScript (sin Vue/Nuxt/DOM), testeado con Vitest.content/*.json — contenido de cada juego (pasos de preparación, citas al reglamento oficial), validado con Zod en CI.app/ — páginas y componentes Nuxt (UI tablet-first, tema oscuro).nuxt.config.ts — configuración de Nuxt, rutas prerenderizadas y cabeceras de caché (routeRules).
