Configuración del Entorno Local

Configuración del Entorno Local

Para poner en marcha el entorno de desarrollo local de uunit9, se utiliza el script idempotente scripts/dev-setup.sh.

Requisitos Previos

• Node.js: v20+ / v22+
• pnpm: v10+
• Docker y Docker Compose
• Bash y Python 3 (usado por utilidades internas de prueba)

Paso a Paso con dev:setup

Ejecuta en la raíz del repositorio:

pnpm dev:setup

El script realiza automáticamente las siguientes acciones:

1. Variables de entorno: Copia .env.example a .env y apps/api/.env si no existen.
2. Servicios Docker: Ejecuta docker compose up -d db redis mailpit.
3. Verificación de Postgres: Espera a que PostgreSQL esté listo en el puerto 5433.
4. Instalación de dependencias: Ejecuta pnpm install.
5. Esquema y datos demo: Aplica drizzle-kit push --force y siembra datos con pnpm --filter @uunit9/db db:seed.
6. Ollama (Opcional): Verifica la presencia de Ollama en localhost:11434 para las funciones de IA.

Puerto y Servicios

Servicio	URL / Puerto	Descripción
Web SPA	http://localhost:5175	Aplicación frontend React
API REST	http://localhost:3001/api/health	Backend Hono
Mailpit	http://localhost:8026	Cliente de prueba de correos
PostgreSQL	localhost:5433	Base de datos (postgres/postgres)
Redis	localhost:6379	Servidor de caché y pub/sub

Iniciar Servidor de Desarrollo

Una vez completado el setup, arranca el monorepo con:

pnpm dev