Gráficos
Los tres gráficos del tablero —el tanque, la producción diaria y los insumos contra su mínimo— son SVG plano, escrito acá. No hay librería de gráficos en el proyecto.
Por qué no se adoptó una librería
Sección titulada «Por qué no se adoptó una librería»Se evaluó Rosen Charts, que era la candidata. Lo que apareció al mirarla de cerca:
| No es un paquete npm | Es copy-paste estilo shadcn. El código aterriza en el repo y pasa a ser nuestro de mantener — con la diferencia de que no lo escribimos nosotros |
| Algunos gráficos son pagos | Pago único, acceso de por vida. No es un problema en sí; sí lo es descubrirlo a mitad de camino |
Dibuja con div, no con SVG |
Es su truco para no necesitar 'use client'. Funciona, pero limita precisión y accesibilidad |
Y sobre todo: los gráficos que este tablero necesita son tres, y uno de ellos —el tanque— es custom con cualquier librería, porque ninguna trae un tanque.
Traer una dependencia de D3 más código de terceros para dibujar barras y una línea de umbral costaba más que escribirlas. La cuenta cambiaría el día que haga falta un scatter, un heatmap o un eje temporal con zoom: ahí una librería gana, y esta decisión se revisa.
Los tres son Server Components
Sección titulada «Los tres son Server Components»SVG plano, sin estado ni efectos. Se pintan en el servidor y llegan como HTML.
No hay 'use client' en el tablero.
Las decisiones que se toman antes de dibujar
Sección titulada «Las decisiones que se toman antes de dibujar»El tanque marca cuartos, no litros
Sección titulada «El tanque marca cuartos, no litros»RN-PRD-11 es explícita: no hay medidor ni regleta. Lo que alguien puede
afirmar mirando un tanque es un cuarto, la mitad, tres cuartos.
Un eje graduado de 0 a 13.000 prometería una precisión que nadie tiene, y sería
una escala que hay que traducir mentalmente cada vez. Los litros siguen estando
—arriba, en cifra— porque el saldo del libro es el que manda (RN-PRD-14). El
dibujo es para comparar, no para medir.
Cuando el último cierre anotó un nivel observado, se pinta la franja que ese nivel representa. Ahí el gráfico deja de ser un adorno: si la línea del agua cae dentro de la franja, el libro y el ojo dicen lo mismo; si cae afuera, hay algo sin registrar y se ve de un vistazo.
La producción va en litros y en UNA serie
Sección titulada «La producción va en litros y en UNA serie»La tentación era apilar pacas de 600, pacas de 300 y botellones. Dos razones para no hacerlo:
- No son la misma unidad. Una paca trae 20 bolsas y un botellón es uno. Sumarlos da un número que no significa nada, y apilarlos invita a compararlos como si fueran comparables.
- Tres segmentos apilados se distinguen solo por color, que es exactamente el problema que el sistema resuelve con cuatro canales en el semáforo (R40). Cerca del 8 % de los varones no separa el par verde/azul, y al sol en la planta no lo separa nadie.
Los litros sí son una unidad común, están siempre —no dependen del caudal— y contestan la pregunta que alguien se hace mirando: cuánto salió cada día.
Un dato que falta no se dibuja en cero
Sección titulada «Un dato que falta no se dibuja en cero»litrosProcesados es null mientras nadie mida el caudal
(pregunta 4). Un cero diría «ese día no se procesó
nada», que es otra cosa: se marca con un punto tenue, que significa hubo
cierre, falta el dato.
Es la misma regla que atraviesa el sistema — un hueco se declara como hueco.
La escala se comparte, aunque los mínimos difieran
Sección titulada «La escala se comparte, aunque los mínimos difieran»En los insumos, todas las barras usan la misma escala. Escalar cada una a su propio máximo haría que dos saldos muy distintos se vean iguales, que es la forma más común de que un gráfico mienta sin decir nada falso.
El techo contempla los mínimos además de los saldos: si todos los insumos estuvieran por debajo de su mínimo, escalar solo por el saldo dejaría las marcas de umbral fuera del dibujo, justo cuando más importan.
Accesibilidad
Sección titulada «Accesibilidad»Cada <svg> lleva role="img" y un aria-label que dice los números, no la
forma. «Un gráfico de barras» no le sirve a nadie; «795 litros en el último
cierre, sin el caudal medido» sí.
El color nunca es el único canal: cada insumo lleva además su insignia de estado con los cuatro canales del sistema.
Qué falta
Sección titulada «Qué falta»El tanque se sincroniza con la producción y los ajustes, y así se queda: el agua sale al envasar, no al vender, así que una venta no mueve el saldo. M6 entró y el tanque no cambió — era lo previsto.
Lo que M6 sí habilitó y todavía no se construyó es el gráfico de rotación: cuánto de lo envasado se vende, y en cuánto tiempo. Antes no tenía datos con qué dibujarse; ahora los tiene.