# joaopaulosn/tcc architecture

> Architecture diagram of the GitHub repository joaopaulosn/tcc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/joaopaulosn/tcc
- Repository: https://github.com/joaopaulosn/tcc

## Overview

Este repositório reúne scripts de análise da autoria em publicações do SBSC entre 2006 e 2025. O fluxo principal parte da planilha tratada, enriquece dados de gênero via IBGE e de localização por afiliação, padroniza e corrige os dados, e então produz análises regionais, históricas e de coautoria. As análises consomem os CSVs resultantes e geram relatórios e visualizações. A arquitetura foi inferida da árvore e dos trechos disponíveis; as ligações de scripts não amostrados refletem nomes de arquivos e artefatos listados, não inspeção de sua implementação.

Main entry points: [`sbsc_dataset_genero_completo.csv`](https://github.com/joaopaulosn/tcc/blob/main/sbsc_dataset_genero_completo.csv) (Dados com gênero), [`enriquecer_dataset2.py`](https://github.com/joaopaulosn/tcc/blob/main/enriquecer_dataset2.py) (Enriquecer dados), [`analisar_genero_regiao_brasil.py`](https://github.com/joaopaulosn/tcc/blob/main/analisar_genero_regiao_brasil.py) (Comparação nacional), [`perspectiva_historica.py`](https://github.com/joaopaulosn/tcc/blob/main/perspectiva_historica.py) (Evolução histórica)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_enrichment["Preparação de dados"]
  node_enrich["Enriquecer dados"]
  node_clean["Limpar afiliações"]
  node_gender_fix["Corrigir gênero<br/>[correcao_genero.py]"]
end

subgraph group_analysis["Análise demográfica"]
  node_regional["Métricas por região"]
  node_regional_brazil["Comparação nacional"]
  node_regional_chart["Gráficos regionais<br/>[grafico_regiao.py]"]
  node_historical["Evolução histórica"]
end

subgraph group_network["Rede de coautoria"]
  node_network_static["Análise de coautoria<br/>[redes_sociais.py]"]
  node_network_interactive["Rede interativa<br/>[redes_sociais2.py]"]
end

subgraph group_artifacts["Dados e resultados"]
  node_source_xlsx["Planilha tratada"]
  node_enriched_csv["Dados enriquecidos"]
  node_clean_csv["Dados normalizados"]
  node_gender_csv["Dados com gênero"]
  node_regional_report["Relatório regional"]
  node_history_csv["Séries históricas"]
  node_history_summary["Resumo histórico"]
  node_centrality_csv["Métricas centrais"]
  node_network_summary["Resumo da rede"]
  node_network_html["Visualização da rede"]
end

node_researcher(("Pesquisador"))
node_ibge{{"API de nomes IBGE"}}

node_researcher -->|"inicia processamento"| node_enrich
node_source_xlsx -->|"lê abas"| node_enrich
node_enrich -.->|"consulta nomes"| node_ibge
node_enrich -->|"grava dados"| node_enriched_csv
node_enriched_csv -->|"lê dados"| node_clean
node_clean -->|"grava dados limpos"| node_clean_csv
node_clean_csv -->|"lê dados"| node_gender_fix
node_gender_fix -->|"grava correções"| node_gender_csv
node_gender_csv -->|"lê autores"| node_regional_brazil
node_regional_brazil -->|"grava relatório"| node_regional_report
node_regional_report -->|"lê métricas"| node_regional_chart
node_regional_brazil -.->|"compartilha análise regional"| node_regional
node_enriched_csv -->|"lê dados"| node_regional
node_gender_csv -->|"lê autores"| node_historical
node_historical -->|"grava série"| node_history_csv
node_historical -->|"grava resumo"| node_history_summary
node_gender_csv -->|"lê autores"| node_network_static
node_network_static -->|"grava métricas"| node_centrality_csv
node_network_static -->|"grava resumo"| node_network_summary
node_gender_csv -->|"lê autores"| node_network_interactive
node_network_interactive -->|"grava visualização"| node_network_html

click node_source_xlsx "https://github.com/joaopaulosn/tcc/blob/main/Dataset%20SBSC%202006-2025%20-%20Tratado.xlsx"
click node_enrich "https://github.com/joaopaulosn/tcc/blob/main/enriquecer_dataset2.py"
click node_enriched_csv "https://github.com/joaopaulosn/tcc/blob/main/sbsc_dataset_enriquecido_ibge_2006_2025.csv"
click node_clean "https://github.com/joaopaulosn/tcc/blob/main/limpeza_enriquecimento.py"
click node_gender_fix "https://github.com/joaopaulosn/tcc/blob/main/correcao_genero.py"
click node_gender_csv "https://github.com/joaopaulosn/tcc/blob/main/sbsc_dataset_genero_completo.csv"
click node_regional "https://github.com/joaopaulosn/tcc/blob/main/analisar_genero_regiao.py"
click node_regional_report "https://github.com/joaopaulosn/tcc/blob/main/relatorio_regional_vs_brasil.csv"
click node_regional_brazil "https://github.com/joaopaulosn/tcc/blob/main/analisar_genero_regiao_brasil.py"
click node_regional_chart "https://github.com/joaopaulosn/tcc/blob/main/grafico_regiao.py"
click node_historical "https://github.com/joaopaulosn/tcc/blob/main/perspectiva_historica.py"
click node_history_csv "https://github.com/joaopaulosn/tcc/blob/main/historico_evolucao_sbsc.csv"
click node_history_summary "https://github.com/joaopaulosn/tcc/blob/main/resumo_historico_sbsc.csv"
click node_network_static "https://github.com/joaopaulosn/tcc/blob/main/redes_sociais.py"
click node_network_interactive "https://github.com/joaopaulosn/tcc/blob/main/redes_sociais2.py"
click node_centrality_csv "https://github.com/joaopaulosn/tcc/blob/main/metricas_centralidade_autores.csv"
click node_network_summary "https://github.com/joaopaulosn/tcc/blob/main/resumo_rede_coautoria.txt"
click node_network_html "https://github.com/joaopaulosn/tcc/blob/main/rede_coautoria_sbsc.html"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_enrich,node_clean,node_gender_fix toneBlue
class node_regional,node_regional_brazil,node_regional_chart,node_historical toneAmber
class node_network_static,node_network_interactive,node_ibge toneMint
class node_source_xlsx,node_enriched_csv,node_clean_csv,node_gender_csv,node_regional_report,node_history_csv,node_history_summary,node_centrality_csv,node_network_summary,node_network_html toneRose
class node_researcher toneIndigo
```

## Components

### Preparação de dados

- [Enriquecer dados](https://github.com/joaopaulosn/tcc/blob/main/enriquecer_dataset2.py): `enriquecer_dataset2.py`
- [Limpar afiliações](https://github.com/joaopaulosn/tcc/blob/main/limpeza_enriquecimento.py): `limpeza_enriquecimento.py`
- [Corrigir gênero](https://github.com/joaopaulosn/tcc/blob/main/correcao_genero.py): `correcao_genero.py`

### Análise demográfica

- [Métricas por região](https://github.com/joaopaulosn/tcc/blob/main/analisar_genero_regiao.py): `analisar_genero_regiao.py`
- [Comparação nacional](https://github.com/joaopaulosn/tcc/blob/main/analisar_genero_regiao_brasil.py): `analisar_genero_regiao_brasil.py`
- [Gráficos regionais](https://github.com/joaopaulosn/tcc/blob/main/grafico_regiao.py): `grafico_regiao.py`
- [Evolução histórica](https://github.com/joaopaulosn/tcc/blob/main/perspectiva_historica.py): `perspectiva_historica.py`

### Rede de coautoria

- [Análise de coautoria](https://github.com/joaopaulosn/tcc/blob/main/redes_sociais.py): `redes_sociais.py`
- [Rede interativa](https://github.com/joaopaulosn/tcc/blob/main/redes_sociais2.py): `redes_sociais2.py`

### Dados e resultados

- [Planilha tratada](https://github.com/joaopaulosn/tcc/blob/main/Dataset%20SBSC%202006-2025%20-%20Tratado.xlsx): `Dataset SBSC 2006-2025 - Tratado.xlsx`
- [Dados enriquecidos](https://github.com/joaopaulosn/tcc/blob/main/sbsc_dataset_enriquecido_ibge_2006_2025.csv): `sbsc_dataset_enriquecido_ibge_2006_2025.csv`
- **Dados normalizados**
- [Dados com gênero](https://github.com/joaopaulosn/tcc/blob/main/sbsc_dataset_genero_completo.csv): `sbsc_dataset_genero_completo.csv`
- [Relatório regional](https://github.com/joaopaulosn/tcc/blob/main/relatorio_regional_vs_brasil.csv): `relatorio_regional_vs_brasil.csv`
- [Séries históricas](https://github.com/joaopaulosn/tcc/blob/main/historico_evolucao_sbsc.csv): `historico_evolucao_sbsc.csv`
- [Resumo histórico](https://github.com/joaopaulosn/tcc/blob/main/resumo_historico_sbsc.csv): `resumo_historico_sbsc.csv`
- [Métricas centrais](https://github.com/joaopaulosn/tcc/blob/main/metricas_centralidade_autores.csv): `metricas_centralidade_autores.csv`
- [Resumo da rede](https://github.com/joaopaulosn/tcc/blob/main/resumo_rede_coautoria.txt): `resumo_rede_coautoria.txt`
- [Visualização da rede](https://github.com/joaopaulosn/tcc/blob/main/rede_coautoria_sbsc.html): `rede_coautoria_sbsc.html`

### Other components

- **Pesquisador**
- **API de nomes IBGE**

## Connections

- Pesquisador → Enriquecer dados: inicia processamento
- Planilha tratada → Enriquecer dados: lê abas
- Enriquecer dados → API de nomes IBGE: consulta nomes
- Enriquecer dados → Dados enriquecidos: grava dados
- Dados enriquecidos → Limpar afiliações: lê dados
- Limpar afiliações → Dados normalizados: grava dados limpos
- Dados normalizados → Corrigir gênero: lê dados
- Corrigir gênero → Dados com gênero: grava correções
- Dados com gênero → Comparação nacional: lê autores
- Comparação nacional → Relatório regional: grava relatório
- Relatório regional → Gráficos regionais: lê métricas
- Comparação nacional → Métricas por região: compartilha análise regional
- Dados enriquecidos → Métricas por região: lê dados
- Dados com gênero → Evolução histórica: lê autores
- Evolução histórica → Séries históricas: grava série
- Evolução histórica → Resumo histórico: grava resumo
- Dados com gênero → Análise de coautoria: lê autores
- Análise de coautoria → Métricas centrais: grava métricas
- Análise de coautoria → Resumo da rede: grava resumo
- Dados com gênero → Rede interativa: lê autores
- Rede interativa → Visualização da rede: grava visualização