# 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.