Gestor de Iniciativas Ecológicas: Django (Parte 2)

Tutorial 2: Creación de Modelos, Superusuario, Uso de Fixtures y Personalización del Panel de Administración

Objetivo: En este tutorial, aprenderás a crear modelos en Django, crear un superusuario para gestionar los datos desde el panel de administración, cargar datos iniciales mediante archivos fixtures, y personalizar el panel de administración para facilitar la gestión de datos.

Paso 1: Creación de los Modelos de Iniciativas y Categorías

Primero, vamos a definir los modelos que necesitamos para nuestras iniciativas ecológicas y sus categorías.

• Definir los modelos en models.py:

  • El modelo Categoria representará los distintos tipos de iniciativas, como "Reciclaje" o "Reforestación".
  • El modelo Iniciativa contendrá los detalles de cada iniciativa, vinculándola con una categoría.

Abre el archivo models.py de la aplicación iniciativas y añade el siguiente código:

   from django.db import models

   class Categoria(models.Model):
       nombre = models.CharField(max_length=100)

       def __str__(self):
           return self.nombre

   class Iniciativa(models.Model):
       nombre = models.CharField(max_length=200)
       descripcion = models.TextField()
       categoria = models.ForeignKey(Categoria, on_delete=models.CASCADE)
       direccion = models.CharField(max_length=255)
       fecha_creacion = models.DateTimeField(auto_now_add=True)

       def __str__(self):
           return self.nombre

• Categoria: Tiene solo un campo nombre para especificar el tipo de iniciativa.

• Iniciativa: Almacena el nombre, descripción, categoría, dirección y la fecha en que fue creada la iniciativa.

  • Realizar las migraciones:

Una vez creados los modelos, necesitamos aplicarlos en la base de datos.

• Ejecuta los siguientes comandos en la terminal:

   poetry run python manage.py makemigrations
   poetry run python manage.py migrate

Esto generará las tablas correspondientes en la base de datos para las iniciativas y categorías.

Paso 2: Añadir Campos de Geolocalización a Iniciativas

En algunos casos, es posible que necesitemos hacer cambios en los modelos ya existentes. Ahora simularemos que se ha decidido agregar campos de geolocalización (ubicacion_lat y ubicacion_lng) al modelo de Iniciativa.

• Modificar el modelo Iniciativa:

Vamos a actualizar el modelo para que incluya la latitud y longitud, que serán útiles para marcar las iniciativas en un mapa.

Abre nuevamente el archivo models.py y añade los campos de ubicación:

   class Iniciativa(models.Model):
       nombre = models.CharField(max_length=200)
       descripcion = models.TextField()
       categoria = models.ForeignKey(Categoria, on_delete=models.CASCADE)
       direccion = models.CharField(max_length=255)
       ubicacion_lat = models.DecimalField(max_digits=9, decimal_places=6, null=True, blank=True)
       ubicacion_lng = models.DecimalField(max_digits=9, decimal_places=6, null=True, blank=True)
       fecha_creacion = models.DateTimeField(auto_now_add=True)

       def __str__(self):
           return self.nombre

• ubicacion_lat y ubicacion_lng permiten almacenar las coordenadas de la iniciativa.

  • Realizar una nueva migración:

Cada vez que modifiques un modelo, es necesario realizar una nueva migración.

• Ejecuta:

   poetry run python manage.py makemigrations
   poetry run python manage.py migrate

Este comando aplicará los nuevos cambios a la base de datos.

Paso 3: Crear un Superusuario para el Panel de Administración

Django tiene un poderoso panel de administración que nos permite gestionar los datos. Para acceder a este panel, necesitamos crear un superusuario.

• Crear el superusuario:

  • En la terminal, ejecuta:

   poetry run python manage.py createsuperuser

Sigue las instrucciones, ingresando un nombre de usuario, correo electrónico y una contraseña.

• Acceder al panel de administración:

  • Inicia el servidor de desarrollo:

   poetry run python manage.py runserver

• Abre tu navegador y visita http://127.0.0.1:8000/admin/.
• Ingresa las credenciales del superusuario que acabas de crear para acceder al panel.

Paso 4: Población Inicial de Categorías usando Fixtures

Un fixture es una forma de cargar datos iniciales en la base de datos. Vamos a usar un archivo JSON para cargar algunas categorías de iniciativas.

• Crear un archivo fixtures:

Crea una carpeta fixtures dentro de la aplicación iniciativas:

   mkdir iniciativas/fixtures

Luego, crea un archivo llamado categorias.json dentro de esa carpeta:

   [
       {
           "model": "iniciativas.categoria",
           "pk": 1,
           "fields": {
               "nombre": "Reciclaje"
           }
       },
       {
           "model": "iniciativas.categoria",
           "pk": 2,
           "fields": {
               "nombre": "Reforestación"
           }
       },
       {
           "model": "iniciativas.categoria",
           "pk": 3,
           "fields": {
               "nombre": "Educación Ambiental"
           }
       },
       {
           "model": "iniciativas.categoria",
           "pk": 4,
           "fields": {
               "nombre": "Energía Renovable"
           }
       },
       {
           "model": "iniciativas.categoria",
           "pk": 5,
           "fields": {
               "nombre": "Agricultura Sostenible"
           }
       }
   ]

Cargar las categorías en la base de datos:

• En la terminal, ejecuta el siguiente comando para cargar las categorías definidas en el archivo JSON:

   poetry run python manage.py loaddata categorias.json

Este comando insertará automáticamente las categorías en la tabla Categoria de la base de datos.

Paso 5: Personalización del Panel de Administración

Ahora, registraremos los modelos Iniciativa y Categoria en el panel de administración de Django para gestionarlos desde allí. Además, personalizaremos la manera en que se muestran los datos.

• Registrar los modelos en el admin:

Abre el archivo admin.py de la aplicación iniciativas y añade el siguiente código:

   from django.contrib import admin
   from .models import Iniciativa, Categoria

   @admin.register(Categoria)
   class CategoriaAdmin(admin.ModelAdmin):
       list_display = ('nombre',)
       search_fields = ('nombre',)

   @admin.register(Iniciativa)
   class IniciativaAdmin(admin.ModelAdmin):
       list_display = ('nombre', 'categoria', 'direccion', 'fecha_creacion')
       search_fields = ('categoria__nombre', 'nombre')
       list_filter = ('categoria',)
       readonly_fields = ('fecha_creacion',)

• Qué hemos añadido:
  • list_display: Controla qué campos se muestran en la lista de iniciativas dentro del admin.
  • search_fields: Permite buscar iniciativas por nombre, dirección y categoría.
  • list_filter: Añade un filtro lateral para filtrar iniciativas por categoría.
  • readonly_fields: Hace que el campo fecha_creacion sea de solo lectura.

Conclusión

En este tutorial, hemos aprendido cómo:

• Crear y modificar modelos en Django.
• Aplicar migraciones y verificar si se han aplicado correctamente.
• Crear un superusuario y acceder al panel de administración.
• Población inicial de categorías usando archivos fixtures.
• Personalizar el panel de administración de Django para facilitar la gestión de los datos.

Este conocimiento te permitirá gestionar eficazmente los modelos y datos en tu proyecto de iniciativas ecológicas. ¡Bien hecho!