Data: 09/07/2025
Responsável: Nilton Flávio Câmara Romani
Sistema: CCMBR / ChatNumis

📌 Resumo

Este relatório descreve o cenário atual, riscos identificados e definições técnicas adotadas para garantir o funcionamento seguro e estável do ChatNumis, com integração de IAs personalizadas por loja ou usuário.

📌 Cenário

• Cada loja possui seu próprio chat, identificado via parâmetro ?loja=ID.

• O chat permite configuração de uma IA personalizada, cadastrada na tabela configuracao_ai.

• As mensagens são salvas na tabela chat_privado, contendo remetente, destinatário, conteúdo e idioma.

• Mensagens podem ser respondidas automaticamente por IA, se configurada e ativa.

• Cada IA possui duas chaves configuráveis:

  • openai_api_key: Para respostas automáticas.

  • tradutor_api_key: Para traduções de mensagens.

• A loja ativa é armazenada em sessão:

⚙️ Chat Institucional (Página Inicial do Portal)

Inicialmente, o primeiro ambiente a receber e testar a integração com IA será o chat institucional do portal (não relacionado a nenhuma loja).

Neste caso:

• O chat utilizará uma IA global, com ID fixo:

• Toda a configuração da IA será carregada a partir deste ID.

• Não utiliza variáveis de loja ou sessão nesse contexto.

• Após o sucesso nos testes, a integração será expandida para os chats das lojas individuais, usando o ID da loja.

📌 Melhorias Estruturais Adotadas

✅ Campo ai_respondeu na tabela chat_privado
Permite identificar se a resposta foi de um usuário ou da IA configurada.

✅ Validação de IA ativa antes de responder
O backend verifica a configuração da IA no momento da mensagem e apenas responde se a IA estiver ativa.

✅ Configuração individualizada por loja
As configurações de IA e tradução são carregadas pelo id_usuario (loja), impedindo o cruzamento de dados entre lojas.

✅ Separação rigorosa de chaves API
Uso de variáveis distintas e obrigatórias:

✅ Prevenção de respostas duplicadas
Garante que a IA só responda uma vez para cada mensagem, evitando loops ou duplicações.

📌 Riscos Mapeados

📌 Próximos Passos Sugeridos

• Implantar log detalhado de requisições às APIs para auditoria e diagnóstico.

• Validar a interface de ativação/desativação da IA no painel da loja.

• Desenvolver um controle de prioridade para cenários futuros com múltiplas IAs.

• Realizar testes de estresse, com múltiplos chats abertos e alternância de IA ativa/desativada.

• Após a validação no chat institucional, iniciar a integração gradual nas lojas.

📌 Conclusão

O fluxo de integração da IA no ChatNumis está estruturado com segurança e eficiência, com os principais riscos identificados e soluções técnicas aplicadas. Recomenda-se manter o ambiente de testes controlado, com versionamento rigoroso de código e banco de dados antes de alterações críticas.