Feat: listar buscar tipos vegetação Api.v2

[JosueModesto]

Close #489

O que foi feito

Foi implementado o módulo de leitura de tipos de vegetação na API v2, preservando o comportamento legado da rota antiga.

Alterações principais

• Criação do módulo de Vegetação em v2 com endpoints de listagem e busca por ID:
• GET /api/v2/vegetacoes
• GET /api/v2/vegetacoes/:vegetacaoId
• Suporte a filtro por nome com busca parcial e sem diferenciação de maiúsculas/minúsculas.
• Ordenação configurável por:
  • id ou nome
  • direção asc ou desc
• Ordenação padrão da listagem em id decrescente, conforme requisito.
• Validação para vegetacaoId inválido com retorno 400.
• Retorno 404 quando o registro não existe.
• Manutenção do legado /api/vegetacoes sem alterações.

Cobertura de testes

• Testes de listagem com filtro
• Testes de ordenação padrão
• Testes de ordenação customizada pela UI
• Teste de busca por registro existente
• Teste de busca por registro inexistente
• Teste de vegetacaoId inválido

[edvaldoszy]

As asserções da listagem sem filtro comparam o corpo inteiro só com as linhas inseridas neste teste. O setup de integração trunca apenas paises e estados, então qualquer residual em vegetacoes (teste paralelo ou falha anterior) quebra o teste de ordem padrão e o de order customizada. O padrão de países filtra por prefixo único e compara só o recorte.

[edvaldoszy]

parseOrder normaliza coluna/direção inválidas em silêncio para id/desc. Valores como order=nome:ASC ou order=foo:bar não devolvem 400; a direção em maiúsculas cai no default desc. Se a UI enviar o formato da listagem legado, a ordem pode ficar invertida sem erro explícito.