Árvore de páginas

01. DADOS GERAIS

Linha de Produto:Franquias e Redes
Segmento:Varejo
Módulo:Server
Função:Lista Código Promocional
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DVARLIVECP-7523


02. SITUAÇÃO/REQUISITO

📄 Documento de Requisitos – Regras de Encerramento de Lista Promocional


Objetivo: Estabelecer as regras de encerramento para uma Lista de Código Promocional, conforme os vínculos da lista com os módulos de benefício, condição e restrição dentro da lógica promocional do sistema.


🧾 Regras de Negócio:

#Situação da ListaAção Esperada
1Lista vinculada apenas ao benefícioNão encerrar lista
2Lista vinculada apenas à condiçãoEncerrar lista
3Lista vinculada apenas à restriçãoEncerrar lista
4Lista vinculada à condição e ao benefícioEncerrar lista
5Lista vinculada à restrição e ao benefícioEncerrar lista

📌 Observações:

  • O encerramento da lista deve seguir o procedimento padrão de mudança de status, como por exemplo: alterar o status da lista para "ENCERRADA" ou equivalente.

  • A não-encerramento significa que a lista permanece ativa e disponível para uso.

03. SOLUÇÃO


🔧 Descrição da Solução

Esta solução implementa as regras de encerramento automático de listas de código promocional, com base na análise de seus vínculos com as entidades:

  • Benefício

  • Condição

  • Restrição

A lógica de verificação será incorporada em um ponto centralizado do backend, no serviço responsável por avaliar o uso da lista (ListaCodigoPromocionalService ou equivalente), garantindo integridade e consistência da regra em toda a aplicação.


📈 Fluxograma da Regra de Encerramento

                 ┌────────────────────────────┐
                 │Verificar vínculos da Lista │
                 └────────────┬───────────────┘
                              │
         ┌────────────────────┼────────────────────┐
         │                    │                    │
      Está apenas        Está apenas          Está apenas
       no benefício?       na condição?         na restrição?
         │                     │                     │
        Sim                   Sim                   Sim
         │                     │                     │
       ┌─▼─┐                ┌──▼──┐              ┌───▼───┐
       │Não│                │Enc. │              │Enc.   │
       │Enc│                │Lista│              │Lista  │
       └───┘                └─────┘              └───────┘
        │
       Não
        │
        ▼
    Verifica se também está em condição ou restrição?
        │
       Sim ─────────────┐
        │               ▼
        │           ┌──────┐
        │           │Enc.  │
        │           │Lista │
        │           └──────┘
        │
       Não
        ▼
┌──────────────┐
│Não encerrar  │
│a lista       │
└──────────────┘

🛠️ Estrutura Técnica

  • A avaliação da regra será feita a partir de métodos de consulta relacionados às tabelas:

    • AGRUP_REST_LISTA_COD_PROMO → restrições

    • RC_ELEM_LISTA_COD_PROMO → condições

    • RB_CODIGO_PROMOCIONAL → benefícios

  • A detecção de vínculos será realizada por meio de verificações:


📦 Impactos no Sistema

  • Backend:

    • Inclusão de lógica no serviço de gerenciamento de listas promocionais.

  • Base de Dados:

    • Sem alterações estruturais previstas.

    • Dependência de integridade dos relacionamentos existentes.

  • Interface (se aplicável):

    • Caso a ação de encerramento seja refletida na interface, deverá ser exibido o status atualizado.


Cenários:


Lista apenas no benefício:


Lista apenas na condição:


Lista apenas nas condições (passo 3):


Lista no benefício e na condição:


  • Sem rótulos