Pular para o conteúdo principal

Versão 0.7.x

Visão geral​

Versão 0.7.x é uma versão principal que introduz melhorias significativas no esquema de banco de dados, estrutura de API e interface do usuário. Esta versão inclui alterações significativas que exigem atualizações nas Integrações externas.

Mudanças Significativas​

Alterações no Schema do Banco de Dados​

  • Renomeação de Tabela: tabela machines renomeada para servers
  • Novos Campos: adicionados campos alias, notes, created_at e updated_at
  • Alterações na Resposta da API: nomes de campos atualizados para consistência

Alterações de API incompatíveis com versões anteriores​

  • Renomeação de Campo: totalMachines → totalServers
  • Renomeação de Objeto: machine → server em respostas da API
  • Renomeação de Campo: backup_types_count → backupJobsCount
Aviso

Integrações externas que usam a API devem ser atualizadas para funcionar com a versão 0.7.x. Consulte o guia Alterações de API incompatíveis com versões anteriores para mais detalhes.

Novos Recursos​

Gerenciamento de Servidores Aprimorado​

  • Aliases de Servidor: Dê aos servidores nomes amigáveis e memoráveis
  • Notas de Servidor: Adicione descrições e informações adicionais
  • Rastreamento de Status Aprimorado: Melhor monitoramento do status do servidor
  • Detalhes de Servidor Aprimorados: Informações mais abrangentes do servidor

Estrutura de API Melhorada​

  • Formato de Resposta Consistente: Estrutura de resposta de API padronizada
  • Melhor Tratamento de Erros: Mensagens de erro e códigos melhorados
  • Documentação Aprimorada: Melhor documentação de API
  • Novos Endpoints: Endpoints de API adicionais para melhor integração

Melhorias de Banco de Dados​

  • Melhor Desempenho: Consultas de banco de dados otimizadas e indexação
  • Integridade de Dados: Validação de dados e restrições aprimoradas
  • Sistema de Migração: Sistema automatizado de migração de banco de dados
  • Sistema de Backup: Backup do banco de dados e restauração melhorados

Melhorias​

Interface do Usuário​

  • Design Moderno: Interface atualizada com melhor design visual
  • Layout Responsivo: Melhor suporte para dispositivos móveis e tablets
  • Navegação Melhorada: Navegação aprimorada e experiência do usuário
  • Gráficos Melhores: Visualização de gráficos e interatividade aprimoradas

Sistema de Notificações​

  • Modelos Aprimorados: Modelos de mensagens de notificação melhores
  • Entrega Melhorada: Entrega de notificações mais confiável
  • Melhor Tratamento de Erros: Tratamento de erros aprimorado para notificações
  • Registro Aprimorado: Melhor registro para depuração de notificações

Desempenho​

  • Consultas Mais Rápidas: Consultas de banco de dados otimizadas
  • Melhor Cache: Mecanismos de cache aprimorados
  • Uso Reduzido de Memória: Melhor gerenciamento de memória
  • Respostas de API Mais Rápidas: Tempos de resposta de API aprimorados

Correções de Bugs​

Problemas de Banco de Dados​

  • Corrigidos problemas de corrupção de banco de dados em casos raros
  • Resolvidos problemas de migração durante atualizações
  • Corrigidos problemas de perda de dados em cenários específicos
  • Melhorados procedimentos de backup do banco de dados e restauração

Problemas de API​

  • Corrigidas inconsistências de resposta da API
  • Resolvidos problemas de autenticação
  • Corrigidos problemas de validação de dados
  • Melhorado tratamento de erros e mensagens

Interface do Usuário​

  • Corrigidos problemas de carregamento do painel
  • Resolvidos problemas de renderização de gráficos
  • Corrigidos problemas de layout móvel
  • Melhorada exibição de mensagem de erro

Sistema de Notificação​

  • Corrigidos falhas de entrega de notificações
  • Resolvidos problemas de configuração de e-mail
  • Corrigidos problemas de integração com NTFY
  • Melhorado o renderização de modelos de notificação

Guia de Migração​

Migração Automática​

A migração de 0.6.x para 0.7.x acontece automaticamente:

  1. Criação de Backup: Backup automático do banco de dados é criado
  2. Atualização de Schema: Schema do banco de dados é atualizado automaticamente
  3. Migração de Dados: Dados existentes são preservados e migrados
  4. Verificação: Migração é verificada e registrada

Etapas Manuais Obrigatórias​

  • Atualizar Integrações Externas: Atualize qualquer ferramenta externa que usa a API
  • Testar Funcionalidade: Verifique se todos os recursos funcionam corretamente
  • Atualizar Documentação: Atualize qualquer documentação Personalizada

Alterações de Configuração​

Novas Opções de Configuração​

# Server management
servers:
  defaultAlias: true
  showNotes: true
  sortBy: "name" # name, status, lastBackup

# API settings
api:
  version: "1.0"
  rateLimit: 100
  timeout: 30000

# Database settings
database:
  backupRetention: 7
  autoVacuum: true
  optimizeInterval: 24

Opções Descontinuadas​

  • Configuração machines (use servers em seu lugar)
  • Nomes de campos da API antiga (use novos nomes de campos)

Imagens Docker​

Imagens Disponíveis​

  • Docker Hub: wsjbr/duplistatus:0.7.x
  • GitHub Container Registry: ghcr.io/wsj-br/duplistatus:0.7.x
  • Tag Mais Recente: wsjbr/duplistatus:latest

Tamanhos de Imagem​

  • Alpine: 52MB
  • Debian: 85MB
  • Multi-arch: Suporte para ARM64 e AMD64

Instalação​

Docker Compose​

services:
  duplistatus:
    image: wsjbr/duplistatus:0.7.x
    container_name: duplistatus
    restart: unless-stopped
    ports:
      - "9666:9666"
    volumes:
      - duplistatus_data:/app/data
    environment:
      - TZ=UTC

Docker CLI​

docker run -d \
  --name duplistatus \
  --restart unless-stopped \
  -p 9666:9666 \
  -v duplistatus_data:/app/data \
  wsjbr/duplistatus:0.7.x

Instruções de Atualização​

Da Versão 0.6.x​

  1. Faça backup dos seus dados (backup criado automaticamente durante a atualização)
  2. Atualize a imagem Docker: docker pull wsjbr/duplistatus:0.7.x
  3. Reinicie o container: docker-compose down && docker-compose up -d
  4. Monitore os logs: docker logs -f duplistatus
  5. Atualize as integrações: Atualize quaisquer ferramentas externas que usam a API
  6. Verifique a atualização: Verifique se todos os recursos funcionam corretamente

Da Versão 0.5.x ou Anterior​

  1. Primeiro atualize para 0.6.x (se disponível)
  2. Depois atualize para 0.7.x usando as etapas acima

Problemas Conhecidos​

Problemas de Migração​

  • Grandes Bancos de Dados: A migração pode levar mais tempo para bancos de dados grandes
  • Espaço em Disco: Certifique-se de ter espaço em disco suficiente para o backup de migração
  • Permissões: Verificar permissões de arquivo para acesso ao banco de dados

Compatibilidade da API​

  • Ferramentas Externas: Ferramentas externas que usam a API precisam de atualizações
  • Nomes de Campos: Alguns nomes de campos foram alterados
  • Formato de Resposta: Alguns formatos de resposta foram alterados

Soluções alternativas​

  • Migração: Garanta espaço em disco e tempo suficientes para a migração
  • API: Atualize as integrações externas para usar o novo formato de API
  • Testes: Teste todas as funcionalidades após a atualização

Suporte​

Obtendo Ajuda​

Reportando Bugs​

Quando reportar bugs, por favor inclua:

  • Versão: 0.7.x
  • Sistema operacional e versão
  • Versão do Docker
  • Mensagens de erro e logs
  • Passos para reproduzir

O Que Vem a Seguir​

Versão 0.8.x (Planejado)​

  • Monitoramento Aprimorado: Melhor monitoramento de backups atrasados
  • Notificações Melhoradas: Sistema de notificações aprimorado
  • Desempenho: Melhorias adicionais de desempenho
  • Novos Recursos: Recursos adicionais de monitoramento e gerenciamento

Roteiro de Longo Prazo​

  • Análise Avançada: Análise de backup mais detalhada
  • Suporte Multi-Tenant: Suporte para múltiplas organizações
  • Integração em Nuvem: Suporte para provedores de armazenamento em nuvem
  • Aplicativo Móvel: Aplicação móvel nativa

Changelog​

Alterações Detalhadas​

  • Adicionado: Funcionalidade de aliases e notas de servidor
  • Adicionado: API aprimorada com formato de resposta consistente
  • Adicionado: Schema de banco de dados melhorado e desempenho aprimorado
  • Adicionado: Melhor tratamento de erros e logging
  • Adicionado: Interface de usuário e navegação aprimoradas
  • Alterado: Nomes de tabelas do banco de dados (machines → servers)
  • Alterado: Nomes de campos da API para consistência
  • Alterado: Estrutura do formato de resposta
  • Corrigido: Problemas de corrupção de banco de dados
  • Corrigido: Inconsistências de resposta da API
  • Corrigido: Problemas de renderização da interface de usuário
  • Corrigido: Problemas de entrega de notificações
  • Melhorado: Desempenho e estabilidade geral
  • Melhorado: Documentação e experiência do usuário

Colaboradores​

Equipe de Desenvolvimento​

  • Waldemar Scudeller Jr.: Desenvolvedor líder e mantenedor
  • Colaboradores da Comunidade: Relatórios de bugs, solicitações de recursos e testes

Agradecimentos Especiais​

  • Testadores Beta: Por testar versões iniciais e fornecer feedback
  • Comunidade: Por sugestões, relatórios de bugs e suporte
  • Equipe Duplicati: Pelo excelente software de backup que torna este projeto possível