| name | suporte-graos-erp-rag |
| description | Skill especializada para o sistema ERP Grãos (suportegraoserp.vercel.app). Opera via RAG buscando contexto em `.agents/memory/knowledge/suporte-graos/`.
|
Suporte Grãos ERP — Skill de Desenvolvimento RAG
🔍 PROTOCOLO DE RECUPERAÇÃO (RAG Search)
Sempre que a tarefa envolver o ERP Grãos, execute:
- Busca: Pesquise termos da tarefa em
.agents/memory/knowledge/suporte-graos/.
- Contexto: Leia os KIs relevantes encontrados (ex:
finance, logistics, overview).
- Execução: Aplique as regras de negócio recuperadas.
🚀 Proatividade com Ferramentas
- O agente tem acesso total ao
supabase-mcp-server.
- PROATIVIDADE OBRIGATÓRIA: Realize consultas SQL e migrações via MCP sem pedir permissão.
💎 PADRÃO FINANCEIRO MODULAR (SQL-First)
Para mantermos o ERP Grãos livre de erros de saldo, siga estritamente este fluxo:
- Baixas de Títulos: Use sempre o RPC
rpc_ops_financial_process_action. NUNCA atualize o campo paid_value manualmente no frontend.
- Estornos: Use
rpc_ops_financial_void_transaction para deletar transações bancárias. Isso ativará os triggers de banco que restauram o saldo e o status do título original automaticamente.
- Logística: Despesas de motorista (extras/abatimentos) devem ser enviadas via
rpc_ops_loading_manage_expense.
- Sincronização de Histórico: O frontend deve injetar apenas o histórico leve via
registerFinancialRecords, marcando a transação como canônica para evitar duplicidade no ledger bancário.
- Estado Global: Após qualquer operação financeira, invalide os caches do TanStack Query (
LOADINGS, FINANCIAL_TRANSACTIONS, ACCOUNTS).
- Isolamento de Módulos (Despesas vs Empréstimos): O submódulo de Despesas (AdminExpensesTab) deve listar apenas despesas administrativas reais (
sub_type = 'admin' ou sub_type = null). Lançamentos históricos de empréstimos, adiantamentos ou créditos inseridos em admin_expenses devem usar sub_type = 'receipt' ou outros sub-types correspondentes para serem filtrados e excluídos do módulo de Despesas.
📂 Módulos e Documentação (Consulte via RAG)
O detalhamento de cada módulo e as regras de negócio foram movidos para a memória evolutiva. Use o Protocolo de Recuperação acima para acessar:
overview.md: Visão geral e fluxo central do negócio.logistics.md: Regras de frete, carregamentos e romaneios.finance.md: Gestão financeira, adiantamentos e baixas.supabase_ui.md: Estrutura do banco de dados e padrões de interface (ModalPortal).known_bugs.md: Histórico de correções e armadilhas a evitar.performance_caixa.md: KPIs, fórmulas e visão patrimonial.
