Talhão
O que é um Talhão
Um talhão (ou parcela) é uma área de terra dentro de uma fazenda onde o cultivo é controlado de forma independente.
- Cada talhão é identificado pelo conjunto (fazenda, nome, data de início).
- Talhões com o mesmo nome na mesma fazenda só podem existir em datas de início diferentes (representam o histórico/reforma do mesmo talhão).
- Um talhão é considerado ativo quando não possui uma data de fim (
dt_end). - Ao ser encerrado/reformado, ele passa a ser um talhão inativo e um novo registro ativo assume o mesmo nome.
Ciclo de vida do Talhão
O talhão passa por estados ao longo do tempo. A seguir, os principais estados e as transições permitidas:
| Estado | Significado | Pode ir para |
|---|---|---|
| INICIAL | Talhão recém-criado, uso ainda não definido | AGRICULTURA, OUTRO |
| AGRICULTURA | Terreno em preparo para plantio (corte 0) | CANA_PLANTA, SEMI_PERENE, NAO_PERENE, com cobertura |
| AGRICULTURA_COBERTURA | Cultura de cobertura plantada | AGRICULTURA_POS_COBERTURA |
| AGRICULTURA_POS_COBERTURA | Cultura de cobertura já colhida | CANA_PLANTA, SEMI_PERENE, NAO_PERENE |
| AGRICULTURA_CANA_PLANTA | Cana-de-açúcar de 1º corte (cana-planta) | AGRICULTURA_CANA_SOCA |
| AGRICULTURA_CANA_SOCA | Cana-de-açúcar em cortes seguintes (soca) | AGRICULTURA_CANA_SOCA (loop), END |
| AGRICULTURA_SEMI_PERENE | Cultura semi-perene (ex.: café) em produção | AGRICULTURA_SEMI_PERENE (loop), END |
| AGRICULTURA_NAO_PERENE | Cultura não-perene (ex.: soja, milho) | END |
| OUTRO | Talhão com uso não produtivo (sede, pasto, etc.) | END |
| END | Talhão finalizado/encerrado (estado final) | — |
Principais transições
- Definir uso: um talhão INICIAL vira AGRICULTURA (uso produtivo) ou OUTRO (uso não produtivo).
- Plantar o primeiro cultivo: de AGRICULTURA (ou POS_COBERTURA) para CANA_PLANTA, SEMI_PERENE ou NAO_PERENE.
- Colher: avança o ciclo (cana planta → soca; soca continua em nova soca; semi-perene continua; não-perene encerra).
- Reformar uma cana/semi-perene: encerra o talhão (END) — o terreno volta a iniciar um novo ciclo.
- Encerrar um talhão OUTRO ou ao final do ciclo: vai para END.
Estados e Cortes (regras de coerência)
O "corte" (harv_idx) representa a quantidade de colheitas. As regras de coerência com o estado:
| Estado | Corte permitido |
|---|---|
| AGRICULTURA (preparo) | 0 |
| OUTRO (uso não produtivo) | 0 |
| CANA_PLANTA | 1 |
| CANA_SOCA | maior que 1 |
| SEMI_PERENE / NAO_PERENE | conforme o ciclo |
Nota (conforme o código): as regras de coerência somente são verificadas para os estados acima (corte 0 para AGRICULTURA/OUTRO, corte 1 para CANA_PLANTA e corte >1 para CANA_SOCA). Para os estados de cultura SEMI_PERENE e NAO_PERENE não há validação específica de corte.
Culturas e Ciclos
O tipo de cultura determina o comportamento do talhão ao longo das safras:
| Cultura | Código | Tipo de ciclo | Duração do ciclo | Comportamento na colheita |
|---|---|---|---|---|
| Cana-de-açúcar | CANE | Perene | ~365 dias (12 meses); reforma/preparo ~6 meses | Avança uma safra no mesmo talhão; a reforma encerra e recomeça |
| Café | COFF | Semi-perene | ~1095 dias (36 meses) | Avança safra no mesmo talhão |
| Milho | CORN | Não-perene | ~120 dias | Ao colher, encerra e o talhão reforma (novo ciclo) |
| Soja | SOY | Não-perene | ~120 dias | Ao colher, encerra e o talhão reforma (novo ciclo) |
Nota (conforme o código): ao criar um talhão não-perene já em corte (≥1), o estado é atribuído como SEMI_PERENE (não usa o estado
NAO_PERENE, que só é alcançado no plantio via Ordem de Serviço).
Regras de Criação
- Nome: obrigatório e único na fazenda (não pode haver talhão ativo com o mesmo nome; nem o mesmo nome com a mesma data de início).
- Área (AOI): geometria (MultiPolygon) válida, dentro dos limites da fazenda e sem sobrepor talhões ativos.
- Data de início: não pode ser no futuro.
- As datas do corte são derivadas automaticamente conforme o corte informado:
- Corte 0 (preparo): a data de início do talhão é a data de início do preparo.
- Corte 1 (cana-planta): o plantio ocorre um dia antes do início da safra.
- Cortes seguintes: as datas de safras anteriores são estimadas retroativamente.
Produtividade (TCH)
- TCH é a produtividade (toneladas de cana por hectare).
- TCH real: valor confirmado da última safra encerrada.
- TCH previsto: projeção para a safra atual (não encerrada).
- Ambos ficam registrados no talhão e por safra.
Regra de Encerramento
- Um talhão não pode ser encerrado duas vezes: se já possui data de fim, é bloqueado.
- Ao encerrar, o talhão recebe a data de fim e fica inativo.
- O mesmo vale para a última safra aberta do talhão.
Nota: fluxos de transição em uso
O sistema possui mais de um caminho para realizar as transições de safra do talhão:
- Via fechamento de ordem de serviço (OS): ao fechar uma OS de plantio ou colheita, o talhão avança de estado automaticamente (máquina de estados) — ver documento Ordem de Serviço.
- Via ação "Nova Safra / Reforma": um diálogo específico permite avançar a safra ou encerrar/reformar o talhão manualmente.
Ambos cumprem o mesmo objetivo (avançar o ciclo de safra) e seguem regras próximas de datas e estado.