1. Visão geral

Desenvolver um sistema para cadastro em lote de registros musicais, destinado a associações e instituições de música, com foco em automatização de processos, conformidade com regras institucionais e redução de erros operacionais.

O sistema deverá importar planilhas Excel com grande volume de dados (ex.: milhares de registros), aplicar regras de negócio específicas do setor musical, validar relacionamentos com cadastros existentes e gerar arquivos institucionais no formato exigido.

A solução deve ser simples de operar, confiável e pronta para evoluir, atendendo tanto à demanda atual quanto a futuras expansões.

2. Objetivos do sistema

• Importar registros musicais em lote via planilhas Excel
• Validar dados conforme regras de negócio do setor musical
• Relacionar registros com:
• Obras musicais
• Titulares (autores, intérpretes, produtores, gravadoras, etc.)
• Identificar e reportar erros por registro
• Gerar arquivos .txt conforme layout exigido por instituições de música
• Aplicar regras distintas para:
• Repertório nacional
• Repertório internacional
• Integrar com sistemas corporativos existentes (ex.: Protheus / TOTVS)

3. Escopo funcional

3.1 Importação de planilhas
• Upload de arquivos:
• .xlsx
• .xls
• Mapeamento automático de colunas:
• Baseado no título do cabeçalho
• Correspondência direta com campos do sistema
• Validação estrutural da planilha
• Pré-visualização dos dados antes da importação definitiva

4. Telas e fluxos do sistema

4.1 Registros internacionais
• Fluxo específico para repertório internacional
• Campos obrigatórios diferenciados
• Validações conforme regras institucionais
• Regras próprias de vínculo com obras e titulares

4.2 Registros nacionais
• Fluxo específico para repertório nacional
• Integração com obras e titulares previamente cadastrados
• Validações conforme regras institucionais
• Regras específicas de distribuição e participação

5. Relacionamento de dados

5.1 Obras musicais

O sistema deverá:
• Consultar obras existentes
• Validar:
• Código
• Título
• Consistência cadastral
• Retornar erro quando:
• A obra não existir
• O vínculo estiver inconsistente

5.2 Titulares
• Validação automática de:
• Existência do titular
• Tipo de titular
• Percentuais de participação
• Regras de negócio para:
• Limites de percentual
• Combinações válidas por tipo
• Indicação de erro quando:
• Titular não encontrado
• Percentual inválido
• Regra institucional violada

6. Regras de negócio e validações

O sistema deverá validar, no mínimo:
• Campos obrigatórios não preenchidos
• Formatos inválidos (datas, códigos, textos)
• Inconsistências entre:
• Registro × Obra
• Registro × Titular
• Aplicação automática de regras distintas para:
• Nacional
• Internacional

As regras devem ser parametrizáveis, permitindo ajustes sem impacto estrutural no sistema.

7. Tratamento de erros
• Validação individual por registro
• Relatório detalhado contendo:
• Linha da planilha
• Identificador do registro
• Campo com erro
• Descrição objetiva
• Registros válidos não devem ser bloqueados por registros inválidos
• Possibilidade de reprocessamento parcial de lotes

8. Geração de arquivos institucionais
• Geração de arquivo .txt
• Layout compatível com padrões exigidos por instituições de música
• Exportação apenas de registros:
• Validados
• Sem pendências
• Opções de exportação:
• Por lote
• Por tipo (nacional / internacional)

9. Integração com Protheus (TOTVS)
• Integração via:
• Consulta direta a tabelas (somente leitura)
• APIs ou serviços intermediários
• Consumo de dados como:
• Obras musicais
• Titulares
• Identificadores internos
• Prevenção de duplicidades e inconsistências
• Estrutura preparada para ampliação da integração

10. Relatórios e visões gerenciais

O sistema poderá disponibilizar relatórios como:
• Volume de registros importados por período
• Registros válidos x inválidos
• Erros mais recorrentes por tipo
• Processamento por lote
• Distribuição entre repertório nacional e internacional

Os relatórios poderão ser:
• Visualizados em tela
• Exportados (Excel / CSV)
• Utilizados para controle, auditoria e tomada de decisão

11. Requisitos não funcionais
• Suporte a grandes volumes de dados
• Logs de processamento e erros
• Controle de acesso por perfil
• Interface simples e orientada a fluxo operacional
• Possibilidade de reprocessamento de lotes

12. Escalabilidade e evolução

O sistema deverá possuir arquitetura modular, permitindo:
• Inclusão de novos tipos de registros
• Novos layouts institucionais
• Novas regras de negócio
• Dashboards e indicadores
• Integração com outros sistemas e APIs