Param Manager¶
Parâmetros centralizados, com segredo cifrado e leitura que não cai¶
O Param Manager tira a configuração de dentro do .env de cada máquina e a
coloca num único lugar, versionado e auditável — sem que a aplicação passe a
depender de a rede estar de pé no instante da leitura.
O produto são dois artefatos entregues separadamente e um contrato entre eles:
- fast-param-manager — a API Servidor FastAPI sobre MongoDB, autenticado por Keycloak. Guarda os parâmetros, valida o tipo de cada um, cifra os sensíveis e decide quem pode escrever o quê.
- param-manager — o cliente Biblioteca Python publicada no PyPI. Lê os parâmetros, mantém cache em memória, decifra os segredos e continua respondendo com dado local quando a API não responde.
- O envelope criptográfico O formato em que um segredo é gravado. É contrato congelado: os dois lados implementam a mesma coisa em repositórios que são liberados em datas diferentes.
Por onde começar¶
| Se você quer… | Vá para |
|---|---|
| Entender o produto antes do código | Visão geral |
| Ver como uma requisição atravessa o sistema | Arquitetura |
| Subir a API na sua máquina | Instalação e execução |
| Consumir os parâmetros de uma aplicação Python | Uso do cliente |
| Saber o que pode quebrar quem já está em produção | Compatibilidade |
| Guardar senha ou credencial num parâmetro | Envelope criptográfico |
O que esta documentação assume¶
Que você vai ler o código quando a resposta importar de verdade. Todas as páginas aqui foram escritas conferindo a implementação, e onde o comportamento é surpreendente isso está dito na página em vez de escondido. Quando houver divergência entre o que está escrito aqui e o que o código faz, o código está certo — e a página está com defeito, o que é um problema a ser reportado.
Cada página pode ser levada embora
O botão Baixar .md entrega o arquivo Markdown original, exatamente como está no repositório. O Salvar em PDF abre a caixa de impressão do navegador com uma folha de estilo que remove a navegação — o que sai é só o conteúdo. Os dois estão na barra superior de toda página, junto do seletor de fonte, e a documentação inteira existe em português e inglês.