# 02-ANÁLISIS (A) - Análisis del Modelado de Datos

**Tarea:** TASK-2026-02-03-ANALISIS-DDL-MODELADO
**Fase:** Análisis (A)
**Estado:** COMPLETADO
**Fecha:** 2026-02-03

---

## 1. RESUMEN EJECUTIVO

Se realizó un análisis exhaustivo del modelado de datos del proyecto trading-platform:

| Métrica | Valor |
|---------|-------|
| Schemas analizados | 11 |
| Tablas identificadas | ~90 |
| Tipos ENUM | 68+ |
| Foreign Keys | 102+ |
| Índices | 200+ |
| Triggers/Funciones | 40+ |
| Archivos DDL | 134 |
| **Gaps identificados** | 15 |
| **Conflictos detectados** | 5 |
| **Duplicidades** | 3 |

---

## 2. INVENTARIO DE SCHEMAS

### 2.1 Distribución por Schema

| Schema | Tablas | Enums | FK | Índices | Estado |
|--------|--------|-------|-----|---------|--------|
| auth | 12 | 6 | 8 | 25 | ✅ Completo |
| education | 17 | 6 | 15 | 30 | ⚠️ Gaps menores |
| trading | 11 | 8 | 10 | 22 | ⚠️ Gaps menores |
| investment | 10 | 6 | 8 | 18 | ✅ Completo |
| financial | 11 | 12 | 9 | 24 | ✅ Completo |
| portfolio | 5 | 4 | 5 | 12 | ✅ Completo |
| market_data | 4 | 2 | 2 | 8 | ✅ Completo |
| ml | 11 | 6 | 8 | 20 | ⚠️ Gaps menores |
| llm | 5 | 7 | 4 | 12 | ✅ Completo |
| audit | 7 | 5 | 5 | 18 | ✅ Completo |
| feature_flags | 3 | 2 | 1 | 6 | ✅ Completo |

### 2.2 Relaciones Principales

```
auth.users (CENTRO)
├── auth.user_profiles (1:1)
├── auth.oauth_accounts (1:N)
├── auth.sessions (1:N)
├── trading.bots (1:N)
├── trading.orders (1:N)
├── trading.positions (1:N)
├── financial.wallets (1:N)
├── investment.accounts (1:N)
├── portfolio.portfolios (1:N)
├── education.enrollments (1:N)
├── llm.conversations (1:N)
└── audit.audit_logs (1:N)
```

---

## 3. GAPS IDENTIFICADOS

### 3.1 Gaps Críticos (P0)

| ID | Schema | Gap | Impacto | Épica |
|----|--------|-----|---------|-------|
| GAP-001 | trading | Tabla `price_alerts` sin FK a symbols | Integridad referencial | OQI-003 |
| GAP-002 | financial | Tabla `refunds` no existe | Funcionalidad Stripe | OQI-005 |
| GAP-003 | education | Tabla `instructors` sin definir | Videos/Cursos | OQI-002 |
| GAP-004 | ml | Overlay predicciones incompleto | Señales ML | OQI-006 |

### 3.2 Gaps Moderados (P1)

| ID | Schema | Gap | Impacto | Épica |
|----|--------|-----|---------|-------|
| GAP-005 | education | Falta `course_tags` para búsqueda | SEO/UX | OQI-002 |
| GAP-006 | trading | `drawing_tools` no tiene tablas | Herramientas dibujo | OQI-003 |
| GAP-007 | investment | `agent_executions` incompleta | Tracking agentes | OQI-004 |
| GAP-008 | ml | Falta índice compuesto symbol+timeframe+created | Performance | OQI-006 |

### 3.3 Gaps Menores (P2)

| ID | Schema | Gap | Impacto | Épica |
|----|--------|-----|---------|-------|
| GAP-009 | auth | Falta índice en `locked_until` | Performance | OQI-001 |
| GAP-010 | education | `course_reviews` sin soft delete | Gestión datos | OQI-002 |
| GAP-011 | audit | Falta particionamiento | Escalabilidad | Transversal |
| GAP-012 | llm | Falta índice GIN en `tags` | Búsqueda | OQI-007 |

### 3.4 Gaps de Documentación (P2)

| ID | Ubicación | Gap |
|----|-----------|-----|
| GAP-DOC-001 | OQI-003 | ET-TRD-003-database.md desactualizado |
| GAP-DOC-002 | OQI-005 | Falta documentación tabla refunds |
| GAP-DOC-003 | Inventarios | DATABASE_INVENTORY.yml desactualizado |

---

## 4. CONFLICTOS DETECTADOS

### 4.1 Conflictos de Nomenclatura

| ID | Conflicto | Detalle | Resolución Propuesta |
|----|-----------|---------|---------------------|
| CONF-001 | `transaction_type` duplicado | Existe en `financial` e `investment` | Renombrar a `financial_tx_type` / `investment_tx_type` |
| CONF-002 | `transaction_status` duplicado | Mismos schemas | Unificar en tipo compartido |

### 4.2 Conflictos de Diseño

| ID | Conflicto | Detalle | Resolución Propuesta |
|----|-----------|---------|---------------------|
| CONF-003 | Catálogo símbolos duplicado | `trading.symbols` vs referencias hardcoded en ML | Usar FK a trading.symbols |
| CONF-004 | Wallet types inconsistentes | Enum `wallet_type` vs columnas específicas | Mantener enum (actual correcto) |
| CONF-005 | Timestamps inconsistentes | Algunos `timestamp`, otros `timestamptz` | Estandarizar a `timestamptz` |

---

## 5. DUPLICIDADES DETECTADAS

| ID | Tipo | Ubicación 1 | Ubicación 2 | Acción |
|----|------|-------------|-------------|--------|
| DUP-001 | Enum | `trading.timeframe` | `market_data.timeframe` | Unificar en schema `public` |
| DUP-002 | Tabla concepto | `trading.signals` | `ml.predictions` | Mantener separados (propósitos diferentes) |
| DUP-003 | Función | `update_updated_at()` | Definida en múltiples schemas | Mover a schema `public` |

---

## 6. VALIDACIÓN POR ÉPICA

### 6.1 OQI-001: Auth (85%)

```yaml
estado: COMPLETO
tablas_ddl: 12
tablas_doc: 12
match: 100%
gaps:
  - Falta índice locked_until (P2)
conflictos: ninguno
```

### 6.2 OQI-002: Education (55%)

```yaml
estado: GAPS MENORES
tablas_ddl: 17
tablas_doc: 14
match: 82%
gaps:
  - instructors sin definir (P0)
  - course_tags faltante (P1)
  - review soft delete (P2)
conflictos: ninguno
```

### 6.3 OQI-003: Trading (60%)

```yaml
estado: GAPS MODERADOS
tablas_ddl: 11
tablas_doc: 12
match: 92%
gaps:
  - price_alerts FK (P0)
  - drawing_tools (P1)
  - indicadores técnicos no tienen tablas (por diseño - calculados)
conflictos: ninguno
```

### 6.4 OQI-004: Investment (55%)

```yaml
estado: COMPLETO CON GAPS
tablas_ddl: 10
tablas_doc: 10
match: 100%
gaps:
  - agent_executions incompleta (P1)
conflictos: ninguno
```

### 6.5 OQI-005: Payments/Financial (65%)

```yaml
estado: GAP CRITICO
tablas_ddl: 11
tablas_doc: 12
match: 92%
gaps:
  - refunds no existe (P0 - BLOQUEANTE)
conflictos: ninguno
```

### 6.6 OQI-006: ML (75%)

```yaml
estado: GAPS MENORES
tablas_ddl: 11
tablas_doc: 11
match: 100%
gaps:
  - overlay predicciones (P0)
  - índice compuesto (P1)
conflictos:
  - símbolos referenciados como strings, no FK
```

### 6.7 OQI-007: LLM (45%)

```yaml
estado: COMPLETO
tablas_ddl: 5
tablas_doc: 5
match: 100%
gaps:
  - índice GIN tags (P2)
conflictos: ninguno
```

### 6.8 OQI-008: Portfolio (45%)

```yaml
estado: COMPLETO
tablas_ddl: 5
tablas_doc: 5
match: 100%
gaps: ninguno
conflictos: ninguno
```

### 6.9 OQI-009: MT4 (15%)

```yaml
estado: NO EXISTE DDL
tablas_ddl: 0
tablas_doc: TBD
match: 0%
gaps:
  - Schema completo no existe (P0 - BLOQUEANTE decisión)
conflictos: N/A
nota: Requiere decisión MetaAPI vs Local Terminal
```

---

## 7. COHERENCIA ENTRE CAPAS

### 7.1 DDL ↔ Backend

| Schema | Entities Backend | Match |
|--------|------------------|-------|
| auth | 12 entities | 100% |
| education | 14 entities | 82% (faltan 3) |
| trading | 10 entities | 91% |
| investment | 8 entities | 80% |
| financial | 9 entities | 82% |
| portfolio | 4 entities | 80% |
| market_data | 3 entities | 75% |
| ml | 6 entities | 55% |
| llm | 4 entities | 80% |
| audit | 5 entities | 71% |

**Promedio coherencia DDL↔Backend:** 80%

### 7.2 Gaps de Coherencia

| Tabla DDL | Entity Backend | Gap |
|-----------|----------------|-----|
| education.instructors | No existe | Crear entity |
| financial.refunds | No existe | Crear tabla + entity |
| trading.price_alerts | Parcial | Completar relaciones |
| ml.feature_store | No existe | Crear entity |
| audit.compliance_logs | No existe | Crear entity |

---

## 8. DOCUMENTACIÓN A PURGAR

### 8.1 Tareas Obsoletas

| Archivo | Motivo | Acción |
|---------|--------|--------|
| TASK-2025-* | Año anterior | Archivar |
| docs/99-analisis/obsoletos/ | Análisis superados | Eliminar |
| orchestration/tareas/_archive/pre-2026/ | Histórico | Mantener comprimido |

### 8.2 Especificaciones Desactualizadas

| Archivo | Estado | Acción |
|---------|--------|--------|
| ET-TRD-003-database.md | Desactualizado | Actualizar |
| ET-EDU-001-database.md | Parcialmente actualizado | Completar |
| ET-AUTH-003-database.sql | Correcto | Mantener |

---

## 9. DEPENDENCIAS IDENTIFICADAS

### 9.1 Dependencias Internas

```yaml
orden_creacion_schemas:
  1. auth (base - usuarios)
  2. trading (depende de auth)
  3. financial (depende de auth)
  4. investment (depende de auth, financial)
  5. portfolio (depende de auth, trading)
  6. market_data (independiente)
  7. ml (depende de trading, market_data)
  8. education (depende de auth)
  9. llm (depende de auth)
  10. audit (depende de todos)
  11. feature_flags (independiente)
```

### 9.2 Dependencias Circulares

```yaml
detectadas: 0
nota: Diseño limpio sin ciclos
```

---

## 10. RIESGOS IDENTIFICADOS

| ID | Riesgo | Probabilidad | Impacto | Mitigación |
|----|--------|--------------|---------|------------|
| R-001 | OQI-009 sin DDL bloquea MT4 | Alta | Alto | Decisión stakeholder |
| R-002 | Refunds faltante = PCI issues | Alta | Crítico | Implementar P0 |
| R-003 | Inconsistencias timestamp | Media | Bajo | Migración controlada |
| R-004 | Duplicidad enums | Baja | Bajo | Unificar gradualmente |

---

## 11. RECOMENDACIONES

### 11.1 Acciones Inmediatas (P0)

1. **Crear tabla `financial.refunds`** - Bloqueante para Stripe
2. **Definir tabla `education.instructors`** - Bloqueante para videos
3. **Agregar FK a `trading.price_alerts`** - Integridad
4. **Decisión MT4** - Define si se crea DDL para OQI-009

### 11.2 Acciones Corto Plazo (P1)

1. Unificar `timeframe` enum en schema público
2. Agregar índices faltantes identificados
3. Completar `agent_executions`
4. Crear `course_tags`

### 11.3 Acciones Mediano Plazo (P2)

1. Estandarizar todos los timestamps a `timestamptz`
2. Mover funciones comunes a schema `public`
3. Considerar particionamiento en `audit`
4. Documentar todas las decisiones en ADRs

---

## 12. PRÓXIMA FASE

→ **Continuar a:** `03-PLANIFICACION.md`

---

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