6. Django Admin y Vistas CRUD ⚙️

1. El Panel Administrativo de Django (Django Admin)

Uno de los mayores superpoderes de Django frente a otros frameworks backend es su panel de administración automático (django.contrib.admin). Lee los metadatos de tus modelos y genera al instante una interfaz web completa para crear, buscar, filtrar y editar registros.

1.1 Creación del Superusuario

Para ingresar al panel de administración necesitas una cuenta con privilegios de superusuario (is_superuser = True). Ejecuta en tu terminal con el entorno virtual (venv) activo:

Creación de Superusuario en CMD

CMD

(venv) C:\proyectos\django\biblioteca> python manage.py createsuperuser
Username: admin_biblioteca
Email address: admin@biblioteca.local
Password: **********
Password (again): **********
Superuser created successfully.

1.2 Registro Profesional de Modelos en admin.py

Registrar un modelo con admin.site.register(Libro) solo ofrece una vista básica. En proyectos reales configuramos clases ModelAdmin con tablas interactivas, filtros laterales, búsquedas optimizadas e inlines para editar registros relacionados en la misma pantalla:

biblioteca/admin.py

PYTHON

# biblioteca/admin.py
from django.contrib import admin
from django.utils.html import format_html
from .models import Autor, Categoria, Libro, SolicitudPrestamo, Tag
 
 
class SolicitudPrestamoInline(admin.TabularInline):
    """Permite ver y gestionar los préstamos directamente dentro de la ficha del Libro."""
    model = SolicitudPrestamo
    extra = 0
    raw_id_fields = ['usuario']
    readonly_fields = ['fecha_solicitud', 'multa_acumulada']
    fields = ['usuario', 'fecha_solicitud', 'fecha_devolucion_limite', 'estado', 'multa_acumulada']
 
 
@admin.action(description="Marcar libros seleccionados como DISPONIBLES")
def marcar_disponible(modeladmin, request, queryset):
    actualizados = queryset.update(disponible_para_prestamo=True)
    modeladmin.message_user(
        request,
        f"Se han actualizado {actualizados} libro(s) a estado disponible."
    )
 
 
@admin.register(Libro)
class LibroAdmin(admin.ModelAdmin):
    list_display = ['titulo', 'autor', 'categoria', 'precio_reposicion', 'stock_disponible', 'disponible_badge', 'fecha_publicacion']
    list_filter = ['disponible_para_prestamo', 'categoria', 'idioma', 'fecha_publicacion']
    search_fields = ['titulo', 'isbn', 'autor__nombre_completo']
    prepopulated_fields = {'slug': ('titulo',)}
    filter_horizontal = ['tags'] # Interfaz de doble caja para relaciones ManyToMany
    inlines = [SolicitudPrestamoInline]
    actions = [marcar_disponible]
    list_per_page = 20
 
    def disponible_badge(self, obj):
        if obj.disponible_para_prestamo and obj.stock_disponible > 0:
            return format_html('<span style="color: #10B981; font-weight: bold;">● Disponible ({})</span>', obj.stock_disponible)
        return format_html('<span style="color: #EF4444; font-weight: bold;">○ Agotado / No disp.</span>')
    disponible_badge.short_description = "Disponibilidad"

2. Arquitectura de Cada Vista CRUD (Create, Read, Update, Delete)

El acrónimo CRUD define las cuatro operaciones fundamentales sobre cualquier base de datos:

C — Create (Crear):Presenta un formulario vacío mediante GET y procesa la carga de datos en base de datos mediante POST con validaciones de tipo e integridad.

R — Read (Leer / Listar):Consulta registros en base de datos para presentarlos en catálogos paginados (ListView) o en fichas individuales (DetailView).

U — Update (Actualizar / Editar):Carga la instancia existente en el formulario (instance=obj), permite modificar sus atributos y aplica validaciones antes de guardar.

D — Delete (Eliminar):Solicita confirmación mediante POST para prevenir borrados accidentales y ejecuta obj.delete() con chequeo de integridad referencial.

2.1 Formularios Basados en Modelos (ModelForm)

En Django, no escribes formularios HTML a mano. Utilizas forms.ModelForm, que genera los campos, etiquetas y validaciones directamente a partir de la definición de tu modelo:

biblioteca/forms.py

PYTHON

# biblioteca/forms.py
from django import forms
from .models import Libro
 
 
class LibroForm(forms.ModelForm):
    class Meta:
        model = Libro
        fields = [
            'isbn', 'titulo', 'autor', 'categoria', 'tags',
            'resumen', 'precio_reposicion', 'stock_disponible',
            'disponible_para_prestamo', 'idioma', 'fecha_publicacion'
        ]
        widgets = {
            'fecha_publicacion': forms.DateInput(attrs={'type': 'date', 'class': 'form-input'}),
            'resumen': forms.Textarea(attrs={'rows': 4, 'placeholder': 'Sinopsis o resumen del libro...'}),
            'precio_reposicion': forms.NumberInput(attrs={'step': '0.01', 'min': '0.01'}),
        }
 
    # Validación de Campo Único (clean_<nombre_campo>)
    def clean_isbn(self):
        isbn = self.cleaned_data.get('isbn', '').strip().replace('-', '')
        if len(isbn) not in [10, 13]:
            raise forms.ValidationError("El ISBN debe contener exactamente 10 o 13 dígitos numéricos.")
        return isbn
 
    # Validación Cruzada Global (clean)
    def clean(self):
        cleaned_data = super().clean()
        stock = cleaned_data.get('stock_disponible')
        disponible = cleaned_data.get('disponible_para_prestamo')
 
        if disponible and (stock is None or stock <= 0):
            raise forms.ValidationError({
                'stock_disponible': "No puedes marcar el libro como disponible si el stock es cero."
            })
        return cleaned_data

2.2 Implementación de Cada Vista CRUD (FBV vs CBV)

A continuación comparamos cómo se implementan las 4 operaciones mediante funciones (FBV) y mediante clases genéricas (CBV):

biblioteca/views_crud.py

PYTHON

# biblioteca/views_crud.py
from django.shortcuts import render, get_object_or_404, redirect
from django.urls import reverse_lazy
from django.contrib import messages
from django.views.generic import ListView, DetailView, CreateView, UpdateView, DeleteView
from .models import Libro
from .forms import LibroForm
 
 
# ===============================================================
# 1. CREATE (Crear Nuevo Libro)
# ===============================================================
# A. Como FBV:
def libro_crear_fbv(request):
    if request.method == 'POST':
        form = LibroForm(request.POST, request.FILES)
        if form.is_valid():
            nuevo_libro = form.save()
            messages.success(request, f"¡Libro '{nuevo_libro.titulo}' registrado con éxito!")
            return redirect('biblioteca:libro_detalle_id', pk=nuevo_libro.id)
    else:
        form = LibroForm()
    return render(request, 'biblioteca/libro_form.html', {'form': form, 'accion': 'Crear'})
 
# B. Como CBV:
class LibroCreateView(CreateView):
    model = Libro
    form_class = LibroForm
    template_name = 'biblioteca/libro_form.html'
    success_url = reverse_lazy('biblioteca:catalogo')
 
    def form_valid(self, form):
        messages.success(self.request, "Libro creado exitosamente.")
        return super().form_valid(form)
 
 
# ===============================================================
# 2. UPDATE (Editar Libro Existente)
# ===============================================================
# A. Como FBV (Importante: pasar instance=libro):
def libro_editar_fbv(request, pk):
    libro = get_object_or_404(Libro, pk=pk)
    if request.method == 'POST':
        # Al pasar instance=libro, form.save() actualiza el registro en vez de crear uno nuevo
        form = LibroForm(request.POST, request.FILES, instance=libro)
        if form.is_valid():
            form.save()
            messages.info(request, f"Libro '{libro.titulo}' actualizado.")
            return redirect('biblioteca:libro_detalle_id', pk=libro.id)
    else:
        form = LibroForm(instance=libro)
    return render(request, 'biblioteca/libro_form.html', {'form': form, 'libro': libro, 'accion': 'Editar'})
 
# B. Como CBV:
class LibroUpdateView(UpdateView):
    model = Libro
    form_class = LibroForm
    template_name = 'biblioteca/libro_form.html'
    success_url = reverse_lazy('biblioteca:catalogo')
 
 
# ===============================================================
# 3. DELETE (Eliminar Libro)
# ===============================================================
# A. Como FBV:
def libro_eliminar_fbv(request, pk):
    libro = get_object_or_404(Libro, pk=pk)
    if request.method == 'POST': # Siempre validar que la eliminación sea por POST
        titulo = libro.titulo
        libro.delete()
        messages.warning(request, f"El libro '{titulo}' ha sido eliminado.")
        return redirect('biblioteca:catalogo')
    return render(request, 'biblioteca/libro_confirm_delete.html', {'libro': libro})
 
# B. Como CBV:
class LibroDeleteView(DeleteView):
    model = Libro
    template_name = 'biblioteca/libro_confirm_delete.html'
    success_url = reverse_lazy('biblioteca:catalogo')

⚡ Laboratorio Interactivo: Simulador de Django Admin y CRUD

Experimenta el ciclo de vida completo de un CRUD en tiempo real: crea registros pasando por las validaciones de clean(), busca y filtra como en Django Admin, edita instancias existentes y elimina elementos con confirmación.

⚙️

Django Admin & CRUD Simulator

Experimenta el panel administrativo, formularios y ciclo Create-Read-Update-Delete

🔍

Filtro:

ID	Título del Libro	Categoría	Precio Venta	Costo	Stock	Estado
#1	Clean Code: Manual de desarrollo ágil	Ingeniería	$45.00	$28.00	4 u.	● Activo
#2	Python Fluente 2da Edición	Backend	$65.00	$42.00	2 u.	● Activo
#3	Django 5 Profesional	Backend	$55.00	$34.00	6 u.	● Activo
#4	Patrones de Diseño (GoF)	Arquitectura	$50.00	$30.00	0 u.	○ Inactivo

3. Ejercicios Didácticos: Proyecto 1 (Biblioteca)

Aplica las técnicas de administración y formularios sobre el dominio de la biblioteca.

Ejercicio 3.1: Formulario con Validación de Préstamos

Crea un ModelForm para SolicitudPrestamo que impida fijar una fecha de devolución superior a 30 días en el futuro.

Ver Solución Explicada

solucion_prestamo_form.py

PYTHON

from django import forms
from django.utils import timezone
from datetime import timedelta
from .models import SolicitudPrestamo
 
class SolicitudPrestamoForm(forms.ModelForm):
    class Meta:
        model = SolicitudPrestamo
        fields = ['libro', 'fecha_devolucion_limite', 'observaciones']
 
    def clean_fecha_devolucion_limite(self):
        fecha_limite = self.cleaned_data.get('fecha_devolucion_limite')
        hoy = timezone.now().date()
        maximo_permitido = hoy + timedelta(days=30)
 
        if fecha_limite < hoy:
            raise forms.ValidationError("La fecha de devolución no puede ser una fecha pasada.")
        if fecha_limite > maximo_permitido:
            raise forms.ValidationError("El período máximo de préstamo de la biblioteca es de 30 días.")
        return fecha_limite

Ejercicio 3.2: Acción Personalizada en Django Admin con Mensajes

Escribe una acción en SolicitudPrestamoAdmin que permita seleccionar múltiples solicitudes atrasadas y condonar sus multas acumuladas poniéndolas en $0.00.

Ver Solución Explicada

solucion_condonar_admin.py

PYTHON

@admin.action(description="Condonar multas acumuladas a los préstamos seleccionados")
def condonar_multas(modeladmin, request, queryset):
    afectados = queryset.filter(multa_acumulada__gt=0).update(multa_acumulada=0.00)
    modeladmin.message_user(
        request,
        f"Se han condonado las multas de {afectados} préstamo(s) con éxito.",
        messages.SUCCESS
    )
 
@admin.register(SolicitudPrestamo)
class SolicitudPrestamoAdmin(admin.ModelAdmin):
    list_display = ['id', 'usuario', 'libro', 'estado', 'multa_acumulada']
    actions = [condonar_multas]

4. Desafío Práctico: Segundo Proyecto — Tienda Online (`tienda`) 🛒

Implementa el panel administrativo y los formularios CRUD del segundo proyecto ubicado en C:\proyectos\django\tienda.

Reto 4.1: PedidoAdmin con TabularInline de Ítems y Acción de Despacho

En pedidos/admin.py, registra Pedido con una relación tabular de ItemPedidoInline para ver los productos comprados, cantidades y subtotales en la misma vista de administración. Añade una acción para marcar los pedidos seleccionados como 'ENVIADO'.

Ver Solución Explicada

solucion_pedido_admin.py

PYTHON

# pedidos/admin.py
from django.contrib import admin
from .models import Pedido, ItemPedido
 
class ItemPedidoInline(admin.TabularInline):
    model = ItemPedido
    extra = 0
    raw_id_fields = ['producto']
    readonly_fields = ['precio_unitario', 'subtotal']
 
@admin.action(description="Marcar pedidos seleccionados como ENVIADOS")
def marcar_como_enviado(modeladmin, request, queryset):
    actualizados = queryset.filter(estado='PAGADO').update(estado='ENVIADO')
    modeladmin.message_user(request, f"{actualizados} pedidos marcados como despachados.")
 
@admin.register(Pedido)
class PedidoAdmin(admin.ModelAdmin):
    list_display = ['id', 'numero_seguimiento', 'cliente', 'estado', 'total', 'fecha_creacion']
    list_filter = ['estado', 'fecha_creacion']
    search_fields = ['id', 'cliente__user__username', 'numero_seguimiento']
    inlines = [ItemPedidoInline]
    actions = [marcar_como_enviado]

Reto 4.2: ModelForm con Validación Cruzada (Precio vs Costo)

En catalogo/forms.py, crea ProductoForm garantizando que: 1. El SKU se guarde siempre en mayúsculas y tenga al menos 4 caracteres. 2. El precio de venta nunca sea inferior al costo de adquisición.

Ver Solución Explicada

solucion_producto_form.py

PYTHON

# catalogo/forms.py
from django import forms
from .models import Producto
 
class ProductoForm(forms.ModelForm):
    class Meta:
        model = Producto
        fields = ['sku', 'nombre', 'categoria', 'descripcion', 'precio', 'costo', 'stock', 'destacado']
 
    def clean_sku(self):
        sku = self.cleaned_data.get('sku', '').strip().upper()
        if len(sku) < 4:
            raise forms.ValidationError("El código SKU debe contener al menos 4 caracteres.")
        return sku
 
    def clean(self):
        cleaned_data = super().clean()
        precio = cleaned_data.get('precio')
        costo = cleaned_data.get('costo')
 
        if precio is not None and costo is not None:
            if precio < costo:
                raise forms.ValidationError({
                    'precio': "El precio de venta no puede ser menor al costo comercial del producto."
                })
        return cleaned_data

Reto 4.3: Vista de Eliminación Suave (Soft Delete)

En comercio electrónico nunca se borra físicamente un producto si ya forma parte del historial de compras de clientes pasados (provocaría error de integridad referencial). Escribe una vista FBV desactivar_producto(request, pk) que al recibir un POST cambie disponible = False en vez de ejecutar delete().

Ver Solución Explicada

soft_delete_view.py

PYTHON

# catalogo/views.py
from django.shortcuts import get_object_or_404, redirect, render
from django.contrib import messages
from .models import Producto
 
def desactivar_producto_view(request, pk):
    producto = get_object_or_404(Producto, pk=pk)
    
    if request.method == 'POST':
        # Soft delete: se desactiva sin borrarlo de la base de datos
        producto.disponible = False
        producto.save(update_fields=['disponible'])
        messages.warning(request, f"El producto '{producto.nombre}' ha sido desactivado del catálogo.")
        return redirect('catalogo:lista')
        
    return render(request, 'catalogo/producto_confirm_deactivate.html', {'producto': producto})

Contenido

📚 Cursos de Café y Código

6. Django Admin y Vistas CRUD ⚙️

1. El Panel Administrativo de Django (Django Admin)

1.1 Creación del Superusuario

1.2 Registro Profesional de Modelos en admin.py

2. Arquitectura de Cada Vista CRUD (Create, Read, Update, Delete)

2.1 Formularios Basados en Modelos (ModelForm)

2.2 Implementación de Cada Vista CRUD (FBV vs CBV)

⚡ Laboratorio Interactivo: Simulador de Django Admin y CRUD

Django Admin & CRUD Simulator

3. Ejercicios Didácticos: Proyecto 1 (Biblioteca)

Ejercicio 3.1: Formulario con Validación de Préstamos

Ejercicio 3.2: Acción Personalizada en Django Admin con Mensajes

4. Desafío Práctico: Segundo Proyecto — Tienda Online (`tienda`) 🛒

Reto 4.1: PedidoAdmin con TabularInline de Ítems y Acción de Despacho

Reto 4.2: ModelForm con Validación Cruzada (Precio vs Costo)

Reto 4.3: Vista de Eliminación Suave (Soft Delete)

Ponte a prueba

¡Hecho con mucho cariño! ☕