Configurações da plataforma

O que é

Esta área é exclusiva de quem administra o Aptofy como um todo (não uma administradora cliente) — configurações globais que afetam a plataforma inteira: envio de e-mail, chave de IA e endpoint de webhook.

O que dá pra configurar

• Inteligência Artificial: qual provedor de IA alimenta o produto (Gemini, Ollama Cloud ou um servidor Ollama próprio), e separadamente, qual provedor/modelo alimenta a busca (embedding) do regimento e da Central de Ajuda — ver seção dedicada abaixo.
• Resend (e-mail): chave de API usada para enviar e-mails transacionais (convites, avisos, faturas).
• Webhook de pagamento: URL que os bancos usam para confirmar pagamentos automaticamente.
• Storage de fotos: onde ficam guardadas as fotos de encomendas e ocorrências.
• Observabilidade (SigNoz): envio de métricas, logs e rastreamentos (traces) do backend para o SigNoz Cloud, para monitorar saúde e diagnosticar erros do ambiente.

Inteligência Artificial — Gemini ou Ollama

Todo recurso de IA do produto (o assistente flutuante do painel, o "Síndico Virtual" do morador, triagem de ocorrências, resumo executivo, leitura de etiqueta de encomenda, sugestão de conta na conciliação bancária, e a busca no regimento/Central de Ajuda) passa por um único seletor: o campo Provedor de IA em uso, com três modos.

• Gemini (padrão) — via API do Google, mesmo comportamento de sempre: configure Chave da API Gemini e, opcionalmente, o modelo.
• Ollama Cloud — modelos hospedados em ollama.com num plano pago; configure a chave da API Ollama e o modelo de texto/ferramentas (ex.: gpt-oss:120b).
• Ollama local — a mesma API do Ollama, só que apontando pro endereço de um servidor seu (Ollama — endereço do servidor local), rodando dentro da sua própria infraestrutura. Nenhum dado sai pra fora nesse modo.

Trocar o provedor vale na hora, sem precisar reiniciar nada — a próxima pergunta ao chat, por exemplo, já responde pelo provedor novo.

No modo Ollama, a leitura de foto de etiqueta de encomenda (OCR) precisa de um modelo de visão configurado à parte (OLLAMA_VISION_MODEL) — nem todo modelo Ollama lê imagem. Sem ele, a leitura automática por foto fica desligada, mas a leitura por código de barras continua funcionando normalmente.

Use o botão Testar IA no topo da seção para verificar, na hora, se o provedor escolhido responde de verdade — ele checa geração de texto, uso de ferramentas (usado pelo assistente com ações), leitura de imagem (quando aplicável) e busca por embedding, com o tempo de resposta de cada teste.

Busca (RAG) — de onde vêm os embeddings do regimento e da Central de Ajuda

A busca por IA no regimento/convenção e na Central de Ajuda (o mecanismo por trás das respostas citadas) usa uma tecnologia chamada embedding — um cálculo separado da geração de texto, com seu próprio provedor e modelo, configurados na subseção Busca / Embeddings (RAG), dentro de Inteligência Artificial:

• Provedor de embedding — Gemini (padrão) ou um servidor Ollama local seu, independente do provedor escolhido para geração de texto acima. Dá pra ter a geração de texto no Ollama e a busca ainda no Gemini (ou o contrário) — os dois roteiam separadamente.
• Modelo de embedding — uma lista curada (ao contrário do modelo de texto do Ollama, que é digitado livremente): trocar o modelo aqui exige cuidado, porque um modelo errado não dá erro visível, só faz a busca responder pior silenciosamente — por isso só aparecem opções já compatíveis com o índice da plataforma.
• Modelo usado na Central de Ajuda — campo somente leitura: mostra qual modelo foi realmente usado pra indexar o conteúdo do manual (gravado automaticamente pela ferramenta de reindexação, não editável aqui).

Migrar o acervo pra um modelo de embedding novo

Quando o modelo de embedding configurado não bate mais com o modelo que indexou algum condomínio, um cartão "Migração assistida do acervo" aparece na mesma subseção, mostrando antes de qualquer botão: quantos condomínios, documentos e trechos estão desatualizados, e uma estimativa do custo em tokens. Só depois dessa estimativa é que o botão Migrar acervo aparece.

Ao confirmar, cada condomínio afetado é reprocessado, um de cada vez:

1. A busca no regimento/convenção daquele condomínio fica temporariamente indisponível enquanto os documentos são reindexados (minutos, não horas) — nenhuma resposta errada é mostrada nesse meio tempo, só uma mensagem honesta de "ainda processando".
2. O limiar de citação do regimento daquele condomínio volta pro padrão — ele era calibrado para o modelo antigo e não faz mais sentido no novo.
3. A Central de Ajuda não entra nessa migração automática (é um acervo único da plataforma, não por condomínio) — reindexá-la é uma ação manual separada, feita pela equipe técnica.

Observabilidade / SigNoz

Quando ligada, a plataforma envia três sinais ao SigNoz Cloud: métricas (latência, erros, saúde do banco), logs estruturados e traces (o caminho completo de cada requisição). Os campos:

• Ativar envio ao SigNoz — liga/desliga a exportação.
• Endpoint OTLP — ex.: ingest.us.signoz.cloud:443.
• Ingestion key — a chave da sua conta SigNoz (secreta).
• Nome do serviço / ambiente / taxa de amostragem — opcionais.

Perguntas frequentes

O que acontece se eu não configurar nenhum provedor de IA?▾

Os recursos de IA continuam existindo na tela, mas respondem com uma mensagem simulada em vez de usar IA de verdade — nada quebra, só fica sem inteligência real até um provedor (Gemini ou Ollama) ser configurado.

Posso trocar de Gemini para Ollama e voltar sem perder nada?▾

Sim. As chaves dos dois provedores ficam salvas separadamente — trocar o Provedor de IA em uso só muda qual delas é usada na próxima chamada. Nenhuma configuração é apagada ao alternar.

Preciso ter um servidor Ollama rodando pra usar o modo cloud?▾

Não. O modo Ollama Cloud usa os servidores do próprio ollama.com (plano pago) — só precisa da chave da API. O modo Ollama local é que exige um servidor seu, e serve como o caminho pra rodar tudo dentro da própria infraestrutura no futuro, sem depender de nenhum provedor externo.

Se eu mudar o provedor de IA principal para Ollama, a busca do regimento fica local também?▾

Só se você também trocar o provedor de embedding, na subseção Busca / Embeddings (RAG) — os dois são independentes. Trocar só o provedor de geração de texto deixa a busca (embedding) no Gemini até você trocar esse campo separadamente; a tela avisa isso quando os dois estão dessincronizados.

O que acontece se eu trocar o modelo de embedding e não migrar o acervo?▾

Nada quebra imediatamente: cada condomínio continua respondendo com o modelo que indexou seus documentos originalmente (a plataforma nunca mistura modelos diferentes na mesma busca). Só as PRÓXIMAS ingestões novas é que passam a usar o modelo novo. Pra colocar o acervo já existente no ar no modelo novo, é preciso rodar a migração assistida — veja o cartão que aparece na mesma subseção quando há divergência.