📚 Manual de Usuario

Sistema de Gestión de Biblioteca Virtual

⚠️ ¡MUY IMPORTANTE! - LEA ESTO PRIMERO

  • 🚨 ESTE SISTEMA NO GUARDA AUTOMÁTICAMENTE
  • ❌ Si cierras el navegador sin descargar el Excel, PERDERÁS TODOS LOS CAMBIOS
  • ❌ Si refrescas la página (F5) sin descargar, PERDERÁS TODO
  • ❌ Si se apaga la PC sin descargar, PERDERÁS TODO
  • ❌ Si se va la luz sin descargar, PERDERÁS TODO

✅ SOLUCIÓN: Descargar el Excel frecuentemente

Cada vez que hagas cambios importantes (agregar libros, registrar préstamos, etc.), haz clic en el botón:

El archivo descargado contiene TODOS tus datos actualizados.
Guárdalo y podrás volver a subirlo cuando regreses al sistema.

💡 Buena práctica: Descarga el Excel después de cada sesión de trabajo, y nómbralo con la fecha (ej: Biblioteca_2025-10-29.xlsx) para tener un historial de respaldos.

🆕 Empezar desde Cero (Sin Excel previo)

📋 Flujo de trabajo cuando NO tienes un archivo Excel

Puedes comenzar a usar el sistema creando libros y socios manualmente, pero DEBES descargar el Excel al finalizar para no perder nada.

Paso a paso para empezar de cero

1 Crear tu primer libro
  • Ve a la pestaña "Libros"
  • Haz clic en el botón
  • Completa los datos del libro (título, autor, etc.)
  • Guarda el libro
2 Crear tu primer socio
  • Ve a la pestaña "Socios"
  • Haz clic en el botón
  • Completa los datos del socio (nombre, DNI, email, etc.)
  • Guarda el socio
3 ⚠️ DESCARGAR EL EXCEL INMEDIATAMENTE
  • Haz clic en el botón ubicado en la parte superior derecha
  • Se descargará un archivo llamado Biblioteca_Actualizado.xlsx
  • Guarda este archivo en un lugar seguro (Documentos, Escritorio, etc.)
🚨 CRÍTICO: Si no descargas este Excel, cuando cierres el navegador o refresques la página, perderás todo lo que acabas de crear.
4 Continuar trabajando

Puedes seguir agregando más libros, socios, haciendo préstamos, etc. Recuerda descargar el Excel frecuentemente (cada 10-15 minutos o después de cambios importantes).

5 La próxima vez que entres al sistema
  • El sistema estará vacío (sin libros ni socios)
  • Sube el archivo Excel que descargaste previamente
  • ¡Todos tus datos reaparecerán!
💡 Recomendación: Si vas a usar el sistema regularmente, crea una carpeta en tu PC llamada "Biblioteca" y guarda ahí todos los archivos Excel descargados con la fecha (ej: Biblioteca_2025-10-29.xlsx, Biblioteca_2025-10-30.xlsx, etc.)

📂 Cargar un Excel Existente

📋 Si ya tienes un archivo Excel de sesiones anteriores

Simplemente carga el archivo y todos tus datos aparecerán instantáneamente.

1 Ubicar el archivo Excel

Busca el archivo Biblioteca_Actualizado.xlsx que descargaste previamente

2 Cargar en el sistema
  • En la parte superior, verás: "Cargar Excel:"
  • Haz clic en el botón de selección de archivo
  • Selecciona tu archivo .xlsx o .xls
3 Verificar la carga

El sistema mostrará un mensaje verde indicando cuántos libros y socios se cargaron correctamente

✅ Datos cargados: 45 libros y 28 socios.
4 Trabajar normalmente

Ahora puedes gestionar préstamos, agregar más libros, etc.

5 ⚠️ DESCARGAR AL FINALIZAR

Antes de cerrar el navegador o apagar la PC, descarga el Excel actualizado

Formato del archivo Excel

ℹ️ Requisito: El archivo Excel debe contener dos hojas llamadas Libros y Socios

Hoja "Libros" - Columnas requeridas:

Columna Descripción Ejemplo
id_libro Identificador único 1, 2, 3...
Titulo Nombre del libro El Principito
Autor Nombre del autor Antoine de Saint-Exupéry
Materia Categoría o tema Literatura Infantil
Cantidad Ejemplares disponibles 5
ESTADO Estado actual del libro DISPONIBLE, PRESTADO, RESERVADO

Hoja "Socios" - Columnas requeridas:

Columna Descripción Ejemplo
ID Identificador único 1, 2, 3...
APELLIDOS Apellido del socio García
NOMBRES Nombre del socio Juan
DNI Documento de identidad 12345678
CORREO Email para notificaciones juan@email.com

📖 Gestión de Libros

Ver catálogo de libros

La tabla muestra todos los libros con su información completa:

  • 🖼️ Portada: Miniatura de la imagen del libro (clic para ampliar)
  • 📊 Stock: Cantidad disponible con indicadores de color Stock OK Stock Bajo Sin Stock
  • 🏷️ Estado: DISPONIBLE PRESTADO RESERVADO

Agregar nuevo libro

1 Clic en el botón "Nuevo"
2 Completar el formulario

Ingresa los datos del libro: título, autor, editorial, año, ISBN, materia, cantidad, etc.

3 Agregar portada (opcional)

Puedes subir una imagen desde tu computadora. El sistema la optimizará automáticamente.

4 Guardar
⚠️ RECUERDA: Después de agregar varios libros, descarga el Excel para no perder los cambios.

Editar libro

Haz clic en el botón en la fila del libro que deseas modificar

Eliminar libro

⚠️ Advertencia: No podrás eliminar un libro que tenga préstamos activos

Haz clic en el botón para eliminar

Buscar libros

Usa la barra de búsqueda para filtrar por cualquier campo: título, autor, materia, ISBN, etc.

👥 Gestión de Socios

Ver lista de socios

La pestaña "Socios" muestra todos los miembros registrados con:

  • 📋 Datos personales completos
  • 📚 Cantidad de préstamos activos
  • 👁️ Botón para ver historial de préstamos

Agregar nuevo socio

1 Clic en "Nuevo"
2 Completar datos

Ingresa: Apellidos, Nombres, DNI, Email, Teléfono, Carrera

💡 Importante: El email es necesario para enviar notificaciones automáticas
3 Guardar
⚠️ RECUERDA: Después de registrar socios, descarga el Excel para guardar los cambios.

Ver préstamos de un socio

Haz clic en el botón para ver todos los libros que tiene en préstamo o reservados

Editar o eliminar socio

⚠️ Restricción: No podrás eliminar un socio con préstamos activos

🤝 Gestión de Préstamos y Reservas

Realizar un préstamo

1 Seleccionar libro

En la tabla de libros, haz clic en el botón

2 Buscar socio

Escribe el nombre, apellido o DNI del socio en el buscador

3 Seleccionar socio

Haz clic sobre el socio deseado en la lista

4 Confirmar préstamo
📅 Automático: El sistema establece la fecha de devolución a 14 días automáticamente
⚠️ IMPORTANTE: Después de registrar préstamos, descarga el Excel para no perder el registro.

Estados de un libro

🟢 DISPONIBLE

El libro está disponible para préstamo o reserva

🔴 PRESTADO

El libro fue prestado a un socio. Se puede modificar la fecha o devolver

🔵 RESERVADO

El libro está reservado para un socio. Puede prestarse o cancelarse

Devolver un libro

1 Abrir gestión del libro

Haz clic en el botón

2 Confirmar devolución

El sistema mostrará a quién está prestado y la fecha de devolución

💡 Automático: Si había una reserva, el libro pasa automáticamente a estado RESERVADO
⚠️ RECUERDA: Después de devolver libros, descarga el Excel para actualizar los registros.

Modificar fecha de devolución

Si un libro está prestado, puedes extender o cambiar la fecha de devolución:

1 Abrir gestión del préstamo

Haz clic en el botón de gestión del libro prestado

2 Seleccionar nueva fecha

En el modal del préstamo, encontrarás un campo de fecha

3 Guardar cambios

Alertas de vencimiento

⚠️ Sistema automático de alertas:
  • 🟡 Alerta amarilla: Faltan 3 días o menos para la devolución
  • 🔴 Alerta roja: La fecha de devolución ya pasó (vencido)

En la parte superior verás un botón con el conteo de préstamos vencidos y próximos a vencer:

📊 Dashboard de Estadísticas

La pestaña "Estadísticas" muestra métricas y análisis completos de tu biblioteca

Indicadores Principales (KPIs)

150

📚 Total Libros

120

✅ Disponibles

25

🤝 Prestados

3

⚠️ Vencidos

Gráficos y Rankings

  • 📊 Estado de Libros: Gráfico circular mostrando distribución de estados
  • 📈 Top 5 Materias: Gráfico de barras con las categorías más populares
  • 🏆 Top 10 Libros Más Prestados: Ranking de libros más solicitados
  • 👥 Top 10 Socios Más Activos: Ranking de lectores más frecuentes
💡 Actualización automática: Las estadísticas se actualizan cada vez que cargas datos o cambias de pestaña al Dashboard.

✉️ Sistema de Notificaciones por Email

El sistema permite enviar recordatorios automáticos por email a los socios con préstamos vencidos o próximos a vencer

Préstamos pendientes

La pestaña "Notificaciones" muestra una tabla con todos los préstamos que requieren atención:

  • 🔴 Vencidos: Préstamos cuya fecha de devolución ya pasó
  • 🟡 Próximos: Préstamos que vencen en los próximos 3 días

Enviar email individual

1 Seleccionar préstamo

En la tabla de notificaciones, haz clic en el botón

2 Revisar el mensaje

El sistema genera automáticamente un mensaje personalizado con:

  • Nombre del socio
  • Título del libro
  • Fecha de devolución
  • Días de retraso (si aplica)
3 Enviar

Enviar emails masivos

1 Seleccionar préstamos

Marca las casillas de los préstamos a los que quieres enviar recordatorios

2 Enviar todos

Configuración de Emails

⚠️ Configuración requerida: Para enviar emails reales, necesitas configurar:
  • Opción 1: Un servidor backend Node.js con configuración SMTP
  • Opción 2: Una API Key de SendGrid
💡 Modo simulación: Si no configuras el envío real, el sistema funciona en modo simulación, registrando los envíos en el historial pero sin enviar emails reales.

Historial de envíos

Cada email enviado (real o simulado) queda registrado en el historial con:

  • 📅 Fecha y hora del envío
  • 👤 Socio destinatario
  • 📧 Email utilizado
  • 📚 Libro relacionado

💡 Consejos y Mejores Prácticas

💾

Descarga frecuente

Descarga el Excel cada 15-20 minutos o después de realizar cambios importantes (varios préstamos, muchos registros nuevos, etc.)

📁

Organización de archivos

Crea una carpeta dedicada y nombra los archivos con fecha (Biblioteca_2025-10-29.xlsx) para tener respaldos históricos

🔄

Respaldos en la nube

Guarda copias del Excel en Google Drive, Dropbox u OneDrive para mayor seguridad

📧

Emails completos

Asegúrate que todos los socios tengan email registrado para poder enviarles notificaciones

🖼️

Portadas optimizadas

El sistema optimiza automáticamente las imágenes. No te preocupes por el tamaño de las fotos

🔍

Usa el buscador

Para bibliotecas grandes, usa el buscador en lugar de hacer scroll. Es mucho más rápido

❓ Preguntas Frecuentes

❓ ¿Por qué se borra todo cuando refresco la página?

El sistema funciona completamente en el navegador y no tiene base de datos permanente. Los datos solo existen mientras la página está abierta. Por eso es crucial descargar el Excel para guardar los cambios.

❓ ¿Puedo usar el mismo Excel en diferentes computadoras?

Sí, absolutamente. Descarga el Excel en una PC, cópialo a otra PC (por email, USB, nube, etc.), y súbelo en el sistema. Todos los datos estarán disponibles.

❓ ¿Se pueden perder datos si trabajo mucho tiempo sin descargar?

Sí. Si hay un corte de luz, cierre accidental del navegador, o cualquier problema, perderás todos los cambios desde la última descarga. Descarga frecuentemente.

❓ ¿Qué hago si olvidé descargar y cerré el navegador?

Lamentablemente, los datos se perdieron. Deberás volver a cargar tu último Excel descargado y rehacer los cambios. Por eso recomendamos descargar frecuentemente.

❓ ¿El sistema guarda las imágenes de los libros?

Sí, las imágenes se pueden guardar de tres formas: dentro del Excel (Base64), en el almacenamiento local del navegador, o como URLs externas. La opción de Excel es la más segura porque va incluida en el archivo descargado.

❓ ¿Puedo tener varios archivos Excel de diferentes bibliotecas?

Sí, puedes tener múltiples archivos Excel diferentes (ej: Biblioteca_Escuela.xlsx, Biblioteca_Personal.xlsx) y cargar el que necesites en cada momento.

❓ ¿Los emails se envían realmente?

Solo si configuras un servidor backend o API de SendGrid. Por defecto, funciona en modo simulación (registra los envíos pero no envía emails reales).

🚨 RECORDATORIO FINAL

Antes de cerrar el navegador,
antes de apagar la PC,
antes de hacer cualquier otra cosa...

Es el único respaldo de tu trabajo.
¡No lo olvides!