US06 - Pesquisa de livro

[mateusmaiamaia]

Descrição

Eu, como Ana Clara, desejo pesquisar livros pelo título ou autor, para encontrar rapidamente o livro que procuro.

Tarefas

• Criar um campo de busca no frontend:

  • Permitir a busca por título, autor ou tema.
  • Posicionar o campo de busca na parte superior da tela.
  • Adicionar um botão de pesquisa ao lado do campo de busca.

• Implementar a lógica de busca no backend:

  • Desenvolver endpoint que receba título, autor ou tema como parâmetros.
  • Realizar consulta no banco de dados para obter resultados relevantes.
  • Garantir que a consulta seja otimizada para responder em no máximo 2 segundos.
  • Ordenar os resultados pela relevância, considerando critérios como:
    • Nota média do livro (avaliações dos usuários).
    • Títulos ou autores que correspondam exatamente ao termo de pesquisa.
    • Frequência de empréstimos ou popularidade do livro.

• Exibir os resultados da pesquisa:

  • Exibir os resultados em formato de grid no frontend.
  • Garantir que cada item do grid inclua:
    • Capa do livro.
    • Título do livro.
    • Autor do livro.
    • Nota média do livro (com visualização de estrelas ou nota numérica).
  • Ordenar os resultados conforme a nota dos usuários (maior para menor).

• Tratar situações sem resultados:

  • Exibir a mensagem "Nenhum livro encontrado para a pesquisa realizada. Tente outros termos." caso não haja resultados.

• Garantir a responsividade da interface:

  • Ajustar o layout do grid para diferentes tamanhos de tela (desktop e dispositivos móveis).

Critérios de Aceitação

• O sistema deve retornar resultados precisos e relevantes com base no título, autor ou tema fornecido pelo usuário.
• O tempo de resposta da pesquisa não deve exceder 2 segundos, garantindo uma experiência ágil.
• Os resultados da pesquisa devem ser exibidos em formato de grid, organizados de maneira clara e visualmente atraente.
• Cada item nos resultados da pesquisa deve apresentar, no mínimo, a capa do livro, o título e o nome do autor.
• Caso nenhum resultado seja encontrado, o sistema deve exibir a mensagem: "Nenhum livro encontrado para a pesquisa realizada. Tente outros termos."
• O botão de pesquisa deve ficar na parte superior da tela.
• O sistema de pesquisa deverá exibir os resultados paginados, apresentando até 20 livros por página.
• Deve ser possível navegar entre as páginas utilizando controles de paginação (como botões "Próximo", "Anterior", ou números de páginas).
• O campo de pesquisa dos livros não deve impor qualquer limitação de caracteres.

Protótipo

https://www.figma.com/design/edZfZi6v6sV8lmFCfGCMPW/Livro-Livre?node-id=172-4&p=f&t=lT4R8ONZmcjjczL9-0

[jpmartins201]

1. Como medir clareza e atração visual da tela?
2. Qual o limite de caracteres para o campo de busca?
3. Quantos resultados podem aparecer por página? Ou será um scroll infinito?

[jpmartins201]

1. Revisar ausência de limite para caracteres no campo de busca: eu como usuário posso colar um texto de 1500 caracteres lá e esperar que aconteça algo?
2. O usuário vai inserir uma string (e.g. título de um livro) e vai executar a pesquisa de que forma? haverá um botão que ele pressiona pra executar? a pesquisa é executada automaticamente 1s após o usuário parar de digitar? favor descrever