Pilotos (Alt+P)

5 · Preparar el evento

¿Cómo usar Gestión de Pilotos?

Cada piloto que sale al aire no viene del cronometraje. El crono solo manda números: 7, 88, 33. Los nombres, marcas, abreviados y fotos los pone Race-G desde tus grupos de pilotos. Un grupo es la lista de inscriptos de una categoría: TC, TC2000, TN, Karting, la que corra. Sin grupos, al aire ves solo #7. Con grupo, ves ALESSI M. + Ford + su PNG.

Importante: el número es la clave de todo. Todo en Race-G gira alrededor del nº de coche. Los PNG de números se guardan por número, los retratos por número, la comparativa pide números, Alt+P busca por número. Si dos pilotos tienen el mismo número en el mismo grupo, es error. Si cambiás un número, tenés que renombrar también su PNG y su retrato.

1. Antes de empezar

📁

Carpeta drivers/

Cada grupo es un archivo drivers/tc.json, drivers/turismonacional.json. No los edites con bloc de notas: usá el panel de Race-G, que normaliza y valida. Hacé backup de esa carpeta antes de una fecha importante.

📊

Excel de inscriptos

La forma más rápida de cargar 40 pilotos: un .xlsx con columnas Nro, Nombre, Apellido, Marca, Equipo. Si lo tenés así, en 10 segundos creás el grupo.

🖼

Numeros/ y Retratos/

Los gráficos no usan texto para el número: usan PNG. Numeros/<grupo>/7.png es la imagen del 7. Retratos/<grupo>/7.png es la foto recortada con fondo transparente. Si no existen, se ve #7 en texto.

🧠

Grupo activo automático

Race-G detecta solo qué grupo está corriendo mirando el nombre de la sesión que manda el crono. Si la sesión dice “TURISMO CARRETERA FINAL”, activa turismocarretera.json. Podés tener 20 grupos, al aire solo hay uno.

2. Dónde están las herramientas

🖼️

Falta captura: Screenshots/pilotos-config.pngModal grande con columna izquierda: cargar nuevo grupo por Excel y lista de grupos. Columna derecha: tabla ABM editable.

⚙

CONFIG → Pilotos → ✎

Gestión completa. Izquierda: crear grupo desde Excel, lista de grupos con ✎ para editar y 🗑 para borrar. Derecha: tabla ABM del grupo seleccionado donde editás Nro, Nombre, Apellido, Marca, Equipo, Abreviado, Short.

👤

Botón 👤 Alt+P — Selector global

En PLAY tenés 👤 Alt+P. Atajo de teclado Alt+P también. Abre buscador que junta todos los pilotos de todos los grupos en una grilla con PNG de número y logo de marca. Filtrá por número o apellido y hacé clic.

🏁

Clic en la tabla de tiempos

Clic en cualquier fila de la clasificación en vivo. Abre el Modal de Acciones del Piloto con #7, nombre, y botones: Radio, Apercibido, Recargo, Exclusión, Pase y Siga, Nombre y ✎ Editar piloto.

✎

✎ Editar piloto — Edición rápida al aire

Dentro del modal de acciones, botón amarillo abajo. Abre el editor completo de ese piloto sin salir de PLAY: campos, PNG del número, retrato, todo. Es para corregir al aire sin ir a CONFIG.

Tres puertas, mismo archivo. CONFIG es para trabajo pesado de pre-carrera. Alt+P es para buscar a cualquiera en 2 segundos aunque no esté en esa tanda. Clic en tabla + ✎ es para corregir uno puntual al aire. Los tres escriben en drivers/<grupo>.json.

3. Qué es un grupo y qué campos tiene

Un grupo es una lista de pilotos. Cada piloto puede tener estas claves:

Campo	Para qué se usa y cómo se autocompleta	Obligatorio
no	Nº de coche. Único dentro del grupo. Permite letras: 7A, 12-1. Se limpia a a-Z,0-9,_-.	Sí
nombre / apellido	Separados. Ej: Mariano / Alessi. Con esto se arma todo lo demás.	Al menos uno
nombre_completo	Si lo dejás vacío se arma como nombre + apellido. Placeholder “vacío = automático”.	Auto
inicial	Primera letra de nombre. Auto si vacío.	Auto
nombreabreviado	Cómo sale al aire: ALESSI M.. Si vacío: Apellido + inicial. (Alessi M.) o apellido solo. Respetá mayúsculas como querés que salga.	Auto
marca	Ford, Chevrolet, Toyota. Usada para logo y para agrupar.	Recomendado
logo_marca	Auto desde marca: primera palabra en minúsculas + .png. Ford Focus → ford.png. Busca en Marcas-Brands/. Podés corregirlo a mano.	Auto
equipo / short / clase / provincia	Opcionales. Equipo sale en algunos overlays. Short son 3 letras para overlays chicos. Clase y provincia para categorías con clases.	No
campo nuevo	Botón + campo nuevo: podés agregar instagram, sponsor, lo que quieras. Race-G lo guarda tal cual. Si el layout está preparado, lo puede mostrar.	No

4. Cargar nuevo grupo desde Excel

🖼️

Falta captura: Screenshots/pilotos-excel.pngCampo Nombre del grupo en minúsculas + selector .xlsx + botón Parsear y guardar grupo + estado.

Nombre del grupo en minúsculasEn CONFIG → Pilotos, izquierda, campo Nombre del grupo: escribí solo a-z, 0-9 y _. Ej: tc, t2000, tnclase3, karting2024. Sin espacios, sin tildes. Ese será el nombre del archivo y de las carpetas Numeros/ y Retratos/.

Elegí el .xlsxBotón Archivo .xlsx → seleccioná tu Excel. Acepta .xlsx y .xls. La primera fila debe tener encabezados.

Parsear y guardarTocá ↑ Parsear y guardar grupo. Lee el Excel, ignora filas sin número, genera nombre_completo, inicial, abreviado y logo_marca automáticamente y guarda drivers/<id>.json. Te muestra ✓ 38 pilotos en grupo "tc". Si falta Pillow/pandas te avisa.

Formato del Excel: Columnas reconocidas: no / numero / nro, nombre, apellido, marca, equipo, nombre_completo, nombreabreviado, short, clase, provincia. Si tu planilla tiene “Piloto” con “Alessi Mariano” en una sola celda, ponelo en nombre_completo y el parser intenta separar. Filas vacías o de totales se ignoran solas.

5. Editar grupos — tabla ABM

🖼️

Falta captura: Screenshots/pilotos-abm.pngTabla con Nro, Nombre, Apellido, Marca, Equipo, Abreviado, Short y botones + Agregar piloto y cerrar tabla.

Abrí el grupoEn lista de grupos (izquierda), tocá ✎. A la derecha aparece la tabla del grupo.

Editá directoCada celda es editable. Cambiá número, nombre, apellido, marca, equipo, abreviado, short. No hay que darle enter: queda en memoria.

Agregar / borrar+ Agregar piloto agrega fila vacía con foco en Nro. El tachito borra la fila. Si borrás por error y no guardaste, cerrá la tabla y volvé a abrir: vuelve lo guardado.

GuardarAl cerrar o con botón guardar, valida que no haya números repetidos. Si hay dos #7 avisa y no guarda. Guarda en drivers/<grupo>.json.

Otras acciones en la lista de grupos: 🗑 Borrar grupo borra el .json (los PNGs de Numeros/ y Retratos/ quedan huérfanos, borralos a mano si querés). Renombrar renombra el archivo y si era el activo lo actualiza.

6. Alt+P — Selector global

🖼️

Falta captura: Screenshots/pilotos-altp.pngOverlay con buscador Filtrar por número o nombre, selector Todos los grupos, y grilla de tarjetas con PNG de número, nombre completo y logo marca.

🔍

Buscador instantáneo

Escribí número o parte de apellido en “Filtrar por número o nombre…”. Filtra en todos los grupos al instante. Ideal cuando te dicen “el 33” y no sabés si es de TC o TN.

📂

Filtro por grupo

Desplegable Todos los grupos → elegí uno. Queda guardado el último usado. Si tu fecha tiene 3 categorías, filtrá para no mezclar números repetidos.

🖼

Tarjeta con PNG y marca

Cada tarjeta: a la izquierda PNG del número desde Numeros/thumb40/<grupo>/<nº>.png (si no existe muestra #N en texto con fallback seguro), centro nombre completo + marca, derecha logo desde Marcas-Brands/. Si falta logo queda invisible, no rompe.

👆

Clic abre modal de acciones

Clic en tarjeta → cierra selector y abre modal de acciones de ese piloto (apercibido, recargo, editar, etc.) aunque no esté en la sesión en vivo. Desde ahí podés mandar “Nombre” al aire o editarlo rápido.

Atención con números repetidos entre categorías: Si hay un #7 en TC y un #7 en TN, Alt+P te muestra dos tarjetas #7. Mirá el grupo y la marca antes de hacer clic. El sistema, cuando viene desde Alt+P con grupo distinto al vivo, usa el piloto seleccionado como fallback para no mostrar el piloto equivocado de la otra categoría.

7. Clic en tabla en vivo — modal de acciones del piloto

🖼️

Falta captura: Screenshots/pilotos-modal-acciones.pngModal con #7 ALESSI M. y botones: Radio en Vivo, Apercibido, Recargo, Exclusión, Pase y Siga, Nombre, Editar piloto.

Click en una fila de la clasificación abre este modal. Busca el competidor por número en currentData.competitors si es el mismo grupo del vivo, si no usa el fallback de Alt+P.

⚠

Acciones

🎙 Radio, ⚠ Apercibido, ⏱ Recargo, ✗ Exclusión, 🚦 Pase y Siga, 👤 Nombre. Cada una pide detalle y manda el gráfico atado a ese piloto con su nombre/marca correctos del grupo.

✎

✎ Editar piloto

Botón amarillo. No manda nada al aire: abre el editor rápido. Úsalo para corregir “Alessi” que salió como “Alessy” sin salir de PLAY.

8. Editar piloto rápido — editor completo

🖼️

Falta captura: Screenshots/pilotos-editar-rapido.pngModal EDITAR PILOTO con grilla de campos, sección PNG del número con actual y vista previa, controles de fuente/color/stroke, y sección Retrato con drag&drop.

Se abre con ✎ Editar piloto. Cabecera muestra #7 · grupo turismocarretera.

🆔

Campos

Grilla de 3 columnas con todos los campos del piloto: los estándar y cualquier extra que tenga en el JSON. Podés editarlos todos. Botón + campo nuevo agrega clave nueva (ej: instagram). Clave se limpia a minúsculas y _.

⚠

Avisos amarillos

“El grupo no tiene archivo: al guardar se crea con este piloto” → vas a crear grupo nuevo. “Este número no está cargado en el grupo: al guardar se agrega” → piloto nuevo en grupo existente.

🔢

Cambio de número

Si cambiás no de 7 a 77 aparece checkbox Si cambio el número, renombrar también su PNG tildado por defecto. Renombra Numeros/<grupo>/7.png → 77.png y Retratos/<grupo>/7.png → 77.png. Si ya existe 77 en el grupo bloquea: Ya existe un piloto con Nº 77.

💾

Guardar

💾 Guardar piloto guarda solo ese piloto en drivers/<grupo>.json, conserva claves no editadas, completa derivados vacíos. Avisa ✓ Piloto guardado — se aplica en el próximo dato en vivo. Si tenés placa al aire, sacala y ponela de nuevo para ver el cambio inmediato.

PNG del número

👁

Actual vs Vista previa

Izquierda ACTUAL: PNG existente o “sin PNG”. Derecha VISTA PREVIA en tiempo real. Se actualiza 200ms después de cambiar fuente/tamaño/color.

🎨

Controles

Fuente (lista de carpeta fonts/), Tamaño, Itálica extra 0-100, Stroke ancho, Color fuente/fondo/stroke, Ancho/Alto PNG. Valores iniciales vienen del generador masivo de NÚMEROS para que todo el grupo quede igual.

⚡

Generar

⚡ Generar PNG del número crea Numeros/<gid>/<no>.png. Si ya existe y no tildás Sobrescribir avisa “El PNG ya existe (marcá sobrescribir)”. Si Pillow no está instalado: “Pillow no está instalado (pip install Pillow)”. Al generar avisa al layout con numero_png_updated para que recargue.

Retrato

📸

Subir

Cuadro punteado damero: arrastrá PNG transparente o clic para elegir. Acepta png, webp, jpg, jpeg. Se guarda como <nº>.png en carpeta de Retratos del grupo (mapeada en config retratos_map). Si tc y tc2000 comparten pilotos, podés mapear ambos al mismo folder de retratos desde CONFIG.

🗑

Quitar

✕ Quitar retrato borra archivo y avisa con retratos_updated. Fondo recomendado PNG con transparencia, 300x400 aprox. Si subís JPG con fondo blanco queda con fondo blanco al aire.

9. Parámetros clave

🔤

Id de grupo

Solo a-z, 0-9, _. “Turismo Carretera” → turismocarretera. Es nombre de archivo y de carpetas Numeros/ y Retratos/. Sin tildes, sin espacios.

🔢

Número

Solo a-Z, 0-9, _, -. Permite 7A, 12-1. No puede quedar vacío. Es clave única dentro del grupo.

🏷

Marca → logo

“Ford Focus” → ford.png. Primera palabra, minúsculas. Si tu archivo es alfaromeo.png y marca es “Alfa Romeo” queda alfa.png: corregilo a mano a alfaromeo.png.

🧩

Detección automática

Race-G compara nombre de sesión del crono con ids de grupos. “TURISMO CARRETERA FINAL” activa turismocarretera.json. Si no detecta, queda último activo. Podés forzarlo desde API /api/drivers/active (CONFIG lo hace).

10. Cómo se usa en transmisión

Pre-evento: cargar grupoCONFIG → Pilotos → Nombre grupo en minúsculas → .xlsx → Parsear y guardar. Verificá tabla ABM sin duplicados ni nombres cortados.

Generar númerosCONFIG → Números → Generar masivo para todo el grupo. O desde cada piloto ✎ → PNG del número → Generar. Verificá carpeta Numeros/<grupo>/.

Retratos si usás fotoSi tu layout usa Totem con foto, Comparativa, Seguidor, subí PNG transparente desde editor rápido. 1 por piloto.

En vivo: tabla o Alt+PClasificación → clic para acciones en pista. Alt+P para buscar cualquiera de cualquier categoría en 2 segundos. Ambos abren mismo modal.

Corrección al aireApellido mal escrito → clic → ✎ Editar piloto → corregí → Guardar. En 1-2s (próximo dato vivo) ya sale corregido. Si tenés placa al aire, sacala y ponela.

11. Precauciones

Número único por grupo. Dos #7 en mismo grupo = error y no guarda. Si tu categoría repite números entre clases, separá en grupos: tc_clase1, tc_clase2, o usa 7A/7B.

Id de grupo sin espacios ni tildes. “TC 2024” queda tc2024. Anotalo porque Numeros/tc2024/ debe coincidir. No cambies mayúsculas después.

Renombrar grupo no mueve PNGs. Renombra el .json y actualiza activo, pero Numeros/old_id/ no se mueve solo. Movelos a mano o regenerá.

Borrar grupo no borra PNGs/Retratos. Borra solo .json. Los PNGs quedan huérfanos. Borralos manual si no los querés.

Excel con filas vacías no rompe. Se ignoran filas sin número. Totales al final se ignoran.

Guardado rápido aplica en próximo dato vivo. Si editás con placa al aire, la placa vieja sigue 1s. Sacá y poné de nuevo para forzar.

Retrato debe ser PNG transparente. JPG con fondo blanco queda con fondo blanco al aire. Recomendado 300x400 recortado.

Alt+P con números repetidos entre categorías confunde. Hay dos #7 (TC y TN). Mirá grupo y marca en tarjeta antes de clic. El sistema usa fallback del piloto seleccionado para no mostrar el equivocado si grupos son distintos.

ABM sin deshacer. Si borrás 10 filas y guardás, no hay papelera. Antes de edición masiva, copia drivers/<grupo>.json.

Probá nombres largos antes del aire. “DE BENEDICTIS” puede cortar en overlay. Probá abreviado “DE BENEDICTIS J.” y ajustá en Editor Visual el ancho de Comparativa Pilotos.

12. Problemas frecuentes

Lo que ves	Qué significa y qué hacer
Seleccioná un archivo .xlsx / Escribí el nombre del grupo	Falta archivo o id en carga por Excel. Completá ambos.
Ya existe un grupo con ese nombre	Renombrás a id ya existente. Elegí otro o borrá existente.
Ya existe un piloto con el Nº X en este grupo	Número duplicado al guardar. Corregí número o borrá duplicado.
El PNG ya existe (marcá sobrescribir)	Hay Numeros/<grupo>/<nº>.png. Tildá Sobrescribir si querés regenerar con otra fuente/color.
Pillow no está instalado	Servidor sin Pillow para PNGs. pip install Pillow y reiniciá Race-G.
Sin PNG — #N en tarjeta	No hay PNG de número. Generá desde ✎ → PNG del número.
Sin retrato — clic o arrastrar	No hay Retratos/<grupo>/<nº>.png. Subí si tu overlay lo necesita.
Este número no está cargado	Aviso amarillo: vas a crear piloto nuevo en ese grupo. Al guardar se agrega.
El grupo no tiene archivo	Vas a crear grupo nuevo desde edición rápida. Al guardar se crea drivers/<grupo>.json con ese piloto.
Nombre cortado	nombre_completo o abreviado vacío y auto-generado no te gusta. Escribilo a mano como querés que salga (ALESSI M.) y guardá.
Alt+P no encuentra	Filtro muy restrictivo o sin grupos. Borrá filtro, elegí Todos los grupos, verificá que drivers/ tenga .json.
Guardé pero sigue nombre viejo al aire	Esperá próximo dato vivo (1s). Sacá y poné placa. Verificá que grupo activo sea el editado.
Logo de marca no aparece	Marcas-Brands/<marca>.png no existe. Subí logo o corregí logo_marca a nombre de archivo existente. No rompe, solo queda invisible.

13. Lista de control rápida

🗂

Al preparar el evento

Subir Excel con id minúsculas, verificar ABM sin duplicados, generar PNGs masivo, subir retratos si usás foto.

🔍

Antes de salir al aire

Alt+P → buscar 2-3 pilotos, verificar PNG y marca. Tabla en vivo → clic → ✎ Editar piloto → verificar que cargue campos, PNG actual y retrato. Probar guardar apellido y ver que aplique en próximo dato.

🏁

Durante la transmisión

Clic en tabla para acciones rápidas. Alt+P para pilotos fuera de tanda. ✎ para correcciones al vuelo. Si cambiás número, dejar tildado renombrar PNG.

💾

Al terminar

Backup de drivers/ + Numeros/ + Retratos/ del grupo usado. Si agregaste pilotos a mano ya quedó guardado.