trading-platform/orchestration/tareas/2026-01-25/TASK-2026-01-25-002-FRONTEND-COMPREHENSIVE-AUDIT/01-CONTEXTO.md

# Fase C - Contexto

**Tarea:** TASK-2026-01-25-002-FRONTEND-COMPREHENSIVE-AUDIT
**Fecha:** 2026-01-25
**Sistema:** SIMCO v4.0.0 + CAPVED

---

## C.1 Identificacion de Proyecto/Modulo/Epic

```yaml
proyecto: trading-platform
ruta_proyecto: projects/trading-platform/
modulo: frontend (apps/frontend/src/)
epics_afectados:
  - OQI-001: fundamentos-auth (70%)
  - OQI-002: educativo (30%)
  - OQI-003: trading-charts (40%)
  - OQI-004: cuentas-inversion (35%)
  - OQI-005: pagos-stripe (50%)
  - OQI-006: senales-ml (60%)
  - OQI-007: llm-strategy-agent (25%)
  - OQI-008: portfolio-manager (20%)
  - OQI-009: mt4-gateway (15%)
```

---

## C.2 Clasificacion de Tarea

```yaml
tipo: audit
subtipo: comprehensive-documentation-audit
categoria: frontend
ambito: documentacion + codigo + arquitectura
```

---

## C.3 Origen de la Tarea

```yaml
origen: plan
solicitante: usuario
prioridad: P0
contexto_adicional: |
  El usuario solicita un analisis y planeacion detallados del frontend
  de trading-platform con enfoque en:
  1. Analisis de TODAS las paginas del frontend
  2. Componentes con funciones bien definidas o acciones
  3. Consumo de APIs con contratos esperados
  4. Manejo de multimedia (imagenes, videos, audios) POST/GET
  5. Purga de documentacion obsoleta
  6. Integracion de definiciones faltantes
  7. Orden de ejecucion logico sin dependencias circulares
  8. Orquestacion de subagentes en paralelo  
```

---

## C.4 Contexto SIMCO (CCA)

### Principios Cargados

- [x] `PRINCIPIO-CAPVED.md` - Ciclo de vida obligatorio
- [x] `SIMCO-TAREA.md` - Proceso detallado CAPVED
- [x] `SIMCO-UBICACION-DOCUMENTACION.md` - Ubicacion de docs
- [x] `PRINCIPIO-DOC-PRIMERO.md` (implicito)
- [x] `PRINCIPIO-ANTI-DUPLICACION.md` (implicito)

### Perfil del Agente

```yaml
agente_principal: claude-opus-4.5
perfil: arquitecto-coordinador
capacidades:
  - Orquestacion de subagentes
  - Analisis arquitectonico
  - Planeacion multi-nivel
  - Coordinacion paralela
```

### CONTEXTO-PROYECTO.md

```yaml
proyecto: trading-platform
tipo: STANDALONE
herencia_simco: true
sistema: SIMCO v4.0.0 + NEXUS v4.0
arquitectura: Hibrida TypeScript + Python
```

### Inventarios Relevantes

```yaml
inventarios_cargados:
  - projects/trading-platform/INVENTARIO.yml (generado EPIC-008)
  - orchestration/inventarios/MASTER_INVENTORY.yml (planeado)
  - orchestration/inventarios/FRONTEND_INVENTORY.yml (planeado)
  - orchestration/inventarios/BACKEND_INVENTORY.yml (planeado)
```

---

## C.5 Documentos Vinculados

### Documentacion del Proyecto

```yaml
docs_proyecto:
  vision:
    - docs/00-vision-general/VISION-PRODUCTO.md
    - docs/00-vision-general/ARQUITECTURA-GENERAL.md
    - docs/00-vision-general/STACK-TECNOLOGICO.md

  modulos_oqi:
    - docs/02-definicion-modulos/OQI-001-fundamentos-auth/_MAP.md
    - docs/02-definicion-modulos/OQI-002-education/_MAP.md
    - docs/02-definicion-modulos/OQI-003-trading-charts/_MAP.md
    - docs/02-definicion-modulos/OQI-004-investment-accounts/_MAP.md
    - docs/02-definicion-modulos/OQI-005-payments-stripe/_MAP.md
    - docs/02-definicion-modulos/OQI-006-ml-signals/_MAP.md
    - docs/02-definicion-modulos/OQI-007-llm-agent/_MAP.md
    - docs/02-definicion-modulos/OQI-008-portfolio-manager/_MAP.md
    - docs/02-definicion-modulos/OQI-009-marketplace/_MAP.md

  especificaciones_tecnicas:
    - docs/02-definicion-modulos/OQI-*/especificaciones/ET-*-frontend.md (creadas en TASK-FRONTEND-ANALYSIS)

  historias_usuario:
    - docs/02-definicion-modulos/OQI-*/historias-usuario/US-*.md (100+ existentes)
```

### Documentacion Tecnica

```yaml
docs_tecnicos:
  - apps/frontend/README.md (si existe)
  - apps/frontend/src/modules/ml/README.md
  - apps/frontend/src/modules/ml/USAGE_EXAMPLES.md
  - apps/frontend/src/modules/ml/VALIDATION_CHECKLIST.md
  - apps/frontend/ML_DASHBOARD_IMPLEMENTATION.md
```

### Orchestration

```yaml
orchestration:
  tareas_relacionadas:
    - TASK-2026-01-25-FRONTEND-ANALYSIS (completada)
    - TASK-2026-01-25-PHASE1-MVP (en progreso)
    - TASK-2026-01-25-NOTIFICACIONES-COMPLETAS (en progreso)
    - TASK-2026-01-25-ML-DATA-MIGRATION (en progreso)

  inventarios:
    - orchestration/inventarios/MASTER_INVENTORY.yml
    - orchestration/inventarios/FRONTEND_INVENTORY.yml
    - orchestration/inventarios/BACKEND_INVENTORY.yml
    - orchestration/inventarios/DATABASE_INVENTORY.yml
```

---

## C.6 Estado Actual del Frontend

### Analisis Previo Recibido

Se recibio un reporte exhaustivo de un agente **Explore** con los siguientes hallazgos:

#### Estructura Identificada

```yaml
rutas_totales: 35+
archivos_tsx: 208
componentes_principales: 150+
servicios_api: 13
stores_zustand: 7
hooks_personalizados: 5+
```

#### Progreso por Epic

```yaml
OQI-001_auth: 70%              # Falta: 2FA UI, biometrics
OQI-002_educacion: 30%          # Falta: live streaming, creator UI
OQI-003_trading_charts: 40%     # Falta: drawing tools persistencia, MT4 real
OQI-004_inversion: 35%          # Falta: creacion cuentas, optimizacion
OQI-005_pagos_stripe: 50%       # Falta: refunds, historico cambios
OQI-006_senales_ml: 60%         # Falta: WebSocket, exportacion
OQI-007_llm_agent: 25%          # Falta: memory, file uploads, streaming
OQI-008_portfolio_mgr: 20%      # Falta: optimizacion automatica
OQI-009_mt4_gateway: 15%        # NO FUNCIONA: solo stubs UI
```

#### Gaps Criticos Identificados

```yaml
gaps_implementacion:
  - 2FA Setup UI (documentado pero no implementado)
  - Biometric Auth (Touch ID / Face ID)
  - MT4 Real Trading (solo paper trading funciona)
  - Live Streaming Education (solo video on-demand)
  - Real-time Signals WebSocket (usa polling)
  - Backtesting Interactivo visual
  - Portfolio Optimization (Markowitz, Black-Litterman)
  - LLM Memory entre sesiones
  - File Uploads Assistant (document analysis)
  - Refunds UI

gaps_documentacion:
  - VideoProgressPlayer bookmarks/notes (implementado sin docs)
  - ICT Analysis Card (solo docs tecnicas)
  - Ensemble Signal (sin ejemplos de uso)
  - Risk-Based Position Sizer (sin guia usuario)
  - Drawing Tools UI (logica persistencia falta)
  - Market Bias Indicator (sin explicacion visual)
```

#### Multimedia Identificado

```yaml
video:
  componente: VideoProgressPlayer
  caracteristicas:
    - HTML5 nativo
    - Bookmarks con timestamps
    - Notas in-app persistentes
    - Velocidades multiples (0.5x-2x)
    - Auto-resume
    - Fullscreen
  gaps:
    - No hay integracion YouTube/Vimeo
    - No hay progressive download
    - No hay live streaming

charts:
  librerias:
    - lightweight-charts (candlesticks)
    - recharts (bar/line charts)
  charts_implementados:
    - CandlestickChart (OHLCV + volumen)
    - EquityCurveChart
    - PredictionChart
    - StrategyComparisonChart
    - AllocationChart (pie/donut)
    - PerformanceChart
  gaps:
    - No hay TradingView Charts
    - Drawing tools sin persistencia

imagenes:
  iconografia: Heroicons + Lucide React
  gaps:
    - No hay galerias de imagenes
    - No hay image compression/optimization

audio:
  estado: NO IMPLEMENTADO
  gaps:
    - No hay audio player
    - No hay podcast support
```

---

## C.7 Alcance de la Auditoria

### En Scope

1. **Analisis de Codigo Existente**
   - Todas las rutas (35+)
   - Todos los componentes (208 archivos)
   - Servicios de API (13)
   - Stores Zustand (7)
   - Hooks personalizados

2. **Documentacion de Componentes**
   - Funcion de cada componente
   - Props y tipos
   - APIs consumidas
   - Multimedia manejado

3. **Contratos de API**
   - Endpoints consumidos
   - Schemas de request
   - Schemas de response esperados
   - Manejo de errores

4. **Multimedia**
   - Componentes que manejan imagenes (GET/POST)
   - Componentes que manejan videos (GET/POST)
   - Componentes que manejan audios (GET/POST)

5. **Purga de Documentacion**
   - Identificar tareas completadas con docs obsoletas
   - Identificar definiciones duplicadas
   - Identificar user stories implementadas

6. **Integracion de Definiciones**
   - Identificar definiciones faltantes
   - Completar specs incompletas
   - Actualizar user stories

7. **Grafo de Dependencias**
   - Dependencias entre componentes
   - Dependencias entre modulos
   - Orden de ejecucion logico
   - Deteccion de dependencias circulares

8. **Plan de Implementacion**
   - Roadmap para cerrar gaps
   - Priorizacion de features faltantes
   - Estimacion de esfuerzo

### Fuera de Scope

1. **Implementacion de Codigo**
   - Esta tarea es SOLO analisis y documentacion
   - NO se implementan features faltantes
   - NO se corrigen bugs

2. **Testing**
   - NO se escriben tests
   - NO se ejecutan tests (solo lectura)

3. **Refactoring**
   - NO se refactoriza codigo existente
   - Solo se documenta estado actual

---

## C.8 Estrategia de Ejecucion

### Fase 1: Analisis Paralelo por Modulo (CAPVED completo)

```yaml
estrategia: Orquestar subagentes en paralelo
cantidad_subagentes: 5-9 (uno por epic)
tipo_subagente: general-purpose
modelo: haiku (costo-efectivo)

subagentes:
  - id: SA-001
    modulo: OQI-001-fundamentos-auth
    scope: "Analizar modulos/auth/ completo"

  - id: SA-002
    modulo: OQI-002-education
    scope: "Analizar modulos/education/ completo"

  - id: SA-003
    modulo: OQI-003-trading-charts
    scope: "Analizar modulos/trading/ completo"

  - id: SA-004
    modulo: OQI-004-investment-accounts
    scope: "Analizar modulos/investment/ completo"

  - id: SA-005
    modulo: OQI-005-payments-stripe
    scope: "Analizar modulos/payments/ completo"

  - id: SA-006
    modulo: OQI-006-ml-signals
    scope: "Analizar modulos/ml/ completo"

  - id: SA-007
    modulo: OQI-007-llm-agent
    scope: "Analizar modulos/assistant/ completo"

  - id: SA-008
    modulo: OQI-008-portfolio-manager
    scope: "Analizar modulos/portfolio/ completo"

  - id: SA-009
    modulo: OQI-009-mt4-gateway
    scope: "Analizar componentes MT4 (distribuidos en trading/)"
```

### Fase 2: Consolidacion y Sintesis

```yaml
agente: claude-opus-4.5 (principal)
funcion: Consolidar reportes de subagentes
entregables:
  - Reporte consolidado de analisis
  - Matriz de cobertura API-Frontend
  - Matriz de multimedia
  - Grafo de dependencias
  - Plan de purga
  - Plan de integracion
```

### Fase 3: Plan de Implementacion

```yaml
agente: Plan agent
funcion: Diseñar plan para cerrar gaps
entregables:
  - Roadmap de implementacion
  - Priorizacion de features
  - Estimacion de esfuerzo
```

---

## C.9 Metricas de Exito

```yaml
metricas:
  cobertura_componentes_documentados: 100%
  contratos_api_documentados: 100%
  multimedia_identificado: 100%
  gaps_identificados_vs_planeados: >90%
  documentacion_purgada: Si
  definiciones_integradas: Si
  grafo_dependencias_generado: Si
  plan_implementacion_creado: Si
  tiempo_estimado: 4-6 horas (con paralelizacion)
```

---

## C.10 Riesgos y Mitigaciones

```yaml
riesgos:
  - id: R1
    descripcion: "208 archivos es mucho para analizar manualmente"
    probabilidad: alta
    impacto: alto
    mitigacion: "Orquestar 9 subagentes en paralelo (1 por epic)"

  - id: R2
    descripcion: "Documentacion puede estar desactualizada vs codigo"
    probabilidad: media
    impacto: medio
    mitigacion: "Priorizar codigo como fuente de verdad, marcar discrepancias"

  - id: R3
    descripcion: "Gaps pueden ser muy numerosos"
    probabilidad: alta
    impacto: bajo
    mitigacion: "Categorizar gaps por prioridad, no intentar resolver todos"

  - id: R4
    descripcion: "Dependencias circulares pueden existir"
    probabilidad: media
    impacto: medio
    mitigacion: "Usar herramientas de analisis estatico si es necesario"

  - id: R5
    descripcion: "Purga de docs puede eliminar informacion valiosa"
    probabilidad: baja
    impacto: alto
    mitigacion: "Revisar manualmente antes de eliminar, hacer backup"
```

---

## C.11 Cronograma Estimado

```yaml
fase: C - Contexto
duracion: 30 min
estado: COMPLETADA

fase: A - Analisis
duracion: 2-3 horas
subespecies: 9 subagentes en paralelo
estado: PENDIENTE

fase: P - Planeacion
duracion: 1 hora
estado: PENDIENTE

fase: V - Validacion
duracion: 30 min
estado: PENDIENTE

fase: E - Ejecucion
duracion: 1-2 horas
nota: "Solo documentacion, no codigo"
estado: PENDIENTE

fase: D - Documentacion
duracion: 30 min
estado: PENDIENTE

total_estimado: 5-7 horas (con paralelizacion)
```

---

## C.12 Entregables Finales

```yaml
entregables:
  documentacion_componentes:
    descripcion: "Documento markdown por cada modulo con todos sus componentes documentados"
    ubicacion: "orchestration/tareas/TASK-002/entregables/componentes/"
    cantidad: 9 (uno por epic)

  contratos_api:
    descripcion: "Matriz completa de endpoints consumidos con schemas"
    ubicacion: "orchestration/tareas/TASK-002/entregables/API-CONTRACTS-MATRIX.md"
    cantidad: 1

  matriz_multimedia:
    descripcion: "Tabla de componentes que manejan multimedia con tipo y operaciones"
    ubicacion: "orchestration/tareas/TASK-002/entregables/MULTIMEDIA-MATRIX.md"
    cantidad: 1

  plan_purga:
    descripcion: "Lista de documentacion obsoleta a eliminar con justificacion"
    ubicacion: "orchestration/tareas/TASK-002/entregables/PURGE-PLAN.md"
    cantidad: 1

  plan_integracion:
    descripcion: "Lista de definiciones faltantes a agregar"
    ubicacion: "orchestration/tareas/TASK-002/entregables/INTEGRATION-PLAN.md"
    cantidad: 1

  grafo_dependencias:
    descripcion: "Grafo de dependencias entre componentes y modulos"
    ubicacion: "orchestration/tareas/TASK-002/entregables/DEPENDENCY-GRAPH.md"
    cantidad: 1

  roadmap_implementacion:
    descripcion: "Plan para cerrar gaps identificados"
    ubicacion: "orchestration/tareas/TASK-002/entregables/IMPLEMENTATION-ROADMAP.md"
    cantidad: 1

  reporte_consolidado:
    descripcion: "Resumen ejecutivo de toda la auditoria"
    ubicacion: "orchestration/tareas/TASK-002/entregables/EXECUTIVE-SUMMARY.md"
    cantidad: 1
```

---

**FASE C COMPLETADA**
**Siguiente Fase:** A - Analisis (orquestacion de 9 subagentes en paralelo)