Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

Link para esta página de comparações

Ambos lados da revisão anterior Revisão anterior
Próxima revisão
Revisão anterior
pres:gerti:gestao_de_ativos:portal:er_003 [26/02/2026 20:01] – [Tela 02 - Página de Resultados da Busca] pramorimpres:gerti:gestao_de_ativos:portal:er_003 [20/09/2026 02:14] (atual) – pramorim
Linha 1: Linha 1:
-====== [ER_XXX] Requisitos - Busca Global ======+====== [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.+Descrição: Funcionalidade responsável por permitir a pesquisa unificada de conteúdos e serviços do Portal Público do TCE-GO — serviços, publicações institucionais, notícias, itens do Portal da Transparência, licitações, páginas institucionais, páginas-âncora de seção, contatos institucionais, itens dos subportais e membros do Tribunal —, com resultados ordenados por relevância ponderada pelo tipo de conteúdo e refinamento por filtros.
  
-Menu / Local de acesso: Portal TCE-GO | Campo de Busca Global (Header fixo em todas as páginas)+Demanda: #39403 (versão original) e #44015 (esta evolução). 
 + 
 +Objetivo de negócio: Fazer com que quem procura um serviço do Tribunal chegue a ele pela busca, em vez de desistir na primeira página de resultados ou recorrer ao atendimento. 
 + 
 +Menu / Local de acesso: Portal TCE-GO | Campo de Busca Global (cabeçalho fixo em todas as páginas) 
 + 
 +Especificação de origem: ''PRD.md'' desta pasta, versão 2.0. Base de contexto: ''CONTEXT.md''. 
 + 
 +===== Problema, escopo e fora de escopo ===== 
 + 
 +**Problema.** A busca devolve o conteúdo certo na ordem errada, com filtros que não correspondem ao que o portal oferece e em tempo que o usuário interpreta como travamento. A consulta por "Prestação de Contas" devolve 306 resultados, com a primeira página composta integralmente por notícias; os dois serviços que correspondem exatamente ao termo ocupam as posições 18 e 19. O filtro "Tipo de serviço" não corresponde a nenhuma classificação usada no catálogo. A resposta leva de 8 a 15 segundos e, quando a busca parte do cabeçalho, nada indica que ela está em curso. 
 + 
 +**Escopo.** 
 + 
 +  * Relevância com peso por tipo de conteúdo, somado à pontuação textual existente (RN12) 
 +  * Seletor de ordenação: Relevância (padrão) e Mais recentes (RN17) 
 +  * Revisão dos filtros: inclusão dos equivalentes aos dos hubs, inclusão da categoria Notícia entre os tipos filtráveis, exclusão dos filtros "Tipo de serviço" e "Tipo de conteúdo" da página, e dos campos que os alimentam (RN09) 
 +  * Período promovido a filtro transversal, sem efeito sobre a ordenação (RN17) 
 +  * Declaração dos campos pesquisáveis por tipo, em lugar da varredura de todos os metadados (RN13) 
 +  * Estado de execução visível e anunciado, no cabeçalho e na página de resultados (RN15) 
 +  * Cache do conjunto de resultados e meta de tempo de resposta verificável (RN16) 
 +  * Categoria "Hub" para as páginas-âncora de seção (RN19) 
 +  * Inclusão de contatos institucionais, itens dos subportais (Governança, Observatório do Cidadão e Primeira Infância) e membros do Tribunal entre os resultados, com peso 30, e a regra de destino para os que não possuem endereço próprio (RN21) 
 + 
 +**Fora de escopo.** 
 + 
 +  * Motor de busca dedicado (Elasticsearch, OpenSearch, Algolia ou equivalente) — decisão da equipe técnica; a solução permanece em WordPress e MySQL 
 +  * Sugestão preditiva durante a digitação — removida em 2026-07-13, RN03 revogada; não retorna nesta versão 
 +  * Busca facetada com contagem por categoria 
 +  * Busca dentro do conteúdo de arquivos anexos (PDF, DOCX) 
 +  * Encaminhamento para a consulta especializada quando a busca não encontra o ato normativo — decisão do P.O. de não tratar o tema nesta demanda 
 +  * Consulta a sistemas externos ao portal — em especial a Jurisprudência e Atos Normativos, serviço à parte com motor de busca próprio, que a busca global não aciona (RN20) 
 +  * Registro dos termos buscados 
 +  * Protótipo da tela em Next.js
  
 ===== Atores ===== ===== Atores =====
Linha 10: Linha 43:
  
 ^Nível^Perfil^Autenticação^Abrangência| ^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.|+|PÚBLICO|Cidadão, jurisdicionado, advogado, licitante, imprensa e demais visitantes|Não obrigatória|Pesquisa todo o conteúdo publicado e público do Portal| 
 +|PÚBLICO|Servidor do Tribunal consultando o Portal|Não obrigatória|Idêntica à do cidadão| 
 +|INTERNO|Servidor responsável pela gestão de conteúdo|Sim (WP-ADMIN)|Preenche os campos que alimentam a busca — palavras-chave, assunto, resumo e classificação (RN07, RN13). Não opera tela da busca| 
 + 
 +===== Comportamento atual e esperado ===== 
 + 
 +Medições realizadas em 2026-09-19 no ambiente ''tce-portal.cluster.tce.gti.br'': 
 + 
 +^Consulta^Tempo de resposta^Resultados^Composição da 1ª página| 
 +|''?s=Prestação de Contas''|15,57 s|306|10 notícias; serviços nas posições 18 e 19| 
 +|''?s=certidão''|12,03 s|33|9 notícias e 1 página| 
 +|''?s=pauta''|8,87 s|304|notícias| 
 +|''?s=boleto''|8,30 s|9|8 notícias e 1 página| 
 +|''?s=Prestação de Contas&tipo=servico''|9,92 s|2|os 2 serviços| 
 +|''?s=&tipo=servico'' (sem termo)|0,53 s|3|os 3 serviços do ambiente| 
 + 
 +^Aspecto^Comportamento atual^Comportamento esperado| 
 +|Tipos cobertos|Serviço, publicação, notícia, item de transparência, licitação e página|Os mesmos, acrescidos de contato, item de subportal (Governança, Observatório e Primeira Infância) e membro do Tribunal, com peso 30 (RN01, RN12)| 
 +|Ordenação|Pontuação textual sem distinção de tipo de conteúdo|Pontuação textual somada ao peso do tipo (RN12); empate pela data mais recente| 
 +|Escolha da ordenação|Não existe; informar período troca a ordenação para data sem o usuário pedir|Seletor "Ordenar por: Relevância / Mais recentes"; período é filtro (RN17)| 
 +|Campos varridos|Título, resumo, conteúdo e **todos** os metadados do registro, sem distinção de chave|Título, resumo, conteúdo e a relação declarada de campos por tipo (RN13)| 
 +|Tipos filtráveis|Página, Publicação, Serviço, Transparência, Licitação — Notícia é omitida da lista|Serviço, Publicação Institucional, Notícia, Transparência, Licitação, Hub, Contato, Item de subportal, Membro do Tribunal e Página| 
 +|Filtro de serviço|Público (4 perfis) e "Tipo de serviço"|Público com os 5 perfis do catálogo, incluindo Licitantes; "Tipo de serviço" deixa de existir| 
 +|Filtro de publicação|Tipo e Tipo específico|Tipo, Tipo específico e Ano de publicação| 
 +|Filtro de licitação|Nenhum|Modalidade, Ano e Situação| 
 +|Filtro de página|"Tipo de conteúdo" (Informativo, Normativo, Institucional, Programa/Projeto)|Deixa de existir, junto com o campo que o alimenta; restam os filtros transversais| 
 +|Filtro de período|Apenas para Notícia, e troca a ordenação|Transversal a todas as categorias, sem efeito sobre a ordenação| 
 +|Correção automática do termo|O termo é substituído antes da consulta sempre que há palavra próxima, inclusive quando a busca original teria bons resultados|A consulta usa sempre o termo digitado; a correção entra apenas no resultado vazio, quando a busca corrigida é executada e os avisos "Exibindo resultados para X" e "Em vez disso, pesquisar por Y" são apresentados (RN14)| 
 +|Vocabulário da correção|Títulos, todos os valores de metadados e os assuntos, reconstruído a cada gravação de conteúdo|Títulos, assuntos padronizados e palavras-chave, reconstruído por rotina agendada (RN14.1)| 
 +|Feedback ao buscar pelo cabeçalho|Nenhum: a página fica inalterada de 8 a 15 s|Campo em estado de busca, ação bloqueada e estado anunciado (RN15)| 
 +|Tempo de resposta|8 a 15,5 s|95% das buscas em até 3 s; nenhuma acima de 8 s (RN16)| 
 +|Consultas por requisição|Duas: a principal do WordPress, descartada, e a da página|Uma única consulta de resultados| 
 + 
 +**Descartado da versão atual:** 
 + 
 +^Item descartado^Motivo| 
 +|Filtro "Tipo de serviço" (Consulta, Emissão, Solicitação) e o campo que o alimenta|Classificação que existe só para a busca, não corresponde à organização do catálogo de serviços e não é mantida pela área| 
 +|Filtro "Tipo de conteúdo" da página (Informativo, Normativo, Institucional, Programa/Projeto) e o campo que o alimenta|Mesmo caso: classificação criada para a busca, sem uso em qualquer outra tela e sem manutenção. A remoção elimina ainda a ambiguidade com o seletor de categoria, que tem o mesmo rótulo. O campo de assunto registrado para a página permanece| 
 +|Substituição do termo digitado antes da consulta, em toda busca|O usuário recebe resultados de uma pergunta que não fez, mesmo quando o termo dele encontraria o que procura, e o custo do cálculo é pago em 100% das buscas. A correção permanece, acionada apenas quando a busca não encontra nada (RN14)| 
 +|Troca automática da ordenação ao informar período|Efeito colateral não solicitado|
  
 ===== Telas ===== ===== Telas =====
  
-==== Tela 01 - Campo de Busca Global ====+==== Tela 01 - Campo de Busca Global (cabeçalho) ====
  
-Componente disponível **fixado no topo** do Portal.+Componente fixado no topo de todas as páginas do Portal, à direita do menu principal, alcançável pelo atalho Alt+2.
  
 ^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação| ^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, CPF, CNPJ, número de processo e nomes.| +|Campo de Busca|Campo de texto|Sim|Alfanumérico, até 100 caracteres|Vazio, ou o termo da busca corrente|Aceita termo parcial, palavra-chave, nome e número de processo (RN02, RN18)| 
-|Sugestão Preditiva|Lista dinâmica|Não|Serviços, Atos, Notícias, Página|–|Exibida automaticamente conforme digitação (RN03).| +|<del>Sugestão Preditiva</del>|<del>Lista dinâmica</del>|Não|-|–|<del>Exibida automaticamente conforme digitação</del> (RN03 revogada)| 
-|Ícone de Lupa|Ícone acionável|Sim|–|–|Executa a pesquisa global.|+|Limpar|Botão de ícone|Não|–|Oculto|Exibido apenas com o campo preenchido; devolve o foco ao campo| 
 +|Ícone de Lupa|Ícone acionável|Sim|–|–|Executa a pesquisa global; no estado de busca é substituído pelo girador e bloqueado (RN15)| 
 +|Região de status|Texto para leitor de tela|–|"Buscando resultados. Aguarde..."|Vazio|''aria-live="polite"''; anuncia início e fim da busca (RN15)|
  
-==== Tela 02 - Página de Resultados da Busca ====+O acionamento com campo vazio não navega. O acionamento com termo preenchido leva o campo ao estado de busca **antes** da navegação, de modo que o sinal apareça durante todo o tempo de espera.
  
-Tela responsável por exibir os resultados da pesquisa global.+==== Tela 02 - Página de Resultados da Busca (/?s={termo}) ==== 
 + 
 +Tela responsável por exibir os resultados da pesquisa global. Segue a anatomia dos hubs do Portal: cabeçalho com título e caminho de navegação, barra lateral de filtros à esquerda e área de resultados à direita. Em telas menores, a barra lateral é recolhida atrás da ação "Filtros e busca".
  
 ^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação| ^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação|
-|Termo Pesquisado|Texto|Sim|Texto informado|–|Exibe o termo utilizado na busca.| +|Busca|Campo de texto|Sim|Até 100 caracteres|Termo corrente|Permite reescrever o termo sem sair da página| 
-|Categorias de Resultado|Abas ou Filtros|Sim|Todos; Notícias; Serviços; Transparência; Páginas; Arquivos|Todos|Permite refinar resultados por tipo de conteúdo.| +|Tipo de conteúdo|Seleção única|Não|Todos os tipos, Serviço, Publicação Institucional, Notícia, Transparência, Licitação, Hub, Contato, Item de subportal, Membro do Tribunal, Página|Todos os tipos|Define o escopo e quais filtros avançados são exibidos (RN05, RN09)| 
-|Filtros Adicionais|Filtros dinâmicos|Não|Data; Tipo de Conteúdo; Assunto; Tags|–|Exibidos conforme categoria selecionada.| +|Assunto|Seleção única|Não|As opções do tema global vigente (RN10)|Todos os assuntos|Transversal; não se aplica a Transparência e Licitação (RN10)| 
-|Lista de Resultados|Lista ou Cards|–|Resultados encontrados|–|Exibe título, resumo e link de acesso.| +|Período — De / Até|Data|Não|Data válida|Vazio|Transversal; filtra pela data de publicação e não altera a ordenação (RN17)| 
-|Paginação|Componente de Paginação|–|Número da página|Página 1|Exibido quando houver mais de 10 resultados (RN06).| +|Filtros Avançados|Área dinâmica|Não|Variável por categoria|Oculto|Exibidos conforme RN09| 
-|Mensagem “Nenhum resultado”|Texto informativo|–|–|–|Exibida quando não houver resultados.|+|Ordenar por|Seleção única|Não|Relevância, Mais recentes|Relevância|RN04, RN12, RN17| 
 +|Exibir|Seleção única|Não|10, 20, 50|10|Itens por página (RN06)| 
 +|Limpar Filtros|Ação|Não|–|–|Refaz a busca apenas com o termo| 
 +|Pesquisar|Ação|Sim|–|–|Aplica termo e filtros; leva a página ao estado de carregamento (RN15)| 
 +|Contador|Texto|–|"Encontramos N resultados"|–|Concorda em número com o total| 
 +|Listagem de Resultados|Lista de cards|Sim|-|Vazio|Um card por ocorrência, com etiqueta da categoria, título, resumo e data (RN08)| 
 +|Paginação|Controle|Não|-|Página 1|Exibida acima e abaixo da lista (RN06)| 
 +|Mensagem Vazio|Texto informativo|–|"Nenhum resultado encontrado para o termo pesquisado."|–|Acompanhada de "Tente outros termos ou ajuste os filtros." e, quando houver, da sugestão de termo (RN14)| 
 + 
 +=== Filtros por categoria === 
 + 
 +^Categoria^Filtros avançados^Origem do conjunto| 
 +|Todos os tipos|Assunto, Período|—| 
 +|Serviço|Público (Cidadão, Órgãos Fiscalizados, Advogado, Licitantes, Servidor), Assunto, Período|Catálogo de Serviços (RF-009)| 
 +|Publicação Institucional|Tipo, Tipo específico, Ano de publicação, Assunto, Período|Hub de Publicações Institucionais (RF-030)| 
 +|Notícia|Autor, Tipo (Clipping, Notícia, Vídeo, Rádio), Assunto, Período|Hub de Notícias (RF-013)| 
 +|Transparência|Categoria (grupo temático), Período|Portal da Transparência (RF-016)| 
 +|Licitação|Modalidade, Ano, Situação, Período|Hub de Licitações e Contratos (RF-031)| 
 +|Hub|Assunto, Período|—| 
 +|Contato|Período|—| 
 +|Item de subportal|Subportal (Governança, Observatório do Cidadão, Primeira Infância), Assunto, Período|Hubs dos subportais (RF-017, RF-018, RF-020)| 
 +|Membro do Tribunal|Período|—| 
 +|Página|Assunto, Período|—| 
 + 
 +"Tipo específico" só é exibido quando o Tipo selecionado possui subdivisões, e é repovoado a cada troca de Tipo. 
 + 
 +Hub e Página não possuem filtro próprio: a classificação "Tipo de conteúdo" da página foi descartada e o rótulo passa a designar apenas o seletor de categoria. Contato e Membro do Tribunal não recebem o filtro de Assunto, por não possuírem esse atributo. 
 + 
 +=== Estados da interface === 
 + 
 +^Estado^Tela^Comportamento esperado| 
 +|Aguardando|Campo do cabeçalho|Campo vazio ou preenchido, aguardando acionamento| 
 +|Em busca|Campo do cabeçalho|Girador no lugar da lupa, ação de envio bloqueada, ''aria-busy'' no campo e mensagem anunciada (RN15)| 
 +|Carregando|Página de resultados|Área de resultados substituída pelo girador e pela mensagem "Buscando resultados. Aguarde..." (RN15)| 
 +|Sucesso|Página de resultados|Lista ordenada, com contador, ordenação, itens por página e paginação| 
 +|Sucesso com correção|Página de resultados|Resultados da busca corrigida, com os avisos "Exibindo resultados para {corrigido}" e "Em vez disso, pesquisar por {digitado}" (RN14)| 
 +|Vazio|Página de resultados|"Nenhum resultado encontrado para o termo pesquisado.", quando não há resultado nem para o termo digitado nem para a correção (RN14)| 
 +|Vazio por filtro|Página de resultados|Mesma mensagem, acrescida da ação "Limpar Filtros"| 
 +|Erro|Página de resultados|"Não foi possível concluir a busca. Tente novamente." e ação "Tentar novamente"|
  
 ===== Fluxos ===== ===== Fluxos =====
Linha 40: Linha 154:
  
 ^Passo^Ação^Regra^Tela| ^Passo^Ação^Regra^Tela|
-|01|O usuário insere um termo no campo de Busca Global.| |Header| +|01|O usuário insere um termo no campo de Busca Global.|RN02, RN18|Tela 01| 
-|02|O sistema apresenta sugestões automáticas conforme digitação.|RN03|Header| +|<del>02</del>|<del>O sistema apresenta sugestões automáticas conforme digitação.</del>|RN03|Tela 01| 
-|03|O usuário aciona o botão “Buscar” ou tecla Enter.| |Header| +|03|O usuário aciona o ícone de lupa ou a tecla Enter.| |Tela 01| 
-|04|O sistema processa a consulta de forma unificada.|RN01, RN02|Resultados| +|03.1|Caso o campo esteja vazio, o sistema não executa a busca e mantém o foco no campo.|RN18|Tela 01| 
-|05|O sistema apresenta os resultados organizados por relevância.|RN04|Resultados| +|04|O sistema sinaliza a busca em curso: substitui a lupa pelo girador, bloqueia a ação de envio e anuncia "Buscando resultados. Aguarde...".|RN15|Tela 01| 
-|06|Caso não existam resultados, o sistema executa o [[#fluxo_03_-_busca_sem_resultado|Fluxo 03]].| |Resultados|+|05|O sistema processa a consulta de forma unificada e apresenta os resultados ordenados por relevância ponderada pelo tipo de conteúdo.|RN01, RN04, RN11, RN12, RN13|Tela 02| 
 +|05.1|Caso não existam resultados, o sistema executa o [[#fluxo_04_-_busca_sem_resultado|Fluxo 04]].| |Tela 02| 
 +|06|O usuário seleciona uma categoria em "Tipo de conteúdo".|RN05|Tela 02| 
 +|07|O sistema exibe os filtros avançados daquela categoria e oculta os das demais.|RN09|Tela 02| 
 +|08|O usuário aciona "Pesquisar".| |Tela 02| 
 +|09|O sistema refina os resultados mantendo o termo pesquisado.|RN05, RN06|Tela 02|
  
-==== Fluxo 02 - Refinar Busca por Categoria ====+==== Fluxo 02 - Refinar Busca por Categoria e Filtros ====
  
 ^Passo^Ação^Regra^Tela| ^Passo^Ação^Regra^Tela|
-|01|O usuário seleciona uma categoria de resultado.| |Resultados| +|01|O usuário seleciona uma categoria e preenche os filtros exibidos.|RN09|Tela 02| 
-|02|O sistema filtra os resultados conforme categoria selecionada.|RN05|Resultados| +|02|O usuário aciona "Pesquisar".| |Tela 02| 
-|03|O sistema atualiza a listagem mantendo o termo pesquisado.|RN05|Resultados|+|03|O sistema substitui a área de resultados pelo estado de carregamento.|RN15|Tela 02| 
 +|04|O sistema filtra os resultados conforme a categoria e os filtros selecionados, mantendo o termo.|RN05|Tela 02| 
 +|04.1|Caso não existam resultados, o sistema exibe a mensagem de ausência e a ação "Limpar Filtros".| |Tela 02| 
 +|05|O usuário aciona "Limpar Filtros" e o sistema refaz a busca apenas com o termo.| |Tela 02|
  
-==== Fluxo 03 - Busca sem Resultado ====+==== Fluxo 03 - Ordenar Resultados ====
  
 ^Passo^Ação^Regra^Tela| ^Passo^Ação^Regra^Tela|
-|01|O sistema não localiza resultados para o termo informado.| |Resultados| +|01|O usuário seleciona a opção desejada em "Ordenar por".|RN04, RN17|Tela 02| 
-|02|O sistema apresenta a mensagem: “Nenhum resultado encontrado para o termo pesquisado.”| |Resultados| +|02|Com "Relevância", o sistema ordena pela pontuação textual somada ao peso do tipo, resolvendo empates pela data mais recente.|RN04, RN12|Tela 02| 
-|03|O sistema mantém o campo de busca disponível para nova tentativa.| |Resultados|+|03|Com "Mais recentes", o sistema ordena pela data de publicação decrescente e não aplica o peso do tipo.|RN17|Tela 02| 
 + 
 +==== Fluxo 04 - Busca sem Resultado ==== 
 + 
 +^Passo^Ação^Regra^Tela| 
 +|01|O sistema não localiza resultados para o termo e os filtros informados.| |Tela 02| 
 +|02|O sistema procura no vocabulário de busca um termo próximo ao digitado.|RN14, RN14.1|Tela 02| 
 +|02.1|Havendo termo próximo, o sistema executa a busca corrigida e apresenta "Exibindo resultados para {termo corrigido}" e "Em vez disso, pesquisar por {termo digitado}", este como link.|RN14|Tela 02| 
 +|03|Não havendo termo próximo, ou não havendo resultado também para o termo corrigido, o sistema apresenta a mensagem "Nenhum resultado encontrado para o termo pesquisado."|RN14|Tela 02| 
 +|04|Havendo filtro aplicado, o sistema apresenta a ação "Limpar Filtros".| |Tela 02| 
 +|05|O sistema mantém o termo no campo de busca, disponível para nova tentativa.| |Tela 02| 
 + 
 +==== Fluxo 05 - Falha na Consulta (Exceção) ==== 
 + 
 +^Passo^Ação^Regra^Tela| 
 +|01|A consulta não é concluída por indisponibilidade.| |Tela 02| 
 +|02|O sistema apresenta a mensagem "Não foi possível concluir a busca. Tente novamente."| |Tela 02| 
 +|03|O sistema apresenta a ação "Tentar novamente", que repete a consulta com o mesmo termo e os mesmos filtros.| |Tela 02|
  
 ===== RN – Regras de Negócio ===== ===== RN – Regras de Negócio =====
  
 ^ID^Descrição| ^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, atos normativos, jurisprudência, notícias, páginas e serviços.| +|RN01|**Busca Unificada** – O sistema executa a pesquisa, em operação única, sobre os conteúdos publicados dos tipos: serviço, publicação institucional, notícia, item do Portal da Transparência (RF-016), licitação (RF-031), página (incluídas as páginas-âncora de seção), contato institucional (RF-024), item de subportal — Governança (RF-020), Observatório do Cidadão (RF-017) e Primeira Infância (RF-018) — e membro do Tribunal (RF-019). Conteúdo com situação diferente de "Publicado" nunca é retornado; contato com situação inativa também não (RN21).| 
-|RN02|**Aceitação de Critérios Variáveis** – O sistema deve permitir pesquisa por termos livres.| +|RN02|**Aceitação de Critérios Variáveis** – O sistema permite pesquisa por termo livre: palavra, expressão, nome ou número. A correspondência é parcial, sem distinção entre maiúsculas e minúsculas e sem distinção de acentuação.| 
-|RN03|**Sugestão Preditiva** – Durante a digitação, o sistema deve apresentar sugestões automáticas de serviços, conteúdos e processos correspondentes ao termo parcial informado.| +|<del>RN03</del>|<del>**Sugestão Preditiva** – Durante a digitação, e após o usuário digitar 3 caracteres, o sistema deve apresentar sugestões automáticas.</del> **Revogada em 2026-07-13.** Identificador preservado e não reaproveitado.| 
-|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.| +|RN04|**Ordenação por Relevância** – Com "Relevância" selecionado, os resultados são ordenados pela soma da pontuação textual com o peso do tipo de conteúdo (RN12). A pontuação textual considera: título idêntico ao termo (600), título contendo o termo (400), assunto correspondente (250), palavra-chave correspondente (200), resumo (120), conteúdo (100) e campo pesquisável do tipo (80), acrescidas das pontuações por palavra isolada do termo. Empates são resolvidos pela data de publicação mais recente.| 
-|RN05|**Filtro por Categoria** – O sistema deve permitir a filtragem dos resultados por tipo de conteúdo, mantendo o termo originalmente pesquisado.| +|RN05|**Filtro por Categoria** – A seleção de categoria restringe os resultados àquele tipo de conteúdo, mantendo o termo originalmente pesquisado e os filtros transversais compatíveis.| 
-|RN06|**Paginação de Resultados** – O sistema deve apresentar os resultados de forma paginada, exibindo 10 (dez) registros por página quando aplicável.| +|RN06|**Paginação de Resultados** – Os resultados são paginados em 10, 20 ou 50 registros por página, à escolha do usuário, com padrão de 10. A paginação é exibida acima e abaixo da listagem.| 
-|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.| +|RN07|**Indexação Temática** – O assunto e as palavras-chave preenchidos na gestão de conteúdo participam da correspondência e da pontuação, de modo que o conteúdo seja retornado mesmo quando o termo não consta do título.| 
-|RN08|**Compatibilidade Mobile** – A funcionalidade de Busca Global deve ser totalmente operável em dispositivos móveis, sem sobreposição de menus ou ocultação de campos de busca.| +|RN08|**Fragmento de Texto (Snippet)** – Cada resultado exibe título e resumo com todas as ocorrências do termo destacadas. O resumo vem do campo próprio de cada tipo — resumo da notícia, resumo da publicação, descrição do serviço, descrição breve do item de transparência, objeto da licitação — e, na ausência dele, das primeiras 28 palavras do conteúdo.| 
-|RN09|**Integração com Catálogo de Serviços** – A busca deve considerar os serviços publicados no Portal e seus respectivos links institucionais.|+|RN09|**Exibição Condicional de Filtros** – Os filtros avançados exibidos correspondem à categoria selecionada em "Tipo de conteúdo", conforme a tabela "Filtros por categoria" da Tela 02. Filtro de categoria não selecionada não é submetido nem aplicado.| 
 +|RN10|**Assuntos (Tema Global)** – O filtro transversal "Assunto" é alimentado pela lista de assuntos do tema global, **mantida pelo RF-030** como fonte única e compartilhada pelos módulos editoriais. A busca não mantém lista própria: reflete a lista vigente. Composição atual, com 35 opções: Acessibilidade, Administração, Agropecuária, Assistência Social, Ciência e Tecnologia, Comunicação Institucional, Contratações Públicas, Contratos e Despesas, Controle Externo, Cultura, Desenvolvimento Regional, Economia, Educação, Energia, Esporte e Lazer, Finanças Públicas, Gestão Ambiental, Gestão de Pessoas, Gestão Estadual, Gestão Patrimonial, Governança, Habitação, Jurisprudência, Licitações, Obras, Participação Cidadã, Planejamento e Orçamento, Previdência Social, Primeira Infância, Saneamento, Saúde, Segurança Pública, Sustentabilidade, Transparência e Transporte. \\ Agropecuária, Controle Externo, Esporte e Lazer, Governança, Habitação, Primeira Infância e Transparência foram acrescentados em 2026-09-18, na classificação das publicações migradas do Liferay (RF-033, decisão M5).| 
 +|RN11|**Critérios de Busca** – A correspondência é feita sobre título, resumo, conteúdo e os campos pesquisáveis declarados em RN13. Quando o termo tem mais de uma palavra, todas precisam ocorrer no mesmo registro, não necessariamente no mesmo campo. Os resultados seguem o padrão de exibição e navegação da sua área de origem, incluindo a indicação visual de link externo, sem abertura automática de nova aba.| 
 +|RN12|**Peso por Tipo de Conteúdo** – À pontuação textual de RN04 soma-se o peso do tipo: \\ Serviço 300 \\ Publicação Institucional 240 \\ Notícia 180 \\ Item de seção (Transparência e Licitação) 120 \\ Hub 60 \\ Contato 30 \\ Item de subportal 30 \\ Membro do Tribunal 30 \\ Página 0 \\ O peso ordena entre iguais e não anula a aderência textual: notícia cujo termo está no título (400 + 180 = 580) precede serviço cujo termo está apenas no conteúdo (100 + 300 = 400).| 
 +|RN13|**Campos Pesquisáveis por Tipo** – Além de título, resumo e conteúdo, a busca considera apenas os campos declarados a seguir; nenhum outro metadado é varrido, em particular identificadores, referências a arquivos, ícones, controles internos e chaves de definição de campo. \\ **Serviço:** descrição resumida, sobre o serviço, chamada, público-alvo, requisitos de acesso. \\ **Publicação institucional:** resumo, descrição completa, palavras-chave, autoria, número da edição, assunto. \\ **Notícia:** resumo, corpo, chapéu, autor, palavras-chave, assunto. \\ **Item de transparência:** descrição breve, corpo. \\ **Licitação:** número, número do processo, objeto, solicitante, participante. \\ **Contato:** nome, nome de exibição, responsável, ramais e endereços de e-mail. \\ **Item de subportal:** descrição breve, conteúdo e autoria. \\ **Membro do Tribunal:** cargo, título e biografia. \\ **Página:** nenhum campo adicional.| 
 +|RN14|**Correção do Termo** – A consulta é executada sempre com o termo digitado pelo usuário. **Somente quando ela devolve zero resultados** o sistema procura no vocabulário de busca um termo próximo ao digitado; havendo um, executa a busca corrigida e apresenta, acima dos resultados, "Exibindo resultados para **{termo corrigido}**" e "Em vez disso, pesquisar por **{termo digitado}**", este como link que refaz a busca sem correção. Não havendo termo próximo, apresenta a mensagem de ausência de resultado. Busca com resultados nunca é corrigida.| 
 +|RN14.1|**Vocabulário de Busca** – O vocabulário usado por RN14 é formado pelos títulos dos conteúdos publicados, pelos assuntos padronizados (RN10) e pelas palavras-chave preenchidas na gestão de conteúdo. Não inclui os demais metadados — nome de ícone, referência a arquivo, identificador e afins não são candidatos a correção. É reconstruído por rotina agendada, não a cada gravação de conteúdo.| 
 +|RN15|**Sinalização de Execução** – Toda busca em curso é sinalizada em até 200 ms do acionamento. No cabeçalho, o ícone de lupa é substituído pelo girador e a ação de envio é bloqueada até a resposta; na página de resultados, a área de resultados é substituída pelo girador com a mensagem "Buscando resultados. Aguarde...". Em ambos os casos o estado é anunciado por região ''aria-live="polite"''. O bloqueio da ação impede o disparo em duplicidade.| 
 +|RN16|**Tempo de Resposta** – 95% das buscas respondem em até 3 segundos e nenhuma ultrapassa 8 segundos, medidos no servidor, sobre termos distintos e sem cache prévio. Para sustentar a meta: uma única consulta de resultados por requisição; conjunto de resultados mantido em cache por 15 minutos, identificado por termo, filtros, ordenação e página; cache invalidado na publicação ou alteração de conteúdo dos tipos de RN01.| 
 +|RN17|**Período e Ordenação** – O período informado filtra pela data de publicação e não altera a ordenação escolhida. Com "Mais recentes", os resultados são ordenados pela data de publicação decrescente e o peso de tipo de RN12 não se aplica.| 
 +|RN18|**Validação do Termo** – O termo é limitado a 100 caracteres, descartado o excedente. Acionamento com campo vazio não executa busca. Termo composto apenas de marcação ou de caracteres removidos na sanitização é tratado como busca sem resultado, nunca como listagem sem filtro.| 
 +|RN19|**Categoria Hub** – São classificadas como Hub as páginas-âncora de seção: Transparência, Imprensa, Observatório do Cidadão, Pacto Nacional pela Primeira Infância, Governança, Planejamento e Gestão, Licitações e Contratos, O Tribunal e Serviços. A relação é **mantida no código do tema**, em ponto único, e não depende de marcação na gestão de conteúdo; página fora da relação é classificada como Página. Seção nova exige alteração da relação e nova publicação do tema. **Jurisprudência e Atos Normativos não integra a lista**: é serviço à parte, com motor de busca próprio (RN20).| 
 +|RN20|**Jurisprudência e Atos Normativos** – A consulta de jurisprudência e atos normativos é serviço à parte, com acervo e motor de busca próprios (Elasticsearch). A busca global **não faz requisição a esse serviço** e não retorna acórdãos, resoluções nem demais atos. O serviço é alcançável pela busca como resultado da categoria Serviço, a partir do seu título, da sua descrição e das suas palavras-chave (RN13), levando o usuário à consulta especializada.| 
 +|RN21|**Destino do Resultado sem Endereço Próprio** – Contato e item de Governança não possuem página própria no portal. O resultado de **contato** leva à página de Contatos, com o contato localizado; somente contatos ativos são retornados. O resultado de **item de Governança** leva ao endereço de destino do item quando ele for link, e à sua página dentro do hub da Governança quando for conteúdo próprio. Itens do Observatório do Cidadão, itens da Primeira Infância e membros do Tribunal possuem endereço próprio e são apontados diretamente.| 
 + 
 +===== Histórico de versões ===== 
 + 
 +^Versão^Data^O que mudou^Motivo^Demanda| 
 +|1.0|2026-04-20|Versão inicial: telas 01 e 02, regras RN01 a RN11 e três fluxos|Especificação original da busca global|#39403| 
 +|1.1|2026-07-13|RN03 (sugestão preditiva) revogada; elemento e passo de fluxo correspondentes marcados como removidos|Remoção da sugestão preditiva|#39403| 
 +|2.0|2026-09-19|Projeção regenerada a partir do ''PRD.md'' 2.0. Acrescidas as seções Problema/escopo, Comportamento atual e esperado, Restrições, Critérios de aceite, Dúvidas pendentes e este histórico. Acrescidas RN12 a RN21, e RN14.1 (peso por tipo, campos pesquisáveis, correção só no resultado vazio, vocabulário de busca, sinalização de execução, tempo de resposta, período e ordenação, validação do termo, categoria Hub, jurisprudência como serviço à parte, destino do resultado sem endereço próprio). Alteradas RN01, RN04, RN05, RN06, RN09, RN10 e RN11. Contatos, itens de subportal e membros do Tribunal passam a ser retornados, com peso 30. Descartados os filtros "Tipo de serviço" e "Tipo de conteúdo" da página. RN10 passa a referenciar a lista de assuntos do tema global mantida pelo RF-030, hoje com 35 opções. Fluxos renumerados de 01 a 05, com a inclusão do fluxo de ordenação e do fluxo de falha na consulta|Evolução da busca: prioridade por tipo de conteúdo, filtros alinhados aos hubs e resposta perceptível|#39403 e demanda da evolução a abrir| 
 + 
 +---- 
 + 
 +Elaborado com: ''research-v2.md'' e ''documentar-funcionalidade-v2.md''
  
 +Revisado por: @pramorim - Paulo Ricardo Amorim Silva
  • pres/gerti/gestao_de_ativos/portal/er_003.1772136060.txt.gz
  • Última modificação: 26/02/2026 20:01
  • por pramorim