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

v1.3.0 - Assinaturas & Analytics

🎉 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 /batch-transfers/ — Criar transferência
GET /batch-transfers/ — Listar transferências
GET /batch-transfers/{id} — Detalhes da transferência
GET /batch-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

🎯 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 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

✨ 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

✨ 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 →