# 01-CAPTURA (C) - Contexto de la Tarea

**Tarea:** TASK-2026-02-03-ANALISIS-DDL-MODELADO
**Fase:** Contexto (C)
**Estado:** COMPLETADO
**Fecha:** 2026-02-03

---

## 1. VINCULACIÓN

| Campo | Valor |
|-------|-------|
| **Proyecto** | trading-platform |
| **Módulo** | Database / DDL |
| **Epic** | Transversal (afecta OQI-001 a OQI-009) |
| **Tipo** | analysis |
| **Origen** | user-request |

---

## 2. CLASIFICACIÓN

### 2.1 Tipo de Tarea

```yaml
tipo: analysis
subtipo: validacion-modelado-datos
alcance:
  - DDL completo (11 schemas)
  - Coherencia con requerimientos
  - Coherencia con backend/frontend
  - Purga documentación obsoleta
```

### 2.2 Modo de Ejecución

```yaml
modo: "@ANALYSIS"
fases_activas:
  - C: Contexto (COMPLETADO)
  - A: Análisis (COMPLETADO)
  - P: Planeación (EN PROGRESO)
  - V: Validación (pendiente)
  # E y D solo si se requieren cambios
```

---

## 3. DOCUMENTOS SIMCO RELEVANTES

### 3.1 Directivas Cargadas

| Directiva | Propósito |
|-----------|-----------|
| @CAPVED | Ciclo de vida obligatorio |
| @ESTANDAR-DATABASE | Estándares de base de datos |
| @PRINCIPIO-NORMALIZACION | Reglas de normalización |
| @SIMCO-DDL-UNIFIED | Operaciones DDL unificadas |
| @SIMCO-SUBAGENTES | Delegación a subagentes |
| @TRIGGER-COHERENCIA-CAPAS | Validación coherencia |

### 3.2 Inventarios de Referencia

| Inventario | Ubicación |
|------------|-----------|
| DATABASE_INVENTORY.yml | orchestration/inventarios/ |
| BACKEND_INVENTORY.yml | orchestration/inventarios/ |
| FRONTEND_INVENTORY.yml | orchestration/inventarios/ |
| MASTER_INVENTORY.yml | orchestration/inventarios/ |

### 3.3 Documentación Épicas

| Épica | Ubicación Base |
|-------|----------------|
| OQI-001 Auth | docs/02-definicion-modulos/OQI-001-fundamentos-auth/ |
| OQI-002 Education | docs/02-definicion-modulos/OQI-002-education/ |
| OQI-003 Trading | docs/02-definicion-modulos/OQI-003-trading-charts/ |
| OQI-004 Investment | docs/02-definicion-modulos/OQI-004-cuentas-inversion/ |
| OQI-005 Payments | docs/02-definicion-modulos/OQI-005-pagos-stripe/ |
| OQI-006 ML | docs/02-definicion-modulos/OQI-006-senales-ml/ |
| OQI-007 LLM | docs/02-definicion-modulos/OQI-007-llm-strategy-agent/ |
| OQI-008 Portfolio | docs/02-definicion-modulos/OQI-008-portfolio-manager/ |
| OQI-009 MT4 | docs/02-definicion-modulos/OQI-009-mt4-gateway/ |

---

## 4. ALCANCE DE LA TAREA

### 4.1 Dentro del Alcance

```yaml
incluido:
  DDL:
    - Validar todos los 11 schemas
    - Verificar ~90 tablas
    - Validar 68+ enums
    - Verificar 102+ foreign keys
    - Validar 200+ índices
    - Identificar gaps vs requerimientos
    - Detectar conflictos/duplicidades

  Documentación:
    - Purgar docs obsoletas de tareas previas
    - Integrar definiciones faltantes
    - Ordenar backlog de tareas DDL
    - Crear matriz de validación

  Coherencia:
    - DDL ↔ Backend entities
    - DDL ↔ Épicas documentadas
    - DDL ↔ Historias de usuario
```

### 4.2 Fuera del Alcance

```yaml
excluido:
  - Implementación de cambios en DDL
  - Modificación de código backend
  - Modificación de código frontend
  - Recreación de base de datos
  - Migraciones
```

---

## 5. CONTEXTO TÉCNICO

### 5.1 Estado Actual DDL

```yaml
base_datos: trading_platform
credenciales:
  usuario: trading_user
  password: trading_dev_2026
  puerto: 5432
  host: localhost (WSL)

schemas: 11
  - auth
  - trading
  - financial
  - investment
  - portfolio
  - market_data
  - ml
  - education
  - llm
  - audit
  - feature_flags

archivos_ddl: 134
ubicacion: apps/database/ddl/
```

### 5.2 Épicas y Completitud

| Épica | DDL % | Backend % | Frontend % | Total % |
|-------|-------|-----------|------------|---------|
| OQI-001 Auth | 100% | 90% | 70% | 85% |
| OQI-002 Education | 100% | 40% | 80% | 55% |
| OQI-003 Trading | 100% | 50% | 90% | 60% |
| OQI-004 Investment | 100% | 35% | 35% | 55% |
| OQI-005 Payments | 100% | 50% | 80% | 65% |
| OQI-006 ML | 100% | 70% | 95% | 75% |
| OQI-007 LLM | 100% | 40% | 45% | 45% |
| OQI-008 Portfolio | 100% | 45% | 0% | 45% |
| OQI-009 MT4 | 0% | 0% | 0% | 15% |

---

## 6. TAREAS RELACIONADAS

### 6.1 Tareas Activas

| Tarea | Estado | Relación |
|-------|--------|----------|
| TASK-2026-02-03-ANALISIS-FRONTEND-UXUI | 60% | Complementaria |
| TASK-2026-01-27-BLOCKER-001-TOKEN-REFRESH | Postergada | Puede requerir DDL |

### 6.2 Tareas Completadas Relevantes

| Tarea | Fecha | Hallazgos DDL |
|-------|-------|---------------|
| TASK-2026-01-30-ANALISIS-INTEGRACION | Completada | TP es standalone |
| TASK-2026-01-25-002-FRONTEND-AUDIT | Completada | 55 gaps identificados |

---

## 7. CRITERIOS DE ÉXITO

```yaml
criterios:
  - Matriz de validación DDL completa
  - 100% schemas validados contra requerimientos
  - Conflictos documentados con resolución propuesta
  - Gaps documentados con prioridad
  - Plan de subtareas CAPVED-compliant
  - Documentación purgada de obsoletos
  - Orden de ejecución lógico sin dependencias circulares
```

---

## 8. PRÓXIMA FASE

→ **Continuar a:** `02-ANALISIS.md` (Completado)
→ **Fase actual:** `03-PLANIFICACION.md` (En progreso)

---

**Fase C COMPLETADA** | Fecha: 2026-02-03 | Agente: claude-opus-4.5