Guía de producto — CardCreator

ProductoEn desarrollo Diseño y maquetación de cartas y componentes para juegos de mesa, con exportación lista para imprenta.

Estado actual: CardCreator está en fase de especificación y prototipado. Todavía no expone una API pública, por lo que esta documentación cubre el producto, los flujos funcionales y el modelo de datos previsto. Cuando el backend esté publicado, esta página se sustituirá por la referencia OpenAPI interactiva en esta misma URL.

1. Qué es CardCreator

CardCreator es una herramienta de diseño y producción de componentes para juegos de mesa y cartas coleccionables. Su propuesta es separar el diseño (la plantilla visual, llamada blueprint) de los datos (las cartas concretas, que llegan desde una hoja de cálculo o CSV), de forma que cambiar una regla o un texto no obligue a rediseñar 200 cartas a mano.

Blueprints

Plantillas reutilizables con paneles de texto e imagen posicionables. Un blueprint define el aspecto de toda una familia de cartas.

Variables

Cada panel se enlaza a una columna de datos. Los valores vienen del CSV/hoja importada, no se teclean carta a carta.

Asistencia AI

Sugerencias de estilo, tono y ajuste tipográfico. Si el proveedor de AI falla, el editor sigue funcionando en modo básico.

Export a imprenta

Generación de PDF con las cartas maquetadas, listo para enviar a impresión o prototipar en casa.

2. Flujo principal de trabajo

Iniciar sesión → aterrizas en el Dashboard con tus proyectos.
New Blueprint → eliges una plantilla predefinida como punto de partida.
Maquetar → arrastras paneles de texto e imagen y ajustas posición y tamaño.
Introducir contenido → escribes el texto o enlazas la variable de datos; la AI propone estilo y encaje.
Export PDF → descargas el archivo listo para imprimir.

3. Pantallas y estados

[Login] → [Dashboard] → [Blueprint Editor]
      ↑          ↓              ↓
      └────[Logout]      [Component Editor]
                                ↓
                         [Variable Manager]
                                ↓
                          [Export Wizard]
                                ↓
                         [Export Complete]

Pantalla	Para qué sirve
Dashboard	Listado de proyectos y blueprints; punto de entrada tras el login.
Blueprint Editor	Lienzo principal: composición de la carta, paneles, capas y guías.
Component Editor	Edición fina de un panel concreto (tipografía, color, encaje, imagen).
Variable Manager	Mapeo entre columnas de datos importados y paneles del blueprint.
Export Wizard	Selección de rango, formato, sangrado y generación del PDF final.

4. Importación de datos

Las cartas se generan a partir de un CSV o hoja de cálculo. Consideraciones al importar:

Las columnas se validan antes de comenzar la importación, para evitar mapeos a medias.
En archivos grandes (más de 1.000 filas) se muestra progreso con tiempo estimado y se puede cancelar.
Un export de más de 100 páginas se divide en varios archivos y se avisa antes de generar.

5. Errores y comportamiento esperado

Situación	Qué ves	Qué hace la app
AI no configurada / clave inválida	«AI Service no disponible. Usando modo básico»	Continúa sin asistencia AI; el editor sigue operativo.
Límite de plan alcanzado	«Límite alcanzado. Contacta soporte»	Bloquea la creación de nuevos elementos, conserva lo existente.
Fallo al exportar	«Error exportando. Intenta de nuevo»	Reintenta automáticamente antes de devolver el error.
Blueprint no encontrado	«Blueprint no encontrado. Sincronizando…»	Recarga los datos del proyecto desde el servidor.
Conexión AI caída a mitad de sesión	Aviso con opción de reintentar	Guarda la sesión localmente para no perder trabajo.

6. API

No hay endpoints públicos todavía. Cuando el backend se despliegue en api.cardcreator.theboomer.dev, esta página pasará a servir la referencia OpenAPI interactiva (Scalar) con los mismos recursos descritos aquí: blueprints, componentes, variables y trabajos de exportación.

7. Enlaces

cardcreator.theboomer.dev — landing del producto
theboomer.dev — resto del catálogo