Cadastros de séries responsáveis e contas de e-mail

São três cadastros de apoio, reaproveitados entre as campanhas do cliente:

• Séries, no grupo Cadastros: o formato do número da sorte, como 042/01987.
• Responsáveis, no grupo Cadastros: o responsável legal que responde pela campanha.
• Contas de e-mail, no grupo Administração: o servidor de envio dos e-mails da campanha.

Nenhum deles é configurado dentro da campanha: a campanha só escolhe, por um select no formulário, qual série, qual responsável e qual conta de e-mail usa. Cada tela segue a permissão do próprio recurso na matriz (Séries, Responsáveis e Contas de e-mail).

Séries

A tela Séries lista as séries com o nome, o formato (quantos dígitos tem a série e o sequencial, e o prefixo quando houver), a faixa da série, quantas campanhas a usam e o status.

O número da sorte tem duas partes: a série e o sequencial. No cadastro entram:

• Nome: único. É por ele que a série é escolhida na campanha.
• Dígitos da série e dígitos do sequencial: cada parte tem no máximo cinco dígitos.
• Início e fim da variação: o intervalo em que a série varia. A faixa precisa caber nos dígitos — com dois dígitos, o teto é 99.
• Prefixo de série, opcional, de 0 a 9: ele ocupa a primeira casa da série sem aumentar o tamanho dela, então sobra um dígito a menos para a variação. Com prefixo, a série precisa de pelo menos dois dígitos.

O bloco "Como o número fica" mostra um exemplo do número, quantas variações a série tem e o fim máximo da faixa. A tela confere a faixa antes de salvar e explica o erro.

A série é da campanha, no card do Sorteio

A série é escolhida no formulário da campanha, no card da modalidade Sorteio, no campo "Série (formato do número da sorte)". Ela é obrigatória no Sorteio e não existe nas outras modalidades. Não fica mais na regra de geração.

A série pode ser trocada à vontade até a campanha gerar o primeiro número da sorte. Depois disso o campo fica travado, para qualquer papel — nem o Master troca —, e a tela explica: trocar deixaria a campanha com números em dois formatos. Para usar outra série, é preciso criar uma campanha nova. Nessa situação o card também não deixa remover a modalidade Sorteio.

Inativar e excluir série

Inativar tira a série da lista de escolha das campanhas, e o painel não aceita escolher uma série inativa. Mas a série que uma campanha já usa continua valendo mesmo se for inativada depois: no card do Sorteio ela aparece com o nome seguido de "(inativa)" e a nota "Inativada depois de escolhida — continua valendo nesta campanha." Isso é normal e não pede nenhuma ação.

Excluir depende do uso. Sem nenhuma campanha usando, a série é removida definitivamente. Em uso por alguma campanha, ela é apenas inativada, para preservar o histórico, e a confirmação diz isso antes do clique.

Responsáveis

Toda campanha precisa apontar para um responsável legal. A tela Responsáveis lista, busca por nome, documento, e-mail ou cargo, cadastra, edita e exclui.

No cadastro entram nome e CPF ou CNPJ, obrigatórios, e cargo, e-mail e telefone, opcionais. O documento pode ser digitado com pontuação: o painel reconhece se é CPF ou CNPJ, confere os dígitos verificadores e avisa se o documento já está cadastrado para outro responsável. O telefone precisa ter DDD. O cargo aparece junto do nome na hora de escolher o responsável da campanha.

Não há ativar ou inativar: excluir é definitivo, e é recusado se o responsável estiver vinculado a alguma campanha. A mensagem de recusa vem do servidor.

No formulário da campanha, quem tem permissão de criar responsáveis vê o botão "Novo responsável", que cadastra sem sair da campanha.

Contas de e-mail

A conta de e-mail é o servidor de envio (SMTP) dos e-mails da campanha — as mensagens de aprovação e reprovação da apuração e os convites da Base. Não é o e-mail de contato do responsável.

No cadastro entram nome, servidor SMTP, porta, usuário SMTP, e-mail remetente (o endereço que aparece como remetente), senha SMTP e a opção Usar SSL/TLS. A cor do e-mail é opcional: é a cor de destaque do modelo do e-mail; em branco, vale a padrão.

A senha é obrigatória na criação e não muda na edição: para trocar, use a ação Trocar senha na lista. Excluir é definitivo e é recusado se a conta estiver vinculada a alguma campanha.

No formulário da campanha, o campo "Conta de e-mail (SMTP)" é opcional e aceita "Nenhuma". Sem conta de e-mail, a campanha não envia os e-mails de aprovação e reprovação, e um convite da Base não pode ser enviado para ela.

Quatro orientações:

Antes de criar a campanha, o cliente precisa ter ao menos um responsável legal cadastrado. Se a campanha vai enviar e-mail, também precisa de uma conta de e-mail. Se vai ter Sorteio, precisa de uma série.

A série define o formato do número da sorte e pode ser trocada até sair o primeiro número. Depois disso ela fica travada para sempre naquela campanha — vale conferir o formato antes de abrir a campanha.

Série marcada como inativa dentro de uma campanha em andamento não é erro: ela foi inativada depois de escolhida e continua valendo para aquela campanha.

Responsável e conta de e-mail em uso por uma campanha não se excluem. A série em uso não se exclui: ela é só inativada.

• Falha: o campo da série no card do Sorteio está desabilitado.
• Possivel causa: a campanha já gerou número da sorte. A partir daí a série não muda para nenhum papel.
• Como orientar: explique a trava que a própria tela mostra. Para usar outra série, é preciso criar uma campanha nova.
• Quando escalar: se a campanha ainda não tiver nenhum número gerado e o campo continuar travado, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a série da campanha aparece com a marca inativa.
• Possivel causa: a série foi inativada no cadastro de Séries depois de ter sido escolhida pela campanha.
• Como orientar: explique que ela continua valendo nesta campanha. Não troque a série por causa disso. Se quiser, reative a série em Cadastros e Séries.
• Quando escalar: não é falha.

• Falha: a série desejada não aparece no select da campanha.
• Possivel causa: a série está inativa. Série inativa não pode ser escolhida.
• Como orientar: reative a série em Cadastros e Séries ou escolha outra ativa.
• Quando escalar: se a série estiver ativa e continuar fora da lista, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: ao excluir uma série, ela foi só inativada.
• Possivel causa: a série é usada por alguma campanha. Série em uso é inativada para preservar o histórico.
• Como orientar: explique que é o comportamento esperado e que a confirmação já avisava. As campanhas que a usam continuam iguais.
• Quando escalar: não é falha.

• Falha: a série não salva e a tela aponta erro na faixa.
• Possivel causa: o fim da variação passa do que cabe nos dígitos, ou o prefixo tomou uma casa da série.
• Como orientar: leia a mensagem da tela e ajuste os dígitos, a faixa ou o prefixo. O bloco "Como o número fica" mostra o fim máximo permitido.
• Quando escalar: se a configuração couber nos dígitos e continuar recusada, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: não dá para excluir um responsável ou uma conta de e-mail.
• Possivel causa: o registro está vinculado a alguma campanha. Exclusão de registro em uso é recusada.
• Como orientar: troque o responsável ou a conta de e-mail nas campanhas que o usam e tente de novo.
• Quando escalar: se o registro não estiver em nenhuma campanha e a exclusão continuar recusada, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o responsável não salva com a mensagem de documento já cadastrado.
• Possivel causa: já existe um responsável com o mesmo CPF ou CNPJ.
• Como orientar: use o responsável que já existe ou corrija o documento.
• Quando escalar: não é falha.

• Falha: a campanha não envia os e-mails de aprovação e reprovação.
• Possivel causa: a campanha está sem conta de e-mail, ou os dados da conta estão errados.
• Como orientar: confira o campo Conta de e-mail (SMTP) no formulário da campanha e os dados da conta em Administração e Contas de e-mail. Se a senha do servidor mudou, use Trocar senha.
• Quando escalar: se a conta estiver configurada e os e-mails continuarem sem sair, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.