Oráculo SMT

Título

Do chão de fábrica ao código: como um técnico de SMT criou um assistente de IA que responde com base no manual

Subtítulo: 15 anos consertando máquinas de montagem de placas em Manaus me ensinaram que o problema raramente é falta de informação. É encontrar a informação certa, na hora certa, com a linha parada.

O problema: a linha parada e um manual de centenas de páginas

Trabalho há mais de 15 anos como técnico em linhas SMT, onde máquinas posicionam componentes eletrônicos em placas a milhares por hora. Quando uma delas para com um código de erro, cada minuto conta.

A resposta quase sempre existe. Está em algum lugar de um manual em PDF, muitas vezes em inglês ou japonês, com centenas de páginas. Ou está na cabeça de um colega que resolveu o mesmo problema no turno anterior e já foi para casa.

O técnico novo procura, liga para alguém, tenta de novo. O experiente lembra, mas não está em todos os turnos. Foi daí que nasceu a pergunta que virou projeto: e se a linha tivesse um colega que leu todos os manuais e nunca esquece o que a equipe aprendeu?

A ideia: o Oráculo SMT

O Oráculo SMT é um assistente de suporte técnico para linhas de montagem eletrônica. O técnico digita (ou fala) o código de erro, a máquina ou o sintoma, e recebe a resposta com base no manual carregado, citando de onde ela veio.

Três regras guiaram o projeto desde o início:

Sem achismo: se a resposta não está no manual, o sistema diz que não sabe, em vez de inventar.
O manual prevalece: a experiência da equipe complementa, mas nunca contradiz a documentação oficial.
Conhecimento que fica: cada solução que funcionou na linha pode virar uma "experiência" aprovada, disponível para o próximo turno.

Além da conversa, o sistema reúne ferramentas do dia a dia: tabela de códigos de erro, controle de componentes sensíveis à umidade (MSL), calendário de preventivas e calculadoras de processo.

Como funciona por dentro

A técnica por trás se chama RAG (geração aumentada por recuperação). Em vez de confiar no que o modelo de IA "lembra", o sistema primeiro busca os trechos certos dos manuais e só então pede para a IA responder usando apenas esses trechos.

Preparar os manuais: cada PDF é lido, dividido em trechos e indexado. Páginas escaneadas passam por OCR para virar texto pesquisável.
Entender a pergunta: códigos de erro são reconhecidos e decodificados antes da busca, porque um código carrega informação (módulo, posição, tipo de falha).
Buscar: o sistema encontra os trechos mais relevantes dos manuais e das experiências aprovadas pela equipe.
Responder: a IA monta a resposta só com esse material e mostra a fonte, para o técnico conferir.

Tecnologias: Node.js e Express no servidor, PostgreSQL (via Supabase) como banco, e mais de um provedor de IA, para que o sistema continue funcionando se um deles sair do ar. A interface é HTML, CSS e JavaScript puros, com um núcleo holográfico animado em Canvas que virou a "recepção" do sistema.

Um detalhe que gosto de mostrar: com o mouse sobre o núcleo, girar a roda faz você "entrar" nele. Lá dentro aparecem as páginas reais dos manuais que o sistema consulta, mais de 3.500, agrupadas por manual. É o jeito visual de mostrar o que "responder com base no manual" quer dizer.

Segurança desde o primeiro dia

Manuais técnicos de fabricantes são material sensível, e um sistema na internet é alvo desde o primeiro minuto. Por isso a segurança nunca foi "para depois":

Nada sem login: só entram contas aprovadas uma a uma pelo administrador.
Proteção contra robôs: desafio anti-robô no login e limite de tentativas.
Fora dos buscadores o que é interno: só a página de apresentação é pública.
Domínio próprio protegido contra ataques de negação de serviço (DDoS), com conexão sempre criptografada.
Backup em três lugares, um deles criptografado e independente do meu computador.
Testes automáticos a cada mudança, inclusive tentativas de acesso indevido.

Não detalho aqui como cada camada funciona, de propósito: em segurança, explicar a defesa é entregar o mapa para quem quer atacar.

O que aprendi

Quem conhece o problema leva vantagem. Eu não comecei como programador. Mas sabia exatamente o que o técnico precisa às 3 da manhã com a linha parada, e isso orientou cada decisão.
IA sem fonte é perigosa no chão de fábrica. Uma resposta errada e confiante pode danificar uma máquina. Por isso o sistema mostra de onde tirou cada resposta e admite quando não sabe.
O dado mais valioso é o da equipe. O manual diz o que a máquina deveria fazer; a experiência registrada diz o que realmente resolve.
Teste é o que deixa dormir tranquilo. Cada mudança passa por dezenas de suítes de teste antes de ir ao ar. Mesmo assim, o primeiro bug da capa nova foi encontrado por mim, apertando o botão Voltar do navegador. Teste automatizado não substitui usar o sistema.
Backup que nunca foi restaurado é só esperança. Hoje eu baixo o backup, abro e confiro se ele bate com o original, em vez de só confiar que a cópia rodou.

Próximos passos

O Oráculo SMT já está em uso, e a lista do que vem pela frente é longa: mais manuais, aprovação de conteúdo pelo celular e respostas cada vez mais visuais.

Se você trabalha com manufatura eletrônica, manutenção industrial ou está começando a programar vindo de outra área, quero trocar ideia. Conheça o projeto em https://oraculosmt.com.br/sobre e me chame nos comentários.

Jimmy Hendrix Queiroz — técnico SMT e desenvolvedor, Manaus (AM)