🔐 Ejemplos Panel de Administración

Guía completa de uso del sistema administrativo Django

Volver a la Guía

🚀 Acceso al Panel

Credenciales de Acceso

Administrador:
Usuario: admin
Contraseña: admin123

Usuarios estándar:
juan_perez, maria_lopez, carlos_ruiz
Contraseña: user123
🔐 Abrir Panel Admin

📚 Gestión de Libros

¿Qué puedes hacer?

El módulo de libros permite gestión completa del catálogo de la biblioteca.

Operaciones disponibles:

  • Crear libro: Agregar nuevos títulos al catálogo
  • Editar libro: Actualizar información, stock, ubicación
  • Eliminar libro: Quitar títulos del sistema
  • Buscar libro: Por título, ISBN, autor
  • Filtrar: Por categoría, autor, editorial, estado
  • Acciones en lote: Eliminar múltiples libros a la vez

Ejemplo: Crear un nuevo libro

  1. Ir a: Admin → Libros → Agregar libro
  2. Completar formulario:
    • Título: "El túnel"
    • ISBN: "9788432217203"
    • Autor: Seleccionar de la lista
    • Editorial, Categoría, Fecha de publicación
    • Stock total y disponible
    • Ubicación física: "Estante G-15"
  3. Click en "Guardar"

Ejemplo: Buscar libros de García Márquez

  1. Ir a: Admin → Libros
  2. En el cuadro de búsqueda escribir: garcía márquez
  3. Ver resultados filtrados
  4. Click en cualquier libro para editar

Campos y Validaciones

Campos obligatorios:
  • Título
  • ISBN (único, 13 dígitos)
  • Autor
  • Editorial
  • Categoría
Validación automática: El sistema no permite ISBNs duplicados ni stock negativo.

✍️ Gestión de Autores

Administrar Autores

Gestiona la información de los autores de la biblioteca.

Funcionalidades:

  • Crear autor: Nombre, apellido, biografía, nacionalidad
  • Editar autor: Actualizar información biográfica
  • Ver libros: Lista de libros del autor
  • Buscar: Por nombre o apellido

Ejemplo: Agregar nuevo autor

  1. Admin → Autores → Agregar autor
  2. Completar:
    • Nombre: "Julio"
    • Apellido: "Cortázar"
    • Fecha nacimiento: "26/08/1914"
    • Nacionalidad: "Argentino"
    • Biografía: "Escritor, traductor..."
  3. Guardar

📋 Gestión de Préstamos

Control de Préstamos

El módulo más importante: gestiona el ciclo completo de préstamos y devoluciones.

Operaciones clave:

  • Crear préstamo: Registrar salida de libro
  • Marcar devolución: Registrar retorno de libro
  • Renovar préstamo: Extender fecha de devolución
  • Aplicar multas: Por devolución tardía
  • Filtrar por estado: activo, devuelto, vencido
  • Ver historial: Préstamos de un usuario

Ejemplo: Registrar nuevo préstamo

  1. Admin → Préstamos → Agregar préstamo
  2. Seleccionar:
    • Libro: Buscar por título
    • Usuario: Seleccionar de la lista
    • Fecha devolución esperada: +14 días
    • Notas (opcional)
  3. Guardar
  4. Efecto: Stock del libro se reduce automáticamente

Ejemplo: Marcar libro como devuelto

  1. Admin → Préstamos
  2. Buscar el préstamo activo
  3. Click para editar
  4. Cambiar estado a: "devuelto"
  5. Registrar fecha_devolucion_real
  6. Si hay retraso, aplicar multa
  7. Guardar
  8. Efecto: Stock del libro aumenta automáticamente

Ejemplo: Ver préstamos vencidos

  1. Admin → Préstamos
  2. En el filtro lateral, seleccionar: Estado → vencido
  3. Ver lista de préstamos no devueltos a tiempo
  4. Click en cada uno para gestionar multas

👥 Gestión de Usuarios

Administrar Usuarios

Control completo de usuarios del sistema con permisos granulares.

Funcionalidades:

  • Crear usuario: Nuevo miembro de la biblioteca
  • Asignar permisos: Bibliotecario, admin, usuario
  • Cambiar contraseña: Reset de credenciales
  • Desactivar cuenta: Sin eliminar historial
  • Ver préstamos: Historial del usuario

Ejemplo: Crear nuevo usuario

  1. Admin → Usuarios → Agregar usuario
  2. Completar:
    • Nombre de usuario: "pedro_sanchez"
    • Contraseña (2 veces para confirmar)
    • Nombre: "Pedro"
    • Apellido: "Sánchez"
    • Email: "pedro@email.com"
  3. Permisos (opcional):
    • ☐ Superusuario
    • ☐ Personal
    • ☑ Activo
  4. Guardar

🏷️ Categorías y Editoriales

Gestión de Catálogos

Agregar Categoría

  1. Admin → Categorías → Agregar categoría
  2. Nombre: "Biografías"
  3. Descripción: "Biografías y memorias"
  4. Guardar

Agregar Editorial

  1. Admin → Editoriales → Agregar editorial
  2. Nombre: "Penguin Random House"
  3. País: "Estados Unidos"
  4. Sitio web: "https://www.penguinrandomhouse.com"
  5. Fecha fundación: "01/07/2013"
  6. Guardar

📊 Reportes y Estadísticas

Información del Sistema

El panel admin muestra estadísticas en tiempo real:

  • Total de libros en el catálogo
  • Libros disponibles vs prestados
  • Número de autores registrados
  • Préstamos activos
  • Préstamos vencidos (requieren atención)
  • Usuarios registrados

💡 Casos de Uso Prácticos

Caso 1: Usuario solicita libro en mostrador

  1. Buscar libro por título en Admin → Libros
  2. Verificar que stock_disponible > 0
  3. Ir a Admin → Préstamos → Agregar
  4. Seleccionar libro y usuario
  5. Fecha devolución: 14 días desde hoy
  6. Guardar → Sistema reduce stock automáticamente

Caso 2: Usuario devuelve libro con retraso

  1. Buscar préstamo en Admin → Préstamos
  2. Filtrar por usuario o libro
  3. Abrir el préstamo activo
  4. Estado → "devuelto"
  5. Fecha devolución real → hoy
  6. Sistema calcula días de retraso
  7. Aplicar multa: $10 por día = $30
  8. Agregar notas: "Libro en buen estado"
  9. Guardar → Stock se incrementa automáticamente

Caso 3: Inventario semanal

  1. Admin → Libros
  2. Revisar filtros:
    • Estado: "disponible" → Verificar ubicación física
    • Estado: "prestado" → Verificar con préstamos activos
  3. Admin → Préstamos
  4. Filtrar por estado: "vencido"
  5. Contactar usuarios con préstamos vencidos
  6. Actualizar multas pendientes

🔒 Permisos y Seguridad

Niveles de Acceso

Superusuario (admin):
✅ Acceso completo a todas las secciones
✅ Puede crear/editar/eliminar cualquier registro
✅ Gestiona usuarios y permisos
✅ Acceso a configuración del sistema
Usuario estándar:
❌ No tiene acceso al panel admin
✅ Solo puede usar la API REST (solo lectura)
✅ Puede ver su propio historial de préstamos
Importante: Nunca compartas las credenciales de administrador. Crea usuarios específicos con los permisos mínimos necesarios.