workspace-v1/orchestration/inventarios/PLAN-CORRECCION-PUERTOS.md

PLAN DE CORRECCION DE PUERTOS

Fecha: 2025-12-08 Generado por: Architecture-Analyst Estado: PENDIENTE APROBACION Version: 1.0.0

---

OBJETIVO

Resolver los conflictos de puertos detectados en el workspace, alineando todos los proyectos con el estandar definido (gamilit como referencia).

---

RESUMEN DE CAMBIOS

Tipo	Cantidad
Archivos a modificar	12
Puertos a cambiar	8
Archivos .env.ports a crear	4

---

FASE 1: CORRECCION DE CONFLICTOS P0 (CRITICOS)

1.1 Resolver CONFLICT-001: Puerto 3000

Orden de ejecucion: Uno por uno, verificando que no haya dependencias.

1.1.1 ERP-CORE

# Archivos a modificar:
# - projects/erp-suite/apps/erp-core/.env
# - projects/erp-suite/apps/erp-core/.env.example
# - projects/erp-suite/apps/erp-core/backend/.env.example

# Cambio:
PORT=3000 -> PORT=3106

Checklist:

• Modificar .env
• Modificar .env.example
• Modificar backend/.env.example
• Verificar docker-compose.yml (si tiene)
• Actualizar CORS si aplica
• Test: npm run dev y verificar puerto

---

1.1.2 MECANICAS-DIESEL

# Archivos a modificar:
# - projects/erp-suite/apps/verticales/mecanicas-diesel/.env.example
# - projects/erp-suite/apps/verticales/mecanicas-diesel/docker-compose.yml

# Cambio:
APP_PORT=3000 -> APP_PORT=3166

Checklist:

• Modificar .env.example
• Modificar docker-compose.yml (backend service port)
• Actualizar frontend VITE_API_URL si aplica
• Test: docker-compose up y verificar puerto

---

1.1.3 POS-MICRO

# Archivos a modificar:
# - projects/erp-suite/apps/products/pos-micro/backend/.env.example
# - projects/erp-suite/apps/products/pos-micro/docker-compose.yml
# - projects/erp-suite/apps/products/pos-micro/frontend/.env.example (VITE_API_URL)

# Cambio:
PORT=3000 -> PORT=3226
VITE_API_URL=http://localhost:3000/api/v1 -> http://localhost:3226/api/v1

Checklist:

• Modificar backend/.env.example
• Modificar docker-compose.yml
• Modificar frontend/.env.example (VITE_API_URL)
• Test: docker-compose up y verificar conectividad

---

1.1.4 PLATFORM MARKETING CONTENT

# Archivos a modificar:
# - projects/platform_marketing_content/apps/backend/.env.example

# Cambio:
PORT=3000 -> PORT=3606

Checklist:

• Modificar apps/backend/.env.example
• Crear .env.ports centralizado
• Test: npm run dev y verificar puerto

---

FASE 2: CORRECCION DE CONFLICTOS P1 (IMPORTANTES)

2.1 Resolver CONFLICT-003: Vidrio-Templado

# Archivos a modificar:
# - projects/erp-suite/apps/verticales/vidrio-templado/.env.example

# Cambio:
APP_PORT=3200 -> APP_PORT=3146

Checklist:

• Modificar .env.example
• Actualizar frontend si tiene referencia al backend
• Test: Levantar servicio y verificar

---

2.2 Revisar Otros Puertos Fuera de Rango

2.2.1 RETAIL

# Archivos a modificar:
# - projects/erp-suite/apps/verticales/retail/.env.example

# Cambio (OPCIONAL - Revisar con equipo):
APP_PORT=3400 -> APP_PORT=3186

Nota: El puerto 3400 esta fuera del rango de ERP-suite (3100-3299), pero puede mantenerse si se documenta como excepcion.

---

2.2.2 CLINICAS

# Archivos a modificar:
# - projects/erp-suite/apps/verticales/clinicas/.env.example

# Cambio (OPCIONAL - Revisar con equipo):
APP_PORT=3500 -> APP_PORT=3206

Nota: Similar a retail, puede documentarse como excepcion si es necesario.

---

FASE 3: CREAR ARCHIVOS .env.ports FALTANTES (P2)

3.1 Template Base

# =============================================================================
# {PROYECTO} - PORT ASSIGNMENTS
# =============================================================================
# Archivo centralizado de asignacion de puertos
# Gestionado por: DevEnv Agent
# Fecha: 2025-12-08
# Rango asignado: {RANGO}
# =============================================================================

# FRONTEND
FRONTEND_PORT={BASE+5}
FRONTEND_ADMIN_PORT={BASE+7}

# BACKEND
BACKEND_API_PORT={BASE+6}
BACKEND_WS_PORT={BASE+8}

# DATABASES
POSTGRES_PORT={PUERTO_DB}
REDIS_PORT={PUERTO_REDIS}

# =============================================================================

3.2 Crear en Proyectos

• projects/erp-suite/.env.ports
• projects/betting-analytics/.env.ports
• projects/inmobiliaria-analytics/.env.ports
• projects/platform_marketing_content/.env.ports

---

FASE 4: VALIDACION POST-IMPLEMENTACION

4.1 Verificacion de Puertos

# Script de validacion
for port in 3106 3166 3226 3606 3146; do
  echo "Verificando puerto $port..."
  lsof -i :$port || echo "Puerto $port disponible"
done

4.2 Verificacion de Conectividad

# Para cada proyecto modificado
curl -s http://localhost:{PUERTO}/health || echo "Servicio no responde"

4.3 Checklist Final

• Todos los conflictos P0 resueltos
• Todos los conflictos P1 resueltos
• Archivos .env.ports creados
• DEVENV-PORTS-INVENTORY.yml actualizado
• Ningun servicio roto
• Documentacion actualizada

---

ORDEN DE IMPLEMENTACION RECOMENDADO

1. ERP-CORE (3000 -> 3106)
   |
2. MECANICAS-DIESEL (3000 -> 3166)
   |
3. POS-MICRO (3000 -> 3226)
   |
4. PMC (3000 -> 3606)
   |
5. VIDRIO-TEMPLADO (3200 -> 3146)
   |
6. Crear .env.ports faltantes
   |
7. Validacion completa
   |
8. Actualizar inventario final

---

ROLLBACK PLAN

Si algo falla, revertir cambios en orden inverso:

# Git puede ayudar
git diff projects/erp-suite/apps/erp-core/.env
git checkout -- projects/erp-suite/apps/erp-core/.env

---

ESTIMACION DE ESFUERZO

Fase	Archivos	Complejidad	Tiempo Estimado
Fase 1.1.1 (erp-core)	3	Baja	15 min
Fase 1.1.2 (mecanicas)	2	Baja	15 min
Fase 1.1.3 (pos-micro)	3	Media	20 min
Fase 1.1.4 (pmc)	1	Baja	10 min
Fase 2 (vidrio-templado)	1	Baja	10 min
Fase 3 (.env.ports)	4	Baja	20 min
Fase 4 (validacion)	-	Media	30 min
TOTAL	14	-	~2 horas

---

APROBACION REQUERIDA

Este plan requiere aprobacion antes de implementar:

• Tech-Leader / Orquestador
• Responsable de cada proyecto afectado

---

ARCHIVOS RELACIONADOS

• DEVENV-PORTS-INVENTORY.yml - Inventario completo
• ANALISIS-PUERTOS-WORKSPACE.md - Analisis detallado
• DEVENV-PORT-STANDARDS.md - Estandar de asignacion
• PERFIL-DEVENV.md - Perfil del agente DevEnv
• PERFIL-ARCHITECTURE-ANALYST.md - Perfil del orquestador

---

Version: 1.0.0 | Estado: PENDIENTE APROBACION | Generado por: Architecture-Analyst