Documentação técnica

Visão geral

A Luctronics é uma plataforma modular de gestão de manutenção e monitoramento de infraestrutura. Todos os módulos compartilham a mesma base de dados, o mesmo controle de acesso e o mesmo modelo de ativos — o que permite consultas transversais (por exemplo: todas as pendências de um mesmo local, independentemente do módulo que as gerou).

O sistema foi desenhado a partir de uma operação real de manutenção especializada, não a partir de um requisito teórico. Isso significa fluxos que refletem a prática: ordem de serviço que passa por contratação, fiscalização e certificação; lista de compras gerada a partir da baixa de estoque; laudo de inspeção com matriz de priorização.

Arquitetura

Módulos

PMOC · Climatização Em produção

Plano de Manutenção, Operação e Controle para sistemas de climatização. Cadastro de unidades, planos periódicos, geração de ordem de serviço com fluxo de contratação (incluindo adesão a Ata de Registro de Preços), fiscalização, certificação de execução, QR code por equipamento e impressão de relatórios.

Elétrica Em produção

Geradores, quadros gerais de baixa tensão (QGBT), nobreaks e iluminação. Planos disparados por horas de operação, OS com baixa automática de estoque e geração de lista de compras a partir das peças consumidas.

Predial Em produção

Inspeção predial conforme NBR 5674 e NBR 16747. Árvore hierárquica de locais, checklists por template, matriz GUT (Gravidade, Urgência, Tendência) para priorização e emissão de laudos.

Calibração Em produção

Rastreabilidade metrológica de instrumentos. Controle de vencimentos, anexo de certificados e laudos, cronograma de envio e alerta de instrumento fora de validade.

Transportes Em produção

Gestão de frota de veículos. Importação da base de ativos, programação de viagens, planos de manutenção e relatórios operacionais.

Máquinas Em produção

Equipamentos com controle por horímetro. Cadastro de peças com preço, registro de consumo de combustível, acompanhamento de ciclo de vida do ativo e lista de compras.

Aviso sonoro Em produção

Sistemas de sonorização PA 70V — amplificadores, consoles, cornetas, linhas e sirenes. Testes periódicos com registro estruturado de não conformidade.

Paióis Em produção

Monitoramento ambiental de paióis e depósitos: temperatura, umidade e detecção de fumaça, por sensores de campo e por medição manual registrada em ronda. Inclui inventário do que está armazenado, controle da climatização do ambiente e mural de leitura consolidada para a portaria.

Gestão e Qualidade Em produção

Camada de gestão à vista sobre todos os módulos: indicadores da NBR 5674, plano de ação 5W2H priorizado por matriz GUT, calendário consolidado de intervenções e as ferramentas clássicas da qualidade aplicadas ao histórico de OS.

Equipes Em produção

Cadastro de pessoas, ofícios e equipes da oficina, com escala semanal por turno e capacidade expressa em homem-hora. O cadastro é compartilhado por todos os módulos, o que permite confrontar carga planejada com capacidade real antes de programar a manutenção.

Bio Beta

Gestão biológica do terreno: fichas de fauna, pragas e espécies arbóreas, árvores etiquetadas com QR code, registro georreferenciado de ocorrências e programação dos serviços de poda e controle com periodicidade definida.

Energia e água Em desenvolvimento

Painel de eficiência energética e hídrica: consumo, demanda contratada, indicadores por área e metas de redução. A interface já está disponível como demonstração com números simulados — a base de medição real ainda está em implantação.

Aguada · Hidráulico Disponível

Monitoramento de reservatórios e sistema hidráulico via sensores ESP32. Existe como aplicação independente e também como módulo integrado à plataforma. Detalhado na seção de sensoriamento.

Sentinela · Segurança Em desenvolvimento

Camada de visão computacional aplicada ao CFTV já existente na instalação: detecção e classificação de objetos, rastreamento entre quadros, contagem e disparo de alarmes por regra configurável. Integra-se ao mesmo motor de alertas dos demais módulos.

Mapa Beta

Mapa interativo da instalação (Leaflet), com basemaps de mapa e satélite e camadas sobrepostas por módulo.

Camada de sensoriamento

Sensoriamento não é um módulo isolado — é uma camada transversal. Onde há grandeza física que valha a pena medir, existe um dispositivo ESP32 que alimenta a mesma base usada pela gestão de manutenção. Isso permite, por exemplo, que uma leitura fora de faixa abra automaticamente uma ordem de serviço no módulo correspondente.

Aguada — arquitetura de referência

O Aguada usa uma rede mesh de nós ESP32 comunicando por ESP-NOW, protocolo ponto-a-ponto da Espressif que dispensa infraestrutura Wi-Fi no ponto de medição. Isso resolve o problema clássico de reservatório em local sem cobertura de rede. A mesma topologia serve de base para os demais dispositivos da camada.

Topologia

# Cada nó fala com o vizinho mais próximo até chegar ao gateway
[Sensor R01] ──┐
[Sensor R02] ──┼──> [Gateway ESP32] ──MQTT──> [Backend FastAPI] ──> [Dashboard]
[Sensor R03] ──┘                                      │
                                                      └──> [Home Assistant]

Características

• Alcance típico por salto: 100 a 200 m em linha de visada
• Sem ponto único de falha — a queda de um nó não derruba a rede
• Intervalo de leitura configurável
• Alertas por limiar (nível crítico, sensor mudo, gateway offline)
• Alimentação por fonte ou bateria com painel solar, conforme o ponto

Grandezas suportadas

API REST

A plataforma expõe uma API REST para integração com sistemas existentes — ERP, sistema de patrimônio, BI ou automação própria.

Autenticação

Autenticação por token Bearer, enviado no cabeçalho de cada requisição.

GET /api/v1/ativos
Authorization: Bearer <seu_token>
Accept: application/json

Endpoints principais

Exemplo de resposta

{
  "id": "R01",
  "nome": "Reservatório Principal",
  "tipo": "reservatorio",
  "capacidade_litros": 50000,
  "nivel_percentual": 76.7,
  "atualizado_em": "2026-08-20T09:41:12-03:00",
  "status": "normal"
}

Integrações

Implantação

Requisitos de servidor

• Linux (Debian/Ubuntu recomendado) com 2 vCPU e 4 GB de RAM para instalações de porte médio
• Docker ou instalação nativa com Python 3.11+
• Certificado TLS (Let's Encrypt ou institucional)
• Backup periódico da base — script fornecido na implantação

Requisitos de rede para o módulo IoT

• Gateway com alimentação estável e conectividade até o servidor
• Nós de campo dentro do alcance de salto da mesh
• Liberação da porta MQTT entre gateway e broker

Etapas típicas

1. Levantamento: inventário de ativos, locais e obrigações legais aplicáveis
2. Importação: carga da base existente (planilha, sistema legado ou cadastro manual assistido)
3. Configuração: planos de manutenção, templates de checklist, perfis de acesso
4. Instalação de campo: apenas quando houver módulo IoT contratado
5. Treinamento: sessões com a equipe de manutenção e com a fiscalização
6. Acompanhamento: período assistido até a operação estabilizar

Segurança e dados

• Autenticação: acesso por credencial individual, com perfis por cargo e função
• Transporte: HTTPS/TLS em todas as comunicações com o servidor
• Auditoria: registro de quem fez o quê, quando — essencial para prestação de contas
• Titularidade: os dados operacionais pertencem à organização contratante
• Exportação: a base pode ser exportada em formato aberto a qualquer momento, sem retenção de dados como trava contratual
• LGPD: tratamento conforme a Política de Privacidade; a Luctronics atua como operadora dos dados inseridos pelo cliente

Responsável técnico