Sistema de Gestão para Propriedades Leiteiras

1

Visão do produto

O sistema não é um controle financeiro com um cadastro de animais anexado, nem uma versão web da planilha. É uma plataforma que conecta decisões zootécnicas ao resultado econômico, no realizado e na projeção.

As três cadeias causais que o motor de cálculo precisa preservar de ponta a ponta:

O diferencial competitivo está em tornar essas cadeias navegáveis: cair a taxa de prenhez precisa reduzir, automaticamente e de forma rastreável, os partos futuros, as vacas em lactação, a produção, a receita, o fluxo de caixa e o resultado econômico projetado.

2

Origem: a planilha como modelo de negócio

A planilha é tratada como fonte das regras de negócio e motor de cálculo, não como fonte de layout. Cada aba se converte em um domínio do sistema:

3

Princípios de modelagem (regras invioláveis)

1. Nunca gravar apenas o estado atual quando o histórico for relevante — categoria, lote, peso, dieta e preço são séries temporais.
2. Dieta antiga nunca é sobrescrita; alteração cria nova vigência.
3. Preço histórico nunca é sobrescrito.
4. DRE histórica não é recalculada com cadastro atual sem versionamento explícito.
5. Todo lançamento pertence a uma propriedade e a um tenant.
6. Identificador de animal (brinco) é único dentro da propriedade.
7. Valores financeiros em NUMERIC/DECIMAL — nunca float.
8. Toda quantidade carrega unidade explícita (kg, kg MS, litros, ha, t, cabeças).
9. Datas com timezone correto; competência ≠ caixa.
10. Simulações são versionadas e imutáveis após cálculo.
11. Fórmulas ficam em serviços de domínio testáveis — nunca em componentes de tela.
12. Todo indicador informa período, propriedade e origem (realizado/orçado/projetado).
13. Realizado e projetado nunca se misturam silenciosamente.
14. Exclusões são auditáveis: inativação com histórico, não DELETE.
15. Integridade preservada entre rebanho, produção, nutrição e financeiro.

4

Stack e arquitetura

Camadas

O motor de cálculo é executado no backend, de forma determinística e reproduzível: dadas as mesmas premissas e a mesma versão de cálculo, o resultado é sempre idêntico.

5

Multi-tenant, propriedades e permissões

Toda tabela central carrega tenant_id, property_id (quando aplicável), created_at, updated_at, created_by, updated_by e active. O isolamento é garantido por guard de tenant no backend e reforçado no banco (constraints e, opcionalmente, RLS).

Perfis

ProprietárioAdministradorGerente FinanceiroVeterinárioZootecnista NutricionistaReproduçãoOperacional ContadorConsultorSomente leitura

Permissões granulares por recurso e ação (ler, criar, editar, excluir, aprovar, exportar), com vínculo usuário↔propriedade em user_properties. Um usuário pode acessar uma propriedade, várias, ou toda a organização.

6

Modelo de dados — entidades principais

Cerca de 45 tabelas no núcleo, mais tabelas auxiliares de domínio (protocolos, sêmen, técnicos, parâmetros de qualidade, feriados de cálculo).

7

Módulo — Cadastros básicos

8

Módulo — Rebanho

Cadastro individual com genealogia (mãe/pai), origem, entrada, categoria, lote, status reprodutivo e produtivo, número de lactação, peso e saída (venda, morte, descarte) com motivo e valor.

Categorias: BezerraBezerroNovilha Novilha inseminadaNovilha prenheVaca seca Vaca em lactaçãoVaca descarteTouro

Cada mudança de categoria, lote e peso gera registro histórico com start_date/end_date, permitindo reconstruir a composição do rebanho em qualquer data passada — requisito da aba Rebanho.

Indicadores

Total do rebanho · vacas adultas · em lactação · secas · novilhas · bezerras · taxa de reposição · taxa de descarte · mortalidade · idade média · idade ao primeiro parto · distribuição por ordem de lactação.

9

Módulo — Reprodução

Eventos reais alimentam os mesmos índices que servem de premissa às projeções: o realizado calibra o projetado.

Eventos: cio · liberação para IA · inseminação artificial · monta · protocolo hormonal · diagnóstico de gestação · confirmação · perda de prenhez · aborto · parto · secagem.

Perda de prenhez por faixa (modelo da planilha)

Esses percentuais são premissas editáveis por cenário e, no realizado, calculados a partir dos eventos.

Indicadores

Taxa de serviço · taxa de concepção · taxa de prenhez · serviços por concepção · dias em aberto · intervalo entre partos · perdas gestacionais · taxa de aborto · vacas elegíveis · vazias · prenhes · previsão de partos.

Alertas

Diagnóstico pendente · retorno de cio · animal acima do período voluntário de espera · parto próximo · secagem próxima · gestação sem confirmação.

10

Módulo — Partos e bezerros

calvings: ordem do parto, tipo, dificuldade, número de crias, retenção de placenta, complicações. calves: peso ao nascimento, sexo, colostro (data, quantidade, qualidade), desmame (data e peso).

Indicadores: peso ao nascimento · mortalidade de bezerras · idade ao desmame · peso ao desmame · ganho médio diário. Alimentam diretamente o custo de recria e a projeção de reposição.

11

Módulo — Lactação

A aba Curva lactação vacas vira motor de acompanhamento produtivo, com curvas distintas para primíparas e multíparas e comparação entre curva real e curva esperada.

Indicadores: produção/vaca/dia · por lote · total · DEL médio · pico · dias até o pico · persistência · produção acumulada · produção 305 dias · primíparas × multíparas.

12

Módulo — Produção e venda de leite

Registro de ordenha (por ordenha, por vaca ou por lote, conforme a realidade da fazenda) e venda com composição completa de preço: preço bruto, bonificações, penalizações, frete, impostos, preço líquido, valor bruto e líquido, data de pagamento.

Qualidade

Gordura · proteína · CCS · CBT · lactose · ureia · crioscopia e demais parâmetros do laticínio, ligados às bonificações do contrato.

13

Módulo — Nutrição e dietas

Representa as abas Dieta mensal, Demanda mensal, Demanda anual, Gasto anual alimentação e Custo alimentar — o maior volume de fórmulas da planilha (~46 mil células).

ingredients: nome, categoria, unidade, matéria seca, PB, NDT, energia, custo padrão, fornecedor padrão. diets: nome, categoria animal, lote, vigência. diet_items: kg/animal/dia, kg MS, custo unitário, custo diário.

14

Módulo — Estoque

stock_items com estoque mínimo, atual e custo médio; stock_movements com entrada, saída e ajuste, quantidade, custo, fornecedor, documento, lote, validade e destino.

O consumo previsto pela dieta pode gerar baixa automática ou estimada, com conciliação posterior contra a compra real.

Alertas: estoque mínimo · dias de estoque · previsão de ruptura · validade · necessidade de compra.

15

Módulo — Área, forragem e agricultura

Representa Necessidade Área e Demanda de área forragem. Parâmetros da planilha incluem consumo de volumoso por vaca (8,5 kg MS/dia), consumo de recria, concentrado de recria (1,8 kg) e produtividade de silagem de milho (13,5 a 14,4 t MS/ha, evoluindo ao longo dos anos).

fields (talhões), crops (plantio, colheita prevista/realizada, produtividade prevista/real, área plantada) e forage_production (cultura, área, toneladas, MS, custo, silo/destino).

Exemplo de alerta: “Demanda projetada de silagem superior à produção estimada em 210 toneladas.”

16

Módulo — Financeiro

financial_transactions unifica contas a pagar e a receber, com competência e caixa separadas, rateio por centro de custo e vínculo opcional a animal, lote ou cultura — o que permite custo por atividade sem lançamento duplicado.

Campos: tipo, competência, emissão, vencimento, pagamento, categoria/subcategoria, fornecedor/cliente, descrição, documento, valor, valor pago, desconto, juros, multa, forma de pagamento, conta bancária, centro de custo, vínculos operacionais, status, recorrência, anexos.

Status: PrevistoAberto Parcialmente pagoPagoVencido Cancelado

Recursos: contas a pagar e a receber, fluxo de caixa (realizado e projetado), competência × caixa, recorrências, anexos, conciliação bancária, filtros e exportação.

17

Módulo — DRE e custo de produção

A DRE é calculada a partir do plano de contas e dos lançamentos, nunca digitada.

Cada linha exibe: R$, R$/litro, % da receita (AV), orçamento, realizado, variação R$ e variação %. Filtros por mês, trimestre, ano, propriedade, centro de custo e consolidado.

Custo de produção

Custo operacional efetivo · custo operacional total · custo total · variável · fixo · alimentar · mão de obra · reprodução · sanidade · energia · manutenção · administrativo · depreciação · custo financeiro.

Indicadores: R$/litro · R$/vaca · R$/vaca em lactação · R$/hectare · % da receita. A aba Referências Custos 2018 vira base de benchmark (pasto × confinamento) para comparação.

18

Módulo — Custo de recria

Cálculo por categoria e fase, com acúmulo até o primeiro parto.

Resultados: custo da novilha ao primeiro parto · custo por dia · custo por fase · idade ao primeiro parto · capital imobilizado na recria. Referência da planilha: concentrado a R$ 4.361,75/animal/ano, ~60,7% do custo de recria.

19

Módulo — Patrimônio e inventário de animais

assets: categoria, descrição, data e valor de aquisição, valor atual, valor residual, vida útil em meses, método e início da depreciação, status. Categorias: terra, benfeitorias, instalações, ordenha, resfriamento, máquinas, tratores, implementos, veículos, equipamentos, culturas permanentes, outros.

A depreciação gerencial alimenta automaticamente a DRE e a análise econômica.

Inventário de animais

Ligado ao rebanho real, com valorização por categoria, valor individual, preço médio ou valor de mercado. Referências da planilha: bezerras 0–1 ano (150 kg, R$ 1.700), novilhas 1–2 anos (300 kg, R$ 3.000), novilhas acima de 2 anos (420 kg, R$ 5.000). Apresenta quantidade, valor unitário, valor total e evolução patrimonial do rebanho ano a ano.

20

Módulo — Investimentos e financiamentos

21

Módulo — Análise econômica

Painel derivado da aba Análise econômica, cruzando patrimônio, resultado e escala produtiva.

22

Módulo — Simulador PNL Diferencial

O coração do produto: reproduz e supera o que a planilha faz hoje, com cenários versionados e comparáveis.

Cenários: BaseConservador OtimistaPersonalizado

Premissas parametrizáveis

Número inicial de animais · produção média · curva de lactação · taxa de serviço · taxa de concepção · taxa de prenhez · perda de prenhez · descarte · mortalidade · idade ao primeiro parto · preço do leite · dieta · preço dos ingredientes · inflação · produtividade agrícola · área · investimentos · custos fixos · mão de obra.

Saídas do recálculo

Evolução do rebanho · vacas em lactação · produção · receita · consumo · custo alimentar · necessidade de área · custo de produção · investimentos · fluxo de caixa · DRE · patrimônio · indicadores econômicos — em série mensal e anual.

23

Motor de cálculo

Regras complexas nunca ficam no frontend. Serviços de domínio isolados, puros e testáveis:

Documentação de fórmulas

Cada fórmula relevante da planilha é catalogada individualmente com: nome · descrição · entradas · saída · unidade · periodicidade · dependências · regra · exemplo numérico · teste unitário. Esse catálogo é entregável do projeto e serve de contrato entre o consultor técnico e o desenvolvimento.

24

Dashboard principal e alertas

Central de alertas

Contas vencidas · estoque crítico · vacas para diagnóstico · vacas para secagem · partos previstos · animais sem produção registrada · desvio de produção frente à curva esperada · déficit de forragem projetado.

25

Relatórios

Evolução do rebanho · inventário · reprodução · prenhez · partos · lactação · produção · qualidade do leite · dieta · consumo · estoque · custo alimentar · custo de produção · custo de recria · despesas por fornecedor · despesas por categoria · fluxo de caixa · DRE · patrimônio · investimentos · financiamentos · análise econômica · realizado × orçamento · comparativo de cenários.

Exportação: PDF, Excel e CSV, com cabeçalho de propriedade, período e origem dos dados.

26

Auditoria e segurança

audit_log: usuário, data/hora, entidade, id da entidade, ação, valor anterior, valor novo, IP, dispositivo.

Informações financeiras e zootécnicas relevantes não são excluídas definitivamente — usa-se cancelamento/inativação com histórico. Complementam a segurança: senhas com hash forte, política de sessão e refresh token, rate limiting, validação de entrada em todos os endpoints, backup diário com teste de restauração e LGPD (dados de pessoas físicas em fornecedores, clientes e usuários).

27

Migração e importação da planilha

1. Propriedades
2. Plano de contas
3. Fornecedores e clientes
4. Lançamentos históricos
5. Premissas (reprodução, curva, dieta, preços, produtividade)
6. Inventário de animais
7. Patrimônio
8. Projeções, quando necessário

import_batches registra arquivo, data, usuário, linhas lidas, linhas importadas, erros e status, com relatório de rejeições e possibilidade de reprocessar apenas as linhas com erro.

28

API — endpoints principais

Padrões: versionamento /api/v1, paginação e filtros consistentes, documentação OpenAPI/Swagger, respostas de erro padronizadas e cabeçalho de tenant/propriedade resolvido pelo token. A API já nasce preparada para integração futura com equipamentos de ordenha, ERPs, bancos, laticínios e aplicativos móveis.

29

Fases e cronograma

Sequência recomendada, com entregas utilizáveis ao fim de cada fase. As durações são estimativas de referência para um time enxuto (1 backend, 1 frontend, apoio de consultoria zootécnica/econômica) e devem ser confirmadas no planejamento detalhado.

30

Entregáveis

31

Qualidade e critério de validação

O critério objetivo de aceite do motor de cálculo:

Sugestão de tolerância: diferença relativa ≤ 0,5% em indicadores agregados (produção anual, custo alimentar, DRE, fluxo de caixa) e ≤ 0,1% em cálculos determinísticos diretos (demanda de ingrediente, área necessária). Divergências acima da tolerância são investigadas e resultam em correção do sistema ou em correção documentada da planilha — em alguns casos a planilha contém erros que o sistema não deve reproduzir.

Cobertura mínima recomendada: 80% de testes unitários nos serviços do motor de cálculo, 100% das fórmulas do catálogo com pelo menos um caso de teste com valores reais.

32

Infraestrutura e deploy

33

Riscos e premissas

Premissas do escopo

• A planilha permanece disponível como fonte de verdade durante toda a engenharia reversa.
• Há um interlocutor técnico (zootecnista/consultor) para validar regras e resultados.
• O produtor-piloto fornece dados reais para validação em homologação.
• Idioma: português do Brasil; moeda: real; unidades do sistema métrico.

34

Fora de escopo desta fase

• Emissão de documentos fiscais (NF-e, NFP-e) e integração contábil fiscal.
• Folha de pagamento e gestão de RH.
• Integração automática com coletores de ordenha, balanças e colares — a API é preparada, a integração é projeto próprio.
• Aplicativo móvel nativo (a aplicação web é responsiva e utilizável em tablet/celular).
• Open Finance e conciliação bancária automática por API bancária (a conciliação é por importação de extrato).
• Módulo de IA generativa e recomendações — previsto para a fase 6, com escopo definido separadamente.