Saltar a contenido

Guía de Inicio

Esta guía te ayudará a configurar el entorno de desarrollo para el proyecto Treinar Revalida.

Prerrequisitos

Antes de comenzar, asegúrate de tener instalado lo siguiente:

  • Python 3.11+: Lenguaje base del backend.
  • Docker & Docker Compose: Para la base de datos y servicios auxiliares.
  • Node.js & npm: Necesario para compilar los estilos de Tailwind CSS.
  • Git: Para control de versiones.

Instalación y Configuración

1. Clonar el Repositorio

git clone https://github.com/Nitza-Developement/treinar_revalida.git
cd treinar_revalida

2. Configurar Variables de Entorno

Copia el archivo de ejemplo .env.example a .env:

cp .env.example .env

Edita el archivo .env y ajusta las variables según sea necesario (credenciales de BD, claves de API, etc.).

3. Entorno Virtual (Opcional pero Recomendado)

Si no usas Docker para la aplicación Python, crea un entorno virtual:

python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# .venv\Scripts\activate  # Windows

Instala las dependencias:

pip install -r requirements.txt

4. Base de Datos

Inicia los servicios de Docker (PostgreSQL):

docker-compose -f docker-compose-dev.yml up -d

Aplica las migraciones:

python manage.py migrate

Ejecución del Servidor

Para desarrollo, utilizamos un comando que levanta tanto el servidor de Django como el watcher de Tailwind CSS:

python manage.py tailwind dev

El sitio estará disponible en http://localhost:8000.

Comandos Útiles

  • Crear superusuario: python manage.py createsuperuser
  • Ejecutar tests: pytest
  • Recopilar estáticos: python manage.py collectstatic