[CRUD Categoria] Modal admin pra criar e excluir categorias personalizadas

[FernandoAlmeidaPinto]

Resumo da entrega. 5 cards no total. Adiciona um modal na DashProva (via botão "Gerenciar Categorias") onde admin pode listar todas as categorias (incluindo seedadas), criar personalizadas com nome auto-gerado, e excluir as que não estão em uso. Sem edit (decisão de design — categoria imutável).

Documento de fundação: docs/crud-categoria-simulado.md
Posição na série: 3 de 10 · Mapa da série: #66

---

Status da entrega ✅

Todos os 5 cards implementados e mergeados ✅

Card	Repo	PR
01 · delete enrichment + countByCategoria + filtro getAll	ms-simulado	#155 ✅ mergeado
02 · restrições no create + auto-nome + validação de pattern	ms-simulado	#156 ✅ mergeado
03 · CategoriaController proxy + guards	api-vcnafacul	#502 ✅ mergeado
04 · services getCategoriaById/createCategoria/deleteCategoria	client-vcnafacul	#642 ✅ mergeado
05 · modal ManageCategorias + integração DashProva	client-vcnafacul	#642 ✅ mergeado

Cards 04 e 05 foram entregues encadeados num único PR (#642).

Por que essa etapa

Hoje só existem as 6 categorias seedadas (Enem Dia 1, Enem Dia 2, Linguagens, Ciências Humanas, Ciências da Natureza, Matemática). Se admin quiser criar um simulado "Personalizado 30q 60min" pra usar em provas custom (etapa 4), não tem interface — precisaria mexer direto no banco.

Essa etapa cria a interface administrativa: modal acessível pela DashProva, com listagem, criação restrita (só personalizadas, backend força custom: true) e exclusão protegida (409 quando em uso).

Decisões cravadas

• CRUD imutável: só create + delete. Nada de PATCH / edit.
• Delete bloqueado se algum Simulado referencia a categoria (proteção automática das seedadas) — retorna 409 com { message, simuladosUsando }.
• Nome auto-gerado no formato "{Prefixo} {qtd}q {duracao}min" (ou "{Prefixo} livre {duracao}min" quando qtd == null). Preview em tempo real no form, espelhando a fórmula do backend.
• Backend força custom: true e selecionavel: true — DTO malicioso é ignorado, backend é fonte de verdade.
• Permissão: alterarPermissao (permissão de admin já existente). Sem permissão nova nesta etapa.
• Categorias seedadas aparecem com badge visual "🔒 Categoria seedada"; botão excluir desabilitado com tooltip.
• Filtro de soft-deleted (deleted: { $ne: true }) no getAll.
• Sincronização com NewProva: callback onCategoriasChanged atualiza o select da criação de prova assim que uma categoria é criada/excluída.

Pré-requisitos

• [Categoria] (etapa 1, # [Categoria] Refatoração do modelo: TipoSimulado → Categoria #65) — schema Categoria com custom + selecionavel + exame.
• [Unificação] (etapa 2, [Unificação] Eliminar tela Simulados admin + vista interna no ShowProva + cleanup `criarSimulado` #68) — DashProva como ponto de entrada do gerenciamento.

Cards desta etapa

• Card 01 · ms-simulado · Enrichment do delete + countByCategoria + filtro no getAll

  • Delete bloqueado com 409 quando em uso. Helper SimuladoRepository.countByCategoria. getAll filtra soft-deleted. forwardRef pra resolver ciclo CategoriaModule ↔ SimuladoModule.
  • PR #155 · mergeado

• Card 02 · ms-simulado · Restrições no create + auto-nome + validação de pattern

  • Force custom: true, selecionavel: true no service. Auto-gera nome a partir de prefixo + qtd + dur. Valida pattern do nome.
  • PR #156 · mergeado

• Card 03 · api-vcnafacul · CategoriaController + proxies + guards

  • 4 endpoints proxy (GET, GET /:id, POST, DELETE). JwtAuthGuard sempre; escritas gated por alterarPermissao. DTOs espelho. Erros 409/400 propagados.
  • PR #502 · mergeado

• Card 04 · client-vcnafacul · Services getCategoriaById, createCategoria, deleteCategoria

  • 3 services novos (getCategorias já existia). URL helper categoriaById. Tratamento de erros específicos (409 com simuladosUsando, 400 pattern).
  • PR #642 · mergeado

• Card 05 · client-vcnafacul · Modal ManageCategorias + integração na DashProva

  • Modal com 3 vistas (lista, criar, excluir). Badge de proteção. Preview do nome em tempo real. Sync com NewProva via callback. protectedTipos.ts com lista de seedadas.
  • PR #642 · mergeado

Ajustes descobertos na implementação

Correções aplicadas ao validar os cards contra o código real:

• Card 02 — unicidade do nome saiu do DTO pro service (retorna 409), com colisão checada antes do pattern (senão nomes seedados como "Enem Dia 1", que não seguem o pattern custom, dariam 400 em vez de 409).
• Card 03 — o CategoriaProxyController já existia (foi estendido, não duplicado). Guard de escrita = JwtAuthGuard antes do PermissionsGuard (garante 401 sem token; 403 com token sem permissão).
• Card 05 — o slot do botão "Gerenciar Categorias" não existia na DashProva (foi adicionado por completo). getExames não existe: as opções de exame são derivadas da própria lista de categorias (.exame). ICategoria não traz contagem de uso, então a lista não pré-desabilita excluir por uso — o 409 real é tratado no clique via toast.

Próximas etapas

• [Provas Custom] (etapa 4) — consome as categorias custom criadas por este CRUD.

Referências

• Resumo executivo da série: Refatoração do domínio Simulado — Resumo executivo #61
• Mapa de etapas: Refatoração do domínio Simulado — Mapa de etapas #66
• Etapa 1 [Categoria]: # [Categoria] Refatoração do modelo: TipoSimulado → Categoria #65 · Etapa 2 [Unificação]: [Unificação] Eliminar tela Simulados admin + vista interna no ShowProva + cleanup `criarSimulado` #68