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

# Punições

> Aprenda a configurar e usar o sistema de punições da FiveDesk, com tipos personalizáveis, expiração automática e convocação para alinhamento!

O sistema de punições permite registrar e aplicar sanções aos membros do seu servidor — de um alerta simples a um banimento — com cargos atribuídos automaticamente, expiração programada e um canal de logs para acompanhar tudo. Ele também inclui um mecanismo de convocação para alinhamento, para conversar com o membro antes de uma punição.

* Tipos de punição personalizáveis, cada um com pontos, cargos e canal de anúncio próprios;
* Aplicação de uma ou várias punições de uma vez, com motivo e duração customizável;
* Convocação para alinhamento, com prazo e punição automática em caso de não comparecimento;
* Expiração automática de punições e restauração de cargos ao reentrar no servidor;
* Canal de logs dedicado para cada evento do sistema.

### Como o sistema é organizado

Esta seção da documentação está dividida em páginas menores, cada uma cobrindo uma parte do sistema:

<CardGroup cols={2}>
  <Card title="Configuração" icon="sliders" href="/products/fivedesk/punicoes/configuracao">
    Restauração automática de cargos, canal de logs e canal de alinhamentos.
  </Card>

  <Card title="Tipos de punição" icon="layer-group" href="/products/fivedesk/punicoes/tipos">
    Crie e edite os tipos de punição disponíveis, com pontos, cargos e expiração.
  </Card>

  <Card title="Aplicando punições" icon="gavel" href="/products/fivedesk/punicoes/aplicando">
    Como punir um usuário diretamente com o comando `/punir aplicar`.
  </Card>

  <Card title="Alinhamento" icon="bell" href="/products/fivedesk/punicoes/alinhamento">
    Convoque um usuário antes de puni-lo, com prazo e punição automática.
  </Card>

  <Card title="Automações" icon="clock" href="/products/fivedesk/punicoes/automacoes">
    Expiração automática de punições e restauração de cargos ao reentrar.
  </Card>
</CardGroup>

### Comandos e formas de acesso

* `/gerenciar` - Abre o painel administrativo geral do servidor. A partir dele, selecione a opção **Punições** para acessar as configurações do sistema.
* `/punir aplicar` - Aplica uma ou mais punições a um usuário do servidor.
* `/punir alinhamento` - Convoca um usuário para alinhamento, com punição automática caso o prazo expire.

<Steps>
  <Step title="Acesse o painel de gerenciamento">
    Execute `/gerenciar` no seu servidor e selecione a opção **Punições** na lista de opções.
  </Step>

  <Step title="Crie ao menos um tipo de punição">
    Sem tipos configurados, os comandos `/punir aplicar` e `/punir alinhamento` não têm o que oferecer. Veja como em [Tipos de punição](/products/fivedesk/punicoes/tipos).
  </Step>

  <Step title="Configure os canais">
    Defina o canal de logs (e, se for usar convocações, o canal de alinhamentos). Veja como em [Configuração](/products/fivedesk/punicoes/configuracao).
  </Step>
</Steps>

<Info>
  Acessar o painel de **Punições** em `/gerenciar` exige a permissão `punicoes.gerenciar`. Já os comandos `/punir aplicar` e `/punir alinhamento` exigem `punicoes.aplicar` — é possível conceder essa permissão para a equipe sem dar acesso às configurações do sistema.
</Info>

### Fluxo geral

1. A equipe cria os tipos de punição, definindo pontos, cargos e duração padrão de cada um;
2. Ao identificar uma infração, a equipe aplica a punição diretamente ou convoca o usuário para alinhamento primeiro;
3. Os cargos configurados são atribuídos automaticamente e o evento é registrado no canal de logs;
4. Se a punição tiver duração definida, ela expira automaticamente e os cargos são removidos;
5. Se o usuário sair e voltar para o servidor, os cargos de punições ainda ativas podem ser restaurados automaticamente.