Histórico da Página

• • Âncora
    campo_modelo_cota campo_modelo_cota

    Modelo de cota: Combo-box com as seguintes opções:
    • • Profissional (valor persistência: usuario)
      • Produto (valor persistência: produto)
      • Filial (valor persistência: filial)
    • As opções não devem aparecer caso já tenham sido selecionada em elementos da lista
      • Por exemplo: Se no primeiro elemento, o usuário selecionar "Profissional", as opções do próximo elemento da lista serão apenas "Produto" e "Filial"
    • A informação preenchida deve ser persistida no campo cotaconfiguracao.valor, onde cotaconfiguracao.sglconfiguracao = 'modelo'

  • Âncora
    campo_selecionar_modelo campo_selecionar_modelo

    "Selecionar": Botão que, quando clicado, abre modal de seleção múltipla para a entidade selecionada em questão
    • O botão somente deve ser visível quando houver Modelo de cota selecionado
    • Quando confirmadas as seleções da modal, o sistema deverá exibir texto `${contagem de registros selecionados} registros selecionados` ao lado do botão "Selecionar"
      • Caso nenhum registro estiver selecionado, exibir "Nenhum registro selecionado"
  • Remover modelo: Ícone que, quando clicado, deve remover o item da lista de modelos selecionados
    
    • O ícone não deve aparecer para o primeiro elemento da lista
• O último elemento da lista deve ser sempre um registro cujo elemento [Modelo de cota] não tenha sido selecionado.
  • Assim que o modelo for selecionado, deve ser inserido mais um elemento vazio ao fim da lista, para garantir a regra acima.

• Âncora
  campo_agrup_cota campo_agrup_cota

  Agrupamento de cota: Combo-box com as seguintes opções:
  • • ${Lista de modelos selecionados no campo Modelo de cota} 
    • Caso a entidade Profissional tenha sido selecionada na lista de modelos selecionados no campo Modelo de cota, o sistema deve exibir a opção:
      • Supervisor (valor persistência: supervisor)
      • Filial (caso não esteja na lista de modelos selecionados no campo Modelo de cota) (valor persistência: filial)
    • Caso a entidade Produto sido selecionada na lista de modelos selecionados no campo Modelo de cota, o sistema deve exibir a opção:
      • Filial (caso não esteja na lista de modelos selecionados no campo Modelo de cota) (valor persistência: filial)

  • A informação preenchida no campo deve ser persistida na tabela cotaconfiguracao, onde:

    Sem Formato
    { idcota: registro de cota referente ao contexto da tela sglconfiguracao: 'agrup' valor: valor referente ao campo selecionado }

• "Selecionar vínculos": botão que, quando clicado, deve abrir modal para seleção de opções de vínculos.
  • A modal de seleção de vínculos deve exibir os seguintes elementos:
    • "Vínculos": título da modal
    • "Pesquisa rápida": Campo de entrada textual, para pesquisar sobre a descrição dos Enums de vínculos que serão exibidos
    • Grid de seleção múltipla, contendo as seguintes colunas:
      • Check-box de seleção dos registros
      • "Descrição": Coluna que deverá exibir a descrição dos Enums de vínculos que serão exibidos
    • Botões de ação, sendo:
      • Cancelar: quando clicado, fecha a modal

      • Confirmar: quando clicado, grava em memória os objetos para persistência na tabela cotaconfigvinculos, onde:

        Sem Formato
        { idcotaconfiguracao: referência da configuração de agrupamento referente à modal sgllogicavinculo: valor do Enum do registro selecionado }

  • O botão somente deve ser exibido quando o campo Agrupamento de cota estiver selecionado com a opção "Filial", e quando aberta, deverá exibir os seguintes Enums:

    Sem Formato
    { Descrição: "Filtrar somente filiais vinculadas aos produtos", valor para persistência: produtofilial } // mostrado apenas quando produto foi selecionado no campo de Modelos de cota { Descrição: "Filtrar somente filiais vinculadas aos profissionais", valor para persistência: usuariofilial } // mostrado apenas quando usuario foi selecionado no campo de Modelos de cota

• O sistema deve realizar a persistência da tabela controlecota, de forma a criar os registros de controle conforme os modelos que foram selecionados.

  
  

  • Para isso, o sistema deve realizar um cross join de todas as seleções de modelos do campo Selecionar, como exemplifica a seguinte sentença SQL:

    Sem Formato
    Nesse exemplo, consideram-se as entidades produto e usuario como modelos selecionados CONSULTA_1 /* select p.idproduto, p.idusuario, null as idlocalfilial from produto p cross join usuario u where p.idproduto in (:lista_produtos_vinculados) and u.idusuario in (:lista_usuarios_vinculados) */

  • Com as combinações das entidades em memória, o sistema deve inserir registros na tabela controlecota, como exemplifica a seguinte sentença SQL:

    Sem Formato
    insert into controlecota (idnativo,saldodisponivel,saldoinicio,idcota,idusuario,idproduto,idlocalfilial) values ( select 1,0,0,:identificador_cota_contexto, idusuario, idproduto, idlocalfilial from CONSULTA_1 )

  • Visto que o processo pode levar um tempo considerável, é importante existir um feedback visual, como barra de progresso, ou no mínino um GIF de carregando com a mensagem: "Finalizando cadastro de cota. Por favor, aguarde. Esse processo pode levar alguns minutos"

• Quando pesquisado, a informação do campo é utilizada para comparar com:
  • produto.descricao referente aos produtos do campo controlecota.idproduto
  • usuario.nome referente aos usuarios do campo controlecota.idproduto
  • local.descricao referente às filiais do campo controlecota.idlocalfilial

• "Unidade": Campo de pesquisa, múltipla seleção, consultando as filiais pertencentes àquela cota
  • Quando preenchido, é utilizado para comparar com o campo controlecota.idlocalfilial
• "Profissional": Campo de pesquisa, múltipla seleção, consultando os usuários pertencentes àquela cota
  •  Quando preenchido, é utilizado para comparar com o campo controlecota.idusuario
• "Produto":  Campo de pesquisa, múltipla seleção, consultando os produtos pertencentes àquela cota
  •  Quando preenchido, é utilizado para comparar com o campo controlecota.idproduto
• "Situação": campos check-box com opções:
  • "Ativo": Marcado por padrão. Quando marcado, filtra registros de credencial onde o campo credencial.idnativo = 1
  • "Inativo": Desmarcado por padrão. Quando marcado, filtra registros de credencial onde o campo credencial.idnativo = 0

• Pesquisar: Quando clicado, dispara a requisição de pesquisa de registros da entidade de controles de cota, utilizando as comparações descritas acima

  • A busca padrão de registros deve considerar os seguintes filtros:
    

    Sem Formato
    select * from controlecota where idnativo = 1 and idcota = (?)

  • Caso a tela tenha sido aberta a partir do botão de editar controles do agrupador de cota, o sistema deve popular os filtros dos modelos vinculados com o agrupador em questão, respeitando o filtro CONSULTA_CONTROLECOTA_VINCULADO_AGRUPADOR

    Sem Formato
    Por exemplo, se clicado no botão editar sobre um agrupamento de supervisor O sistema deverá abrir a tela de controle filtrando o campo "Profissional" com os valores selecionados dos usuários vinculados com aquele supervisor.

• Limpar: Limpa os valores dos campos de pesquisa

• Coluna somente deve ser exibida caso a entidade usuario estiver selecionada nos modelos da cota

  Sem Formato
  /* (select valor from cotaconfiguracao where idcota = ? and sglconfiguracao = 'modelo') */ = 'usuario'

• Coluna somente deve ser exibida caso a entidade produto estiver selecionada nos modelos da cota

  Sem Formato
  /* (select valor from cotaconfiguracao where idcota = ? and sglconfiguracao = 'modelo') */ = 'produto'

• Coluna somente deve ser exibida caso a entidade filial estiver selecionada nos modelos da cota

  Sem Formato
  /* select valor from cotaconfiguracao where idcota = ? and sglconfiguracao = 'modelo' */

"Saldo processado": Campo numérico, somente leitura, exibindo o somatório de todas as movimentações ativas e processadas com relação aos controles de cota que possuem vínculo com o agrupador, sendo:

/*
	select sum(valor) from controlecotamovimento ccm where ccm.idcontrolecota = (?) and ccm.idnativo = 1 and ccm.idnprocessado = 1 
/*

"Saldo a processar": Campo numérico, somente leitura, exibindo o somatório de todas as movimentações ativas e não-processadas com relação aos controles de cota que possuem vínculo com o agrupador, sendo:

/*
	select sum(valor) from controlecotamovimento ccm where ccm.idcontrolecota = (?) and ccm.idnativo = 1 and ccm.idnprocessado = 0
/*

• "Distribuir igualmente"
• "Dividir proporcionalmente ao valor de pedidos anteriores"

• O campo somente deve ser exibido, caso o campo "Modelo de distribuição" estiver marcado com a opção "Dividir proporcionalmente ao valor de pedidos anteriores"
• O valor preenchido no campo deve ser persistido na sessão, de forma que ao abrir a modal novamente, o campo venha previamente preenchido.

• O campo somente deve ser exibido, caso o campo "Modelo de distribuição" estiver marcado com a opção "Dividir proporcionalmente ao valor de pedidos anteriores"
• O valor preenchido no campo deve ser persistido na sessão, de forma que ao abrir a modal novamente, o campo venha previamente preenchido.

Somente devem ser exibidos usuários que pertencem à cota do contexto e estejam com o controle ativo

select idusuario from controlecota where idcota = ? and idnativo = 1

• Caso nenhum registro estiver selecionado, exibir "Nenhum registro selecionado. Aplicável a todos"

Somente devem ser exibidos produtos que pertencem à cota do contexto e estejam com o controle ativo

select idproduto from controlecota where idcota = ? and idnativo = 1

• Caso nenhum registro estiver selecionado, exibir "Nenhum registro selecionado. Aplicável a todos"

Somente devem ser exibidas filiais que pertencem à cota do contexto e estejam com o controle ativo

select idlocalfilial from controlecota where idcota = ? and idnativo = 1

• Caso nenhum registro estiver selecionado, exibir "Nenhum registro selecionado. Aplicável a todos"

• Caso não estiver, rollback + mensagem: Preencha o campo ${"Adicionar saldo" ou "Deduzir saldo" dependendo do que  estiver selecionado}

• Caso verdadeiro, rollback + mensagem: Preencha o campo ${campo não preenchido em questão}

Validar se todos os controles de cotas ativas filtradas pelos filtros de controles de cota de destino receberão o montante definido no campo "Saldo mínimo"

${Saldo a ser distribuido igualmente}
/* select ${Valor do saldo adicionado} / count(*) from controlecota 
where (idusuario in (:filtro_usuario) or (:filtro_usuario) is null) 
and  (idproduto in (:filtro_produto) or (:filtro_produto) is null)  
and  (idlocalfilial in (:filtro_filial) or (:filtro_filial) is null) */

Verificar se ${Saldo a ser distribuido, se igualmente} > ${Valor do saldo mínimo}

• Se falso, rollback + mensagem: "O saldo adicionado não é suficiente para respeitar o saldo mínimo definido"

• Se o campo radio button estiver marcado como "Adicionar saldo"

  • O sistema deverá adicionar um movimento de cota igual positivo na controlecotamovimento para todos os controles de cota filtrados pelos filtros de controles de cota de destino e somá-lo ao saldo do controle de cota, da seguinte forma:
    

    Sem Formato

    Por exemplo, se filtrados usuários e produtos na modal SET1: set de controlecotas a serem atualizadas /* select idcontrolecota from controlecota where idproduto in (?) and idusuario in (?) and idnativo = 1 Para cada registro: /* insert into controlecotamovimento ... values { idprofissional: identificador da entidade do campo "Profissional" idproduto: identificador da entidade do campo "Produto" quantidade: ${Saldo a ser distribuido igualmente} observação: "Movimento criado e processado manualmente pela aplicação", sglorigem: 'WEB' idnativo: 1 idnprocessado: 1 data: current_date datamovimento:current_date } */ /* update controlecota set saldodisponivel = saldodisponivel + ${controlecotamovimento.quantidade} */

    
    

    • O sistema deverá retornar feedback visual toast (Success): "Operação realizada com sucesso"
• Se o campo radio button estiver marcado como "Deduzir saldo"
  • O sistema deverá adicionar um movimento de cota igual negativo na controlecotamovimento para todos os controles de cota filtrados pelos filtros de controles de cota de destino e somá-lo ao saldo do controle de cota
    • Caso o saldo disponível pelo controle de cota não for suficiente para ser deduzido integralmente, o sistema deve retornar o valor que não pôde ser deduzido, com a mensagem pop up:
      • "Dedução de ${${Valor do campo deduzir saldo } - ${Valor que não pôde ser deduzido}} foi realizada com sucesso. Não foi possível deduzir  ${Valor que não pôde ser deduzido} do saldo de cota, devido à saldos disponíveis insuficientes" Opções "OK" e  "Deduzir restante"
      • Ao clicar em ok, fechar a modal
      • Ao clicar em "Deduzir restante", aplicar  ${Valor que não pôde ser deduzido} no campo "Deduzir saldo"

  • Sem Formato

    Por exemplo, se filtrados usuários e produtos na modal SET1: set de controlecotas a serem deduzidas /* select idcontrolecota from controlecota where idproduto in (?) and idusuario in (?) and idnativo = 1 and saldodisponivel > 0 Para cada registro: ${Saldo a ser deduzido} = controlecota.saldodisponivel >= ${Saldo a ser distribuido igualmente} ? ${Saldo a ser distribuido igualmente} : controlecota.saldodisponivel -- Se controlecota.saldodisponivel < ${Saldo a ser distribuido igualmente}, somar os valores que não puderam ser deduzidos ${Valor que não pôde ser deduzido} = ${Saldo a ser distribuido igualmente} - controlecota.saldodisponivel /* insert into controlecotamovimento ... values { idprofissional: identificador da entidade do campo "Profissional" idproduto: identificador da entidade do campo "Produto" quantidade: -${Saldo a ser deduzido} observação: "Movimento criado e processado manualmente pela aplicação", sglorigem: 'WEB' idnativo: 1 idnprocessado: 1 data: current_date datamovimento:current_date } */ /* update controlecota set saldodisponivel = saldodisponivel + ${controlecotamovimento.quantidade} */ -- Caso o saldo disponível não seja suficiente para ser deduzido, o campo saldodisponivel deve obrigatoriamente resultar em 0

    
    

    • Caso o saldo todo pôde ser deduzido, o sistema deverá retornar feedback visual toast (Success): "Operação realizada com sucesso"

•  Se o campo radio button estiver marcado como "Adicionar saldo"

  • A lógica de distribuição será realizada desta forma:

    Sem Formato

    Por exemplo, se filtrados usuários e produtos na modal SET1: set de controlecotas a serem deduzidas /* select idcontrolecota from controlecota where idproduto in (?) and idusuario in (?) and idnativo = 1 /* select sum(pp.quantidadefaturada * pp.precofaturado) as valor from pedidoproduto pp inner join pedido p on pp.idpedido = p.idpedido inner join tiposituacaopedido tsp on tsp.idtiposituacaopedido = p.idtiposituacaopedido where p.idusuario in (:filtro_usuario) and pp.idproduto in (:filtro_produto) and tsp.sgltiposituacaopedido in (:parametro_sim3g.cota.distribuicao.historico.sgltiposituacaopedido /* Deve ser criado pelo tools, opção 18 */ group by pp.idproduto, p.idusuario */ CONSULTA_A /* select sum(valor) as valor_total from CONSULTA_A */ O sistema deverá atribuir peso de 0 a 1 para todos os registros filtrados, com base na relação entre o valor e o valor total /* select idproduto,idusuario,valor/${valor_total} as peso */ CONSULTA_PESOS Com os pesos em mãos, o sistema deverá em primeiro momento contabilizar o excedente entre o saldo a adicionar e o saldo mínimo a adicionar ${Valor total distribuido igualmente} = SET1.size() * ${Valor do saldo mínimo} ${Valor restante} = ${Valor a ser adicionado} - ${Valor total distribuido igualmente} Para cada registro: /* insert into controlecotamovimento ... values { idprofissional: identificador da entidade do campo "Profissional" idproduto: identificador da entidade do campo "Produto" quantidade: ${Saldo a ser distribuido igualmente} + ${${Valor restante} * CONSULTA_PESOS.peso} observação: "Movimento criado e processado manualmente pela aplicação", sglorigem: 'WEB' idnativo: 1 idnprocessado: 1 data: current_date datamovimento:current_date } */ /* update controlecota set saldodisponivel = saldodisponivel + ${controlecotamovimento.quantidade} */

• Se o campo radio button estiver marcado como "Deduzir saldo"
  • • O sistema deverá adicionar um movimento de cota igual negativo na controlecotamovimento para todos os controles de cota filtrados pelos filtros de controles de cota de destino e somá-lo ao saldo do controle de cota
      • Caso o saldo disponível pelo controle de cota não for suficiente para ser deduzido integralmente, o sistema deve retornar o valor que não pôde ser deduzido, com a mensagem pop up:
        • "Dedução de ${${Valor do campo deduzir saldo } - ${Valor que não pôde ser deduzido}} foi realizada com sucesso. Não foi possível deduzir  ${Valor que não pôde ser deduzido} do saldo de cota, devido à saldos disponíveis insuficientes" Opções "OK" e  "Deduzir restante"
        • Ao clicar em ok, fechar a modal
        • Ao clicar em "Deduzir restante", aplicar  ${Valor que não pôde ser deduzido} no campo "Deduzir saldo"

          
          

          Sem Formato

          Por exemplo, se filtrados usuários e produtos na modal SET1: set de controlecotas a serem deduzidas /* select idcontrolecota from controlecota where idproduto in (?) and idusuario in (?) and idnativo = 1 and saldodisponivel > 0 Mesma lógica para encontrar CONSULTA_PESOS da lógica de adição acima Para cada registro: ${Saldo a ser deduzido proporcionalmente ao histórico} = ${Saldo a ser distribuido igualmente} + ${${Valor restante} * CONSULTA_PESOS.peso} ${Saldo a ser deduzido} = controlecota.saldodisponivel >= ${Saldo a ser deduzido proporcionalmente ao histórico} ? ${Saldo a ser deduzido proporcionalmente ao histórico} : controlecota.saldodisponivel -- Se controlecota.saldodisponivel < ${Saldo a ser deduzido proporcionalmente ao histórico}, somar os valores que não puderam ser deduzidos ${Valor que não pôde ser deduzido} = ${Saldo a ser deduzido proporcionalmente ao histórico} - controlecota.saldodisponivel /* insert into controlecotamovimento ... values { idprofissional: identificador da entidade do campo "Profissional" idproduto: identificador da entidade do campo "Produto" quantidade: -${Saldo a ser deduzido proporcionalmente ao histórico} observação: "Movimento criado e processado manualmente pela aplicação", sglorigem: 'WEB' idnativo: 1 idnprocessado: 1 data: current_date datamovimento:current_date } */ /* update controlecota set saldodisponivel = saldodisponivel + ${controlecotamovimento.quantidade} */ -- Caso o saldo disponível não seja suficiente para ser deduzido, o campo saldodisponivel deve obrigatoriamente resultar em 0

          • Visto que o processo pode levar um tempo considerável, é importante existir um feedback visual, como barra de progresso, ou no mínino um GIF de carregando com a mensagem: "Por favor, aguarde. Esse processo pode levar alguns minutos"