Setup

Setup

Primera vez

cp .env.example .env

Todos los valores por defecto funcionan out-of-the-box. Ver [[environment|Environment]] para referencia de variables.

Levantar el stack

# Backend (PostgreSQL + Django API)
docker compose up -d

El entrypoint.sh ejecuta 6 pasos automáticamente:

1. migrate — aplica migraciones pendientes
2. create_superuser — crea [email protected] (idempotente)
3. loaddata — carga los fixtures mock_clinic.yaml y mock_employees.yaml (solo en config.settings.local)
4. collectstatic
5. flushexpiredtokens — limpia blacklist JWT
6. Arranca uvicorn con hot-reload

Ver [[mock-data|Mock Data]] para el detalle del flujo de fixtures. Ver [[docker|Docker]] para comandos de contenedor.

# Frontend (Angular dev server)
cd frontend
bun install               # solo primera vez o tras cambios de deps
bun start                 # dev server en :4200, proxy → :8000

Verificar

curl http://localhost:8000/api/health/   # {"status":"healthy","database":"connected"}
curl http://localhost:4200/api/health/   # mismo JSON vía proxy Angular

El superuser del admin Django es [email protected] / Vanevan3. Ver [[admin|Admin]].

Comandos frecuentes

# Stack
docker compose logs -f api               # tail logs Django
docker compose down                      # bajar el stack
docker compose down -v                   # bajar + borrar volúmenes (DB limpia)

# Frontend
bun test                                 # vitest, modo watch
bun run build                            # build producción

# Backend (dentro del contenedor)
docker compose exec api python manage.py makemigrations
docker compose exec api python manage.py migrate
docker compose exec api pytest