# ═══════════════════════════════════════════════════════════════════
# PLAN-MAESTRO-REMEDIACION.yml
# Trading Platform - Plan de Remediacion del Modelado de Base de Datos
# ═══════════════════════════════════════════════════════════════════

version: "1.0.0"
fecha: "2026-02-05"
tarea: "TASK-2026-02-05-ANALISIS-VALIDACION-MODELADO-BD"
fase: "FASE-6: Plan Maestro de Remediacion"
agente: "Claude Code (Opus 4.6)"

# ─────────────────────────────────────────────────────────────────
# RESUMEN EJECUTIVO
# ─────────────────────────────────────────────────────────────────

resumen_ejecutivo:
  descripcion: |
    Plan de remediacion basado en analisis integral de 101 tablas DDL, 11 schemas,
    y coherencia multicapa (DDL-Backend-Frontend). Priorizado por impacto funcional
    y dependencias tecnicas. Organizado en 4 sprints ejecutables.

  estado_actual:
    tablas_ddl: 101
    schemas: 11
    coherencia_ddl_inventario: "100%"  # RESUELTO en esta tarea
    coherencia_ddl_backend_entities: "68%"
    coherencia_ddl_backend_services: "52%"
    coherencia_ddl_backend_controllers: "45%"
    coherencia_global: "54%"
    gaps_totales: 37
    gaps_resueltos: 3
    gaps_pendientes: 34
    fk_errors: 0  # RESUELTO en esta tarea
    enum_conflicts: 3
    entities_faltantes: 31

  target:
    coherencia_ddl_backend_entities: "95%"
    coherencia_ddl_backend_services: "85%"
    coherencia_global: "90%"
    gaps_pendientes: 0
    enum_conflicts: 0
    entities_faltantes: 0

# ─────────────────────────────────────────────────────────────────
# MATRIZ IMPACTO vs ESFUERZO
# ─────────────────────────────────────────────────────────────────

matriz_impacto_esfuerzo:

  # CUADRANTE 1: Alto Impacto + Bajo Esfuerzo → HACER PRIMERO
  quick_wins:
    - gap: "GAP-ENUM-P1-003"
      accion: "Migrar 3 tablas a public.trading_timeframe"
      impacto: "Elimina conflicto timeframe"
      esfuerzo: "2h"
      riesgo: "Bajo (non-breaking, valores compatibles)"

    - gap: "GAP-REL-P1-002"
      accion: "Agregar wallet_id FK en trading.bots"
      impacto: "Vincula bots con wallets"
      esfuerzo: "1h"
      riesgo: "Bajo"

    - gap: "GAP-REL-P1-003"
      accion: "Agregar symbol_id FK en market_data.tickers"
      impacto: "Vincula catalogos"
      esfuerzo: "1h"
      riesgo: "Bajo"

    - gap: "GAP-NAME-P2-001"
      accion: "Estandarizar asset_type -> asset_class"
      impacto: "Consistencia nomenclatura"
      esfuerzo: "1h"
      riesgo: "Bajo"

    - gap: "GAP-PURGE-P2-001"
      accion: "Purgar docs obsoletas"
      impacto: "Limpieza documental"
      esfuerzo: "1h"
      riesgo: "Bajo"

  # CUADRANTE 2: Alto Impacto + Alto Esfuerzo → PLANIFICAR
  strategic:
    - gap: "GAP-BE-P2-001"
      accion: "Crear 31 entities backend"
      impacto: "68% -> 95% entity coverage"
      esfuerzo: "62h"
      riesgo: "Medio (volumen alto)"

    - gap: "GAP-SVC-P2-001"
      accion: "Crear audit services (7 tablas)"
      impacto: "0% -> 100% audit coherencia"
      esfuerzo: "32h"
      riesgo: "Medio"

    - gap: "GAP-DUP-P1-001"
      accion: "Consolidar symbols/tickers"
      impacto: "Elimina duplicacion catalogo master"
      esfuerzo: "12h"
      riesgo: "Alto (afecta ml, market_data, data-service)"

  # CUADRANTE 3: Bajo Impacto + Bajo Esfuerzo → OPORTUNISTA
  oportunista:
    - gap: "GAP-ENUM-P1-002"
      accion: "Crear public.risk_profile"
      esfuerzo: "2h"
      nota: "Opcional, valores ya identicos"

    - gap: "GAP-IDX-P3-001"
      accion: "Agregar indices compuestos"
      esfuerzo: "2h"

    - gap: "GAP-ORPHAN-P3-001"
      accion: "Documentar market_data.staging"
      esfuerzo: "0.5h"

  # CUADRANTE 4: Bajo Impacto + Alto Esfuerzo → DIFERIR
  diferir:
    - gap: "GAP-SVC-P2-002"
      accion: "OHLCV service completo"
      esfuerzo: "16h"
      nota: "Solo relevante cuando market_data pipeline este activo"

    - gap: "GAP-SVC-P2-003"
      accion: "Currency exchange service"
      esfuerzo: "16h"
      nota: "Solo relevante cuando se habilite multi-moneda"

# ─────────────────────────────────────────────────────────────────
# SPRINTS DE REMEDIACION
# ─────────────────────────────────────────────────────────────────

sprints:

  # ═══════════════════════════════════════════════════════════════
  # SPRINT 1: Quick Wins DDL + Enum Resolution (5 dias)
  # ═══════════════════════════════════════════════════════════════
  sprint_1:
    nombre: "Quick Wins DDL + Enum Resolution"
    duracion: "5 dias"
    esfuerzo_total: "24h"
    prioridad: CRITICA
    prerequisitos: []

    objetivo: |
      Resolver todos los conflictos DDL, enums, y FKs faltantes.
      Ejecutar purga documental catalogada.

    tareas:
      - id: "S1-T1"
        nombre: "Ejecutar migracion timeframe enum"
        gap_ref: "GAP-ENUM-P1-003"
        tipo: DDL
        esfuerzo: "2h"
        dependencias: []
        sql: |
          -- 3 tablas: trading.bots, trading.signals, trading.drawing_tools
          -- Usar patron ADD COLUMN new -> UPDATE -> DROP old -> RENAME new
        validacion: "Recrear BD en WSL, verificar tablas se crean correctamente"

      - id: "S1-T2"
        nombre: "Agregar FK trading.bots -> financial.wallets"
        gap_ref: "GAP-REL-P1-002"
        tipo: DDL
        esfuerzo: "1h"
        dependencias: []
        sql: "ALTER TABLE trading.bots ADD COLUMN wallet_id UUID REFERENCES financial.wallets(id);"
        validacion: "Verificar FK se crea, no rompe datos existentes"

      - id: "S1-T3"
        nombre: "Agregar FK market_data.tickers -> trading.symbols"
        gap_ref: "GAP-REL-P1-003"
        tipo: DDL
        esfuerzo: "1h"
        dependencias: []
        sql: "ALTER TABLE market_data.tickers ADD COLUMN symbol_id UUID REFERENCES trading.symbols(id);"
        validacion: "Verificar FK se crea"

      - id: "S1-T4"
        nombre: "Agregar FK investment.accounts -> financial.wallets"
        gap_ref: "GAP-REL-P1-001"
        tipo: DDL
        esfuerzo: "2h"
        dependencias: []
        sql: |
          -- Verificar si wallet_id ya existe en DDL actual
          -- Si no: ALTER TABLE investment.accounts ADD COLUMN wallet_id UUID REFERENCES financial.wallets(id);
        validacion: "Verificar FK funciona, evaluar ON DELETE behavior"

      - id: "S1-T5"
        nombre: "Documentar decision transaction_type"
        gap_ref: "GAP-ENUM-P1-001"
        tipo: DOCUMENTACION
        esfuerzo: "2h"
        dependencias: []
        accion: |
          Crear ADR documentando la decision de MANTENER transaction_type separados:
          - financial.transaction_type (9 valores, wallets)
          - investment.transaction_type (3 valores, cuentas inversion)
          Razon: valores diferentes, renombrar es breaking change.
          Enforcement: calificacion de schema estricta en backend.

      - id: "S1-T6"
        nombre: "Estandarizar asset_type -> asset_class"
        gap_ref: "GAP-NAME-P2-001"
        tipo: DDL
        esfuerzo: "1h"
        dependencias: []

      - id: "S1-T7"
        nombre: "Documentar feature_flags schema"
        gap_ref: "GAP-DDL-P0-002"
        tipo: DOCUMENTACION
        esfuerzo: "3h"
        dependencias: []
        accion: |
          1. Crear ET (Especificacion Tecnica) en docs/02-definicion-modulos/
          2. Agregar a CLAUDE.md del proyecto (seccion schemas)
          3. Documentar 3 tablas: flags, user_flags, evaluations
          4. Documentar 2 enums: flag_status, rollout_stage
          5. Documentar funcion evaluate_flag()

      - id: "S1-T8"
        nombre: "Ejecutar purga documental"
        gap_ref: "GAP-PURGE-P2-001, GAP-PURGE-P2-002"
        tipo: OPERACIONES
        esfuerzo: "3h"
        dependencias: []
        accion: |
          Segun PURGA-DOCUMENTAL.yml:
          1. Eliminar directorio vacio 2026-01-28/
          2. Archivar 4 carpetas de tareas (2026-01-25/, 2026-01-27/MASTER-ANALYSIS, 2026-02-03/DDL-VALIDATION)
          3. Archivar 2 coherence baselines (2026-01-28)
          4. Actualizar _INDEX.yml

      - id: "S1-T9"
        nombre: "Documentar tablas faltantes en inventarios"
        gap_ref: "GAP-INV-P1-001 a P1-005"
        tipo: DOCUMENTACION
        esfuerzo: "6h"
        dependencias: []
        accion: |
          Las 19 tablas ya estan en DATABASE_INVENTORY v2.0.0.
          Crear definiciones (ET) para cada grupo:
          - education: 7 tablas → ET en OQI-002
          - trading: 2 tablas → ET en OQI-003
          - financial: 2 tablas → ET en OQI-005
          - ml: 2 tablas → ET en OQI-006
          - auth/inv/llm/port/mkt: 6 tablas → ETs en modulos respectivos

      - id: "S1-T10"
        nombre: "Recrear BD en WSL para validar cambios DDL"
        tipo: VALIDACION
        esfuerzo: "1h"
        dependencias: ["S1-T1", "S1-T2", "S1-T3", "S1-T4", "S1-T6"]
        validacion: "wsl unified-recreate-db.sh trading-platform --drop"

    criterio_exito:
      - "0 conflictos de enum activos"
      - "3 FKs cross-schema agregadas"
      - "feature_flags documentado"
      - "BD recrea sin errores"
      - "Purga documental ejecutada"

    metricas_esperadas:
      gaps_resueltos: "+12 (total: 15/37)"
      coherencia_ddl_inventario: "100% (mantenida)"
      enum_conflicts: "3 -> 0"
      fk_faltantes: "3 -> 0"

  # ═══════════════════════════════════════════════════════════════
  # SPRINT 2: Backend Entities Core (10 dias)
  # ═══════════════════════════════════════════════════════════════
  sprint_2:
    nombre: "Backend Entities - Core Schemas"
    duracion: "10 dias"
    esfuerzo_total: "62h"
    prioridad: ALTA
    prerequisitos: ["sprint_1"]

    objetivo: |
      Crear las 31 entities backend faltantes para alcanzar 95%+ entity coverage.
      Priorizar schemas criticos primero (audit, trading, education).

    tareas:
      - id: "S2-T1"
        nombre: "Crear 7 entities audit"
        gap_ref: "GAP-BE-P2-001 (audit)"
        schema: audit
        entities:
          - "AuditLog -> audit.audit_logs"
          - "SecurityEvent -> audit.security_events"
          - "SystemEvent -> audit.system_events"
          - "TradingAudit -> audit.trading_audit"
          - "ApiRequestLog -> audit.api_request_logs"
          - "DataAccessLog -> audit.data_access_logs"
          - "ComplianceLog -> audit.compliance_logs"
        esfuerzo: "14h (2h/entity)"
        dependencias: []
        paralelizable: true

      - id: "S2-T2"
        nombre: "Crear 5 entities education"
        gap_ref: "GAP-BE-P2-001 (education)"
        schema: education
        entities:
          - "UserActivityLog -> education.user_activity_log"
          - "ReviewHelpfulVote -> education.review_helpful_votes"
          - "CourseTag -> education.course_tags"
          - "CourseTagAssignment -> education.course_tag_assignments"
          - "Video -> education.videos"
        esfuerzo: "10h"
        dependencias: []
        paralelizable: true

      - id: "S2-T3"
        nombre: "Crear 3 entities trading"
        gap_ref: "GAP-BE-P2-001 (trading)"
        schema: trading
        entities:
          - "PriceAlert -> trading.price_alerts"
          - "DrawingTool -> trading.drawing_tools"
          - "DrawingTemplate -> trading.drawing_templates"
        esfuerzo: "6h"
        dependencias: []
        paralelizable: true

      - id: "S2-T4"
        nombre: "Crear 3 entities financial"
        gap_ref: "GAP-BE-P2-001 (financial)"
        schema: financial
        entities:
          - "WalletLimit -> financial.wallet_limits"
          - "CurrencyExchangeRate -> financial.currency_exchange_rates"
          - "Refund -> financial.refunds"
        esfuerzo: "6h"
        dependencias: []
        paralelizable: true

      - id: "S2-T5"
        nombre: "Crear 3 entities investment"
        gap_ref: "GAP-BE-P2-001 (investment)"
        schema: investment
        entities:
          - "DistributionHistory -> investment.distribution_history"
          - "DistributionRun -> investment.distribution_runs"
          - "AgentExecution -> investment.agent_executions"
        esfuerzo: "6h"
        dependencias: []
        paralelizable: true

      - id: "S2-T6"
        nombre: "Crear entities menores (ml, portfolio, market_data, auth, feature_flags)"
        gap_ref: "GAP-BE-P2-001 (resto)"
        entities:
          ml:
            - "LlmSignal -> ml.llm_signals"
            - "PredictionOverlay -> ml.prediction_overlays"
          portfolio:
            - "RebalanceHistory -> portfolio.rebalance_history"
            - "PortfolioSnapshot -> portfolio.portfolio_snapshots"
          market_data:
            - "Ohlcv5m -> market_data.ohlcv_5m"
            - "Ohlcv15m -> market_data.ohlcv_15m"
            - "Staging -> market_data.staging"
          auth:
            - "RateLimitingConfig -> auth.rate_limiting_config"
            - "UserPushToken -> auth.user_push_tokens"
          feature_flags:
            - "Flag -> feature_flags.flags"
        esfuerzo: "20h"
        dependencias: []
        paralelizable: true

    estrategia_ejecucion: |
      Las 6 tareas son 100% paralelizables (sin dependencias entre schemas).
      Con 3 agentes ejecutando en paralelo, el sprint se reduce de 62h a ~21h.

      Cada entity debe incluir:
      1. Archivo entity con decoradores TypeORM (@Entity, @Column, @ManyToOne, etc.)
      2. Columnas exactas del DDL (tipo, nullable, default)
      3. Relaciones basadas en FKs del DDL
      4. Schema property apuntando al schema correcto

    criterio_exito:
      - "31 entities creadas con build exitoso"
      - "Entity coverage: 68% -> 99% (99/101, excluyendo user_flags y evaluations de multi-CREATE)"
      - "npm run build exitoso"
      - "Inventarios actualizados"

    metricas_esperadas:
      entities_faltantes: "31 -> 0"
      coherencia_entities: "68% -> 99%"
      gaps_resueltos: "+1 (GAP-BE-P2-001)"

  # ═══════════════════════════════════════════════════════════════
  # SPRINT 3: Backend Services Critical (10 dias)
  # ═══════════════════════════════════════════════════════════════
  sprint_3:
    nombre: "Backend Services - Critical Coverage"
    duracion: "10 dias"
    esfuerzo_total: "68h"
    prioridad: ALTA
    prerequisitos: ["sprint_2"]

    objetivo: |
      Crear servicios backend criticos: audit (7 tablas), feature_flags,
      completar bots service, risk assessment service.

    tareas:
      - id: "S3-T1"
        nombre: "Crear AuditService + SecurityEventService + ComplianceService"
        gap_ref: "GAP-SVC-P2-001"
        schema: audit
        esfuerzo: "32h"
        dependencias: ["S2-T1"]
        entregables:
          - "AuditService (audit_logs, data_access_logs)"
          - "SecurityEventService (security_events)"
          - "TradingAuditService (trading_audit)"
          - "ComplianceService (compliance_logs)"
          - "AuditController con endpoints admin-only"
        endpoints:
          - "GET /api/admin/audit/logs"
          - "GET /api/admin/audit/security"
          - "GET /api/admin/audit/trading"
          - "GET /api/admin/audit/compliance"
          - "GET /api/admin/audit/export"

      - id: "S3-T2"
        nombre: "Crear FeatureFlagService"
        gap_ref: "GAP-SVC-P2-006"
        schema: feature_flags
        esfuerzo: "8h"
        dependencias: ["S2-T6"]
        entregables:
          - "FeatureFlagService con cache Redis"
          - "FeatureFlagMiddleware para route gating"
          - "FeatureFlagController"
        endpoints:
          - "GET /api/admin/flags"
          - "PUT /api/admin/flags/:name"
          - "GET /api/flags/evaluate/:name"

      - id: "S3-T3"
        nombre: "Completar BotsService (60% -> 100%)"
        gap_ref: "GAP-SVC-P2-004"
        schema: trading
        esfuerzo: "16h"
        dependencias: ["S2-T3"]
        faltante:
          - "CRUD completo (create, update, delete)"
          - "WebSocket monitoring real-time"
          - "Integracion con wallet via FK"
          - "Historial de ejecuciones"

      - id: "S3-T4"
        nombre: "Crear RiskAssessmentService"
        gap_ref: "GAP-SVC-P2-005"
        schema: investment
        esfuerzo: "12h"
        dependencias: ["S2-T5"]
        entregables:
          - "RiskAssessmentService"
          - "RiskAssessmentController"
        endpoints:
          - "GET /api/risk/questionnaire"
          - "POST /api/risk/assessment"
          - "PUT /api/users/:id/risk-profile"

    criterio_exito:
      - "Audit schema 100% serviced"
      - "Feature flags operativo con cache"
      - "Bots service 100% completo"
      - "Risk assessment calculando score"
      - "npm run build exitoso"

    metricas_esperadas:
      coherencia_services: "52% -> 72%"
      gaps_resueltos: "+4 (GAP-SVC-P2-001, P2-004, P2-005, P2-006)"

  # ═══════════════════════════════════════════════════════════════
  # SPRINT 4: Consolidation + Symbols Migration (10 dias)
  # ═══════════════════════════════════════════════════════════════
  sprint_4:
    nombre: "Consolidation + Symbol Catalog Migration"
    duracion: "10 dias"
    esfuerzo_total: "50h"
    prioridad: MEDIA
    prerequisitos: ["sprint_3"]

    objetivo: |
      Consolidar catalogos de simbolos, crear servicios market_data y currency,
      completar definiciones documentales, actualizar roadmap.

    tareas:
      - id: "S4-T1"
        nombre: "Consolidar trading.symbols vs market_data.tickers"
        gap_ref: "GAP-DUP-P1-001"
        tipo: DDL + BACKEND
        esfuerzo: "12h"
        dependencias: []
        pasos:
          - "1. Agregar campos ML a trading.symbols (is_ml_enabled, polygon_ticker, supported_timeframes)"
          - "2. Crear migracion para mover datos de tickers a symbols"
          - "3. Actualizar market_data.tickers a vista o tabla dependiente"
          - "4. Actualizar todas las referencias en ml schema y data-service"
          - "5. Recrear BD y verificar"
        riesgo: "Alto - afecta Python data-service, ml schema queries"

      - id: "S4-T2"
        nombre: "Crear Market Data OHLCV Service"
        gap_ref: "GAP-SVC-P2-002"
        esfuerzo: "16h"
        dependencias: ["S2-T6", "S4-T1"]

      - id: "S4-T3"
        nombre: "Crear Currency Exchange Service"
        gap_ref: "GAP-SVC-P2-003"
        esfuerzo: "8h"
        dependencias: ["S2-T4"]
        nota: "Reducido a 8h si solo se implementa lectura de rates sin API externa"

      - id: "S4-T4"
        nombre: "Completar definiciones documentales"
        gap_ref: "GAP-DOC-P2-001"
        esfuerzo: "10h"
        dependencias: []

      - id: "S4-T5"
        nombre: "Resolver gaps P3 (oportunista)"
        gap_ref: "GAP-IDX-P3-001, GAP-DEL-P3-001, GAP-ORPHAN-P3-001/002, GAP-ARCH-P3-001"
        esfuerzo: "4h"
        dependencias: []

    criterio_exito:
      - "1 catalogo de simbolos unificado"
      - "Market data y currency services operativos"
      - "Todas las definiciones documentales creadas"
      - "0 gaps P3 pendientes"

    metricas_esperadas:
      coherencia_services: "72% -> 85%"
      gaps_pendientes: "0"
      coherencia_global: "54% -> 90%"

# ─────────────────────────────────────────────────────────────────
# GRAFO DE DEPENDENCIAS
# ─────────────────────────────────────────────────────────────────

dependencias:
  sprint_level:
    - "Sprint 1 -> Sprint 2 (entities necesitan DDL correcto)"
    - "Sprint 2 -> Sprint 3 (services necesitan entities)"
    - "Sprint 3 -> Sprint 4 (consolidation necesita services base)"

  task_level_criticas:
    - "S1-T1 (enum migration) -> S1-T10 (BD validation)"
    - "S1-T2..T4 (FKs) -> S1-T10 (BD validation)"
    - "S2-T1 (audit entities) -> S3-T1 (audit services)"
    - "S2-T6 (feature_flags entity) -> S3-T2 (feature_flags service)"
    - "S2-T3 (trading entities) -> S3-T3 (bots service)"
    - "S2-T5 (investment entities) -> S3-T4 (risk service)"
    - "S4-T1 (symbols consolidation) -> S4-T2 (market data service)"

  parallelism:
    sprint_1: "T1..T9 son independientes, T10 espera T1..T6"
    sprint_2: "T1..T6 son 100% paralelizables (diferentes schemas)"
    sprint_3: "T1..T4 son paralelizables (diferentes schemas)"
    sprint_4: "T1 secuencial, T2..T5 parcialmente paralelizables"

# ─────────────────────────────────────────────────────────────────
# ESTIMACION TOTAL
# ─────────────────────────────────────────────────────────────────

estimacion:
  esfuerzo_secuencial:
    sprint_1: "24h"
    sprint_2: "62h"
    sprint_3: "68h"
    sprint_4: "50h"
    total: "204h"

  esfuerzo_paralelo_estimado:
    sprint_1: "12h (2 agentes)"
    sprint_2: "21h (3 agentes)"
    sprint_3: "32h (2 agentes)"
    sprint_4: "28h (2 agentes)"
    total: "~93h"

  duracion_calendario:
    con_1_agente: "~35 dias (7 semanas)"
    con_2_agentes: "~20 dias (4 semanas)"
    con_3_agentes: "~15 dias (3 semanas)"

  distribucion_por_tipo:
    ddl_modifications: "10h (5%)"
    entity_creation: "62h (30%)"
    service_creation: "68h (33%)"
    documentation: "28h (14%)"
    consolidation: "20h (10%)"
    validation_testing: "16h (8%)"

# ─────────────────────────────────────────────────────────────────
# RIESGOS Y MITIGACION
# ─────────────────────────────────────────────────────────────────

riesgos:
  - id: "R1"
    riesgo: "Symbols consolidation causa regresion en Python data-service"
    probabilidad: MEDIA
    impacto: ALTO
    mitigacion: "Ejecutar en Sprint 4 cuando servicios base esten estables. Crear script de migracion reversible."

  - id: "R2"
    riesgo: "31 entities no compilan por dependencias circulares"
    probabilidad: BAJA
    impacto: MEDIO
    mitigacion: "Crear entities por schema aislado, lazy-load relations cross-schema"

  - id: "R3"
    riesgo: "Audit services muy grandes (32h) retrasan Sprint 3"
    probabilidad: MEDIA
    impacto: MEDIO
    mitigacion: "Implementar read-only primero (queries), write operations en fase posterior"

  - id: "R4"
    riesgo: "Enum migration rompe datos existentes"
    probabilidad: BAJA
    impacto: ALTO
    mitigacion: "Solo timeframe es safe (valores compatibles). transaction_type se documenta, no se migra."

# ─────────────────────────────────────────────────────────────────
# INTEGRACION CON ROADMAP EXISTENTE
# ─────────────────────────────────────────────────────────────────

integracion_roadmap:
  roadmap_actual: "ROADMAP-2026-Q1.yml v1.0.0 (2026-01-27)"

  cambios_requeridos:
    - seccion: "M1 (Gaps P0)"
      cambio: |
        Agregar: Sprint 1 de remediacion modelado (enum migrations, FKs, feature_flags doc).
        GAP-DDL-P0-001 ya resuelto (FK price_alerts corregida).
        Metricas baseline actualizadas: 37 gaps (no 12), 101 tablas (no 89).

    - seccion: "M2 (Gaps P1)"
      cambio: |
        Integrar: Sprint 2 entities + Sprint 3 services.
        Nuevos gaps P1 identificados: 14 (vs 4 original).
        Target DDL-Backend coherence revisado: 54% actual (no 85%).

    - seccion: "Metricas baseline"
      cambio: |
        Actualizar todas las metricas baseline con datos verificados:
        - Tablas: 101 (no 89)
        - Gaps: 37 (no 12), de los cuales 3 resueltos
        - Coherencia global: 54% (no 81.25% - recalculada con precision)
        - Entity coverage: 68% (no ~85%)
        - Service coverage: 52%
        - Controller coverage: 45%

    - seccion: "Nuevos milestones"
      cambio: |
        Insertar M0.5: "Modelado BD Corregido" entre M0 y M1.
        Sprint 1+2 de remediacion como prerequisito para M1 (P0 funcionales).

  nota: |
    El ROADMAP-2026-Q1.yml necesita actualizacion significativa.
    Las metricas originales estaban infladas (coherencia 81.25% vs 54% real).
    Se recomienda crear ROADMAP-2026-Q1 v2.0.0 incorporando estos hallazgos.

# ─────────────────────────────────────────────────────────────────
# CHECKLIST DE REMEDIACION
# ─────────────────────────────────────────────────────────────────

checklist:
  pre_sprint_1:
    - "[ ] Verificar acceso a WSL para recrear BD"
    - "[ ] Verificar backup de datos actuales"
    - "[ ] Confirmar que PURGA-DOCUMENTAL.yml esta aprobado"

  post_sprint_1:
    - "[ ] BD recrea sin errores"
    - "[ ] 0 conflictos enum"
    - "[ ] 3 nuevas FKs validadas"
    - "[ ] feature_flags documentado"
    - "[ ] Purga ejecutada"
    - "[ ] Inventarios sincronizados"

  post_sprint_2:
    - "[ ] 31 entities compilan (npm run build)"
    - "[ ] Entity coverage >= 95%"
    - "[ ] BACKEND_INVENTORY actualizado"
    - "[ ] DDL-BACKEND-COHERENCE actualizado"

  post_sprint_3:
    - "[ ] Audit endpoints operativos"
    - "[ ] Feature flags con cache Redis"
    - "[ ] Bots service 100%"
    - "[ ] Risk assessment operativo"
    - "[ ] Service coverage >= 72%"

  post_sprint_4:
    - "[ ] 1 catalogo simbolos unificado"
    - "[ ] 0 gaps pendientes"
    - "[ ] Coherencia global >= 90%"
    - "[ ] COHERENCE-MASTER-REPORT v2.0 generado"
    - "[ ] ROADMAP-2026-Q1 v2.0 actualizado"

# ═══════════════════════════════════════════════════════════════════
# FIN DE PLAN-MAESTRO-REMEDIACION.yml
# ═══════════════════════════════════════════════════════════════════