Cenários — Busca Geral do OLA

Histórias concretas de uso que mostram como as situações reais se transformam em interações esperadas com o subsistema de busca.

1. Finalidade

Esta página registra os cenários da demanda Busca Geral do OLA. Os cenários descrevem histórias concretas de uso, derivadas das situações reais, antes da formalização dos casos de uso.

2. Posição dos cenários no processo

No OLA, o cenário fica entre a situação real e o caso de uso. Ele transforma uma ocorrência da vida real em uma história compreensível de interação.

Problema
  ↓
Situações reais
  ↓
Cenários
  ↓
Casos de uso
  ↓
Requisitos
  ↓
Funcionalidades
  ↓
Regras
  ↓
Casos de teste

3. O que é um cenário nesta demanda?

Um cenário é uma narrativa curta que descreve:

  • quem está usando ou precisando da busca;
  • qual é a intenção do usuário;
  • qual dificuldade aparece;
  • qual ação é realizada;
  • qual resultado esperado encerra a situação.

4. Cenários identificados

Código Cenário Situação real de origem Descrição narrativa Resultado esperado
C01 Localizar imagem pelo tema SR01 Walter lembra que criou uma imagem sobre OLA como organismo vivo, mas não lembra em qual pasta ela está. Ele acessa a Busca Geral do OLA e digita organismo vivo. A busca apresenta a imagem correspondente com miniatura e link para abrir.
C02 Localizar página pelo assunto SR02 Walter lembra que existe uma página sobre sistema cognitivo do conhecimento, mas não lembra o nome exato do arquivo. Ele pesquisa por sistema cognitivo. A busca retorna páginas relacionadas ao tema e permite abrir a página desejada.
C03 Localizar artefatos de uma demanda SR03 Walter deseja revisar tudo que foi produzido para uma demanda, como busca_geral_ola, llm ou ux_leandro_galvao. A busca retorna páginas e arquivos localizados dentro da pasta da demanda.
C04 Localizar artefatos de uma entrega SR04 Walter quer abrir rapidamente uma entrega já publicada para compartilhar, revisar ou atualizar. Ele pesquisa pelo nome da entrega. A busca apresenta os arquivos relacionados à entrega correspondente.
C05 Verificar publicação de nova página SR05 Walter cria uma nova página no OLA, gera novamente o índice e pesquisa pelo nome ou tema da página para confirmar se ela aparece. A nova página aparece nos resultados após atualização do busca_index.json.
C06 Verificar publicação de nova imagem SR06 Walter cria ou substitui uma imagem, atualiza o índice e pesquisa pelo tema ou nome do arquivo. A imagem aparece com miniatura clicável e abre corretamente.
C07 Mostrar material durante conversa SR07 Durante uma conversa presencial ou remota, Walter quer abrir rapidamente uma página ou imagem para explicar uma ideia do OLA. A busca permite encontrar e abrir o material sem navegar manualmente pelas pastas.
C08 Buscar pelo celular ou tablet SR08 Walter acessa o OLA em celular ou tablet e precisa encontrar uma página ou imagem sem usar navegação complexa. A busca apresenta resultados legíveis, em cards responsivos e com links clicáveis.
C09 Visitante encontra conteúdo público SR09 Um visitante do site deseja localizar conteúdo sobre sistemas, conhecimento, UX, LLM ou outro tema publicado no OLA. A busca retorna páginas e imagens públicas relacionadas ao termo pesquisado.
C10 Evitar cadastro manual de itens SR10 Walter percebe que cadastrar manualmente cada página e imagem é trabalhoso. Ele roda o gerador do índice para que os arquivos sejam descobertos automaticamente. O arquivo busca_index.json é atualizado sem cadastro manual item a item.

5. Cenário detalhado de referência

C01 — Localizar imagem pelo tema

Contexto:
Walter lembra que criou uma imagem sobre "OLA como organismo vivo".

Dificuldade:
Ele não lembra a pasta nem o nome exato do arquivo.

Ação:
Walter acessa busca.html e digita "organismo vivo".

Resposta esperada:
A busca apresenta a imagem correspondente, com miniatura e link clicável.

Resultado:
Walter abre a imagem em nova aba.

6. Rastreabilidade entre situações reais, cenários e requisitos

Situação real Cenário derivado Requisitos relacionados Próximo artefato esperado
SR01 C01 — Localizar imagem pelo tema RF02, RF03, RF04, RF07 UC01 — Localizar imagem
SR02 C02 — Localizar página pelo assunto RF01, RF03, RF07 UC02 — Localizar página HTML
SR03 C03 — Localizar artefatos de uma demanda RF05, RF07, RF10 UC03 — Filtrar ou buscar por demanda
SR05 C05 — Verificar publicação de nova página RF08, RF10, RNF06 UC05 — Atualizar índice de busca
SR08 C08 — Buscar pelo celular ou tablet RNF03, RNF04 UC08 — Usar busca em dispositivo móvel
SR10 C10 — Evitar cadastro manual de itens RF08, RNF05 UC10 — Gerar índice automaticamente

7. Ponte para casos de uso

Os cenários desta página serão usados para construir os casos de uso da demanda. Cada cenário pode originar um ou mais casos de uso.

Cenário:
Walter procura a imagem "OLA como organismo vivo".

Caso de uso derivado:
UC01 — Localizar imagem.

Fluxo esperado:
1. Usuário acessa a busca.
2. Usuário digita termo.
3. Sistema consulta o índice.
4. Sistema exibe resultado.
5. Usuário abre a imagem.

8. Síntese

Os cenários tornam visível como o problema de localização de conhecimento aparece na prática. Eles preparam a demanda para a próxima etapa: a definição formal dos casos de uso do subsistema Busca Geral do OLA.