Histórico de Versões

📜 Histórico de Versões

Acompanhe todas as atualizações, novos recursos e correções de bugs da API Aera+.

---

📋 Tabela de Versões

Versão	Data de Lançamento	Status	Destaques
v1.3.0	Fev 2026	🟢 Atual	Assinaturas, Dashboard, IoT, Exportações
v1.2.0	Jan 2026	🟡 Estável	IA Financeira, Lotes, Viveiros
v1.1.0	Out 2025	🔴 Legado	Qualidade da Água, Alimentação
v1.0.0	Ago 2025	🔴 Legado	Lançamento Inicial

---

b1.3.10 - Simplificacao do Payload de Transferencia (2026-03-25)

• POST /transfers/ agora exige apenas: batch_id, from_pond_id, to_pond_id
• transfer_date, population_count e avg_weight viraram opcionais e podem ser calculados automaticamente
• Campos manuais como reason e notes foram removidos do modelo de entrada

b1.3.9 - Padronizacao de Descricoes em Ingles (2026-03-17)

• Descricoes de endpoints e docstrings foram padronizadas em ingles no backend

b1.3.8 - IDs obrigatorios movidos para path (2026-03-17)

• Rotas com ID obrigatorio deixaram de usar query e passaram a usar path param
• Exemplos:
  • GET /biometries/{batch_id}
  • GET /feeding/{batch_id}/summary
  • GET /water-quality/{pond_id}/latest
  • GET /exports/biometries/{batch_id}/csv
  • GET /storage/products/{farm_id}

b1.3.7 - Correcao do Fluxo de Geocoding da Fazenda (2026-03-17)

• Endereco passou a aceitar latitude e longitude
• Criacao de fazenda ignora geocoding quando coordenadas sao enviadas pelo cliente

b1.3.6 - Correcao de Tamanho de Revisao de Migration (2026-03-17)

• Corrigido erro de truncamento de revisao do Alembic (StringDataRightTruncation)
• IDs de migration renomeados para versoes menores
• Admin padrao passa a receber limites ilimitados (-1)

b1.3.5 - Limpeza de Comentarios Superficiais (2026-03-17)

• Comentarios redundantes removidos de controllers/services/utils

b1.3.4 - Ajuste de Terminologia em Transferencias (2026-03-15)

• Documentacao e mensagens de transferencia padronizadas em ingles
• Terminologia alinhada de Tank para Pond

b1.3.3 - Melhorias de Registro de Alimentacao (2026-03-14)

• Novos campos no feeding:
  • meals_per_day (auto incremento por lote/dia)
  • feeding_method (BROADCAST, TRAY, AUTOMATIC)
  • acceptance_notes
  • photo_url

b1.3.2 - Endpoints de Estoque e Inventario (2026-03-14)

• Novo modulo de estoque:
  • POST /storage/products
  • GET /storage/products/{farm_id}
  • PUT /storage/products/{product_id}
  • POST /storage/movement
  • GET /storage/products/{product_id}/history

b1.3.1 - Redesign MVP do Dashboard Overview (2026-03-11)

• GET /dashboard/overview redesenhado para a home
• Novos campos:
  • top_batch, worst_batch, top_pond
  • biomass_chart, biomass_growth_percentage
  • critical_alerts
• Campos antigos removidos para reduzir payload

---

v1.3.0 - Assinaturas & Analytics

Data de Lançamento: 19 de Fevereiro de 2026

Atualização principal introduzindo sistema de assinaturas, análises abrangentes, notificações e recursos avançados de gerenciamento de produção.

🎉 Principais Recursos

💳 Sistema de Assinaturas com Integração Stripe

Gerenciamento completo de assinaturas com quatro níveis (GRATUITO, BÁSICO, PROFISSIONAL, EMPRESARIAL), aplicação automática de limites, flags de funcionalidades e processamento seguro de pagamentos.

Novos Endpoints:

• GET /subscriptions/me — Obter assinatura atual
• GET /subscriptions/me/limits — Obter limites de uso
• GET /subscriptions/plans — Listar planos disponíveis
• PUT /subscriptions/{user_id} — Atualizar assinatura (admin)
• POST /stripe/create-checkout-session — Criar sessão de pagamento
• POST /stripe/create-billing-portal — Acessar portal do cliente
• POST /stripe/cancel-subscription — Cancelar assinatura

---

📊 Dashboard Analytics

Sistema de dashboard abrangente com insights em tempo real incluindo visão geral da fazenda, resumos de viveiros, tendências de biomassa, taxas de crescimento, taxas de sobrevivência e eficiência alimentar.

Novos Endpoints:

• GET /dashboard/overview — Estatísticas da fazenda
• GET /dashboard/ponds — Resumos detalhados de viveiros
• GET /dashboard/biomass-trend — Dados históricos de crescimento
• GET /dashboard/growth-rates — Análise de crescimento
• GET /dashboard/survival-rates — Rastreamento de população
• GET /dashboard/feed-efficiency — Análise de FCA

---

🔔 Sistema de Notificações

Sistema de notificações em tempo real para alertas, eventos do sistema, atualizações de assinatura e confirmações de pagamento.

Novos Endpoints:

• GET /notifications/ — Listar notificações
• GET /notifications/unread/count — Contador de não lidas
• PATCH /notifications/{notification_id}/read — Marcar como lida
• POST /notifications/mark-all-read — Marcar todas como lidas

---

📏 Rastreamento de Biometria

Sistema completo de medição de biometria com cálculos automáticos (peso médio, CV%), análise de curva de crescimento e rastreamento histórico.

Novos Endpoints:

• POST /biometries/ — Registrar medição
• GET /biometries/batch/{batch_id} — Obter histórico
• GET /biometries/batch/{batch_id}/summary — Estatísticas do lote

---

💧 Monitoramento de Qualidade da Água

Monitoramento avançado de qualidade da água com alertas automatizados para temperatura, OD, pH, amônia, nitrito e outros parâmetros.

Novos Endpoints:

• POST /water-quality/ — Registrar medição
• GET /water-quality/pond/{pond_id} — Obter histórico
• GET /water-quality/latest — Últimas leituras por viveiro
• GET /water-quality/alerts — Alertas ativos
• GET /water-quality/trend/{pond_id}/{parameter} — Tendências de parâmetros

---

🍤 Gerenciamento de Alimentação

Sistema abrangente de registro de alimentação com cálculos automáticos de FCA, rastreamento de custos e integração com estoque.

Novos Endpoints:

• POST /feeding/ — Registrar evento de alimentação
• GET /feeding/batch/{batch_id} — Obter histórico
• GET /feeding/batch/{batch_id}/summary — Obter estatísticas
• GET /feeding/batch/{batch_id}/recommendation — Recomendações de IA

---

📦 Transferência de Lotes

Sistema completo para transferir lotes entre viveiros com rastreamento de custos e histórico.

Novos Endpoints:

• POST /transfers/ — Criar transferência
• GET /transfers/{transfer_id} — Detalhes da transferência
• GET /transfers/batch/{batch_id} — Histórico por lote

---

📤 Sistema de Exportação

Exportação de dados em formato CSV para biometrias, alimentação, qualidade da água e relatórios de lotes.

Novos Endpoints:

• GET /exports/biometries — Exportar biometrias
• GET /exports/feeding — Exportar alimentação
• GET /exports/water-quality — Exportar qualidade da água
• GET /exports/batch-report/{batch_id} — Relatório completo do lote

---

🌐 Dispositivos IoT

Integração com dispositivos ESP32 para monitoramento de heartbeat e gerenciamento de shadow state.

Novos Endpoints:

• POST /iot/heartbeat — Registrar heartbeat do dispositivo
• GET /iot/shadow/{device_id} — Obter shadow state
• PUT /iot/shadow/{device_id} — Atualizar shadow state

---

📈 Análise de Crescimento

Novos endpoints para análise detalhada do crescimento dos lotes.

Novos Endpoints:

• GET /batches/{id}/growth-analysis — Análise completa de crescimento
• GET /batches/{id}/growth-chart — Dados para gráficos
• GET /ponds/summary-cards — Cards de resumo dos viveiros
• GET /ponds/{pond_id}/summary-card — Card individual

---

🐛 Correções de Bugs

• Serialização de Schema: Corrigidos problemas de serialização de propriedades do Pydantic v2
• Comparação de Enum: Resolvida comparação de enum BatchStatus no controller de alimentação
• Formato do Dashboard: Corrigida estrutura de resposta do endpoint de eficiência alimentar
• Schema de Assinatura: Adicionados campos atualizáveis ausentes
• Cálculo de FCA: Corrigida precisão nos cálculos de recomendação de alimentação
• Timezone: Resolvidos problemas de timezone nos alertas de qualidade da água
• Paginação: Corrigida paginação na listagem de lotes

---

v1.2.0 - Módulos Inteligentes

Data de Lançamento: 8 de Janeiro de 2026

Atualização de Módulos Inteligentes — Lançamento principal introduzindo análises alimentadas por IA, otimização de produção e gerenciamento financeiro abrangente para operações de carcinicultura.

🎯 Novos Módulos & Endpoints

💰 Módulo de Análise Financeira

Sistema completo de gerenciamento financeiro com suporte de decisão alimentado por IA para maximizar a lucratividade.

Novos Endpoints:

• POST /financial/expenses — Registrar despesas operacionais

  • Suporte para 9 categorias: RAÇÃO, MÃO DE OBRA, ENERGIA, MANUTENÇÃO, SUPRIMENTOS, TRATAMENTO, TRANSPORTE, EQUIPAMENTO, OUTROS

• GET /financial/cost-per-kg/{batch_id} — Calcular custo de produção por kg

  • Detalhamento por tipo de despesa
  • Fórmula: Custo por Kg = (Custo de Ração + Custo Operacional) / Biomassa

• GET /financial/profitability/{batch_id} — Análise de lucratividade

  • Margem de lucro, ROI, receita projetada

• GET /financial/optimal-harvest/{batch_id} — 🤖 Otimização de colheita por IA

  • Recomendações: CONTINUE, HARVEST_NOW ou MONITOR

---

🦐 Módulo de Gerenciamento de Lotes

Rastreamento completo do ciclo de produção desde o povoamento até a colheita.

Novos Endpoints:

• POST /batches — Criar novo lote de produção
• GET /batches/{batch_id} — Detalhes do lote
• GET /batches — Listar todos os lotes
• PUT /batches/{batch_id} — Atualizar lote
• DELETE /batches/{batch_id} — Remover lote

Recursos Principais:

• Cálculo automático de biomassa: (População × Peso Médio) / 1000
• Rastreamento de taxa de crescimento
• Cálculos de taxa de sobrevivência
• Suporte a FCA

---

🏊 Módulo de Gerenciamento de Viveiros

Sistema abrangente de configuração e monitoramento de viveiros.

Novos Endpoints:

• POST /ponds — Criar viveiro
• GET /ponds/{pond_id} — Detalhes do viveiro
• GET /ponds — Listar viveiros
• PUT /ponds/{pond_id} — Atualizar viveiro
• DELETE /ponds/{pond_id} — Remover viveiro

Recursos Principais:

• Validação de densidade de estocagem
• Cálculos de volume de água
• Rastreamento de capacidade de aeração

---

🤖 Recursos de IA & Inteligência

Algoritmo de Colheita Ideal

Motor de decisão que analisa taxa de crescimento, preço de mercado e custos operacionais para maximizar o lucro.

Painel de Inteligência Financeira

Análises financeiras em tempo real com custo por kg, margem de lucro e projeções de ROI.

Otimização de Produção

Insights orientados por dados para rastreamento de biomassa, eficiência alimentar e taxas de sobrevivência.

---

📊 Melhorias

• Modelo de Dados: Rastreamento completo do ciclo de vida de produção
• Integridade Relacional: Vinculação fazendas → viveiros → lotes → financeiro
• Cálculos Automáticos: Biomassa, crescimento, custos em tempo real
• 9 Categorias de Despesas: Rastreamento granular de custos
• Parâmetros de Consulta: Filtros e classificação em todos os endpoints
• Tratamento de Erros: Mensagens descritivas com erros em nível de campo

---

🔄 Migração & Compatibilidade

Mudanças Incompatíveis

Esta versão introduz novos relacionamentos obrigatórios. Dados existentes podem precisar de scripts de migração.

Mudanças no Banco de Dados:

• Novas tabelas: batches, ponds, financial_expenses
• Novos relacionamentos: ponds → farms, batches → ponds, expenses → batches

Compatibilidade da API:

• Endpoints existentes da v1.0.0 permanecem funcionais
• Novos endpoints usam prefixo /api/v1/
• Autenticação JWT inalterada

---

v1.1.0 - Qualidade da Água & Alimentação

Data de Lançamento: Outubro de 2025

Introdução de monitoramento de qualidade da água e gerenciamento de alimentação.

✨ Novos Recursos

• 💧 Qualidade da Água: Monitoramento completo com OD, pH, temperatura, salinidade
• 🍤 Gerenciamento de Alimentação: Cálculos de FCA e agendamentos de alimentação
• 🔔 Alertas Automáticos: Notificações para parâmetros críticos

🔧 Melhorias

• Suporte multi-fazenda
• Melhorias na organização de viveiros
• Padronização de respostas da API

---

v1.0.0 - Lançamento Inicial

Data de Lançamento: Agosto de 2025

Primeira versão pública da API Aera+.

✨ Recursos Iniciais

• 🏭 Gerenciamento de Fazendas
• 🏊 Gerenciamento de Viveiros básico
• 📦 Rastreamento de Lotes
• 📏 Biometria básica
• ⚙️ Pontos de Controle de Aeradores
• 👤 Autenticação de Usuários com JWT
• 📋 Sistema de Logs de Auditoria

---

🔗 Links Úteis

Página Inicial

Voltar para a documentação principal.

Ir →

Roadmap

Veja o que está por vir.

Explorar →