Dominio operacional do Aegro - fazendas, autenticacao, tags e orquestracao entre dominios
Referencia completa do dominio operacional da Fazenda Aegro (farm::5711512de4b0e15eb04da4d0, ~67k ha).
Cobre autenticacao, gestao de fazendas, tags, empresas, ordens de compra e a orquestracao de fluxos entre dominios.
| Termo | Definicao | Exemplo |
|---|---|---|
| Farm | Propriedade rural vinculada a uma API Key. Cada token da acesso a exatamente uma fazenda | farm::5711512de4b0e15eb04da4d0 |
| API Key | Token de integracao solicitado via [email protected]. Identifica fazenda e permissoes | Header Aegro-Public-API-Key |
| Tag | Marcador para categorizar recursos (patrimonios, atividades, colheitas, talhoes, etc.) | Tag "Lote Norte" tipo GLEBE |
| Relation Type | Tipo de entidade que a tag categoriza. Define permissao necessaria para criar | MACHINE, VEHICLE, GLEBE, ACTIVITY, HARVEST_TAG, BILL, PURCHASE |
| Company | Empresa cadastrada — fornecedor, cliente ou transportadora. Usada em financeiro e compras | Bayer CropScience (PROVIDER) |
| Purchase Order | Ordem de compra vinculada a empresa, com itens, valores e entregas | OC-2026-001 — Defensivos safra 25/26 |
| Element | Item do catalogo (defensivo, fertilizante, semente, servico, produto). Entidade cross-domain | Glifosato 480 SL (DEFENSIVE) |
| Key | Identificador unico no formato tipo::hexstring (ex: farm::5711..., tag::abc123, company::def456) | purchaseOrder::67a1b2c3d4e5f6 |
AEGRO_FARMS — JSON map {"nome_fazenda": "api_key"} (CI/CD)AEGRO_FARMS_FILE — caminho para arquivo JSON com mesmo formato~/.config/aegro/credentials.json — criado por aegro auth login| Arquivo | Conteudo | Gerenciado por |
|---|---|---|
~/.config/aegro/credentials.json | Map nome → API key | aegro auth login |
~/.config/aegro/state.json | Fazenda selecionada, timestamp | aegro farms select |
# Login interativo — solicita nome da fazenda e API key, salva em credentials.json
aegro auth login
# Verificar status da autenticacao e fazenda ativa
aegro auth status
# Remover credenciais locais
aegro auth logout
# Listar fazendas disponiveis (do credentials.json ou env)
aegro farms list
# Selecionar fazenda ativa (persiste em state.json)
aegro farms select "Fazenda Aegro"
# Informacoes da fazenda selecionada
aegro farms info
Nota: Todo comando de dominio exige fazenda selecionada. Se nao houver, retorna exit code 2 (auth) com mensagem orientando aegro farms select.
| Formato | Flag | Descricao |
|---|---|---|
| JSON | --output json (default) | Saida estruturada para parsing por LLMs e scripts |
| Tabela | --output table | Formatado com Rich para leitura humana |
| CSV | --output csv | Para export e planilhas |
--page N (inicia em 1) e --per-page NtotalItems, totalPages, currentPageTodas as chaves seguem o padrao tipo::hexstring: