mdominguez/ars-report-kit
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ars-report-kit/README.md
Mario Daniel Dominguez Sosa a2bd6cb697 ars-report-kit: kit portátil de branding para reportes/cotizaciones 
Extraído de autosanta-stack (agente de santa) para reusarlo en cualquier
proyecto: plantilla base + 2 ejemplos + logo + Paged.js, sin dependencias de
servidor. Ver AGENT_GUIDE.md.
2026-07-23 16:06:53 +00:00

2.3 KiB
Raw Permalink Blame History

ARS Report Kit

Kit portátil y autocontenido para que cualquier agente genere reportes, incidentes y cotizaciones con la identidad visual de ARS Integradores y los exporte a PDF carta con encabezado y pie en cada página. No requiere Flask, NetBox ni ningún servidor: sólo un navegador (Chrome) para el PDF.

Contenido

Archivo Descripción
AGENT_GUIDE.md El prompt / instrucciones para el agente. Empieza aquí.
ars_report_base.html Plantilla maestra a copiar y rellenar.
example_reporte.html Ejemplo completo: reporte técnico.
example_cotizacion.html Ejemplo completo: cotización con totales.
logo-report.jpg Logo ARS (referenciado localmente).
paged.polyfill.js Motor de paginación Paged.js (local, sin CDN).

Regla: todo .html generado debe quedar en la MISMA carpeta que logo-report.jpg y paged.polyfill.js.

Uso rápido

  1. El agente lee AGENT_GUIDE.md.
  2. Copia ars_report_base.html → <FOLIO>.html y rellena las zonas <!-- EDIT -->.
  3. Abre en Chrome → botón "Exportar PDF" → Guardar como PDF (Carta, con gráficos de fondo).

Distribución vía control plane (recomendado)

En lugar de que cada agente lleve su propio reporteador, publica este kit como un recurso único en el control plane y que los agentes lo soliciten:

  • Como skill/paquete compartido: expón la carpeta ars-report-kit/ completa. Los agentes descargan los 6 archivos a un directorio de trabajo y operan localmente.
  • Contrato mínimo que un agente necesita del control plane:
    1. AGENT_GUIDE.md (las reglas y componentes).
    2. ars_report_base.html (la plantilla).
    3. logo-report.jpg + paged.polyfill.js (assets binarios).
  • Versionado: trata el kit como una unidad versionada (p. ej. ars-report-kit@1.0). Si cambian marca o componentes, subes una versión; los agentes siempre piden la última.

De esta forma la marca y la paginación viven en un solo lugar y se corrigen una vez para todos.

Notas técnicas

  • No usar WeasyPrint / wkhtmltopdf: no ejecutan Paged.js → rompen header/pie por página.
  • Evitar Chart.js / <canvas>: rompen la paginación. Usar KPIs y tablas CSS.
  • Sin recursos externos (fuente de sistema, sin Google Fonts, sin CDNs).
  • Color primario #c81b74; fuente Century Gothic con fallbacks.