b9098ca91c
Comprehensive analysis of 101 DDL tables across 11 schemas: - Phase 1-2: Schema validation, 37 gaps cataloged (3 resolved) - Phase 3: Integrity audit (80 FKs, 89 CHECKs, 17 issues: 2 CRIT/5 HIGH) - Phase 4: DDL-Backend mapping (84% interfaces, 75% services, 61% controllers) - Phase 5: Documentation purge catalog (201 files analyzed) - Phase 6: Remediation plan (4 sprints, 204h) Key finding: Backend uses raw SQL + pg Pool (NOT TypeORM). 13 deliverables + updated inventories to v2.0.0. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
31 KiB
31 KiB
ANALISIS MAESTRO - Validacion Integral del Modelado de Base de Datos
Trading Platform - TASK-2026-02-05-ANALISIS-VALIDACION-MODELADO-BD
Fecha: 2026-02-05 Perfil: Especialista en Base de Datos y Modelado de Datos Modo: @ANALYSIS (CAPVED: C+A+P sin ejecutar) Estado: FASE-1 COMPLETADA
1. CONTEXTO (C)
1.1 Situacion Actual
El proyecto trading-platform es una plataforma de trading e inversiones con arquitectura hibrida TypeScript/Python. Cuenta con:
- 11 schemas PostgreSQL 16+
- 100 tablas DDL definidas (vs 81 documentadas en inventario)
- 50+ enums personalizados
- 17+ funciones stored procedures
- 39+ triggers automaticos
- 9 modulos epicos (OQI-001 a OQI-009)
- Coherencia global actual: 81.25%
1.2 Problema Identificado
El modelado de datos presenta discrepancias significativas entre:
- DDL real (100 tablas) vs inventario documentado (81 tablas) = 19 tablas sin documentar
- Conflictos de enums duplicados entre schemas (3 conflictos activos)
- 1 error critico de FK en price_alerts (referencia incorrecta)
- Acoplamiento debil entre schemas criticos (wallets <-> investment, bots <-> wallets)
- Duplicacion funcional en catalogo de simbolos (trading.symbols vs market_data.tickers)
- Documentacion desactualizada con tareas completadas mezcladas con pendientes
1.3 Objetivo
Lograr un modelado de datos validado al 100%, coherente con la documentacion, sin conflictos ni duplicidades, preparado para integracion backend, con un plan de ejecucion detallado por fases.
2. ANALISIS (A)
2.1 Inventario de Hallazgos Criticos
2.1.1 ERROR CRITICO: FK Incorrecta en price_alerts
| Atributo | Valor |
|---|---|
| Archivo | apps/database/ddl/schemas/trading/tables/11-price_alerts.sql |
| Linea | 15 |
| Error | REFERENCES auth.user_profiles(id) |
| Correcto | REFERENCES auth.users(id) |
| Impacto | Tabla NO se puede crear - BLOQUEANTE |
| Prioridad | P0 - INMEDIATO |
2.1.2 Tablas No Documentadas (19 tablas)
| # | Schema | Tabla | Archivo DDL | Impacto |
|---|---|---|---|---|
| 1 | education | instructors | 17-instructors.sql | Backend tiene servicio sin tabla doc |
| 2 | education | course_tags | 18-course_tags.sql | Funcionalidad de tags no integrada |
| 3 | education | course_tag_assignments | 19-course_tag_assignments.sql | M:N tags-cursos sin doc |
| 4 | education | review_helpful_votes | 16-review_helpful_votes.sql | Votos de reviews sin doc |
| 5 | education | user_activity_log | 13-user_activity_log.sql | Tracking gamificacion sin doc |
| 6 | education | user_gamification_profile | 12-user_gamification_profile.sql | Perfil XP sin doc en inventario |
| 7 | education | course_reviews | 14-course_reviews.sql | Reviews de cursos sin doc |
| 8 | trading | drawing_tools | 12-drawing_tools.sql | Herramientas dibujo chart |
| 9 | trading | drawing_templates | 13-drawing_templates.sql | Templates de dibujo |
| 10 | financial | refunds | 11-refunds.sql | Reembolsos sin doc |
| 11 | financial | currency_exchange_rates | 07-currency_exchange_rates.sql | Tipos de cambio sin doc |
| 12 | investment | agent_executions | 10-agent_executions.sql | Ejecuciones agentes sin doc |
| 13 | investment | risk_questionnaire | 02-risk_questionnaire.sql | Cuestionario riesgo sin doc inv |
| 14 | ml | llm_signals | 11-llm_signals.sql | Senales LLM sin doc |
| 15 | ml | prediction_overlays | 12-prediction_overlays.sql | Overlays prediccion sin doc |
| 16 | feature_flags | flags | 01-flags.sql | Schema completo sin doc |
| 17 | auth | notifications | 11-notifications.sql | Notificaciones sin doc inv |
| 18 | auth | user_push_tokens | 12-user_push_tokens.sql | Push tokens sin doc inv |
| 19 | portfolio | portfolio_snapshots | 05-portfolio_snapshots.sql | Snapshots sin doc inv |
2.1.3 Conflictos de Enums (3 activos)
| ID | Enum | Schemas | Estado | Accion |
|---|---|---|---|---|
| CONF-E1 | transaction_type |
financial, investment | Migracion pendiente | Renombrar a wallet_transaction_type / investment_transaction_type |
| CONF-E2 | risk_profile |
investment, portfolio | NO marcado para migracion | Consolidar en public.risk_profile |
| CONF-E3 | timeframe |
public, trading, market_data | Parcialmente migrado | Completar migracion, agregar '1M' a market_data |
2.1.4 Acoplamiento Debil entre Schemas
| ID | Relacion Faltante | Impacto | Prioridad |
|---|---|---|---|
| WEAK-1 | investment.accounts <-> financial.wallets | Cuentas inversion sin wallet vinculado | P1 |
| WEAK-2 | trading.bots <-> financial.wallets | Bots sin tracking de capital en wallet | P1 |
| WEAK-3 | portfolio.portfolios <-> investment.accounts | Portafolio sin link a cuentas | P2 |
| WEAK-4 | market_data.tickers -> trading.symbols | Catalogo duplicado sin referencia cruzada | P1 |
2.1.5 Duplicacion Funcional
| ID | Objeto A | Objeto B | Tipo | Resolucion |
|---|---|---|---|---|
| DUP-1 | trading.symbols (UUID PK) | market_data.tickers (SERIAL PK) | Catalogo simbolos | Consolidar en trading.symbols como master |
| DUP-2 | auth.users.role | auth.user_status | Status/Role dual | Mantener separados (correcto) |
| DUP-3 | financial.wallet_audit_log | audit.audit_logs | Auditoria | Complementarios, mantener |
2.2 Analisis de Completitud por Schema
Schema: auth (13 tablas DDL / 10 inventario)
| Tabla | DDL | Inventario | Backend Entity | Backend Service | Gap |
|---|---|---|---|---|---|
| users | OK | OK | OK | OK | - |
| user_profiles | OK | OK | OK | OK | - |
| oauth_accounts | OK | OK | OK | OK | - |
| sessions | OK | OK | OK | OK | - |
| email_verifications | OK | OK | OK | OK | - |
| phone_verifications | OK | OK | OK | OK | - |
| password_reset_tokens | OK | OK | OK | OK | - |
| auth_logs | OK | OK | OK | OK | - |
| login_attempts | OK | OK | OK | Parcial | Falta rate limit service |
| rate_limiting_config | OK | OK | NO | NO | Falta entity + service |
| notifications | OK | FALTA | OK | Parcial | Falta doc inventario |
| user_push_tokens | OK | FALTA | NO | NO | Falta entity + service + doc |
Coherencia auth: 10/13 documentadas = 77% (deberia ser 100%)
Schema: trading (13 tablas DDL / 11 inventario)
| Tabla | DDL | Inventario | Backend Entity | Backend Service | Gap |
|---|---|---|---|---|---|
| symbols | OK | OK | OK | OK | - |
| watchlists | OK | OK | OK | OK | - |
| watchlist_items | OK | OK | OK | OK | - |
| bots | OK | OK | OK | Parcial (60%) | Falta completar bot service |
| orders | OK | OK | OK | OK | - |
| positions | OK | OK | OK | OK | - |
| trades | OK | OK | OK | OK | - |
| signals | OK | OK | OK | OK | - |
| trading_metrics | OK | OK | OK | Parcial | Falta metrics service |
| paper_balances | OK | OK | OK | OK | - |
| price_alerts | OK | OK | NO | NO | FK ERROR + falta entity |
| drawing_tools | OK | FALTA | NO | NO | Nuevo - falta todo |
| drawing_templates | OK | FALTA | NO | NO | Nuevo - falta todo |
Coherencia trading: 11/13 documentadas = 85%
Schema: education (19 tablas DDL / 12 inventario)
| Tabla | DDL | Inventario | Backend Entity | Backend Service | Gap |
|---|---|---|---|---|---|
| categories | OK | OK | OK | OK | - |
| courses | OK | OK | OK | OK | - |
| modules | OK | OK | OK | OK | - |
| lessons | OK | OK | OK | OK | - |
| enrollments | OK | OK | OK | OK | - |
| progress | OK | Falta | OK | Parcial | Falta doc |
| quizzes | OK | OK | OK | OK | - |
| quiz_questions | OK | OK | OK | OK | - |
| quiz_attempts | OK | OK | OK | OK | - |
| certificates | OK | OK | OK | OK | - |
| user_achievements | OK | OK | OK | OK | - |
| user_gamification_profile | OK | OK | OK | OK | - |
| videos | OK | OK | NO | NO | Falta entity |
| user_activity_log | OK | FALTA | NO | NO | Falta todo |
| course_reviews | OK | FALTA | NO | Parcial | Falta entity |
| review_helpful_votes | OK | FALTA | NO | NO | Falta todo |
| instructors | OK | FALTA | NO | Existe stub | Falta entity real |
| course_tags | OK | FALTA | NO | NO | Falta todo |
| course_tag_assignments | OK | FALTA | NO | NO | Falta todo |
Coherencia education: 12/19 documentadas = 63% (la peor)
Schema: financial (11 tablas DDL / 9 inventario)
| Tabla | DDL | Inventario | Backend Entity | Backend Service | Gap |
|---|---|---|---|---|---|
| wallets | OK | OK | OK | OK | - |
| wallet_transactions | OK | OK | OK | OK | - |
| subscriptions | OK | OK | OK | OK | - |
| invoices | OK | OK | OK | OK | - |
| payments | OK | OK | OK | OK | - |
| wallet_audit_log | OK | OK | OK | OK | - |
| wallet_limits | OK | OK | NO | NO | Falta entity |
| customers | OK | OK | OK | OK | - |
| payment_methods | OK | OK | OK | OK | - |
| currency_exchange_rates | OK | FALTA | NO | NO | Falta todo |
| refunds | OK | FALTA | NO | NO | Falta todo |
Coherencia financial: 9/11 documentadas = 82%
Schema: investment (10 tablas DDL / 8 inventario)
| Tabla | DDL | Inventario | Backend Entity | Backend Service | Gap |
|---|---|---|---|---|---|
| products | OK | OK | OK | OK | - |
| risk_questionnaire | OK | Falta | OK | Parcial | Falta doc inv |
| accounts | OK | OK | OK | OK | - |
| distributions | OK | OK | OK | OK | - |
| transactions | OK | OK | OK | OK | - |
| withdrawal_requests | OK | OK | OK | OK | - |
| daily_performance | OK | OK | OK | Parcial | Falta performance service |
| distribution_history | OK | OK | NO | NO | Nuevo Sprint 3 |
| distribution_runs | OK | OK | NO | NO | Nuevo Sprint 3 |
| agent_executions | OK | FALTA | NO | NO | Falta todo |
Coherencia investment: 8/10 documentadas = 80%
Schema: ml (12 tablas DDL / 10 inventario)
| Tabla | DDL | Inventario | Backend Entity | Backend Service | Gap |
|---|---|---|---|---|---|
| models | OK | OK | OK | OK | - |
| model_versions | OK | OK | OK | OK | - |
| predictions | OK | OK | OK | OK | - |
| prediction_outcomes | OK | OK | OK | OK | - |
| feature_store | OK | OK | OK | OK | - |
| llm_predictions | OK | OK | OK | OK | - |
| llm_prediction_outcomes | OK | OK | OK | OK | - |
| llm_decisions | OK | OK | OK | OK | - |
| risk_events | OK | OK | OK | OK | - |
| backtest_runs | OK | OK | OK | OK | - |
| llm_signals | OK | FALTA | NO | NO | Falta todo |
| prediction_overlays | OK | FALTA | NO | NO | Falta todo |
Coherencia ml: 10/12 documentadas = 83%
Schema: llm (5 tablas DDL / 4 inventario)
| Tabla | DDL | Inventario | Backend Entity | Backend Service | Gap |
|---|---|---|---|---|---|
| conversations | OK | OK | OK | OK | - |
| messages | OK | OK | OK | OK | - |
| user_preferences | OK | Falta | OK | OK | Falta doc inv |
| user_memory | OK | OK | OK | OK | - |
| embeddings | OK | OK | OK | Parcial | pgvector integration |
Coherencia llm: 4/5 documentadas = 80%
Schema: audit (7 tablas DDL / 7 inventario)
Todas documentadas. Coherencia: 100%. Sin embargo, NO tiene servicios backend.
Schema: portfolio (5 tablas DDL / 4 inventario)
| Tabla | DDL | Inventario | Backend Entity | Backend Service | Gap |
|---|---|---|---|---|---|
| portfolios | OK | OK | OK | OK | - |
| portfolio_allocations | OK | OK | OK | OK | - |
| portfolio_goals | OK | OK | OK | OK | - |
| rebalance_history | OK | OK | NO | NO | Falta entity |
| portfolio_snapshots | OK | FALTA | NO | NO | Falta todo |
Coherencia portfolio: 4/5 documentadas = 80%
Schema: market_data (4 tablas DDL / 3 inventario)
| Tabla | DDL | Inventario | Backend Entity | Backend Service | Gap |
|---|---|---|---|---|---|
| tickers | OK | OK | OK | Parcial | Falta completar |
| ohlcv_5m | OK | OK | NO | NO | Falta entity |
| ohlcv_15m | OK | OK | NO | NO | Falta entity |
| staging | OK | Falta | NO | NO | ETL staging |
Coherencia market_data: 3/4 documentadas = 75%
Schema: feature_flags (1 tabla DDL / 0 inventario)
| Tabla | DDL | Inventario | Backend Entity | Backend Service | Gap |
|---|---|---|---|---|---|
| flags | OK | FALTA | NO | Parcial | Schema completo sin doc |
Coherencia feature_flags: 0/1 documentadas = 0% (peor caso)
2.3 Resumen de Coherencia DDL-Inventario
| Schema | DDL | Documentadas | Coherencia |
|---|---|---|---|
| auth | 13 | 10 | 77% |
| trading | 13 | 11 | 85% |
| education | 19 | 12 | 63% |
| financial | 11 | 9 | 82% |
| investment | 10 | 8 | 80% |
| ml | 12 | 10 | 83% |
| llm | 5 | 4 | 80% |
| audit | 7 | 7 | 100% |
| portfolio | 5 | 4 | 80% |
| market_data | 4 | 3 | 75% |
| feature_flags | 1 | 0 | 0% |
| TOTAL | 100 | 78 | 78% |
2.4 Analisis de Documentacion para Purga
Documentacion Obsoleta / Candidatos a Purga
| Ubicacion | Tipo | Razon | Accion |
|---|---|---|---|
| orchestration/tareas/_archive/2026-01/ | Tareas archivadas | Estructura creada pero archivos no movidos | Completar archivado |
| orchestration/analisis/_archive/2026-01-25/ | Analisis OQI-001 viejos | Superseded por TASK-2026-02-03 | Mantener en archive |
| docs/_archive/04-fase-backlog/ | Backlog deprecado | Links rotos a /docs/planning/ | Eliminar |
| docs/_archive/00-notas/NOTA-DISCREPANCIA-PUERTOS-2025-12-08.md | Nota resuelta | Resuelto 2026-01-07 | Eliminar |
| orchestration/analisis/coherencia/COHERENCE-BASELINE-2026-01-28.md | Baseline viejo | Superseded por version actual | Mover a _archive |
| orchestration/tareas/2026-01-25/ | Carpeta fecha antigua | Tareas movidas o completadas | Verificar y archivar |
| orchestration/tareas/2026-01-27/ | Carpeta fecha antigua | Tareas movidas o completadas | Verificar y archivar |
Documentacion Faltante (a integrar)
| Tipo | Contenido | Ubicacion Sugerida |
|---|---|---|
| Definicion | feature_flags schema completo | docs/02-definicion-modulos/ (transversal) |
| Especificacion | ET para drawing_tools/templates | docs/02-definicion-modulos/OQI-003-trading-charts/ |
| Historia Usuario | US para price_alerts | docs/02-definicion-modulos/OQI-003-trading-charts/ |
| Requerimiento | RF para refunds | docs/02-definicion-modulos/OQI-005-payments-stripe/ |
| Especificacion | ET para course_tags | docs/02-definicion-modulos/OQI-002-education/ |
| Historia Usuario | US para instructors management | docs/02-definicion-modulos/OQI-002-education/ |
| Requerimiento | RF para agent_executions | docs/02-definicion-modulos/OQI-004-investment-accounts/ |
| Especificacion | ET para prediction_overlays | docs/02-definicion-modulos/OQI-006-ml-signals/ |
3. PLANIFICACION (P) - PLAN MAESTRO POR FASES
3.0 Estructura General de Fases
FASE-1: Analisis y Planificacion (COMPLETADA - este documento)
|
v
FASE-2: Validacion de Esquemas y Objetos DDL
├── 2.1: Correccion de errores criticos DDL
├── 2.2: Validacion schema-por-schema
├── 2.3: Resolucion de conflictos de enums
└── 2.4: Resolucion de duplicaciones funcionales
|
v
FASE-3: Auditoria de Integridad y Coherencia
├── 3.1: Validacion de foreign keys
├── 3.2: Validacion de indices
├── 3.3: Validacion de constraints
├── 3.4: Validacion de funciones y triggers
└── 3.5: Validacion de relaciones entre schemas
|
v
FASE-4: Coherencia DDL-Backend
├── 4.1: Mapeo tablas -> entities
├── 4.2: Mapeo entities -> services
├── 4.3: Mapeo services -> controllers
├── 4.4: Identificacion de gaps de implementacion
└── 4.5: Plan de entidades faltantes
|
v
FASE-5: Purga y Reorganizacion Documental
├── 5.1: Purgar documentacion obsoleta
├── 5.2: Integrar definiciones faltantes
├── 5.3: Actualizar inventarios
└── 5.4: Actualizar documentacion de modulos
|
v
FASE-6: Plan Maestro de Remediacion
├── 6.1: Priorizar acciones por impacto
├── 6.2: Definir orden de ejecucion con dependencias
├── 6.3: Estimar esfuerzo por subtarea
└── 6.4: Generar roadmap actualizado
FASE-2: Validacion de Esquemas y Objetos DDL
SUBTAREA 2.1: Correccion de Errores Criticos DDL
CAPVED:
- C: price_alerts tiene FK incorrecta que impide creacion de tabla
- A: Error en linea 15 de 11-price_alerts.sql:
auth.user_profiles(id)deberia serauth.users(id) - P: Modificar archivo SQL corrigiendo la referencia
- V: Recrear BD en WSL, verificar tabla se crea correctamente
- E: Modificar archivo, ejecutar DDL
- D: Documentar correccion en changelog
| ID | Tarea | Archivo | Prioridad | Esfuerzo | Dependencias |
|---|---|---|---|---|---|
| 2.1.1 | Corregir FK price_alerts | trading/tables/11-price_alerts.sql | P0 | 0.5h | Ninguna |
| 2.1.2 | Verificar creacion tabla | Script recreacion BD | P0 | 0.5h | 2.1.1 |
SUBTAREA 2.2: Validacion Schema por Schema
Para CADA schema se debe validar (CAPVED por cada uno):
| ID | Schema | Tablas | Accion Principal | Esfuerzo | Paralelizable |
|---|---|---|---|---|---|
| 2.2.1 | auth | 13 | Documentar notifications + user_push_tokens | 2h | Si |
| 2.2.2 | trading | 13 | Documentar drawing_tools + drawing_templates | 2h | Si |
| 2.2.3 | education | 19 | Documentar 7 tablas faltantes | 4h | Si |
| 2.2.4 | financial | 11 | Documentar refunds + currency_exchange_rates | 2h | Si |
| 2.2.5 | investment | 10 | Documentar agent_executions + risk_questionnaire | 2h | Si |
| 2.2.6 | ml | 12 | Documentar llm_signals + prediction_overlays | 2h | Si |
| 2.2.7 | llm | 5 | Documentar user_preferences | 1h | Si |
| 2.2.8 | audit | 7 | Validar completitud (ya 100%) | 0.5h | Si |
| 2.2.9 | portfolio | 5 | Documentar portfolio_snapshots | 1h | Si |
| 2.2.10 | market_data | 4 | Documentar staging | 1h | Si |
| 2.2.11 | feature_flags | 1 | Documentar schema completo | 2h | Si |
Total 2.2: 19.5h (paralelizable a ~8h con 3 agentes)
CAPVED para cada 2.2.X:
- C: Schema tiene N tablas DDL, M documentadas en inventario
- A: Leer cada archivo SQL, comparar con inventario, identificar campos/tipos/constraints
- P: Crear/actualizar entrada en DATABASE_INVENTORY.yml para tablas faltantes
- V: Verificar coherencia post-actualizacion
- E: Actualizar DATABASE_INVENTORY.yml
- D: Registrar cambios en changelog
SUBTAREA 2.3: Resolucion de Conflictos de Enums
| ID | Conflicto | Accion | Esfuerzo | Dependencias |
|---|---|---|---|---|
| 2.3.1 | CONF-E1: transaction_type | Verificar migracion existe, crear si no | 2h | 2.2.4, 2.2.5 |
| 2.3.2 | CONF-E2: risk_profile | Crear migracion a public.risk_profile | 2h | 2.2.5, 2.2.9 |
| 2.3.3 | CONF-E3: timeframe | Completar migracion, agregar '1M' a market_data | 1h | 2.2.10 |
Total 2.3: 5h
SUBTAREA 2.4: Resolucion de Duplicaciones Funcionales
| ID | Duplicacion | Accion | Esfuerzo | Dependencias |
|---|---|---|---|---|
| 2.4.1 | DUP-1: symbols vs tickers | Analizar consolidacion, crear plan de migracion | 4h | 2.2.2, 2.2.10 |
Total 2.4: 4h
TOTAL FASE-2: 30h (~12h con paralelizacion)
FASE-3: Auditoria de Integridad y Coherencia
SUBTAREA 3.1: Validacion de Foreign Keys
CAPVED:
- C: 100 tablas con multiples FKs inter-schema
- A: Recorrer cada tabla, verificar que FKs referencian tablas existentes con tipos correctos
- P: Generar matriz de FKs con estado de validacion
- V: Cada FK validada contra tabla destino
- E: Ejecutar validacion
- D: Generar FK-VALIDATION-MATRIX.yml
| ID | Grupo | Tablas | Accion | Esfuerzo | Paralelizable |
|---|---|---|---|---|---|
| 3.1.1 | auth -> auth | 13 tablas | Validar FKs internas | 1h | Si |
| 3.1.2 | trading -> auth, trading | 13 tablas | Validar FKs cross-schema | 1.5h | Si |
| 3.1.3 | education -> auth, education | 19 tablas | Validar FKs cross-schema | 2h | Si |
| 3.1.4 | financial -> auth, financial | 11 tablas | Validar FKs cross-schema | 1.5h | Si |
| 3.1.5 | investment -> auth, investment | 10 tablas | Validar FKs cross-schema | 1h | Si |
| 3.1.6 | ml, llm, portfolio, audit | 29 tablas | Validar FKs cross-schema | 2h | Si |
| 3.1.7 | Relaciones faltantes | WEAK-1 a WEAK-4 | Documentar y proponer FKs | 2h | No (depende de 3.1.1-3.1.6) |
Total 3.1: 11h (~5h con paralelizacion)
SUBTAREA 3.2: Validacion de Indices
| ID | Accion | Esfuerzo | Paralelizable |
|---|---|---|---|
| 3.2.1 | Inventariar todos los indices existentes | 3h | Si (por schema) |
| 3.2.2 | Identificar queries criticas sin indice | 2h | No |
| 3.2.3 | Proponer indices faltantes | 1h | No |
Total 3.2: 6h
SUBTAREA 3.3: Validacion de Constraints
| ID | Accion | Esfuerzo | Paralelizable |
|---|---|---|---|
| 3.3.1 | Validar CHECK constraints por tabla | 3h | Si |
| 3.3.2 | Validar UNIQUE constraints | 1h | Si |
| 3.3.3 | Validar NOT NULL en campos criticos | 1h | Si |
| 3.3.4 | Validar DEFAULT values | 1h | Si |
Total 3.3: 6h
SUBTAREA 3.4: Validacion de Funciones y Triggers
| ID | Accion | Esfuerzo | Paralelizable |
|---|---|---|---|
| 3.4.1 | Inventariar 17+ funciones | 2h | Si |
| 3.4.2 | Validar funciones usadas en triggers | 1h | No |
| 3.4.3 | Identificar funciones huerfanas | 1h | No |
| 3.4.4 | Validar triggers de updated_at | 1h | Si |
| 3.4.5 | Validar triggers de auditoria | 1h | Si |
Total 3.4: 6h
SUBTAREA 3.5: Validacion de Relaciones Inter-Schema
| ID | Accion | Esfuerzo | Paralelizable |
|---|---|---|---|
| 3.5.1 | Mapear dependencias auth -> todos los schemas | 2h | No |
| 3.5.2 | Identificar ciclos de dependencia | 1h | No |
| 3.5.3 | Validar ON DELETE behavior (CASCADE vs RESTRICT) | 2h | No |
| 3.5.4 | Documentar diagrama ER inter-schema | 3h | No |
Total 3.5: 8h
TOTAL FASE-3: 37h (~18h con paralelizacion)
FASE-4: Coherencia DDL-Backend
SUBTAREA 4.1: Mapeo Tablas -> Entities
CAPVED por cada modulo backend:
| ID | Modulo | Tablas | Entities Existentes | Gap | Esfuerzo |
|---|---|---|---|---|---|
| 4.1.1 | auth | 13 | 10 | 3 faltantes | 2h |
| 4.1.2 | trading | 13 | 10 | 3 faltantes | 2h |
| 4.1.3 | education | 19 | 12 | 7 faltantes | 3h |
| 4.1.4 | financial | 11 | 9 | 2 faltantes | 1.5h |
| 4.1.5 | investment | 10 | 7 | 3 faltantes | 1.5h |
| 4.1.6 | ml | 12 | 10 | 2 faltantes | 1h |
| 4.1.7 | llm | 5 | 4 | 1 faltante | 0.5h |
| 4.1.8 | portfolio | 5 | 3 | 2 faltantes | 1h |
| 4.1.9 | market_data | 4 | 1 | 3 faltantes | 1.5h |
| 4.1.10 | audit | 7 | 0 | 7 faltantes | 2h |
| 4.1.11 | feature_flags | 1 | 0 | 1 faltante | 0.5h |
Total 4.1: 16.5h
SUBTAREA 4.2: Mapeo Entities -> Services
| ID | Accion | Esfuerzo |
|---|---|---|
| 4.2.1 | Listar todos los servicios existentes | 2h |
| 4.2.2 | Mapear servicios a entities | 2h |
| 4.2.3 | Identificar entities sin servicio | 1h |
| 4.2.4 | Identificar servicios sin entity | 1h |
Total 4.2: 6h
SUBTAREA 4.3: Mapeo Services -> Controllers/Routes
| ID | Accion | Esfuerzo |
|---|---|---|
| 4.3.1 | Listar todos los controllers existentes | 1h |
| 4.3.2 | Mapear controllers a servicios | 1h |
| 4.3.3 | Identificar endpoints sin implementacion | 2h |
Total 4.3: 4h
SUBTAREA 4.4: Identificacion de Gaps Backend
| ID | Accion | Esfuerzo |
|---|---|---|
| 4.4.1 | Consolidar gaps DDL -> Entity | 2h |
| 4.4.2 | Consolidar gaps Entity -> Service | 2h |
| 4.4.3 | Consolidar gaps Service -> Controller | 1h |
| 4.4.4 | Generar BACKEND-GAPS-MATRIX.yml | 2h |
Total 4.4: 7h
SUBTAREA 4.5: Plan de Entities Faltantes
| ID | Accion | Esfuerzo |
|---|---|---|
| 4.5.1 | Priorizar entities por impacto funcional | 2h |
| 4.5.2 | Definir campos de cada entity faltante | 4h |
| 4.5.3 | Definir DTOs necesarios por entity | 3h |
| 4.5.4 | Definir servicios necesarios por entity | 3h |
Total 4.5: 12h
TOTAL FASE-4: 45.5h (~20h con paralelizacion)
FASE-5: Purga y Reorganizacion Documental
SUBTAREA 5.1: Purgar Documentacion Obsoleta
| ID | Accion | Archivos | Esfuerzo |
|---|---|---|---|
| 5.1.1 | Eliminar docs/_archive/04-fase-backlog/ | 1 archivo | 0.25h |
| 5.1.2 | Eliminar nota discrepancia puertos resuelta | 1 archivo | 0.25h |
| 5.1.3 | Mover coherence baseline a archive | 1 archivo | 0.25h |
| 5.1.4 | Verificar y completar archivado tareas 2026-01 | 20 tareas | 2h |
| 5.1.5 | Limpiar carpetas de fechas vacias | 2-3 carpetas | 0.5h |
Total 5.1: 3.25h
SUBTAREA 5.2: Integrar Definiciones Faltantes
| ID | Definicion | Modulo OQI | Tipo Doc | Esfuerzo |
|---|---|---|---|---|
| 5.2.1 | feature_flags schema | Transversal | ET + RF | 3h |
| 5.2.2 | drawing_tools/templates | OQI-003 | ET + US | 2h |
| 5.2.3 | price_alerts | OQI-003 | US + RF | 2h |
| 5.2.4 | refunds | OQI-005 | ET + US + RF | 2h |
| 5.2.5 | course_tags/instructors | OQI-002 | ET + US | 2h |
| 5.2.6 | agent_executions | OQI-004 | ET + US | 2h |
| 5.2.7 | prediction_overlays | OQI-006 | ET | 1h |
| 5.2.8 | portfolio_snapshots | OQI-008 | ET | 1h |
Total 5.2: 15h
SUBTAREA 5.3: Actualizar Inventarios
| ID | Inventario | Accion | Esfuerzo |
|---|---|---|---|
| 5.3.1 | DATABASE_INVENTORY.yml | Actualizar de 81 a 100 tablas, agregar feature_flags | 3h |
| 5.3.2 | BACKEND_INVENTORY.yml | Actualizar con gaps identificados en Fase 4 | 2h |
| 5.3.3 | MASTER_INVENTORY.yml | Sincronizar con cambios | 1h |
| 5.3.4 | DDL-COMPLETE-MATRIX.yml | Actualizar de 93 a 100 tablas | 2h |
| 5.3.5 | GAPS-TRACKING.yml | Actualizar con nuevos gaps | 2h |
Total 5.3: 10h
SUBTAREA 5.4: Actualizar Documentacion de Modulos
| ID | Modulo | Accion | Esfuerzo |
|---|---|---|---|
| 5.4.1 | OQI-002 | Agregar docs para 7 tablas nuevas education | 3h |
| 5.4.2 | OQI-003 | Agregar docs para drawing_tools, price_alerts | 2h |
| 5.4.3 | OQI-004 | Agregar docs para agent_executions | 1h |
| 5.4.4 | OQI-005 | Agregar docs para refunds, currency_exchange | 2h |
| 5.4.5 | OQI-006 | Agregar docs para prediction_overlays, llm_signals | 1.5h |
| 5.4.6 | OQI-008 | Agregar docs para portfolio_snapshots | 1h |
Total 5.4: 10.5h
TOTAL FASE-5: 38.75h (~15h con paralelizacion)
FASE-6: Plan Maestro de Remediacion
SUBTAREA 6.1: Priorizar Acciones por Impacto
| ID | Accion | Esfuerzo |
|---|---|---|
| 6.1.1 | Clasificar todos los gaps por P0/P1/P2/P3 | 2h |
| 6.1.2 | Calcular impacto funcional de cada gap | 2h |
| 6.1.3 | Generar matriz impacto vs esfuerzo | 1h |
Total 6.1: 5h
SUBTAREA 6.2: Definir Orden de Ejecucion
| ID | Accion | Esfuerzo |
|---|---|---|
| 6.2.1 | Mapear dependencias entre subtareas | 2h |
| 6.2.2 | Identificar camino critico | 1h |
| 6.2.3 | Identificar tareas paralelizables | 1h |
| 6.2.4 | Generar diagrama de dependencias | 2h |
Total 6.2: 6h
SUBTAREA 6.3: Estimar Esfuerzo
| ID | Accion | Esfuerzo |
|---|---|---|
| 6.3.1 | Estimar horas por subtarea | 2h |
| 6.3.2 | Agregar buffer (20%) | 0.5h |
| 6.3.3 | Calcular ruta critica temporal | 1h |
Total 6.3: 3.5h
SUBTAREA 6.4: Generar Roadmap Actualizado
| ID | Accion | Esfuerzo |
|---|---|---|
| 6.4.1 | Actualizar ROADMAP-2026-Q1.yml | 3h |
| 6.4.2 | Generar EXECUTION-PLAN-MODELADO.yml | 3h |
| 6.4.3 | Crear REMEDIATION-CHECKLIST.md | 2h |
Total 6.4: 8h
TOTAL FASE-6: 22.5h
4. RESUMEN DE ESFUERZO
| Fase | Descripcion | Horas Secuencial | Horas Paralelo (est.) |
|---|---|---|---|
| FASE-1 | Analisis y Planificacion | COMPLETADA | COMPLETADA |
| FASE-2 | Validacion Esquemas DDL | 30h | 12h |
| FASE-3 | Auditoria Integridad | 37h | 18h |
| FASE-4 | Coherencia DDL-Backend | 45.5h | 20h |
| FASE-5 | Purga y Reorganizacion | 38.75h | 15h |
| FASE-6 | Plan Maestro Remediacion | 22.5h | 22.5h |
| TOTAL | 173.75h | ~87.5h |
Prioridad de Ejecucion
INMEDIATO (Hoy):
└── 2.1.1: Corregir FK price_alerts (P0 BLOQUEANTE)
URGENTE (Esta semana):
├── 2.2.1-2.2.11: Documentar tablas faltantes (paralelo)
├── 2.3.1-2.3.3: Resolver conflictos enums
└── 5.3.1: Actualizar DATABASE_INVENTORY.yml
IMPORTANTE (Proxima semana):
├── 3.1.1-3.1.7: Validar FKs
├── 4.1.1-4.1.11: Mapeo tablas -> entities
└── 5.1.1-5.1.5: Purgar docs obsoletas
PLANIFICADO (Semana 3-4):
├── 3.2-3.5: Indices, constraints, funciones
├── 4.2-4.5: Mapeo completo backend
├── 5.2-5.4: Integrar definiciones faltantes
└── 6.1-6.4: Plan maestro remediacion
5. METRICAS DE EXITO
| Metrica | Baseline | Target Post-Analisis |
|---|---|---|
| Coherencia DDL-Inventario | 78% (78/100) | 100% (100/100) |
| FK Errors | 1 | 0 |
| Conflictos Enum | 3 | 0 |
| Tablas sin documentar | 19 | 0 |
| Schemas sin documentar | 1 (feature_flags) | 0 |
| Relaciones debiles | 4 | 0 (documentadas o resueltas) |
| Duplicaciones funcionales | 1 (symbols/tickers) | 0 (plan de consolidacion) |
| Docs obsoletas | ~25 archivos | 0 |
| Definiciones faltantes | 8 | 0 |
6. DEPENDENCIAS ENTRE FASES
FASE-2 ──┐
├──> FASE-3 (necesita schemas validados)
│
├──> FASE-4 (necesita inventario actualizado)
│
└──> FASE-5 (necesita gaps identificados)
│
└──> FASE-6 (necesita docs limpias y gaps consolidados)
Nota: FASE-2, FASE-4, y FASE-5 pueden ejecutarse parcialmente en paralelo.
7. ORQUESTACION DE SUBAGENTES
Subagentes Recomendados para Paralelizacion
| Subagente | Rol | Fases | Tareas Asignables |
|---|---|---|---|
| SA-DDL-1 | Validador DDL Auth+Trading | F2, F3 | 2.2.1, 2.2.2, 3.1.1, 3.1.2 |
| SA-DDL-2 | Validador DDL Education+Financial | F2, F3 | 2.2.3, 2.2.4, 3.1.3, 3.1.4 |
| SA-DDL-3 | Validador DDL Investment+ML+Rest | F2, F3 | 2.2.5-2.2.11, 3.1.5, 3.1.6 |
| SA-BACKEND-1 | Mapper Backend Auth+Trading | F4 | 4.1.1, 4.1.2, 4.2.1 |
| SA-BACKEND-2 | Mapper Backend Education+Financial | F4 | 4.1.3, 4.1.4, 4.2.2 |
| SA-DOCS-1 | Documentador/Purga | F5 | 5.1.X, 5.2.X, 5.3.X |
Secuencia de Orquestacion
Turno 1 (Paralelo): SA-DDL-1, SA-DDL-2, SA-DDL-3
→ Resultado: Schemas validados, inventario actualizado
Turno 2 (Paralelo): SA-BACKEND-1, SA-BACKEND-2, SA-DOCS-1
→ Resultado: Mapeo backend, docs purgadas
Turno 3 (Secuencial): Orquestador consolida
→ Resultado: FASE-6 plan maestro
Generado por: Claude Code (Opus 4.6) - Especialista en Modelado de Datos Sistema: SIMCO v4.0.0 | Metodologia: CAPVED Fecha: 2026-02-05