Painel de Administração
Regras
- Tabelas de dados: paginação, ordenação e filtros no lado do servidor — nunca carregar todas as linhas no cliente — usar
?page=1&limit=25&sort=createdAt&order=desc - Padrão CRUD: listar (tabela), criar (formulário/modal), ler (visualização de detalhes), atualizar (formulário de edição), excluir (diálogo de confirmação) — layout consistente em todos os recursos
- Controle de acesso baseado em funções: definir funções (admin, editor, viewer) com matriz de permissões — verificar permissões no servidor em cada rota da API, não apenas na interface
- Operações em lote: selecionar várias linhas, ação em lote (excluir, exportar, alterar status) — confirmar ações destrutivas, processar em segundo plano para lotes grandes
- Pesquisa: pesquisa de texto com debounce (300ms) em campos-chave — combinar com filtros de coluna para consultas precisas
- Gerenciamento de usuários: listar usuários, visualizar detalhes, alterar funções, desabilitar/habilitar contas, personificar (apenas admin com log de auditoria)
- Log de auditoria: registrar quem mudou o quê e quando —
{ userId, action, resource, resourceId, changes, timestamp } - Layout: navegação por barra lateral (colapsável), migalhas de pão, título da página com botões de ação — responsivo, mas otimizado para desktop
Padrão de Verificação de Permissão
const PERMISSIONS = {
admin: ["users:read", "users:write", "users:delete", "data:read", "data:write", "data:delete"],
editor: ["data:read", "data:write"],
viewer: ["data:read"],
} as const;
function can(role: string, permission: string): boolean {
return PERMISSIONS[role]?.includes(permission) ?? false;
}
// Middleware
if (!can(user.role, "users:write")) return Response.json({ error: "Forbidden" }, { status: 403 });
Padrão de API de Tabela de Dados
GET /api/admin/users?page=1&limit=25&sort=createdAt&order=desc&search=john&role=admin
Retorna: { data: [...], total: 150, page: 1, limit: 25, totalPages: 6 }
Evitar
- Verificações de permissão apenas no cliente — sempre aplicar no servidor
- Carregar todos os dados e então paginar no navegador — usar paginação no servidor
- Sem confirmação para ações destrutivas — sempre confirmar exclusões e operações em lote
- Ausência de rastreamento de auditoria — você precisa saber quem mudou o quê