Converter Sugestão em Repertório

Gerado pelo Writer (Reversa) em 2026-05-11 doc_level: detalhado | Módulo pai: sugestao-repertorio

Visão Geral

Caso de uso que permite ao usuário selecionar itens de uma sugestão de repertório e convertê-los em um repertório editável.

Regras de Negócio

• Itens com metadata.ignorar = true já foram excluídos na query — não aparecem para seleção 🟢
• O usuário deve selecionar ao menos 1 item para criar o repertório 🟢
• Itens não selecionados são descartados antes da criação 🟢
• O repertório criado é navegado automaticamente após a criação 🟢
• Após criação por sugestão, a navegação pode resetar a stack para abrir o repertório dentro do fluxo padrão da aba de repertórios 🟢

Requisitos Funcionais

ID	Requisito	Prioridade	Critério de Aceite
RF-01	Entrar em modo seleção de itens	Must	Botão ativa modo seleção; checkboxes aparecem por item
RF-02	Selecionar/desmarcar itens individualmente	Must	Toggle por item persiste no estado local
RF-03	Criar repertório com itens selecionados	Must	criarPorSugestao cria repertório; toast de sucesso; navegação
RF-04	Validar mínimo 1 item selecionado	Must	Toast "Selecione ao menos um item" quando lista vazia

Critérios de Aceitação

Dado que o usuário está na tela de detalhes de uma sugestão
Quando entra em modo seleção e seleciona 2 de 5 itens
Então "Criar repertório" cria um repertório com os 2 itens selecionados

Dado que o usuário não seleciona nenhum item
Quando clica em "Criar repertório"
Então toast "Selecione ao menos um item" é exibido e nenhum repertório é criado

Rastreabilidade de Código

Arquivo	Função / Classe	Cobertura
src/view/screen/sugestaoRepertorio/SugestaoRepertorioDetalhesScreen.tsx	criarRepertorio, useModoSelecao	🟢
src/store/Repertorios/Repertorios.action.ts	criarPorSugestao	🟢
src/router/navigation/useAppNavigation.ts	navigateToRepertorioCriadoPorSugestao	🟢