> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciar regras

> Configure regras do Tracer no Console com filtros, ciclo de vida, validação de expressão e escopo por contexto.

Use a página **Regras** para criar e operar regras de decisão do Tracer. Cada regra combina expressão, ação e escopo para influenciar o resultado da validação.

## Acessando a página de Regras

***

No menu lateral do módulo Tracer, selecione **Regras**. A página abre com o título **Fraud Detection Rules** e um painel de ajuda **What is a Rule?**.

## Filtros disponíveis

***

No topo da página, use os filtros para refinar a lista:

| Filtro               | Opções                                            |
| -------------------- | ------------------------------------------------- |
| **Search**           | Busca por nome                                    |
| **Status**           | All, Active, Inactive, Draft                      |
| **Decision**         | All, Aprovar, Rejeitar, Revisar                   |
| **Transaction Type** | All Types, Card, PIX, Wire, Crypto, ACH, Internal |

Você também pode ajustar a quantidade de itens por página.

## Estrutura dos cartões de regra

***

Cada cartão exibe:

* Nome da regra.
* Status (`ACTIVE`, `INACTIVE` ou `DRAFT`).
* Ação (`ALLOW`, `DENY` ou `REVIEW`).
* Descrição (quando preenchida).
* Expressão da regra.
* Data de atualização.

## Ações por regra

***

No menu de ações de cada cartão:

| Ação                    | Comportamento                                           |
| ----------------------- | ------------------------------------------------------- |
| **Details**             | Abre o painel lateral da regra                          |
| **Ativar**              | Move para `ACTIVE`                                      |
| **Desativar**           | Move para `INACTIVE`                                    |
| **Mover para Rascunho** | Disponível para regras `INACTIVE`; retorna para `DRAFT` |
| **Excluir**             | Remove a regra permanentemente, com confirmação         |

<Warning>
  Regras `ACTIVE` precisam ser desativadas antes de voltar para `DRAFT`.
</Warning>

## Criando uma nova regra

***

<Steps>
  <Step>
    Clique em **Nova Regra**.
  </Step>

  <Step>
    Preencha os campos no painel lateral:

    | Campo           | Obrigatório | Observação                            |
    | --------------- | ----------- | ------------------------------------- |
    | **Name**        | Sim         | Nome da regra                         |
    | **Description** | Não         | Contexto da regra                     |
    | **Expression**  | Sim         | Expressão com validação em tempo real |
    | **Action**      | Sim         | `ALLOW`, `DENY` ou `REVIEW`           |
    | **Scope**       | Não         | Restrições por contexto               |
  </Step>

  <Step>
    Clique em **Criar**.
  </Step>
</Steps>

A regra nasce em `DRAFT`. Só começa a ser aplicada quando ativada.

## Editando uma regra

***

Abra **Details** para editar. O Console permite salvar alterações apenas em regras `DRAFT`. Para regras em outros status, aparece o aviso **Only draft rules can be edited**.

## Scope (escopo)

***

A seção **Scope** permite restringir onde a regra se aplica:

| Tipo de escopo   | Entrada                                                      |
| ---------------- | ------------------------------------------------------------ |
| Account          | UUID                                                         |
| Merchant         | UUID                                                         |
| Segment          | UUID                                                         |
| Portfolio        | UUID                                                         |
| Transaction Type | Seletor (`CARD`, `PIX`, `WIRE`, `CRYPTO`, `ACH`, `INTERNAL`) |
| Sub Type         | Texto                                                        |

Você adiciona condições com **Adicionar Condição** e remove com o ícone de remoção ao lado da condição.

## Relacionado

***

* [Motor de regras](/pt/tracer/rule-engine) — Como as regras avaliam transações
* [Criar regra](/pt/reference/tracer/create-rule) — Referência de API
* [Atualizar regra](/pt/reference/tracer/update-rule) — Referência de API