Please enable JavaScript.

Coggle requires JavaScript to display documents.

Alterações Auto Updater, Criar Utilitário de Execução de Patchs no PDV…

- - - - Método RealizarDownloads
        
        Eagle.AutoUpdater.Command.Impl.DownloadPatchsAmazonS3: invoca o serviço responsável pelo download de Patchs
        
        :check: No método Executar, adicionar outro IF para realizar o download dos Patchs do bucket do PDV
        
        :check:Passar o bucket do PDV como parâmetro e também a versão, que ficam no registro
        
        :check: verificar também se a versão do PDV é válida - diferente de "beta"
        
        :check:Adicionar também verificação para checar se é servidor (tanto para o Eagle Gestão quanto para o PDV)
        
        Eagle.AutoUpdater.Model.Service.Impl.DownloaderPatchsAmazonS3:: responsável por verificar se existe arquivo para ser baixado, realizar a criação de pastas e chamar o serviço que faz o downloads
        
        :check:Modificar o método DeveBaixarArquivo para verificar se o patch também não existe na pasta PatchsNaoExecutados. O caminho da pasta deverá estar em uma constante da unit Eagle.AutoUpdater.Core.Utils.Consts
        
        Eagle.AutoUpdater.Command.Impl.DownloadAtualizadores: serviço responsável pelo download do instalador do Falcon SL
        
        Eagle.AutoUpdater.Command.Impl.DownloadApplicationFilesAmazonS3: invoca o serviço responsável pelo download de Arquivos/Executáveis
        
        :check:No método ExecutarDownloads, adicionar outro IF para realizar o download dos Executáveis do bucket do PDV
        
        :check:Passar o bucket do PDV como parâmetro e também a versão, que fica no registro
        
        :check: verificar também se a versão do PDV é válida - diferente de "beta"
        
        Eagle.AutoUpdater.Model.Service.Impl.DownloaderArquivosAmazonS3: gerencia o download de arquivos. Responsável por verificar se existe arquivo para ser baixado, realizar a criação de pastas e chamar o serviço que faz o downloads
        
        Herdam de Eagle.AutoUpdater.Model.Service.Impl.DownloaderAmazonS3: Ela quem faz os downloads, mas os filtros e condições são decididos pelas classes filhas
        
        Eagle.AutoUpdater.Model.Service.Impl.NotificadorDownloads: por meio de eventos, invoka os serviços TGeradorNotificacoesDownloadsPendentes e TAtualizadorIconeDownloadsPendentes
        
        TGeradorNotificacoesDownloadsPendentes: serviço para gerar notificações na barra de tarefas
        
        TAtualizadorIconeDownloadsPendentes: serviço para atualizar o ícone e o hint do Auto Updater na bandeja
        
        :check:Adicionar a constante PASTA_DOWNLOADS_PDV_EXPRESSO em Eagle.AutoUpdater.Core.Utils.ConstantesDownloads (similar a do Eagle Gestão)
        
        :check:Adicionar constantes PASTA_PATCHS_EXECUTADOS_PDV_EXPRESSO e PROJETO_PDV_EXPRESSO_BUCKET em Eagle.AutoUpdater.Core.Utils.Consts (similares as do Eagle Gestão)
        
        :check:No método RealizarDownloads, remover IF que verifica se é servidor (deve ser verificado dentro do serviço)
        
        :check:Adicionar constantes IDENTIFICADOR_EVENTO_PATCH_INCOMPATIVEL_TODOS_BANCOS, NOME_PASTA_PATCHS_NAO_EXECUTADOS, PASTA_PATCHS_NAO_EXECUTADOS_EAGLE_GESTAO e PASTA_PATCHS_NAO_EXECUTADOS_PDV_EXPRESSO na unit Eagle.AutoUpdater.Core.Utils.Consts
        
        :check:Seguir padrão das contantes semelhantes
      - Método RealizarSubstituicoes
        
        Eagle.AutoUpdater.Command.Impl.SubstituidorDownloads: gerencia a substituição de arquivos baixados
        
        :check:Renomear método SubstituirDownloads para SubstituirDownloadsAplicacoes
        
        :check:Atualizar chamada no método Executar
        
        Eagle.AutoUpdater.Core.Utils.SubstituidorExecutavel: reponsável por fazer a substituição de arquivos. Apesar do nome, aparentemente troca outros tipos de arquivos, além de executáveis (mas se for executáveis, verifica se o processo do mesmo está em execução antes de trocar).
        
        :check:Renomear SubstituirDownloadsEagleGestao para SubstituirDownloads e modificar para que o mesmo receba como parâmetro o caminho da pasta de downloads da aplicação, o caminho da pasta da aplicação e o texto padrão do log
        
        :check:Atualizar método SubstituirDownloadsAplicacoes para chamar o método SubstituirDownloads duas vezes, uma para o Eagle Gestão e outra para o PDV Expresso
        
        :check:Criar na própria classe a constante LOGS_DOWNLOADS_PDV_EXPRESSO_SUBSTITUIDOS_COM_SUCESSO. Demais valores estão em constantes da classe Eagle.AutoUpdater.Core.Utils.ConstantesDownloads e também na Sessão
  - - - :check:Semelhante a classe Eagle.AutoUpdater.Common.Model.Impl.ConfiguracoesEagleGestao (precisa ter o número da versão e as informações de acesso ao banco de dados)
        
        :check:O PDV até possui o campo AppVersion no Registro, mas o mesmo é gravado pelo localconf e fica sempre com o valor "Beta".
        
        :check:Será necessário alterar os scripts do Inno Setup para que a versão passe a ser gravada quando o a aplicação for instalada/atualizada
        
        :check: O Auto Updater só faria o Download de correções do PDV a partir da versão em que está implementação fosse liberada
        
        :check:Remover a gravação no registro de dentro do localconf, para que não sobrepor o valor da instalação/atualização
      - :check:No Regedit do PDV as informações do banco de dados não ficam em uma pasta separada (como no Eagle Gestão), mas acho que é interessante criar uma classe separada para elas, pois, vai facilitar no momento de executar os patchs.
        
        :check:Classe deve herdar de Eagle.AutoUpdater.Common.Model.BancoDados
        
        :check:Na classe TConfiguracoesPDVExpresso a propriedade BancoDados deve ser do tipo concreto (TBancoDadosPDVExpresso) e deve possuir o atributo KeyValue('') vazio
    - - :check:Criar Método CarregarBancoDadosPDV, e fazer com que o mesmo seja adicionada na lista retornada pelo método Carregar
        
        :check:Setar nome do banco como PDVEXPRESSO
  - - - Eagle.AutoUpdater.Model.Service.Impl.GeradorListaAplicacoesComDownloadsPendentes: gera a lista de aplicações para serem exibidas no hint da bandeja
        
        :check:Modificar a constante APLICACOES_MONITORADAS em Eagle.AutoUpdater.Core.Utils.ConstantesDownloads, adicionando o projeto do PDV (para que ele possa aparecer no hint do bandeja e na notificação)
    - - :check:Abaixo do check Servidor, criar o check Terminal PDV
      - :check:Na aba aplicações, criar um edit com label PDV Expresso e botão "...", onde o usuário selecionará o caminho onde o PDV Expresso está instalado (igual ao do Eagle Gestão)
      - :check:Criar também outro check Habilitado a frente do edit do PDV Expresso, se o mesmo estiver marcado o usuário é obrigado a informar o caminho do PDV (igual ao Eagle Gestão). Validação no método ValidarDados
      - :check:Tratar salvamento das configurações no método CarregarSessao, adicionando as novas propriedades
      - :warning:Nomes verificados com a Analista de Negócisos
      - :check:Tratar carregamento das novas configurações no método CarregarConfiguracoes
      - :check:Tratar validações no método ValidarDados
    - - :check:Será necessário criar a tabela PATCHS no PDV, com a mesma estrutura do Eagle Gestão
      - :check:Adicionar tratamento para especificar qual aplicação está sendo feita a execução do patch
    - - No método OnLogListener tratar para que o log também seja salvo em arquivo. Esse método é invocado via evento em caso de falhas e sucessos na execução de patchs
        
        Utilizar Loggerpro
    - - :check:Adicionar inserção dos arquivos do PDV no método ExecutarDownload
  - - - :check:Substituir o uso do método RaiseMessageWarning por raise EWarningEXception.Create
    - - :check:: Remover também no PDV (verificado com a analista de negócios)
  - - - :check:Adicionar atributos Alias (todos) e Columns (apenas campo Nome)
- - - - Na abertura do utilitário, Carregar os Patchs já executados no banco (obtidos na tabela PATCHS). É recarregado após a execução com sucesso de um patch
        
        Criar template para grid e realizar vinculação
        
        Criar repository para buscar patchs executados no banco (semelhante ao repository Eagle.AutoUpdater.Model.Repository.Impl.PatchRepository do Auto Udpater)
      - Não permite edição
      - Tem as colunas, IDENTIFICADOR, DATA DA EXECUÇÃO E DESCRIÇÃO (todas vem da tabela PATCHS)
        
        Adicionar Campo Nome (no do Patch)
      - Durante a execução do patch o grid é limpo (provávelmente para desativar conexões simultâneas da arquitetura antiga). Não será necessário na nova arquitetura.
    - - Abrir tela para seleção de arquivos (utilizar o método FDialogService.ShowOpenDialog exemplo no método Pesquisar da classe Eagle.ERP.Financeiro.ViewModel.Impl.ConciliacaoBancariaViewModel
        
        Selecionado arquivo com extensão inválida (diferente de .ZIP)
        
        :warning: Provavelmente não vai ser possível, por causa dos filtros do OpenDialog
        
        Botão Executar Patch é Desabilitado
        
        Label Você precisa selecionar uma arquivo com a extensão .zip fica visível e na cor vermelha
        
        Edit Caminho do Arquivo recebe o endereço do arquivo selecionado
        
        Selecionado arquivo com extensão válida (igual a .ZIP)
        
        Label Você precisa selecionar uma arquivo com a extensão .zip fica invisível
        
        Botão Executar Patch é Habilitado
        
        Edit Caminho do Arquivo recebe o endereço do arquivo selecionado
      - Fica habilitado na abertura do utilitário
      - O diretório inicial é o C:
    - - Fica desabilitado na abertura do utilitário
      - É habilitado após realizar a seleção de um patch válido
      - Realiza a execução do patch selecionado
      - Durante a execução os botões Selecionar Arquivo e Executar Patch ficam desabilitados
    - - Fica invisível durante a abertura do utilitário
      - Fica visível ao selecionar um arquivo com extensão diferente de zip.
      - Fica invisível novamente ao selecionar um arquivo com extensão diferente de zip.
    - - Propriedade Style setada para "pbstMarquee" (assim ela carrega infinitamente)
      - É exibida durante a execução do patch
    - - Desabilitado
      - Recebe o caminho do arquivo selecionado após selecionar um patch
      - NÃO é limpo após a execução do Patch
- - - - Criar método CriarPastaScriptsSeNaoExistir, que gera a pasta onde serão descompactados os scripts (no caso de Eagle Gestão é chamada SCRIPTS)
      - Criar método ExtrairScriptsDoPatch para realizar a extração do patch dentro do diretório criado
        
        Utilizar classe TAbUnZipper do Abrevia para realizar a extração do patch
      - Criar método CarregarConfiguracoesDoPatch, para realizar leitura do JSON de configurações
        
        Criar classe para representar o JSON de configurações e serealizar os campos da mesma utilizando o XSuperObject (semelhante a classe Eagle.AutoUpdater.Model.Entity.Impl.ConfiguracaoPatch do AutoUpdater)
      - Criar método ValidarExecucaoPatch, para validar execução do Patch
        
        Verificar se versão do Eagle Gestão está entre a versão mínma e máxima do patch
        
        Validar se patch já foi executado
        
        Validar CNPJ do patch
        
        Validar aplicação
      - Criar método ExecutarPatch, que realiza a execução do Script do Patch no banco do PDV
        
        Colocar banco de dados em modo exclusivo
        
        Basear no método ShutdownDBFirstConection da classe Eagle.Patch.DatabaseService
        
        :warning: Esse processo não é feito pelo Auto Updater
        
        :warning: Requer que o executável gfix.exe esteja na pasta de instalação, atualmente não vai para o PDV. Adicionar arquivo ao projeto e modificar os scripts do Inno para colocar os arquivos na pasta durante a instalação
        
        Executar Script através do repository
        
        Se basear no método ExecutarArquivoPatch do repository Eagle.AutoUpdater.Model.Repository.Impl.PatchRepository
      - Colocar banco de dados em modo normal
        
        Basear no método TurnNormalOnline da classe Eagle.Patch.DatabaseService
        
        :warning: Esse processo não é feito pelo Auto Updater
      - Criar método RegistrarPatchComoExecutado, para fazer o registro da execução do Patch
        
        Fazer de forma semelhante ao repository Eagle.AutoUpdater.Model.Repository.Impl.PatchRepository
        
        Talvez possa ser necessário realizar a execução do patch e seu registro em uma única transação, devido ao fato do banco estar em modo shutdown. Contudo, em testes que realizei, inicialmente não foi necessário.
  - - - O Patch <<identificador patch>> já foi executado anteriormente e não permite múltiplas execuções.
    - - O Patch requer um banco de dados na versão '<<versão mínima, conforme no json>>' ou superior
    - - Não foi possivel atualizar a tabela Patchs, o banco de dados está desconectado.
    - - Erro ao atualizar a tabela de Patchs, ATENÇÃO o script ja foi executado!
    - - Não foi possivel criar o diretorio!
    - - Debug: ATENÇÃO!||Ocorreu uma falha ao executar o script: <<Mensagem de erro>> As alterações no banco de dados não foram aplicadas.
      - Release: ATENÇÃO!||Ocorreu um erro de SQL. As alterações no banco de dados não foram aplicadas.
    - - Arquivo de configuração não encontrado!
    - - Não foi possivel ler o arquivo de configuração.
    - - Senha de Patch inválida
    - - Não foi possivel ler a versao do banco, o banco de dados está desconectado.
    - - Erro ao tentar ler a versão do banco!
    - - O script patchscript.sql não foi encontrado.
    - - Não foi possivel realizar validação com banco de dados, banco de dados está desconectado.
    - - Não foi possível configurar o Banco de Dados em modo exclusivo. Erro: <<mensagem original>>
    - - Não foi possível retonar o Banco ao estado normal. Erro: <<mensagem original>>
    - - Utilitário gfix não encontrado!||Verifique se o executável "gfix.exe" encontra-se na mesma pasta do sistema ou configurado no PATH do windows.
    - - O Patch requer um banco de dados na versão '<<versão máxima, conforme no json>>' ou inferior
    - - Este patch não pode ser executado neste banco de dados.
    - - Patch incompatível com a aplicação
- - - - :check: Verificar também se a versão do PDV é válida - diferente de "beta"
  - - - :check:As informações estão em constantes e também nos métodos GetBancoDadosEagleGestao e GetBancoDadosPDV
  - - - :check:Validar Documento
        
        :check:Criar método ValidarDocumento
        
        :check:Utiliza método DocumentoDoPatchEhCompativelComBanco para verificar se o patch pode ser executado
        
        :check:Documento é diferente do Documento do Banco
        
        :check:Levanta excessão do tipo EExecutadorPatchException com mensagem específica
        
        :check:Decrementa o contador de bancos compatíveis
        
        :check:Documento é igual ao Documento do Banco
        
        :check:Apenas sai
        
        :check:Se o campo Documento do patch estiver vazio
        
        :check:Apenas sai
        
        :check:Criar método DocumentoDoPatchEhCompativelComBanco
        
        :check:No repository Eagle.AutoUpdater.Model.Repository.Impl.PatchRepository, criar função GetEmpresaDocumento, para retornar o Documento da empresa do Banco
        
        :check:Se o CNPJ do patch for igual ao do banco, retorna verdadeiro, caso contrário, falso
        
        :check:Chamar método ValidarDocumento no método ValidarExecucaoPatch
      - :check:Alterar o método ValidarVersaoDoBanco, para também verificar se a versão do banco não é maior que a versão máxima do patch
        
        :check:Lançar exceção com mensagem específica no caso da versão do banco ser superior à versão máxima
        
        :check:Decrementa o contador de bancos compatíveis
      - Criar método ValidarAplicacao
        
        :check:Se a aplicação do patch for diferente da aplicação da variável global
        
        :check:Levanta excessão do tipo EExecutadorPatchException
        
        :check:Decrementa o contador de bancos compatíveis
        
        :check:Se a aplicação do patch for igual a aplicação da variável global
        
        :check:Apenas sai
        
        :check:Chamar método ValidarAplicacao no método ValidarExecucaoPatch
        
        :check:Caso o campo aplicação do patch esteja vazio, também deverá ser lançada exceção da variável global for PDV. Se for Eagle Gestão, deve permitir execução
      - :check:Alterar métodos Executar para também receber a aplicação como parâmetro
        
        :check:Gravar valor em uma variável global
      - :check:Tratamento para Mover Patchs para a pasta PatchsNaoExecutados
        
        :check:Criar variável global FQuantidadeBancosCompativeisPatch
        
        :check:No método ExecutarPatchs fazer com que variável FQuantidadeBancosCompativeisPatch receba a quantidade de itens da lista FBancosDados
        
        :check:Nas validações de Documento, Versão (Mínima e Máxima) e Aplicação, decrementar a variável FQuantidadeBancosCompativeisPatch
        
        :check:Pois neste caso, o patch não é compatível com o banco de dados
        
        :check:No caso de haver conexões abertas ou o patch já ter sido executado no banco de dados, o contador não deve decrementado (pois o banco não é incompatível)
        
        :check:Após o for, do método ExecutarPatchs, tratar a gravação dos eventos no controlador de estado global
        
        :check:Criar variável Booleana PatchIncompativelTodosOsBancos, a mesma recebe o valor lógico de FQuantidadeBancosCompativeisPatch = ZERO
        
        :check:Gravar o valor da variável PatchIncompativelTodosOsBancos no evento IDENTIFICADOR_EVENTO_PATCH_INCOMPATIVEL_TODOS_BANCOS
        
        :check:Modificar a gravação do evento IDENTIFICADOR_EVENTO_PATCH_EXECUTADO_EM_TODOS_OS_BANCOS para checar se o patch é compatível com pelo menos um banco de dados e se a quantidade de bancos em que o patch foi executado é igual ou maior a quantidade de bancos compatíveis
        
        :check:Criar método GetQuantidadeExecucoesComSucesso, que receba a ListaDeExecucoesDoPatchNosBancos e retorne a quantidade de bancos onde o patch foi executado com sucesso
        
        :check:PatchFoiExecutadoEmTodosOsBancos := not PatchIncompativelTodosOsBancos and (GetQuantidadeExecucoesComSucesso(ListaDeExecucoesDoPatchNosBancos) >= FQuantidadeBancosCompativeisPatch);
        
        :check:Na unit Eagle.AutoUpdater.Core.Utils.Consts, criar nova constante para evento de mover para pasta Patchs Não Executados (IDENTIFICADOR_EVENTO_PATCH_INCOMPATIVEL_TODOS_BANCOS)
      - Criar variável global FNomePatch para armazenar o nome do arquivo Patch
        
        :check:Preencher no próprio método Executar
        
        :check:No método CarregarConfiguracoesDoPatch, após carregar as configurações, verificar se o nome está vazio, e caso esteja preencher o campo com o valor da variável FNomePatch
  - - - :check:Se o valor do evento IDENTIFICADOR_EVENTO_PATCH_INCOMPATIVEL_TODOS_BANCOS for verdadeiro, o patch deve ser movido para a pasta de patchs não executados, que estará na variável FPastaArquivosNaoExecutados
    - - :check:Obter valores das constantes da unit Eagle.AutoUpdater.Core.Utils.Consts
- - - - Nome do Patch
        
        :check: Edit obrigatório, suporta até 100 caracteres. Nome para o patch que será gerado
        
        :check:Foi aumentado de 50 para 100
      - Descrição
        
        :check:Memo obrigatório, suporta até 300 caracteres. Descrição do patch.
        
        :check:Foi aumentado de 200 para 300
      - Versão mínima
        
        :check:Edit obrigatório, máscara "9999.999.9;9;", suporta até 8 caracteres (excluindo a máscara). Versão mínima para execução do patch em um banco de dados.
        
        :check:O usuário deve digitar pelo menos os 7 primeiros caracteres
        
        :warning: A Analista de negócios informou que deve ser mantido o terceiro dígito, mesmo que não utilizado
      - Permite múltiplas execuções
        
        :check: Check que pode ficar marcado ou desmarcado. Indica se o patch pode ou não ser executado mais de uma vez por banco.
      - Diretório onde irá salvar o arquivo Zip
        
        :check: Edit desabilitado, mas de preenchimento obrigatório
        
        :check:Ao clicar sobre o botão "..." abre uma caixa de diálogo para selecionar a pasta onde deverá ser salvo o patch
        
        :check:Caminho selecionado preenche o edit
        
        :check: Utilizar método ShowSelectDirectory do DialogService.
      - Arquivo SQL
        
        :check: Edit desabilitado, mas de preenchimento obrigatório
        
        :check: Ao clicar sobre o botão "..." abre uma caixa de diálogo para selecionar o arquivo sql
        
        :check:Utilizar filtro ".SQL" (semelhante a tela de conciliação bancária)
        
        :check:Ao selecionar um arquivo válido, o caminho do arquivo preenche o edit
        
        :forbidden: No Patch Zipper antigo, se o usuário fechar a caixa de diálogo ou selecionar um arquivo com extensão inválida, o label Selecione um arquivo do tipo SQL fica visível (e em vermelho), e o botão Gerar fica desabilitado. Contudo, agora essa validação será feita quando o usuário clicar em Gerar, logo não será mais necessário esse tratamento.
        
        :forbidden: No patch antigo, se o usuário selecionar um arquivo válido, mas algum dos campos de preenchimento obrigatório estiver vazio, o label Verifique se preencheu todos os campos obrigatórios ficava visível (e em vermelho), mas agora as validações são feitas ao final
      - Aplicação
        
        :check:Combo obrigatório com as opções Eagle Gestão e PDV Expresso, por padrão deverá vir vazio. Indica em qual banco de dados o patch pode ser executado.
        
        :check: Deve ser salvo 1 para Eagle Gestão e 2 para PDV
      - Versão máxima
        
        :check:Edit obrigatório, máscara "9999.999.9;9;", suporta até 8 caracteres (excluindo a máscara). Versão mínima para execução do patch em um banco de dados.
        
        :check:Caso não fique vazio, o usuário deve digitar pelo menos os 7 primeiros caracteres
      - Documento
        
        :check:Edit não obrigatório. Indica o CPF/CNPJ que deve estar no campo EMPRESA_CNPJ da tabela EMPRESA para que o patch possa ser executado
        
        :check:Deve aceitar até 14 dígitos
        
        :check:O campo não é de preenchimento obrigatório
      - Gerar
        
        :check:Botão para ser iniciada a geração do patch.
        
        :warning: No Patch Zipper antigo, o botão iniciava desabilitado, e só era habilitado após informar o arquivo .SQL, quando era verificado se havia sido selecionado um arquivo válido e se todos os campos obrigatórios estavam preenchidos. Contudo, agora ele sempre ficará habilitado, mas realizará as validações ao ser clicado
    - - :check:É gerado o patchconfiguracao.json onde são salvas as configurações do patch
        
        :check:Montar entidade para representar as configurações e utilizar o XSuperObject para gerar o JSON
        
        :check:Também deve ser adicionado um campo jID, o mesmo deve ser preenchido com um identificador único.
        
        :warning:Aparentemente, foi utilizado o método GuidToString do delphi para gerar a jid (removendo so caracteres especiais).
      - :check:O arquivo .sql é renomeado para patchscript.sql
      - :check:Ambos os arquivos são compactados em um arquivo .zip único com senha, o nome do mesmo é o valor informado no campo Nome do Patch
        
        :warning: Utilizar Abbrevia para realizar a compactação do patch
      - :check:Deve ser validado se os campos obrigatórios estão preenchidos, e se os campos Versão Mínima, Versão Máxima, CNPJ e Arquivo SQL estão preenchidos com valores válidos
    - - :check: BorderStyle = Single e em BorderIcons desabilitar a opção biMaximize
    - - :check: Position = poScreenCenter