Regras de Negocio¶

Formulas, calculos e regras de negocio do sistema TepConfina.

Calculos de Peso¶

Peso Medio¶

O peso medio e calculado dividindo o peso liquido total pela quantidade de animais:

PesoMedio = PesoLiquido / QuantidadeAnimais

Peso em Arrobas¶

A conversao de quilogramas para arrobas utiliza o fator padrao de 15 kg:

PesoArroba = Peso / 15

Rendimento de Carcaca¶

Percentual do peso vivo que se converte em carcaca apos o abate:

RendimentoCarcaca = (PesoCarcaca / PesoVivo) * 100

Faixas de Referencia¶

Ganho em Arrobas¶

Calculo do ganho liquido em arrobas durante o periodo de confinamento:

GanhoArroba = (PesoSaida * RendimentoCarcaca/100 - PesoEntrada) / 15

GMD - Ganho Medio Diario¶

Taxa de ganho de peso diario entre duas pesagens:

GMD = (PesoAtual - PesoAnterior) / DiasEntrePesagens

Faixas de Referencia GMD¶

Conversao Alimentar¶

Relacao entre a quantidade de racao consumida e o ganho de peso:

ConversaoAlimentar = KgRacaoConsumida / KgGanhoPeso

Faixas de Referencia¶

Break-even (Ponto de Equilibrio)¶

Calculo do preco minimo da arroba para cobrir os custos:

BreakEven = CustoTotal / QuantidadeAnimais / PrecoArroba

Onde CustoTotal inclui:

• Custo de aquisicao dos animais
• Custo total de racao consumida
• Custo de medicamentos aplicados
• Outros gastos operacionais

Regras de Fechamento de Lote¶

Ao fechar um lote, as seguintes regras sao aplicadas:

flowchart TD
    A[Fechar Lote] --> B{Dados de saida preenchidos?}
    B -->|Nao| C[Erro: Preencher PesoSaida e RendimentoCarcaca]
    B -->|Sim| D[Calcular KPIs finais]
    D --> E[GanhoArroba]
    D --> F[GMD final]
    D --> G[Conversao Alimentar]
    D --> H[Break-even]
    E --> I[Status = Fechado]
    F --> I
    G --> I
    H --> I
    I --> J[DataSaida = agora]
    J --> K[Lote nao pode mais ser editado]

Campos obrigatorios para fechamento¶

KPIs calculados automaticamente¶

GMD — Semáforo Visual¶

O frontend exibe um indicador colorido (verde/amarelo/vermelho) para sinalizar o desempenho do GMD em listagens e cards de lote.

A IA Proativa dispara alerta quando um lote fica vermelho por 3 pesagens consecutivas.

Margem Real (CompraLote)¶

Quando um lote tem múltiplas CompraLote, o custo de aquisição é rateado proporcionalmente ao peso de entrada de cada compra. Cada animal recebe um CustoAnimal.CustoCompra individual.

CustoAnimalIndividual = (PesoEntradaAnimal / PesoEntradaTotalDoLote) × ValorTotalCompras

A margem real de cada animal vendido é calculada como:

MargemReal = ValorVenda - CustoAnimal.CustoCompra - CustoOperacionalAcc

O CustoOperacionalAcc é incrementado proporcionalmente sempre que há lançamento de ração, medicamento, suplemento, arrendamento ou outros gastos no lote.

Hedge — Cálculos¶

Contratos BGI a vender¶

Cada contrato BGI da B3 representa 330 arrobas. Para travar uma fração % hedge de um lote:

ArrobasTotais = QuantidadeAnimais × ArrobasPorCabeca
ArrobasHedge = ArrobasTotais × (% hedge)
ContratosTeoricos = ArrobasHedge / 330
ContratosSugeridos = arredondamento(ContratosTeoricos, modo)

CoberturaReal = (ContratosSugeridos × 330) / ArrobasTotais
ExposicaoResidual = ArrobasTotais - (ContratosSugeridos × 330)

ExposicaoResidual positiva = lote ainda parcialmente descoberto. Negativa = sobreproteção.

Valor protegido¶

ValorProtegido = ContratosSugeridos × 330 × PrecoArrobaAtual

PrecoArrobaAtual vem do BGI1! ou do override manual da página Mercado.

Decision Engine — Momento Ideal de Trava¶

Score 0–100 calculado como média ponderada de 5 critérios, retorna recomendação categórica.

Pesos¶

Cálculo de cada critério (0–100)¶

ScorePreco — quanto mais próximo o preço atual do alvo, maior:

distanciaPct = (PrecoAlvo - PrecoAtual) / PrecoAlvo
ScorePreco = 100 - clamp(|distanciaPct| × 1000, 0, 100)

ScoreMargem — margem por arroba vs meta:

MargemArroba = PrecoFisicoLocal - CustoTotalPorArroba
ScoreMargem = clamp((MargemArroba / MargemMetaPorArroba) × 100, 0, 100)

ScoreBase — base é a diferença entre físico e futuro:

Base = PrecoFisicoLocal - PrecoAtual
basePct = Base / historicoBaseMedia (com proteção contra div/0)
ScoreBase = 50 + clamp(basePct × 30, -50, 50)

ScoreTendencia — comparação Média 7d vs 30d:

Se Media7d > Media30d × 1.02 → ScoreTendencia = 100 (alta forte)
Se Media7d > Media30d        → ScoreTendencia = 70  (leve alta)
Caso contrário              → ScoreTendencia = 30  (baixa)

ScoreVolatilidade — desvio padrão dos últimos N preços / média:

volatilidade = stddev(historicoPrecos) / mean(historicoPrecos)
Se volatilidade ≤ 0.01 → ScoreVolatilidade = 100 (estável, bom para travar)
Se volatilidade ≤ 0.02 → ScoreVolatilidade = 60
Caso contrário        → ScoreVolatilidade = 20

Score final e recomendação¶

ScoreFinal = ScorePreco × 0.35 + ScoreMargem × 0.30 + ScoreBase × 0.15
           + ScoreTendencia × 0.10 + ScoreVolatilidade × 0.10

Hedge Ladder — Escada de Travas¶

Quando o ScoreFinal está entre 40 e 75 (zona de incerteza), o sistema sugere uma escada progressiva em vez de travar tudo num só preço.

PrecoBase = PrecoArrobaAtual
NumeroDegraus = 4 (default)
EspacamentoDegrau = volatilidade × PrecoBase (mín. R$ 2,50)

Degrau[i] = PrecoBase + (i × EspacamentoDegrau)
% por degrau = (% hedge total) / NumeroDegraus

Exemplo com % hedge total = 80% e 4 degraus:

O usuário coloca ordens limit no broker em cada degrau. Quando a ordem dispara, a HedgeOperacao é registrada manualmente.

Conferência Visual — BCS (Body Condition Score)¶

Escala de 1 a 9 retornada pela análise da Claude Vision a partir de fotos do lote.

A análise também retorna contagem de cabeças (TF-Lite cattle_detector.tflite). Se a contagem diverge da QuantidadeAnimais esperada do lote em mais de 5%, o sistema gera um alerta para revisão manual.

Calibragem auto-ajustante¶

Se o usuário corrigir manualmente a contagem retornada pelo modelo, o threshold de confidence do TF-Lite é ajustado para o tenant (persistido no backend) — usa o feedback acumulado para calibrar:

NovoThreshold = ThresholdAtual × (1 + (ContagemReal - ContagemModelo) / ContagemReal × ajuste)

Onde ajuste = 0.1 (10% por feedback).

Volatilidade Histórica¶

Usada no Decision Engine. Calculada sobre os últimos N preços diários do índice ativo (default N=30):

mean   = sum(precos) / N
stddev = sqrt(sum((p - mean)²) / N) for p in precos
volatilidade = stddev / mean

Faixas para boi gordo BGI1!:

• ≤ 1% → mercado estável
• 1–2% → volatilidade normal
• > 2% → alta volatilidade (sugere aguardar antes de travar)