# COORDINACION DE CONFIGURACIONES - MULTI-PROYECTO

**Agente:** Requirements-Analyst
**Fecha:** 2025-12-05
**Version:** 1.0.0
**Proposito:** Documento de coordinacion entre agentes para configuraciones de ambiente, puertos, bases de datos y variables de entorno.

---

## RESUMEN EJECUTIVO

Este documento consolida las configuraciones necesarias para todos los proyectos del workspace, incluyendo:
- Asignacion de puertos (DEVENV)
- Variables de entorno (DEVENV)
- Configuraciones de base de datos (Database-Agent)
- Epicas/Historias de usuario pendientes (Backend-Agent)

---

## 1. ASIGNACION DE PUERTOS POR PROYECTO

### Convencion de Bloques de Puertos

Cada proyecto tiene un bloque de 10 puertos asignados:
- Frontend: base + 5
- Backend: base + 6
- ML/API: base + 7 (si aplica)
- Workers: base + 8-9

### Tabla Consolidada de Puertos

| Proyecto | Bloque | Frontend | Backend | ML/API | Database | Estado |
|----------|--------|----------|---------|--------|----------|--------|
| **GAMILIT** | 3000 | 3005 | 3006 | - | gamilit_platform | ACTIVO |
| **ORBIQUANTIA** | 3010 | 3015 | 3016 | 8001 | orbiquantia_platform | ACTIVO |
| **ERP-CORE** | 3020 | 3025 | 3026 | - | erp_core | Desarrollo |
| **ERP-Construccion** | 3030 | 3035 | 3036 | - | construccion_mvp | Desarrollo |
| **ERP-Vidrio** | 3040 | 3045 | 3046 | - | vidrio_templado | Planificado |
| **ERP-Mecanicas** | 3050 | 3055 | 3056 | - | mecanicas_diesel | Planificado |
| **ERP-Clinicas** | 3060 | 3065 | 3066 | - | clinicas | Planificado |
| **ERP-Retail** | 3070 | 3075 | 3076 | - | retail | Planificado |
| **TRADING-PLATFORM** | 3080 | 3085 | 3086 | 8002 | trading_platform | Desarrollo |
| **BETTING-ANALYTICS** | 3090 | 3095 | 3096 | 8003 | betting_analytics | Planificado |
| **INMOBILIARIA** | 3100 | 3105 | 3106 | 8004 | inmobiliaria_analytics | Planificado |

### Servicios Compartidos

| Servicio | Puerto | Descripcion |
|----------|--------|-------------|
| **PostgreSQL** | **5432** | **UNA instancia, múltiples databases** |
| Redis | 6379 | Cache y sesiones compartidas |

**IMPORTANTE:** Todos los proyectos usan la MISMA instancia de PostgreSQL en puerto 5432.
Cada proyecto tiene su propia DATABASE dentro de esa instancia.

---

## 2. CONFIGURACIONES DE BASE DE DATOS

### Arquitectura PostgreSQL

```
PostgreSQL (puerto 5432)
├── gamilit_platform        <- GAMILIT
├── orbiquantia_platform    <- ORBIQUANTIA
├── erp_core                <- ERP-CORE
├── construccion_mvp        <- ERP-Construccion
├── vidrio_templado         <- ERP-Vidrio
├── mecanicas_diesel        <- ERP-Mecanicas
├── clinicas                <- ERP-Clinicas
├── retail                  <- ERP-Retail
├── trading_platform        <- TRADING-PLATFORM
├── betting_analytics       <- BETTING-ANALYTICS
└── inmobiliaria_analytics  <- INMOBILIARIA
```

### Por Proyecto

| Proyecto | Host | Puerto | Database | Usuario | Schemas |
|----------|------|--------|----------|---------|---------|
| GAMILIT | localhost | 5432 | gamilit_platform | gamilit_user | 14 schemas |
| ORBIQUANTIA | localhost | 5432 | orbiquantia_platform | orbiquantia | 7 schemas |
| ERP-CORE | localhost | 5432 | erp_core | erp_admin | Multi-schema |
| ERP-Construccion | localhost | 5432 | construccion_mvp | erp_admin | Multi-schema |
| TRADING-PLATFORM | localhost | 5432 | trading_platform | trading_user | 7 schemas |

### Schemas por Proyecto

#### GAMILIT (14 schemas)
1. `auth` - Supabase Auth
2. `auth_management` - Gestion autenticacion (11 tablas)
3. `educational_content` - Contenido educativo (8 tablas)
4. `gamification_system` - Gamificacion (12 tablas)
5. `progress_tracking` - Tracking progreso (10 tablas)
6. `admin_dashboard` - Dashboard admin (6 tablas)
7. `content_management` - Gestion contenido (7 tablas)
8. `social_features` - Features sociales (8 tablas)
9. `storage` - Almacenamiento (5 tablas)
10. `audit_logging` - Logs auditoria (6 tablas)
11. `system_configuration` - Configuracion (4 tablas)
12. `lti_integration` - Integracion LTI (5 tablas)
13. `gamilit` - Schema principal (10 tablas)
14. `public` - Acceso publico (2 tablas)

#### TRADING-PLATFORM (7 schemas)
1. `public` - Usuarios y auth (10 tablas)
2. `education` - Modulo educativo (11 tablas)
3. `trading` - Trading y charts (10 tablas)
4. `investment` - Cuentas de inversion (8 tablas)
5. `financial` - Pagos y Stripe (10 tablas)
6. `ml` - Senales ML (8 tablas)
7. `audit` - Auditoria (7 tablas)

#### ERP-CORE (Schemas base)
1. `auth_management` - Autenticacion
2. `project_management` - Proyectos
3. `financial_management` - Finanzas
4. `purchasing_management` - Compras
5. `construction_management` - Construccion
6. `quality_management` - Calidad
7. `infonavit_management` - Integracion INFONAVIT

---

## 3. VARIABLES DE ENTORNO REQUERIDAS

### Template Base para Backend (NestJS/Express)

```bash
# Server
NODE_ENV=development
PORT={BACKEND_PORT}
API_PREFIX=api
API_VERSION=v1

# Database
DB_HOST=localhost
DB_PORT={DB_PORT}
DB_NAME={DB_NAME}
DB_USER={DB_USER}
DB_PASSWORD={DB_PASSWORD}
DB_SYNCHRONIZE=false
DB_LOGGING=true

# JWT
JWT_SECRET={PROJECT}-jwt-secret-key-change-in-production
JWT_EXPIRES_IN=15m
JWT_REFRESH_EXPIRES_IN=7d

# CORS
CORS_ORIGIN=http://localhost:{FRONTEND_PORT},http://localhost:{BACKEND_PORT}
ENABLE_CORS=true
ENABLE_SWAGGER=true

# Logging
LOG_LEVEL=info
LOG_TO_FILE=false
```

### Template Base para Frontend (React/Vite)

```bash
# Application
VITE_APP_NAME={PROJECT_NAME}
VITE_APP_VERSION=1.0.0
VITE_APP_ENV=development

# API Configuration
VITE_API_HOST=localhost:{BACKEND_PORT}
VITE_API_PROTOCOL=http
VITE_API_VERSION=v1
VITE_API_TIMEOUT=30000

# WebSocket
VITE_WS_HOST=localhost:{BACKEND_PORT}
VITE_WS_PROTOCOL=ws

# Feature Flags
VITE_ENABLE_DEBUG=true
VITE_MOCK_API=false
```

---

## 4. MIGRACIONES PENDIENTES (Para DEVENV-Agent)

### ORBIQUANTIA - Migracion de Puertos

**Estado actual:**
- Backend en puerto 3000 (deberia ser 3016)
- Frontend en puerto 5173 (deberia ser 3015)
- PostgreSQL en puerto 5433 (correcto)

**Cambios requeridos:**
1. `apps/backend/.env` - PORT: 3000 -> 3016
2. `apps/frontend/.env` - VITE_API_URL: localhost:3000 -> localhost:3016
3. `vite.config.ts` - server.port: 5173 -> 3015

### ERP-CORE - Configuracion Inicial

**Requiere crear:**
1. Base de datos `erp_core` en puerto 5434
2. Usuario `erp_admin`
3. Archivo `.env` con puerto 3026
4. Configuracion de frontend en puerto 3025

### TRADING-PLATFORM - Configuracion Inicial

**Requiere crear:**
1. Base de datos `trading_platform` en puerto 5435
2. Usuario `trading_user`
3. Actualizar `.env` con puertos estandarizados (3085/3086)

---

## 5. EPICAS Y TAREAS PENDIENTES

### ERP-SUITE (Para Backend-Agent)

#### Modulos Core (P0 - 430 SP Total)

| Modulo | Descripcion | SP | Estado |
|--------|-------------|-----|--------|
| MGN-001 | Fundamentos (Auth, Users, Roles) | 50 | Pendiente |
| MGN-002 | Empresas y Organizaciones | 30 | Pendiente |
| MGN-003 | Catalogos Maestros | 35 | Pendiente |
| MGN-004 | Financiero Basico | 80 | Pendiente |
| MGN-005 | Inventario Basico | 70 | Pendiente |
| MGN-006 | Compras Basico | 60 | Pendiente |
| MGN-007 | Ventas Basico | 60 | Pendiente |
| MGN-008 | Contabilidad Analitica | 45 | Pendiente |

#### Modulos Complementarios (P1/P2 - 305 SP Total)

| Modulo | Descripcion | SP | Prioridad |
|--------|-------------|-----|-----------|
| MGN-009 | CRM Basico | 50 | P1 |
| MGN-010 | RRHH Basico | 55 | P1 |
| MGN-011 | Proyectos Genericos | 65 | P1 |
| MGN-012 | Reportes y Analytics | 40 | P2 |
| MGN-013 | Portal de Usuarios | 50 | P1 |
| MGN-014 | Mensajeria y Notificaciones | 45 | P1 |

### TRADING-PLATFORM (Para Backend-Agent)

#### Epicas MVP (280 SP Total)

| Epica | Descripcion | SP | Estado |
|-------|-------------|-----|--------|
| OQI-001 | Fundamentos y Auth | 50 | COMPLETADO |
| OQI-002 | Modulo Educativo | 45 | Pendiente |
| OQI-003 | Trading y Charts | 55 | Pendiente |
| OQI-004 | Cuentas de Inversion | 50 | Pendiente |
| OQI-005 | Pagos y Stripe | 40 | Pendiente |
| OQI-006 | Senales ML | 40 | Pendiente |

#### Proximas Tareas Sugeridas (OQI-002)

1. **Database:** Crear schema `education` con 11 tablas
2. **Backend:** Implementar modulo `education` con 4 services
3. **Frontend:** Implementar feature `education` con 4 paginas
4. **Reutilizacion:** 70% de GAMILIT (estructura cursos, progreso)

---

## 6. DELEGACIONES A OTROS AGENTES

### Para DEVENV-Agent

**Tarea:** Estandarizar configuraciones de ambiente
- [ ] Crear instancia PostgreSQL en puerto 5434 para ERP Suite
- [ ] Crear instancia PostgreSQL en puerto 5435 para Trading-Platform
- [ ] Migrar puertos de ORBIQUANTIA segun tabla
- [ ] Generar archivos .env para proyectos pendientes

### Para Database-Agent

**Tarea:** Crear schemas iniciales
- [ ] ERP-CORE: Crear schemas base segun documentacion
- [ ] TRADING-PLATFORM: Crear 7 schemas segun especificacion
- [ ] Implementar RLS policies en todos los schemas

### Para Backend-Agent

**Tarea:** Validar definiciones de epicas
- [ ] Revisar requerimientos funcionales de ERP-SUITE (14 modulos)
- [ ] Revisar requerimientos funcionales de TRADING-PLATFORM (6 epicas)
- [ ] Proponer desglose de tareas para proximos sprints

---

## 7. REFERENCIAS

### Documentos de Configuracion

- `~/workspace/core/devtools/environment/DEV-ENVIRONMENT-REGISTRY.yml`
- `~/workspace/projects/{proyecto}/orchestration/environment/PROJECT-ENV-CONFIG.yml`

### Documentacion de Proyectos

- GAMILIT: `~/workspace/projects/gamilit/docs/`
- ERP-SUITE: `~/workspace/projects/erp-suite/apps/erp-core/docs/`
- TRADING-PLATFORM: `~/workspace/projects/trading-platform/docs/`
- ORBIQUANTIA: `~/workspace/projects/orbiquantia/docs/`

### Prompts de Agentes

- Database-Agent: `~/workspace/core/orchestration/prompts/base/PROMPT-DATABASE-AGENT.md`
- Backend-Agent: `~/workspace/core/orchestration/prompts/base/PROMPT-BACKEND-AGENT.md`
- DEVENV-Agent: `~/workspace/core/orchestration/prompts/base/PROMPT-DEVENV-AGENT.md`

---

## APENDICE: Checklist de Validacion

### Pre-Desarrollo

- [ ] Puerto frontend asignado y sin conflictos
- [ ] Puerto backend asignado y sin conflictos
- [ ] Base de datos creada con usuario correspondiente
- [ ] Archivo .env configurado con todas las variables
- [ ] Schemas de BD creados y documentados

### Post-Desarrollo

- [ ] Variables de entorno validadas en produccion
- [ ] Migraciones de BD aplicadas
- [ ] Tests de conexion ejecutados
- [ ] Documentacion actualizada

---

*Documento generado por Requirements-Analyst*
*Ultima actualizacion: 2025-12-05*
