📊 EBBC OpenData — Portal & API Pública de Anais

🇧🇷 Português | 🇺🇸 English

O EBBC OpenData é uma plataforma e API científica pública projetada para consolidar, analisar e exportar os metadados bibliométricos e classificações metodológicas de todas as edições históricas viáveis do Encontro Brasileiro de Bibliometria e Cientometria (EBBC), cobrindo o período de 2012 a 2024.

O projeto visa fomentar a Ciência Aberta e auxiliar pesquisadores e cientistas da informação na realização de revisões sistemáticas, análises cientométricas e estudos metodológicos sobre a produção científica brasileira em estudos métricos.

🏗️ Arquitetura do Sistema e Fluxo de Dados

A plataforma funciona em três camadas: a extração inicial de dados (Pipelines), o serviço web de dados (REST API) e a interface visual de exploração (Single Page Application).

flowchart TD
    subgraph Scraping_Pipeline [1. Pipeline de Dados]
        OJS[Portais OJS Históricos: 2012-2018] -->|Python Scraping & RegEx| ScraperOlder[data/scrape_ebbc_older.py]
        OpenAlex[API OpenAlex: 2020-2024] -->|Python Extraction| ScraperModern[extract_ebbc.py]
        ScraperOlder -->|Salva datasets| LocalJSON[data/ebbc_YEAR_data.json]
        ScraperModern -->|Salva datasets| LocalJSON
    end

    subgraph Backend_Server [2. Servidor API Node.js / Express]
        LocalJSON -->|Leitura na inicialização| Express[server.js: Porta 3000]
        Express -->|Filtra / Ordena / Pagina| RouteArticles["GET /api/articles"]
        Express -->|Agrega Estatísticas Dinâmicas| RouteStats["GET /api/articles/stats"]
        Express -->|Busca por DOI/Sufixo| RouteDoi["GET /api/articles/:doi"]
        Express -->|Gera Downloads JSON/CSV| RouteExport["GET /api/articles/export"]
    end

    subgraph Frontend_Client [3. Dashboard UI & Sandbox]
        Browser[Painel do Usuário: index.html]
        Browser -->|Consome metadados| AppJS[public/app.js]
        AppJS -->|Visualização de Métricas| StatsPanel[Painel de Estatísticas]
        AppJS -->|Tabelas com Filtros Ativos| ExplorerPanel[Explorador de Dados]
        AppJS -->|Simula Requisições & Snippets| SandboxPanel[Simulador Sandbox]
        
        %% Customizações do Usuário
        UserTheme[Paleta Neon/Apple/Pastel/Mono] -->|Modifica Estilos| StatsPanel
        UserChart[Tipo de Gráfico: Barras/Linhas/Radar] -->|Modifica Formatos| StatsPanel
    end

    RouteArticles -->|AJAX Fetch| AppJS
    RouteStats -->|AJAX Fetch| AppJS
    RouteDoi -->|AJAX Fetch| AppJS
    RouteExport -->|Download direto| Browser

⚡ Principais Recursos do Projeto

Dataset Unificado (2012–2024): 643 artigos catalogados de forma idêntica e padronizada.
Curadoria de Metodologia: Classificação automatizada dos softwares e ferramentas utilizados (VOSviewer, R, Python, Gephi, Excel, etc.), fontes de dados coletadas (Web of Science, Scopus, OpenAlex, etc.) e etapas metodológicas de aplicação.
Painel Customizável de Estatísticas:
- Tipo de Gráfico: Alternância dinâmica de formato entre Barras/Colunas, Linhas/Conexões e Radar (Teia).
- Paletas de Cores: Estilos visuais personalizados, incluindo Apple Minimalist, Neon Cyberpunk, Pastel Suave e Monocromático Sleek.
Explorador Avançado de Dados: Filtros combinados de pesquisa, paginação e exportação instantânea em formatos abertos (JSON e CSV).
Documentação Interativa com Sandbox: Testador de chamadas de API com gerador de código em tempo real nas linguagens JavaScript, Python e comandos cURL.

🚀 Como Executar o Projeto Localmente

Pré-requisitos

Node.js (v16 ou superior)
Python 3 (caso precise rodar os scripts de extração e raspagem de dados)

Passos para Inicialização

Instale as dependências de backend:
```
npm install
```
Inicialize o servidor web da API:
```
npm start
```
Acesse a plataforma no navegador em:
```
https://ebbcopendata.vercel.app/
```

📡 Endpoints da API Pública

Base URL (produção): https://ebbcopendata.vercel.app

1. Lista de Artigos com Filtros

GET /api/articles

Parâmetros de Consulta (Query Params):

Parâmetro	Tipo	Padrão	Descrição
`search`	string	—	Busca textual em título, resumo, autores, palavras-chave, ferramentas e fontes.
`year`	string	—	Filtra por edição. Aceita múltiplos separados por vírgula (ex: `2022,2024`).
`author`	string	—	Filtra por nome de autor (busca parcial).
`tool`	string	—	Filtra por software/ferramenta utilizada (ex: `VOSviewer`, `R`).
`source`	string	—	Filtra por fonte de coleta de dados (ex: `Scopus`, `Lattes`).
`stage`	string	—	Filtra por etapa metodológica: `coleta de dados`, `análise dos dados`, `visualização`.
`has_tool`	boolean	—	`true` retorna apenas artigos que usam alguma ferramenta.
`sort`	string	`title`	Campo de ordenação: `title`, `year` ou `doi`.
`order`	string	`asc`	Sentido da ordenação: `asc` ou `desc`.
`limit`	integer	`20`	Quantidade de resultados por página.
`offset`	integer	`0`	Quantidade de itens a pular (paginação).

Exemplo de resposta:

{
  "total": 643,
  "filteredCount": 12,
  "limit": 20,
  "offset": 0,
  "results": [ { "doi": "...", "title": "...", "year": 2024, "authors": [...] } ]
}

2. Estatísticas Consolidadas

GET /api/articles/stats

Retorna dados agregados calculados dinamicamente: total de artigos, distribuição por edição, taxa de adoção de ferramentas, ranking das top ferramentas, principais fontes de coleta e distribuição por etapa metodológica.

3. Busca por DOI Individual

Suporta três formatos de chamada:

# Formato A — DOI URL-encoded (recomendado para clientes HTTP padrão)
GET /api/articles/{doi_url_encoded}
Exemplo: GET /api/articles/https%3A%2F%2Fdoi.org%2F10.22477%2Fix.ebbc.260

# Formato B — Sufixo do DOI com barras brutas
GET /api/articles/doi/{doi_suffix}
Exemplo: GET /api/articles/doi/10.22477/ix.ebbc.260

# Formato C — URL completa do DOI com barras brutas
GET /api/articles/doi/{doi_url_completa}
Exemplo: GET /api/articles/doi/https://doi.org/10.22477/ix.ebbc.260

# Formato D — Query param (fallback)
GET /api/articles/doi?value={doi}
Exemplo: GET /api/articles/doi?value=https://doi.org/10.22477/ix.ebbc.260

4. Exportação de Arquivos

GET /api/articles/export

Exporta o subconjunto filtrado para download. Aceita os mesmos filtros do endpoint /api/articles (exceto limit e offset).

Parâmetro	Valores	Padrão
`format`	`json` ou `csv`	`json`

Exemplos rápidos:

GET /api/articles/export?format=json&year=2024
GET /api/articles/export?format=csv&tool=VOSviewer

🛠️ Detalhes da Curadoria Metodológica (Filtros e RegEx)

A extração automática de softwares e fontes de dados analisa a combinação de Título, Resumo e Palavras-chave de cada submissão com base nas seguintes correspondências:

Categoria	Ferramenta / Fonte	Padrão de Expressão Regular (Regex)
Softwares	VOSviewer	`\bvosviewer\b`
	Gephi	`\bgephi\b`
	CiteSpace	`\bcitespace\b`
	Bibliometrix	`\bbibliometrix\b`
	Python	`\bpython\b`
	R (linguagem)	Expressão contextualizada para evitar falsos positivos de artigos em português
Fontes	Web of Science	`\bweb\s+of\s+science\b\|wos`
	Scopus	`\bscopus\b`
	OpenAlex	`\bopenalex\b`
	Google Scholar	`\bgoogle\s+scholar\b`

📄 Licença

Este projeto é licenciado sob a Licença MIT — consulte o arquivo LICENSE para mais detalhes.

🗣️ Como Citar / How to Cite

Se você utilizou o EBBC OpenData em sua pesquisa, por favor cite usando um dos formatos abaixo.

📌 Zenodo (DOI Oficial)

ABNT:

GAMA, Gabriel Nascimento. EBBC OpenData: Portal e API Pública de Metadados dos Anais do EBBC (2012–2024). Zenodo, 2026. DOI: 10.5281/zenodo.20722056. Disponível em: https://ebbcopendata.vercel.app.

APA:

Gama, G. N. (2026). EBBC OpenData: Portal e API Pública de Metadados dos Anais do EBBC (2012–2024). Zenodo. https://doi.org/10.5281/zenodo.20722056

BibTeX:

@software{gama_2026_ebbc_opendata,
  author       = {Gama, Gabriel Nascimento},
  title        = {{EBBC OpenData: Portal e API Pública de Metadados dos Anais do EBBC (2012--2024)}},
  year         = {2026},
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.20722056},
  url          = {https://doi.org/10.5281/zenodo.20722056}
}

🐙 GitHub (Repositório)

ABNT:

GAMA, Gabriel Nascimento. EBBC OpenData. GitHub, 2026. Disponível em: https://github.com/GabrielBaiano/EBBC-OpenData. Acesso em: [data de acesso].

APA:

Gama, G. N. (2026). EBBC OpenData [Software]. GitHub. https://github.com/GabrielBaiano/EBBC-OpenData

BibTeX:

@software{gama_2026_ebbc_opendata_github,
  author       = {Gama, Gabriel Nascimento},
  title        = {{EBBC OpenData}},
  year         = {2026},
  publisher    = {GitHub},
  url          = {https://github.com/GabrielBaiano/EBBC-OpenData}
}

Name		Name	Last commit message	Last commit date
data		data
node_modules		node_modules
public		public
tests		tests
venv		venv
.gitignore		.gitignore
LICENSE		LICENSE
README.en.md		README.en.md
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
server.js		server.js
vercel.json		vercel.json

Navigation Menu

Repository files navigation

📊 EBBC OpenData — Portal & API Pública de Anais

🏗️ Arquitetura do Sistema e Fluxo de Dados

⚡ Principais Recursos do Projeto

🚀 Como Executar o Projeto Localmente

Pré-requisitos

Passos para Inicialização

📡 Endpoints da API Pública

1. Lista de Artigos com Filtros

2. Estatísticas Consolidadas

3. Busca por DOI Individual

4. Exportação de Arquivos

🛠️ Detalhes da Curadoria Metodológica (Filtros e RegEx)

📄 Licença

🗣️ Como Citar / How to Cite

📌 Zenodo (DOI Oficial)

🐙 GitHub (Repositório)

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

📊 EBBC OpenData — Portal & API Pública de Anais

🏗️ Arquitetura do Sistema e Fluxo de Dados

⚡ Principais Recursos do Projeto

🚀 Como Executar o Projeto Localmente

Pré-requisitos

Passos para Inicialização

📡 Endpoints da API Pública

1. Lista de Artigos com Filtros

2. Estatísticas Consolidadas

3. Busca por DOI Individual

4. Exportação de Arquivos

🛠️ Detalhes da Curadoria Metodológica (Filtros e RegEx)

📄 Licença

🗣️ Como Citar / How to Cite

📌 Zenodo (DOI Oficial)

🐙 GitHub (Repositório)

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages