| Ambos lados da revisão anterior Revisão anterior Próxima revisão | Revisão anterior |
| pres:gerti:gestao_de_ativos:portal:er_003 [04/03/2026 14:36] – [Fluxo 01 - Executar Busca Global (Fluxo Principal)] pramorim | pres:gerti:gestao_de_ativos:portal:er_003 [20/09/2026 02:14] (atual) – pramorim |
|---|
| ====== [ER_003] 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 ===== |
| |
| ^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, 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|-|–|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}) ==== |
| |
| ^ Elemento ^ Tipo ^ Obrigatório ^ Valores Possíveis ^ Valor Padrão ^ Observação | | 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". |
| | 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.| | |
| |
| | ^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação| |
| | |Busca|Campo de texto|Sim|Até 100 caracteres|Termo corrente|Permite reescrever o termo sem sair da página| |
| | |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)| |
| | |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)| |
| | |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)| |
| | |Filtros Avançados|Área dinâmica|Não|Variável por categoria|Oculto|Exibidos conforme RN09| |
| | |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 ===== |
| |
| ^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 a açã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 e apresenta os resultados organizados por relevância.|RN01, RN02, RN04|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| |
| |04.1|Caso não existam resultados, o sistema executa o [[#fluxo_03_-_busca_sem_resultado|Fluxo 03]].| |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| |
| |05|O usuário seleciona um filtro específico (ex: Serviços).|RN03|Tela 01| | |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| |
| |06|O sistema atualiza a lista e exibe os filtros avançados daquela categoria (ex: Público "Advogados").|RN09|Tela 01| | |05.1|Caso não existam resultados, o sistema executa o [[#fluxo_04_-_busca_sem_resultado|Fluxo 04]].| |Tela 02| |
| |07|O sistema refina os resultados mantendo o termo de busca|RN06|Tela 01| | |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, notícias, páginas, publicações 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 notícias, páginas, publicações e serviços 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. Quando houver período inserido, a ordeneção deve ser feita pela data mais atual. | | |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|**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.| | |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|**Exibição Condicional de Filtros**: Exibição Condicional de Filtros: O sistema deve renderizar os componentes de filtro avançado dinamicamente com base na aba (Filtro Primário) selecionada, 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 transversal de Assunto, o Tipo de dado (Despesa, Receita, Pessoal, Licitação, Convênio) e o Ano de Exercício. \\ **6. Publicações Institucionais**: Exibe o filtro de Tipo (Normativo, Sumário Executivo, Livro, Apresentação, Cartilha/Manual/Tutorial, Revista/Periódico, Relatório de Fiscalização, Relatório de Gestão) e o transversal de Assunto.| | |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 de "Assunto" deve ser alimentado obrigatoriamente pelas seguintes opções padronizadas: Acessibilidade, Administração, Assistência Social, Ciência e Tecnologia, 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, 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.| | |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 |