Assistente de IA para diretoria e lojas

Crie tabelas de consumo por pergunta: venda diária por loja, item fiscal, estoque por produto e filial, margem por item. Cada uma tem o grão declarado na descrição em uma frase ("Uma linha por loja, por dia"). Não exponha uma tabela genérica que mistura grãos, e não use campo financeiro de uma tabela operacional como faturamento.

Comece a descrição da coluna com a marcação: @pk para chave do grão, @fk para chave estrangeira, @measure additive para somável em qualquer dimensão, @measure non_additive para ticket médio e percentuais, @grain=daily ou monthly. Depois, em texto: origem, regra de cálculo e armadilha. Documente a tabela, não só a transformação.

"Quanto vendeu" é respondido com a venda líquida (bruta menos descontos menos cancelamentos). A resposta sempre nomeia a métrica, o período e a loja. Bruta só quando pedida.

Campos de data do ERP gravados como meia-noite UTC já são o dia comercial. A IA calcula hoje e ontem em America/Sao_Paulo e compara direto, sem converter o campo. A regra fica escrita na descrição da coluna e no context document.

Na Nekt, a permissão vale por camada inteira ou por tabela e view, com papéis de leitura e edição. Pastas no catálogo são só organização visual e não protegem nada. Crie uma view por loja (venda diária filtrada para aquela loja) e conceda a cada gerente só a sua. Use token com escopo por tabela para o assistente de cada público.

Cancelamentos e tentativas de cancelamento identificam o operador de caixa e servem para avaliação e investigação. Eles não entram nas views de loja, nem filtrados para a própria loja. Ficam em views da diretoria, auditoria e RH.

O assistente nunca responde número sem executar a consulta. Também não recusa por falta de dado antes de ler a estrutura da tabela semântica do domínio. Métricas marcadas como "a validar" não são inferidas. Quando o campo não existe, a resposta é "dado não localizado nesta fonte".

Disponível = quantidade total menos reservada, nunca negativo. Filiais que espelham o mesmo estoque físico são agregadas pelo grupo de estoque, nunca somadas. Produtos com estoque ilimitado ficam fora. Produto inexistente e produto sem estoque têm respostas diferentes. Códigos de produto são padronizados (por exemplo, zeros à esquerda até 18 posições no SAP) antes de cruzar com venda.

As views do assistente rodam por evento logo depois da tabela de origem, nunca com gatilho manual. Um monitor com agendamento próprio detecta ausência de execução (por exemplo, mais de 120 minutos sem carga). A resposta informa a data e hora da última atualização.

Empresas do mesmo grupo podem aparecer como contas ou lojas distintas. Transferências entre elas não são receita nem despesa operacional e são eliminadas no consolidado. A margem vem da tabela oficial de margem, nunca recalculada pela IA com outra regra.