Manual do Rebanho360 Balança

Instalação

Do download ao primeiro indicador

1. 1

   Baixe pelo painel

   Entre no painel do Rebanho 360, abra Dispositivos e clique em «Baixar Rebanho360 Balança para Windows». Aproveite para cadastrar o PC da fazenda.

2. 2

   Aviso do SmartScreen

   O instalador ainda não tem assinatura digital. Na primeira execução o Windows mostra «O Windows protegeu o computador». Clique em «Mais informações» e em «Executar assim mesmo».

3. 3

   Execute o Setup

   Aceite o serviço Windows (recomendado) e o atalho. O instalador traz o WebView2 se o PC não tiver e cria a pasta de dados com as permissões certas.

4. 4

   Serviço

   O serviço chama-se Rebanho360Balanca, roda com a conta LocalService, inicia com o Windows e reinicia sozinho se cair. Pare ou reinicie em Serviços do Windows ou pelo aplicativo.

5. 5

   Conecte com um código

   No painel, abra o dispositivo e clique em «Conectar Balança»: aparece um código de 8 caracteres, válido por 15 minutos. No aplicativo, em Configurações › Nuvem › «Conectar com código», digite o código. A sincronização liga sozinha e o painel confirma «Balança conectada».

6. 6

   Ligue um indicador

   Com o indicador no Wi-Fi, ele aparece em Indicadores em segundos e as pesagens novas começam a descer.

Se este PC já tinha o software do fabricante da balança, feche-o e tire-o da inicialização automática. Os dois usam as portas UDP e TCP 5000; só um pode estar ativo.

Funções, uma a uma

Cada tela, com vídeo

Os vídeos são curtos e sem áudio; o texto ao lado tem o passo a passo. As telas são do próprio software.

01

Instalação e primeiro acesso

Um único instalador para Windows coloca o serviço, o aplicativo e a ferramenta de linha de comando. O serviço começa sozinho com o Windows; o aplicativo abre quando você quiser olhar.

1. 1Baixe o instalador no painel do Rebanho 360 (Dispositivos) com uma conta Master.
2. 2Execute o Setup. Se o Windows mostrar o aviso do SmartScreen, clique em «Mais informações» e depois em «Executar assim mesmo».
3. 3Mantenha marcado «Instalar e iniciar o serviço Windows»: é ele que fala com os indicadores mesmo sem ninguém logado no PC.
4. 4Ao terminar, o Rebanho360 Balança abre na tela inicial. Os dados ficam em C:\ProgramData\Rebanho360\Balanca.

Se outro software de balança estiver instalado neste PC, feche-o e desative a inicialização automática dele: os dois usam as mesmas portas de rede.

Tela inicial logo após a instalação.

02

Indicadores de pesagem

Os indicadores dos vagões se anunciam na rede Wi-Fi da fazenda. O Rebanho360 Balança escuta esses anúncios, registra cada indicador pelo número de série e passa a conversar com ele automaticamente.

1. 1Ligue o indicador no Wi-Fi da fazenda. Em segundos ele aparece em Indicadores, com IP e hora da última visita.
2. 2Dê um apelido (por exemplo «Vagão 1») para reconhecer o indicador nas pesagens e nos relatórios.
3. 3Use «Baixar pesagens» para forçar o download ou, no console, «Ler cadastros do indicador» para ver o que está gravado nele.
4. 4O console envia um comando bruto ao indicador: útil para suporte, não para o dia a dia.

Vídeo curto, sem áudio, com legendas na tela.

03

Download automático das pesagens

Cada vez que um indicador aparece na rede, e depois em intervalos regulares, o software baixa as pesagens novas, grava no banco local e desconta o estoque. Nada se perde se o Wi-Fi cair no meio: o download continua de onde parou.

1. 1Abra Pesagens para ver cargas e descargas por período, indicador, tipo e receita.
2. 2Clique numa linha para ver os ingredientes e quilos (carga) ou os lotes e quilos (descarga).
3. 3A ferramenta «Importar XML do indicador» traz pesagens gravadas no pendrive por um indicador que não está na rede.

O número da pesagem é o registro do próprio indicador. Pesagens já baixadas nunca são duplicadas.

Vídeo curto, sem áudio, com legendas na tela.

04

Cargas e descargas

Carga é o que entrou no vagão (ingredientes por receita, manual ou por autônomo). Descarga é o que saiu em cada lote (por guia, manual ou por autônomo). As duas chegam do indicador com data, hora e setpoint.

1. 1O tipo da pesagem é identificado automaticamente: Receita, Guia, Manual ou Autônomo.
2. 2Numa pesagem por autônomo, o passo da viagem aparece junto do número do autônomo.
3. 3Use os filtros de período (hoje, 7 dias, 30 dias, personalizado) e o agrupamento por data para fechar o dia.

Vídeo curto, sem áudio, com legendas na tela.

05

Ingredientes

Até 25 ingredientes, cada um numa posição fixa que o indicador reconhece. Nome, unidade, estoque mínimo e custo ficam aqui e alimentam receitas, estoque e relatórios.

1. 1Cadastre o ingrediente na posição desejada e salve.
2. 2Envie aos indicadores em «Sincronizar cadastros» para que as pesagens cheguem com o nome certo.

Vídeo curto, sem áudio, com legendas na tela.

06

Receitas

Uma receita tem nome, base (kg ou cabeças), tempo de mistura e até 10 ingredientes com quantidades. É o que o operador escolhe no indicador na hora de carregar o vagão.

1. 1Crie a receita, escolha a base e informe a quantidade de cada ingrediente.
2. 2O total e a participação de cada ingrediente aparecem enquanto você digita.
3. 3Salve e envie aos indicadores; a fila mostra quando cada vagão recebeu.

Vídeo curto, sem áudio, com legendas na tela.

07

Guias de descarga

A guia diz quanto descarregar em cada lote (curral). Base em kg ou cabeças, até 10 lotes por guia.

1. 1Crie a guia, escolha a base e adicione lotes com as quantidades.
2. 2Envie aos indicadores em «Sincronizar cadastros».

Vídeo curto, sem áudio, com legendas na tela.

08

Autônomos

O autônomo junta uma receita e uma guia com a capacidade do vagão (bachada) e a porção a fornecer. O software calcula as viagens e o indicador conduz o operador passo a passo.

1. 1Escolha receita e guia com a mesma base, informe a bachada em kg e a porção (%).
2. 2Confira o plano de viagens: quantas cargas, quanto por lote em cada viagem.
3. 3Salve e envie ao indicador.

Receita e guia precisam ter a mesma base (kg ou cabeças); o software impede a combinação errada.

Vídeo curto, sem áudio, com legendas na tela.

09

Lotes

Os lotes (currais ou piquetes) são os destinos das descargas. Cadastre uma vez e use nas guias e nos relatórios de consumo por lote.

1. 1Cadastre o lote com nome e, se quiser, número de cabeças.
2. 2Use nas guias; as descargas passam a aparecer por lote.

Vídeo curto, sem áudio, com legendas na tela.

10

Estoque e custos

Cada carga baixada desconta os ingredientes do estoque. Com estoque mínimo e custos informados, o software avisa quando algo está acabando e calcula o custo de cada carga e de cada lote.

1. 1Em Estoque, lance o saldo inicial e os recebimentos com «Ajustar saldo».
2. 2Informe o estoque mínimo por ingrediente: a tela inicial e a linha do tempo avisam quando ficar abaixo.
3. 3Em Custos, registre o preço por kg na data da compra; os relatórios usam o custo vigente em cada pesagem.

Vídeo curto, sem áudio, com legendas na tela.

11

Sincronizar cadastros com os indicadores

Ingredientes, receitas, guias e autônomos são enviados aos indicadores por uma fila: um comando por vez, na ordem, com o resultado de cada envio registrado.

1. 1Em Indicadores, clique em «Sincronizar cadastros» para enfileirar tudo, ou envie um cadastro específico pela própria tela dele.
2. 2Acompanhe em Tarefas: pendente, enviado ou falhou, com a mensagem do indicador.
3. 3Se um vagão está desligado, a tarefa espera e é enviada assim que ele voltar à rede.

Vídeo curto, sem áudio, com legendas na tela.

12

Relatórios

Dezoito relatórios prontos: desvio de carga por ingrediente e total (com e sem custo), desvio de descarga por lote e total, detalhe de carga, ingredientes por lote, projeção de consumo, receitas, reparto por dia, autônomos e consumo por ingrediente e por lote.

1. 1Escolha o relatório, o período e, quando houver, o indicador, a receita ou o lote.
2. 2Gere na tela, imprima ou exporte.

Vídeo curto, sem áudio, com legendas na tela.

13

Exportar para pendrive e CSV

Para indicadores sem rede, os cadastros podem ir no pendrive em arquivos de texto, e as pesagens voltam em Excel XML. Também há exportação das pesagens em CSV para planilhas.

1. 1Em Pesagens, «Exportar CSV» gera o arquivo com data, hora, número, descrição e cada ingrediente com seu peso.
2. 2Em Configurações, «Exportar para pendrive» grava os cadastros na pasta escolhida.

Vídeo curto, sem áudio, com legendas na tela.

14

Importar o banco do software anterior

Se a fazenda já usava outro software com estes indicadores, receitas, guias, lotes, estoque, custos e pesagens vêm junto. A importação só acrescenta: nada do que já existe é apagado.

1. 1Faça o backup final no software anterior e feche-o.
2. 2Em Configurações, «Importar banco do software anterior» e escolha o arquivo do banco (.sql, .db) ou o backup .sql.
3. 3Confira cadastros e estoque e envie os cadastros aos indicadores.

Vídeo curto, sem áudio, com legendas na tela.

15

Sincronização com o Rebanho 360

Conectado por um código curto gerado no painel, o PC da fazenda envia pesagens, cadastros, inventário de indicadores e eventos ao Rebanho 360. Tudo o que foi confirmado pela nuvem é marcado; o que a nuvem recusar fica separado e é reenviado sozinho mais tarde.

1. 1No painel do Rebanho 360, em Dispositivos, cadastre o PC e clique em «Conectar Balança» para ver o código.
2. 2No aplicativo, em Configurações › Nuvem, use «Conectar com código» e digite o código. A sincronização liga sozinha.
3. 3Em Nuvem, acompanhe cursores, última sincronização e recusados; «Testar conexão» mostra a qual fazenda o PC está ligado.

Se o PC ficar mais de 30 minutos sem falar com o Rebanho 360, o painel avisa quem administra a fazenda.

Vídeo curto, sem áudio, com legendas na tela.

16

Comandos remotos pelo painel

Do painel do Rebanho 360 é possível enfileirar comandos para o PC da fazenda: baixar pesagens, listar indicadores, reenviar cadastros. O PC executa no próximo ciclo e devolve o resultado.

1. 1No painel, abra o dispositivo e use «Comandos».
2. 2O PC executa cada comando uma única vez e registra o resultado.
3. 3Comandos que apagam dados ficam bloqueados por padrão e só funcionam se liberados em Configurações.

Vídeo curto, sem áudio, com legendas na tela.

17

Backup e restauração

Um backup consistente do banco é gravado todo dia, com retenção configurável, e outro é feito automaticamente antes de qualquer exclusão de pesagens. Também dá para fazer na hora.

1. 1Em Configurações, «Fazer backup agora» grava um arquivo com data e hora na pasta backups.
2. 2Para restaurar: pare o serviço, substitua o arquivo do banco pelo backup e inicie o serviço.

Vídeo curto, sem áudio, com legendas na tela.

18

Diagnóstico e logs

A linha do tempo mostra o que aconteceu (indicador apareceu, download, estoque baixo, erro de rede). Os logs ficam em arquivos por dia e, quando preciso, o tráfego com o indicador pode ser gravado para o suporte.

1. 1Em Diagnóstico, veja estado do serviço, da porta de integração e da API local.
2. 2«Copiar diagnóstico» junta tudo o que o suporte precisa.
3. 3Ative «Gravar tráfego de protocolo» só quando o suporte pedir; desative depois.

Vídeo curto, sem áudio, com legendas na tela.

19

Integração com softwares de terceiros

Sistemas que já conversavam com o PC da balança pela rede continuam funcionando: o Rebanho360 Balança oferece a mesma porta TCP, com os mesmos comandos de listagem, cadastro e sincronização.

1. 1Em Configurações, ligue ou desligue a porta de integração e escolha o endereço e a porta.
2. 2Comandos que apagam dados ficam bloqueados por padrão.
3. 3Em Diagnóstico, «Testar comando de integração» confirma que a porta responde.

Vídeo curto, sem áudio, com legendas na tela.

Tarefas automáticas

O que acontece sem ninguém clicar

Valores padrão; todos ajustáveis em Configurações. Sem internet, tudo o que é local continua; a nuvem retoma de onde parou quando a conexão volta.

• Verificação dos indicadores

  a cada 60 s

  O serviço pergunta a cada indicador conhecido se há pesagens novas e baixa o que faltar, e aproveita para executar a fila de tarefas pendentes (receitas, guias e autônomos a enviar). Cada comando espera até 30 s pela resposta. Além disso, toda vez que um indicador se anuncia na rede o download acontece na hora. A cada 30 minutos sem novidade, a memória inteira do indicador é relida para detectar se ela foi apagada e a numeração recomeçou.

• Ciclo da nuvem

  a cada 30 s

  Pesagens novas vão em lotes de até 500 registros. O ponto de leitura (cursor) só avança depois que o Rebanho 360 confirma o lote. Erro de rede ou do servidor: tenta no próximo ciclo. Registro recusado pelo conteúdo: é isolado em «Recusados», o resto segue, e o programa tenta reenviá-lo sozinho 1 h, 6 h, 24 h e 72 h depois.

• Cadastros, indicadores e eventos

  no mesmo ciclo

  O inventário de indicadores e a linha do tempo vão a cada ciclo; a fotografia dos cadastros só quando algo mudou.

• Comandos remotos

  no mesmo ciclo

  Comandos enfileirados no painel são executados uma única vez e o resultado volta ao painel. Comandos destrutivos ficam bloqueados por padrão.

• Heartbeat

  ao fim de cada ciclo

  Versão do software, cursores, quantidade de recusados e último erro. É o que o painel mostra em «Agente no PC da fazenda».

• Backup diário

  às 02:30

  Cópia consistente do banco na pasta backups, mantendo 30 dias. Horário e retenção são configuráveis. Um backup extra é feito antes de qualquer exclusão de pesagens.

• Limpeza de logs

  diária

  Arquivos de log por dia, mantidos por 30 dias.

Requisitos e portas

O que liberar no firewall

PC e indicadores precisam estar na mesma rede local. O aplicativo pode ser aberto de outro PC da fazenda se a API local for configurada para a rede.

Migração

Trocando o software anterior

1. 1No software anterior, baixe as pesagens dos indicadores uma última vez e faça o backup do banco.
2. 2Feche-o e desative a inicialização automática.
3. 3Instale o Rebanho360 Balança. Em Configurações, «Importar banco do software anterior» e escolha o arquivo do banco (.sql, .db) ou o backup .sql. Receitas, guias, lotes, estoque, custos e pesagens entram; nada é apagado.
4. 4Confira cadastros e estoque. Ligue um indicador: ele aparece em Indicadores e baixa as pesagens novas.
5. 5Envie os cadastros aos indicadores em «Sincronizar cadastros».
6. 6Gere o código em Dispositivos › Conectar Balança e digite-o em Configurações › Nuvem › «Conectar com código».

Solução de problemas

Sintoma e onde olhar

Indicador aparece mas «download falhou»

IP correto? Firewall do Windows liberando TCP 5000 de saída e UDP 5000 de entrada?

«Resposta incompleta» no download

Wi-Fi fraco; o indicador cortou a transmissão. Repita: o download continua de onde parou.

Estoque negativo

Estoque inicial não lançado. Em Estoque, use «Ajustar saldo».

Aviso «O Rebanho360 recusou o acesso deste PC»

O acesso foi revogado ou o dispositivo foi trocado no painel. Gere um código em Dispositivos › Conectar Balança e use «Conectar com código». As pesagens ficam guardadas no PC e sobem depois.

Registros em «Recusados»

A API rejeitou o conteúdo. O programa tenta de novo sozinho; se continuar, corrija na origem e clique em «Reenviar».

Porta 5000 indisponível nos eventos

Outro programa (quase sempre o software anterior da balança) está com a porta. Feche-o e tire da inicialização automática.

O serviço não sobe

Procure service-start-error.txt na pasta de dados: é um erro de configuração anterior ao log.

Logs em C:\ProgramData\Rebanho360\Balanca\logs, um arquivo por dia. Em Diagnóstico, «Copiar diagnóstico» junta versão, configuração (sem a chave de acesso), estado dos indicadores e últimos eventos para enviar ao suporte.

Segurança

Como os dados ficam protegidos

• A chave de acesso à nuvem chega pelo pareamento por código e fica só no arquivo de configuração, com permissão apenas para administradores e para o serviço. Nunca é gravada nos logs nem mostrada na tela. O código de pareamento vale 15 minutos e uma única vez.
• O aplicativo fala com o serviço por uma API local em 127.0.0.1 com um token aleatório de 48 caracteres gerado na instalação.
• Comandos que apagam dados (pesagens, cadastros, tarefas) são recusados por padrão, tanto pela porta de integração quanto pela nuvem. Só funcionam se liberados em Configurações.
• Apagar pesagens pelo aplicativo exige digitar APAGAR e gera um backup antes.
• O instalador ainda não tem assinatura digital; baixe sempre pelo painel do Rebanho 360.