Cadena de Frio

Que es la cadena de frio?

La cadena de frio es el control ininterrumpido de temperatura desde la produccion hasta el consumo. Si un equipo de frio se sale del rango de temperatura seguro, el producto puede estar comprometido.

Configurar un activo para cadena de frio

Desde el Dashboard

1. Ve a Activos y selecciona tu equipo de frio
2. En la seccion de edicion, activa Cadena de Frio
3. Configura:
   • Temperatura minima: Limite inferior seguro (ej: -22 grados C)
   • Temperatura maxima: Limite superior seguro (ej: -16 grados C)
   • Unidad: grados C o grados F
   • Tiempo de gracia: Minutos permitidos fuera de rango antes de alerta critica (1-120 min)

Desde la API

PATCH /api/v1/assets/{asset_id}
{
  "cold_chain_enabled": true,
  "temperature_min": -22,
  "temperature_max": -16,
  "temperature_unit": "C",
  "excursion_grace_minutes": 15
}

Excursiones de Temperatura

Cuando un sensor reporta una temperatura fuera del rango configurado:

1. Se crea una excursion con: temperatura actual, desviacion, direccion (arriba/abajo)
2. Se actualiza continuamente con: duracion, desviacion pico
3. Severidad escala: Warning (dentro del tiempo de gracia) -> Critical (tiempo de gracia agotado)
4. Se resuelve automaticamente cuando la temperatura vuelve al rango normal

Ver excursiones

GET /api/v1/cold-chain/excursions?asset_id=xxx&resolved=false

Respuesta:

{
  "excursions": [
    {
      "id": "exc_001",
      "asset_id": "asset_freezer01",
      "started_at": "2026-03-30T10:15:00Z",
      "current_temp": -14.2,
      "limit_breached": "high",
      "peak_deviation": 3.8,
      "duration_minutes": 12,
      "severity": "warning",
      "resolved": false
    }
  ]
}

Vista de flota

GET /api/v1/cold-chain/status

Retorna todos los activos con cadena de frio habilitada y su estado actual de excursion.

{
  "assets": [
    {
      "asset_id": "asset_freezer01",
      "name": "Freezer Almacen A",
      "current_temp": -14.2,
      "range": [-22, -16],
      "status": "excursion",
      "excursion_duration_minutes": 12
    },
    {
      "asset_id": "asset_cooler01",
      "name": "Cuarto Frio Produccion",
      "current_temp": 3.1,
      "range": [0, 5],
      "status": "ok",
      "excursion_duration_minutes": null
    }
  ]
}

Conexion con HACCP

Si un activo de cadena de frio tambien tiene un CCP HACCP configurado, ambos sistemas evaluan en paralelo:

• Cadena de frio: Registra excursiones con duracion y severidad
• HACCP CCP: Evalua contra limites regulatorios y activa flujo de accion correctiva

Ambos se alimentan del mismo dato — el mismo evento de temperatura fluye por todo el pipeline.

Notificaciones

Cuando se detecta una excursion, Rela envia notificaciones automaticas:

• WhatsApp: Mensaje inmediato al tecnico responsable con nombre del equipo, temperatura actual y desviacion
• Email: Notificacion con detalles completos y enlace al dashboard
• Escalamiento: Si la excursion no se resuelve dentro del tiempo de gracia, se escala al supervisor