Começar
Aparência

Vale na hora e fica lembrada neste navegador.

Decisões

ORG-0017 — Aplicações e endereços

Contexto

Uma stack entrega um produto que pode ter várias aplicações, para públicos diferentes. Sem uma unidade clara de aplicação, imagens, endereços, clients e cores se misturam, e sessões de públicos diferentes acabam no mesmo domínio.

Decisão

  1. Uma aplicação = uma imagem Docker, um serviço Kamal, um endereço e uma família de cor do design system.
  2. O acesso de cada aplicação é declarado: restrito (tudo exige login), público (sem login; declara o que expõe e o que nunca pode expor) ou misto (as rotas públicas listadas uma a uma; o resto exige login).
  3. Endereços pela política de domínios da plataforma: <app>.hibex.app para o usuário final, <app>.<plataforma>.hibex.net para colaboradores; exceções comerciais em hibex.co, com ADR.
  4. A lista de aplicações fica numa ADR da stack (a ADR-0005 pré-escrita) e na ficha.

Alternativas consideradas

AlternativaPor que não
Uma aplicação por stack, com tudo juntoPor que não: públicos diferentes no mesmo domínio e na mesma sessão
Endereços livresPor que não: cookies e sessões cruzam públicos; a plataforma não consegue padronizar o proxy

Consequências

  • Domínios por público isolam sessões por construção.
  • Uma aplicação nova é uma mudança visível: imagem, serviço, endereço, família e acesso.

Mais

O detalhe está na documentação da arquitetura.