1. Finalidade
Esta página registra as funcionalidades previstas para o subsistema Busca Geral do OLA. As funcionalidades representam as capacidades que o subsistema deverá oferecer para atender aos casos de uso, requisitos e regras já definidos.
2. Posição das funcionalidades no processo
Situações reais
↓
Cenários
↓
Casos de uso
↓
Requisitos
↓
Funcionalidades
↓
Regras
↓
Casos de teste
↓
Implementação
↓
Entrega
3. O que é uma funcionalidade nesta demanda?
Uma funcionalidade é uma capacidade concreta que o subsistema precisa oferecer. Ela é mais operacional do que um requisito e mais próxima da implementação.
Requisito:
A busca deve localizar imagens.
Funcionalidade:
Pesquisar imagens por nome, caminho, área ou extensão.
4. Lista de funcionalidades
| Código | Funcionalidade | Descrição | Casos de uso relacionados | Requisitos relacionados | Prioridade |
|---|---|---|---|---|---|
| F01 | Pesquisar páginas HTML | Permitir localizar arquivos .html e .htm por nome, caminho, área ou palavra relacionada. |
UC02, UC07 | RF01, RF03, RF07 | Alta |
| F02 | Pesquisar imagens | Permitir localizar imagens .png, .jpg, .jpeg, .svg e .webp. |
UC01, UC07 | RF02, RF03, RF04, RF07 | Alta |
| F03 | Abrir resultado encontrado | Permitir abrir páginas, imagens e PDFs diretamente a partir da lista de resultados. | UC01, UC02, UC03, UC04, UC07, UC08 | RF03 | Alta |
| F04 | Exibir miniatura de imagens | Mostrar miniatura clicável quando o resultado encontrado for uma imagem. | UC01, UC06, UC07 | RF04 | Alta |
| F05 | Filtrar por área | Permitir filtrar resultados por áreas como fundamentos, domínios, demandas, entregas, metodologia e governança. | UC03, UC04, UC07 | RF05 | Média |
| F06 | Filtrar por formato | Permitir filtrar resultados por página HTML, imagem, PDF ou outro formato previsto. | UC01, UC02, UC07 | RF06 | Média |
| F07 | Gerar índice automaticamente | Gerar o arquivo busca_index.json a partir da estrutura física real do OLA. |
UC05, UC08 | RF08, RNF05, RNF06 | Alta |
| F08 | Ignorar arquivos indevidos | Excluir da indexação arquivos temporários, backups, arquivos ocultos, pastas técnicas e itens fora do escopo público. | UC05 | RF09, RNF07 | Alta |
| F09 | Exibir quantidade de resultados | Informar ao usuário quantos itens foram encontrados para a busca realizada. | UC03, UC04, UC07, UC08 | RF10 | Média |
| F10 | Buscar por nome e caminho | Permitir que termos digitados sejam comparados com nome do arquivo, caminho, área, extensão e tipo. | UC01, UC02, UC03, UC04, UC07 | RF07 | Alta |
| F11 | Funcionar sem back-end | Permitir que a busca funcione apenas com busca.html, JavaScript e busca_index.json. |
UC01, UC02, UC07 | RNF01, RNF02 | Alta |
| F12 | Funcionar em dispositivos móveis | Apresentar busca, filtros e resultados de forma legível em celular, tablet, desktop e TV. | UC06 | RNF03, RNF04 | Alta |
| F13 | Atualizar resultados após novo índice | Após regeneração e publicação do busca_index.json, a busca deve refletir os novos arquivos. |
UC05, UC08 | RF08, RNF06 | Alta |
5. Agrupamento das funcionalidades
| Grupo funcional | Funcionalidades | Finalidade |
|---|---|---|
| Busca e recuperação | F01, F02, F03, F10 | Localizar e abrir páginas, imagens e arquivos. |
| Visualização dos resultados | F04, F09, F12 | Exibir resultados de forma clara, responsiva e compreensível. |
| Filtros e organização | F05, F06 | Permitir refinamento da busca por área e formato. |
| Geração e atualização do índice | F07, F08, F13 | Manter a busca sincronizada com a estrutura física do OLA. |
| Arquitetura sem back-end | F11 | Garantir funcionamento estático com HTML, JavaScript e JSON. |
6. Priorização para a primeira versão
Para a primeira versão da entrega, as funcionalidades mínimas recomendadas são:
F01 — Pesquisar páginas HTML
F02 — Pesquisar imagens
F03 — Abrir resultado encontrado
F04 — Exibir miniatura de imagens
F07 — Gerar índice automaticamente
F08 — Ignorar arquivos indevidos
F10 — Buscar por nome e caminho
F11 — Funcionar sem back-end
F12 — Funcionar em dispositivos móveis
7. Rastreabilidade funcional
| Funcionalidade | Origem em caso de uso | Origem em requisito | Regra relacionada | Teste futuro |
|---|---|---|---|---|
| F01 — Pesquisar páginas HTML | UC02, UC07 | RF01 | Regra de escopo; Regra de recuperação | Buscar por sistema cognitivo. |
| F02 — Pesquisar imagens | UC01 | RF02 | Regra de escopo; Regra de recuperação | Buscar por organismo vivo. |
| F03 — Abrir resultado | UC01, UC02 | RF03 | Regra de abertura | Clicar no resultado e verificar abertura. |
| F04 — Exibir miniatura | UC01 | RF04 | Regra de miniaturas | Resultado de imagem deve mostrar miniatura. |
| F07 — Gerar índice | UC05 | RF08 | Regra da fonte da verdade; Regra de geração | Rodar script e verificar criação do JSON. |
| F08 — Ignorar arquivos indevidos | UC05 | RF09, RNF07 | Regra de exclusão; Regra de segurança | Verificar se .DS_Store não aparece. |
| F12 — Funcionar em dispositivos móveis | UC06 | RNF03, RNF04 | Regra de responsividade | Abrir busca no celular e verificar layout. |
8. Ponte para casos de teste
A próxima etapa da demanda é transformar as funcionalidades em casos de teste.
Funcionalidade:
F02 — Pesquisar imagens
Caso de teste:
Buscar por "organismo vivo"
Resultado esperado:
A imagem correspondente aparece com miniatura e link clicável.
9. Síntese
As funcionalidades definem as capacidades que o subsistema Busca Geral do OLA deve oferecer. Elas foram derivadas dos casos de uso e rastreadas aos requisitos, regras e futuros testes.