# ifesserra-lab/scriptlattes architecture

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

- Interactive diagram: https://gitdiagram.com/ifesserra-lab/scriptlattes
- Repository: https://github.com/ifesserra-lab/scriptlattes

## Overview

scriptLattes compiles public Lattes curricula for a configured researcher group into deduplicated research and activity summaries, reports, researcher-level JSON, collaboration graphs, and member/student location maps. The principal workflow is configuration and researcher IDs → curriculum download → HTML parsing into domain records → group compilation → generated outputs. The graph preserves major documented production categories and reporting capabilities. Several subsystem links rely on the README or SOURCE INDEX; unsampled implementation details are not treated as verified call paths.

Main entry points: [`scriptLattes/grupo.py`](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/grupo.py) (Group coordinator), [`scriptLattes/parserLattes.py`](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/parserLattes.py) (Lattes HTML parser), [`scriptLattes/membro.py`](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/membro.py) (Researcher member), [`scriptLattes/baixaLattes.py`](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/baixaLattes.py) (Curriculum download)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Collection workflow"]
  node_cli["CLI entry<br/>[scriptLattes.py]"]
  node_group["Group coordinator<br/>[grupo.py]"]
  node_fetch["Curriculum download<br/>[baixaLattes.py]"]
  node_compiler["List compilation"]
end

subgraph group_domain["Researcher data"]
  node_member["Researcher member<br/>[membro.py]"]
  node_parser["Lattes HTML parser<br/>[parserLattes.py]"]
  node_bibliographic["Bibliographic works"]
  node_technical["Technical works"]
  node_artistic["Artistic works"]
  node_projects["Projects and activity"]
  node_events["Event participation"]
  node_patents["Patents and records"]
  node_guidance["Student guidance"]
end

subgraph group_outputs["Reports and analysis"]
  node_web["HTML report generation"]
  node_collaboration["Collaboration graphs"]
  node_json["Researcher JSON<br/>[grupo.py]"]
  node_location["Member location map"]
end

subgraph group_support["Shared services"]
  node_similarity["Similarity utilities<br/>[util.py]"]
end

node_user(("Research group user"))
node_lattes[("Lattes public curricula")]

node_user -->|"runs with config"| node_cli
node_cli -->|"starts processing"| node_group
node_group -.->|"downloads curricula"| node_fetch
node_fetch -.->|"retrieves HTML"| node_lattes
node_group -->|"loads researchers"| node_member
node_member -->|"downloads curriculum"| node_fetch
node_member -->|"parses curriculum"| node_parser
node_parser -->|"creates records"| node_bibliographic
node_parser -->|"creates records"| node_technical
node_parser -->|"creates records"| node_artistic
node_parser -->|"creates records"| node_projects
node_parser -.->|"creates records"| node_events
node_parser -.->|"creates records"| node_patents
node_parser -->|"creates records"| node_guidance
node_group -->|"compiles lists"| node_compiler
node_compiler -->|"compares items"| node_similarity
node_group -->|"generates reports"| node_web
node_group -->|"writes researcher JSON"| node_json
node_group -->|"generates graphs"| node_collaboration
node_group -.->|"generates location maps"| node_location

click node_cli "https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes.py"
click node_group "https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/grupo.py"
click node_fetch "https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/baixaLattes.py"
click node_member "https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/membro.py"
click node_parser "https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/parserLattes.py"
click node_bibliographic "https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/producoesBibliograficas"
click node_technical "https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/producoesTecnicas"
click node_artistic "https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/producoesArtisticas"
click node_projects "https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/producoesUnitarias"
click node_events "https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/eventos"
click node_patents "https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/patentesRegistros"
click node_guidance "https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/orientacoes"
click node_compiler "https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/compiladorDeListas.py"
click node_web "https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/geradorDePaginasWeb.py"
click node_collaboration "https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/grafoDeColaboracoes.py"
click node_json "https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/grupo.py"
click node_location "https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/geradorDePaginasWeb.py"
click node_similarity "https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/util.py"

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_cli,node_group,node_fetch,node_compiler,node_user toneBlue
class node_member,node_parser,node_bibliographic,node_technical,node_artistic,node_projects,node_events,node_patents,node_guidance,node_lattes toneAmber
class node_web,node_collaboration,node_json,node_location toneMint
class node_similarity toneRose
```

## Components

### Collection workflow

- [CLI entry](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes.py): `scriptLattes.py`
- [Group coordinator](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/grupo.py): `scriptLattes/grupo.py`
- [Curriculum download](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/baixaLattes.py): `scriptLattes/baixaLattes.py`
- [List compilation](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/compiladorDeListas.py): `scriptLattes/compiladorDeListas.py`

### Researcher data

- [Researcher member](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/membro.py): `scriptLattes/membro.py`
- [Lattes HTML parser](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/parserLattes.py): `scriptLattes/parserLattes.py`
- [Bibliographic works](https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/producoesBibliograficas): `scriptLattes/producoesBibliograficas`
- [Technical works](https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/producoesTecnicas): `scriptLattes/producoesTecnicas`
- [Artistic works](https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/producoesArtisticas): `scriptLattes/producoesArtisticas`
- [Projects and activity](https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/producoesUnitarias): `scriptLattes/producoesUnitarias`
- [Event participation](https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/eventos): `scriptLattes/eventos`
- [Patents and records](https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/patentesRegistros): `scriptLattes/patentesRegistros`
- [Student guidance](https://github.com/ifesserra-lab/scriptlattes/tree/main/scriptLattes/orientacoes): `scriptLattes/orientacoes`

### Reports and analysis

- [HTML report generation](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/geradorDePaginasWeb.py): `scriptLattes/geradorDePaginasWeb.py`
- [Collaboration graphs](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/grafoDeColaboracoes.py): `scriptLattes/grafoDeColaboracoes.py`
- [Researcher JSON](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/grupo.py): `scriptLattes/grupo.py`
- [Member location map](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/geradorDePaginasWeb.py): `scriptLattes/geradorDePaginasWeb.py`

### Shared services

- [Similarity utilities](https://github.com/ifesserra-lab/scriptlattes/blob/main/scriptLattes/util.py): `scriptLattes/util.py`

### Other components

- **Research group user**
- **Lattes public curricula**

## Connections

- Research group user → CLI entry: runs with config
- CLI entry → Group coordinator: starts processing (evidence: `scriptLattes.py`)
- Group coordinator → Curriculum download: downloads curricula
- Curriculum download → Lattes public curricula: retrieves HTML
- Group coordinator → Researcher member: loads researchers (evidence: `scriptLattes/grupo.py`)
- Researcher member → Curriculum download: downloads curriculum (evidence: `scriptLattes/membro.py`)
- Researcher member → Lattes HTML parser: parses curriculum (evidence: `scriptLattes/membro.py`)
- Lattes HTML parser → Bibliographic works: creates records (evidence: `scriptLattes/parserLattes.py`)
- Lattes HTML parser → Technical works: creates records (evidence: `scriptLattes/parserLattes.py`)
- Lattes HTML parser → Artistic works: creates records (evidence: `scriptLattes/parserLattes.py`)
- Lattes HTML parser → Projects and activity: creates records (evidence: `scriptLattes/parserLattes.py`)
- Lattes HTML parser → Event participation: creates records (evidence: `scriptLattes/parserLattes.py`)
- Lattes HTML parser → Patents and records: creates records (evidence: `scriptLattes/parserLattes.py`)
- Lattes HTML parser → Student guidance: creates records (evidence: `scriptLattes/parserLattes.py`)
- Group coordinator → List compilation: compiles lists (evidence: `scriptLattes/grupo.py`)
- List compilation → Similarity utilities: compares items (evidence: `scriptLattes/compiladorDeListas.py`)
- Group coordinator → HTML report generation: generates reports (evidence: `scriptLattes/grupo.py`)
- Group coordinator → Researcher JSON: writes researcher JSON (evidence: `scriptLattes/grupo.py`)
- Group coordinator → Collaboration graphs: generates graphs (evidence: `scriptLattes/grupo.py`)
- Group coordinator → Member location map: generates location maps (evidence: `scriptLattes/grupo.py`)
