← Todos os projetosAll projects

Individual · Usado na fazendaSolo · Used on the farm

Sistema-Gado

Sistema de gestão para a fazenda da minha família: rebanho, fluxo de caixa e cotações num só lugar.A management system for my family’s farm: herd, cash flow and market prices in one place.

Animais no rebanhoHead of cattle
235base de demonstraçãodemo database
Ganho de peso médioAverage weight gain
0,730kg por animal, por diakg per animal, per day
Engordando poucoGaining too little
17animais identificados pelo sistemaanimals flagged by the system
Valor do rebanho ativoActive herd value
R$ 433 milcalculado pelas cotações do diafrom the day’s market prices

ProblemaProblem

O controle do rebanho era feito em planilhas, que não calculavam o GMD (ganho médio diário de peso) de cada animal nem cruzavam as pesagens com o fluxo de caixa. Na prática, o produtor não sabia quais animais estavam crescendo abaixo do esperado. Num rebanho em que cada cabeça vale perto de R$ 2.000, um animal que não engorda passa meses consumindo pasto e suplemento sem dar retorno.

Herd records lived in spreadsheets that didn’t calculate each animal’s ADG (average daily weight gain) or cross-reference weigh-ins with cash flow. In practice, the farmer couldn’t tell which animals were growing below target. When each head is worth close to R$ 2,000, an animal that isn’t gaining weight spends months eating pasture and supplements with no return.

Decisão principal: cálculos no banco, não no PythonKey decision: compute in the database, not in Python

O GMD de cada animal sai de uma única view: duas window functions marcam a primeira e a última pesagem, e o ganho é dividido pelo intervalo de dias. Em vez de trazer tudo para a memória do Flask e iterar animal por animal, uma view (v_gmd_analitico) usa CTE e window function e devolve o resultado pronto. O mesmo vale para o fluxo de caixa (v_fluxo_caixa, um UNION de compras, vendas, custos e medicações) e para as outras views do sistema.

Each animal’s ADG comes out of a single view: two window functions mark the first and last weigh-in, and the weight gain is divided by the number of days between them. Instead of loading everything into Flask and looping animal by animal, a view (v_gmd_analitico) uses a CTE and a window function and returns the finished result. The same goes for cash flow (v_fluxo_caixa, a UNION of purchases, sales, costs and medications) and the system’s other views.

Por isso descartei o ORM. Ele trocaria uma query legível de 40 linhas por várias chamadas de método gerando SQL equivalente, só que mais difícil de ler e de otimizar com índices. O schema é versionado com yoyo-migrations, em SQL puro e com uma política de só adicionar.

That’s why I dropped the ORM. It would have replaced a readable 40-line query with several method calls generating equivalent SQL that’s harder to read and to tune with indexes. The schema is versioned with yoyo-migrations, in plain SQL, with an additive-only policy.

CREATE OR REPLACE VIEW v_gmd_analitico AS
WITH pesagens_ordenadas AS (
    SELECT animal_id, data_pesagem, peso,
        ROW_NUMBER() OVER (PARTITION BY animal_id ORDER BY data_pesagem ASC)  AS rn_asc,
        ROW_NUMBER() OVER (PARTITION BY animal_id ORDER BY data_pesagem DESC) AS rn_desc
    FROM pesagens WHERE deleted_at IS NULL
),
primeira_ultima AS (
    SELECT animal_id,
        MAX(data_pesagem) FILTER (WHERE rn_asc  = 1) AS data_inicial,
        MAX(peso)         FILTER (WHERE rn_asc  = 1) AS peso_inicial,
        MAX(data_pesagem) FILTER (WHERE rn_desc = 1) AS data_final,
        MAX(peso)         FILTER (WHERE rn_desc = 1) AS peso_final
    FROM pesagens_ordenadas GROUP BY animal_id
)
SELECT a.user_id, a.id AS animal_id, a.brinco, p.peso_final,
    (p.peso_final - p.peso_inicial)  AS ganho_total,
    (p.data_final  - p.data_inicial) AS dias,
    -- gmd fica NULL quando todas as pesagens são do mesmo dia
    CASE WHEN (p.data_final - p.data_inicial) > 0
         THEN (p.peso_final - p.peso_inicial) / (p.data_final - p.data_inicial)
         END AS gmd
FROM primeira_ultima p
JOIN animais a ON p.animal_id = a.id
WHERE a.deleted_at IS NULL;

A view que calcula o GMD de cada animal (migrations/0001.baseline-schema.sql). O CASE no fim evita divisão por zero em animais com pesagens só na mesma data. Esse caso quebrava a conta quando ela ainda rodava no Python.The view that computes each animal’s ADG (migrations/0001.baseline-schema.sql). The trailing CASE avoids dividing by zero for animals whose weigh-ins are all on the same date. That case used to break the math back when it ran in Python.

StackStack

  • Flask: leve, sem ORM, porque o SQL puro era o requisito central
  • PostgreSQL: window functions, views materializadas e índices parciais para o GMD
  • Redis: cache
  • Playwright: geração de PDF no servidor
  • Flask-Limiter: limite de requisições no login e na exportação
  • Railway: container e PostgreSQL gerenciado no mesmo provedor, enquanto o sistema esteve hospedado
  • Flask: lightweight, no ORM, since plain SQL was the core requirement
  • PostgreSQL: window functions, materialized views and partial indexes for ADG
  • Redis: caching
  • Playwright: server-side PDF generation
  • Flask-Limiter: rate limiting on login and export
  • Railway: container and managed PostgreSQL from one provider, while the system was hosted

ResultadoOutcome

O sistema rodou em produção na fazenda da família. O deploy foi encerrado porque a hospedagem não se pagava para um punhado de usuários; o projeto roda localmente e o código continua aberto. Números da base de demonstração:

The system ran in production on the family farm. The deployment was retired because hosting didn’t pay for itself with a handful of users; the project runs locally and the code stays open. Figures from the demo dataset:

Animais no rebanhoHead of cattle235
GMD médioAverage ADG0,730 kg/diaday
Animais abaixo do GMD mínimoAnimals below minimum ADG17 (< 0,395 kg/diaday)
Valor do rebanho ativoActive herd valueR$ 433.640,87
Praças de cotação monitoradasPrice markets tracked33

O painel lista direto os brincos dos 17 animais abaixo do GMD mínimo, algo que a planilha não mostrava.

The dashboard lists the ear tags of the 17 animals below minimum ADG, something the spreadsheet never showed.

Tela de rebanho do Sistema-Gado
Tela de rebanho.Herd screen.
Tela financeira do Sistema-Gado
Fluxo de caixa.Cash flow.

Próximos passosNext steps

  • Alertas de pesagem atrasada e de parto previsto
  • Carência pós-medicação avisando antes de o animal ser vendido
  • Permissões por papel (dono, gerente, vaqueiro) e convite de equipe
  • Relatório de DRE completo
  • Geração de PDF numa fila separada, para não segurar a requisição
  • Alerts for overdue weigh-ins and expected calving
  • Post-medication withdrawal period warning before an animal is sold
  • Role-based permissions (owner, manager, farmhand) and team invites
  • Full income statement report
  • PDF generation moved to a separate queue, so it stops holding the request

Próximo projetoNext project

Gado-Scraper →

Todo dia um programa busca o preço do boi em 33 regiões e arquiva o resultado.Every day a program fetches cattle prices from 33 regions and files the result.

Vamos conversarLet’s talk

Estou procurando estágio em desenvolvimento, remoto ou presencial em Maceió. Se quiser falar sobre este projeto ou sobre uma vaga, é só escrever.I’m looking for a development internship, remote or on-site in Maceió. If you want to talk about this project or about a role, just write.