Guia: Como Adicionar Uma Nova Permissão

1. Criar a flag via migration/seed em permissoes.
2. Usar nome estável no formato modulo.acao ou modulo.recurso.acao.
3. Preencher nome, modulo, acao e descricao.
4. Adicionar a flag ao escopo global (permissao_escopo_global).
5. Se aplicável, adicionar ao escopo das white labels (white_label_permissao).
6. Aplicar backend_permission_require() ou backend_permission_require_any() no endpoint.
7. Usar data-permission na UI somente para experiência visual.
8. Registrar a entrada em docs/permissoes-matriz-endpoints.md e em docs/api/endpoints.md.
9. Testar:
   • sem login;
   • sem flag;
   • com flag;
   • super-admin;
   • usuário de outro white label.