Skip to content

docs(riesgos): guia para crear, modificar y auditar widgets del area Riesgos en el dashboard OAE

Alan Amox requested to merge riesgos into qa

Agrega frontend/components/dashboard/CLAUDE-riesgos.md como referencia paralela al CLAUDE.md de Comercial. Cubre:

  • contexto del area (endpoint dashboard-summary, tablas seguros_fianzas, polizas_danos, fianzas, gating por sub-area riesgos)
  • diferencia con el dashboard monolitico paralelo /finanzas/riesgos
  • anatomia de un widget: registry, mapeo, render, wrapper
  • inventario de los 12 widgets actuales con sus widget IDs y campos del response que consumen
  • contrato completo del endpoint dashboard-summary: query params aceptados y shape del response
  • reglas de negocio acordadas: mes cerrado dia 11, overlap de vigencia, dedup por numero, categorizacion de recibos en RecibosTimeline, que filtros aplican a polizas vs fianzas
  • receta para crear un widget nuevo en 7 pasos
  • patrones visuales: KPI cards multilinea, colores estandar por concepto, donut homologado, bar Top 10, line con tooltip enriquecido
  • modales de Detalle: inventario, patron estandar con filtros locales, drill-down 3 niveles, sub-modales reusables (PolizaDetalleModal con onRowClick, RecibosDetalleModal con columna Dias pago, FianzaDetalleModal)
  • receta para agregar modal a un widget
  • optimizaciones de performance aplicadas en 2026-05: lazy-mount de sub-modales, lazy-fetch del raw con useRef + promise compartida, blur reducido de 10px a 4px
  • gotchas criticos: orden de hooks vs return condicional, regla del dia 11, kpis _vigentes vs originales, URLs concatenadas en campo fianza, status case-insensitive con includes, snake_case vs kebab-case en registry vs renderer
  • referencias rapidas a todos los paths relevantes (frontend, sub-modales, backend, lib/dateRules)

Co-Authored-By: Claude Opus 4.7 (1M context) noreply@anthropic.com

Merge request reports

Loading