Descobrindo Odoo Estrutura

Skill para descoberta de campos e estrutura de modelos do Odoo.

QUANDO USAR: Quando o Agent nao conhecer um modelo/campo especifico do Odoo e precisar descobrir a estrutura para enriquecer a resposta ao usuario.

Casos de Uso

•
Usuario pergunta sobre dado que nao esta mapeado
- •Agent usa esta skill para descobrir campos
- •Retorna informacao enriquecida ao usuario
•
Implementar nova consulta
- •Descobrir estrutura do modelo
- •Mapear campos relevantes
- •Documentar em rastreando-odoo (references/relacionamentos.md)
•
Debug de integracoes
- •Inspecionar registro especifico
- •Verificar valores de campos

Script Disponivel

descobrindo.py

bash

source .venv/bin/activate && \
python .claude/skills/descobrindo-odoo-estrutura/scripts/descobrindo.py [opcoes]

Operacoes Disponiveis

Operacao	Flag	Descricao	Exemplo
Listar campos	`--listar-campos`	Lista todos os campos do modelo	`--modelo res.partner --listar-campos`
Buscar campo	`--buscar-campo`	Busca campo por nome/descricao	`--modelo res.partner --buscar-campo cnpj`
Inspecionar	`--inspecionar`	Mostra todos os campos de um registro	`--modelo res.partner --inspecionar 123`
Consulta generica	`--filtro`	Consulta com filtro JSON	`--modelo res.partner --filtro '[["name","ilike","teste"]]'`

Parametros

Parametro	Obrigatorio	Descricao
`--modelo`	Sim	Nome do modelo Odoo (ex: `res.partner`, `account.move`)
`--listar-campos`	Nao	Lista todos os campos do modelo
`--buscar-campo`	Nao	Termo para buscar nos nomes/descricoes dos campos
`--inspecionar`	Nao	ID do registro para inspecionar
`--filtro`	Nao	Filtro em formato JSON
`--campos`	Nao	Campos a retornar (JSON), usado com --filtro
`--limit`	Nao	Limite de resultados (padrao: 10)
`--json`	Nao	Saida em formato JSON

Exemplos de Uso

Descobrir campos de um modelo

bash

python .../descobrindo.py --modelo l10n_br_ciel_it_account.dfe --listar-campos

Buscar campo especifico

bash

python .../descobrindo.py --modelo res.partner --buscar-campo cnpj

Inspecionar registro

bash

python .../descobrindo.py --modelo res.partner --inspecionar 123

Consulta generica com filtro

bash

python .../descobrindo.py \
  --modelo res.partner \
  --filtro '[["vat","ilike","93209765"]]' \
  --campos '["id","name","vat"]' \
  --limit 5

Cenarios Praticos de Descoberta

Cenario 1: Usuario pergunta sobre campo desconhecido

Situacao: "Qual o campo que guarda o codigo de barras do produto?"

bash

# Passo 1: Buscar campos relacionados a "barcode" no modelo product.product
source .venv/bin/activate && \
python .claude/skills/descobrindo-odoo-estrutura/scripts/descobrindo.py \
  --modelo product.product \
  --buscar-campo barcode

# Resultado esperado: Lista campos como barcode, barcode_ids, etc.

Acao apos descoberta: Documentar no CLAUDE.md ou references/MODELOS_CAMPOS.md se for campo frequentemente usado.

Cenario 2: Debug de campo com valor inesperado

Situacao: "Qual o valor do campo X no registro Y?"

NOTA: Para RASTREAR documentos (NF, PO, SO), use a skill rastreando-odoo em vez desta.

bash

# Inspecionar TODOS os campos de um registro especifico
source .venv/bin/activate && \
python .claude/skills/descobrindo-odoo-estrutura/scripts/descobrindo.py \
  --modelo res.partner \
  --inspecionar 12345

Resultado: Ver todos os valores de campos do registro para debug.

Cenario 3: Preparar nova integracao

Situacao: "Preciso criar integracao com modelo stock.picking (movimentacao de estoque)"

bash

# Passo 1: Listar TODOS os campos do modelo
source .venv/bin/activate && \
python .claude/skills/descobrindo-odoo-estrutura/scripts/descobrindo.py \
  --modelo stock.picking \
  --listar-campos \
  --json > /tmp/stock_picking_campos.json

# Passo 2: Buscar campos especificos de interesse
python .claude/skills/descobrindo-odoo-estrutura/scripts/descobrindo.py \
  --modelo stock.picking \
  --buscar-campo partner

python .claude/skills/descobrindo-odoo-estrutura/scripts/descobrindo.py \
  --modelo stock.picking \
  --buscar-campo origin

# Passo 3: Pegar um registro de exemplo para entender estrutura
python .claude/skills/descobrindo-odoo-estrutura/scripts/descobrindo.py \
  --modelo stock.picking \
  --filtro '[["state","=","done"]]' \
  --limit 1 \
  --inspecionar

Proximo passo: Usar skill integracao-odoo para criar o Service com os campos descobertos.

Modelos Conhecidos (Referencia)

Modelo	Descricao	Skill Relacionada
`l10n_br_ciel_it_account.dfe`	Documentos Fiscais	rastreando-odoo
`l10n_br_ciel_it_account.dfe.line`	Linhas dos DFE	rastreando-odoo
`res.partner`	Parceiros (clientes, fornecedores)	rastreando-odoo
`account.move`	Faturas/Lancamentos	rastreando-odoo
`account.move.line`	Linhas de fatura	rastreando-odoo
`purchase.order`	Pedidos de compra	rastreando-odoo
`sale.order`	Pedidos de venda	rastreando-odoo
`product.product`	Produtos	-

Fluxo de Trabalho

code

Usuario pergunta sobre dado desconhecido
        │
        ▼
Agent verifica: modelo/campo conhecido?
        │
        ├── SIM → Usa rastreando-odoo para consultar fluxos
        │
        └── NAO → Usa esta skill para descobrir
                    │
                    ▼
              descobrindo.py --modelo X --listar-campos
                    │
                    ▼
              Retorna informacao ao usuario

Relacionado

Skill	Uso
rastreando-odoo	Consultas e rastreamento de fluxos documentais (NF, PO, SO, titulos)
integracao-odoo	Desenvolvimento de novas integracoes
gerindo-expedicao	Consultas de carteira, separacoes e estoque