Configuração do Servidor do Hotsite
Por que endereços e chaves do hotsite ficam num lugar só e o que acontece quando um deles está errado
O que e?
É a decisão técnica (ADR-005, aceita) de concentrar num único ponto a configuração do servidor do hotsite: o endereço da API, o endereço público do site e dos arquivos, o serviço de consulta de NFC-e e a chave da inteligência artificial que identifica produtos. Essa configuração é do servidor e não tem relação com a configuração da campanha no painel.
Como funciona?
- Cada endereço é conferido pelo sistema: valor ausente ou mal escrito gera erro logo, em vez de uma falha silenciosa.
- Chaves e endereços internos ficam só no servidor e nunca chegam ao navegador do participante.
- A configuração fica num arquivo do servidor, fora do código, e é preservada entre as publicações.
- A chave da inteligência artificial é opcional: sem ela o site funciona e só a identificação automática de produtos fica indisponível.
Como explicar ao cliente?
A configuração técnica do hotsite é única para todas as campanhas e é cuidada pelo time técnico. O cliente não precisa nem consegue alterá-la; tudo o que é da campanha fica no painel.
Possiveis falhas, causas e solucoes
- Falha: depois de uma publicação, uma parte do site para em todas as campanhas (por exemplo comprovantes que não abrem ou leitura de QR Code que nunca funciona).
- Possivel causa: um endereço de serviço configurado errado no servidor.
- Como orientar: informe que o time técnico está verificando. Para a nota, oriente o preenchimento manual.
- Quando escalar: acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com o horário e o que parou.
- Falha: a tela avisa "A identificação automática dos produtos está indisponível".
- Possivel causa: a chave da inteligência artificial não está configurada ou o serviço está fora.
- Como orientar: oriente adicionar os produtos manualmente. O cadastro da nota funciona normalmente.
- Quando escalar: só se o recurso for esperado e continuar indisponível por mais de um dia, abrindo issue no Jira (projeto DEV).
Exemplo de resposta pronta
Olá! Neste momento a identificação automática dos produtos está indisponível, mas você pode concluir o cadastro normalmente: basta adicionar os produtos participantes da sua compra manualmente antes de enviar.
Quando escalar?
Acione urgentemente o time de desenvolvimento e abra issue no Jira (projeto DEV) quando um recurso parar em todas as campanhas ao mesmo tempo, principalmente logo após uma publicação. Envie o horário em que começou, o recurso afetado e os prints.
Artigos relacionados
Quais serviços o hotsite usa e o que o participante vê quando cada um falha
Onde o hotsite roda e como novas versões são publicadas e o que conferir quando algo sai do ar
Resumo das decisões técnicas registradas do hotsite e o efeito prático de cada uma no atendimento