Módulo Synapsys
O módulo Synapsys é o componente principal de rastreamento da plataforma ION Guard. Ele fornece localização indoor baseada em BLE, alertas de pânico, monitoramento de dispositivos e analytics.
Sub-recursos por site
O Synapsys agrupa suas capacidades em sub-recursos (features) que o Platform Admin pode habilitar ou desabilitar individualmente por site — sem desligar o módulo inteiro (ver Módulos):
| Sub-recurso | Identificador | O que entrega |
|---|---|---|
| Botão de Pânico | panic-button | Alertas de pânico disparados pelos beacons e o fluxo de resposta associado |
| Rastreamento de Ativos | asset-tracking | Localização e histórico de beacons/ativos por zona, itens de menu de rastreamento |
| Câmara Fria | cold-room | Monitoramento de permanência e pausas térmicas — ver Módulo Câmara Fria |
No portal, a Câmara Fria é documentada como uma subcategoria própria por ter escopo funcional extenso, mas tecnicamente ela é entregue como o sub-recurso cold-room dentro do módulo Synapsys (indoor-location), reaproveitando a mesma infraestrutura de beacons e antenas.
Funcionalidades
Rastreamento em tempo real
- Localização de beacons por zona usando sinais RSSI captados por antenas
- Cálculo de confiança baseado em quantidade de sinais, intensidade, margem e consistência temporal
- Histerese para evitar oscilação entre zonas limítrofes
- Visualização em Mapa de Zonas com plantas baixas interativas
- Histórico de localização por beacon
Alertas
O módulo registra 5 tipos de alerta:
| Tipo | Severidade | Trigger | Auto-resolve |
|---|---|---|---|
| Botão de Pânico | Crítica | Beacon envia sinal de pânico | Não |
| Dispositivo Offline | Alta | Beacon para de enviar sinais | Sim (quando volta online) |
| Antena Offline | Alta | Antena para de transmitir | Sim (quando volta online) |
| Bateria Baixa | Aviso | Nível de bateria abaixo do limiar | Sim (quando nível normaliza) |
| Entrada em Zona Restrita | Alta | Beacon detectado em zona tipo Restrita | Configurável |
Todos os alertas são escaláveis — consulte Escalação para tempos por tipo.
Dispositivos
- Gerenciamento de Beacons (3 tipos: pânico, ativo, pessoal)
- Gerenciamento de Antenas com configuração MQTT automática
- Monitoramento de saúde: status online/offline, nível de bateria, último sinal
Analytics
O módulo inclui uma página de Analytics (/analytics) com:
- Métricas de resposta — Tempo médio de resposta a alertas (avg, p50, p95)
- Volume de alertas — Breakdown por tipo e severidade
- Resolução — Taxa de resolução manual vs automática
- Ocupação de zonas — Heatmap de presença por zona
- Performance de operadores — Métricas por operador
- Disponibilidade de dispositivos — Ranking de dispositivos mais alertados
- Tendência de escalação — Evolução de alertas escalados
Relatórios
6 tipos de relatório disponíveis para download (CSV, XLSX, PDF):
| Relatório | Descrição |
|---|---|
| Disponibilidade de Beacons | Uptime/downtime por beacon no período |
| Saúde de Antenas | Status e disponibilidade de antenas |
| Atividade de Dispositivos | Log de atividade (sinais, movimentações) |
| Entrada em Zona Restrita | Registro de entradas em zonas restritas |
| Ocupação de Zonas | Métricas de presença por zona |
| Incidentes de Segurança | Resumo de alertas e resoluções |
Menus adicionados
Quando habilitado, o módulo adiciona ao menu lateral:
- Beacons — Gerenciamento de beacons
- Antenas — Gerenciamento de antenas
- Rastreamento — Visão de zonas com contagem de beacons
- Mapa do Site — Visualização interativa com planta baixa
- Analytics — Dashboards e métricas
Pré-requisitos
Para o módulo funcionar corretamente no site:
- Zonas configuradas — Pelo menos uma zona no site
- Antenas cadastradas e atribuídas — Cada zona precisa de pelo menos uma antena
- Beacons cadastrados — Dispositivos registrados com driver correto
- MQTT operacional — Broker Mosquitto ativo para receber sinais das antenas
- InfluxDB operacional — Para armazenamento de sinais time-series
Habilitação
O módulo é habilitado por site. Para habilitar:
- Acesse Módulos no menu de administração
- Localize "Synapsys"
- Clique em "Habilitar" para o site desejado
Consulte Módulos para instruções detalhadas.
Calibração
O módulo inclui uma ferramenta completa de calibração (rota /commissioning) com 4 abas:
- Monitor de Sinais — Heatmap em tempo real (RSSI por antena × beacon)
- Teste de Zonas — Análise detalhada de localização por beacon, com score de confiança
- Calibração — Ajuste de parâmetros do site e offsets por antena
- Verificação — Diagnóstico de infraestrutura, dispositivos e cobertura
A calibração permite ajustar janela de tempo, limiares de RSSI, histerese e offsets individuais por antena — com efeito imediato e validação em tempo real.
Consulte o Guia de Calibração para instruções detalhadas de uso.
Configuração
O módulo possui configurações ajustáveis em config/location.php:
| Parâmetro | Descrição |
|---|---|
| Window size | Janela de tempo para coleta de sinais (segundos) |
| Thresholds | Limiares de RSSI para detecção de zona |
| Hysteresis | Parâmetros anti-oscilação entre zonas |
| Intervals | Frequência de cálculo de localização |
Para alterar esses parâmetros em produção, consulte o administrador do sistema. Veja Configuração.