Django Guía

14. Setup del Proyecto y Configuración Inicial

Esta sección cubre los pasos necesarios para levantar el proyecto desde cero en un entorno local, algo fundamental para empezar a trabajar.

Para trabajar con este proyecto profesional de Django, es necesario configurar correctamente el entorno de desarrollo. A continuación, detallamos el proceso paso a paso.

Prerrequisitos

  • Python 3.12+ instalado en tu sistema.
  • Git para el control de versiones.
  • Un editor de código como VS Code.

Paso 1: Clonar el Repositorio

Primero, obtén una copia del código fuente en tu máquina local:

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

Paso 2: Crear y Activar Entorno Virtual

Es una buena práctica aislar las dependencias del proyecto.

Windows

python -m venv venv
.\venv\Scripts\activate

macOS / Linux

python3 -m venv venv
source venv/bin/activate

Paso 3: Instalar Dependencias

Con el entorno virtual activado, instala las librerías necesarias listadas en requirements.txt:

pip install -r requirements.txt

Paso 4: Variables de Entorno

El proyecto utiliza python-decouple para gestionar configuraciones sensibles. Debes crear un archivo .env en la raíz del proyecto (al mismo nivel que requirements.txt).

Puedes copiar el archivo de ejemplo:

cp .env.example .env

O crear uno manualmente con el siguiente contenido mínimo para desarrollo:

# .env
DEBUG=True
SECRET_KEY=tu-clave-secreta-para-desarrollo-12345
ALLOWED_HOSTS=127.0.0.1,localhost
DATABASE_URL=sqlite:///db.sqlite3

Paso 5: Aplicar Migraciones

Django necesita crear las tablas en la base de datos. Ejecuta las migraciones:

python src/manage.py migrate

Nota: El comando se ejecuta apuntando a src/manage.py porque el proyecto está dentro de la carpeta src.

Paso 6: Crear Superusuario

Para acceder al panel de administración, necesitas un usuario con permisos:

python src/manage.py createsuperuser

Sigue las instrucciones en pantalla para definir usuario, email y contraseña.

Paso 7: Ejecutar el Servidor

Finalmente, levanta el servidor de desarrollo:

python src/manage.py runserver

Ahora puedes acceder a: