Contenido de esta guía:
🔐 Pantalla de Login
👤 Mi perfil — email y contraseña
📧 Comunicaciones recibidas
🔍 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 (formato exacto o libre)
📦 Campos de inventario (OVP, Repuesto, Manual)
⚙️ Gestión de Usuarios (Admin)
📊 Log de Conexiones y Acciones (Admin)
🏷️ Ventas y Subastas
📊 Excel de Ventas/Subastas
🔐 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.
- La sesión se mantiene activa durante 30 días sin necesidad de volver a iniciar sesión, incluso si cierras el navegador.
- Para cerrar sesión manualmente, pulsa el botón Salir en la esquina superior derecha.
- Pulsa 👤 Mi perfil (en la cabecera) para actualizar tu email de contacto o cambiar tu contraseña.
Los botones de la cabecera tienen todos el mismo tamaño para facilitar su localización: 🏷️ Ventas (naranja), 👤 Mi perfil, 📧 Comunicaciones, ❓ Ayuda y Salir. El administrador ve además ⚙️ Gestionar Usuarios y cuando navega a Ventas aparece 🚂 Mi Colección en su lugar.
👤 Mi perfil
Cada usuario puede gestionar su propio perfil pulsando el botón 👤 Mi perfil de la cabecera. El panel tiene dos secciones:
✉ Email de contacto
- Al abrir el panel se muestra el email registrado actualmente en tu cuenta.
- Se usa para recibir avisos: ganador de subasta, notificaciones del administrador, etc.
- Es opcional; la aplicación funciona sin él.
- Puedes cambiarlo en cualquier momento con el botón Guardar email.
🔑 Cambiar contraseña
- Introduce tu contraseña actual y la nueva dos veces para confirmar.
- Si la contraseña actual no es correcta, el sistema lo indicará sin realizar cambios.
- El cambio se aplica inmediatamente.
El administrador también puede cambiar la contraseña de cualquier usuario desde el panel ⚙️ Gestionar Usuarios con el botón 🔑, sin necesidad de conocer la contraseña actual.
📧 Comunicaciones recibidas
En la cabecera de la aplicación hay un botón 📧 Comunicaciones que muestra el historial de correos que el sistema te ha enviado.
- Usuario normal: Ve solo los correos recibidos por su propia cuenta.
- Administrador: Ve todos los correos enviados a todos los usuarios.
Haz clic en cualquier entrada de la lista para desplegar el contenido completo del correo.
📬 Correos que envía el sistema automáticamente
- 🎉 Bienvenida: Al crear una cuenta con email, el nuevo usuario recibe un correo de bienvenida con el enlace a la aplicación.
- ✅ Nuevo anuncio publicado: El creador recibe confirmación de que su anuncio ha sido publicado.
- 🔔 Nueva oferta: El vendedor recibe aviso con el importe y el nombre del ofertante; el ofertante recibe confirmación de su oferta.
- 🔔 Oferta actualizada: Igual que nueva oferta pero indicando el precio anterior y el nuevo.
- ℹ️ Oferta retirada: El vendedor recibe aviso de que un comprador ha retirado su oferta; el comprador recibe confirmación de la retirada.
- 🏆 Ganador asignado: El ganador recibe los detalles del artículo; el vendedor recibe confirmación con los datos del ganador; los demás ofertantes reciben un aviso indicando que el artículo ha sido asignado a otro comprador.
- ⏰ Cierre automático de subasta: Igual que el cierre manual, pero lo inicia el sistema al llegar a la hora de finalización configurada. Si hay ofertas, la pieza se asigna al mejor postor; si no hay ofertas, el anuncio se cierra sin asignar. Todos los participantes reciben su notificación correspondiente.
- ✅ Anuncio cerrado sin ganador: El vendedor recibe confirmación de cierre; todos los ofertantes reciben aviso de que el anuncio se ha cerrado sin asignar.
- 🔑 Cambio de contraseña por el administrador: El usuario afectado recibe un aviso de que su contraseña ha sido modificada.
Para que el sistema pueda enviarte correos, asegúrate de tener tu email configurado en 👤 Mi perfil. Si no tienes email, los correos no se envían pero las demás funciones no se ven afectadas.
🔍 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: Cualquier texto: denominación, fabricante, código, CIA, librea...
- Fabricante: Desplegable con todos los fabricantes de tu colección.
- DCC: Solo máquinas con o sin decodificador.
- Loco/Vagón: Solo locomotoras, solo vagones, o ambos.
- Tipo de Loco: Por tipo (eléctrica, vapor, diésel...).
- Checkboxes: 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, CV, 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, CV, 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, CV, CIA, Librea, Época, Denominación, Fabricante, Referencia, Escala, Loco/Vagón, Tipo Vagón, Ejes, 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.
El campo Fabricante permite introducir texto libre o seleccionar uno de los fabricantes existentes en la lista desplegable. Si el fabricante no aparece en la lista, escríbelo directamente en el campo.
📸 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.5 - {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, Época, Ejes, Loco/Vagón, Tipo Vagón, 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.5 - {usuario}.xlsx. Se genera en el navegador con:
- 29 columnas: Código, Foto, CV, 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, Época, Ejes, Loco/Vagón, Tipo Vagón.
- 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 ↑ Subir Excel (o ↕ Importar Excel (formato libre)) y selecciona un archivo .xlsx.
- El sistema reconoce cada columna por su nombre de cabecera (no por su posición), y reemplaza tu colección actual con las filas del archivo.
- Si el archivo contiene imágenes en las celdas, se extraen y guardan automáticamente con el nombre del código PA correspondiente.
⚠️ El import reemplaza tu colección
Ambos botones de importación reemplazan por completo tus locomotoras actuales por las del archivo subido (o toda la colección global si eres administrador).
↑ Subir Excel está pensado para el flujo habitual: descarga el Excel desde la aplicación → modifícalo en tu ordenador → súbelo de vuelta.
↕ Importar Excel (formato libre) hace exactamente lo mismo, pero está pensado para un Excel que no venga de esta aplicación: las columnas pueden estar en cualquier orden, sobrar columnas que no reconoce la app (se ignoran) o faltar alguna columna esperada (esa columna quedará vacía en la base de datos, p.ej. si el archivo no trae "Alias").
🔴 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. El panel de administración tiene dos partes:
👥 Gestión de usuarios
- Ver todos los usuarios: Lista de usuarios con su rol, email y fecha de alta.
- Crear usuario: Introduce nombre, contraseña, rol (usuario o admin) y email (opcional). El nuevo usuario podrá iniciar sesión inmediatamente. Si se introduce email, se le envía automáticamente un correo de bienvenida con el enlace a la aplicación.
- Editar usuario: Cambia el rol o el email. Pulsa Guardar para confirmar.
- Cambiar contraseña: Pulsa el botón 🔑 junto al usuario para establecer una nueva contraseña sin necesidad de conocer la actual. Si el usuario tiene email, recibe una notificación automática del cambio.
- Activar / Desactivar usuario: Impide el acceso sin eliminar su colección.
- Eliminar usuario: Borra el usuario y todas sus máquinas e imágenes permanentemente.
El campo Email de cada usuario es necesario para recibir notificaciones automáticas. Si no se introduce al crear la cuenta, se puede añadir desde el panel de administración o desde 👤 Mi perfil.
El admin puede ver las máquinas de todos los usuarios con el selector de usuario que aparece en la cabecera.
📧 Historial de comunicaciones (Admin)
Desde el panel de admin puedes consultar las comunicaciones de cualquier usuario de dos formas:
- Botón 📧 junto a cada usuario → muestra los correos recibidos por ese usuario en concreto.
- Botón 📧 Todas las comunicaciones enviadas (al pie del panel) → historial completo de todos los usuarios.
Ver también la sección 📧 Comunicaciones recibidas de esta guía para el detalle de los correos automáticos que envía el sistema.
📊 Log de Conexiones y Acciones
Al final del panel de administración hay un botón 📊 Ver Log de Conexiones. Este log registra todas las actividades de los usuarios en tiempo real:
- 🔑 Inicio y cierre de sesión (login / logout)
- 📄 Exportaciones a PDF
- 📊 Exportaciones e importaciones de Excel (colección y ventas)
- ➕ Creación de nuevas locomotoras
- ✏️ Edición de registros existentes
- 🗑 Eliminación de registros
- 📸 Subidas de imágenes
- 🖨️ Impresión de la ayuda
Cada entrada registra usuario, acción, fecha/hora (en hora de España) e IP de origen. El log se puede descargar en Excel con el botón 📥 Descargar Excel.
🏷️ Ventas y Subastas
La sección de Ventas y Subastas permite a los usuarios publicar máquinas o vagones para intercambio entre los miembros de la aplicación. Accede pulsando el botón 🏷️ Ventas en la cabecera (naranja). Para volver a la colección, pulsa 🚂 Colección.
📋 Vista de anuncios
Muestra todas las publicaciones como tarjetas. Cada tarjeta incluye imagen, título, tipo (venta / subasta), precio de salida, número de ofertas recibidas, estado (abierto / asignado / cerrado) y, para subastas con hora de cierre, una cuenta atrás en tiempo real ⏰ Cierra en…. Usa el desplegable de filtros para ver:
- Todas: Todos los anuncios de todos los usuarios.
- Abiertas: Solo anuncios en estado abierto.
- Mis anuncios: Solo los que tú has publicado.
- Mis ofertas: Anuncios en los que has hecho una oferta.
Tus propios anuncios muestran el badge Mío (azul) y un borde azul. En la esquina superior derecha de tus tarjetas (y de cualquier tarjeta si eres administrador) aparece un botón rojo ✕ para eliminar el anuncio directamente sin necesidad de abrirlo.
✏️ Publicar un nuevo anuncio
- Pulsa + Nueva Venta / Subasta.
- Escribe un título (obligatorio), descripción opcional y precio de salida.
- Elige el tipo: Venta directa (precio fijo) o Subasta (el comprador oferta).
- Si eliges Subasta, aparece un campo opcional ⏰ Fecha y hora de cierre automático. Al llegar esa hora, el sistema asigna automáticamente la pieza al mejor postor y notifica a todos los participantes por email. Si no se establece fecha, la subasta permanece abierta indefinidamente hasta que el vendedor la cierre manualmente.
- Pulsa Publicar. El anuncio aparece inmediatamente en el tablón.
La sección de ventas es completamente independiente de la colección. Para publicar artículos con imagen, sube primero el Excel de ventas con las imágenes incrustadas (ver sección Excel de Ventas más abajo).
Cada anuncio recibe automáticamente un código único con el formato {iniciales}-{número}-{v|s}. Por ejemplo, el primer anuncio de venta del usuario juan recibe el código ju-001-v; su primera subasta sería ju-002-s. El contador es correlativo y compartido entre ventas y subastas del mismo usuario.
🔎 Detalle de un anuncio — Vista del comprador
Pulsa en cualquier tarjeta para abrir el detalle. Como comprador (no eres el vendedor del anuncio):
- Ves la descripción completa, precio de salida y número total de ofertas.
- Si la subasta tiene hora de cierre configurada, aparece un bloque ⏰ Cierre automático con la fecha exacta y la cuenta atrás en tiempo real.
- Puedes introducir tu precio y un mensaje opcional, y pulsar Ofertar.
- Si ya tienes una oferta enviada, puedes actualizarla con un precio nuevo o retirarla con Retirar oferta.
- Solo ves tu propia oferta, no las de los demás compradores.
- Si ganas la subasta (manualmente por el vendedor o de forma automática al expirar), aparece el badge 🏆 ¡Lo has ganado! en tu tarjeta y recibes un email de confirmación.
🔎 Detalle de un anuncio — Vista del vendedor
Como vendedor del anuncio (publicado por ti), en el detalle tienes acceso a todas las ofertas recibidas con nombre del ofertante, precio y mensaje. Desde ahí puedes:
- Asignar a una oferta: Pulsa ✅ Asignar junto a la oferta ganadora. El anuncio pasa a estado asignado, el comprador ve el badge de ganador y tú ves su email de contacto (si lo tiene configurado) en el detalle del anuncio.
- Cierre automático (subastas con hora): Si configuraste una hora de cierre, no necesitas hacer nada. Al llegar esa hora, el sistema asigna automáticamente la pieza a la mejor oferta existente y envía los emails a todos los participantes. Si no hay ninguna oferta, el anuncio se cierra sin asignar.
- Cerrar sin asignar: Cierra el anuncio manualmente sin elegir ningún comprador (envía aviso a los ofertantes).
- Eliminar anuncio: Borra el anuncio y todas sus ofertas. También puedes eliminarlo directamente desde la tarjeta con el botón ✕ rojo sin necesidad de abrirlo.
El botón ✕ en la esquina superior derecha de cada tarjeta está disponible para el creador del anuncio y para el administrador, que puede eliminar cualquier anuncio.
📊 Excel de Ventas y Subastas
Dentro de la sección de Ventas hay dos botones adicionales para gestionar el catálogo de tus anuncios mediante Excel:
⬇ Descargar Excel de tus ventas/subastas
Exporta solo tus propios anuncios a un archivo Listado de trenes - venta-subasta - {usuario} - v5.5.xlsx. Contiene 8 columnas:
- Código — identificador único del anuncio (p.ej.
ju-001-v).
- Foto — imagen del artículo incrustada.
- Tipo — venta o subasta.
- Título — nombre del artículo.
- Descripción — descripción libre.
- Precio Salida — precio de salida en euros.
- Estado — abierto, asignado o cerrado.
- Fecha — fecha y hora de publicación.
⬆ Subir Excel de tus ventas/subastas
- Pulsa ⬆ Subir Excel y selecciona un archivo
.xlsx.
- El sistema lee cada fila y la identifica por su Código.
- Si ya existe un anuncio tuyo con ese código → actualiza sus datos.
- Si el código no existe → crea un anuncio nuevo.
- Las imágenes incrustadas en la columna Foto se extraen automáticamente y se guardan en
images/subasta/{usuario}/ con el nombre del código (p.ej. ju-001-v.jpg).
⚠️ Usa siempre el Excel descargado desde la aplicación como plantilla. La importación requiere que la columna Código tenga un valor en cada fila. Solo se modifican tus propios anuncios; los de otros usuarios no se ven afectados.
📩 Contacto y soporte
Para solicitar información, reportar problemas o pedir acceso, escribe a basedetrenes@gmail.com.
💡 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.
- Usa el botón 🖨️ Imprimir (arriba a la derecha de esta ayuda) para generar una versión imprimible en PDF con todos los apartados.
- Las imágenes de la colección se guardan en
images/{usuario}/; las de ventas en images/subasta/{usuario}/. Nunca se mezclan entre usuarios.
- Cada usuario solo ve su propia colección. Los admins pueden ver todas con el selector de usuario.
- La sesión dura 30 días; no hace falta volver a iniciar sesión cada vez.
- El botón ✕ rojo en la esquina de una tarjeta de ventas borra ese anuncio directamente sin abrirlo. Solo lo ves en tus propios anuncios (o en todos si eres admin).
- Configura tu email en 👤 Mi perfil para recibir avisos automáticos: bienvenida, anuncio ganado y cambio de contraseña por el admin.
- En subastas con ⏰ hora de cierre, el vendedor no necesita estar presente: el sistema asigna solo la mejor oferta al llegar la hora y avisa a todos por email.