Dev Setup - PROSEGUIT

Levanta el entorno de desarrollo del proyecto.

Sin argumentos o "all": entorno completo

1. Verificar Docker esta corriendo

   docker info > /dev/null 2>&1 || echo "ERROR: Docker no esta corriendo"
   

2. Levantar PostgreSQL

   docker compose up -d postgres
   

3. Instalar dependencias

   npm install
   

4. Correr migraciones

   cd backend && npx prisma migrate dev && cd ..
   

5. Generar Prisma Client

   cd backend && npx prisma generate && cd ..
   

6. Arrancar servidores

   # En terminales separadas:
   cd backend && npm run dev
   cd frontend && npm run dev
   

Argumento "db": solo base de datos

docker compose up -d postgres
cd backend && npx prisma migrate dev && cd ..

Argumento "backend": solo backend

cd backend && npm install && npm run dev

Argumento "frontend": solo frontend

cd frontend && npm install && npm run dev

Migración de datos desde seguit v1

Cuando se trae un dump SQL de seguit v1 (db_seguit1.sql):

1. Colocar db_seguit1.sql en la raíz del proyecto (PROSEGUIT/)
2. Asegurarse de que la DB esté corriendo: docker compose up -d postgres
3. Correr el comando único de migración:

   npm run migrate:v1
   

El comando encadena automáticamente:

• node extract_data.js — extrae datos del SQL a JSON
• Pre-flight checks: verifica conexión, detecta y repara migraciones incompletas (estado_equipo_old)
• prisma migrate deploy — aplica migraciones pendientes
• prisma generate — regenera el cliente
• Importación completa de datos (ubicaciones, tipos, usuarios, equipos, historial, préstamos)

Verificar que todo funciona

• PostgreSQL: docker compose ps (debe mostrar postgres healthy)
• Backend: http://localhost:3001/api/v1/health
• Frontend: http://localhost:5173

Troubleshooting

• Si el puerto 5433 esta ocupado: docker compose down && docker compose up -d postgres
• Si Prisma falla: cd backend && npx prisma migrate reset --force
• Si npm falla: borrar node_modules y reinstalar
• Si migrate:v1 falla con "export_datos_v1.json no encontrado": verificar que db_seguit1.sql está en la raíz
• Si migrate:v1 falla con "No se puede conectar": correr npm run db:up primero