Contenido de esta guía:
🔐 Pantalla de Login
🔍 Pantalla principal — Filtros y búsqueda
🃏 Vista Tarjetas
📋 Vista Lista
🔎 Ficha de Máquina (detalle)
✏️ Editar una Máquina
📸 Subir Imagen
📄 Exportar a PDF
📊 Exportar a Excel
📥 Importar desde Excel
📦 Campos de inventario (OVP, Repuesto, Manual)
⚙️ Gestión de Usuarios (Admin)
🔐 Pantalla de Login
Al abrir la aplicación aparece el formulario de acceso. Introduce tu usuario y contraseña. Cada usuario tiene su propia colección independiente; solo el administrador puede ver todas las colecciones.
- Si introduces mal la contraseña, se muestra el error en pantalla.
- Para cerrar sesión, pulsa el botón Logout en la esquina superior derecha.
🔍 Pantalla Principal — Filtros y Búsqueda
Es la pantalla central de la aplicación. En la parte superior encontrarás el panel de filtros:
- Búsqueda libre: Filtra por denominación, fabricante, código, CIA, librea... cualquier texto.
- Fabricante: Desplegable con todos los fabricantes de tu colección.
- DCC: Filtra solo las máquinas con o sin decodificador.
- Tipo de Loco: Filtra por tipo (eléctrica, vapor, diésel, vagón...).
- Checkboxes: Filtra por Con imagen, Con caja, Verificadas, Marcadas.
- Vista: Alterna entre vista Tarjetas y vista Lista con los botones de la esquina superior.
- Ordenación: En vista Lista, haz clic en cualquier encabezado de columna para ordenar por ese campo. Por defecto se ordena por Código (PA-001, PA-002...).
🃏 Vista Tarjetas
Muestra cada máquina como una tarjeta con su imagen, código, denominación y datos principales. Es la vista más visual para explorar la colección. Haz clic en cualquier tarjeta para abrir la ficha de detalle.
📋 Vista Lista
Muestra todas las máquinas en formato tabla con las columnas principales: Código, Foto, ID, CIA, Librea, Tipo, Escala, Verificado, Marcada, Caja, OVP, Repuesto, Manual, Fabricante, Referencia, Denominación, Decoder, SND, DCC, Tipo Decoder, Precio Actual.
- Haz clic en un encabezado para ordenar por esa columna (ascendente / descendente).
- Haz clic en cualquier fila para abrir la ficha de detalle.
- Los campos Verificado, Marcada y Caja se muestran como checkboxes visuales.
🔎 Ficha de Máquina (Detalle)
Al hacer clic en una máquina se abre su ficha completa. Muestra todos los campos en 3 columnas:
- Identificación: Código, ID, CIA, Librea, Denominación, Tipo Loco.
- Técnico: Fabricante, Referencia, Escala, DCC, Decoder, Tipo Decoder, Sonido (SND).
- Estado: Verificado, Marcada, Caja, OVP, Repuesto, Manual.
- Económico: Precio estimado, Precio búsqueda, Precio actual, Año adquisición, enlace eBay.
- Imagen: Foto de la máquina a la izquierda.
Desde la ficha puedes hacer clic en Editar para modificar los datos.
✏️ Editar una Máquina
- Abre la ficha de una máquina y pulsa Editar.
- Modifica los campos que necesites. El formulario tiene todos los campos disponibles.
- Pulsa Guardar para confirmar. Los cambios se guardan en el servidor inmediatamente.
- Pulsa Cancelar para descartar los cambios.
Campos editables: Código, ID, CIA, Librea, Denominación, Fabricante, Referencia, Escala, Tipo Loco, DCC, SND, Decoder, Tipo Decoder, Verificado, Marcada, Caja, OVP, Repuesto, Manual, Precio estimado, Precio búsqueda, Precio actual, Año adquisición, eBay.
📸 Subir Imagen
- En el panel de edición de una máquina, haz clic en Cambiar imagen.
- Selecciona un archivo PNG o JPG desde tu ordenador.
- La imagen se sube automáticamente y se guarda con el código de la locomotora en tu carpeta personal.
- Aparece inmediatamente en la tarjeta y en la ficha de detalle.
📄 Exportar a PDF
Haz clic en Descargar PDF para generar el catálogo. El PDF se genera íntegramente en el navegador (sin servidor) y descarga como Listado de trenes v5.2 - {usuario}.pdf. Contiene:
- Portada / encabezado: Nombre del usuario, fecha de generación y total de máquinas.
- Tarjetas de máquinas: 4 por página. Cada tarjeta incluye:
- Imagen de la máquina.
- Código, Librea, CIA, Denominación.
- Checkboxes: Verificado, Marcada, Caja, OVP, Repuesto, Manual, DCC, SND.
- Columna derecha: Fabricante, Referencia, Decoder, Tipo Decoder, Tipo Loco, Escala, Precio actual.
- Última página — Estadísticas: Página de resumen con gráficos (ver detalle más abajo).
El PDF respeta los filtros activos: si tienes un filtro aplicado, solo exporta las máquinas visibles.
📈 Página de Estadísticas (última página del PDF)
Se genera automáticamente al final del PDF con dos columnas de gráficos:
Columna izquierda:
- Tipo de locomotora (barras)
- Fabricante — todos los valores (barras)
- Distribución de precio actual por rangos de 50€ (barras) con Mín/Máx/Media/Total
Columna derecha:
- Digital / Analógica / SND (píldoras de color)
- Estado: Verificadas / Con caja / Con manual / Total (píldoras)
- Año de adquisición (barras)
- Tipo de Decoder — todos los valores (barras)
📊 Exportar a Excel
Haz clic en Descargar Excel para descargar el archivo Listado de trenes v5.2 - {usuario}.xlsx. Se genera en el navegador con:
- 25 columnas: Código, Foto, ID, CIA, Librea, Tipo Máquina, Escala, Verificado, Marcada, Caja, OVP, Repuesto, Manual, Fabricante, Referencia, Denominación, Decoder, SND, DCC, Tipo Decoder, Precio Estimado, Precio Búsqueda, Año Adquisición, eBay, Precio Actual.
- Encabezados en azul oscuro con texto blanco.
- Imágenes de las máquinas incrustadas en la columna Foto.
- Autofilter activado en todos los encabezados.
- El orden de filas respeta el orden activo en la tabla (por defecto, por Código).
📥 Importar desde Excel
- Haz clic en Cargar Excel y selecciona un archivo .xlsx.
- El sistema lee todas las filas y las incorpora a tu colección.
- Si el archivo contiene imágenes en las celdas, se extraen y guardan automáticamente con el nombre del código PA correspondiente.
- Si ya existe una máquina con el mismo código, se actualiza; si no existe, se crea nueva.
El archivo debe tener las mismas columnas que el Excel exportado. Se recomienda usar siempre el Excel exportado como plantilla.
⚠️ Formato obligatorio
La importación de Excel solo funciona con el formato exacto de esta aplicación. No es posible importar cualquier Excel con datos de trenes; debe ser el archivo descargado previamente desde la opción Descargar Excel.
El flujo recomendado es: descarga el Excel desde la aplicación → modifica los datos que quieras en tu ordenador con Excel → sube el archivo modificado. Los datos importados reemplazarán los existentes en la base de datos.
🔴 Los datos sobreescritos NO son recuperables. Asegúrate de tener una copia antes de importar.
📦 Campos de Inventario
- Verificado: La máquina ha sido verificada (comprobada que funciona correctamente).
- Marcada: Máquina marcada para cualquier propósito (revisión, venta, préstamo...).
- Caja: Tiene caja la máquina o vagón.
- OVP (Original Packaging): Tiene la caja original del fabricante.
- Repuesto: Tiene una caja de repuesto genérica.
- Manual: Tiene instrucciones — Original (el manual original del fabricante) o Copia (copia impresa del manual).
⚙️ Gestión de Usuarios (Solo Administrador)
Si tienes rol de Admin, verás el botón ⚙️ Gestionar Usuarios en la cabecera:
- Ver todos los usuarios: Lista de usuarios con su rol y fecha de alta.
- Crear usuario: Introduce nombre, contraseña y rol (usuario o admin).
- Editar usuario: Cambia la contraseña o el rol de cualquier usuario.
- Eliminar usuario: Borra el usuario y todas sus máquinas e imágenes.
El admin puede ver las máquinas de todos los usuarios usando el filtro de usuario que aparece en la cabecera.
💡 Consejos rápidos
- Pulsa Esc para cerrar cualquier modal o ficha.
- Los filtros se aplican en tiempo real mientras escribes.
- El PDF y el Excel exportan solo las máquinas visibles con los filtros activos.
- Las imágenes se guardan en tu espacio personal (
images/{usuario}/) y no se mezclan con las de otros usuarios.
- Cada usuario solo ve su propia colección. Los admins ven todas.