Riscos e Mitigação — Busca Geral do OLA

1. Finalidade

Esta página registra os riscos e as ações de mitigação da demanda Busca Geral do OLA. O objetivo é antecipar problemas que podem afetar a construção, publicação, uso, manutenção e evolução do subsistema.

2. Posição no fluxo da demanda

Problema
  ↓
Experiência
  ↓
Pontos de Contato
  ↓
Blueprint
  ↓
Requisitos
  ↓
Funcionalidades
  ↓
Casos de Teste
  ↓
Planejamento
  ↓
Riscos e Mitigação
  ↓
Construção da Entrega
  ↓
Testes Executados
  ↓
Avaliação
  ↓
Evolução

3. Critérios usados para analisar riscos

Critério	Descrição	Escala simples
Probabilidade	Chance de o risco ocorrer durante construção, publicação ou uso.	Baixa, média, alta.
Impacto	Gravidade do efeito caso o risco ocorra.	Baixo, médio, alto.
Prioridade	Importância de tratar o risco antes da entrega.	Baixa, média, alta.
Tipo de controle	Forma de reduzir, detectar ou corrigir o risco.	Preventivo, detectivo, corretivo.

4. Matriz de riscos e mitigação

Código	Risco	Origem provável	Impacto na experiência	Probabilidade	Impacto	Prioridade	Mitigação	Teste / evidência
R01	Índice desatualizado.	Novos arquivos criados sem rodar `gerar_busca_index.py`.	Usuário não encontra artefatos novos.	Alta	Alto	Alta	Criar rotina obrigatória de geração do índice antes da publicação.	CT09, CT14.
R02	Links quebrados.	Caminhos errados no JSON ou arquivos não publicados.	Resultado aparece, mas não abre.	Média	Alto	Alta	Testar abertura dos resultados principais após publicação.	CT03.
R03	Arquivos privados ou indevidos indexados.	Script incluir pastas ou extensões fora do escopo público.	Exposição indevida de conteúdo.	Média	Alto	Alta	Definir lista de exclusão e revisar JSON antes de publicar.	CT10.
R04	Resultados demais e pouco claros.	Busca por termo genérico sem filtro.	Aumento do esforço cognitivo.	Alta	Médio	Alta	Adicionar filtros, contador, caminho, tipo e cards legíveis.	CT07, CT08, CT11.
R05	Usuário espera busca tipo Google.	Modelo mental diferente do funcionamento real inicial.	Frustração ao não encontrar por conteúdo semântico.	Média	Médio	Média	Explicar que a primeira versão busca por nome, caminho, área, tipo e extensão.	Validação do modelo mental.
R06	Miniaturas não carregam.	Caminho errado, imagem ausente ou formato não tratado.	Perda do reconhecimento visual.	Média	Médio	Média	Validar extensões de imagem e caminhos relativos.	CT04.
R07	Busca não funciona em celular.	Layout não responsivo ou elementos pequenos para toque.	Dificuldade de uso móvel.	Média	Alto	Alta	Aplicar modelo responsivo OLA e testar no celular/tablet.	CT13.
R08	Script gerador falha.	Erro de caminho, permissão, codificação ou extensão inesperada.	Índice não é gerado ou fica incompleto.	Média	Alto	Alta	Registrar mensagens de erro e testar geração com conjunto pequeno.	CT09, CT10.
R09	Nomes de arquivos pouco descritivos.	Arquivos como `imagem1.png` ou `pagina_final.html`.	Usuário não reconhece o resultado.	Alta	Médio	Alta	Adotar regra de nomenclatura descritiva.	Revisão manual dos resultados.
R10	Publicar arquivos sem publicar o índice atualizado.	Falha no fluxo operacional de publicação.	Artefatos novos não aparecem na busca.	Alta	Alto	Alta	Checklist de publicação incluindo `busca_index.json`.	CT14.
R11	JSON inválido.	Erro na geração, edição manual ou codificação.	Busca pode não carregar resultados.	Baixa	Alto	Média	Evitar edição manual do JSON e validar antes da publicação.	Teste de carregamento da página.
R12	Busca lenta com índice muito grande.	Crescimento do acervo do OLA.	Demora na resposta e perda de fluidez.	Média futura	Médio	Média	Otimizar índice, limitar campos e considerar busca por categorias futuras.	Teste de desempenho simples.

5. Riscos críticos da primeira versão

Para a primeira entrega, os riscos mais importantes são:

R01 — Índice desatualizado
R02 — Links quebrados
R03 — Arquivos privados ou indevidos indexados
R07 — Busca não funciona em celular
R08 — Script gerador falha
R10 — Publicar arquivos sem publicar o índice atualizado

6. Checklist preventivo antes da publicação

Rodar gerar_busca_index.py.
Confirmar que busca_index.json foi atualizado.
Verificar se não há arquivos indevidos no JSON.
Testar busca por organismo vivo.
Testar busca por sistema cognitivo.
Testar abertura de página HTML.
Testar abertura de imagem.
Testar no celular ou tablet.
Publicar busca.html e busca_index.json.
Executar teste publicado após upload.

7. Relação com artefatos da demanda

Risco	Artefato relacionado	Relação
Modelo mental desalinhado.	modelo_mental.html	Mostra diferença entre expectativa do usuário e funcionamento real.
Problemas nos pontos de contato.	pontos_contato.html	Identifica interfaces, arquivos e ações críticas.
Falhas operacionais.	blueprint.html	Mostra camadas internas e suporte necessário.
Ausência de verificação.	casos_teste.html	Define testes para detectar falhas.
Incoerência entre demanda e entrega.	rastreabilidade.html	Relaciona situação, requisito, funcionalidade, regra e teste.
Riscos na construção.	planejamento.html	Organiza ordem de construção e critérios de prontidão.

8. Monitoramento durante a entrega

Na entrega futura, estes riscos devem ser acompanhados em:

entregas/busca_geral_ola/casos_teste_executados.html
entregas/busca_geral_ola/avaliacao_resultados.html
entregas/busca_geral_ola/licoes_aprendidas.html

9. Síntese

A análise de riscos mostra que a Busca Geral do OLA precisa de atenção especial à atualização do índice, à abertura correta dos links, à exclusão de arquivos indevidos, à responsividade e à clareza dos resultados.

Risco principal:
a busca existir, mas não refletir corretamente o acervo real do OLA.

Mitigação central:
gerar, revisar, publicar e testar o índice sempre que o acervo for alterado.