Agrofy - Gestão Agrícola Maricá

Seja bem-vindo ao Protótipo Agrofy

Este ambiente é uma **visualização interativa do front-end** desenvolvida para demonstrar a experiência do usuário final. Esta interface foi projetada para consumir a **API RESTful** documentada na seção técnica deste portal, servindo como base para a implementação real do sistema de gerenciamento agrícola de Maricá.

Conectado ao Protótipo

Painel de Controle

Bem-vindo ao Agrofy. Esta seção oferece um panorama consolidado da sua infraestrutura, ciclos produtivos ativos e saúde financeira, permitindo uma tomada de decisão rápida e baseada em dados reais da sua propriedade em Maricá.

Lotes Ativos

0

Em ciclo de plantio

Alertas de Estoque

0

Itens abaixo do mínimo

Próxima Colheita

-

Previsão automática

Despesas (Mês)

R$ 0,00

Inclui Mumbuca convertida

Status das Safras por Cultura

Acompanhe a proporção de terra dedicada a cada tipo de plantio no momento.

Diário de Campo Recente

Últimas anotações registradas sobre o clima e pragas na região.

Infraestrutura e Propriedades

Gerencie as divisões físicas da sua terra. Mapear corretamente as propriedades nos distritos de Maricá e subdividi-las em Lotes/Canteiros é o primeiro passo para o controle de capacidade e aplicação de insumos.

Propriedades Cadastradas

Catálogo de Culturas

Biblioteca de maturação.

Mapeamento de Lotes (Canteiros)

Visão Detalhada

Gestão do Ciclo Produtivo

Acompanhe a vida de cada semente. Esta seção vincula suas culturas aos lotes, mostrando o status atual (Plantado, Em Crescimento, Colhido) e calculando automaticamente as janelas de colheita com base no catálogo.

Safras Ativas e Histórico

Lote	Cultura	Plantio	Previsão Colheita	Status	Ação

Estoque e Logística

Evite interrupções na produção. Monitore o volume de sementes e insumos agrícolas armazenados. O sistema gera alertas visuais para itens que precisam ser reabastecidos para o próximo ciclo.

Níveis de Estoque (Sementes vs Insumos)

Visão quantitativa dos itens armazenados. Barras vermelhas indicam estado crítico.

Almoxarifado

Administração e Finanças

Controle o custo real da sua produção. Registre despesas e visualize a proporção de gastos, com suporte nativo para separar transações feitas em Reais (BRL) e na moeda social de Maricá (Mumbuca).

Distribuição de Gastos

Impacto da Moeda Mumbuca nos custos operacionais da propriedade.

Fluxo de Despesas (Últimos 30 dias)

Documentação da API

Guia de referência para os desenvolvedores do Agrofy. Estes endpoints compõem o contrato de comunicação entre o backend (Node/Prisma) e o frontend (Flutter/Dashboard).

Fazendas e Lotes

GET /api/farms

Lista todas as propriedades rurais de Maricá.

POST /api/farm

Cria uma nova propriedade agrícola no sistema.

DELETE /api/farm/:id

Exclui permanentemente uma propriedade do sistema.

PATCH /api/farm/:id

Edita os dados cadastrais de uma fazenda.

GET /api/plots

Lista lotes vinculados a fazendas específicas.

POST /api/plot

Adiciona um novo lote a uma fazenda.

DELETE /api/plot/:id

Exclui um lote vinculado a uma fazenda.

PATCH /api/plot/:id

Edita as características de um lote existente.

Catálogo e Plantio

GET /api/crops

Retorna o catálogo completo de vegetais e ciclos.

POST /api/crop

Cadastra um novo tipo de cultura no catálogo.

DELETE /api/crop/:id

Exclui uma cultura do catálogo geral.

PATCH /api/crop/:id

Edita os detalhes de uma cultura (ex: tempo de maturação).

POST /api/seasons

Inicia um novo ciclo de plantio em um lote específico.

DELETE /api/season/:id

Exclui o registro de uma safra (ciclo produtivo).

PATCH /api/seasons/:id

Atualiza o status da safra (ex: marcar como "Colhido").

Almoxarifado e Capital

GET /api/inventory

Exibe o saldo atual de sementes e insumos.

POST /api/inventory

Registra entrada de novos materiais no estoque.

DELETE /api/inventory/:id

Deleta permanentemente sementes ou insumos do estoque.

PATCH /api/inventory/:id

Edita o saldo ou detalhes de um item no estoque.

GET /api/inventory/alerts

Lista itens com estoque abaixo do nível de segurança.

Administração e Diário

POST /api/finances/expenses

Registra uma nova conta paga ou gasto operacional.

GET /api/finances/summary

Gera resumo mensal de gastos em BRL e Moeda Mumbuca.

POST /api/logs

Registra um evento ou observação climática no diário de campo.

🛡️ Nota de Segurança

As operações de DELETE e PATCH requerem verificação de integridade no banco de dados para evitar orfandade de dados vinculados a safras históricas.

💡

Lembrete para o Time:

Todos os endpoints devem utilizar tratamento de erros centralizado e as respostas devem seguir o padrão JSON. O deploy da API está sendo configurado pela Pessoa 5 (DevOps).