Endpoints de Biometria

Visão Geral

A API de Biometria permite registrar e rastrear medições de crescimento de camarões incluindo amostras de peso, cálculos automáticos de métricas e análise de curva de crescimento.

Novo na v1.3.0

Sistema completo de rastreamento de biometria com medições baseadas em amostras, cálculos automáticos (peso médio, CV%) e análise de dados históricos.

Todos os endpoints requerem autenticação.

Authorization: Bearer <token>

---

POST /biometries/

Registrar uma nova medição de biometria para um lote.

Requisição

POST /api/v1/biometries/
Authorization: Bearer <token>
Content-Type: application/json

{
  "batch_id": "batch-uuid",
  "measurement_date": "2026-02-19T10:00:00Z",
  "sample_size": 100,
  "total_weight_g": 400.0,
  "notes": "Biometria semanal - boa uniformidade"
}

Parâmetros do Body

Campo	Tipo	Obrigatório	Descrição
batch_id	UUID	✅	ID do lote
measurement_date	datetime	✅	Data da medição (ISO 8601)
sample_size	integer	✅	Número de camarões amostrados
total_weight_g	float	✅	Peso total da amostra em gramas
notes	string	❌	Notas adicionais

Resposta 201 Created

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "batch_id": "batch-uuid",
  "measurement_date": "2026-02-19T10:00:00Z",
  "sample_size": 100,
  "total_weight_g": 400.0,
  "average_weight_g": 4.0,
  "coefficient_variation": 15.2,
  "days_in_production": 42,
  "notes": "Biometria semanal - boa uniformidade",
  "created_at": "2026-02-19T10:30:00Z"
}

Campos Calculados

Campo	Descrição	Fórmula
average_weight_g	Peso médio individual	Peso Total / Tamanho da Amostra
coefficient_variation	Indicador de uniformidade (CV%)	(Desvio Padrão / Média) × 100
days_in_production	Dias desde o início do lote	Data Atual - Data de Início

Nota

Coeficiente de Variação (CV%) indica uniformidade:

• CV < 20%: Excelente uniformidade
• CV 20-30%: Boa uniformidade
• CV > 30%: Uniformidade ruim (considere despesca seletiva)

---

GET /biometries/batch/{batch_id}

Obter o histórico completo de biometrias de um lote.

Parâmetros de Caminho

Parâmetro	Tipo	Descrição
batch_id	UUID	ID do lote

Requisição

GET /api/v1/biometries/batch/{batch_id}
Authorization: Bearer <token>

Resposta 200 OK

{
  "batch_id": "batch-uuid",
  "batch_number": "LOTE-2026-001",
  "biometries": [
    {
      "id": "biometry-uuid-1",
      "measurement_date": "2026-01-08T10:00:00Z",
      "days_in_production": 0,
      "sample_size": 100,
      "total_weight_g": 50.0,
      "average_weight_g": 0.5,
      "coefficient_variation": 12.5,
      "created_at": "2026-01-08T10:30:00Z"
    }
  ],
  "growth_summary": {
    "initial_weight_g": 0.5,
    "current_weight_g": 4.0,
    "total_growth_g": 3.5,
    "average_weekly_growth_g": 0.58,
    "total_measurements": 4
  }
}

---

Análise de Crescimento

Taxa de Crescimento Semanal (TCS)

Calcular o crescimento médio semanal:

TCS = (Peso Atual - Peso Anterior) / Dias × 7

Taxa de Crescimento Específico (TCE)

Calcular o crescimento percentual diário:

TCE = ((ln(Peso Final) - ln(Peso Inicial)) / Dias) × 100

---

Boas Práticas

Frequência de Amostragem

Fase de Produção	Frequência Recomendada
Berçário (0-30 dias)	Semanal
Engorda inicial (30-60 dias)	A cada 10 dias
Engorda final (60+ dias)	A cada 14 dias

Diretrizes de Tamanho de Amostra

Tamanho do Viveiro	Tamanho de Amostra Recomendado
< 0.5 ha	50-100 indivíduos
0.5-1 ha	100-150 indivíduos
> 1 ha	150-200 indivíduos

Dicas para Medições Precisas

1. Horário consistente: Meça no mesmo horário do dia
2. Amostragem aleatória: Colete de diferentes áreas do viveiro
3. Período de jejum: Meça 3-4 horas após a alimentação
4. Manuseio adequado: Minimize o estresse durante a coleta
5. Calibração de equipamento: Use balanças calibradas

---

GET /biometries/batch/{batch_id}/summary

Obtém resumo de biometria com estatísticas de crescimento para um lote.

Parâmetros de Path

Parâmetro	Tipo	Descrição
batch_id	UUID	ID do lote

Requisição

GET /api/v1/biometries/batch/{batch_id}/summary
Authorization: Bearer <token>

Resposta 200 OK

{
  "batch_id": "batch-uuid",
  "batch_number": "LOTE-2026-001",
  "total_biometries": 6,
  "summary": {
    "initial_weight_g": 0.5,
    "current_weight_g": 12.8,
    "weight_gain_g": 12.3,
    "days_in_production": 45,
    "adg": 0.27,
    "expected_adg": 0.15,
    "performance_percentage": 180.0,
    "average_cv": 15.2,
    "uniformity_rating": "EXCELLENT"
  },
  "latest_biometry": {
    "id": "biometry-uuid",
    "measurement_date": "2026-02-19T10:00:00Z",
    "sample_size": 100,
    "average_weight_g": 12.8,
    "coefficient_variation": 14.5
  },
  "growth_trend": "ACCELERATING",
  "recommendations": [
    "Taxa de crescimento está excelente. Práticas de manejo atuais são efetivas.",
    "Considere despesca seletiva se CV% exceder 25%."
  ]
}

Campos do Resumo

Campo	Descrição
adg	Ganho Diário Médio (g/dia)
expected_adg	ADG esperado baseado na espécie
performance_percentage	Desempenho real vs esperado
average_cv	Coeficiente de Variação médio
uniformity_rating	EXCELLENT, GOOD ou POOR
growth_trend	ACCELERATING, STEADY ou DECLINING