Skip to content

Listar e buscar tipos de relevo #491

Description

@edvaldoszy

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

Por que isso importa

Relevo é o relevo do local de coleta (por exemplo plano, inclinado). O coletor escolhe no formulário do tombo; fica em tombos.relevo_id; a ficha impressa e as pendências mostram o nome.

Hoje o Curador só lista os tipos de relevo 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 Relevo 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 relevo 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 relevo pelo id para confirmar que estou editando o registro certo.

Critérios de aceite

Listar

  • GET /api/v2/relevos 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/relevos/:relevoId devolve { id, nome } com 200.
  • Id inexistente → 404.
  • relevoId inválido → 400.

Comum

  • O legado /api/relevos 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.

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

Status
to do

Relationships

None yet

Development

No branches or pull requests

Issue actions