61 lines
1.4 KiB
Markdown
61 lines
1.4 KiB
Markdown
# 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álida
|
|
- `SLEEP + 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. |