Regras, listas e emergência

Para: Fin · Adm — Conferido em 2026-10-18.

A área Regras e listas é onde você vê as regras que decidem se um saque ou depósito é automático, vai para revisão ou é bloqueado, propõe mudanças com simulação e aprovação, mantém listas de bloqueio e VIPs e aciona o botão de emergência. Ela tem seis abas: Visão geral, Propor mudança, Listas, VIP, Calendário e Emergência.

O que é

As regras são um conjunto versionado por operação: limites de depósito e saque, o teto do saque automático, o multiplicador do automático, a aprovação dupla, o horário do automático, o calendário de feriados e outras políticas. O mesmo conteúdo está em GET /v1/rules (veja Regras (API)); aqui você o vê e o altera pela tela, sem escrever código.

Valores

Esta página não lista os valores padrão das regras. Consulte GET /v1/rules ou a aba Visão geral para ver o que vale na sua operação. A lógica de decisão está em Decisão, limites e regras.

Quem faz o quê:

Ação Quem
Ver regras, histórico, pedidos, calendário e listas Administrador do tenant, Financeiro, Auditor
Propor mudança de regra, calendário ou reversão Administrador do tenant, Financeiro
Aprovar ou recusar mudança de regra Financeiro
Incluir, importar e remover entradas de lista; propor e revogar VIP Financeiro
Suspender o automático e confirmar a emergência Administrador do tenant, Financeiro

Revisor não vê a área. O mesmo conjunto de regras pode ser proposto pela API com a chave de escopo rules:propose; as propostas feitas por ela aparecem na tela só para leitura.

Quando usar

  • Para apertar ou afrouxar limites com segurança, vendo antes o efeito sobre os últimos 30 dias.
  • Para ajustar o horário do automático ou os feriados.
  • Para bloquear um documento, uma chave PIX, um IP ou um dispositivo, ou para dar a um jogador um limite próprio (VIP).
  • Para parar o saque automático de uma moeda na hora, em caso de suspeita de fraude.

Como fazer

Regras iniciais e mudanças

Toda operação nasce com o conjunto de regras inicial do Dracma, já em vigor: ele não passa por aprovação. Daí em diante, qualquer mudança é um pedido:

Sentido O que é Aprovação Espera
Restritiva Torna as regras mais rígidas: limite menor, automático desligado, feriado a mais. 1 pessoa além de quem propôs nenhuma: vigora quando aprovada
Relaxante Torna as regras mais folgadas: limite maior, automático ampliado. 1 pessoa além de quem propôs 24 horas por padrão (o pedido mostra o valor vigente)

Uma proposta que mistura os dois sentidos conta como relaxante. Quem propõe nunca aprova a própria proposta.

Propor uma mudança

  1. Abra Propor mudança. A tela mostra os campos principais de cada moeda e os globais, além de um campo JSON avançado com o conjunto completo.
  2. Edite os campos. Valores em dinheiro vão na menor unidade (1000 = R$ 10,00). Campos que aceitam "desligado" ficam em branco.
  3. Clique em Simular/Validar. O painel valida e mostra uma tabela campo a campo com o sentido de cada mudança (Restritiva ou Relaxante).
  4. Se a mudança for relaxante, a tela mostra a Simulação dos últimos 30 dias: quantos saques cairiam em cada desfecho (Automático, Revisão (1 aprovação), Revisão (2 aprovações), Bloqueado (422)), os itens que mudariam de revisão para automático e a carga da fila por dia.
  5. Escreva a justificativa (de 10 a 1000 caracteres). Na mudança relaxante, marque Li o relatório da simulação.
  6. Clique em Propor mudança. É preciso confirmação recente.

Campos que a tela edita, por moeda: depósito mínimo e máximo; saque mínimo e máximo; automático (máximo por saque e por dia); multiplicador do automático; máximo de saques por dia; aprovação dupla a partir de. Globais: automático ligado; primeiro saque em revisão; pagador deve ser o jogador; espera após trocar a chave PIX; política fora da janela do automático.

Limite da simulação

A simulação não recalcula em cascata: um saque que passaria a ser automático não altera o limite diário dos pedidos seguintes. Use o relatório como estimativa, não como previsão exata.

O sentido é decidido pelo Dracma, campo a campo. Se a regra mudou desde que você abriu a tela, o envio é recusado com "A regra mudou desde que você abriu a tela. Recarregue a página e refaça a edição."

Reverter uma versão antiga: no Histórico de versões, Reverter para esta versão abre uma proposta com o conteúdo daquela versão. Ela cria uma nova versão ao entrar em vigor e segue o mesmo fluxo.

Aprovar, recusar e acompanhar

Na Visão geral, Pedidos de mudança pendentes lista o pedido, o sentido, quem propôs, a justificativa, os votos (x de N) e o time-lock. Clique no pedido para ver o Resumo, a Decisão, O que muda (campo a campo) e as Regras propostas.

  • Aprovar e Recusar aparecem para o Financeiro que não propôs e ainda não votou. Pede motivo e confirmação recente.
  • Cancelar pedido aparece para quem pode propor ou aprovar, enquanto o pedido não vigorou.
  • Um voto de recusa encerra o pedido.

Estados do pedido: Aguardando aprovação, Aprovado, em time-lock, Em vigor, Recusado, Cancelado e Falhou ao aplicar. Durante o time-lock a tela conta o tempo restante ("faltam 2 h 05 min") e, vencido, "vigora na próxima execução".

Calendário e horário do automático

A aba Calendário mostra o fuso da operação, a janela do automático, os dias da semana (1 = segunda a 7 = domingo), o que acontece fora da janela (Aguardar a abertura ou Mandar para revisão), o calendário nacional (BR-national) e as datas extras.

Para propor mudança, use o formulário da aba: ligar o calendário nacional ou acrescentar uma data é restritivo; desligá-lo ou remover uma data é relaxante. O fluxo é o mesmo (Simular, justificar, propor). O fuso e o horário detalhados estão em Dia, fuso e horários.

Listas de bloqueio

A aba Listas mostra as entradas ativas (situação, tipo, efeito, referência, motivo, quem criou, validade) e as remoções pendentes.

Tipos de entrada: documento (CPF/CNPJ), referência do jogador (external_ref), destino (chave PIX, com o tipo cpf, cnpj, email, phone ou random), IP e dispositivo. Efeito: Bloquear, ou Mandar para revisão (só para IP e dispositivo). O valor digitado é guardado apenas como impressão digital; a tela mostra uma referência, nunca o valor.

Tipos aceitos

O seletor da tela pode listar tipos além dos acima. A API aceita só os cinco descritos; qualquer outro é recusado com validation_failed.

  • Incluir entrada vale na hora: 1 pessoa (Financeiro), com motivo e confirmação recente, sem aprovação. A tela avisa: "incluir vale na hora (efeito imediato, sem aprovação)".
  • Importar CSV: cabeçalho kind,value,key_type,effect,reason,expires_at, até 500 linhas e 256 KiB. A prévia mostra quantas linhas são válidas, inválidas e duplicadas, com os valores mascarados; só as válidas e novas são gravadas, e a importação também vale na hora.
  • Remover entrada é um pedido: 1 aprovação de outra pessoa e time-lock. A entrada continua valendo até o pedido vigorar.

Bloquear é restritivo, por isso entra sem espera; tirar o bloqueio é relaxante, por isso espera.

VIP

Um VIP dá a um jogador, numa moeda, um limite próprio do automático: um multiplicador e/ou um máximo por saque. Para propor:

  1. Informe a referência do jogador (external_ref), a moeda, ao menos um limite e a data Vale até (amanhã até 90 dias a partir de hoje).
  2. Escreva o motivo e clique em Propor VIP. É preciso confirmação recente.
  3. O pedido precisa de 1 aprovação de outra pessoa e do time-lock. Só então o VIP passa a valer.

Revogar um VIP é restritivo: vale na hora, com motivo e confirmação recente. A aba mostra os VIPs (jogador, moeda, situação, validade) e os pedidos pendentes.

Emergência: suspender o automático

É o botão de contenção da operação. Suspender automático desliga o saque automático de uma moeda na hora (o automático e o multiplicador ficam zerados): os saques novos dessa moeda passam a ir para revisão.

  1. Na aba Emergência, no cartão da moeda, digite o código da moeda (por exemplo BRL) em "Digite BRL para confirmar". Isso evita suspender a moeda errada.
  2. Escreva o motivo (de 10 a 1000 caracteres) e clique em Suspender automático. É preciso confirmação recente. Uma pessoa basta para acionar.
  3. Outra pessoa confirma em até 24 horas, com motivo, em Emergências registradas. Quem acionou nunca vê o botão Confirmar.
  4. Se passar de 24 horas sem confirmação, a tela mostra "ATENÇÃO: passou de 24 h sem a confirmação de uma segunda pessoa." A suspensão continua valendo.

Para religar o automático use Propor mudança: é uma mudança relaxante (aprovação e espera). O alerta "Uso do interruptor de emergência" avisa a equipe (veja Alertas e e-mails).

Não disponível

O painel não tem botão para suspender a operação inteira. O que existe é esta suspensão do automático por moeda. Para suspender a operação, peça ao suporte do Dracma (veja Tenants e operações).

Exemplos

Apertar o automático, com a equipe Ana (Administrador) e Bruno (Financeiro):

Passo Quem O que acontece
1 Ana Em Propor mudança, reduz o "Automático: máximo por saque" e clica em Simular/Validar. A tabela marca o campo como Restritiva.
2 Ana Escreve "Reduzir o teto do automático após aumento de fraude" e propõe.
3 Bruno Abre o pedido, confere O que muda e clica em Aprovar.
4 Dracma O pedido passa a Em vigor logo após a aprovação.

Se Ana quisesse afrouxar o mesmo campo, ela veria a simulação dos últimos 30 dias, marcaria Li o relatório da simulação e, depois da aprovação do Bruno, esperaria 24 horas.

Erros e casos de borda

Mensagem Causa O que fazer
"A regra mudou desde que você abriu a tela. Recarregue a página e refaça a edição." A regra vigente mudou (etag_mismatch). Recarregue e refaça.
"Marque que leu o relatório da simulação para propor um afrouxamento." Falta a caixa na mudança relaxante. Marque a caixa.
"Nada mudou em relação à regra vigente." A proposta é igual à regra atual. Altere um campo.
"O JSON das regras não é um objeto válido." JSON avançado inválido. Corrija o JSON.
"Quem propôs (ou acionou) não pode aprovar, recusar ou confirmar o próprio pedido." self_review_forbidden. Peça a outra pessoa.
"Você já votou neste pedido." already_voted. Nenhuma.
"Este pedido já foi encerrado ou não aceita essa ação agora." invalid_state_transition. Recarregue.
"A confirmação precisa ser igual ao código da moeda." / "Moeda inválida (3 letras maiúsculas)." Emergência mal preenchida. Digite o código exato.
"A validade do VIP deve ser futura e de no máximo 90 dias." Data do VIP fora da janela. Ajuste a data.
"Informe ao menos um limite do VIP (multiplicador ou máximo por saque)." VIP sem limite. Preencha um limite.
"O CSV passa de 256 KiB." / "O CSV passa de 500 linhas." Arquivo grande demais. Divida o arquivo.
"O CSV da confirmação foi alterado ou está corrompido. Refaça a prévia." O conteúdo mudou entre a prévia e a confirmação. Refaça a prévia.
"Data inválida. Use o formato AAAA-MM-DD." Data de expiração mal formada. Corrija.
"Confirme com o fator forte para concluir." step_up_required. Use Confirmar identidade agora.
"Sem permissão para esta ação." Seu papel não permite. Peça a quem tem o papel.

Casos de borda:

  • Equipe de uma pessoa. Nenhuma mudança de regra, remoção de lista ou VIP fecha, porque falta quem aprove. A emergência e a inclusão em lista funcionam, mas a confirmação da emergência fica em atraso.
  • Proposta feita pela API. Aparece em "Propostas pela API pública (somente leitura)"; decida-a pelo fluxo da API.
  • Relaxar logo depois de endurecer. São dois pedidos independentes, cada um com a sua aprovação.

Veja também