Descripción general

Act4RacingCards es una app Android que funciona como un álbum de cartas coleccionables de autos de resistencia (LMH, LMDh, GTP, GT3, GTE, LMP2…). El usuario crea sus propias cartas eligiendo un auto, una clase, un color de fondo y una escudería; la app “rifa” las estadísticas de rendimiento con una animación estilo casino/gacha y le asigna una rareza.

No es un catálogo con datos reales de autos: es un juguete de creación y colección, con el peso visual y la ceremonia de una carta física (marco, viñeta de color, roundel de número, badge de escudería, chip de clase y chip de rareza).

Las 4 pantallas

Pantalla	Rol
Splash / Loading	Pantalla de marca mostrada al abrir la app, antes de que exista contenido.
Gallery	Colección de cartas del usuario, en grilla o en lista, con filtro por clase.
Create / Edit	Formulario para crear una carta nueva (con el roll de estadísticas) o editar una existente.
Details	Vista de una carta individual con su panel de estadísticas (“Quick Info”) y opción de eliminar.

Ver Navegación y flujo de pantallas para el diagrama completo de transiciones.

Ciclo de vida de una carta

1. El usuario pulsa Create en la barra inferior.
2. Elige nombre, clase, color de carrocería y escudería; desliza el carrusel para elegir la foto del auto.
3. Al confirmar (✓), la app rifa velocidad máxima, 0–100 km/h, potencia y peso dentro de rangos fijos (ver PerformanceRoller), y los revela uno por uno con una animación tipo slot machine.
4. Con las 4 estadísticas reveladas, se calcula una rareza de S a D y la carta se guarda en la Gallery.
5. Desde la Gallery o desde Details, la carta puede editarse (todo excepto las estadísticas, que no se vuelven a rifar) o eliminarse.

Qué no es (todavía)

El modelo RacingCard está documentado como “layout-only scaffolding” en el propio código fuente: no hay persistencia en disco (las cartas viven en memoria, en un mutableStateListOf, y se pierden al cerrar la app), no hay backend, y los valores de estadísticas son aleatorios dentro de rangos ficticios, no datos reales de los autos.