trading-platform/orchestration/tareas/TASK-2026-02-03-ANALISIS-DDL-MODELADO/02-ANALISIS.md

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%)

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

6.2 OQI-002: Education (55%)

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%)

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%)

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%)

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%)

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%)

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

6.8 OQI-008: Portfolio (45%)

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

6.9 OQI-009: MT4 (15%)

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

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

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