Listar e buscar tipos de vegetação

[edvaldoszy]

GitHub: a issue de escrita (cadastrar / renomear / remover) fica bloqueada por esta.

Por que isso importa

Vegetação é o tipo de habitat do local de coleta. O coletor escolhe no formulário do tombo; fica em tombos.vegetacao_id; o Darwin Core exporta o nome como habitat; a ficha impressa mostra em Observações.

Hoje o Curador só lista os tipos de vegetação pela API antiga. A API nova precisa deixar listar o catálogo e abrir um registro, para o formulário do tombo ter uma lista confiável e o Curador saber que está no registro certo antes de alterar.

Esta issue cria o módulo de Vegetação na API v2 e os dois endpoints de leitura. Cadastrar, renomear e remover ficam em outra issue.

Histórias

• Como Curador, quero listar os tipos de vegetação pelo nome para ver o que os coletores vão escolher no formulário do tombo.
• Como Curador, quero ordenar essa lista (por id ou por nome, crescente ou decrescente) para achar o registro mais fácil. Sem ordenação pedida, quero ver os mais recentes primeiro.
• Como Curador, quero abrir um tipo de vegetação pelo id para confirmar que estou editando o registro certo.

Critérios de aceite

Listar

• GET /api/v2/vegetacoes devolve { id, nome }[].
• Sem parâmetros de ordenação, a lista vem por id descendente.
• A UI consegue pedir outra ordenação, pelo menos por id e nome, nas direções crescente e decrescente.
• Query opcional ?nome= filtra por nome (match parcial, sem diferenciar maiúsculas).

Buscar

• GET /api/v2/vegetacoes/:vegetacaoId devolve { id, nome } com 200.
• Id inexistente → 404.
• vegetacaoId inválido → 400.

Comum

• O legado /api/vegetacoes permanece inalterado.
• Há testes de listagem (filtro, ordenação padrão e ordenação pedida pela UI), de busca encontrada e de busca inexistente.

Fora de escopo

• Cadastrar, atualizar e excluir — issue separada, bloqueada por esta.
• Auth na v2.
• Alterar o formulário do tombo.