1. Finalidade
Esta página apresenta o blueprint da demanda Busca Geral do OLA. O blueprint mostra como a experiência desejada do usuário depende de elementos visíveis, ações internas, arquivos, processos de suporte e evidências de funcionamento.
Este artefato pertence à demanda, pois descreve como a solução deve funcionar antes da implementação definitiva da entrega.
2. Posição no fluxo da demanda
Mapa da experiência
↓
Pontos de contato
↓
Blueprint
↓
Funcionalidades
↓
Casos de teste
↓
Planejamento
↓
Entrega implementada3. O que é blueprint nesta demanda?
O blueprint organiza a busca em camadas. Ele separa aquilo que o usuário vê daquilo que precisa acontecer nos bastidores para a experiência funcionar.
Experiência do usuário
↓
Pontos de contato visíveis
↓
Ações do usuário
↓
Resposta do sistema
↓
Processos internos
↓
Arquivos e dados de suporte
↓
Evidências e testes4. Blueprint operacional
| Etapa | Objetivo do usuário | Ponto de contato visível | Ação do usuário | Resposta visível do sistema | Processo interno | Arquivo / dado envolvido | Evidência / teste |
|---|---|---|---|---|---|---|---|
| 1. Acessar a busca | Entrar no ponto único de recuperação. | Link no portal, raiz ou página relacionada. | Clica no link para busca.html. |
A página de busca é aberta. | Carregamento da interface HTML, CSS e JavaScript. | busca.html |
CT12 — Funcionar sem back-end. |
| 2. Digitar termo | Procurar por tema, nome ou parte do caminho. | Campo de busca. | Digita organismo vivo, sistema cognitivo ou outro termo. |
O termo aparece no campo e aciona a busca. | Normalização do texto digitado e comparação com o índice. | busca_index.json |
CT01, CT02, CT05. |
| 3. Consultar índice | Receber resultados relevantes. | Lista de resultados. | Aguarda retorno da busca. | Cards de resultados aparecem. | JavaScript percorre o índice e filtra itens por termo, área e formato. | busca_index.json, função JS de filtro. |
CT01, CT02, CT07, CT08. |
| 4. Examinar resultados | Reconhecer o artefato correto. | Cards, caminho, tipo, contador e miniatura. | Lê títulos, caminhos e observa miniaturas. | Resultados ficam organizados em cards legíveis. | Renderização dos resultados na página. | Dados do índice: título, caminho, área, extensão e tipo. | CT04, CT11, CT13. |
| 5. Abrir artefato | Acessar o conteúdo encontrado. | Título, caminho ou miniatura clicável. | Clica no resultado desejado. | Arquivo abre no navegador. | Uso do caminho relativo para abrir página, imagem ou PDF. | Arquivo real publicado no OLA. | CT03. |
| 6. Refinar ou repetir busca | Ajustar a busca se o resultado não for suficiente. | Campo de busca, filtros, botão limpar. | Altera termo, aplica filtro ou limpa busca. | Resultados são recalculados. | Nova filtragem sobre o índice já carregado. | busca_index.json |
CT07, CT08, CT15. |
| 7. Atualizar índice | Fazer novos artefatos aparecerem na busca. | Terminal no Mac e rotina de publicação. | Executa python3 gerar_busca_index.py. |
Novo busca_index.json é gerado. |
Script varre pastas, ignora arquivos indevidos e grava JSON. | gerar_busca_index.py, busca_index.json |
CT09, CT10, CT14. |
| 8. Publicar atualização | Disponibilizar a busca atualizada no site. | Hostinger / gerenciador de arquivos / FTP. | Envia arquivos novos e índice atualizado. | Busca publicada passa a encontrar novos artefatos. | Substituição ou envio de arquivos no servidor. | busca.html, busca_index.json, artefatos novos. |
CT14. |
5. Camadas do blueprint
| Camada | Descrição | Exemplos no subsistema |
|---|---|---|
| Linha de interação | O que o usuário faz diretamente. | Acessar busca, digitar termo, clicar em resultado. |
| Linha de visibilidade | O que o usuário consegue ver. | Campo de busca, filtros, cards, miniaturas, contador. |
| Linha interna | O que acontece no sistema, mas não aparece como ação direta. | Carregar JSON, filtrar itens, montar cards, normalizar texto. |
| Linha de suporte | O que mantém o subsistema funcionando. | Script Python, rotina de publicação, estrutura de pastas. |
| Linha de evidência | Como verificar se funcionou. | Casos de teste, links abrindo, resultados aparecendo, miniaturas visíveis. |
6. Responsabilidades por papel
| Papel | Responsabilidades | Artefatos relacionados |
|---|---|---|
| Usuário / Visitante | Pesquisar, examinar resultados e abrir artefatos públicos. | busca.html, cards, links, miniaturas. |
| Walter — Autor do OLA | Usar a busca para recuperar conhecimento e verificar artefatos criados. | Busca publicada, páginas, imagens, demandas e entregas. |
| Administrador do OLA | Gerar índice, publicar arquivos, testar resultados e evitar exposição indevida. | gerar_busca_index.py, busca_index.json, Hostinger. |
| Subsistema de busca | Carregar índice, filtrar dados, exibir resultados e permitir abertura. | HTML, CSS, JavaScript e JSON. |
7. Pontos de falha e controle
| Ponto de falha | Efeito na experiência | Controle previsto |
|---|---|---|
| Índice JSON não publicado. | A busca pode não carregar ou retornar resultados antigos. | Incluir publicação do índice no fluxo operacional. |
| Caminho incorreto no JSON. | Resultado aparece, mas não abre. | Executar CT03 e CT14. |
| Arquivo privado indexado. | Exposição indevida de conteúdo. | Aplicar regras de exclusão e revisar índice antes de publicar. |
| Miniatura quebrada. | Usuário perde apoio visual. | Executar CT04. |
| Interface ruim no celular. | Busca difícil de usar em dispositivo móvel. | Executar CT13. |
8. Relação com artefatos da demanda
| Blueprint | Artefato relacionado | Relação |
|---|---|---|
| Etapas visíveis da experiência | mapa_experiencia.html | O blueprint detalha operacionalmente a experiência mapeada. |
| Pontos visíveis e invisíveis | pontos_contato.html | Os pontos de contato viram camadas operacionais no blueprint. |
| Ações do usuário | casos_uso.html | Os casos de uso formalizam as interações. |
| Capacidades necessárias | funcionalidades.html | As funcionalidades implementam a resposta esperada do sistema. |
| Evidências de funcionamento | casos_teste.html | Os testes verificam se o blueprint foi atendido na entrega. |
9. Ponte para a entrega
Na entrega futura, este blueprint deverá ser comparado com a solução implementada. A versão da entrega poderá registrar o que foi implementado, testado e ajustado.
Na demanda:
blueprint.html
→ descreve como deve funcionar.
Na entrega:
blueprint_implementado.html
→ mostra como foi implementado.
Na entrega:
casos_teste_executados.html
→ comprova o funcionamento.10. Síntese
O blueprint mostra que a Busca Geral do OLA depende de uma articulação entre interface, índice JSON, script gerador, estrutura física de pastas, publicação e testes. Ele transforma a experiência desejada em um modelo operacional que orienta a construção da entrega.