Refatoração de modelo de desconto

03.01.01 Adição de colunas na tabela desconto

Contexto / Gatilho:

• Pelo tools, opção 3

Lógica:

• O sistema deve adicionar as seguintes colunas na tabela desconto:

sglmodeloaplicacao: varchar(10), nullable, default "PERC"

• O sistema deverá atualizar os valores da coluna uma vez segundo o script:

update desconto set sglmodeloaplicacao = case when valor > 0 then 'VAL' else 'PERC' end 

03.02.01 Separação de tela de desconto em abas

Contexto / Gatilho:

• No ambiente Web, ao clicar na opção do menu Cadastro → Venda → Desconto

Lógica:

• O sistema deverá carregar tela com duas abas:

  • "Preço de tabela"

    • Quando clicado sobre a aba, o sistema deve carregar o conteúdo descrito pela seção Aba "Preço tabela"

  • "Preço de venda"

    • Selecionada por padrão
    • Quando clicado sobre a aba, o sistema deve carregar o conteúdo descrito pela seção Aba "Preço venda"
• Visto que o conteúdo de cada uma das abas será diferente, os botões de ação:
  • • "Adicionar"
    • "Gravar"
  • que anteriormente ficavam no canto superior da tela, deverão ser removidos, para serem reposicionados dentro do escopo da grid, dentro do conteúdo das abas.

03.02.02 Aba "Preço tabela"

Contexto / Gatilho:

• No ambiente Web, na tela de descontos, ao clicar sobre a aba "Preço de tabela"

Lógica:

• O sistema deverá exibir conteúdo referenciado conforme o protótipo a seguir:

  • 
• O conteúdo da aba deverá exibir os seguintes elementos visuais:

• Cabeçalho de pesquisa:
  • "Pesquisa rápida": Campo de entrada textual
    
    • Quando pesquisado, a informação do campo é utilizada para comparar com:
      • desconto.descricao
      • desconto.sigla
  • "Vigência de": Campo de entrada, data
  • "Até": Campo de entrada, data
  • "Pesquisa avançada": Texto clicável, para exibir/ocultar os campos de filtros avançados
    • /* Visto que não terá alteração nos filtros avançados, essa documentação não teve como objetivo detalhar todos os campos */
  • Botões de ação:
    • Pesquisar: Quando clicado, dispara a requisição de pesquisa de registros da entidade
    • Limpar: Limpa os valores dos campos de pesquisa
• Grid de informações de controle de cota, contendo
  • Botões de ação
    • Adicionar: Botão que, quando clicado, adiciona nova linha na grid de desconto.
    • Cancelar alteração: cancela alterações da grid ainda não commitadas em banco
    • Gravar: commita as alterações da grid nos respectivos campos

      • Quando gravado, o registro deverá ser persistido na tabela desconto, sendo o detalhe do objeto a seguir:

        {
        	descricao: Valor do campo "Descrição"
        	sgltipodesconto: Valor do campo "Sigla"
        	idclassedesconto: identificador da entidade selecionada no campo "Classe desconto"
        	datainiciovigecia: Valor do campo "Data início vigência"
        	datafimvigencia: Valor do campo "Data fim vigência"
        	faixaquantidademinima: Valor do campo "Faixa quantidade mínima" 
         	faixaquantidademaxima: Valor do campo "Faixa quantidade máxima"
        	sglmodeloaplicacao: Valor do campo "Modelo aplicação" (Se "Percentual" = "PERC", se "Valor"= "VAL")
        	sglaplicacao: "PRCTAB"
        	percentual: Se sglmodeloaplicacao = PERC, Valor do campo "Percentual/Valor"
         	valor: Se sglmodeloaplicacao = VAL, Valor do campo "Percentual/Valor" 
        }

  • Lista de colunas da grid:
    • "Descrição": campo texto, editável, obrigatório
      
      • O valor da coluna é buscado / persistido com base no campo desconto.descricao
    • "Sigla": campo texto, editável, obrigatório, aceitando até 20 caracteres
      • O valor da coluna é buscado / persistido com base no campo desconto.sgltipodesconto
    • "Classe desconto": campo do tipo pesquisa seleção simples, editável, obrigatório
      • As opções do campo deverão seguir conforme implementação atual, definido nesta documentação
        
      • O valor da coluna é buscado / persistido com base no campo desconto.idclassedesconto
    • "Data início vigência": Campo tipo data, não obrigatório, editável
      • O valor da coluna é buscado / persistido com base no campo desconto.datainiciovigencia
      • O campo não pode ter valor maior que o campo "Data fim vigência", se informado
    • "Data fim vigência": Campo tipo data, não obrigatório, editável
      • O valor da coluna é buscado / persistido com base no campo desconto.datafimvigencia
      • O campo não pode ter valor maior que o campo "Data inicio vigência", se informado
    • "Faixa quantidade mínima": campo numérico, não obrigatório, editável
      • O campo deve aceitar apenas valores positivos
      • O campo deve aceitar valores fracionados, com precisão de até 6 casas decimais
      • O valor da coluna é buscado / persistido com base no campo desconto.faixaquantidademinina
      • O campo, quando não informado, deve persistir valor nulo
    • "Faixa quantidade máxima": campo numérico, não obrigatório, editável
      • O campo deve aceitar apenas valores positivos
      • O campo deve aceitar valores fracionados, com precisão de até 6 casas decimais
      • O valor da coluna é buscado / persistido com base no campo desconto.faixaquantidademaxima
      • O campo, quando não informado, deve persistir valor nulo
    • "Modelo aplicação": campo de opções selecionáveis, obrigatório, editável, seleção única, com as seguintes opções selecionáveis:
      • • "Percentual", valor padrão
          • Visto que há possibilidade de o campo estar null no banco, se estiver, considerar 'perc'
        • "Valor"
    • "Percentual / Valor": campo numérico, editável, obrigatório
      • O campo deve aceitar valores positivos e negativos (ainda que o campo esteja preenchido)
      • O valor da coluna é buscado / persistido com base na lógica a seguir:
        • Se sglmodeloaplicacao = PERC,
          • persistir/consultar do campo desconto.percentual
        • Se sglmodeloaplicacao = VAL
          • persistir/consultar do campo desconto.valor
    • "Editar": ícone clicável.
      • Quanto clicado, abre modal de vínculos de desconto com outras entidades
        • /* A modal já existe e não terá sua lógica alterada, portanto, não será detalhada na presente documentação */
    • "Remover": ícone clicável
      • Quando clicado, marca o registro da grid para deleção. A deleção efetiva ocorre após o acionamento do botão de ação "Gravar"

03.02.02 Aba "Preço Venda"

Contexto / Gatilho:

• No ambiente Web, na tela de descontos, ao clicar sobre a aba "Preço de venda"

Lógica:

• O sistema deverá exibir conteúdo referenciado conforme o protótipo a seguir:

  • 

• O conteúdo da aba deverá exibir os seguintes elementos visuais:

• Cabeçalho de pesquisa:
  • "Pesquisa rápida": Campo de entrada textual
    
    • Quando pesquisado, a informação do campo é utilizada para comparar com:
      • desconto.descricao
      • desconto.sigla
  • "Vigência de": Campo de entrada, data
  • "Até": Campo de entrada, data
  • "Pesquisa avançada": Texto clicável, para exibir/ocultar os campos de filtros avançados
    • /* Visto que não terá alteração nos filtros avançados, essa documentação não teve como objetivo detalhar todos os campos */
  • Botões de ação:
    
    • Pesquisar: Quando clicado, dispara a requisição de pesquisa de registros da entidade
    • Limpar: Limpa os valores dos campos de pesquisa
• Grid de informações de controle de cota, contendo
  • Botões de ação
    • Adicionar: Botão que, quando clicado, adiciona nova linha na grid de desconto.
    • Cancelar alteração: cancela alterações da grid ainda não commitadas em banco
    • Gravar: commita as alterações da grid nos respectivos campos

      • Quando gravado, o registro deverá ser persistido na tabela desconto, sendo o detalhe do objeto a seguir:

        {
        	descricao: Valor do campo "Descrição"
        	sgltipodesconto: Valor do campo "Sigla"
        	idclassedesconto: identificador da entidade selecionada no campo "Classe desconto"
        	datainiciovigecia: Valor do campo "Data início vigência"
        	datafimvigencia: Valor do campo "Data fim vigência"
        	faixaquantidademinima: Valor do campo "Faixa quantidade mínima" 
         	faixaquantidademaxima: Valor do campo "Faixa quantidade máxima"
        	sgllogicaexceder: Valor do campo "Lógica aplicação" (Se "Permitir" = null, "Gerar aprovação" = 'APR', "Gerar aprovação com itens" = "APR_ITENS") 		
        	idtipoaprovacao: Identificador da entidade selecionada no campo "Tipo aprovação" 
        	sglmodeloaplicacao: Valor do campo "Modelo aplicação" (Se "Percentual" = "PERC", se "Valor"= "VAL")
        	faixapercentualinicial: Se sglmodeloaplicacao = PERC, Valor do campo "Faixa aplicação inicial"
        	faixapercentualfinal: Se sglmodeloaplicacao = PERC, Valor do campo "Faixa aplicação final"
        	faixavalorminimo: Se sglmodeloaplicacao = VAL, Valor do campo "Faixa aplicação inicial"
        	faixavalormaximo: Se sglmodeloaplicacao = VAL, Valor do campo "Faixa aplicação final"
        	idnaplicaautomatico: Valor do campo "Aplica automático?" (1 se marcado, 0 se desmarcado)
        	percentual: Se sglmodeloaplicacao = PERC, Valor do campo "Percentual/Valor"
         	valor: Se sglmodeloaplicacao = VAL, Valor do campo "Percentual/Valor"
        	sglaplicacao: "PRCVEN"
        }

  • Lista de colunas da grid:
    • "Descrição": campo texto, editável, obrigatório
      
      • O valor da coluna é buscado / persistido com base no campo desconto.descricao
    • "Sigla": campo texto, editável, obrigatório, aceitando até 20 caracteres
      • O valor da coluna é buscado / persistido com base no campo desconto.sgltipodesconto
    • "Classe desconto": campo do tipo pesquisa seleção simples, editável, obrigatório
      • As opções do campo deverão seguir conforme implementação atual, definido nesta documentação
      • O valor da coluna é buscado / persistido com base no campo desconto.idclassedesconto
    • "Data início vigência": Campo tipo data, não obrigatório, editável
      • O valor da coluna é buscado / persistido com base no campo desconto.datainiciovigencia
      • O campo não pode ter valor maior que o campo "Data fim vigência", se informado
    • "Data fim vigência": Campo tipo data, não obrigatório, editável
      • O valor da coluna é buscado / persistido com base no campo desconto.datafimvigencia
      • O campo não pode ter valor maior que o campo "Data inicio vigência", se informado
    • "Faixa quantidade mínima": campo numérico, não obrigatório, editável
      • O campo deve aceitar apenas valores positivos
      • O campo deve aceitar valores fracionados, com precisão de até 6 casas decimais
      • O valor da coluna é buscado / persistido com base no campo desconto.faixaquantidademinina
      • O campo, quando não informado, deve persistir valor nulo
    • "Faixa quantidade máxima": campo numérico, não obrigatório, editável
      • O campo deve aceitar apenas valores positivos
      • O campo deve aceitar valores fracionados, com precisão de até 6 casas decimais
      • O valor da coluna é buscado / persistido com base no campo desconto.faixaquantidademaxima
      • O campo, quando não informado, deve persistir valor nulo
    • "Lógica aplicação": campo de opções selecionáveis, obrigatório, editável, seleção única, com as seguintes opções:
      • • "Permitir": valor nulo
        • "Bloquear": valor "BLQ"
        • "Gerar aprovação": valor "APR"
        • "Gerar aprovação por itens": valor "APR_ITENS"
    • "Tipo aprovação": campo do tipo pesquisa seleção simples, editável
      • O campo deverá ser obrigatório quando a opção selecionada do campo "Lógica aplicação" for "Gerar aprovação" ou "Gerar aprovação por itens"
      • As opções do campo deverão seguir conforme implementação atual
      • O valor da coluna é buscado / persistido com base no campo desconto.idtipoaprovacao
    • "Modelo aplicação": campo de opções selecionáveis, obrigatório, editável, seleção única, com as seguintes opções:
      • • "Percentual", valor padrão
          • Visto que há possibilidade de o campo estar null no banco, se estiver, considerar 'perc'
        • "Valor"
    • "Faixa aplicação inicial": campo numérico, obrigatório, editável
      • O campo deve aceitar valores positivos e negativos
      • O campo deve aceitar valores fracionados, com precisão de até 6 casas decimais
      • O valor da coluna é buscado / persistido com base na lógica a seguir:
        • Se sglmodeloaplicacao = PERC,
          • persistir/consultar do campo desconto.faixapercentualinicial
        • Se sglmodeloaplicacao = VAL
          • persistir/consultar do campo desconto.faixavalorminimo
    • "Faixa aplicação final": campo numérico, obrigatório, editável
      • O campo deve aceitar valores positivos e negativos
      • O campo deve aceitar valores fracionados, com precisão de até 6 casas decimais
      • O valor da coluna é buscado / persistido com base na lógica a seguir:
        • Se sglmodeloaplicacao = PERC,
          • persistir/consultar do campo desconto.faixapercentualfinal
        • Se sglmodeloaplicacao = VAL
          • persistir/consultar do campo desconto.faixavalormaximo
    • "Aplica automático?": campo texto, editável exibindo Ativo/Inativo quando o campo desconto.idnaplicaautomatico estiver com respectivos valores 1/0. Ao editar o campo, o tipo do campo vira check-box marcada/desmarcada quando o campo desconto.idnaplicaautomatico estiver com respectivos valores 1/0
      • O valor da coluna é buscado / persistido com base no campo desconto.idnaplicaautomatico
    • "Percentual / Valor": campo numérico
      • O campo deve ser editável e obrigatório somente quando o campo "Aplica automático?" estiver marcado
      • O campo deve aceitar valores positivos e negativos (ainda que o campo esteja preenchido)
      • O valor da coluna é buscado / persistido com base na lógica a seguir:
        • Se sglmodeloaplicacao = PERC,
          • persistir/consultar do campo desconto.percentual
        • Se sglmodeloaplicacao = VAL
          • persistir/consultar do campo desconto.valor
    • "Oferta / Vitrine": Ícone clicável, que será implementado por esta documentação
    • "Editar": ícone clicável.
      • Quanto clicado, abre modal de vínculos de desconto com outras entidades
        • /* A modal já existe e não terá sua lógica alterada, portanto, não será detalhada na presente documentação */
    • "Remover": ícone clicável
      • Quando clicado, marca o registro da grid para deleção. A deleção efetiva ocorre após o acionamento do botão de ação "Gravar"

03.03.01.01.01 Aplicação de filtro de faixapercentual de maneira fixa na busca de descontos

Contexto / Gatilho:

• No ambiente Web, na configuração de busca de descontos (Configuração → Configuração pedido → Busca Produto → registro de DESCONTO)
  • Ao verificar os campos de filtro, tanto de busca por níveis como pelos filtros gerais

Lógica:

• O sistema deverá remover a possibilidade de selecionar o registro "FAIXAPERCENTUAL", que atualmente pode ser selecionado opcionalmente.

03.03.01.01.02 Implementação de filtragem fixa de descontos por faixa de aplicação

Contexto / Gatilho:

• No ambiente Web / Mobile

Lógica:

• O sistema deve

03.03.01.02 Migration para diminuir impacto legado na aplicação de filtro fixo de faixapercentual

Contexto / Gatilho:

Lógica:

03.03.02 Alteração de lógica de bloqueio de descontos na ausência de políticas encontradas

Contexto / Gatilho:

Lógica: