feat: implement certificate pagination

[estevaoMG]

https://tree.taiga.io/project/laridurao-liga-da-justica/task/79

Implementação concluída com sucesso ✅

O que foi desenvolvido

• Adicionado suporte à paginação na rota:

  • GET /certificate/users/{user_id}

• Inclusão dos query params:

  • page (default = 1)
  • limit (default = 20)

• Implementado cálculo interno de skip

• Aplicado skip + limit na consulta MongoDB

• Adicionada ordenação por certificados mais recentes:

  • issued_at desc

• Inclusão de metadados de paginação na resposta:

  • total
  • page
  • limit
  • total_pages

• Ajustado comportamento para páginas acima do total:

  • retorna lista vazia sem erro

Regras implementadas

• limit máximo permitido: 100
• Valores inválidos retornam HTTP 422
• Mantida retrocompatibilidade para chamadas sem parâmetros

Estrutura da resposta

{
  "success": true,
  "message": "Certificados obtidos com sucesso.",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "limit": 20,
    "total_pages": 0
  }
}

Testes

• Testes unitários atualizados

• Cobertura mantida em 90%

• Todos os testes passando:

  • 52 passed