Guía Definitiva de Django

Bienvenido a este repositorio diseñado para aprender Django de manera profunda y práctica. A diferencia de otras guías, este repositorio contiene código fuente validado que acompaña a cada lección, permitiéndote ver cómo funcionan los conceptos en un proyecto real.

🚀 ¿Cómo usar esta guía?

Esta documentación se divide en lecciones que cubren desde lo básico hasta temas avanzados. Cada sección está respaldada por código funcional que puedes encontrar en la carpeta src/ del repositorio.

📚 Índice de Contenidos

• 01. Introducción

  Conceptos básicos y arquitectura.

• 02. Configuración

  Entorno virtual y setup inicial.

• 03. Modelos

  Bases de datos y ORM.

• 04. Vistas y URLs

  Controladores y enrutamiento.

• 05. Plantillas

  Motores de renderizado y herencia.

• 06. Formularios

  Validación y procesamiento de datos.

• 07. Admin Profesional

  Personalización del panel de administración.

• 08. Temas Avanzados

  Middleware, señales y optimización.

• 09. Autenticación

  Gestión de usuarios y permisos.

• 10. Arquitectura Moderna

  MTV, Service Layer y Selectores.

• 11. Patrones de Diseño

  Strategy, Adapter, Factory y Anti-patrones.

• 12. Arquitectura Avanzada

  DDD, Hexagonal, CQRS y Microservicios.

• 13. DevOps & Calidad

  Docker, CI/CD y buenas prácticas.

🚀 Proyectos Reales

• 14. Setup del Proyecto

  Estructura profesional y Docker.

• 15. Autenticación y Login

  Seguridad, Emails y Auth Avanzado.

• 16. Roles y Permisos

  RBAC, Grupos y Protección de Vistas.

• 17. Dashboard ERP

  Analytics, Reportes PDF y Optimización de Datos.

• 18. Plantillas Avanzadas

  Herencia Profunda, Componentes, i18n y Alpine.js.

🛠️ Instalación y Ejecución

Para ejecutar el código de ejemplo en tu máquina local:

1. Clonar el repositorio:

   git clone https://github.com/RchrdMrtnz/Guia_de_Aprendizaje_de_Django.git
   cd Guia_de_Aprendizaje_de_Django

2. Crear y activar un entorno virtual:

   python3 -m venv venv
   source venv/bin/activate  # En Windows: venv\Scripts\activate

3. Instalar dependencias:

   pip install -r requirements.txt

4. Ejecutar migraciones:

   cd src
   python manage.py migrate

5. Correr el servidor:

   python manage.py runserver

✅ Validación del Código

Una característica clave de esta guía es que todo el código está validado mediante pruebas automatizadas. Puedes verificar que todo funciona correctamente ejecutando el script de validación:

# Desde la raíz del repositorio
./validar_codigo.sh

Esto ejecutará la suite de pruebas de Django (tests.py) para asegurar que los modelos y vistas se comportan como se espera.