consultando-estoque-loja - SKILL.md Agent Skill

name: consultando-estoque-loja description: >- Skill READ do Agente Lojas HORA para estoque de motos nas lojas HORA: contagem por loja/modelo, chegada de chassi, motos em transito. Respeita escopo via (escopado ve so sua loja; admin ve todas). Gatilhos: "quantas motos tenho?", "quanto tem de ?", "o chassi XYZ ja chegou?", "quais motos em transito?". NAO usar para historico completo de um chassi -> rastreando-chassi. Matriz USAR/NAO-USAR completa no corpo. allowed-tools: Read, Bash, Glob, Grep

Consultando Estoque Loja HORA

Consulta o estoque fisico de motos eletricas nas lojas HORA, respeitando escopo por loja do usuario.

Quando usar / Quando NAO usar

USAR QUANDO:

Contagem de estoque: "quantas motos tenho aqui?", "quanto de ?", "quantas tem disponivel?", "quanto tenho em estoque?"
Verificar chassi: "o chassi MC172XXX ja chegou?"
Motos em transito: "quais motos pedidas mas nao recebidas?"
Disponibilidade fisica por loja / visao por loja (admin): "como esta o estoque de cada loja?"

NAO USAR PARA:

Historico completo/detalhado de UM chassi -> rastreando-chassi
Conferencia fisica de recebimento -> conferindo-recebimento (M2)
Consultar vendas B2C -> consultando-venda-loja
Estoque Nacom Goya -> gerindo-expedicao (agente diferente)

REGRAS CRITICAS

1. GUARDRAIL ANTI-ALUCINACAO

PROIBIDO inferir quantidades ou status sem rodar o script. Se o script retornou vazio: diga "nao ha motos cadastradas com esses criterios" em vez de inventar.

2. RESPEITAR

O bloco <loja_context> injetado no prompt define o escopo:

pode_ver_todas: true -> pode consultar qualquer loja_id
pode_ver_todas: false + loja_ids_permitidas: [X] -> SEMPRE passar --loja-ids X
NUNCA passar --loja-ids fora desse conjunto.

3. MOTOS SEM EVENTO = EM TRANSITO

Uma moto em hora_moto sem linha em hora_moto_evento NAO esta em estoque de nenhuma loja — esta em transito (pedido/NF ja lancada, mas nao recebida fisicamente). Mostrar em categoria separada.

4. ULTIMO EVENTO = POSICAO ATUAL

Estoque de uma loja = chassis cujo ULTIMO evento (ordenado por timestamp DESC) esta em EVENTOS_EM_ESTOQUE (fonte de verdade: estoque_service.py) E tem loja_id=<loja>. Inclui RECEBIDA, CONFERIDA, TRANSFERIDA, CANCELADA, AVARIADA, FALTANDO_PECA, EMPRESTIMO_ENTRADA, RESSARCIMENTO_SAIDA — NAO apenas 'RECEBIDA'.

DECISION TREE

Pergunta do usuario	Parametros do script
"quantas motos?" (generico)	`--resumo`
"quanto de PMX?"	`--modelo "PMX"`
"chassi MC172 chegou?"	`--chassi MC172922511890568`
"motos em transito?"	`--incluir-transito --so-transito`
admin: "estoque por loja"	`--por-loja`

Sempre incluir --loja-ids <X,Y,...> quando pode_ver_todas: false.

Invocacao

cd /home/rafaelnascimento/projetos/frete_sistema
source .venv/bin/activate
python .claude/skills/consultando-estoque-loja/scripts/consultando_estoque_loja.py \
    --loja-ids 2 \
    --resumo

Output: JSON imprimido em stdout.

Output JSON

{
  "escopo_aplicado": {"loja_ids": [2], "modelo": null, "chassi": null},
  "lojas": [
    {"id": 2, "apelido": "MOTOCHEFE BRAGANCA", "cidade": "BRAGANCA PAULISTA"}
  ],
  "totais": {"estoque": 1, "transito": 0, "vendido": 0},
  "por_modelo": [
    {"modelo": "PMX", "estoque": 1, "transito": 0}
  ],
  "motos": [
    {
      "chassi": "MC172922511890568",
      "modelo": "PMX", "cor": "preta", "ano_modelo": 2026,
      "loja_atual_id": 2, "loja_atual": "MOTOCHEFE BRAGANCA",
      "status": "estoque",
      "ultimo_evento": {"tipo": "RECEBIDA", "timestamp": "2026-04-22T21:50"}
    }
  ],
  "_debug": {"query_ms": 42}
}

Referencias

Schema: .claude/skills/consultando-sql/schemas/tables/hora_moto.json
Schema eventos: .claude/skills/consultando-sql/schemas/tables/hora_moto_evento.json
Invariante: app/hora/CLAUDE.md secao "Invariante central"