Documentação
Esta documentação detalha a metodologia, fontes, limitações e o propósito do Blank Charts, reforçando nosso compromisso com a transparência.
1. Metodologia
O processo de análise segue três etapas fundamentais:
- Coleta de dados: os dados brutos dos charts (em formato CSV) são extraídos de fontes públicas. Este processo é executado offline, onde os dados são enriquecidos com informações da API do Spotify (como imagens de artistas e capas de singles) e armazenados em um banco de dados local (SQLite) para análise histórica.
-
Categorização de gênero: o artista principal de cada faixa é categorizado seguindo um processo rigoroso para garantir respeito e precisão.
- Critério principal: a identidade de gênero é baseada na autodeclaração da artista ou nos pronomes utilizados em sua comunicação pública.
- Validação: as informações são verificadas em fontes confiáveis, como entrevistas, artigos e perfis oficiais em redes sociais.
- Princípio de não suposição: nenhum gênero é presumido. Um esforço considerável é dedicado a não supor identidades, respeitando a individualidade de cada artista.
- Casos complexos: para artistas com múltiplos pronomes ou informações não conclusivas, uma pesquisa aprofundada é realizada para assegurar a máxima precisão.
-
Visualização: a apresentação dos dados no Blank Charts é projetada para oferecer uma análise comparativa e clara da representatividade feminina.
- Estrutura dos rankings: a lista final exibe apenas as artistas que atendem aos nossos critérios, com sua posição apresentada em duas colunas: posição original e posição no Blank Charts. A comparação entre as duas quantifica visualmente o impacto da disparidade.
- Conteúdo por tipo de chart: o detalhe exibido se adapta à natureza do ranking (capa do single, nome da música e artista para charts de canções; foto, nome da artista e ouvintes mensais para charts de artistas).
- Performance: para garantir a máxima velocidade, os dados filtrados são pré-gerados em arquivos estáticos (JSON), que são lidos pelo site, resultando em um carregamento quase instantâneo para o usuário final.
2. Fontes de Dados
- Charts de Músicas e Artistas: dados brutos em formato CSV do Spotify (Weekly Top 200 Songs) e Kworb.net (Monthly Top Artists).
- API do Spotify: utilizada para enriquecer os dados dos charts, obtendo as imagens oficiais de artistas e as capas dos singles.
- Dados estatísticos de referência: as estatísticas de apoio vêm do projeto Every Noise at Once de Glenn McDonald, com dados coletados até dezembro de 2024. O Blank Charts não atualiza estes números de referência continuamente.
3. Limitações
Complexidade de gênero: a metodologia do Blank Charts lida com a complexidade de gênero da seguinte forma:
- Modelo de visualização: o projeto opera com uma classificação binária (mulheres/homens) por uma necessidade de simplificação para a visualização de dados.
- Inclusão de pessoas trans: nossa política é explícita: mulheres trans são mulheres e homens trans são homens, e são categorizados de acordo com sua autodeclaração.
- Artistas não-binários: para não simplificar indevidamente suas identidades, optamos, no momento, por não incluí-los na visualização final.
- Compromisso futuro: esta abordagem está em constante revisão e estamos pesquisando metodologias mais inclusivas.
Colaborações (featurings): a análise foca no artista principal (o primeiro nome listado na faixa), o que pode invisibilizar o trabalho de mulheres em faixas lideradas por homens.
Precisão das fontes: o projeto depende da acurácia de dados fornecidos por terceiros (Spotify, Kworb.net).
4. Perguntas frequentes (FAQ)
5. Changelog
-
v1.3 (28 de Julho, 2025): Refinamento da interface e apresentação de dados
- Reformulação da homepage com um design mais informativo e visualmente atraente.
- Adição da análise de playlists de curadoria editorial do Spotify (Rap Caviar e Esquenta Sertanejo).
- Melhoria no design dos cards, otimizando a hierarquia visual e a apresentação dos dados.
- Correções no script de exportação para garantir a consistência e performance dos dados no frontend.
-
v1.2 (23 de Julho, 2025): Expansão da análise de dados
- Adição da análise de playlists de curadoria editorial do Spotify (Novidades da Semana e New Music Friday).
- Implementação de nova lógica no backend para extrair dados diretamente da API de playlists do Spotify.
- Atualização da homepage para incluir os novos charts de curadoria nos destaques.
-
v1.1 (22 de Julho, 2025): Refatoração da arquitetura de dados
- Migração do sistema para uma arquitetura baseada em backend (Node.js) com banco de dados (SQLite).
- Implementação de armazenamento histórico e cache de imagens para otimizar a performance.
- Aumento da robustez do sistema para lidar com colaborações, acentos e diferentes formatos de dados.
- v1.0 (21 de Julho, 2025): Lançamento do projeto.
6. Tecnologia
Processamento
- Node.js
- SQLite 3
Bibliotecas
- axios
- csv-parser
- sqlite3
Frontend
- HTML5 / CSS3
- Tailwind CSS
- JavaScript (Vanilla)
Plataforma
- Netlify
- Spotify API
7. Como Contribuir
Encontrou um erro ou tem sugestões? Entre em contato pelo e-mail: blankcharts@proton.me
8. Licença
- Conteúdo e dados: CC BY-NC-SA 4.0
- Código-fonte: Licença MIT
9. Concepção e créditos
Idealização, pesquisa e design de Thabata Lima Arruda. Desenvolvimento da arquitetura de dados (Node.js/SQLite) e frontend com auxílio de IA.