Blue Consultas Helpdesk Bridge

Services/Helpdesk · v19.0.1.0.0 · OPL-1

Connect Blue Consultas records with Odoo Enterprise Helpdesk

Dependências

blue_credit_query, helpdesk

Documentação

Integra o histórico de consultas e as compras de créditos ao Helpdesk Enterprise do Odoo 19.

Resultado

• atendentes podem abrir um chamado diretamente pela consulta ou compra;
• novos cliques reabrem o chamado existente em vez de duplicá-lo;
• o ticket mantém vínculo auditável com a origem;
• a equipe é selecionada na mesma empresa do registro de origem;
• o Helpdesk continua responsável por equipe, SLA, comunicação e encerramento.

Requisito operacional

Deve existir pelo menos uma equipe do Helpdesk na empresa da consulta ou compra. Quando não existir, o módulo bloqueia a criação e apresenta uma mensagem de configuração, em vez de abrir o chamado na empresa errada.

Testes automatizados

odoo \
  -c /tmp/odoo.conf \
  -d consultas_qa \
  --no-http \
  --stop-after-init \
  --workers=0 \
  --test-enable \
  --test-tags /blue_credit_query_helpdesk \
  -i blue_credit_query_helpdesk

Os testes cobrem:

• roteamento para uma equipe da mesma empresa;
• empresa derivada corretamente da equipe;
• vínculo com consulta e compra;
• idempotência em cliques repetidos.

Instalação segura no host

O script usa a imagem atualmente implantada no serviço Swarm e copia temporariamente o odoo.conf, variáveis e segredos do container em execução. Nenhuma credencial é mantida no repositório.

bash scripts/install-module-consultas.sh blue_credit_query_helpdesk install

Para atualizar uma instalação existente:

bash scripts/install-module-consultas.sh blue_credit_query_helpdesk upgrade

O script:

1. valida módulo, serviço e rede;
2. identifica a imagem implantada por tag ou digest;
3. copia a configuração para diretório temporário com permissão restrita;
4. escala o serviço para zero antes da alteração de schema;
5. instala ou atualiza o módulo;
6. confirma o estado installed no banco;
7. restaura a quantidade original de réplicas mesmo quando ocorre erro;
8. remove os arquivos temporários.

Instalação manual em QA

odoo \
  -c /tmp/odoo.conf \
  -d consultas_qa \
  --no-http \
  --stop-after-init \
  --workers=0 \
  -i blue_credit_query_helpdesk

QA funcional

1. abrir um histórico de consulta;
2. clicar em Abrir chamado;
3. confirmar parceiro, equipe, empresa, documento, provedor e status;
4. voltar à consulta e clicar novamente;
5. confirmar que o mesmo ticket foi aberto;
6. repetir o fluxo para uma compra de créditos;
7. abrir o ticket e confirmar o bloco Blue Consultas;
8. validar ACLs com um usuário Helpdesk e um usuário sem o grupo;
9. validar mensagem clara em empresa sem equipe Helpdesk.

Critérios antes do deploy

• manifest validado pelo gate do repositório;
• testes automatizados executados em Odoo 19 Enterprise;
• instalação limpa com helpdesk;
• XML IDs nativos confirmados na build Enterprise usada pela imagem;
• smoke test autenticado;
• imagem registrada por SHA/digest;
• upgrade explícito do banco e rollback documentados.

Rollback

O módulo é opcional e não altera os modelos de origem. Em caso de rollback:

1. reverter a imagem para o digest anterior;
2. manter o módulo instalado quando já existirem tickets vinculados;
3. preferir reverter o código em vez de desinstalar e perder vínculos;
4. executar o smoke test de consultas, compras e Helpdesk após a reversão.

DevOps Conexão Azul Digital