Decisões Técnicas do Hotsite V2
Resumo das decisões técnicas registradas do hotsite e o efeito prático de cada uma no atendimento
O que e?
As decisões técnicas (ADRs) registram por que o hotsite foi construído de um jeito e não de outro. Elas são escritas para o time de desenvolvimento, mas várias explicam comportamentos que o participante percebe. Este artigo resume cada uma pelo efeito prático.
Como funciona?
Decisões registradas hoje:
- ADR-001, Next.js com App Router (aceita): tecnologia base do site. Sem efeito direto no atendimento.
- ADR-002, site somente por rota de campanha (aceita): o site só existe dentro de /campanha/nome-da-campanha. A raiz do domínio mostra "Página não encontrada". A exceção posterior é o Portal Premify, em /portal.
- ADR-003, IIS como proxy para Node (vale só para o hotsite legado): o hotsite novo roda em Docker atrás do servidor web da API.
- ADR-004, arquivos e comprovantes em /files (aceita e provisória): os comprovantes de nota ficam numa pasta persistente publicada pelo próprio site, até a API ganhar o envio de arquivos.
- ADR-005, configuração centralizada (aceita): endereços e chaves de serviços ficam num lugar só e são conferidos pelo sistema.
- ADR-006, tradução com idioma lido no servidor (aceita): o site funciona em português, espanhol e inglês, e a primeira tela já sai no idioma escolhido.
Quando uma decisão muda, ela não é apagada: ganha uma revisão ou uma nova ADR.
Como explicar ao cliente?
Normalmente não é preciso falar de ADR com o cliente. Use estes registros para explicar o porquê de comportamentos que parecem estranhos, como a raiz do domínio sem conteúdo, o login separado por campanha ou o site que não muda de idioma sozinho pelo navegador.
Possiveis falhas, causas e solucoes
- Falha: o cliente pede uma página inicial no domínio com todas as promoções.
- Possivel causa: a raiz não tem conteúdo por decisão (ADR-002). A vitrine de promoções é o Portal Premify.
- Como orientar: indique o endereço site.premify.com.br/portal.
- Quando escalar: pedido de mudança de produto, não falha. Registrar como solicitação.
- Falha: o participante diz que o site abriu em português mesmo com o navegador em espanhol.
- Possivel causa: comportamento esperado (ADR-006). O idioma só muda pelo seletor do site.
- Como orientar: oriente escolher Español ou English no seletor do topo da página.
- Quando escalar: não é falha.
Exemplo de resposta pronta
Olá! O site da campanha funciona sempre a partir do link da promoção, e o idioma pode ser trocado no seletor no topo da página (Português, Español ou English). Se quiser ver todas as promoções em andamento, acesse o Portal Premify em site.premify.com.br/portal.
Quando escalar?
Decisões técnicas não geram incidente por si. Escale, abrindo issue no Jira (projeto DEV), quando um comportamento contrariar o que a decisão descreve, por exemplo comprovantes que se perdem após uma publicação ou o idioma voltando sozinho para português depois de escolhido.
Artigos relacionados
Por que o hotsite só abre com o nome da campanha no endereço e por que a raiz do domínio mostra página não encontrada
O IIS como porta de entrada vale só para o hotsite legado e o hotsite novo roda em Docker
Como os comprovantes de nota enviados no hotsite são guardados e publicados e por que essa solução é provisória
Por que endereços e chaves do hotsite ficam num lugar só e o que acontece quando um deles está errado
Como o participante troca o idioma do hotsite entre português e espanhol e inglês e o que é ou não traduzido