Skip to content

1. Introducción

El PDF del documento está |AQUÍ|.

Los códigos del documento están |AQUÍ|.

Este documento es un producto de Claude, la IA de Anthropic. Sigue al documento “Introducción paso a paso al framework web [Symfony]” (2026), que a su vez siguió a los documentos “Introducción paso a paso al framework web [Laravel],” "Introducción paso a paso al framework web [Flask]," "Introducción paso a paso al framework web [Spring MVC]," "Introducción paso a paso al framework web [ASP.NET Core MVC]," y "Introducción paso a paso al framework web [NestJS]" (2026). Este documento deja el mundo [PHP] para volver al lenguaje [Python], el del curso de [Flask], pero con un framework de una escala completamente distinta:

  • el framework [Symfony] se reemplaza por el framework [Django] 6.1, que utiliza el lenguaje [Python] (versión 3.12 o posterior);
  • las vistas [Twig] se reemplazan por las plantillas de [Django], escritas en su lenguaje de plantillas, DTL (Django Template Language);
  • los componentes Form y Validator de [Symfony] se reemplazan por los formularios de [Django] (el módulo [django.forms]), que describen a la vez los campos de un formulario HTML, su conversión y su validación;
  • el componente Security de [Symfony] (firewall, autenticadores, roles) se reemplaza por middleware y decoradores escritos específicamente para este fin, con la biblioteca [PyJWT] para los tokens JWT y la biblioteca [bcrypt] para las contraseñas;
  • los escuchadores de eventos de [Symfony] se reemplazan por el middleware de [Django], que envuelve el procesamiento de cada solicitud, y por sus señales;
  • el ORM se reemplaza por el ORM de [Django], que sigue basándose en [MySQL].

El documento sigue de cerca la estructura del curso de [Symfony]: primero, numerosos proyectos pequeños, cada uno centrado en un solo concepto, seguidos de un caso de estudio completo (una aplicación web para gestionar citas en un consultorio médico) con todos los archivos comentados en detalle. Los ejemplos tienen los mismos números y abordan los mismos temas que en los cursos de [Symfony], [Laravel], [Flask], [Spring MVC] y [ASP.NET Core MVC]: un lector que conozca alguno de estos cursos puede comparar los frameworks caso por caso. Sin embargo, esto no es necesario: este documento es autosuficiente y no supone ningún conocimiento previo de esos frameworks. Los únicos requisitos son una comprensión básica de la programación web (el protocolo HTTP, el lenguaje HTML) y los fundamentos del lenguaje [Python] (variables, listas, diccionarios, funciones, clases, módulos). Las características menos comunes de [Python] utilizadas en los ejemplos (decoradores, clases de datos, anotaciones de tipo, administradores de contexto, generadores, etc.) se explican cuando aparecen por primera vez.

1.1. El papel de Django en una aplicación web

Una aplicación web suele construirse en capas, y cada capa se comunica únicamente con sus vecinas inmediatas:

Image

  • la capa web recibe las solicitudes HTTP del navegador y le devuelve páginas HTML. Es la capa que [Django] nos ayuda a escribir;
  • la capa de negocio contiene las reglas de negocio de la aplicación (por ejemplo, “un paciente solo puede tener una cita próxima”). No sabe nada de la web: podría servir igualmente a una aplicación de línea de comandos;
  • la capa de acceso a datos (capa DAO, por Data Access Object) lee y escribe en la base de datos. Utilizaremos el ORM (Object Relational Mapper) de [Django], que asocia las filas de las tablas con objetos [Python].

La capa web sigue a su vez el patrón MVC (Modelo-Vista-Controlador). Aquí hay que prestar atención a la terminología, porque [Django] no utiliza los términos de MVC en su sentido habitual. La documentación de [Django] habla de la arquitectura MTV (Model–Template–View):

  • lo que MVC llama controlador (C), [Django] lo llama vista: es una función (o una clase) de [Python] que procesa un tipo de solicitud (por ejemplo, [GET /schedule]). Una vista lee los parámetros de la solicitud, invoca la capa de negocio y luego elige la página que se mostrará. En el curso de [Symfony], esto era una acción de un controlador;
  • lo que MVC llama vista (V), [Django] lo llama plantilla: un archivo HTML que contiene expresiones [{{ ... }}] e instrucciones [{% if %}], [{% for %}]..., que el motor de plantillas reemplaza por datos. En el curso de [Symfony], esto era una vista ([Twig]);
  • lo que MVC llama modelo (M), el conjunto de datos que se pasa a la página, [Django] lo llama contexto de la plantilla: un diccionario de [Python];
  • por último, lo que [Django] llama modelo es una clase de [Python] que representa una tabla de la base de datos (el archivo [models.py]): lo que [Symfony] llamaba entidad.

Este documento usa la terminología de [Django], ya que es la que se emplea en su documentación, en sus mensajes de error y en los nombres de archivo ([views.py], [templates], [models.py]): por lo tanto, aquí una vista es siempre la función [Python] que procesa una solicitud, y una plantilla es el archivo HTML que genera la página. El término “modelo” tiene dos significados, que el contexto siempre distingue: en el capítulo 2, el modelo de una vista designa los datos que recibe de la solicitud, descritos mediante una clase; a partir del capítulo 7, un modelo de [Django] es una clase del ORM. Por último, el término “plantilla de página” (o “layout”) designa la plantilla común de la que heredan las demás páginas (ejemplo 15).

El procesamiento de una solicitud sigue los pasos numerados del diagrama:

  • 1: el navegador envía una solicitud, por ejemplo HTTP;
  • 2: el servidor web recibe la solicitud y la transmite a la aplicación [Django] mediante el objeto [application] del archivo [config/wsgi.py]. Durante el desarrollo, este servidor es el que incluye [Django], iniciado con el comando [python manage.py runserver]; en producción será un servidor [Python], como [gunicorn] o [waitress], a menudo colocado detrás de un servidor web como [nginx]. [Django] hace pasar la solicitud por una serie de componentes de middleware, clases de [Django] y de la aplicación que intervienen antes y después de la vista (gestión de sesiones, protección anti-CSRF, configuración del idioma, seguridad, etc.), y compara la ruta solicitada con las rutas de la aplicación, descritas en los archivos [urls.py], para elegir la vista encargada de procesar esta solicitud: esto es el enrutamiento;
  • 3: la vista solicita a la capa de negocio los datos que necesita; la capa de negocio, si es necesario, recurre a la capa DAO, que consulta la base de datos [MySQL] en SQL, a través del ORM;
  • 4: la vista construye el contexto (el modelo M) e indica al motor de plantillas que genere la página (función [render]);
  • 5: la página HTML generada por la plantilla es la respuesta de la vista, que [Django] devuelve al navegador después de hacerla pasar de vuelta por el middleware.

[Django] es, junto con [Flask], uno de los dos grandes frameworks web del mundo [Python]. Gratuito y de código abierto, fue creado en 2003 por Adrian Holovaty y Simon Willison en el Lawrence Journal-World, un periódico de Kansas, y publicado en 2005. Debe su nombre al guitarrista de jazz Django Reinhardt. Hoy lo desarrolla una comunidad bajo los auspicios de la Django Software Foundation y funciona en cualquier lugar donde funcione [Python] ([Windows], [Linux], [macOS]). Lo utilizan sitios web de alto tráfico ([Instagram], [Pinterest], [Mozilla]...). Su lema, “el framework web para perfeccionistas con plazos ajustados”, refleja bien su enfoque: mientras que [Flask] ofrece solo un núcleo que se complementa con extensiones, [Django] viene con “baterías incluidas”: enrutamiento, plantillas, formularios y validación, ORM y migraciones de bases de datos, sesiones, mensajes, traducciones, caché, protección contra ataques comunes (CSRF, inyección SQL, clickjacking) e incluso una interfaz de administración de datos generada automáticamente. Todo esto forma un conjunto coherente, documentado en un solo lugar y diseñado para funcionar en conjunto. En comparación con [Symfony], [Django] toma decisiones distintas: no hay contenedor de servicios ni inyección de dependencias, sino módulos [Python] que se importan; la configuración se escribe en [Python], en un único archivo ([settings.py]), en lugar de en [YAML]; y las vistas son simples funciones. [Django] también sigue un calendario regular de versiones: una versión aproximadamente cada ocho meses, una versión de “soporte a largo plazo” (LTS) cada dos años (5.2 en 2025, 6.2 en 2027), y avisos de obsolescencia que siempre preceden en dos versiones a la eliminación de una funcionalidad. [Django] puede crear servidores que devuelven JSON a un cliente [JavaScript] ([Angular], [React], [Vue.js], [Flutter]...), a menudo con la extensión [Django REST framework], a diferencia de las aplicaciones web tradicionales, en las que el servidor genera las páginas HTML y el navegador se limita a mostrarlas. Este documento examina este segundo caso de uso.

Una diferencia clave con [PHP] explica buena parte de [Django]: la aplicación se carga una sola vez, cuando se inicia el servidor, y luego permanece en memoria para procesar todas las solicitudes posteriores (ejemplo 01). Lo que se construye al iniciar (la configuración, la tabla de enrutamiento, los objetos almacenados en variables de módulo) es compartido por todas las solicitudes. Es lo contrario de [Symfony], que reconstruía la aplicación en cada solicitud: volveremos con frecuencia sobre este punto, en particular en el capítulo sobre los ámbitos de datos.

1.2. Herramientas utilizadas

Los ejemplos se escribieron y probaron con las siguientes herramientas (su instalación se describe en el apéndice):

  • [Python] 3.13 (cualquier versión 3.12 o posterior es adecuada: es el requisito mínimo de [Django] 6.1);
  • [pip], el administrador de bibliotecas de [Python], y el módulo [venv], que crea entornos virtuales (ambos incluidos con [Python]);
  • el editor [Visual Studio Code], junto con las extensiones de Microsoft [Python] y [Pylance] (análisis de código, ejecución, depuración) y una extensión para las plantillas de [Django] (resaltado de sintaxis);
  • un navegador moderno ([Chrome], [Firefox], [Edge]);
  • la herramienta de línea de comandos [curl], que muestra las respuestas HTTP sin procesar (viene incluida con [Windows] 10 y 11);
  • el SGBD [MySQL] 8.4 o posterior (o [MariaDB] 10.11 o posterior), por ejemplo, el de [Laragon] en [Windows], a partir del capítulo sobre el acceso a datos y para el caso de estudio.

[Django] y las demás bibliotecas no forman parte de [Python]: [pip] las descarga del repositorio PyPI (Python Package Index) durante la instalación (por lo que ese día debe tener conexión a Internet) y las instala en un entorno virtual, una carpeta propia de cada proyecto (véase más adelante). Cada proyecto describe sus bibliotecas en un archivo [requirements.txt]. La siguiente tabla enumera las principales, junto con las versiones utilizadas:

Biblioteca
Función
Versión
[Django]
El framework: servidor de desarrollo, enrutamiento, vistas, middleware, plantillas, formularios, sesiones, mensajes, traducciones, caché, ORM; instala las dos bibliotecas que necesita: [asgiref] (el vínculo entre código síncrono y asíncrono) y [sqlparse] (formato de las órdenes SQL mostradas)
6.1.1
[Babel]
Formato de números, importes y fechas según el idioma (ejemplo 16)
2.18.0
[PyJWT]
Tokens JWT (capítulo sobre autenticación)
2.15.0
[mysqlclient]
El controlador de [MySQL] que utiliza [Django] (ejemplo 28 y caso de estudio)
2.3.0
[bcrypt]
Hash de contraseñas (caso de estudio)
5.0.0

[Django] normalmente se instala con [pip], y luego se crea un proyecto con el comando [django-admin startproject], que instala [Django] (véanse los apéndices):

pip install django
django-admin startproject my_project

Este comando crea una carpeta llamada [my_project] que contiene un archivo llamado [manage.py] y un paquete llamado [my_project] formado por cinco archivos ([settings.py], [urls.py], [wsgi.py], [asgi.py], [__init__.py]). Luego se agregan aplicaciones con el comando [python manage.py startapp name], que crea una carpeta con siete archivos. Así se inicia un proyecto real. Con fines didácticos, este método tiene un inconveniente: el archivo [settings.py] generado ya contiene unas cien líneas de código, que activan unas diez aplicaciones y siete componentes de middleware, cuyo propósito aún no queda claro. Por eso los ejemplos de este documento parten del otro extremo: el ejemplo 01 es la aplicación [Django] más pequeña posible, y cada ejemplo agrega únicamente los archivos y la configuración que necesita, escritos y comentados a mano. El caso de estudio final sigue la estructura de una aplicación [Django] estándar.

1.3. Ejecución del caso de estudio

1.3.1. Instalación de Laragon

El caso de estudio requiere el SGBD [MySQL]. Laragon puede proporcionarlo, y más. En septiembre de 2026, Laragon está disponible en la URL y [Download Laragon – Fast & Modern Dev Environment]. Laragon incluye herramientas que permiten instalar un servidor web y el SGBD y [MySQL]:

Image

  • en [1], un servidor web Apache;
  • en [2], el SGBD [MySQL];
  • en [3], una herramienta de mensajería que no utilizaremos;
  • [4] inicia todos los servicios (Apache, [MySQL], MailPit);
  • [5] muestra la página web de la URL [http://localhost]. De forma predeterminada, esta URL corresponde a la carpeta <laragon-install>\www, donde <laragon-install> es la carpeta de instalación de Laragon;
  • en [6], inicia la herramienta HeidiSQL, que permite administrar bases de datos MySQL. Usaremos esta herramienta para crear la base de datos del caso de estudio;
  • en [7], abre una terminal en la que todos los binarios necesarios para Laragon están en el PATH;
  • en [8], abre una ventana del Explorador de Windows en la carpeta asociada a la URL [http://localhost];

La carpeta de instalación de Laragon contiene los siguientes elementos:

Image

en [1], la carpeta [bin] contiene numerosas aplicaciones:

Image

  • en [1], el servidor web Apache;
  • en [2], una terminal de línea de comandos;
  • en [3], un cliente [git] que permite administrar las distintas versiones de un proyecto;
  • en [4], un administrador de bases de datos;
  • [5], un administrador de correo electrónico;
  • en [6], el SGBD y [MySQL];
  • [7], otro servidor web;
  • en [8], [node.js] para ejecutar scripts de JavaScript;
  • [9], un editor de texto;
  • [10], el intérprete de PHP;
  • [11], el intérprete de [Python];
  • [12], un servidor de caché;

Laragon incluye un entorno de desarrollo completo. En este curso solo usaremos el SGBD, [MySQL], [6], y la herramienta [heidisql] para administrarlo gráficamente. Es posible que el intérprete [Python] [11] de Laragon no sea lo bastante reciente para [Django] 6.1 (se necesita la versión 3.12 o posterior): en su lugar, instalaremos [Python] desde su sitio web oficial (véanse los apéndices), marcando en el instalador la casilla que agrega [python] al PATH existente de la máquina.

El archivo README mencionado en el caso de estudio indica que se deben ingresar los siguientes comandos en una ventana de terminal abierta en la carpeta de la aplicación:

python -m venv .venv

para crear un entorno virtual llamado [Python] y una carpeta llamada [.venv], donde se instalarán las bibliotecas de la aplicación;

.venv\Scripts\activate

para activar este entorno en la terminal (en [Linux] y [macOS]: [source .venv/bin/activate]). El indicador de la terminal comienza entonces con [(.venv)];

pip install -r requirements.txt

para instalar las bibliotecas de [Python] necesarias para el caso de estudio ([Django], [mysqlclient], [PyJWT], [bcrypt]);

python manage.py runserver 8081

para ejecutar el caso de estudio. Si usa una terminal [PowerShell] en VSCode, es posible que [PowerShell] se niegue a ejecutar el script de activación y muestre un mensaje que indica que “la ejecución de scripts está deshabilitada en este sistema”. Para habilitarla, solo para su cuenta de usuario, ingrese lo siguiente una vez en una terminal [PowerShell]:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Deberá reiniciar VSCode para que este cambio surta efecto. Como alternativa, en VSCode puede seleccionar una terminal llamada [Command Prompt] en lugar de [PowerShell], donde el script [activate] se ejecuta sin esta autorización.

Para crear la base de datos [MySQL] necesaria para el caso de estudio, proceda de la siguiente manera:

Image

  • en [1], todos los servicios deben estar iniciados;
  • en [2], la opción [Database] permite administrar la base de datos;

La opción [Database] inicia una utilidad llamada HeidiSQL:

Image

  • en [1], puede seleccionar distintas opciones de SGBD. El valor predeterminado es el SGBD MySQL. Es adecuado;
  • en [2], se conecta a HeidiSQL;

Image

Image

  • en [1-2], ejecute el archivo SQL y luego seleccione el archivo [dbrdvmedecins2.sql], que encontrará en la carpeta [django-sept-2026/rdvmedecins2-django/database]:

Image

La ejecución del archivo [3] creará la base de datos [dbrdvmedecins2] que utiliza el caso de estudio. Para verla, presione F5 en HeidiSQL para actualizar la pantalla.

Nota: las siguientes capturas de pantalla muestran una base de datos llamada [dbrdvmedecins], mientras que la base de datos del caso de estudio se llama [dbrdvmedecins2]. Las dos bases de datos son prácticamente idénticas, por lo que consideramos innecesario tomar nuevas capturas.

Image

La base de datos [dbrdvmedecins] ha sido creada. Este es su contenido:

Image

  • en [1-3], la tabla [clients];
    • [id] es la clave primaria de la tabla;
    • [version] es el número de versión de la fila. Este número se incrementa cada vez que se modifica la fila;
    • [titre, nom, prenom] identifica a la persona;

Image

  • en [1-3], la tabla [medecins];
    • [id] es la clave primaria de la tabla;
    • [version] es el número de versión de la fila;
    • [titre, nom, prenom] identifica a la persona;

Image

  • en [1-3], la tabla de los intervalos de citas de los médicos:
    • [id]: clave primaria;
    • [version]: número de versión de la fila;
    • [id_medecin]: clave externa que referencia la clave primaria del médico;
    • [hdebut, mdebut]: hora y minutos del inicio de la cita. Así, [8,20] significa las 8:20 a.m.
    • [hfin, mfin]: hora y minutos del fin de la consulta.

Image

  • en [1-3], la tabla [rv] de las citas programadas;
    • [id]: clave primaria;
    • [version]: número de versión;
    • [jour]: fecha de la cita;
    • [id_creneau]: clave externa que referencia la clave primaria del intervalo de la cita. Como un intervalo está vinculado a un médico, sabemos qué médico atiende esta cita;
    • [id_client]: clave externa al número (clave primaria) del cliente que solicita la cita;

Image

  • en [1-3], la tabla [users], que enumera los usuarios autorizados a utilizar la aplicación;
    • [id, version]: clave primaria, número de versión;
    • [login, password]: credenciales del usuario;
    • [nom]: nombre del usuario;
    • [role]: el rol del usuario. [ADMIN] tiene acceso total; [MEDECIN] consulta su propia agenda; [PATIENT] (un cliente del consultorio) programa y cancela sus propias citas;

1.3.2. Ejecución del caso de estudio

Nota del revisor: aconsejo al lector que realice el caso de estudio de inmediato, tal como se describe a continuación. Una vez que comprenda bien la función de esta aplicación de citas, pida a su IA favorita que modifique la aplicación de la siguiente manera: a partir de ahora, cada médico podrá:

  • definir sus propios intervalos de consulta entre dos fechas. Esto les permitirá ajustar su agenda según sea necesario;
  • quitar ciertos intervalos del calendario en un día determinado, por ejemplo, si no están disponibles por motivos personales;

La modificación no es sencilla, porque implica un cambio en la estructura de la base de datos. Pida a la IA que le proporcione el nuevo código de la aplicación y el script SQL para crear la nueva base de datos. Para ello, deberá entregarle el archivo ZIP con el proyecto completo, así como el script SQL de la base de datos anterior.

Además, no he revisado el curso creado por Claude. Él ya había producido los cursos [NestJS], [ASP.NET Core MVC], [Spring MVC] y [Flask], todos ellos perfectos. Supuse que lo mismo ocurría con este. Si tiene algún problema para entender algo, la solución es siempre la misma: pida a su IA favorita que le explique lo que no comprende. Claude, por ejemplo, es muy bueno para esto. Quizá deba “subirle” el ejemplo que no entiende.

Fin de la nota.

El caso de estudio al final de este documento es una aplicación completa. Es probable que los lectores quieran verla en funcionamiento antes de adentrarse en los detalles del framework: así se ejecuta. Se encuentra en la carpeta [rdvmedecins2-django], junto a la carpeta [examples]:

1
2
3
django-sept-2026/
├── examples/
└── rdvmedecins2-django/

Debe tener instalados [Python] (versión 3.12 o posterior), [Visual Studio Code] y [MySQL] (véanse los apéndices). Luego:

  • Cree la base de datos [dbrdvmedecins2] ejecutando el script [rdvmedecins2-django/database/dbrdvmedecins2.sql]. Con [Laragon], abra la herramienta [HeidiSQL] (botón Database) y ejecute el script desde el menú File / Run SQL (véase más arriba). En la línea de comandos, desde la carpeta [rdvmedecins2-django]:
mysql -u root < database/dbrdvmedecins2.sql
  • Abra la carpeta [rdvmedecins2-django] en [Visual Studio Code] (menú File / Open Folder) y luego abra una terminal (menú Terminal / New Terminal);
  • cree el entorno virtual de la aplicación, actívelo y luego instale sus bibliotecas: [pip] lee el archivo [requirements.txt], descarga [Django] y las demás bibliotecas, y las coloca en la carpeta [.venv] de la aplicación (tarda unas decenas de segundos). En [Windows]:
1
2
3
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
  • En [Linux] y [macOS], el segundo comando es [source .venv/bin/activate]. [Visual Studio Code] muestra una ventana que pregunta si desea usar este entorno para la carpeta: acepte; las terminales que abra después lo activarán automáticamente;
  • verifique la conexión a la base de datos. La aplicación se conecta a [MySQL] en [127.0.0.1], puerto 3306, con el usuario [root] sin contraseña (la configuración predeterminada de [Laragon]). Si su cuenta [root] tiene contraseña, ingrésela en el archivo [.env] de la aplicación, en la línea [DB_PASSWORD=];
  • ejecute la aplicación:
python manage.py runserver 8081
  • [Django] muestra:
1
2
3
4
5
6
7
8
Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).
September 27, 2026 - 19:30:12
Django version 6.1.1, using settings 'config.settings'
Starting development server at http://127.0.0.1:8081/
Quit the server with CTRL-BREAK.

El servidor de desarrollo escucha en el puerto 8081 de la máquina ([127.0.0.1], es decir, [localhost]). Cada solicitud recibida se registrará en la consola, junto con los comandos SQL enviados a la base de datos;

  • Abra la URL [http://localhost:8081] en un navegador:

Image

  • Inicie sesión con una de las cuentas de demostración, cuya contraseña es igual al nombre de usuario: [admin] (administrador), [pelissier], [tatou], [dupont] (médicos), [martin], [durand], [bistrou], [german] (pacientes). También debe ingresar los caracteres de la imagen, en mayúsculas o minúsculas.

Al iniciar, el comando [runserver] verifica el proyecto y, junto con [MySQL], se conecta a la base de datos con ese fin: si la base de datos no está accesible, el servidor no se inicia y la consola muestra el error al final de una larga pila de llamadas. Si el mensaje es [(2002, "Can't connect to server on '127.0.0.1' (10061)")], significa que [MySQL] no se ha iniciado; con [(1045, "Access denied for user 'root'@'localhost' (using password: NO)")], significa que la contraseña es incorrecta; con [(1049, "Unknown database 'dbrdvmedecins2'")], significa que el script SQL no se ejecutó. Si el comando [python manage.py runserver] falla con el mensaje [ModuleNotFoundError: No module named 'django'], significa que el entorno virtual no está activado (o que [pip install] no se ha ejecutado); si el mensaje de error es [Error: That port is already in use.], significa que el puerto 8081 ya está en uso (por otra versión de la aplicación, por ejemplo). El archivo [README.md] de la aplicación describe otros escenarios. Detenga la aplicación con [Ctrl-C] en la terminal ([Ctrl-Pause] en [Windows], como indica el mensaje de [Django], aunque [Ctrl-C] también funciona).

Una vez que el lector comprenda bien la función de esta aplicación de citas, puede pedir a su IA favorita que la modifique de la siguiente manera: a partir de ahora, cada médico podrá:

  • definir sus propios intervalos de cita entre dos fechas. Esto les permitirá ajustar su agenda según sea necesario;
  • quitar ciertos intervalos del calendario en un día determinado, por ejemplo, si no están disponibles por motivos personales.

La modificación no es sencilla, porque implica un cambio en la estructura de la base de datos. Debe pedir a la IA el nuevo código de la aplicación y el script SQL que crea la nueva base de datos, entregándole el archivo ZIP con el proyecto completo, así como el script SQL de la base de datos anterior. Del mismo modo, si encuentra en este documento un punto que no comprende, la solución es siempre la misma: pida a su IA favorita que le explique lo que no entiende, proporcionándole el ejemplo correspondiente si es necesario.

El caso de estudio al final del documento muestra cómo usar la aplicación y luego explica cada uno de sus archivos.

1.4. Ejemplos

Los ejemplos se encuentran en la carpeta [examples], con una subcarpeta por ejemplo:

examples/
├── 01-structure/
├── 02-routing/
├── ...
├── 28-layers/
├── common/
│   ├── static/
│   │   └── bootstrap/
│   └── README.md
└── requirements.txt

Cada ejemplo es una pequeña aplicación ([Django]) que se ejecuta por sí sola. Todos los ejemplos usan las mismas bibliotecas, descritas en el archivo [examples/requirements.txt]:

1
2
3
4
5
6
# las bibliotecas de los ejemplos, instaladas de una vez por todas en el entorno
# virtual de la carpeta de ejemplos: pip install -r requirements.txt
Django==6.1.1
mysqlclient==2.3.0
PyJWT==2.15.0
Babel==2.18.0
  • líneas 1–2: comentarios; en [Python], como en este archivo, un comentario se extiende desde [#] hasta el final de la línea;
  • líneas 3–6: las bibliotecas, una por línea, con sus versiones exactas: [Django] en sí, [mysqlclient] (acceso a [MySQL], ejemplo 28), [PyJWT] (los tokens JWT, ejemplo 25) y [Babel] (formato de números y fechas según el idioma, ejemplo 16). El operador [==] impone la versión; [>=6.1,<6.2] aceptaría todas las versiones 6.1.x. Las dos bibliotecas que requiere [Django] ([asgiref], [sqlparse]) no aparecen en la lista: [pip] las instala automáticamente, ya que [Django] las declara.

[Python] reconoce una sola carpeta de bibliotecas por intérprete. Para que cada proyecto tenga sus propias bibliotecas en las versiones adecuadas, se crea un entorno virtual: una carpeta que contiene una copia ligera del intérprete y su propia carpeta de bibliotecas ([Lib/site-packages] en [Windows], [lib/python3.13/site-packages] en los demás sistemas). Para ejecutar los ejemplos, cree un entorno virtual e instale allí sus bibliotecas, una vez y para siempre, en una terminal abierta en la carpeta [examples]:

1
2
3
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

[python -m venv .venv] ejecuta el módulo [venv] de [Python], que crea el entorno en la carpeta [.venv]. El script [activate] (en [Linux] y [macOS]: [source .venv/bin/activate]) modifica el PATH de la terminal: los comandos [python] y [pip] pasan entonces a referirse a los del entorno, y el indicador comienza con [(.venv)]. [pip install -r requirements.txt] instala las bibliotecas del archivo. El entorno [examples/.venv] es compartido por los 28 ejemplos: se activa en cada terminal donde se quiera ejecutar alguno. El comando [pip list] muestra las bibliotecas instaladas, y [deactivate] desactiva el entorno. La carpeta [common] contiene el framework CSS [Bootstrap] ([common/static/bootstrap]), compartido por los ejemplos que dan formato a sus páginas (a partir del ejemplo 15).

Casi todos los ejemplos tienen la misma estructura, la de un proyecto [Django] estándar, reducido a lo esencial. Por ejemplo, la estructura del ejemplo 13:

13-first-view/
├── config/
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── pages/
│   ├── __init__.py
│   ├── urls.py
│   ├── viewmodels.py
│   └── views.py
├── templates/
│   └── pages/
│       ├── index.html
│       └── unknown.html
└── manage.py
  • [manage.py]: la herramienta de línea de comandos del proyecto, que en particular inicia el servidor de desarrollo (ejemplo 01);
  • [config]: el paquete de configuración del proyecto: su configuración ([settings.py]), sus rutas ([urls.py], ejemplo 02) y su punto de entrada para un servidor web ([wsgi.py]). Un proyecto creado con [django-admin startproject] da a este paquete el nombre del proyecto; en todos los ejemplos lo llamamos [config] para aclarar su función;
  • [pages]: una aplicación [Django]: un paquete [Python] que agrupa las vistas ([views.py]), sus rutas ([urls.py]) y las clases que necesitan. Un proyecto es un conjunto de aplicaciones, que la configuración [INSTALLED_APPS] enumera (ejemplo 02);
  • [templates]: las plantillas (a partir del capítulo sobre plantillas).

Para ejecutar un ejemplo, abra una terminal en su carpeta (en [Visual Studio Code]: haga clic con el botón derecho en la carpeta del ejemplo y seleccione "Open in the built-in terminal"), active el entorno virtual de los ejemplos ([..\.venv\Scripts\activate] en [Windows], [source ../.venv/bin/activate] en los demás sistemas) y escriba:

python manage.py runserver

Todos los ejemplos escuchan en el puerto 8000: solo se puede ejecutar uno a la vez (o hay que cambiar el puerto: [python manage.py runserver 8001]). Detenga el servidor con [Ctrl-C] en la terminal. No es necesario reiniciar el servidor después de modificar un archivo [Python] o una plantilla: el servidor de desarrollo supervisa los archivos del proyecto y se reinicia automáticamente cuando alguno cambia (ejemplo 01).

Cuando abra la carpeta [examples] en [Visual Studio Code], debe indicar el intérprete del entorno virtual a la extensión [Python] (comando Python: Select Interpreter en la paleta de comandos, [Ctrl-Maj-P], y luego [.venv\Scripts\python.exe]): la extensión [Pylance] analiza entonces todos los archivos con las bibliotecas del entorno, incluida [Django]: en cada archivo se puede aprovechar la finalización de código, la navegación a la definición de una clase o función (tecla [F12]) y la notificación de errores. Como todos los ejemplos incluyen un paquete [config], el análisis puede confundir los paquetes de dos ejemplos; esto no afecta la ejecución, ya que cada ejemplo se ejecuta por separado desde su propia carpeta. Para evitar esta confusión, basta con abrir directamente la carpeta del ejemplo.

1.5. Contenido del documento

El documento está organizado de la siguiente manera:

Capítulo
Tema
Ejemplos
Vistas, enrutamiento, respuestas
De la solicitud a la vista: rutas, aplicaciones, respuestas, redirecciones, servicios compartidos
01 a 06
La vista de la plantilla
Parámetros de la solicitud: lectura, conversión, validación mediante los formularios de [Django], solicitudes POST
07 a 12
Plantillas y formularios
el lenguaje de plantillas de [Django], plantillas de página, fragmentos, etiquetas y filtros personalizados, formularios, validación, PRG, protección anti-CSRF
13 a 21
Internacionalización
Una aplicación en francés e inglés
22
Ámbitos de datos
solicitud, sesión, caché, cookies
23
El ciclo de vida de una solicitud
señales, middleware, convertidores de ruta, manejo de errores
24
Autenticación y autorización
token JWT en una cookie, middleware de autenticación, decoradores, roles, CAPTCHA, límite de intentos
25–27
Arquitectura en capas y acceso a datos
Web / Negocio / DAO con el ORM de [Django] y [MySQL]
28
Caso de estudio
La aplicación RdvMedecins, explicada archivo por archivo
-

Cada ejemplo introduce solo unos pocos conceptos nuevos, y los capítulos se apoyan unos en otros: lo mejor es leerlos en orden. El caso de estudio, en cambio, recurre a todos los conceptos de los capítulos anteriores: siempre que corresponde, su comentario remite al ejemplo donde se introdujo el concepto. Los apéndices describen la instalación de las herramientas: [Python], [pip], y los entornos virtuales, [Visual Studio Code] y sus extensiones, [MySQL] junto con [Laragon], [curl] y la herramienta [django-admin].