Planejamento — Busca Geral do OLA

Planejamento revisado para transformar a demanda completa em uma entrega funcional, validada e publicável.

Início › Demandas › Busca Geral do OLA › Planejamento
```

1. Finalidade

Esta página registra o planejamento revisado da demanda Busca Geral do OLA. Seu objetivo é organizar a passagem da demanda especificada para a construção da entrega correspondente.

Esta versão incorpora os artefatos de compreensão, contexto, experiência, arquitetura da informação, navegação, interface, validação, massa de teste, riscos e notas privadas.

2. Posição do planejamento no fluxo OLA

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
↓
Massa de Teste
↓
Rastreabilidade
↓
Planejamento
↓
Riscos e Mitigação
↓
Notas Privadas
↓
Index da Demanda
↓
Construção da Entrega
↓
Testes Executados
↓
Publicação
↓
Avaliação
↓
Evolução
```

3. Objetivo da entrega planejada

Construir uma busca geral estática para o OLA, capaz de recuperar páginas, imagens, PDFs e outros artefatos publicados, sem depender inicialmente de back-end. 

Resultado esperado da primeira versão:
```

busca.html
busca_index.json
gerar_busca_index.py
```

4. Escopo da primeira versão

Incluído na primeira versão Fora da primeira versão
Busca por nome de arquivo, caminho, área, tipo, extensão e metadados básicos. Busca semântica com IA.
Busca de páginas HTML e HTM. Banco de dados.
Busca de imagens PNG, JPG, JPEG, SVG e WEBP. Login e controle de permissões por usuário.
Busca de PDFs publicados. Busca em tempo real no servidor.
Miniatura para imagens. Indexação automática feita pela Hostinger.
Índice JSON gerado localmente no Mac. Busca dentro do conteúdo integral de PDFs.
Funcionamento estático com HTML, CSS, JavaScript e JSON. Processamento no servidor.
Filtros por área e tipo. Grafo semântico automático na primeira versão.
Mensagem de nenhum resultado. Recomendação automática de conteúdos relacionados.

5. Artefatos da demanda especificados

Grupo Artefato Arquivo Função no planejamento
Compreensão Situações reais situacoes_reais.html Mostra onde o problema ocorre na prática.
Compreensão Cenários cenarios.html Transforma situações reais em histórias de uso.
Contexto Stakeholders stakeholders.html Identifica participantes, papéis e interesses.
Contexto Ecossistema ecossistema.html Mostra atores, acervo, infraestrutura, dados e operação.
Experiência Modelo mental modelo_mental.html Compara expectativa do usuário e funcionamento real.
Experiência Jornada jornada.html Organiza a sequência da experiência de busca.
Experiência Mapa da experiência mapa_experiencia.html Descreve ações, dores, emoções, respostas esperadas e oportunidades.
Experiência Pontos de contato pontos_contato.html Identifica campos, links, cards, arquivos, filtros e interações.
Interface Wireframe wireframe.html Define a organização visual esperada da interface.
Arquitetura Arquitetura da Informação arquitetura_informacao.html Define rótulos, metadados, filtros, categorias e estrutura dos resultados.
Navegação Sistema de Navegação sistema_navegacao.html Define navegação global, local, contextual, estrutural e relacional.
Navegação Diagrama de Navegação diagrama_navegacao.html Mostra graficamente os caminhos de entrada, busca, abertura e retorno.
Operação Blueprint blueprint.html Conecta experiência visível, processos internos, arquivos e testes.
Especificação Casos de uso casos_uso.html Formaliza interações entre atores e subsistema.
Especificação Requisitos requisitos.html Define o que o subsistema deve atender.
Especificação Funcionalidades funcionalidades.html Define capacidades operacionais do subsistema.
Especificação Regras regras_busca.html Define regras de funcionamento, atualização, exclusão e segurança.
Validação Casos de teste casos_teste.html Define como verificar se a entrega atenderá à demanda.
Validação Massa de teste massa_teste.html Define arquivos, termos e resultados esperados para executar testes.
Validação Rastreabilidade rastreabilidade.html Integra situações, experiência, navegação, requisitos, regras e testes.
Planejamento Riscos e mitigação riscos_mitigacao.html Antecipa falhas e define ações preventivas e corretivas.
Interno Notas privadas notas_privadas.html Registra decisões, dúvidas, reflexões e pendências internas.
Consolidação Index da demanda index.html Consolida a demanda e dá acesso aos artefatos produzidos.

6. Artefatos a produzir na entrega

Artefato Local previsto Finalidade
busca.html raiz do OLA Página de busca usada pelo usuário no navegador.
busca_index.json raiz do OLA Índice estático com páginas, imagens e arquivos recuperáveis.
gerar_busca_index.py ambiente local / documentação da entrega Script que varre a estrutura física do OLA e gera o índice JSON.
manual_uso.html entregas/busca_geral_ola/ Explica como usar a busca.
manual_administracao_busca.html entregas/busca_geral_ola/ Explica como gerar, revisar, publicar e atualizar o índice.
casos_teste_executados.html entregas/busca_geral_ola/ Registra testes executados, resultados, falhas e correções.
avaliacao_resultados.html entregas/busca_geral_ola/ Avalia se a entrega atendeu à demanda.
avaliacao_ux_busca.html entregas/busca_geral_ola/ Avalia clareza, navegação, responsividade e esforço cognitivo.
licoes_aprendidas.html entregas/busca_geral_ola/ Registra aprendizados, limitações e evolução futura.

7. Etapa E00 — Validar a demanda antes da construção

Antes de iniciar a entrega, é necessário verificar a coerência entre os artefatos da demanda. 

Verificar:
```

* 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;
* massa de teste;
* rastreabilidade;
* planejamento;
* riscos e mitigação;
* notas privadas;
* index da demanda.

8. Etapas de construção da entrega

```
Etapa Descrição Artefatos envolvidos Resultado esperado
E00 — Validar demanda Revisar coerência dos artefatos antes de construir. Index, rastreabilidade, casos de teste, massa de teste e planejamento. Demanda pronta para entrega.
E01 — Preparar estrutura Definir onde ficarão a página de busca, o índice JSON e o script gerador. raiz do OLA e pasta de entrega. Estrutura definida e documentada.
E02 — Criar gerador do índice Implementar script que percorre pastas e identifica arquivos permitidos. gerar_busca_index.py, regras, massa de teste. Script gera JSON inicial.
E03 — Gerar índice inicial Executar o script no Mac para gerar o primeiro busca_index.json. busca_index.json, massa de teste. Índice criado com páginas, imagens e PDFs.
E04 — Criar página de busca Desenvolver busca.html para ler o JSON, pesquisar e exibir resultados. busca.html, wireframe, arquitetura da informação, sistema de navegação. Busca funcional no navegador.
E05 — Implementar miniaturas Exibir miniatura clicável quando o resultado for imagem. Wireframe, arquitetura da informação, casos de teste. Imagens aparecem visualmente nos resultados.
E06 — Implementar filtros, contador e mensagens Adicionar filtros por área e tipo, contador de resultados e mensagem de nenhum resultado. Arquitetura da informação, sistema de navegação, casos de teste. Resultados podem ser refinados, quantificados e interpretados.
E07 — Implementar navegação e contexto Exibir caminho físico, link de abertura, retorno ao topo e elementos de orientação. Sistema de navegação, diagrama de navegação, casos de teste. Usuário consegue abrir artefatos e entender onde estão.
E08 — Testar localmente Executar os casos de teste prioritários no ambiente local. casos_teste.html, massa_teste.html. Falhas identificadas antes da publicação.
E09 — Publicar na Hostinger Enviar arquivos necessários para o servidor. busca.html, busca_index.json, páginas e imagens. Busca disponível no site publicado.
E10 — Testar publicado Executar testes no endereço publicado. casos_teste_executados.html. Resultados registrados.
E11 — Avaliar e ajustar Corrigir problemas e registrar melhorias futuras. avaliacao_resultados.html, avaliacao_ux_busca.html. Entrega estabilizada para primeira versão.
```

9. Prioridades da primeira versão

``` 
Prioridade 1:
  ```
* validar a demanda;
* gerar busca_index.json;
* buscar páginas HTML;
* buscar imagens;
* abrir resultados;
* exibir miniaturas;
* funcionar sem back-end;
* exibir caminho físico;
* exibir mensagem de nenhum resultado.

Prioridade 2:

* filtros por área;
* filtros por tipo;
* contador de resultados;
* responsividade refinada;
* navegação mobile preservada;
* retorno ao topo.

Prioridade 3:

* manual de uso;
* manual de administração;
* avaliação da entrega;
* avaliação de UX;
* melhoria futura da indexação;
* documentação da experiência implementada.

10. Dependências

```
Dependência Tipo Uso no subsistema Observação
Estrutura física do OLA Técnica / informacional Fonte real para geração do índice. Pastas e arquivos precisam estar organizados.
Arquitetura da Informação UX / informação Define rótulos, categorias, filtros, metadados e cards. Base para o JSON e para a interface.
Sistema de Navegação UX / navegação Define entrada, busca, abertura, caminho físico e retorno ao contexto. Base para links e orientação do usuário.
Wireframe Interface Define organização visual da busca. Base para busca.html.
Massa de teste Validação Fornece arquivos, termos e resultados esperados para testar. Base para testes locais e publicados.
Python 3 Técnica Execução do script gerar_busca_index.py. Usado localmente no Mac.
Navegador moderno Técnica Execução de busca.html. Necessário para JavaScript e leitura do JSON.
Hostinger Infraestrutura Publicação dos arquivos. Ambiente de hospedagem do OLA.
Arquivo JSON Dado estruturado Base estática da busca. Gerado localmente e publicado na raiz.
```

11. Testes previstos

Os testes prioritários vêm das páginas casos_teste.html e massa_teste.html.

``` 
CT01 — Buscar imagem por tema
  ```

CT02 — Buscar página HTML por assunto
CT03 — Abrir resultado encontrado
CT04 — Exibir miniatura de imagem
CT09 — Gerar índice automaticamente
CT10 — Ignorar arquivos indevidos
CT12 — Funcionar sem back-end
CT13 — Funcionar em dispositivo móvel
CT14 — Atualizar resultados após novo índice
CT17 — Caminho físico exibido
CT18 — Filtro por área funciona
CT19 — Filtro por tipo funciona
CT20 — Navegação mobile preservada
CT22 — Mensagem de nenhum resultado
```

12. Riscos principais a considerar

Risco Impacto Mitigação prevista
Índice desatualizado. Usuário não encontra artefatos novos. Rodar o gerador antes de publicar.
Links quebrados. Resultado aparece, mas não abre. Executar testes de abertura.
Arquivos privados indexados. Exposição indevida. Aplicar regras de exclusão e revisar índice.
Muitos resultados pouco claros. Aumento de esforço cognitivo. Usar filtros, títulos claros e caminhos visíveis.
Interface ruim em celular. Dificuldade de uso móvel. Executar teste responsivo.
Navegação confusa. Usuário encontra o item, mas se perde no contexto. Exibir caminho físico, breadcrumb e retorno ao topo.
Modelo mental desalinhado. Usuário espera uma busca tipo Google e se frustra. Explicar escopo da primeira versão e melhorar rótulos.
Massa de teste incompleta. Testes não cobrem situações reais importantes. Atualizar massa_teste.html antes da execução dos testes.

A análise detalhada está em riscos_mitigacao.html.

13. Fluxo de publicação

1. Criar ou alterar páginas, imagens e PDFs no OLA local.
```

2. Rodar gerar_busca_index.py no Mac.
3. Conferir busca_index.json.
4. Testar busca.html localmente usando a massa de teste.
5. Verificar links, miniaturas, filtros, caminho físico e mensagens.
6. Publicar arquivos novos na Hostinger.
7. Publicar busca_index.json atualizado.
8. Abrir busca.html no site publicado.
9. Executar testes principais.
10. Registrar testes executados na entrega.
```

14. Critérios para considerar a entrega pronta

  • A demanda foi validada antes da construção.
  • A busca encontra páginas HTML existentes.
  • A busca encontra imagens existentes.
  • A busca encontra PDFs publicados.
  • Imagens aparecem com miniatura clicável.
  • Resultados possuem links para abertura.
  • O caminho físico aparece nos resultados.
  • Filtros por área e tipo funcionam.
  • Mensagem de nenhum resultado aparece quando necessário.
  • O índice é gerado automaticamente pelo script.
  • Arquivos indevidos não aparecem no índice.
  • A página funciona sem back-end.
  • A busca é utilizável em celular, tablet e desktop.
  • Os testes principais foram executados e registrados.

15. Infogramas relacionados

A demanda possui ou prevê infogramas que apoiam a compreensão visual do planejamento:

  • Infograma dos Stakeholders.
  • Infograma do Ecossistema.
  • Infograma do Modelo Mental.
  • Infograma da Jornada.
  • Infograma do Mapa da Experiência.
  • Infograma dos Pontos de Contato.
  • Infograma do Wireframe.
  • Infograma do Sistema de Navegação.
  • Infograma do Diagrama de Navegação.
  • Infograma do Blueprint.

16. Relação com a rastreabilidade

O planejamento deve respeitar a matriz registrada em rastreabilidade.html. 

Experiência
```

↓
Arquitetura da Informação
↓
Navegação
↓
Funcionalidades prioritárias
↓
Casos de teste prioritários
↓
Massa de teste
↓
Construção da entrega
↓
Testes executados
↓
Avaliação da entrega
```

17. Estado atual da demanda

Item Situação Observação
Compreensão do problema Concluída Situações reais e cenários definidos.
Contexto Concluído Stakeholders e ecossistema 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 Revisada Casos de teste, massa de teste e rastreabilidade definidos.
Riscos Concluídos Riscos e mitigação registrados.
Index da demanda Concluído Portal da demanda criado.
Entrega Pendente Próxima fase: construir busca.html, busca_index.json e gerar_busca_index.py.

18. Próxima etapa após este planejamento

Como a demanda já possui index, rastreabilidade, casos de teste, massa de teste, planejamento, riscos e notas privadas, a próxima etapa é iniciar a construção da entrega. 

Próxima fase:
```

entregas/busca_geral_ola/

Artefatos iniciais:

* busca.html
* busca_index.json
* gerar_busca_index.py
* manual_uso.html
* manual_administracao_busca.html
* casos_teste_executados.html

19. Síntese

O planejamento revisado organiza a transição entre a demanda especificada e a entrega funcional. Ele considera compreensão do problema, experiência do usuário, arquitetura da informação, navegação, interface, operação, requisitos, regras, testes, massa de teste, riscos e critérios de prontidão.

A demanda Busca Geral do OLA está pronta para iniciar a construção da entrega funcional.