Proyecto Django — Guía de instalación

Instrucciones paso a paso para clonar, configurar e iniciar el entorno de desarrollo local.

Framework: Django • Python 3 • SQLite

1) Requisitos previos

Python 3.10+ y pip
Git con acceso al repositorio por http
Opcional: virtualenv o venv (integrado en Python)
Navegador web (preferentemente Google Chrome)

2) Clonar el repositorio (https)

git clone https://github.com/Hector2016cgp/Eila-Hackaton.git
cd nameRepo

3) Crear y activar el entorno virtual

Linux / macOS

python3 -m venv venv
source venv/bin/activate

Windows (PowerShell)

python -m venv venv
venv\Scripts\Activate.ps1

Si ves (venv) al inicio de tu terminal, el entorno virtual está activo correctamente.

4) Instalar dependencias

Una vez activado el entorno virtual, instala las librerías necesarias desde el archivo requirements.txt:

pip install --upgrade pip
pip install -r requirements.txt

Este paso descargará todas las dependencias necesarias para ejecutar el proyecto Django correctamente.

5) Migraciones de base de datos

Genera y aplica las migraciones necesarias para inicializar la base de datos:

# Crea migraciones (ajusta los nombres de apps según tu proyecto)
python3 manage.py makemigrations candidatos reclutamiento

# Aplica las migraciones
python3 manage.py migrate

6) (Opcional) Crear un superusuario

python3 manage.py createsuperuser

Esto te permitirá acceder al panel administrativo de Django en http://127.0.0.1:8000/admin/.

7) Ejecutar el servidor local

python3 manage.py runserver

Una vez iniciado, abre en tu navegador: http://127.0.0.1:8000/

8) Estructura del proyecto

REPO/
├─ candidatos/
├─ reclutamiento/
├─ templates/
├─ static/
├─ manage.py
├─ requirements.txt
└─ README.html

9) Problemas comunes

Problema Causa Solución

Problema	Causa	Solución
No se activa el entorno virtual	Ruta o comando incorrecto	Usa `source venv/bin/activate` o `venv\Scripts\Activate.ps1`
Error con dependencias	pip desactualizado	Ejecuta `pip install --upgrade pip` antes de instalar
Falla `makemigrations`	Nombre de app incorrecto	Ejecuta sin parámetros para detectar todas las apps: `python3 manage.py makemigrations`

No se activa el entorno virtual

Ruta o comando incorrecto

Usa source venv/bin/activate o venv\Scripts\Activate.ps1

Error con dependencias

pip desactualizado

Ejecuta pip install --upgrade pip antes de instalar

Falla makemigrations

Nombre de app incorrecto

Ejecuta sin parámetros para detectar todas las apps: python3 manage.py makemigrations