cochid-graphs dentro del sistema.
cochid-graphs será el renderer y servicio canónico para visualizaciones COCHID. Style v10 le entrega tokens, reglas gráficas y contratos de accesibilidad.
Arquitectura observada
| Capa | Estado actual |
|---|---|
| Backend | FastAPI, Plotly y Kaleido para PNG, SVG y PDF |
| Frontend | Next 16, React 19, Tailwind 4 y react-plotly.js |
| Datos | cochid-datos mediante FDW de lectura |
| Theme | Carga tokens desde style.cochid.cl con fallback |
| Plantillas | Línea, barras, área, coropletas, dispersión y multiserie |
Contrato v10
| Style entrega | cochid-graphs entrega |
|---|---|
| Fuentes y roles tipográficos | SVG, canvas y exports con la misma familia |
| Paletas categórica, secuencial y divergente | Asignación estable y contraste |
| Papel, tinta, línea y estados | Layout Plotly y assets |
| Formato de número, fecha y unidad | Ejes, tooltip y CSV |
| Accesibilidad | Resumen, tabla, caption y descarga |
| Manifest | Versión de theme y renderer en el recibo |
Theme ejecutable del candidato
Prueba con el renderer real
Este SVG se generó localmente con render_figure y to_svg de cochid-graphs, un fixture ficticio y el theme r19. La procedencia registra el commit, los entrypoints y los digests; no creó objetos en producción.
Deuda detectada
- El fallback todavía usa Inter y debe pasar a IBM Plex Sans.
- El frontend actual incluye sombra hover en cards y debe eliminarla.
- Tailwind está fijado a una beta 4.0.0 y debe alinearse con la versión v10.
- El contrato de tokens necesita schema, digest y política de refresh.
- Los exports deben incrustar tipografía o declarar sustitución verificable.
Integración por producto
- COCHID Datos enlaza el editor y permalinks de gráficos.
- Mapas usa D3 o geografía especializada cuando Plotly no cubre el caso.
- Informes consumen SVG/PDF y registran template, query, fuente y fecha.
- USAIA puede usar cochid-graphs para evidencia analítica, sin convertirlo en renderer general de chat.
Decisiones
Usa el identificador para confirmar, modificar o rechazar una regla.
GRAPH-01Regla vigentecochid-graphs es el servicio gráfico canónico de COCHID.
GRAPH-02Pendiente de aprobaciónVersionar un schema de theme v10 consumible por Plotly y exports.