Culturas
Quando usar
Use Culturas para cadastrar o modelo agronomico que sera usado nos planos de producao.
Pre-condicoes
- Login realizado.
- Organizacao selecionada.
- Recursos cadastrados quando a cultura exigir insumos ou materiais associados.
Dados de exemplo usados
- Cultura:
Alface Crespa Demo. - Ciclo: valor definido conforme a tela permitir.
- Recursos: insumos ficticios criados no modulo Recursos.
Passo a passo
Listar culturas
- Acesse
/:organizationId/crop/list. - Confira culturas existentes.
- Use a busca, filtros ou acoes disponiveis na tela quando existirem.

Resultado esperado: a lista mostra culturas cadastradas ou um estado vazio orientando o primeiro cadastro.
Cadastrar cultura
- Acesse
/:organizationId/crop/registerou use a acao de novo cadastro na lista. - Preencha nome, ciclo e demais campos obrigatorios exibidos.
- Salve a cultura.

Resultado esperado: a cultura fica disponivel para selecao em planos de producao.
Estagios
- Abra o cadastro ou edicao da cultura.
- Preencha os estagios de cultivo conforme a UI permitir.
- Salve as alteracoes.
Resultado esperado: os estagios ajudam a orientar tarefas e acompanhamento.
Tarefas
- Na tela da cultura, localize a secao de tarefas associadas.
- Cadastre tarefas como preparo, plantio, irrigacao ou colheita, conforme os campos disponiveis.
- Salve.
Resultado esperado: tarefas associadas podem alimentar o acompanhamento operacional quando usadas em planos.
Recursos
- Na tela da cultura, localize a secao de recursos ou insumos usados.
- Selecione recursos previamente cadastrados.
- Informe quantidades apenas se a tela solicitar.
Resultado esperado: a cultura fica preparada para calculos de consumo quando o fluxo de planejamento usar esses dados.
Editar cultura
- Acesse
/:organizationId/crop/register/:id. - Altere apenas os campos necessarios.
- Salve e volte para a listagem.
Resultado esperado: a lista reflete os dados atualizados.
Validacoes e acoes da listagem
- E obrigatorio ter pelo menos 1 estagio para salvar a cultura.
- O dia inicial (
start_day) de uma tarefa deve estar dentro do ciclo total da cultura. - A frequencia em dias (
frequency_days) de uma tarefa nao pode exceder o ciclo total. - A hora final de uma tarefa deve ser maior que a hora inicial.
- A listagem permite visualizar, editar, excluir (com checagem de dependencias) e exportar em Excel/PDF.
Erros e estados vazios
-
Campo obrigatorio ausente: preencha os campos destacados pela UI.
-
Recursos nao aparecem: cadastre categorias, fornecedores e recursos primeiro.
-
Lista de culturas vazia: acontece em organizacoes novas, antes do primeiro cadastro.
