Configuração de implantação

As aplicações da Fábrica de Cálculos leem sua configuração no início da execução. Imagens e artefatos de build permanecem iguais entre ambientes; endereços, credenciais, limites e integrações são fornecidos pela plataforma de implantação.

Contrato público

A documentação pública descreve apenas o que um usuário ou integrador consegue observar:

• endereços e formatos das APIs publicados no portal de APIs;
• fluxo de sessão e identidade descrito em Autenticação;
• códigos HTTP, envelopes e limites documentados por endpoint;
• comportamento das interfaces e calculadoras.

Os nomes das chaves de implantação, valores por ambiente, topologia entre serviços, caminhos operacionais e procedimentos de administração não fazem parte desse contrato. Esses dados ficam no catálogo interno do repositório, junto de cada contexto responsável.

Responsabilidades das aplicações

Cada aplicação declara em código a forma e os valores padrão seguros de sua configuração. A substituição feita pela plataforma ocorre somente no início da execução e não deve exigir um novo build.

Configurações obrigatórias são validadas antes de a aplicação aceitar tráfego. Quando uma integração essencial não está disponível, o serviço deve falhar de modo explícito ou responder com o erro previsto no contrato público; ele nunca deve degradar silenciosamente para um modo menos seguro.

Orientação para integradores

Integradores não precisam conhecer a configuração interna da implantação. Para consumir uma API, use o endereço público e o mecanismo de autenticação apresentados no portal. Para executar o projeto localmente, siga o guia de setup, que delega a preparação ao assistente do monorepo sem publicar o inventário operacional.