Importar Repertório — Requisitos

Gerado pelo Writer (Reversa) em 2026-05-11 Caso de uso do módulo repertorios

Visão Geral

Permite ao usuário importar um repertório de outra conta Canta.app via link/slug, criando uma cópia local sem duplicar se o slug já foi importado.

Regras de Negócio

• Se o slug já existe localmente (slug_referencia ou slug_corrente), o fluxo redireciona para o repertório local sem criar duplicata 🟢
• O slug_referencia do repertório importado é preservado (rastreabilidade de origem) 🟢
• Importação não requer autenticação — a API de leitura de repertórios por slug é pública �

Requisitos Funcionais

ID	Requisito	Prioridade	Critério de Aceite
RF-01	Buscar repertório por slug na API Canta.app	Must	Dados do repertório retornados da API
RF-02	Criar cópia local com itens completos	Must	Repertório e todos os itens persistidos localmente; slug_referencia preservado
RF-03	Deduplicar: redirecionar se slug já existe localmente	Must	Nenhum duplicado criado; usuário é levado ao repertório já existente
RF-04	Navegar para o repertório importado após criação	Must	Tela de detalhe do repertório importado abre automaticamente

Critérios de Aceitação

Dado que o usuário abre o link canta.app/repertorios/?joao:missa-abc
Quando o slug não existe localmente
Então a API é consultada, os dados são importados e a tela de detalhe abre

Dado que o usuário abre o link para um slug já importado anteriormente
Quando findRepertorioSimilar encontra o slug local
Então a tela de detalhe do repertório existente abre sem criar duplicata