Demanda — Busca Geral do OLA

Portal da demanda que especifica a página de busca geral para recuperar páginas, imagens, PDFs e artefatos do OLA.

1. Visão geral da demanda

A demanda busca_geral_ola tem como objetivo especificar uma página de busca geral para o OLA. A busca deve recuperar artefatos já publicados, como páginas HTML, imagens, PDFs, demandas, entregas e materiais de apoio.

Necessidade:
recuperar conhecimento produzido no OLA.

Solução planejada:
busca.html + busca_index.json + gerar_busca_index.py.

Primeira versão:
estática, sem back-end, baseada em índice JSON gerado localmente.

2. Problema central

À medida que o OLA cresce, torna-se mais difícil lembrar onde cada página, imagem, infograma, demanda ou entrega foi armazenada. A navegação ajuda quando o caminho é conhecido, mas a busca é necessária quando o usuário lembra do tema, do nome parcial ou do tipo de artefato.

Problema:
como localizar rapidamente artefatos do OLA
sem depender de cadastro manual
e sem back-end na primeira versão?

3. Fluxo de obtenção da demanda

Problema
  ↓
Situações Reais
  ↓
Cenários
  ↓
Stakeholders
  ↓
Ecossistema
  ↓
Modelo Mental
  ↓
Jornada
  ↓
Mapa da Experiência
  ↓
Pontos de Contato
  ↓
Wireframe
  ↓
Arquitetura da Informação
  ↓
Sistema de Navegação
  ↓
Diagrama de Navegação
  ↓
Blueprint
  ↓
Casos de Uso
  ↓
Requisitos
  ↓
Funcionalidades
  ↓
Regras
  ↓
Casos de Teste
  ↓
Rastreabilidade
  ↓
Planejamento
  ↓
Riscos e Mitigação
  ↓
Notas Privadas
  ↓
Entrega

4. Artefatos da demanda

Compreensão

Situações reais

Onde a necessidade de busca aparece na prática.

Compreensão

Cenários

Histórias de uso que descrevem a busca em ação.

Contexto

Stakeholders

Participantes, papéis e interesses envolvidos.

Contexto

Ecossistema

Ambiente sistêmico onde a busca opera.

Experiência

Modelo mental

Como o usuário imagina a busca e como ela funciona.

Experiência

Jornada

Sequência da experiência: lembrar, buscar, encontrar e abrir.

Experiência

Mapa da experiência

Ações, dores, emoções, oportunidades e respostas esperadas.

Experiência

Pontos de contato

Elementos onde usuário, sistema e artefatos se encontram.

Interface

Wireframe

Organização visual esperada para a interface de busca.

Arquitetura

Arquitetura da Informação

Rótulos, filtros, metadados, categorias e cards.

Navegação

Sistema de Navegação

Navegação global, local, contextual, estrutural e relacional.

Navegação

Diagrama de Navegação

Visão gráfica dos caminhos de entrada, busca e abertura.

Operação

Blueprint

Camadas visíveis e internas da operação da busca.

Especificação

Casos de uso

Interações entre usuário, administrador e subsistema.

Especificação

Requisitos

O que o subsistema de busca deve atender.

Especificação

Funcionalidades

Capacidades operacionais previstas para a busca.

Especificação

Regras de funcionamento

Regras de busca, atualização, segurança e publicação.

Validação

Casos de teste

Testes previstos antes da implementação e publicação.

Validação

Rastreabilidade

Conexão entre situação, cenário, requisito, regra e teste.

Planejamento

Planejamento

Etapas para transformar a demanda em entrega funcional.

Riscos

Riscos e mitigação

Riscos da busca e ações preventivas ou corretivas.

Interno

Notas privadas

Reflexões, decisões, dúvidas e pendências internas.

5. Arquitetura prevista da solução

Componente Local previsto Função
busca.html Raiz do OLA Interface da busca geral usada pelo usuário no navegador.
busca_index.json Raiz do OLA Índice estático contendo páginas, imagens, PDFs e metadados.
gerar_busca_index.py Ambiente local / documentação da entrega Script para varrer a estrutura física do OLA e gerar o JSON.
entregas/busca_geral_ola/ Pasta de entrega Documentação de uso, testes executados, avaliação e lições aprendidas.

6. Busca, navegação, mapa do site e grafo

A busca não substitui a navegação do OLA. Ela complementa outros mecanismos de acesso ao conhecimento.

Recurso Pergunta que responde Função no OLA
Navegação Onde isso fica na estrutura? Conduz o usuário por caminhos planejados.
Busca Onde está aquilo que eu lembro? Recupera artefatos por termos, nomes, caminhos e tipos.
Mapa do site Qual é a estrutura do todo? Mostra a organização geral do OLA.
Grafo / rede de tópicos Com que isso se relaciona? Permite explorar relações de conhecimento.

7. Escopo da primeira versão

Incluído:
- busca por páginas HTML;
- busca por imagens;
- busca por PDFs publicados;
- filtro por área;
- filtro por tipo;
- miniatura de imagem;
- abertura do artefato;
- funcionamento sem back-end.

Fora da primeira versão:
- busca semântica com IA;
- banco de dados;
- login;
- permissões por usuário;
- indexação automática no servidor;
- busca dentro do conteúdo integral de PDFs.

8. Estado atual da demanda

Área Situação Observação
Compreensão do problema Concluída Situações reais e cenários definidos.
Experiência do usuário Concluída Modelo mental, jornada, mapa da experiência e pontos de contato definidos.
Arquitetura da solução Concluída Wireframe, arquitetura da informação, sistema e diagrama de navegação definidos.
Especificação funcional Concluída Casos de uso, requisitos, funcionalidades e regras definidos.
Validação Revisar Casos de teste e rastreabilidade devem ser revisados com os artefatos novos.
Planejamento e riscos Concluídos Planejamento e riscos registrados.
Entrega Pendente Próxima fase: construir busca.html, busca_index.json e gerar_busca_index.py.

9. Próximos passos

1. Revisar rastreabilidade.html.
2. Revisar casos_teste.html.
3. Conferir links internos da demanda.
4. Iniciar a entrega:
   - busca.html
   - busca_index.json
   - gerar_busca_index.py
5. Registrar testes executados na entrega.

10. Síntese

A demanda Busca Geral do OLA especifica um subsistema de recuperação de informação e conhecimento. Ela começou como uma página de busca, mas evoluiu para uma especificação completa envolvendo experiência do usuário, arquitetura da informação, navegação, requisitos, testes, planejamento e riscos.

O próximo movimento é revisar a rastreabilidade e os testes para, em seguida, iniciar a entrega funcional.