ADR 015: Reportes y exports¶

Estado¶

Aceptado — 2026-06

Contexto¶

Los plugins de negocio deben poder exponer reportes con parámetros y exportación. Cortex tenía JSON manual panel-reports.

Decisión¶

1. ReportBuilder + hook register_reports(registry).
2. Pantalla {panel}/reports compuesta por widgets report.
3. Contrato: dataPath (ejecución), exportPath opcional (CSV/XLSX vía API plugin).
4. Widget frontend ReportWidget: ejecutar + exportar + tabla resultado.

Leyenda: Flujo reportes declarativos desde builder hasta export. Actores: plugin, ReportRegistry, ReportWidget. Estado: Implementado.

flowchart TB
  subgraph plugin [Plugin]
    RB[ReportBuilder]
    RR[register_reports]
  end
  subgraph framework [Framework]
    Reg[ReportRegistry]
    Dash["pantalla panel/reports"]
  end
  subgraph panel [Panel React]
    RW[ReportWidget]
    Exec[dataPath ejecutar]
    Exp[exportPath CSV XLSX]
  end
  RB --> RR --> Reg --> Dash --> RW
  RW --> Exec
  RW --> Exp

Consecuencias¶

• Plugins de dominio migran reportes declarativos al hook register_reports.
• Export real depende de cada plugin REST.