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>
780 lines
31 KiB
Markdown
780 lines
31 KiB
Markdown
# 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:
|
|
1. **DDL real** (100 tablas) vs **inventario documentado** (81 tablas) = 19 tablas sin documentar
|
|
2. **Conflictos de enums** duplicados entre schemas (3 conflictos activos)
|
|
3. **1 error critico** de FK en price_alerts (referencia incorrecta)
|
|
4. **Acoplamiento debil** entre schemas criticos (wallets <-> investment, bots <-> wallets)
|
|
5. **Duplicacion funcional** en catalogo de simbolos (trading.symbols vs market_data.tickers)
|
|
6. **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 ser `auth.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*
|