Pular para o conteúdo principal

Versão 1.0.x

Visão geral​

Versão 1.0.x é um lançamento de recursos que introduz melhorias significativas na Configuração de e-mail, capacidades de Gerenciamento de servidores e ferramentas de Manutenção do banco de dados. Este lançamento concentra-se em melhorar a confiabilidade das notificações de e-mail, expandir as opções de conexão SMTP e fornecer melhores ferramentas para gerenciar servidores e integridade do banco de dados.

Novos Recursos​

Aprimoramentos de Gerenciamento de servidores​

  • Funcionalidade de alteração de senha do servidor - Os usuários agora podem alterar senhas do servidor diretamente na página de detalhes do servidor clicando no ícone de chave
  • Detecção e mesclagem de servidores duplicados - Nova função no formulário de Manutenção do banco de dados para detectar servidores duplicados e mesclá-los em uma única entrada de servidor

Melhorias de Registro de Auditoria​

  • Registro de auditoria de upload de backup - Todos os uploads de log de backup via o endpoint /api/upload agora são automaticamente registrados no log de auditoria. Cada entrada inclui detalhes do backup (ID do servidor, nome do servidor, nome do backup, status, data, duração, contagens de arquivos, tamanhos, avisos e erros) junto com endereço IP do cliente e informações de agente do usuário para rastreamento e fins de segurança

Aprimoramentos de Configuração de E-mail​

  • Aviso de configuração incompleta - Alerta visual exibido quando as configurações de e-mail não estão devidamente configuradas
  • Indicadores de status do serviço - Rótulos "(Desabilitado)" mostrados nas caixas de seleção de notificações quando os serviços de e-mail não estão configurados
  • Informações do remetente personalizáveis:
    • Campo Nome do remetente para personalizar o nome de exibição mostrado como remetente nas notificações por e-mail
    • Campo Endereço do remetente para especificar o endereço de e-mail mostrado como remetente
    • Nota: Alguns provedores de e-mail substituirão o Endereço do remetente pelo Nome de usuário do servidor SMTP
  • Alternância de autenticação SMTP - Opção para ativar ou desativar a autenticação SMTP, suportando servidores que não exigem autenticação
  • Validação de formato de e-mail - Validação dos campos de endereço do destinatário e do remetente para garantir o formato correto do endereço de e-mail
  • E-mail de teste aprimorado - O e-mail de teste agora exibe detalhes abrangentes de conexão, incluindo nome do host do servidor SMTP, porta, tipo de conexão, status de autenticação, nome de usuário (se aplicável), e-mail do destinatário, endereço do remetente, nome do remetente e data e hora do teste

Suporte a Tipo de Conexão SMTP​

  • Múltiplos tipos de conexão - Suporte para três tipos de conexão:
    • Plain SMTP (sem criptografia) na porta 25
    • STARTTLS (atualizar para TLS) na porta 587
    • Direct SSL/TLS (criptografado desde o início) na porta 465
  • Tipo de conexão padrão - Alterado para Direct SSL/TLS para novas configurações
  • Requisitos específicos da conexão - O campo From Address é obrigatório para conexões Plain SMTP para garantir a identificação adequada do remetente de e-mail e conformidade com RFC 5322

🐛 Correções de Bugs​

Correções do Sistema de E-mail​

  • Corrigido cabeçalho From ausente - Resolvidos erros de conformidade RFC 5322 garantindo que todas as mensagens de e-mail incluam cabeçalhos From apropriados
  • Corrigida criptografia de e-mail para STARTTLS - Corrigido o tratamento de criptografia para conexões STARTTLS (porta 587)
  • Corrigidas conexões SMTP simples - Resolvidos erros de negociação TLS que estavam causando falha nas conexões SMTP simples
  • Corrigida perda de configuração não salva - Impedida a limpeza da configuração de e-mail não salva ao alterar a senha
  • Corrigida configuração SMTP obsoleta - Resolvido problema onde o endpoint de testar e-mail estava usando configuração SMTP desatualizada

Correções da Interface do Usuário​

  • Corrigido toggle de visibilidade de senha - Corrigido o comportamento do recurso de visualizar senha no formulário de alteração de senha; clicar no ícone de olho agora mostra a senha para ambos os campos de senha simultaneamente

Correções do Sistema​

  • Corrigido logging do entrypoint Docker - Resolvido problema onde o script de entrypoint Docker estava descartando mensagens de log
  • Corrigida cálculo da data de Próxima execução - Adicionado recálculo automático da data de Próxima execução após coletar logs de backup, garantindo que a data seja atualizada corretamente após a coleta de logs

🚀 Notas de Migração​

Da Versão 0.9.x​

Esta versão inclui melhorias na Configuração de e-mail e Gerenciamento de servidores. Quando atualizar da Versão 0.9.x:

  1. Não é necessária migração de banco de dados - Esta versão não requer alterações no esquema de banco de dados
  2. Atualizações de configuração de e-mail - As configurações de e-mail existentes continuarão funcionando, mas você pode querer revisar e atualizar suas configurações para aproveitar os novos recursos:
    • Considere definir um Nome de remetente personalizado para melhor identificação de e-mail
    • Verifique se seu Endereço de origem está configurado corretamente, especialmente se estiver usando conexões SMTP simples
    • Teste sua configuração de e-mail usando o recurso aprimorado de teste de e-mail
  3. Padrão de tipo de conexão - Novas configurações de e-mail usarão como padrão o tipo de conexão SSL/TLS direto
  4. Gerenciamento de senha do servidor - Você agora pode alterar senhas do servidor diretamente na página de detalhes do servidor sem precisar coletar backups novamente

Recomendações de Configuração de E-mail​

  • Para uso em produção: Use conexões STARTTLS ou Direct SSL/TLS para entrega segura de e-mail
  • Para testes locais: Conexões Plain SMTP estão disponíveis para redes locais confiáveis
  • Requisito de Endereço do remetente: Quando usar Plain SMTP ou quando a autenticação está desabilitada, certifique-se de que o campo Endereço do remetente está devidamente configurado
  • Teste sua configuração: Sempre use o botão "Enviar e-mail de teste" para verificar se sua configuração de e-mail funciona corretamente

Pontos de Extremidade da API​

Endpoints de Configuração de E-mail​

  • GET /api/email/config - Obter configuração de e-mail
  • POST /api/email/config - Atualizar configuração de e-mail
  • POST /api/email/test - Enviar e-mail de teste
  • DELETE /api/email/config - Excluir configuração de e-mail

Endpoints de Gerenciamento de servidores​

  • PATCH /api/servers/{id}/password - Atualizar senha do servidor
  • POST /api/database/maintenance/merge-duplicate-servers - Mesclar servidores duplicados

Suporte​

Obtendo Ajuda​

Relatando Bugs​

Ao relatar bugs, inclua:

  • Versão: 1.0.x (especifique a versão exata, por exemplo, 1.0.3)
  • Sistema operacional e versão
  • Versão do Docker/podman
  • Tipo de contêiner (Docker ou podman/Pod)
  • Mensagens de erro e logs
  • Passos para reproduzir
  • Detalhes de configuração de e-mail (se relacionado a e-mail)
  • Detalhes de configuração do Podman (se executando em podman/Pod)

Changelog​

Alterações Detalhadas​

  • Adicionado: Funcionalidade de alteração de senha do servidor na página de detalhes do servidor
  • Adicionado: Detecção e mesclagem de servidores duplicados na Manutenção do banco de dados
  • Adicionado: Campos Nome do Remetente e Endereço do remetente na Configuração de e-mail
  • Adicionado: Suporte para conexões Plain SMTP (porta 25)
  • Adicionado: Seleção de Tipo de conexão (Plain SMTP, STARTTLS, Direct SSL/TLS)
  • Adicionado: Alternância de requisito de autenticação SMTP
  • Adicionado: Validação de formato de e-mail para campos de destinatário e endereço do remetente
  • Adicionado: E-mail de teste aprimorado com detalhes de conexão abrangentes
  • Adicionado: Aviso de Configuração incompleta para Configurações de e-mail
  • Adicionado: Rótulos "(desabilitado)" nas caixas de seleção de notificação quando os serviços não estão configurados
  • Adicionado: Entradas de Log de Auditoria para uploads de logs de backup via endpoint /api/upload
  • Alterado: Tipo de conexão padrão para Direct SSL/TLS para novas configurações
  • Alterado: Campo Endereço do remetente agora é obrigatório para conexões Plain SMTP
  • Corrigido: Cabeçalho From ausente em Mensagens de e-mail (conformidade RFC 5322)
  • Corrigido: Criptografia de e-mail para conexões STARTTLS
  • Corrigido: Conexões Plain SMTP falhando com erros de negociação TLS
  • Corrigido: Configuração de e-mail não salva sendo limpa ao alterar Senha
  • Corrigido: Configuração SMTP obsoleta no endpoint de e-mail de Testar
  • Corrigido: Alternância de visibilidade de Senha no formulário de alteração de Senha
  • Corrigido: Script de entrypoint do Docker descartando Logs
  • Corrigido: Data de Próxima Execução não sendo recalculada após coletar logs de backup
  • Melhorado: Experiência do usuário na Configuração de e-mail com melhor validação e feedback

Licença​

Este projeto está licenciado sob a Apache License 2.0.

Copyright © 2025 Waldemar Scudeller Jr.