> For the complete documentation index, see [llms.txt](https://ftcoders.first-tech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ftcoders.first-tech.com/first-tech-ttp-sdk-pt/busca-de-produtos.md).
# Busca de Produtos
**Objetivo**
Definir os requisitos mínimos para o fluxo de busca de produtos dentro do catálogo, garantindo uma experiência de pesquisa rápida, acessível e eficiente, que aumente a probabilidade de os usuários encontrarem os itens desejados.
**Diretrizes**
* A busca deve considerar sinônimos e pequenas variações ortográficas para otimizar os resultados.
* A arquitetura da busca deve priorizar o desempenho, mesmo com grandes volumes de dados de produtos.
* O comportamento deve ser responsivo e acessível em todos os tamanhos de tela e tipos de dispositivos.
***
## **Campo de Busca**
### 01 - Campo de entrada de busca na tela inicial
Deve ser claramente visível e acessível, com um placeholder de exemplo e ícone de lupa. Ao receber foco, deve navegar para uma tela dedicada à busca.
{% hint style="success" %}
**Obrigatório:**\
O campo de busca deve estar sempre visível na parte superior da tela do catálogo.
{% endhint %}
{% hint style="info" %}
**Recomendado:**\
Suportar busca por voz ou acessibilidade via leitor de tela.
{% endhint %}
***
## **Tela de Busca Ativa**
### 02 - Barra de busca expandida
Deve manter o foco e permitir a digitação contínua de texto.
### 03 - Histórico de busca
Deve exibir os termos pesquisados recentemente, com uma opção de “Limpar tudo”.
{% hint style="success" %}
**Obrigatório:**\
O histórico deve ser armazenado localmente e nunca exibir dados sensíveis.
{% endhint %}
{% hint style="info" %}
**Recomendado:**\
Ordenar os resultados por frequência de uso ou sazonalidade.
{% endhint %}
***
## **Sugestões e Resultados Relevantes**
### 04 - Sugestões populares
Devem ser exibidas abaixo da barra de busca, incluindo imagem, nome, categoria e preço de cada produto. A ação de adicionar ao carrinho deve incluir um botão direto (ícone de carrinho claramente visível à direita).
{% hint style="success" %}
**Obrigatório:**\
Deve permitir ação imediata no item sugerido, sem necessidade de navegação para os detalhes do produto.
{% endhint %}
{% hint style="info" %}
**Recomendado:**\
Exibir disponibilidade de estoque e variantes do produto, se aplicável.
{% endhint %}
***
## **Tela de Resultados de Busca Filtrada**
### 05 - Filtros dinâmicos
Devem permitir ordenar por critérios como “Mais Popular”, “Menor Preço”, “Todos”.
### 06 - Lista de resultados
Cada produto deve exibir: imagem, nome, categoria, preço, estoque e botão de adicionar ao carrinho visível.
{% hint style="success" %}
**Obrigatório:**\
A lista deve suportar rolagem infinita ou paginação, com otimização de performance.
{% endhint %}
{% hint style="info" %}
**Recomendado:**\
Destacar termos correspondentes na busca nos resultados.
{% endhint %}
***
## **Mensagens Obrigatórias**
* Quando nenhum resultado for encontrado:
> Nenhum produto encontrado para “{termo}”. Tente uma palavra-chave diferente ou ajuste seus filtros.
* Quando a conexão estiver instável:
> Não foi possível carregar os resultados. Por favor, verifique sua conexão com a internet.
***
## **Comportamentos Esperados**
* A digitação no campo de busca deve atualizar os resultados dinamicamente (sugestões preditivas).
* Os botões de filtro devem manter seu estado ativo e permitir critérios combinados (ex.: popular + mais barato).
* A busca deve funcionar independentemente da categoria selecionada anteriormente.
* O campo de entrada deve suportar correção rápida e limpar automaticamente ao sair da interface de busca.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ftcoders.first-tech.com/first-tech-ttp-sdk-pt/busca-de-produtos.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.