Relaciones
Many-to-Many
en Django

from django.db import models


class Curso(models.Model):
    nombre   = models.CharField(max_length=200)
    creditos = models.PositiveIntegerField(default=6)

    def __str__(self):
        return self.nombre


class Estudiante(models.Model):
    nombre = models.CharField(max_length=200)
    email  = models.EmailField(unique=True)

    # 👇 Aquí está la magia: ManyToManyField
    cursos = models.ManyToManyField(
        Curso,
        blank=True,          # permite que un estudiante no tenga cursos
        related_name='estudiantes'  # acceso inverso desde Curso
    )

    def __str__(self):
        return self.nombre

# 1. Generamos el fichero de migración
python manage.py makemigrations academia

# 2. Aplicamos la migración a la base de datos
python manage.py migrate

# Creamos algunos cursos
mate  = Curso.objects.create(nombre="Matemáticas", creditos=6)
prog  = Curso.objects.create(nombre="Programación", creditos=9)
hist  = Curso.objects.create(nombre="Historia", creditos=4)

# Creamos estudiantes
ana   = Estudiante.objects.create(nombre="Ana García", email="ana@uni.es")
luis  = Estudiante.objects.create(nombre="Luis Martín", email="luis@uni.es")
sofia = Estudiante.objects.create(nombre="Sofía Ruiz", email="sofia@uni.es")

# ── ADD: matricular a Ana en Matemáticas y Programación ──
ana.cursos.add(mate, prog)

# También puedes añadir por ID:
ana.cursos.add(3)  # añade el curso con id=3

# ── ALL: ver los cursos de Ana ──
ana.cursos.all()
# <QuerySet [<Curso: Matemáticas>, <Curso: Programación>]>

# ── RELACIÓN INVERSA: ver los estudiantes de Programación ──
prog.estudiantes.all()
# <QuerySet [<Estudiante: Ana García>]>

# ── REMOVE: dar de baja a Ana de Matemáticas ──
ana.cursos.remove(mate)

# ── SET: definir exactamente los cursos de Luis (reemplaza todo) ──
luis.cursos.set([mate, hist])

# ── CLEAR: quitar a Sofía de todos sus cursos ──
sofia.cursos.clear()

# ── COUNT: cuántos cursos tiene Luis ──
luis.cursos.count()  # → 2

# ── EXISTS: ¿está Luis matriculado en Historia? ──
luis.cursos.filter(id=hist.id).exists()  # → True

from django.db.models import Count, Q

# ── 1. Estudiantes matriculados en Programación ──
Estudiante.objects.filter(cursos__nombre="Programación")

# ── 2. Cursos que tiene Ana García ──
Curso.objects.filter(estudiantes__nombre="Ana García")

# ── 3. Cursos con MÁS de 5 estudiantes ──
Curso.objects\
    .annotate(num_estudiantes=Count('estudiantes'))\
    .filter(num_estudiantes__gt=5)

# ── 4. Estudiantes con AL MENOS 2 cursos, ordenados por nombre ──
Estudiante.objects\
    .annotate(num_cursos=Count('cursos'))\
    .filter(num_cursos__gte=2)\
    .order_by('nombre')

# ── 5. Estudiantes matriculados en Mates O en Programación ──
Estudiante.objects.filter(
    Q(cursos__nombre="Matemáticas") |
    Q(cursos__nombre="Programación")
).distinct()  # distinct() evita duplicados en uniones

# ── 6. Cursos que NO tienen ningún estudiante ──
Curso.objects.filter(estudiantes__isnull=True)

# ── 7. Prefetch para evitar el problema N+1 ──
estudiantes = Estudiante.objects.prefetch_related('cursos')
for est in estudiantes:
    # Este acceso NO lanza una nueva query gracias a prefetch_related
    print(est.nombre, est.cursos.all())

from django.db import models
from django.utils import timezone


class Curso(models.Model):
    nombre   = models.CharField(max_length=200)
    creditos = models.PositiveIntegerField(default=6)

    def __str__(self):
        return self.nombre


class Matricula(models.Model):
    """Tabla intermedia personalizada con datos extra."""
    estudiante    = models.ForeignKey('Estudiante', on_delete=models.CASCADE)
    curso         = models.ForeignKey(Curso, on_delete=models.CASCADE)

    # 👇 Campos extra que necesitamos
    fecha_matricula = models.DateField(default=timezone.now)
    nota_final      = models.FloatField(null=True, blank=True)  # puede estar vacía

    class Meta:
        # Evita que un estudiante se matricule dos veces en el mismo curso
        unique_together = [('estudiante', 'curso')]
        verbose_name = "Matrícula"
        ordering = ['-fecha_matricula']

    def __str__(self):
        return f"{self.estudiante} → {self.curso}"


class Estudiante(models.Model):
    nombre = models.CharField(max_length=200)
    email  = models.EmailField(unique=True)

    # 👇 Usamos through= para indicar nuestra tabla personalizada
    cursos = models.ManyToManyField(
        Curso,
        through=Matricula,
        related_name='estudiantes'
    )

    def __str__(self):
        return self.nombre

from datetime import date

# ── CREAR una matrícula (en lugar de .add()) ──
m = Matricula.objects.create(
    estudiante     = ana,
    curso          = prog,
    fecha_matricula = date.today(),
)

# ── ACTUALIZAR la nota de Ana en Programación ──
m.nota_final = 8.5
m.save()

# ── LEER los cursos de Ana (funciona igual) ──
ana.cursos.all()

# ── LEER la matrícula para ver los datos extra ──
matricula = Matricula.objects.get(estudiante=ana, curso=prog)
print(matricula.nota_final)  # → 8.5

# ── ELIMINAR una matrícula (en lugar de .remove()) ──
Matricula.objects.filter(estudiante=ana, curso=prog).delete()

# ── CONSULTAS avanzadas cruzando through ──
# Estudiantes que han aprobado (nota >= 5) Programación
Estudiante.objects.filter(
    matricula__curso=prog,
    matricula__nota_final__gte=5.0
)

# Cursos en los que Ana tiene nota superior a 7
ana.cursos.filter(matricula__nota_final__gt=7.0)

from django.contrib import admin
from .models import Estudiante, Curso, Matricula


@admin.register(Estudiante)
class EstudianteAdmin(admin.ModelAdmin):
    list_display  = ['nombre', 'email']
    search_fields = ['nombre', 'email']
    # filter_horizontal muestra un selector doble (izquierda/derecha)
    filter_horizontal = ['cursos']


@admin.register(Curso)
class CursoAdmin(admin.ModelAdmin):
    list_display  = ['nombre', 'creditos']
    search_fields = ['nombre']

class MatriculaInline(admin.TabularInline):
    model  = Matricula
    extra  = 1   # cuántos formularios en blanco mostrar
    fields = ['curso', 'fecha_matricula', 'nota_final']


@admin.register(Estudiante)
class EstudianteAdmin(admin.ModelAdmin):
    list_display  = ['nombre', 'email']
    search_fields = ['nombre']
    inlines       = [MatriculaInline]   # las matrículas aparecen dentro del estudiante


@admin.register(Matricula)
class MatriculaAdmin(admin.ModelAdmin):
    list_display   = ['estudiante', 'curso', 'fecha_matricula', 'nota_final']
    list_filter    = ['curso']
    search_fields  = ['estudiante__nombre', 'curso__nombre']