aegro-cadastro-patrimonio

name	aegro-cadastro-patrimonio
description	Guia para cadastrar e gerenciar patrimonios, abastecimentos e manutencoes
version	0.5.1

Cadastro de Patrimonio

Objetivo

Cadastrar ativos da fazenda (maquinas, veiculos, silos, benfeitorias, pivos, estacoes meteorologicas) e iniciar o tracking de abastecimentos e manutencoes.

Quando Usar

• Novo equipamento adquirido (trator, colheitadeira, pickup)
• Cadastrar frota existente no sistema
• Registrar abastecimento de combustivel
• Registrar manutencao preventiva ou corretiva
• Cliente pergunta "como cadastro meu trator?" ou "como registro abastecimento?"

Pre-requisitos

Carregue este domain skill antes de iniciar:

• /aegro-patrimonial — vocabulario, modelo de dados, regras de negocio e comandos de patrimonio

Fazenda deve estar selecionada.

Fluxo de Decisao - Tipo de Ativo

Qual tipo de patrimonio?
│
├── Maquina agricola (trator, colheitadeira, pulverizador, plantadeira)
│   └── assets create-machine --machine-type <TIPO>
│       Tipos: TRACTOR, HARVESTER, SPRAYER, PLANTER, FERTILIZER, TILLER, WAGON, OTHER
│       Se implemento acoplado (grade, subsolador): adicionar --is-implement
│
├── Veiculo (caminhao, pickup, utilitario)
│   └── assets create-vehicle
│       Usa hodometro (km), NAO horimetro
│
├── Silo / armazem
│   └── assets create-garner
│
├── Benfeitoria (barracao, oficina, casa)
│   └── assets create-immobilized
│
├── Pivo de irrigacao
│   └── assets create-pivot
│
└── Estacao meteorologica
    └── assets create-weather-station
        ATENCAO: Bug #6 impede criar weather-logs via API

Sequencia: Cadastrar Ativo

1. Verificar se o ativo ja existe

aegro assets list --types <TIPO>

Confirmar que nao ha duplicata pelo nome/fabricante.

2. Criar o patrimonio

# Exemplo: trator
aegro assets create-machine \
  --name "JD 8R 410" \
  --manufacturer "John Deere" \
  --machine-type TRACTOR \
  --manufacture-year 2023 \
  --value 1200000 --currency BRL \
  --hourmeter 1500

# Exemplo: veiculo
aegro assets create-vehicle \
  --name "Hilux CD 4x4" \
  --manufacturer "Toyota" \
  --manufacture-year 2024 \
  --value 320000 --currency BRL \
  --odometer 15000

3. Confirmar cadastro

aegro assets get <asset_key_retornada>

Campos obrigatorios por tipo:

• MACHINE: --name, --machine-type (obrigatorio, sem ele da 422)
• VEHICLE: --name
• GARNER/IMMOBILIZED/PIVOT/WEATHER_STATION: --name

Campos recomendados: --manufacturer, --manufacture-year, --value, --currency

Sequencia: Registrar Abastecimento

# Maquina (horimetro) | Veiculo: trocar --hourmeter por --odometer
aegro fuel-supplies create \
  --asset-key <asset_key> --date "2026-03-13" --hourmeter 1550 \
  --stock-location-key <stock_location_key> \
  --inputs '[{"elementKey": "element::combustivel", "quantity": 200}]'

Com stockLocationKey: baixa de estoque automatica. Sem ele: registro informativo apenas.

Sequencia: Registrar Manutencao

# Preventiva com pecas (adicionar --crop-prorate-group-key para ratear na safra)
aegro maintenances create \
  --asset-key <asset_key> --date "2026-03-12" --hourmeter 1545 \
  --stock-location-key <stock_location_key> \
  --observations "Revisao 500h" \
  --inputs '[{"elementKey": "element::filtro01", "quantity": 1}]'

Limitacoes Atuais

Bug	Impacto	Workaround
#3 fuel-supplies list → HTTP 500	Impossivel listar historico de abastecimentos	Usar fuel-supplies get <key> individual ou Aegro App
#4 maintenances list → HTTP 500	Impossivel listar historico de manutencoes	Usar maintenances get <key> individual ou Aegro App
#6 weather create → HTTP 500	Impossivel criar registros meteorologicos	Registrar pelo Aegro App

Consequencia: Apos cadastrar abastecimentos/manutencoes, guarde as chaves retornadas. Nao sera possivel listar posteriormente via CLI.

Formato de Resposta

Apresentar tabela com: Nome, Tipo, Fabricante, Ano, Valor, Chave. Sugerir proximos passos: primeiro abastecimento, manutencao preventiva.

Proximos Workflows

• Controlar estoque de pecas/combustivel → /aegro-reconciliacao-estoque
• Ratear manutencao para safra → /aegro-analise-rentabilidade
• Visao geral da fazenda → /aegro-visao-geral