trading-platform/orchestration/tareas/TASK-2026-02-03-ANALISIS-DDL-MODELADO/01-CAPTURA.md
Adrian Flores Cortes 92b1009fe8 [TASK-2026-02-03-ANALISIS-DDL-MODELADO] docs: Add comprehensive DDL analysis and planning
Phase C (Context) and A (Analysis) complete:
- Analyzed 11 schemas, ~90 tables, 68+ enums
- Identified 15 gaps (4 P0, 4 P1, 7 P2)
- Detected 5 conflicts and 3 duplicities
- Created validation matrix DDL vs requirements

Phase P (Planning) in progress:
- 7-phase execution plan with CAPVED compliance
- Subtask delegation plan for parallel execution
- Estimated effort: 126h (without MT4)

Key findings:
- GAP-002: financial.refunds missing (P0 - Stripe blocker)
- GAP-003: education.instructors missing (P0)
- CONF-001: transaction_type enum conflict
- DUP-001: timeframe enum duplicated

Deliverables created:
- 01-CAPTURA.md, 02-ANALISIS.md, 03-PLANIFICACION.md
- DDL-GAPS-REGISTRY.yml
- DDL-CONFLICTS-REGISTRY.yml
- DDL-VALIDATION-MATRIX.yml
- DELEGATION-PLAN.yml

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 23:40:28 -06:00

214 lines
5.1 KiB
Markdown

# 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