Decisões
ORG-0017 — Aplicações e endereços
- Status: aceita
- Data: 2026-10-18
- Decide: uma aplicação é uma imagem, um serviço, um endereço e uma família de cor, com acesso declarado
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
- Uma aplicação = uma imagem Docker, um serviço Kamal, um endereço e uma família de cor do design system.
- 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).
- Endereços pela política de domínios da plataforma:
<app>.hibex.apppara o usuário final,<app>.<plataforma>.hibex.netpara colaboradores; exceções comerciais emhibex.co, com ADR. - A lista de aplicações fica numa ADR da stack (a ADR-0005 pré-escrita) e na ficha.
Alternativas consideradas
| Alternativa | Por que não |
|---|---|
| Uma aplicação por stack, com tudo junto | Por que não: públicos diferentes no mesmo domínio e na mesma sessão |
| Endereços livres | Por 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.