Casos de Uso — Busca Geral do OLA

1. Finalidade

Esta página registra os casos de uso do subsistema Busca Geral do OLA. Os casos de uso descrevem como os atores interagem com a busca para localizar, abrir, verificar e atualizar artefatos publicados no OLA.

2. Posição dos casos de uso no processo

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

3. Atores

Código	Ator	Descrição	Interesse na busca
A01	Walter — Autor do OLA	Usuário principal, produtor e organizador dos artefatos do OLA.	Encontrar rapidamente páginas, imagens, demandas, entregas e modelos.
A02	Visitante do OLA	Pessoa que acessa o site publicado para conhecer ou consultar conteúdo.	Localizar conteúdos públicos por tema ou palavra-chave.
A03	Administrador do OLA	Papel responsável por gerar o índice, publicar arquivos e verificar resultados.	Atualizar o índice e garantir que os resultados estejam corretos.

4. Lista de casos de uso

Código	Nome	Ator principal	Cenário de origem	Objetivo
UC01	Localizar imagem	A01, A02	C01, C06	Encontrar e abrir uma imagem publicada no OLA.
UC02	Localizar página HTML	A01, A02	C02	Encontrar e abrir uma página HTML publicada.
UC03	Localizar artefatos de uma demanda	A01	C03	Encontrar páginas e arquivos relacionados a uma demanda específica.
UC04	Localizar artefatos de uma entrega	A01	C04	Encontrar páginas e arquivos relacionados a uma entrega específica.
UC05	Atualizar índice de busca	A03	C05, C06, C10	Gerar novo `busca_index.json` a partir da estrutura física do OLA.
UC06	Usar busca em dispositivo móvel	A01, A02	C08	Pesquisar e abrir resultados em celular ou tablet.
UC07	Encontrar conteúdo público	A02	C09	Permitir que visitantes encontrem conteúdos públicos do OLA.
UC08	Verificar publicação de novo artefato	A03	C05, C06	Confirmar se página ou imagem recém-publicada aparece nos resultados.

5. UC01 — Localizar imagem

Ator principal:
Walter ou visitante do OLA.

Objetivo:
Encontrar uma imagem publicada no OLA.

Pré-condição:
A imagem deve existir na estrutura física do OLA e estar presente no busca_index.json.

Fluxo principal:
1. O usuário acessa busca.html.
2. O usuário digita um termo, por exemplo: organismo vivo.
3. O sistema consulta busca_index.json.
4. O sistema apresenta os resultados encontrados.
5. O sistema exibe miniatura quando o resultado for imagem.
6. O usuário clica no título, caminho ou miniatura.
7. A imagem abre em nova aba.

Pós-condição:
A imagem foi localizada e aberta.

6. UC02 — Localizar página HTML

Ator principal:
Walter ou visitante do OLA.

Objetivo:
Encontrar uma página HTML publicada.

Pré-condição:
A página deve existir no OLA e estar indexada.

Fluxo principal:
1. O usuário acessa busca.html.
2. O usuário digita um termo relacionado ao assunto.
3. O sistema consulta o índice.
4. O sistema apresenta páginas relacionadas.
5. O usuário clica no resultado desejado.
6. A página HTML abre no navegador.

Pós-condição:
A página foi localizada e aberta.

7. UC03 — Localizar artefatos de uma demanda

Ator principal:
Walter.

Objetivo:
Encontrar arquivos relacionados a uma demanda específica.

Fluxo principal:
1. Walter acessa busca.html.
2. Digita o nome ou parte do nome da demanda.
3. O sistema retorna arquivos localizados na pasta da demanda.
4. Walter abre o arquivo desejado.

Exemplo:
busca_geral_ola
llm
ux_leandro_galvao

8. UC04 — Localizar artefatos de uma entrega

Ator principal:
Walter.

Objetivo:
Encontrar arquivos relacionados a uma entrega já produzida.

Fluxo principal:
1. Walter acessa a busca.
2. Digita o nome da entrega ou tema relacionado.
3. O sistema retorna páginas, imagens ou arquivos da entrega.
4. Walter abre o artefato desejado.

9. UC05 — Atualizar índice de busca

Ator principal:
Administrador do OLA.

Objetivo:
Gerar novo busca_index.json.

Pré-condição:
Existem páginas, imagens ou PDFs novos, alterados ou removidos.

Fluxo principal:
1. O administrador abre o terminal no Mac.
2. Acessa a pasta raiz local do OLA.
3. Executa gerar_busca_index.py.
4. O script varre as pastas permitidas.
5. O script gera busca_index.json.
6. O administrador publica o novo arquivo na Hostinger.

Pós-condição:
A busca passa a refletir a estrutura atualizada do OLA.

10. UC06 — Usar busca em dispositivo móvel

Ator principal:
Walter ou visitante.

Objetivo:
Realizar busca em celular ou tablet.

Fluxo principal:
1. O usuário acessa busca.html em dispositivo móvel.
2. Digita o termo de busca.
3. O sistema mostra resultados em layout responsivo.
4. O usuário toca no resultado.
5. O arquivo abre no navegador móvel.

11. UC07 — Encontrar conteúdo público

Ator principal:
Visitante do OLA.

Objetivo:
Localizar conteúdo público publicado no OLA.

Fluxo principal:
1. O visitante acessa a busca.
2. Digita um tema.
3. O sistema retorna resultados públicos.
4. O visitante abre o conteúdo desejado.

12. UC08 — Verificar publicação de novo artefato

Ator principal:
Administrador do OLA.

Objetivo:
Confirmar que uma nova página ou imagem aparece na busca.

Fluxo principal:
1. O administrador publica o novo artefato.
2. Atualiza o índice.
3. Acessa busca.html.
4. Pesquisa pelo nome ou tema do artefato.
5. Confirma se o resultado aparece.
6. Clica no resultado para verificar abertura.

13. Rastreabilidade entre cenários, casos de uso e requisitos

Cenário	Caso de uso	Requisitos relacionados	Funcionalidades derivadas
C01, C06	UC01 — Localizar imagem	RF02, RF03, RF04, RF07	Pesquisar imagens; exibir miniaturas; abrir imagem.
C02	UC02 — Localizar página HTML	RF01, RF03, RF07	Pesquisar páginas; abrir página; buscar por nome/caminho.
C03	UC03 — Localizar artefatos de demanda	RF05, RF07, RF10	Buscar por área; buscar por caminho; contar resultados.
C04	UC04 — Localizar artefatos de entrega	RF05, RF07, RF10	Buscar por pasta; listar resultados relacionados.
C05, C06, C10	UC05 — Atualizar índice	RF08, RF09, RNF05, RNF06	Gerar índice; ignorar arquivos indevidos; atualizar busca.
C08	UC06 — Usar busca móvel	RNF03, RNF04	Layout responsivo; cards legíveis; links acessíveis.
C09	UC07 — Encontrar conteúdo público	RF01, RF02, RF03, RF05, RF07	Busca pública por tema, formato e área.
C05, C06	UC08 — Verificar novo artefato	RF08, RF10, RNF06	Atualizar índice; buscar novo item; confirmar abertura.

14. Ponte para funcionalidades

A partir dos casos de uso, a próxima página poderá extrair as funcionalidades do subsistema. Por exemplo:

UC01 — Localizar imagem
  ↓
Funcionalidades:
- pesquisar imagens;
- exibir miniatura;
- abrir imagem.

UC05 — Atualizar índice
  ↓
Funcionalidades:
- gerar índice JSON;
- ignorar arquivos indevidos;
- atualizar resultados publicados.

15. Síntese

Os casos de uso formalizam como os atores interagem com a Busca Geral do OLA. Eles servem como ponte entre os cenários narrativos e as funcionalidades que serão especificadas na próxima etapa da demanda.