Mario Daniel Dominguez Sosa
a2bd6cb697
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.
50 lines
2.3 KiB
Markdown
50 lines
2.3 KiB
Markdown
# 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.
|