Perguntas Frequentes

Geral

Como funciona o multi-tenancy?

Cada SPE da incorporadora é uma "organização" no sistema, com isolamento total de dados. Um usuário pode ser membro de várias orgs e trocar pelo seletor no header. → Multi-tenancy

Posso usar a plataforma sem internet?

Não. É uma plataforma SaaS. Para áreas com conectividade ruim (canteiro), recomendamos uso pelo celular com 4G/5G — a UI é mobile-first nas operações de campo (recebimento, lançamento de gasto de fundo, etc.).

Que dispositivos são suportados?

• Desktop: Chrome/Firefox/Edge/Safari atuais (últimos 2 anos)
• Mobile: iOS 15+, Android 10+ no navegador
• Não há app nativo dedicado — é PWA / responsivo

Como funciona o backup?

Supabase faz backup automático diário com retenção de 30 dias. Para SLAs maiores ou backup off-site, contatar suporte.

Módulo Compras

A IA da cotação está errando muito. O que faço?

Confiabilidade da IA depende da qualidade do upload:

• PDFs estruturados (gerados por ERP do fornecedor): >95% acertos
• Fotos de papel manuscrito: 70-85% acertos
• Áudios em ambiente ruidoso: 60-80%

Sempre revise os campos com confidence < 80% (badges visuais na UI). Para fornecedores recorrentes, peça que envie em formato estruturado.

Posso configurar bloqueio rígido de pagamento por CND vencida?

Atualmente alerta. Bloqueio rígido configurável é planejado para Phase 2.1. Por enquanto, política é organizacional — a equipe decide se ignora ou regulariza antes do PIX.

Como o 3-way match lida com tolerância?

Configurável em Settings → Compras:

• Tolerância de quantidade (default 2%) — para commodities como areia/brita
• Tolerância de preço (default 0%) — qualquer divergência abre incidente

Qual é a diferença entre RC, Cotação e PO?

• RC (Requisição de Compra): pedido interno, "preciso disso, sem fornecedor ainda"
• Cotação (RFQ): convite a múltiplos fornecedores para cotar uma RC
• PO (Pedido de Compra): documento contratual com o fornecedor escolhido

→ Fluxo P2P completo

O que acontece se eu apagar uma RC?

RCs em rascunho podem ser apagadas. RCs aprovadas só podem ser canceladas (registra evento auditável). Não há delete físico para preservar trilha.

Módulo Estoque

Custo médio negativo. Como?

Não acontece em fluxo normal. Aparece apenas quando:

1. permite_saldo_negativo=true no almoxarifado (config explícita)
2. Saldo é negativo
3. Entrada chega com custo muito diferente

Recomendação: deixe permite_saldo_negativo=false (default).

Posso desfazer uma transferência?

Não diretamente. Crie outra transferência no sentido oposto. Movimentos são imutáveis para auditoria.

Inventário discrepante. Como tratar?

Ajuste de inventário (tab Inventário → "Inventariar") gera entrada/saída de ajuste com motivo obrigatório. Trigger atualiza ultima_inventario_diferenca no saldo. Auditoria fica registrada.

Aprovações

Aprovador parado. Como destrancar?

SLA configurado escala automaticamente após 24h úteis (default) para o role acima. Se não escalou, configure regra de escalação em Settings → Aprovações → Regras de Escalação.

Posso delegar minhas aprovações enquanto estou de férias?

Sim. Settings → Aprovações → Delegações → Nova delegação. Defina período, escopo e razão.

Aprovei mas a entidade não atualizou

Bug pré-existente foi corrigido. Em produção: callbacks são automáticos e idempotentes. Se notar inconsistência, reportar em suporte@octabuild.ai com request_id.

Performance e limites

Quantos itens em uma cotação?

Sem limite hard. Performance ótima até ~500 itens. Acima, considere split em múltiplas RCs/RFQs.

Quantos fornecedores na mesma RFQ?

Recomendado: 3-7. Acima de 10, sobrecarrega o comprador na análise.

Qual o tamanho máximo de arquivo na proposta do fornecedor?

• Por arquivo: 50 MB
• Por proposta: 6 arquivos
• Configurável em Settings → Compras → Máx arquivos por proposta

Suporte

Como abrir um ticket de suporte?

Email: suporte@octabuild.ai. Inclua:

• URL onde aconteceu o problema
• Screenshot ou vídeo
• Steps to reproduce

SLA de suporte

• Plano padrão: 24h úteis para resposta inicial
• Plano enterprise: 4h úteis + canal Slack dedicado

Status da plataforma

status.octabuild.ai (planejado).