Bem-vindo à Documentação da Plataforma CarbonBR

Sobre esta documentação

Esta documentação reúne o conhecimento da Plataforma CarbonBR — uma plataforma de gestão agrícola voltada ao controle de áreas de cultivo, operações de campo e insumos, com apoio a relatórios de sustentabilidade (Renovabio).

Ela é a fonte de consulta para todos os usuários da plataforma:

Usuários operacionais (operadores, supervisores e gestores de fazenda), que usam o sistema no dia a dia.
Time de negócios e produtos, que precisa entender os fluxos, as regras e o comportamento da plataforma.
Suporte técnico, que orienta os usuários quanto a custos, permissões e funcionamento de cada módulo.
Desenvolvedores, que utilizam estes documentos para manter e evoluir o sistema.

O conteúdo descreve o funcionamento real da plataforma, com as regras validadas diretamente no código. Isso apoia treinamentos, orienta o uso no cotidiano, alinha expectativas entre as áreas e orienta a análise de novos projetos e melhorias.

O que você encontra nesta documentação

Organização — a instância principal da plataforma (o cliente). Dono de todos os dados, com suas configurações e opções (incluindo o consumo automático de insumos).
Fazenda — a divisão de área dentro da organização, onde ficam os talhões. Inclui os dados de cadastro, o modelo de propriedade e a relação com os talhões.
Talhão — a unidade de cultivo. Descreve o ciclo de vida, os estados, as culturas, os cortes e a produtividade (TCH).
Ordem de Serviço (OS) — a operação agrícola executada sobre os talhões, seu ciclo (abertura, edição e encerramento) e o efeito que a operação gera no talhão.
Entrada de Insumo — o registro da chegada de produtos (insumos) ao estoque, com seus efeitos sobre a quantidade disponível, os preços e o consumo.
Cálculo de Custos — como o custo de uma operação é apurado, por Atividade de Talhão, em três categorias: insumos, combustível e despesas.
Perfis e Permissões — o controle de acesso da plataforma: quais perfis existem, o que cada permissão habilita e o que fica oculto para usuários sem acesso total (incluindo valores monetários).

Como a plataforma se conecta

Os temas desta documentação se relacionam e, lidos em conjunto, mostram o fluxo completo da plataforma:

A Organização possui Fazendas.
As Fazendas possuem Talhões, que seguem um ciclo de vida de cultivo.
As operações de campo são realizadas via Ordem de Serviço, executada nos talhões.
Os insumos aplicados nas operações entram na plataforma pelas Entradas de Insumo, que alimentam o estoque, os preços e o consumo.
Os custos das operações são apurados a partir das ordens de serviço, dos insumos e do combustível/despesas (ver Cálculo de Custos).
O que cada usuário consegue ver e acessar é definido pelo Perfis e Permissões — inclusive a visibilidade de custos e valores monetários.

Esse encadeamento — do cadastro da organização até o registro das operações, insumos e custos — é o que permite à plataforma acompanhar toda a cadeia agrícola de ponta a ponta.