Introducción a Django

# models.py
from django.db import models
from django.contrib.auth.models import User
from django.urls import reverse

class Categoria(models.Model):
    nombre = models.CharField(max_length=100, unique=True)
    descripcion = models.TextField(blank=True)
    activa = models.BooleanField(default=True)
    fecha_creacion = models.DateTimeField(auto_now_add=True)
    
    class Meta:
        verbose_name = "Categoría"
        verbose_name_plural = "Categorías"
        ordering = ['nombre']
    
    def __str__(self):
        return self.nombre

class Articulo(models.Model):
    ESTADO_CHOICES = [
        ('borrador', 'Borrador'),
        ('publicado', 'Publicado'),
        ('archivado', 'Archivado'),
    ]
    
    titulo = models.CharField(max_length=200)
    slug = models.SlugField(unique=True)
    contenido = models.TextField()
    resumen = models.CharField(max_length=300, blank=True)
    autor = models.ForeignKey(User, on_delete=models.CASCADE)
    categoria = models.ForeignKey(Categoria, on_delete=models.SET_NULL, null=True)
    etiquetas = models.ManyToManyField('Etiqueta', blank=True)
    imagen = models.ImageField(upload_to='articulos/', blank=True, null=True)
    estado = models.CharField(max_length=20, choices=ESTADO_CHOICES, default='borrador')
    fecha_creacion = models.DateTimeField(auto_now_add=True)
    fecha_actualizacion = models.DateTimeField(auto_now=True)
    vistas = models.PositiveIntegerField(default=0)
    
    class Meta:
        ordering = ['-fecha_creacion']
        indexes = [
            models.Index(fields=['estado', 'fecha_creacion']),
        ]
    
    def __str__(self):
        return self.titulo
    
    def get_absolute_url(self):
        return reverse('blog:detalle', kwargs={'slug': self.slug})
    
    @property
    def es_reciente(self):
        from django.utils import timezone
        from datetime import timedelta
        return self.fecha_creacion >= timezone.now() - timedelta(days=7)

class Etiqueta(models.Model):
    nombre = models.CharField(max_length=50, unique=True)
    color = models.CharField(max_length=7, default='#007bff')  # Color hexadecimal
    
    def __str__(self):
        return self.nombre

# Ejemplos de uso del ORM de Django

# Crear objetos
categoria = Categoria.objects.create(
    nombre="Tecnología",
    descripcion="Artículos sobre tecnología"
)

articulo = Articulo(
    titulo="Mi primer artículo",
    contenido="Contenido del artículo...",
    autor=request.user,
    categoria=categoria
)
articulo.save()

# Consultas básicas
todos_articulos = Articulo.objects.all()
articulos_publicados = Articulo.objects.filter(estado='publicado')
articulo_especifico = Articulo.objects.get(id=1)

# Consultas avanzadas
articulos_recientes = Articulo.objects.filter(
    fecha_creacion__gte=timezone.now() - timedelta(days=30)
).order_by('-fecha_creacion')

# Consultas con relaciones
articulos_con_categoria = Articulo.objects.select_related('categoria', 'autor')
articulos_con_etiquetas = Articulo.objects.prefetch_related('etiquetas')

# Agregaciones
from django.db.models import Count, Avg
stats = Articulo.objects.aggregate(
    total=Count('id'),
    promedio_vistas=Avg('vistas')
)

# Consultas complejas
articulos_populares = Articulo.objects.filter(
    estado='publicado',
    vistas__gt=100
).exclude(
    categoria__nombre='Privado'
).order_by('-vistas')[:10]

# Búsqueda de texto
from django.db.models import Q
resultados = Articulo.objects.filter(
    Q(titulo__icontains=query) | Q(contenido__icontains=query)
)