Deploy com contêineres

As aplicações da Fábrica de Cálculos são empacotadas em imagens reproduzíveis. Interfaces estáticas são servidas por nginx; aplicações Nuxt/Nitro com rotas de servidor executam em Node.js.

Fluxo de build

O build segue quatro responsabilidades, isoladas em estágios:

1. preparar Node.js, pnpm e Turborepo;
2. reduzir o monorepo ao contexto necessário para a aplicação;
3. instalar as dependências bloqueadas pelo lockfile e produzir o artefato;
4. copiar somente o resultado para uma imagem mínima de execução.

Essa separação reduz o tamanho final e impede que ferramentas de desenvolvimento sejam carregadas para o ambiente de execução.

Configuração em tempo de execução

A mesma imagem deve poder avançar entre ambientes. Valores específicos da implantação são fornecidos somente ao iniciar o contêiner e são validados antes de a aplicação aceitar tráfego.

O inventário de chaves, os valores por ambiente, a topologia de serviços e os procedimentos de operação são internos. A superfície pública mantém apenas os contratos observáveis descritos em Configuração de implantação.

Estado e escalabilidade

As calculadoras e APIs que não persistem estado local podem ser replicadas horizontalmente. Aplicações com persistência dependem do armazenamento compartilhado definido pela plataforma. Fluxos assíncronos mantidos em memória têm suas limitações registradas no contrato da API correspondente.

Desenvolvimento local

O monorepo oferece um assistente para subir o ambiente integrado:

pnpm dev:docker

O próprio comando apresenta as opções, informa os endereços resultantes e oferece comandos de consulta e encerramento. Detalhes de infraestrutura permanecem no material interno para evitar que o guia público se torne um mapa da implantação.