Creación del Módulo Home

Prerrequisito: entorno virtual luffy activado

# Navegar al directorio de aplicaciones
cd luffyapi/apps

# Crear nueva aplicación
python ../../manage.py startapp home

Confiugración de Rutas

Ruta Principle (luffyapi/urls.py)

from django.urls import path, include

urlpatterns = [
    path('home/', include('home.urls')),
]

Ruta Secundaria (home/urls.py)

from django.urls import path

urlpatterns = []

Modelo para Banner

Modelo Base (utils/model.py)

from django.db import models

class ModeloBase(models.Model):
    fecha_creacion = models.DateTimeField(auto_now_add=True, verbose_name='Creación')
    fecha_actualizacion = models.DateTimeField(auto_now=True, verbose_name='Actualización')
    eliminado = models.BooleanField(default=False)
    visible = models.BooleanField(default=True)
    prioridad = models.IntegerField()

    class Meta:
        abstract = True

Modelo Banner (home/models.py)

from django.db import models
from utils.model import ModeloBase

class Banner(ModeloBase):
    titulo = models.CharField(max_length=16, unique=True, verbose_name='Título')
    imagen = models.ImageField(upload_to='banners', verbose_name='Imagen')
    enlace = models.CharField(max_length=64, verbose_name='URL destino')
    detalles = models.TextField(verbose_name='Información adicional')

    class Meta:
        db_table = 'luffy_banner'
        verbose_name_plural = 'Banners'

    def __str__(self):
        return self.titulo

Migración de Datos

# Ejecutar en la raíz de luffyapi
python manage.py makemigrations
python manage.py migrate

Registro del Módulo

En settings/dev.py:

INSTALLED_APPS = [
    'rest_framework',
    'home',
]

API para Banners

Serializador (home/serializers.py)

from rest_framework import serializers
from .models import Banner

class BannerSerializer(serializers.ModelSerializer):
    class Meta:
        model = Banner
        fields = ['titulo', 'imagen', 'enlace']

Vista (home/views.py)

from rest_framework.viewsets import GenericViewSet
from rest_framework.mixins import ListModelMixin
from .models import Banner
from .serializers import BannerSerializer

class VistaBanner(GenericViewSet, ListModelMixin):
    queryset = Banner.objects.filter(eliminado=False, visible=True)
    serializer_class = BannerSerializer

Rutas API (home/urls.py)

from django.urls import include, path
from utils.router import router
from .views import VistaBanner

router.register('banners', VistaBanner, 'banners')

urlpatterns = [
    path('', include(router.urls)),
]

Endpoint

http://localhost:8000/home/banners/