====== [ER_003] Requisitos - Busca Global ======
Descrição: Funcionalidade responsável por permitir a pesquisa unificada de conteúdos e serviços do Portal Público do TCE-GO, incluindo atos normativos, notícias, serviços e conteúdos institucionais, com foco na melhoria da encontrabilidade da informação.
Menu / Local de acesso: Portal TCE-GO | Campo de Busca Global (Header fixo em todas as páginas)
===== Atores =====
A funcionalidade de Busca Global está disponível no contexto público, podendo ser utilizada por usuários autenticados ou não autenticados.
^Nível^Perfil^Autenticação^Abrangência|
|INTERNO/PÚBLICO|Todos os Perfis|Não obrigatória|Pesquisa unificada de conteúdos e serviços disponíveis publicamente no Portal.|
===== Telas =====
==== Tela 01 - Campo de Busca Global ====
Componente disponível **fixado no topo** do Portal.
^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação|
|Campo de Busca|Campo Texto com sugestão automática|Sim|Alfanumérico|Vazio|Aceita termos parciais, palavras-chave, número de processo e nomes.|
|Sugestão Preditiva|Lista dinâmica|Não|-|–|Exibida automaticamente conforme digitação (RN03).|
|Ícone de Lupa|Ícone acionável|Sim|–|–|Executa a pesquisa global.|
==== Tela 02 - Página de Resultados da Busca ====
Tela responsável por exibir os resultados da pesquisa global.
^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação|
|Filtro Primário|Radio|Sim|Todos, Serviços, Notícias, Páginas, Transparência, Publicações Institucionais|Todos|Define o escopo e altera os filtros avançados disponíveis.|
|Filtros Avançados|Área Dinâmica|Não|Variável por filtro primário|Oculto|Exibidos conforme a regra RN09|
|Paginação|Controle|Não|-|1|Navegação entre os resultados encontrados.|
|Listagem de Resultados|Lista|Sim|-|Vazio|Exibe os cards de resultados com Título, Resumo e Categoria.|
|Mensagem Vazio|Texto informativo|–|“Nenhum resultado encontrado em todo o Portal TCE-GO”|“Nenhum resultado encontrado em todo o Portal TCE-GO”|Exibida quando não houver resultados.|
===== Fluxos =====
==== Fluxo 01 - Executar Busca Global (Fluxo Principal) ====
^Passo^Ação^Regra^Tela|
|01|O usuário insere um termo no campo de Busca Global.| |Header|
|02|O sistema apresenta sugestões automáticas conforme digitação.|RN03|Header|
|03|O usuário aciona a ação“Buscar” ou tecla Enter.| |Header|
|04|O sistema processa a consulta de forma unificada e apresenta os resultados organizados por relevância.|RN01, RN02, RN04|Resultados|
|04.1|Caso não existam resultados, o sistema executa o [[#fluxo_03_-_busca_sem_resultado|Fluxo 03]].| |Resultados|
|05|O usuário seleciona um filtro específico (ex: Serviços).|RN03|Tela 01|
|06|O sistema atualiza a lista e exibe os filtros avançados daquela categoria (ex: Público "Advogados").|RN09|Tela 01|
|07|O sistema refina os resultados mantendo o termo de busca|RN06|Tela 01|
==== Fluxo 02 - Refinar Busca por Categoria ====
^Passo^Ação^Regra^Tela|
|01|O usuário seleciona uma categoria de resultado.| |Resultados|
|02|O sistema filtra os resultados conforme categoria selecionada.|RN05|Resultados|
|03|O sistema atualiza a listagem mantendo o termo pesquisado.|RN05|Resultados|
==== Fluxo 03 - Busca sem Resultado ====
^Passo^Ação^Regra^Tela|
|01|O sistema não localiza resultados para o termo informado.| |Resultados|
|02|O sistema apresenta a mensagem: “Nenhum resultado encontrado para o termo pesquisado.”| |Resultados|
|03|O sistema mantém o campo de busca disponível para nova tentativa.| |Resultados|
===== RN – Regras de Negócio =====
^ID^Descrição|
|RN01|**Busca Unificada** – O sistema deve executar a pesquisa de forma unificada em todos os repositórios públicos integrados ao Portal: notícias, páginas, publicações, serviços e itens de transparência (RF-016).|
|RN02|**Aceitação de Critérios Variáveis** – O sistema deve permitir pesquisa por termos livres.|
|RN03|**Sugestão Preditiva** – Durante a digitação, e após o usuário digitar 3 caracteres o sistema deve apresentar sugestões automáticas de notícias, páginas, publicações, serviços e itens de transparência correspondentes ao termo parcial informado.|
|RN04|**Ordenação por Relevância** – Os resultados devem ser ordenados por critério de relevância baseado na correspondência do termo pesquisado com título, assunto e conteúdo indexado. Quando houver período inserido, a ordeneção deve ser feita pela data mais atual.|
|RN05|**Filtro por Categoria** – O sistema deve permitir a filtragem dos resultados por tipo de conteúdo, mantendo o termo originalmente pesquisado.|
|RN06|**Paginação de Resultados** – O sistema deve apresentar os resultados de forma paginada, exibindo 10 (dez) registros por página quando aplicável.|
|RN07|**Indexação Temática** – O sistema deve utilizar indexação por palavras-chave e assuntos para garantir que conteúdos relacionados sejam retornados mesmo que o termo pesquisado não corresponda exatamente ao título do conteúdo.|
|RN08|**Fragmento de Texto (Snippet)**: Cada resultado de busca deve exibir um resumo ou fragmento do texto onde o termo foi encontrado, destacando a palavra-chave quando possível em negrito.|
|RN09|**Exibição Condicional de Filtros**: Exibição Condicional de Filtros: O sistema deve renderizar os componentes de filtro avançado dinamicamente com base no Filtro Primário selecionado, conforme o mapeamento abaixo: \\ **1. Todos**: Apresenta apenas o filtro transversal de Assunto (Tema Global) e o filtro de Tipo de Conteúdo. \\ **2. Serviços**: Exibe os filtros de Público (Cidadão, Advogados, Órgãos Fiscalizados, Servidores) e Tipo de Serviço (Consulta, Emissão, Solicitação). \\ **3. Notícias**: Exibe os filtros de Período, Autor, Tipo (Clipping, Notícia, Vídeo, Rádio) e o transversal de Assunto. \\ **4. Páginas**: Exibe os filtros de Tipo de Conteúdo (Informativo, Normativo, Institucional, Programa/Projeto) e o transversal de Assunto. \\ **5. Transparência**: Exibe o filtro de Categoria (Grupo Temático), populado dinamicamente com os grupos temáticos publicados no Portal da Transparência (RF-016), incluindo a opção "Todos" para remover o filtro. Não exibe o filtro transversal de Assunto, pois os itens de transparência não possuem esse atributo no modelo de dados do RF-016. \\ **6. Publicações Institucionais**: Exibe o filtro de Tipo (Normativo, Relatório, Boletim, Cartilha, Manual / Tutorial, Livro / Revista, Apresentação), o filtro de Tipo Específico (subtipo — disponível somente quando o Tipo selecionado possui subdivisões, ex.: Relatório de Gestão / Relatório de Fiscalização para o tipo Relatório; Boletim de Jurisprudência / Boletim de Produtividade para o tipo Boletim) e o transversal de Assunto.|
|RN10|**Assuntos (Tema Global)**: O filtro transversal de "Assunto" deve ser alimentado obrigatoriamente pelas seguintes opções padronizadas: Acessibilidade, Administração, Assistência Social, Ciência e Tecnologia, Comunicação Institucional, Contratações Públicas, Contratos e Despesas, Cultura, Desenvolvimento Regional, Economia, Educação, Energia, Finanças Públicas, Gestão Ambiental, Gestão de Pessoas, Gestão Estadual, Gestão Patrimonial, Jurisprudência, Licitações, Obras, Participação Cidadã, Planejamento e Orçamento, Previdência Social, Saneamento, Saúde, Segurança Pública, Sustentabilidade e Transporte.|
|RN11|**Critérios de Busca** – O sistema deve considerar exclusivamente itens com status "Publicado". A correspondência deve ser feita por termo parcial (RN02), sem distinção entre maiúsculas e minúsculas, sobre o título e a descrição breve do item. Os resultados devem seguir o padrão de exibição e navegação da sua área de origem (ex.: notícia, página, publicação, serviço, item de transparência), incluindo, quando aplicável, a indicação visual de link externo sem abertura automática de nova aba.|