API de Manutenção Preditiva PHM para Ponte Rolante

Os dados operacionais acumulados pelo sistema de manutenção preditiva (PHM) da ponte rolante só se tornam um centro de dados integrado nas decisões de planeamento da produção quando ligados ao sistema de execução de manufatura (MES) da oficina e à plataforma de gestão de nível superior — caso contrário, permanecem uma ferramenta de alerta isolada. A Kelude Indústrias Pesadas acaba de disponibilizar oficialmente a interface RESTful API do seu sistema PHM de manutenção preditiva para pontes rolantes. Até à data desta publicação, a interface de dados já foi concluída e testada com 30 fornecedores de MES, abrangendo três grandes tipos de sistemas: MES metalúrgico, MES de fabricação discreta e WMS de armazém. Com a abertura da API, os dados de estado em tempo real da ponte rolante, os eventos de alerta e as recomendações de manutenção podem ser enviados diretamente para a plataforma de gestão de produção já existente no cliente, sem que o operador tenha de alternar entre vários sistemas. Este artigo apresenta o tema em quatro vertentes: especificação técnica da API, processo de integração, cenários de aplicação típicos e resultados dos testes de integração.

Arquitetura da API PHM e modelo de dados

A API PHM agora disponibilizada segue a especificação OpenAPI 3.0, adota o estilo arquitetural RESTful e suporta dois formatos de serialização de dados: JSON e Protocol Buffers. A API está organizada em cinco categorias de interfaces por tipo de recurso, cobrindo todas as capacidades de dados centrais do sistema PHM da ponte rolante.

Interface de estado em tempo real (Realtime Status API): permite consultar num único passo o estado operacional atual da ponte rolante. Os principais endpoints incluem: GET /api/v1/crane/{craneId}/status (devolve os parâmetros operacionais atuais — posição X/Y da ponte, altura de elevação, velocidade de translação, corrente do motor, estado do freio, leituras do limitador de sobrecarga, entre outros, num total de 36 campos, com frequência de atualização de 1 segundo), GET /api/v1/crane/{craneId}/health (devolve a pontuação de saúde do equipamento, um índice de saúde de 0 a 100 calculado por fusão de múltiplas dimensões de parâmetros, atualizado a cada 5 minutos) e GET /api/v1/crane/{craneId}/alerts (devolve a lista de alertas ativos, com filtros por grau de severidade e tipo de alerta).

Interface de dados históricos (History API): permite consultas em lote de dados operacionais e histórico de alertas. Os endpoints incluem: GET /api/v1/crane/{craneId}/timeseries (consulta de dados de séries temporais históricas de parâmetros específicos num intervalo de tempo, com exportação contínua até 30 dias e período de amostragem configurável em três níveis: 1 segundo, 10 segundos ou 1 minuto), GET /api/v1/crane/{craneId}/alerts/history (consulta da lista de eventos de alerta históricos, incluindo hora de ocorrência, hora de resolução, tipo de alerta, grau de severidade e estado de tratamento) e GET /api/v1/crane/{craneId}/maintenance (consulta do histórico de manutenção do equipamento, incluindo tipo de manutenção, data, conteúdo e executor). A interface de dados históricos destina-se principalmente à geração de relatórios de análise OEE e ao planeamento de calendários de manutenção no sistema MES.

Interface de envio de alertas (Alert Webhook API): permite que a plataforma MES subscreva eventos de alerta do sistema PHM através de webhooks. O cliente configura as regras de envio de alertas no backend web do PHM (URL de destino, limiar de grau de alerta e frequência de envio). Quando o sistema PHM gera um novo evento de alerta, envia automaticamente um pedido POST para o URL do webhook configurado, com o corpo do pedido em formato JSON contendo os dados do evento. O webhook inclui um mecanismo de repetição: em caso de falha no primeiro envio, tenta novamente após 30 segundos, até 3 tentativas no total; se todas falharem, envia uma notificação por email ao administrador para tratamento manual. A latência mediana do envio por webhook é de 5 segundos (desde a deteção da anomalia pelo PHM até à receção da mensagem no MES do cliente).

Interface de gestão de equipamentos (Device Management API): fornece operações CRUD sobre as informações básicas das pontes rolantes. Os endpoints suportam o registo de novos equipamentos (POST /api/v1/crane, com geração automática do identificador único e dos parâmetros de configuração iniciais), a atualização de configurações (PATCH /api/v1/crane/{craneId}, para alterar limiares de alerta, frequência de amostragem, entre outros), a consulta da lista de equipamentos (GET /api/v1/cranes, com filtros por oficina, tipo de equipamento e estado operacional) e a eliminação de equipamentos (DELETE /api/v1/crane/{craneId}, com confirmação em duas etapas). Esta interface permite que o sistema MES do cliente registe automaticamente novas pontes rolantes no sistema PHM, sem necessidade de acesso manual ao backend do PHM.

Interface de modelos e diagnóstico (Model API): fornece gestão de modelos de diagnóstico de IA e consulta de resultados de diagnóstico. Os endpoints incluem: GET /api/v1/model/{modelId}/info (consulta de informações sobre um modelo de diagnóstico específico — número da versão do modelo, data de implantação, modelos de ponte rolante suportados e indicadores de precisão), POST /api/v1/crane/{craneId}/diagnose (aciona um diagnóstico de saúde imediato para uma ponte rolante específica, devolvendo o estado de saúde de cada subsistema e as medidas de manutenção recomendadas) e GET /api/v1/crane/{craneId}/diagnose/history (consulta da lista de relatórios de diagnóstico anteriores). A Model API permite que o sistema de despacho do MES do cliente consulte proativamente o estado de saúde da ponte rolante antes do planeamento da produção, evitando atribuir tarefas a equipamentos em mau estado.

Solução técnica de integração e certificação de segurança

A API PHM utiliza o fluxo de credenciais de cliente OAuth 2.0 (Client Credentials Grant) para autenticação. No primeiro contacto com a API, o sistema MES do cliente solicita um ID de cliente (client_id) e uma chave secreta de cliente (client_secret) através da plataforma de desenvolvimento PHM e obtém um token de acesso (access_token) através do endpoint POST /oauth/token. O token é válido por 24 horas por predefinição e, após expirar, deve ser renovado com refresh_token. Os limites de frequência de pedidos são: interface de estado em tempo real — máximo de 6000 consultas por hora (cerca de 1,67 por segundo em média), interface de dados históricos — máximo de 360 por hora, interfaces de envio de alertas e diagnóstico de modelos — sem limite de frequência. O tempo de resposta da API no percentil 99% é inferior a 500 ms (excluindo transmissão em redes lentas).

A transmissão de dados é encriptada com TLS 1.3 e o gateway da API está implantado no Alibaba Cloud API Gateway, com suporte para WAF (Web Application Firewall) e proteção DDoS. Os registos de pedidos da API incluem o carimbo temporal, o ID do cliente, o caminho do pedido, o código de estado da resposta e o tempo de resposta de todas as chamadas, com um período de retenção de 180 dias. O cliente pode consultar autonomamente as estatísticas de utilização da API através da plataforma de desenvolvimento (volume diário de chamadas, taxa de sucesso, tempo médio de resposta, entre outros indicadores). A plataforma disponibiliza um ambiente sandbox onde o cliente pode desenvolver e testar a integração com dados simulados antes de migrar para o ambiente de produção. O ambiente sandbox é totalmente isolado do ambiente de produção, sem qualquer impacto nos dados reais do equipamento.

Estado da integração e cobertura de fornecedores MES

Até à data desta publicação, a integração e os testes da API foram concluídos com 30 fornecedores de MES, abrangendo quatro setores: indústria metalúrgica (12), fabricação de equipamentos pesados (8), maquinagem mecânica (6) e logística de armazém (4). Os tipos de sistemas MES integrados incluem: sistemas MES nacionais de referência (como UFIDA U8+MES, Kingdee Cloud Galaxy MES, Digiwin MES, entre outros — 14), sistemas MES verticais (como MES metalúrgico, MES de processamento de alumínio, MES naval, entre outros — 10) e sistemas MES de desenvolvimento próprio (sistemas de gestão de oficina desenvolvidos internamente por grandes empresas — 6).

Existem três padrões comuns de integração de dados PHM por parte dos fabricantes de sistemas MES durante o processo de ligação: integração de painel de alertas (a lista de alertas PHM é incorporada no painel de monitorização de equipamentos do sistema MES, permitindo que o operador visualize os alertas de saúde da ponte rolante sem mudar para o sistema PHM — escolhido por cerca de 70% dos clientes), geração automática de ordens de manutenção (o sistema MES recebe o alerta PHM e aciona automaticamente o fluxo de criação da ordem de manutenção, preenchendo automaticamente as informações do equipamento, a descrição do alerta e o plano de manutenção recomendado — escolhido por cerca de 45% dos clientes) e articulação entre saúde do equipamento e planeamento (o módulo de planeamento do MES consulta automaticamente a pontuação de saúde do equipamento PHM ao atribuir tarefas de içamento e transporte, priorizando a atribuição de tarefas urgentes às pontes rolantes com pontuação mais elevada — escolhido por cerca de 20% dos clientes). Os três padrões podem ser combinados sem conflitos.

O período médio para testes de integração é de 3 a 5 dias úteis (desde a obtenção da documentação da API pelo fabricante do MES até à conclusão da validação de dados ponta a ponta), sendo que o fabricante de MES mais rápido concluiu a integração em 2 dias úteis. Os problemas típicos identificados durante a fase de testes de integração incluem: exceder o limite de frequência de pedidos à API (resolvido ajustando o intervalo de sondagem do sistema MES; recomenda-se que o intervalo de sondagem para interfaces de estado em tempo real não seja inferior a 5 segundos), problemas de sincronização temporal de dados (incompatibilidade de fusos horários entre o tempo do alerta PHM e o tempo da ordem de trabalho MES — resolvido devolvendo simultaneamente o tempo UTC e o tempo local nos dados de alerta) e certificados expirados no recetor Webhook (resolvido através de monitorização automática da validade dos certificados no API Gateway e alerta antecipado de 30 dias).

Cenários de aplicação típicos e dados de desempenho

Tomando como exemplo uma empresa metalúrgica que já integrou a API PHM, esta possui 5 pontes rolantes. Antes da implementação, as informações de alerta das pontes rolantes exigiam que o administrador de equipamentos iniciasse sessão no backend PHM Web para consulta manual. Após a deteção de um alerta, era necessário preencher manualmente uma ordem de manutenção em papel e entregá-la à equipa de manutenção, resultando num tempo médio de 45 minutos desde a ocorrência do alerta até à emissão da ordem. Após a integração da API, os eventos de alerta do sistema PHM são automaticamente enviados para o sistema MES da empresa via Webhook. O sistema MES gera automaticamente ordens de manutenção com base no grau de alerta (ordens de nível Warning são atribuídas automaticamente à equipa de manutenção do turno diurno; ordens de nível Critical notificam imediatamente o engenheiro de serviço). O tempo de geração da ordem é reduzido para menos de 10 segundos. As estatísticas dos 6 meses seguintes à integração mostram que o tempo médio de resposta para paradas não programadas das pontes rolantes da empresa (desde a ocorrência da falha até à chegada ao local do pessoal de manutenção) diminuiu de 85 minutos para 22 minutos, e a perda de capacidade de produção causada por paradas não programadas foi reduzida em cerca de 62%.

A abertura da interface API também forneceu a base de dados para a otimização contínua do sistema PHM — o modelo de alerta de saúde da ponte rolante utiliza os dados de resultados de manutenção fornecidos pelo sistema MES (se a falha corresponde de facto ao alerta PHM, os modelos de componentes efetivamente substituídos e o tempo de manutenção) para treino iterativo, melhorando a precisão de alerta precoce em cerca de 1,5 pontos percentuais por trimestre. As interfaces de dados planeadas para a próxima fase incluem: dados de consumo de energia da ponte rolante (consumo elétrico em tempo real e consumo acumulado dos motores da Ponte, do Carro e do Motor de Elevação, suportando benchmarking energético e otimização da eficiência) e estatísticas de içamento e transporte (número médio diário de operações de içamento por ponte rolante, distribuição do peso içado e estatísticas de duração das operações, suportando análise de eficiência do planeamento de produção), com o objetivo de concluir a integração com 50 fabricantes de sistemas MES até ao final do ano.

Perguntas Frequentes (FAQ)