# marcoagp/findpapers_caest architecture

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

- Interactive diagram: https://gitdiagram.com/marcoagp/findpapers_caest
- Repository: https://github.com/marcoagp/findpapers_caest

## Overview

Este repositório é um script de busca bibliográfica: a pessoa executa a pesquisa multilíngue, o Findpapers consulta e consolida registros em sete bases configuradas, e o script normaliza e ordena os resultados antes de exportá-los. As saídas incluem arquivos tratados e uma tentativa de preservar o resultado bruto, além de um relatório da execução. O mapeamento se baseia no README e nos trechos disponíveis de `pesquisar.py`; detalhes internos do Findpapers e partes não exibidas do script não foram inspecionados.

Main entry points: [`pesquisar.py`](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/pesquisar.py) (Script de pesquisa), [`resultados/findpapers_raw_search.json`](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/findpapers_raw_search.json) (Resultado bruto JSON), [`resultados/artigos.json`](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/artigos.json) (Artigos JSON), [`resultados/artigos.csv`](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/artigos.csv) (Artigos CSV)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_search["Busca bibliográfica"]
  node_query["Consulta multilíngue<br/>[pesquisar.py]"]
  node_runner["Script de pesquisa<br/>[pesquisar.py]"]
  node_findpapers["Findpapers Engine"]
  node_indexes["Sete bases acadêmicas"]
end

subgraph group_processing["Tratamento dos registros"]
  node_normalization["Normalização de metadados<br/>[pesquisar.py]"]
  node_ranking["Ordenação de registros<br/>[pesquisar.py]"]
end

subgraph group_outputs["Exportação de resultados"]
  node_raw["Resultado bruto JSON"]
  node_json["Artigos JSON<br/>[artigos.json]"]
  node_csv["Artigos CSV<br/>[artigos.csv]"]
  node_bib["Artigos BibTeX<br/>[artigos.bib]"]
  node_fulltext["Texto dos artigos"]
  node_summary["Resumo da busca<br/>[resumo_busca.txt]"]
end

node_researcher(("Pesquisador"))

node_researcher -->|"executa"| node_runner
node_runner -->|"usa consulta"| node_query
node_runner -->|"chama busca"| node_findpapers
node_findpapers -->|"consulta bases"| node_indexes
node_runner -->|"normaliza registros"| node_normalization
node_normalization -->|"ordena registros"| node_ranking
node_runner -->|"salva resultado bruto"| node_raw
node_runner -->|"exporta JSON"| node_json
node_runner -->|"exporta CSV"| node_csv
node_runner -->|"exporta BibTeX"| node_bib
node_runner -->|"gera texto"| node_fulltext
node_runner -->|"registra execução"| node_summary

click node_query "https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/pesquisar.py"
click node_runner "https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/pesquisar.py"
click node_normalization "https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/pesquisar.py"
click node_ranking "https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/pesquisar.py"
click node_raw "https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/findpapers_raw_search.json"
click node_json "https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/artigos.json"
click node_csv "https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/artigos.csv"
click node_bib "https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/artigos.bib"
click node_fulltext "https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/artigos_completos.txt"
click node_summary "https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/resumo_busca.txt"

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_query,node_runner,node_findpapers,node_indexes toneBlue
class node_normalization,node_ranking toneAmber
class node_raw,node_json,node_csv,node_bib,node_fulltext,node_summary toneMint
class node_researcher toneIndigo
```

## Components

### Busca bibliográfica

- [Consulta multilíngue](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/pesquisar.py): `pesquisar.py`
- [Script de pesquisa](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/pesquisar.py): `pesquisar.py`
- **Findpapers Engine**
- **Sete bases acadêmicas**

### Tratamento dos registros

- [Normalização de metadados](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/pesquisar.py): `pesquisar.py`
- [Ordenação de registros](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/pesquisar.py): `pesquisar.py`

### Exportação de resultados

- [Resultado bruto JSON](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/findpapers_raw_search.json): `resultados/findpapers_raw_search.json`
- [Artigos JSON](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/artigos.json): `resultados/artigos.json`
- [Artigos CSV](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/artigos.csv): `resultados/artigos.csv`
- [Artigos BibTeX](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/artigos.bib): `resultados/artigos.bib`
- [Texto dos artigos](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/artigos_completos.txt): `resultados/artigos_completos.txt`
- [Resumo da busca](https://github.com/marcoagp/findpapers_caest/blob/MarcoAGP/resultados/resumo_busca.txt): `resultados/resumo_busca.txt`

### Other components

- **Pesquisador**

## Connections

- Pesquisador → Script de pesquisa: executa (evidence: `README.md`)
- Script de pesquisa → Consulta multilíngue: usa consulta (evidence: `pesquisar.py`)
- Script de pesquisa → Findpapers Engine: chama busca (evidence: `pesquisar.py`)
- Findpapers Engine → Sete bases acadêmicas: consulta bases (evidence: `README.md`)
- Script de pesquisa → Normalização de metadados: normaliza registros (evidence: `pesquisar.py`)
- Normalização de metadados → Ordenação de registros: ordena registros (evidence: `pesquisar.py`)
- Script de pesquisa → Resultado bruto JSON: salva resultado bruto (evidence: `pesquisar.py`)
- Script de pesquisa → Artigos JSON: exporta JSON (evidence: `pesquisar.py`)
- Script de pesquisa → Artigos CSV: exporta CSV (evidence: `pesquisar.py`)
- Script de pesquisa → Artigos BibTeX: exporta BibTeX (evidence: `README.md`)
- Script de pesquisa → Texto dos artigos: gera texto (evidence: `README.md`)
- Script de pesquisa → Resumo da busca: registra execução (evidence: `pesquisar.py`)
