# CONTEXTO - Análisis e Integración Trading Platform

**Tarea:** TASK-2026-01-26-ANALYSIS-INTEGRATION-PLAN
**Fecha:** 2026-01-26
**Agente:** ARQUITECTO-SISTEMA-PLANIFICADOR (claude-sonnet-4-5)
**Fase CAPVED:** C - Contexto

---

## 1. CONTEXTO DEL PROYECTO

### 1.1 Estado General

**Trading Platform** es un proyecto standalone del workspace-v2 con:
- **Completitud:** ~42% (era 38% pre-análisis)
- **Versión:** 0.3.0
- **Tipo:** STANDALONE (integrado selectivamente con template-saas)
- **Nivel:** NIVEL_2A_STANDALONE

### 1.2 Arquitectura

**Stack Tecnológico:**
- **Frontend:** React 18.2 + TypeScript 5.3 + Vite 6.2
- **Backend:** Express.js 5.0.1 + TypeScript
- **Database:** PostgreSQL 16+ (11 schemas, 85 tablas)
- **Cache:** Redis 7.x (DB 1)
- **ML Engine:** Python 3.11 + FastAPI + PyTorch/TensorFlow
- **Data Service:** Python + FastAPI + Polygon.io API

**Submódulos (13 inicializados):**
- Core Apps (5): backend, frontend, database, data-service, ml-engine
- MCP Services (8): auth, wallet, products, vip, investment, predictions, binance, mt4

**Puertos Asignados:**
- Backend: 3080
- Frontend: 3000
- ML Engine: 3083
- Data Service: 3084
- MCPs: 3090-3095

### 1.3 Métricas del Proyecto

```yaml
Código:
  total_loc: 58000+
  typescript_files: 398 (backend: 158, frontend: 240)
  python_files: 109
  schemas_db: 11
  tablas_db: 85

Documentación:
  markdown_files: 356
  especificaciones_tecnicas: 62 (ET-*)
  user_stories: 100+
  requerimientos_funcionales: 40+
  tareas_completadas: 16 (últimos 6 días)

Componentes:
  frontend_components: 152 (32 páginas + 91 reutilizables + 29 nuevos)
  backend_modules: 13
  mcp_tools: 92
  api_endpoints: 113
```

---

## 2. CONTEXTO DE LA TAREA

### 2.1 Origen de la Tarea

El usuario solicitó:
> "hacer un análisis detallado sobre los nuevos requerimientos y que se tenga una completa integración entre todos los proyectos, separando en subtareas en n cantidad de subniveles y cada subtarea o tarea a cualquier subnivel deben de cumplir con el principio CAPVED"

**Motivación:**
- Se realizaron mejoras significativas en trading-platform (enero 2026)
- 16 tareas completadas en 6 días (25-26 ene 2026)
- Necesidad de consolidar, integrar documentación y planear siguientes fases
- Purgar documentación obsoleta
- Asegurar coherencia entre capas (DDL↔Backend↔Frontend)

### 2.2 Trabajos Recientes (ene 2026)

**Tareas Completadas (25-26 ene):**

1. **TASK-002-FRONTEND-COMPREHENSIVE-AUDIT** (2026-01-25)
   - 123 componentes auditados
   - 113 APIs documentadas
   - 48 documentos generados (19,117 LOC)
   - 32 gaps P0-P1 identificados
   - Roadmap 4 fases (Q1-Q4 2026, 2,457h)

2. **TASK-ML-TRAINING-ENHANCEMENT** (2026-01-25)
   - 5 estrategias ML nuevas (PVA, MRD, VBP, MSA, MTS)
   - Neural Gating Metamodel
   - 63 archivos, 29,769 LOC

3. **TASK-PHASE1-MVP** (2026-01-25)
   - Sistema de notificaciones multi-canal
   - Distribution job (cron daily)
   - WebSocket real-time

4. **TASK-OQI-002 a OQI-008** (2026-01-25/26)
   - 15+ componentes frontend nuevos
   - Progreso: OQI-002 +10%, OQI-004 +20%, OQI-005 +15%, OQI-006 +10%, OQI-007 +10%

**Commits:** 58 commits en 6 días, 45,000+ LOC entre código y documentación

### 2.3 Problemas Identificados

**Gaps de Coherencia (E-COH-001 a E-COH-007):**
- Backend UserRole enum mismatch con DDL
- Investment types incompletos en backend
- Portfolio types completamente ausentes
- Frontend missing trading enums
- JSONB fields no tipados

**Blockers Críticos (P0):**
- Token refresh manual (60h) - Security vulnerability
- PCI-DSS non-compliant (80h) - Legal blocker
- Video upload backend (60h) - Feature incomplete
- MT4 Gateway 0% funcional (180h) - Comercial blocker

**Documentación:**
- 58 items faltantes (ET specs, User Stories, Swagger docs)
- Frontend no documentado en FRONTEND_INVENTORY.yml
- CODE-REUSE-MATRIX incompleta
- Documentación obsoleta por purgar

---

## 3. ALCANCE DE LA TAREA

### 3.1 Objetivos Principales

1. **Análisis Exhaustivo:**
   - Consolidar hallazgos de 5 agentes exploradores
   - Identificar todos los gaps (coherencia, documentación, implementación)
   - Cuantificar trabajo pendiente

2. **Plan de Integración:**
   - Definir subtareas en múltiples niveles
   - Aplicar CAPVED a todas las subtareas
   - Establecer orden lógico sin dependencias circulares
   - Priorizar según criticidad (P0 → P1 → P2 → P3)

3. **Integración Documentación:**
   - Definir qué va en docs/ vs orchestration/
   - Integrar 58 items faltantes
   - Purgar documentación obsoleta
   - Actualizar inventarios

4. **Roadmap Ejecutable:**
   - Plan Q1-Q4 2026 con esfuerzos cuantificados
   - Identificar dependencias entre tareas
   - Asignar prioridades y recursos

### 3.2 Fuera de Alcance

- Implementación de código (solo planeación)
- Ejecución de subtareas (se delegan)
- Decisiones de negocio no técnicas
- Cambios arquitectónicos mayores

### 3.3 Capas Afectadas

```yaml
Capas:
  - database: Coherencia types, nuevos schemas
  - backend: Types incompletos, controllers faltantes
  - frontend: Types missing, componentes nuevos
  - docs: Integración, purga, organización
  - orchestration: Inventarios, tareas, trazabilidad
```

---

## 4. CONTEXTO TÉCNICO

### 4.1 Épicas del Proyecto (OQI-001 a OQI-009)

| ID | Épica | Progreso | Estado | Gaps |
|----|-------|----------|--------|------|
| OQI-001 | Auth & OAuth | 70% | ✅ Estable | 3 (P0-P1) |
| OQI-002 | Educación | 40% | 🟡 En desarrollo | 2 (P1) |
| OQI-003 | Trading Charts | 45% | 🟡 En desarrollo | 7 (P1) |
| OQI-004 | Investment Accounts | 55% | 🟡 En desarrollo | 0 |
| OQI-005 | Payments Stripe | 65% | 🟡 En desarrollo | 2 (P0) |
| OQI-006 | ML Signals | 70% | ✅ Estable | 0 |
| OQI-007 | LLM Agent | 35% | 🟡 En desarrollo | 2 (P1-P2) |
| OQI-008 | Portfolio Manager | 20% | 🔴 Inicial | 3 (P2-P3) |
| OQI-009 | MT4 Gateway | 15% | 🔴 Stub | 1 (P0) |

### 4.2 Arquitectura de Datos

**Schemas PostgreSQL (11):**
- public (core tables)
- auth (users, oauth, sessions)
- education (courses, lessons, gamification)
- trading (orders, positions, signals, bots)
- investment (accounts, products, distributions)
- financial (wallets, transactions, subscriptions)
- ml (predictions, models, signals)
- llm (conversations, messages, tool_executions)
- portfolio (portfolios, allocations, goals, rebalance)
- notifications (notifications, push_tokens)
- audit (logs, activity, events)

**Total:** 85 tablas + enums tipados

### 4.3 Dependencias Externas

**Críticas:**
- Stripe (payments) - PCI-DSS compliance pendiente
- Polygon.io (market data) - Integrado
- Binance API (trading) - Via CCXT
- MetaTrader 4 (trading gateway) - 0% funcional (BLOCKER)
- OpenAI/Anthropic (LLM) - Integrado

**Secundarias:**
- Twilio (SMS/WhatsApp)
- Firebase (push notifications)
- OAuth providers (Google, Facebook, X, Apple, GitHub)

---

## 5. CONTEXTO DE HERRAMIENTAS Y PROCESOS

### 5.1 Sistema SIMCO

- **Metodología:** CAPVED obligatorio para toda tarea
- **Triggers:** COHERENCIA, INVENTARIOS, CIERRE-TAREA
- **Validaciones:** build, lint, tests, typecheck
- **Documentación:** Gobernanza docs/ vs orchestration/

### 5.2 Git y Submodules

```yaml
Main Branch: main
Submodules:
  core_apps: rama "main"
  mcp_services: rama "master"  # ⚠ Inconsistencia
Status: 13/13 inicializados
```

### 5.3 Agentes Utilizados

**Exploración Paralela (5 agentes):**
1. agent-a018b30: Estructura trading-platform
2. agent-a581459: Documentación (docs/ + orchestration/)
3. agent-ab9dec7: Inventarios y dependencias
4. agent-a0125a1: Requerimientos y mejoras
5. agent-a6672fb: Coherencia capas (DDL↔Backend↔Frontend)

**Tiempo:** ~45 minutos (vs 3-4h secuencial) = 85% reducción

---

## 6. CONTEXTO DE CALIDAD ACTUAL

### 6.1 Puntuación Documentación: 7.1/10

| Aspecto | Puntuación |
|---------|-----------|
| Especificaciones técnicas | 9/10 |
| User stories | 9/10 |
| API documentation | 8/10 |
| Architecture docs | 9/10 |
| Task tracking | 10/10 |
| Deployment guides | 4/10 |
| Runbooks | 3/10 |
| Data governance | 3/10 |

### 6.2 Test Coverage

```yaml
Backend: ~85%
Frontend: ~80%
ML Engine: ~70%
E2E Tests: 0%  # ⚠ CRÍTICO
```

### 6.3 Performance

```yaml
Métricas actuales:
  FCP: 3.5s (target: <1.5s)
  TTI: 6s (target: <3s)
  LCP: 4.2s (target: <2.5s)
  Bundle Size: 2.5MB (target: <500KB gzip)
```

---

## 7. CONTEXTO DE STAKEHOLDERS

### 7.1 Usuarios Finales

- Traders retail (objetivo: 10k Q4 2026)
- Inversores PAMM (Money Manager)
- Estudiantes de trading (educación)
- Administradores de plataforma

### 7.2 Equipo Técnico

- 2 devs full-time estimado
- Agentes IA (Claude, Gemini, Windsurf)
- Proceso 4 fases: Claude Plan → Gemini Descomponer → Windsurf Ejecutar → Claude/Gemini Validar

---

## 8. CONTEXTO DE RESTRICCIONES

### 8.1 Técnicas

- Express.js (no NestJS) - Arquitectura diferente a ERPs
- Standalone (no hereda de erp-core)
- PostgreSQL 16+ (mínimo)
- TypeScript strict mode
- React 18+ (no downgrade)

### 8.2 Negocio

- GO-LIVE target: Q2 2026
- MVP mínimo: OQI-001 a OQI-006 completos
- Compliance: PCI-DSS obligatorio antes de pagos reales
- MT4 Gateway: Promesa comercial, debe completarse

### 8.3 Recursos

- Presupuesto estimado: $223,000 (2,457h)
- Timeline: Q1-Q4 2026 (12 meses)
- ROI esperado: 165% ($468k ganancia neta Year 1)

---

## 9. CONTEXTO DE RIESGOS

### 9.1 Riesgos Técnicos (ALTO)

1. **Coherencia DDL↔Backend↔Frontend**
   - Probabilidad: CRÍTICO (ya ocurrió)
   - Impacto: Alto (bugs en producción)
   - Mitigación: Resolver E-COH-001 a E-COH-007 inmediato

2. **MT4 Gateway 0% funcional**
   - Probabilidad: Alta (feature vendida sin implementar)
   - Impacto: Comercial blocker
   - Mitigación: Prioridad P0, 180h asignadas Q2

3. **PCI-DSS non-compliant**
   - Probabilidad: CRÍTICO (detectado)
   - Impacto: Legal blocker (no procesar pagos)
   - Mitigación: 80h Q1, auditoría externa

### 9.2 Riesgos Operacionales (MEDIO)

- Falta de E2E tests (coverage 0%)
- Deployment guides incompletos
- Runbooks no existen

### 9.3 Riesgos de Proyecto (BAJO)

- Documentación bien estructurada (98% completitud)
- CAPVED aplicado consistentemente
- 0 dependencias circulares

---

## 10. RESUMEN DEL CONTEXTO

**Trading Platform** es un proyecto standalone (~42% completitud) con excelente documentación arquitectónica pero gaps críticos de coherencia entre capas y 4 blockers P0 que impiden go-live.

**Situación Actual:**
- ✅ Arquitectura sólida, bien documentada
- ✅ 16 tareas completadas en 6 días (velocidad alta)
- ✅ ML Engine completamente funcional
- ✅ 0 dependencias circulares
- 🔴 7 gaps coherencia DDL↔Backend↔Frontend
- 🔴 4 blockers P0 (token refresh, PCI-DSS, video upload, MT4)
- 🔴 2,457h trabajo pendiente (Q1-Q4 2026)

**Necesidad Inmediata:**
1. Resolver gaps coherencia (6.5h)
2. Integrar documentación faltante (47.5h)
3. Planear resolución de blockers P0 (380h Q1-Q2)
4. Establecer roadmap ejecutable con subtareas CAPVED

---

**Fecha de Completitud:** 2026-01-26 15:30
**Siguiente Fase:** 02-ANALISIS.md