miinventario-v2/docs/90-transversal/GUIA-DESPLIEGUE.md

id	type	status	version	created_date	updated_date	simco_version	author
GUIA-DESPLIEGUE	Guide	Vigente	1.0.0	2026-01-13	2026-01-13	4.0.0	Agente Arquitecto de Documentación

Guía de Despliegue - MiInventario

1. Requisitos Previos

1.1 Software Requerido

Software	Versión	Propósito
Docker	24.x+	Contenedores
Docker Compose	2.x+	Orquestación
Node.js	18.x+	Runtime
npm	9.x+	Gestión de paquetes

1.2 Recursos Mínimos

• CPU: 2 cores
• RAM: 4 GB
• Disco: 10 GB libres

2. Despliegue Local (Desarrollo)

2.1 Clonar Repositorio

git clone <repo-url> miinventario
cd miinventario

2.2 Configurar Variables de Entorno

# Copiar template de variables
cp .env.example .env

# Editar variables obligatorias
nano .env

Variables obligatorias:

• JWT_SECRET - Generar con: openssl rand -base64 32
• STRIPE_SECRET_KEY - Obtener de dashboard Stripe
• AI_API_KEY - API key de OpenAI o Anthropic

2.3 Iniciar Servicios Docker

# Levantar PostgreSQL, Redis, MinIO
docker-compose up -d

# Verificar que los servicios están corriendo
docker-compose ps

2.4 Instalar Dependencias

npm install

2.5 Ejecutar Migraciones

npm run db:migrate

2.6 Cargar Datos Iniciales (Seeds)

npm run db:seed

2.7 Iniciar Aplicación

# Backend (puerto 3142)
npm run dev:backend

# Mobile (puerto 8082)
npm run dev:mobile

3. Despliegue Producción

3.1 Build de Producción

# Backend
npm run build:backend

# Mobile (generar APK/IPA)
cd apps/mobile
eas build --platform android --profile production
eas build --platform ios --profile production

3.2 Variables de Producción

Asegurar que estas variables estén configuradas:

Variable	Descripción
NODE_ENV	production
DATABASE_URL	URL PostgreSQL producción
REDIS_URL	URL Redis producción
S3_ENDPOINT	Endpoint S3/MinIO producción
STRIPE_SECRET_KEY	Key producción Stripe
STRIPE_WEBHOOK_SECRET	Secret para webhooks

3.3 Docker Compose Producción

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

4. Verificación de Despliegue

4.1 Health Check Backend

curl http://localhost:3142/api/health
# Respuesta esperada: { "status": "ok" }

4.2 Verificar Base de Datos

docker exec -it miinventario-postgres psql -U postgres -d miinventario_dev -c "\dt"
# Debe mostrar 21 tablas

4.3 Verificar Redis

docker exec -it miinventario-redis redis-cli ping
# Respuesta esperada: PONG

4.4 Verificar MinIO

Acceder a http://localhost:9003 con credenciales:

• Usuario: minioadmin
• Contraseña: minioadmin

5. Troubleshooting

5.1 Error: Puerto ya en uso

# Identificar proceso usando el puerto
lsof -i :3142

# Matar proceso
kill -9 <PID>

5.2 Error: Conexión a PostgreSQL rechazada

# Verificar que el contenedor está corriendo
docker-compose ps postgres

# Ver logs del contenedor
docker-compose logs postgres

5.3 Error: Migraciones fallan

# Recrear base de datos
./database/scripts/recreate-db.sh

# Volver a ejecutar migraciones
npm run db:migrate

5.4 Error: MinIO no accesible

# Verificar permisos del bucket
docker exec -it miinventario-minio mc ls local/miinventario

6. Monitoreo

6.1 Logs en Tiempo Real

# Todos los servicios
docker-compose logs -f

# Solo backend
docker-compose logs -f backend

# Solo base de datos
docker-compose logs -f postgres

6.2 Métricas de Recursos

docker stats

7. Backup y Restauración

7.1 Backup de Base de Datos

docker exec -t miinventario-postgres pg_dump -U postgres miinventario_dev > backup.sql

7.2 Restaurar Base de Datos

docker exec -i miinventario-postgres psql -U postgres miinventario_dev < backup.sql

---

Documento creado: 2026-01-13 Última actualización: 2026-01-13 Versión: 1.0.0