Manual do Usuário — TepConfina¶

Sistema de Gestão de Confinamento Bovino Versão 1.1 · Tecnoepec

Sumário¶

1. Acesso ao Sistema
2. Visão Geral da Interface
3. Dashboard
4. Lotes
5. Animais
6. Pesagens
7. Rações
8. Estoque de Insumos
9. Produtores
10. Mercado e Preços
11. Simulador de Hedge
12. Previsão Inteligente de Venda
13. Financeiro
14. Relatórios
15. Agente IA
16. Alertas de Preço
17. Notificações
18. Usuários
19. Perfis e Permissões
20. Aplicativo Mobile
21. Perguntas Frequentes
22. Protocolo Sanitário
23. Importação via Excel
24. Auditoria

1. Acesso ao Sistema¶

Web¶

Acesse https://tepconfina.tecnoepec.com.br em qualquer navegador moderno (Chrome, Firefox, Edge, Safari).

Recomendação: Altere a senha padrão no primeiro acesso em Usuários → Editar → Alterar Senha.

Login¶

1. Informe o e-mail e a senha cadastrados.
2. Clique em Entrar.
3. Caso esqueça a senha, entre em contato com o administrador do sistema para redefinição.

2. Visão Geral da Interface¶

┌──────────────────┬──────────────────────────────────────────┐
│                  │  Header: usuário, notificações, busca    │
│   Sidebar        ├──────────────────────────────────────────┤
│   (menu lateral) │                                          │
│                  │   Área de conteúdo principal             │
│   • Dashboard    │                                          │
│   • Lotes        │                                          │
│   • Animais      │                                          │
│   • ...          │                                          │
└──────────────────┴──────────────────────────────────────────┘

• Sidebar — Navegação principal. Pode ser recolhida clicando na seta ‹ (desktop).
• Header — Exibe o usuário logado, sino de notificações e busca rápida (Ctrl+K).
• Breadcrumb — Caminho atual exibido no topo de cada página.
• Paginação — Todas as listas paginam com 20 registros por página.
• Busca — Campo de pesquisa presente em todas as listas principais.

3. Dashboard¶

O Dashboard exibe um resumo executivo da operação:

Gráficos¶

• Evolução de Peso — Linha com pesagens dos últimos meses.
• Custo por Categoria — Pizza com distribuição: ração, medicamentos, outros.
• Preço Mercado — Cotação do boi gordo (CEPEA) em tempo real.

Os dados do dashboard são atualizados automaticamente a cada 30 segundos via conexão em tempo real (SignalR).

4. Lotes¶

O lote é a unidade central do sistema. Representa um grupo de animais em confinamento.

Listar Lotes¶

Acesse Lotes no menu lateral. A lista exibe:

• Nome do lote
• Data de entrada
• Número de animais
• Peso médio
• GMD
• Status (Ativo / Finalizado)

Use o campo de busca para filtrar por nome. Use os filtros para filtrar por status ou raça.

Criar Lote¶

1. Clique em Novo Lote.
2. Preencha os campos:

1. Clique em Salvar.

Detalhe do Lote¶

Ao clicar em um lote, você acessa suas abas:

Encerrar Lote¶

Na aba Resumo, clique em Finalizar Lote para registrar o abate. Informe: - Data de abate - Peso de abate (arroba) - Preço de venda (R$/arroba)

O sistema calculará automaticamente o resultado financeiro.

Exportar Relatório PDF¶

Em qualquer detalhe de lote, clique no botão Exportar PDF para gerar o relatório completo do lote em PDF, incluindo todos os custos, pesagens e resultado.

5. Animais¶

Cadastro individual de animais. Todo animal é obrigatoriamente vinculado a um lote.

Acessar¶

• Menu Animais — lista global com filtros (Todos / Ativos / Mortos / Vendidos), busca por brinco/lote e botões de cadastro.
• Detalhe do lote → aba Animais — visão por lote específico, mesmas ações.

Cadastrar animal individualmente¶

1. Clique em Novo Animal (canto superior direito).
2. Selecione o Lote ativo no dropdown.
3. Informe Brinco (obrigatório), Sexo (Macho/Fêmea) e Peso Entrada (kg, opcional).
4. Clique em Adicionar.

Cadastrar muitos animais de uma vez (em lote)¶

1. Clique em Cadastro em Lote (botão cinza ao lado de "Novo Animal").
2. Selecione o Lote ativo.
3. Cole a lista de brincos no textarea, um por linha:

   B001
   B002
   B003
   

4. Clique em Criar Animais.
5. O sistema mostra quantos foram criados e quais brincos foram ignorados por duplicação (já existiam no tenant).

Campos do animal¶

Ações por animal¶

Na linha de cada animal, ícones permitem:

• 🛒 Registrar Venda (azul) — informa data, peso saída, valor/@, rendimento de carcaça e comprador.
• 💀 Registrar Mortalidade (vermelho claro) — informa data e causa.
• 🗑️ Excluir (vermelho) — remove o animal (soft delete).

6. Pesagens¶

Registro de pesagens periódicas para acompanhamento do GMD.

Lançar Pesagem¶

1. No detalhe do lote, acesse a aba Pesagens.
2. Clique em Lançar Pesagem.
3. Informe:
4. Data da pesagem
5. Peso médio atual (kg)
6. Observações (opcional)
7. Clique em Salvar.

O sistema calcula automaticamente: - GMD = (Peso atual − Peso anterior) ÷ Dias - Arrobas atuais = Peso médio ÷ 15

Histórico¶

A aba exibe todas as pesagens com data, peso, GMD e variação percentual.

7. Rações¶

Gerenciamento do catálogo de rações e lançamento de consumo.

Cadastrar Ração¶

1. Acesse Rações → Nova Ração.
2. Informe nome, fabricante, tipo e custo por kg.
3. Salve.

Lançar Consumo¶

Na aba Ração do lote:

1. Clique em Registrar Consumo.
2. Selecione a ração, informe a data e a quantidade consumida (kg).
3. O sistema calcula o custo automaticamente.

Consumo por Animal¶

O sistema exibe o consumo médio por animal por dia (kg/cab/dia) e o custo correspondente.

8. Estoque de Insumos¶

Controle de estoque de ração e outros insumos.

Funcionalidades¶

• Entrada de estoque — Registra compra de insumos com quantidade e valor.
• Saída — Vincula ao consumo do lote.
• Saldo atual — Exibe o estoque disponível por produto.
• Alertas de estoque mínimo — Avisa quando o saldo fica abaixo do mínimo configurado.

9. Produtores¶

Cadastro dos produtores proprietários dos animais.

Criar Produtor¶

1. Acesse Produtores → Novo Produtor.
2. Informe nome, CPF/CNPJ, telefone, e-mail e endereço.
3. Salve.

Os produtores podem ser vinculados a lotes para rastreabilidade de propriedade.

10. Mercado e Preços¶

Acompanhamento da cotação do Boi Gordo Futuro B3 (BGI) em tempo real.

Fonte dos dados¶

Layout da página Mercado¶

1. Cards de resumo (topo): preço atual do BGI1!, média 7 dias, média 30 dias — todos em R$/@.
2. Painel "Ajustar preço da arroba" (cinza, abaixo dos cards): campo opcional para você informar o preço praticado na sua região (CEPEA local, frigorífico, etc.). Se preenchido, sobrescreve o BGI nos cálculos do hedge e da previsão de venda. Deixe em branco para voltar a usar o BGI.
3. Gráfico Candlestick próprio — candles diários OHLC do BGI1! (90 dias), renderizado a partir do nosso banco. Sem dependência de widget externo.
4. Simulador de Hedge, Decision Card, Hedge Ladder e Histórico de Hedge (próxima seção).

Override manual do preço¶

O override é salvo localmente no seu navegador (não é compartilhado entre usuários). Use quando:

• O BGI futuro está descolado do preço físico que você consegue na sua região.
• Você quer simular cenários com preços hipotéticos.
• Quer travar a previsão de venda em um valor de referência.

Para limpar, deixe o campo em branco e clique Salvar override.

11. Simulador de Hedge¶

Ferramentas para análise e operação de hedge no contrato BGI da B3. Todas estão na página Mercado, abaixo do gráfico.

11.1. Simulador de Hedge — Boi Futuro B3¶

Calcula quantos contratos BGI vender para travar o preço de um lote.

1. Selecione um Lote ativo no dropdown (preenche automaticamente cabeças e arrobas/cabeça com base no GMD atual) ou preencha manualmente.
2. Ajuste:
3. Quantidade de animais
4. Arrobas por cabeça (@)
5. % do lote a travar (slider 0–100%)
6. Modo de hedge: Conservador (floor — menos contratos), Balanceado (round), Proteção Máxima (ceil)
7. Clique em Calcular Hedge.
8. O sistema retorna:
9. Arrobas totais e arrobas protegidas
10. Contratos teóricos (fração) e contratos sugeridos (inteiro, conforme modo)
11. Cobertura real (% efetivo)
12. Exposição residual (descoberto ou sobreprotegido)
13. Valor total protegido (R$) — usa o preço da arroba atual (BGI ou override manual)
14. Recomendação operacional em texto pleno

11.2. Momento Ideal de Trava (Decision Engine)¶

Engine de decisão com 5 critérios ponderados que retorna um score 0–100 e uma recomendação categórica.

Informe:

• Preço alvo de trava (R$/@) — onde você gostaria de travar
• Preço físico local (R$/@) — preço praticado na sua região
• Custo total por arroba (R$/@) — break-even
• Margem meta por arroba (R$/@) — quanto quer ganhar acima do custo

Pesos dos critérios:

Resultado:

• TRAVAR AGORA (verde) — score ≥ 75
• TRAVAR PARCIAL (laranja) — score 60–74
• ATENÇÃO (azul) — score 40–59
• AGUARDAR (cinza) — score < 40

O card mostra também as barras de cada critério, base atual, distância ao alvo e tendência.

11.3. Hedge Ladder¶

Sugere uma escada de travas progressiva: ao invés de travar 100% num só preço, divide a operação em faixas (por exemplo: 25% em R$ 360, 25% em R$ 365, 25% em R$ 370, 25% em R$ 375). Reduz o risco de travar tudo no pior momento e aproveita movimentos favoráveis.

A escada é gerada automaticamente a partir do score do Decision Engine e do preço atual.

11.4. Histórico de Hedge¶

Lista todas as operações de hedge registradas pelo seu tenant (contratos vendidos, datas, preços, P&L estimado vs preço atual). Permite registrar nova operação manualmente para acompanhamento.

12. Previsão Inteligente de Venda¶

Card no Dashboard que mostra o resultado projetado de cada lote ativo se você vender hoje, considerando 3 cenários de preço:

Aparece automaticamente quando o preço da arroba está disponível (BGI ativo ou override manual) e o tenant tem lotes ativos.

13. Financeiro¶

Visão financeira consolidada da operação.

Resumo Financeiro¶

Categorias de Custo¶

• Compra de animais — Valor pago pelos bezerros/bois
• Ração — Consumo total de ração
• Medicamentos — Vacinas e tratamentos
• Suplementos — Minerais e vitaminas
• Arrendamento — Custo da pastagem/confinamento
• Outros — Despesas diversas (frete, energia, etc.)

Exportação¶

Clique em Exportar Excel ou Exportar PDF para baixar o relatório financeiro.

14. Relatórios¶

Central de relatórios gerenciais.

Relatórios Disponíveis¶

Como Gerar¶

1. Acesse Relatórios.
2. Selecione o tipo de relatório.
3. Defina o período ou filtros.
4. Clique em Gerar PDF ou Exportar Excel.

15. Agente IA¶

Assistente inteligente integrado ao ChatGPT/Claude para análise da operação.

Como Usar¶

1. Acesse Agente IA no menu.
2. Digite sua pergunta em linguagem natural. Exemplos:
3. "Qual lote tem o melhor GMD este mês?"
4. "Qual o custo de ração por arroba produzida no Lote A?"
5. "Calcule o resultado financeiro se vender a R$ 280/arroba"
6. "Faça um resumo da operação atual"
7. O agente consulta os dados do seu confinamento e responde com análise contextualizada.

O agente tem acesso somente aos dados do seu tenant (empresa). Dados de outros clientes nunca são compartilhados.

16. Alertas de Preço¶

Configure alertas automáticos para ser notificado quando o preço do boi gordo atingir determinados valores.

Criar Alerta¶

1. Acesse Alertas no menu.
2. Clique em Novo Alerta.
3. Configure:
4. Tipo: Preço acima de / Preço abaixo de
5. Valor: Preço em R$/arroba
6. Indicador: Boi Gordo CEPEA ou Futuro B3
7. Salve.

Recebimento¶

Quando o preço atingir o valor configurado: - Notificação push no app mobile - Notificação in-app (sino no header)

17. Notificações¶

Central de todas as notificações do sistema.

Acesse clicando no sino no header ou pelo menu Notificações.

Clique em uma notificação para ir diretamente ao item relacionado. Use Marcar todas como lidas para limpar o contador.

18. Usuários¶

Gerenciamento dos usuários da sua empresa. (Disponível para perfil Admin)

Criar Usuário¶

1. Acesse Usuários → Novo Usuário.
2. Informe nome, e-mail, perfil e senha inicial.
3. Salve.

O usuário receberá acesso imediato com as permissões do perfil selecionado.

Editar Usuário¶

• Clique no ícone de lápis na lista de usuários.
• Você pode alterar nome, perfil, status (Ativo/Inativo) e senha.

Desativar Usuário¶

Para remover o acesso sem excluir o histórico, edite o usuário e mude o status para Inativo.

19. Perfis e Permissões¶

Restrições por Perfil¶

20. Aplicativo Mobile¶

O TepConfina possui aplicativo nativo para Android e iOS.

Download¶

• Android: Disponível na Google Play Store (em breve)
• iOS: Disponível na App Store (em breve)

Funcionalidades Mobile¶

• Dashboard com indicadores em tempo real
• Lançamento de pesagens em campo
• Consulta de lotes e animais
• Alertas de preço via push notification
• Consumo de ração
• Funcionamento offline — dados sincronizados ao retornar a cobertura de rede

Login Mobile¶

Use o mesmo e-mail e senha do sistema web. A sessão é mantida de forma segura no dispositivo.

21. Perguntas Frequentes¶

Como altero minha senha? Acesse Usuários, encontre seu usuário, clique em Editar e use o campo Nova Senha.

O sistema funciona sem internet? O app mobile suporta modo offline para consulta e lançamentos. O sistema web requer conexão ativa.

Como exporto os dados para o Excel? Em qualquer lista ou na página de Relatórios, clique em Exportar Excel.

Os dados de outras empresas aparecem para mim? Não. O sistema é multi-tenant: cada empresa (tenant) visualiza exclusivamente seus próprios dados.

O que é GMD? Ganho Médio Diário — indica quantos kg o animal ganhou por dia no período. Calculado como: GMD = (Peso Final − Peso Inicial) ÷ Número de Dias

O que é uma arroba? Unidade de medida de peso para bovinos: 1 arroba = 15 kg de peso vivo.

Como funciona o hedge? O hedge é uma operação no mercado futuro da B3 para travar o preço de venda do boi gordo. O simulador calcula se vale a pena travar o preço com base nos seus custos e margem desejada.

Esqueci minha senha, como recupero? Entre em contato com o administrador da sua empresa (perfil Admin) para redefinição. Se o Admin esquecer a senha, contate o suporte Tecnoepec.

Suporte¶

22. Protocolo Sanitário¶

O calendário sanitário permite agendar e rastrear vacinas, vermífugos, vitaminas e outros procedimentos veterinários por lote.

Acessar: dentro do detalhe do lote, clique na aba Sanitário.

Criar protocolo¶

1. Clique em Novo Protocolo
2. Informe:
3. Produto — nome do medicamento (ex: Aftosa, Ivermectina)
4. Tipo — Vacina, Vermifugo, Vitamina, Antibiotico ou Outro
5. Data Prevista — quando o procedimento deve ser realizado
6. Dose (mL) e Custo por animal — opcionais, usados para controle financeiro
7. Clique em Salvar

Marcar como realizado¶

1. Clique em Realizar no protocolo desejado
2. Informe a data de realização e confirme

Protocolos com data vencida e não realizados são destacados em vermelho como alerta.

23. Importação via Excel¶

Permite importar pesagens em massa sem digitar linha a linha.

Acesse: menu Importação na barra lateral.

Passo a passo¶

1. Baixar template — clique em "Baixar template de pesagens" para obter o modelo .xlsx
2. Preencher — abra o arquivo e preencha as colunas:
3. LoteNome — nome exato do lote ativo
4. Data — no formato YYYY-MM-DD (ex: 2025-06-01)
5. PesoMedio_kg — peso médio em kg (ex: 420.5)
6. QuantidadeAnimais — opcional; se omitido, usa a quantidade cadastrada no lote
7. Observacoes — opcional
8. Selecionar arquivo — clique na área de upload e escolha o arquivo .xlsx preenchido
9. Importar — clique em "Iniciar importação"

O sistema exibe quantas pesagens foram importadas e lista as linhas com erro (se houver), sem interromper as demais.

24. Auditoria¶

O log de auditoria registra todas as ações de escrita realizadas no sistema (criação, edição e exclusão).

Acesse: menu Auditoria (visível apenas para Admin e SuperAdmin).

Filtros disponíveis:

• Método — POST, PUT, PATCH ou DELETE
• Usuário — filtrar por e-mail do usuário
• Período — intervalo de datas

Cada entrada exibe: método, rota acessada, código de resposta, usuário, IP de origem, duração e horário.

TepConfina — Gestão Inteligente de Confinamento Bovino © 2025 Tecnoepec. Todos os direitos reservados.