스킬 파일

Aegro Patrimonial

Name: Aegro Patrimonial
Author: pmdusso

Dominio de patrimonio do Aegro - ativos, maquinas, veiculos, abastecimentos e manutencoes

pmdusso0 스타2026. 3. 18.

직업: 경영 분석가
카테고리: 부동산 및 법률

스킬 내용

Dominio Patrimonial

Referencia completa do dominio de patrimonio da Fazenda Aegro (farm::5711512de4b0e15eb04da4d0, ~67k ha). Cobre ativos (maquinas, veiculos, silos, benfeitorias, pivos, estacoes meteorologicas), abastecimentos de combustivel e manutencoes.

Vocabulario

Termo	Definicao	Formato da Chave
Asset (Patrimonio)	Bem da fazenda: maquina, veiculo, silo, benfeitoria, pivo ou estacao meteorologica	`asset::hexstring`
Fuel Supply (Abastecimento)	Evento de abastecimento de combustivel vinculado a um patrimonio	`fuelSupply::hexstring`
Maintenance (Manutencao)	Evento de manutencao vinculado a um patrimonio, pode consumir pecas do estoque	`maintenance::hexstring`
Horimetro	Contador de horas de operacao. Usado em MACHINE e PIVOT	Valor numerico (ex: 1550.5)

관련 스킬

Aegro Patrimonial | Skills Pool

Tipo	Descricao	Endpoint de Criacao	Medidor
`MACHINE`	Maquinas agricolas (tratores, colheitadeiras, pulverizadores, plantadeiras)	`assets create-machine`	Horimetro
`VEHICLE`	Veiculos (caminhoes, pickups, utilitarios)	`assets create-vehicle`	Hodometro (km)
`GARNER`	Silos e armazens de graos	`assets create-garner`	Horimetro
`IMMOBILIZED`	Benfeitorias (barracoes, oficinas, casas)	`assets create-immobilized`	Horimetro
`PIVOT`	Pivos de irrigacao	`assets create-pivot`	Horimetro
`WEATHER_STATION`	Estacoes meteorologicas	`assets create-weather-station`	—

FARM (farm::5711512de4b0e15eb04da4d0)
  │
  ├── ASSET (type: MACHINE)
  │     ├── machineType: TRACTOR, HARVESTER, SPRAYER, ...
  │     ├── currentHourmeter: 1550
  │     ├── isImplement: false
  │     ├── value: {currencyCode: "BRL", amount: 1200000}
  │     │
  │     ├── FUEL_SUPPLY (fuelSupply::...)
  │     │     ├── assetKey → referencia ao patrimonio
  │     │     ├── occurrenceDate: "2026-03-13"
  │     │     ├── hourmeterAtOccurrence: 1550
  │     │     ├── stockLocationKey → deposito de combustivel
  │     │     └── inputs: [{elementKey, quantity}]
  │     │
  │     └── MAINTENANCE (maintenance::...)
  │           ├── assetKey → referencia ao patrimonio
  │           ├── occurrenceDate: "2026-03-12"
  │           ├── hourmeterAtOccurrence: 1545
  │           ├── stockLocationKey → deposito de pecas
  │           └── inputs: [{elementKey, quantity}]
  │
  ├── ASSET (type: VEHICLE)
  │     ├── currentOdometer: 85000 (km)
  │     └── eventos usam odometerAtOccurrenceInKilometers
  │
  ├── ASSET (type: GARNER)
  │     └── Silo — sem eventos de combustivel tipicos
  │
  ├── ASSET (type: IMMOBILIZED)
  │     └── Benfeitoria — barracoes, oficinas
  │
  ├── ASSET (type: PIVOT)
  │     ├── currentHourmeter
  │     └── eventos de manutencao com horimetro
  │
  └── ASSET (type: WEATHER_STATION)
        └── WEATHER_LOG (registro climatico)
              ├── weatherStationKey → referencia a estacao
              ├── date: "2026-03-13"
              └── precipitation: {magnitude: 15.5, unit: "mm"}

Tipo	Comando CLI	Campos Especificos
MACHINE	`assets create-machine`	`--machine-type` (obrig.), `--hourmeter`, `--is-implement`
VEHICLE	`assets create-vehicle`	`--odometer` (km)
GARNER	`assets create-garner`	`--hourmeter`
IMMOBILIZED	`assets create-immobilized`	`--hourmeter`
PIVOT	`assets create-pivot`	`--hourmeter`
WEATHER_STATION	`assets create-weather-station`	`--hourmeter`

{"currencyCode": "BRL", "amount": 1200000.00}

--value 1200000 --currency BRL

Consumo (L/h) = Litros abastecidos / (Horimetro atual - Horimetro anterior)

200L / (1550 - 1500) = 4.0 L/h

{
  "inputs": [
    {"elementKey": "element::combustivel01", "quantity": 200},
    {"elementKey": "element::filtro01", "quantity": 2}
  ]
}

Tipo do Asset	Campo no evento	Unidade
MACHINE	`hourmeterAtOccurrence`	Horas
PIVOT	`hourmeterAtOccurrence`	Horas
VEHICLE	`odometerAtOccurrenceInKilometers`	Km
GARNER	`hourmeterAtOccurrence`	Horas
IMMOBILIZED	`hourmeterAtOccurrence`	Horas

Comando	Descricao	Flags Principais
`aegro assets get <key>`	Busca patrimonio por chave	`--output`
`aegro assets list`	Lista patrimonios com filtros	`--types`, `--machine-types`, `--page`, `--per-page`, `--output`
`aegro assets create-machine`	Cria maquina	`--name` (obrig.), `--machine-type` (obrig.), `--manufacturer`, `--manufacture-year`, `--value`, `--currency`, `--hourmeter`, `--is-implement`, `--tag-or-model`, `--observations`
`aegro assets create-vehicle`	Cria veiculo	`--name` (obrig.), `--manufacturer`, `--manufacture-year`, `--value`, `--currency`, `--odometer`, `--tag-or-model`, `--observations`
`aegro assets create-garner`	Cria silo	`--name` (obrig.), `--manufacturer`, `--manufacture-year`, `--value`, `--currency`, `--hourmeter`, `--observations`
`aegro assets create-immobilized`	Cria benfeitoria	`--name` (obrig.), `--manufacturer`, `--manufacture-year`, `--value`, `--currency`, `--hourmeter`, `--observations`
`aegro assets create-pivot`	Cria pivo de irrigacao	`--name` (obrig.), `--manufacturer`, `--manufacture-year`, `--value`, `--currency`, `--hourmeter`, `--observations`
`aegro assets create-weather-station`	Cria estacao meteorologica	`--name` (obrig.), `--manufacturer`, `--manufacture-year`, `--value`, `--currency`, `--observations`

# Criar trator John Deere
aegro assets create-machine \
  --name "JD 8R 410" \
  --manufacturer "John Deere" \
  --machine-type TRACTOR \
  --manufacture-year 2023 \
  --value 1200000 \
  --currency BRL \
  --hourmeter 1500
# {"key": "asset::67f3c4d5e6a7b8c9", "name": "JD 8R 410", "type": "MACHINE", "machineType": "TRACTOR", ...}

# Criar colheitadeira
aegro assets create-machine \
  --name "Case IH 8250" \
  --manufacturer "Case IH" \
  --machine-type HARVESTER \
  --manufacture-year 2024 \
  --value 2800000 \
  --currency BRL \
  --hourmeter 320

# Criar pulverizador autopropelido
aegro assets create-machine \
  --name "Jacto Uniport 4530" \
  --manufacturer "Jacto" \
  --machine-type SPRAYER \
  --manufacture-year 2022 \
  --value 1600000 \
  --currency BRL \
  --hourmeter 2100

# Criar implemento (grade aradora)
aegro assets create-machine \
  --name "Grade Aradora 32 discos" \
  --manufacturer "Baldan" \
  --machine-type TILLER \
  --manufacture-year 2021 \
  --value 85000 \
  --currency BRL \
  --is-implement

# Criar veiculo (pickup)
aegro assets create-vehicle \
  --name "Hilux CD 4x4 SRV" \
  --manufacturer "Toyota" \
  --manufacture-year 2024 \
  --value 320000 \
  --currency BRL \
  --odometer 15000

# Criar silo
aegro assets create-garner \
  --name "Silo Metalico 3000t" \
  --manufacturer "Kepler Weber" \
  --manufacture-year 2020 \
  --value 450000 \
  --currency BRL

# Criar benfeitoria
aegro assets create-immobilized \
  --name "Barracão de Máquinas" \
  --manufacture-year 2018 \
  --value 280000 \
  --currency BRL

# Criar pivo de irrigacao
aegro assets create-pivot \
  --name "Pivo Central Talhao 5" \
  --manufacturer "Valley" \
  --manufacture-year 2022 \
  --value 650000 \
  --currency BRL \
  --hourmeter 4200

# Criar estacao meteorologica
aegro assets create-weather-station \
  --name "Estacao Sede" \
  --manufacturer "Davis Instruments" \
  --manufacture-year 2023 \
  --value 12000 \
  --currency BRL

# Listar apenas maquinas do tipo trator
aegro assets list --types MACHINE --machine-types TRACTOR

# Listar todos os veiculos
aegro assets list --types VEHICLE

Comando	Descricao	Flags Principais
`aegro fuel-supplies get <key>`	Busca abastecimento por chave	`--output`
`aegro fuel-supplies list`	Lista abastecimentos (BUG #3 - retorna 500)	`--asset-keys`, `--start-date`, `--end-date`, `--page`, `--per-page`, `--output`
`aegro fuel-supplies create`	Cria abastecimento	`--asset-key` (obrig.), `--date` (obrig.), `--hourmeter`, `--odometer`, `--stock-location-key`, `--observations`, `--inputs` (JSON)
`aegro fuel-supplies update <key>`	Atualiza abastecimento	mesmas flags do create

# Registrar abastecimento de trator (Diesel S10 - 200L)
aegro fuel-supplies create \
  --asset-key "asset::57d299c3e4b059f24e3f99b0" \
  --date "2026-03-13" \
  --hourmeter 1550 \
  --stock-location-key "stockLocation::abc123" \
  --observations "Diesel S10 - 200L - Tanque sede" \
  --inputs '[{"elementKey": "element::combustivel_diesel", "quantity": 200}]'
# {"key": "fuelSupply::67f4d5e6a7b8c9d0", "assetKey": "asset::57d299c3e4b059f24e3f99b0", ...}

# Registrar abastecimento de veiculo (com hodometro)
aegro fuel-supplies create \
  --asset-key "asset::veiculo_hilux01" \
  --date "2026-03-13" \
  --odometer 15500 \
  --observations "Diesel S10 - 80L - Posto externo"

# Buscar abastecimento especifico
aegro fuel-supplies get "fuelSupply::67f4d5e6a7b8c9d0"

# Atualizar observacao de abastecimento
aegro fuel-supplies update "fuelSupply::67f4d5e6a7b8c9d0" \
  --asset-key "asset::57d299c3e4b059f24e3f99b0" \
  --date "2026-03-13" \
  --hourmeter 1550 \
  --observations "Diesel S10 - 200L - Tanque sede - Corrigido"

Comando	Descricao	Flags Principais
`aegro maintenances get <key>`	Busca manutencao por chave	`--output`
`aegro maintenances list`	Lista manutencoes (BUG #4 - retorna 500)	`--asset-keys`, `--start-date`, `--end-date`, `--page`, `--per-page`, `--output`
`aegro maintenances create`	Cria manutencao	`--asset-key` (obrig.), `--date` (obrig.), `--hourmeter`, `--odometer`, `--stock-location-key`, `--crop-prorate-group-key`, `--observations`, `--inputs` (JSON), `--farm-user-keys`
`aegro maintenances update <key>`	Atualiza manutencao	mesmas flags do create

# Registrar manutencao preventiva de trator (troca de filtros + oleo)
aegro maintenances create \
  --asset-key "asset::57d299c3e4b059f24e3f99b0" \
  --date "2026-03-12" \
  --hourmeter 1545 \
  --stock-location-key "stockLocation::abc123" \
  --observations "Revisao 500h - Troca filtros oleo/ar/combustivel + oleo motor 15W40" \
  --inputs '[{"elementKey": "element::filtro_oleo01", "quantity": 1}, {"elementKey": "element::filtro_ar01", "quantity": 1}, {"elementKey": "element::oleo_motor01", "quantity": 18}]'
# {"key": "maintenance::67f5e6a7b8c9d0e1", "assetKey": "asset::57d299c3e4b059f24e3f99b0", ...}

# Manutencao corretiva de colheitadeira
aegro maintenances create \
  --asset-key "asset::colheitadeira_case01" \
  --date "2026-03-10" \
  --hourmeter 318 \
  --observations "Troca correia do elevador - quebra em operacao" \
  --inputs '[{"elementKey": "element::correia_elevador", "quantity": 1}]'

# Manutencao de veiculo (usa hodometro)
aegro maintenances create \
  --asset-key "asset::veiculo_hilux01" \
  --date "2026-03-11" \
  --odometer 15200 \
  --observations "Troca oleo + filtros - revisao 10.000km" \
  --inputs '[{"elementKey": "element::oleo_motor_5w30", "quantity": 7}, {"elementKey": "element::filtro_oleo_hilux", "quantity": 1}]'

# Manutencao com rateio para safra
aegro maintenances create \
  --asset-key "asset::57d299c3e4b059f24e3f99b0" \
  --date "2026-03-08" \
  --hourmeter 1540 \
  --crop-prorate-group-key "prorateGroup::safra2526" \
  --observations "Reparo sistema hidraulico - rateado para safra 25/26"

# Buscar manutencao especifica
aegro maintenances get "maintenance::67f5e6a7b8c9d0e1"

# ERRADO - vai falhar com 500
aegro fuel-supplies list --asset-keys "asset::57d299c3e4b059f24e3f99b0"

# CORRETO - use GET individual se tiver a chave
aegro fuel-supplies get "fuelSupply::67f4d5e6a7b8c9d0"

# ERRADO - veiculo nao usa horimetro
aegro fuel-supplies create --asset-key "asset::veiculo01" --hourmeter 1500 ...

# CORRETO - veiculo usa hodometro (km)
aegro fuel-supplies create --asset-key "asset::veiculo01" --odometer 85000 ...

# EVITAR - sem fabricante dificulta identificacao
aegro assets create-machine --name "Trator 180cv" --machine-type TRACTOR

# MELHOR - com fabricante e modelo identificavel
aegro assets create-machine \
  --name "JD 8R 410" \
  --manufacturer "John Deere" \
  --machine-type TRACTOR

# ERRADO - falta machineType
aegro assets create-machine --name "Trator" --manufacturer "John Deere"
# Erro 422: machineType is required

# CORRETO
aegro assets create-machine --name "Trator" --manufacturer "John Deere" --machine-type TRACTOR

# Inputs sem stockLocationKey = registro informativo apenas, sem baixa de estoque
aegro maintenances create --asset-key "asset::x" --date "2026-03-12" \
  --inputs '[{"elementKey": "element::filtro01", "quantity": 2}]'

# Inputs com stockLocationKey = baixa automatica do estoque no local indicado
aegro maintenances create --asset-key "asset::x" --date "2026-03-12" \
  --stock-location-key "stockLocation::abc123" \
  --inputs '[{"elementKey": "element::filtro01", "quantity": 2}]'

Tipo	Descricao
`TRACTOR`	Trator
`HARVESTER`	Colheitadeira
`SPRAYER`	Pulverizador
`PLANTER`	Plantadeira
`FERTILIZER`	Adubadora
`TILLER`	Implemento de preparo de solo
`WAGON`	Vagao / transbordo
`OTHER`	Outros

Aegro Patrimonial

Dominio Patrimonial

Vocabulario

Aegro Patrimonial

Dominio Patrimonial

Vocabulario

Tipos de Patrimonio (type)

Tipos de Maquina (machineType) — somente para type MACHINE

Modelo de Dados

Regras de Negocio

1. Seis endpoints de criacao especificos

2. Implementos (isImplement)

3. Valor do patrimonio (value)

4. Horimetro no abastecimento

5. Inputs em eventos (abastecimento e manutencao)

6. Hodometro vs Horimetro em eventos

Referencia de Comandos

assets

Exemplos de criacao de patrimonios

fuel-supplies

maintenances

Bugs e Workarounds

Bug #3: `fuel-supplies/filter` retorna HTTP 500

Bug #4: `maintenances/filter` retorna HTTP 500

Bug #6: `weather-logs` POST retorna HTTP 500

Anti-padroes

1. Nao tente listar fuel-supplies ou maintenances

2. Nao use horimetro em veiculos

3. Nao esqueca o fabricante (manufacturer)

4. Nao crie estacao meteorologica esperando registrar dados via API

5. Nao esqueca o tipo de maquina (machineType) para MACHINE

6. Nao misture inputs sem stockLocationKey

Feishu Perm

Logistics Exception Management

Review

Employment Contract Templates

On-Call Handoff Patterns

Advogado Criminal

Aegro Patrimonial

Dominio Patrimonial

Vocabulario

Aegro Patrimonial

Dominio Patrimonial

Vocabulario

Tipos de Patrimonio (type)

Tipos de Maquina (machineType) — somente para type MACHINE

Modelo de Dados

Regras de Negocio

1. Seis endpoints de criacao especificos

2. Implementos (isImplement)

3. Valor do patrimonio (value)

4. Horimetro no abastecimento

5. Inputs em eventos (abastecimento e manutencao)

6. Hodometro vs Horimetro em eventos

Referencia de Comandos

assets

Exemplos de criacao de patrimonios

fuel-supplies

maintenances

Bugs e Workarounds

Bug #3: fuel-supplies/filter retorna HTTP 500

Bug #4: maintenances/filter retorna HTTP 500

Bug #6: weather-logs POST retorna HTTP 500

Anti-padroes

1. Nao tente listar fuel-supplies ou maintenances

2. Nao use horimetro em veiculos

3. Nao esqueca o fabricante (manufacturer)

4. Nao crie estacao meteorologica esperando registrar dados via API

5. Nao esqueca o tipo de maquina (machineType) para MACHINE

6. Nao misture inputs sem stockLocationKey

Feishu Perm

Logistics Exception Management

Review

Employment Contract Templates

On-Call Handoff Patterns

Advogado Criminal

Bug #3: `fuel-supplies/filter` retorna HTTP 500

Bug #4: `maintenances/filter` retorna HTTP 500

Bug #6: `weather-logs` POST retorna HTTP 500