flowchart LR
    AUT([Autoridad local])
    COM([Comunidad en sitio])
    TEC([Técnico de mantenimiento])
    subgraph SIS[AquaMonitor]
        UC1((Consultar valor actual))
        UC2((Consultar histórico y eventos))
        UC3((Recibir notificación en tablero))
        UC4((Silenciar alarma física))
        UC5((Ver variables en la OLED))
        UC6((Escuchar alarma sonora))
        UC7((Autenticarse en el tablero))
        UC8((Diagnosticar falla de sensor))
    end
    AUT --> UC1
    AUT --> UC2
    AUT --> UC3
    AUT --> UC4
    UC1 -. include .-> UC7
    UC4 -. include .-> UC7
    COM --> UC5
    COM --> UC6
    TEC --> UC8
    TEC --> UC5

classDiagram
    class Estado {
        <<enumeration>>
        EST_OK
        EST_DESBORDE
        EST_FUGA
        EST_SEQUIA
        EST_ERROR_SENSOR
    }
    class Datos {
        float nivel, distCm
        float temp, hum
        float presion, tempBmp, presDelta
        float uvV, uvIdx, evap
        float tasaReal, tasaEsperada, perdidaExtra
        int8_t tendencia
        uint8_t catUV
        uint8_t fallas
        Estado estado
        bool silenciada, presionCae
    }
    class Muestra {
        unsigned long t
        float nivel, temp, hum, uvIdx, evap, presion
        Estado estado
    }
    class Evento {
        unsigned long t
        uint8_t codigo
    }
    class TareaSensado {
        +tareaSensado(void*)
        -leerUV(float&) bool
        -medirDistanciaMediana(float) float
        -calcularIndiceEvaporacion(t,h,uv) float
        -calcularEstado(...) Estado
    }
    class GestorFallas {
        +aplicarFalla(bit, activa, t)
        +reportarFalla(bit, activa)
        +registrarEvento(codigo, t)
    }
    class InterfazLocal {
        +loop()
        +dibujarPantalla(Datos)
        +vigilarOLED(ahora)
    }
    class GestorWiFi {
        +conectarWiFi() bool
        +gestionarWiFi(ahora)
    }
    class ServidorWeb {
        +configurarServidorWeb()
        -acceso(req) bool
        -ipEnSubred(ip) bool
    }
    Datos --> Estado
    Muestra --> Estado
    TareaSensado --> Datos : escribe (mutexDatos)
    TareaSensado --> Muestra : historico[60]
    TareaSensado --> GestorFallas
    GestorFallas --> Evento : eventos[10]
    InterfazLocal --> Datos : snapshot
    InterfazLocal --> GestorFallas
    GestorWiFi --> GestorFallas
    ServidorWeb --> Datos : lee (mutexDatos)
    ServidorWeb --> Muestra
    ServidorWeb --> Evento

stateDiagram-v2
    [*] --> OK
    OK --> DESBORDE : nivel ≥ 95 %
    DESBORDE --> OK : nivel < 90 %
    OK --> FUGA : tasa < 0 y pérdida extra ≤ −2.5 %/h
    FUGA --> OK : condición deja de cumplirse
    OK --> SEQUIA : nivel ≤ 20 %, o nivel ≤ 35 % y evap ≥ 70 (55 si la presión cae)
    SEQUIA --> OK : nivel > 25 % y sin riesgo por evaporación
    OK --> ERROR_SENSOR : 5 ciclos sin eco válido
    DESBORDE --> ERROR_SENSOR : 5 ciclos sin eco
    FUGA --> ERROR_SENSOR : 5 ciclos sin eco
    SEQUIA --> ERROR_SENSOR : 5 ciclos sin eco
    ERROR_SENSOR --> OK : vuelve el eco (se reevalúan las reglas)

sequenceDiagram
    actor U as Autoridad (navegador)
    participant W as Servidor web (ESP32)
    participant M as mutexDatos
    participant T as Tarea de sensado
    participant L as loop()
    participant B as Buzzer
    T->>M: toma mutex, escribe Datos (estado = SEQUIA)
    L->>M: snapshot
    L->>B: pitido intermitente
    loop cada 4 s
        U->>W: GET /data
        W->>W: acceso() — subred y credenciales
        alt fuera de la subred
            W-->>U: 403
        else sin credenciales válidas
            W-->>U: 401
        else autorizado
            W->>M: copia Datos y eventos
            W-->>U: 200 JSON
        end
    end
    U->>W: POST /silenciar
    W->>M: datos.silenciada = true
    W-->>U: 200 ok=true
    L->>M: snapshot (silenciada)
    L->>B: apagado

flowchart TD
    S([Inicio de ciclo]) --> D[Leer DHT22]
    D --> DV{¿Válido?}
    DV -- sí --> DA[Aplicar calibración, fallasDHT = 0]
    DV -- no --> DF[fallasDHT++]
    DA --> P
    DF --> P
    P[Tomar mutexI2C, verificar BMP180 en 0x77] --> PV{¿Responde y en rango?}
    PV -- sí --> PA[Presión calibrada, fallasBmp = 0]
    PV -- no --> PF[fallasBmp++, reinicializar al volver]
    PA --> PW{¿Pasó la ventana de 3 h?}
    PW -- sí --> PC[Calcular ΔP, presionCae si ΔP ≤ −2 hPa]
    PW -- no --> U
    PC --> U
    PF --> U
    U[Leer GUVA, 16 muestras] --> UV{¿Ruido, saturación o 0 mV?}
    UV -- no --> UI[Índice UV]
    UV -- sí --> UF[fallasUV++]
    UI --> N
    UF --> N
    N[HC-SR04: 5 disparos, mediana] --> NV{¿≥ 3 válidas?}
    NV -- sí --> NE[Nivel en porcentaje, EMA, tendencia, tasa]
    NV -- no --> NF[fallasNivel++]
    NE --> E
    NF --> E
    E[Índice de evaporación y pérdida esperada] --> MX[Tomar mutexDatos]
    MX --> F[Actualizar bits de falla]
    F --> C[calcularEstado - fusión]
    C --> CE{¿Cambió el estado?}
    CE -- sí --> EV[Registrar evento, rearmar alarma]
    CE -- no --> H
    EV --> H{¿Pasó 1 min?}
    H -- sí --> HI[Guardar muestra en histórico]
    H -- no --> R
    HI --> R[Liberar mutex, imprimir en serie]
    R --> W[Esperar 2 s] --> S