1.4 KiB
Semántica de drenaje
Problema
La señal bruta no puede mostrarse al usuario final como si fuera una verdad directa de negocio.
raw_drain_state por sí solo no basta.
Regla base
La vertical debe distinguir entre:
- señal bruta
- muestra válida / no válida
- estado de drenaje interpretado
- estado de control
- semántica final visible al usuario
Motivo
Una entrada digital no significa automáticamente “medición válida”.
Depende de si el sensor estaba alimentado o no.
Caso de reposo
Cuando el nodo está en reposo con:
5VT = 0
la lectura no debe interpretarse como drenaje.
La semántica correcta en ese caso es:
NO_SAMPLE
Caso activo
Cuando el sistema está en ACTIVE y el sensor está alimentado, la lectura sí puede interpretarse como muestra válida.
Regla operativa consolidada
ACTIVE-> la lectura es válidaSLEEP + 5VT=0-> no hay muestra válida- reposo sin alimentación != drenaje
Qué no debe verse en pantalla
El usuario no debe ver ingeniería interna cruda como único dato principal.
No debe tomarse raw_drain_state como panel final.
Qué debe verse
El usuario debe ver estados prácticos y robustos.
El objetivo de la vertical no es enseñar bits, sino soportar una operación comprensible y útil.
Consecuencia práctica en Grafana
Las queries y paneles finales deben basarse en semántica útil (semantic_state) y no en el bit bruto aislado.