# barbosaetn/ppga-analytics architecture

> Architecture diagram of the GitHub repository barbosaetn/ppga-analytics, 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/barbosaetn/ppga-analytics
- Repository: https://github.com/barbosaetn/ppga-analytics

## Overview

PPGA Analytics is a planned academic-production analysis system: users are intended to provide Lattes PDFs, which are structured for later consultation, indicators, comparisons, dashboards, rankings, and reports. The inspected implementation is much narrower: a minimal frontend shell, an Express health endpoint backed by SQLite, and a separate parser proof of concept. The README documents the broader workflow, but the sampled code does not show PDF upload, parser-to-backend integration, or analytics implementation; those links are therefore documented plans, not demonstrated runtime calls.

Main entry points: [`parser/src`](https://github.com/barbosaetn/ppga-analytics/tree/main/parser/src) (Academic structuring), [`backend/src/app.js`](https://github.com/barbosaetn/ppga-analytics/blob/main/backend/src/app.js) (Health endpoint), [`backend/src/database/connection.js`](https://github.com/barbosaetn/ppga-analytics/blob/main/backend/src/database/connection.js) (SQLite database), [`parser/src/main.py`](https://github.com/barbosaetn/ppga-analytics/blob/main/parser/src/main.py) (Lattes PDF)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_frontend["Web interface<br/>[App.jsx]"]
end

subgraph group_api["Backend API"]
  node_server["API server<br/>[server.js]"]
  node_app["Health endpoint<br/>[app.js]"]
  node_database[("SQLite database<br/>[connection.js]")]
  node_env["DB configuration<br/>[env.js]"]
end

subgraph group_parser["PDF processing"]
  node_pdf["Lattes PDF<br/>[main.py]"]
  node_extract["PDF extraction<br/>[main.py]"]
  node_structuring["Academic structuring"]
end

subgraph group_analytics["Planned analytics"]
  node_consult["Data consultation"]
  node_indicators["Indicators and dashboards"]
  node_comparison["Rankings and comparison"]
  node_reports["Analytical reports"]
end

node_manager(("Program user"))

node_server -->|"serves"| node_app
node_app -->|"authenticates"| node_database
node_database -->|"reads settings"| node_env
node_pdf -->|"opens PDF"| node_extract
node_manager -.->|"uses"| node_frontend
node_manager -.->|"provides PDF"| node_pdf
node_extract -.->|"structures data"| node_structuring
node_structuring -.->|"enables consultation"| node_consult
node_structuring -.->|"supports indicators"| node_indicators
node_structuring -.->|"supports comparison"| node_comparison
node_structuring -.->|"supports reports"| node_reports
node_manager -.->|"reviews results"| node_consult

click node_frontend "https://github.com/barbosaetn/ppga-analytics/blob/main/frontend/src/App.jsx"
click node_server "https://github.com/barbosaetn/ppga-analytics/blob/main/backend/src/server.js"
click node_app "https://github.com/barbosaetn/ppga-analytics/blob/main/backend/src/app.js"
click node_database "https://github.com/barbosaetn/ppga-analytics/blob/main/backend/src/database/connection.js"
click node_env "https://github.com/barbosaetn/ppga-analytics/blob/main/backend/src/config/env.js"
click node_pdf "https://github.com/barbosaetn/ppga-analytics/blob/main/parser/src/main.py"
click node_extract "https://github.com/barbosaetn/ppga-analytics/blob/main/parser/src/main.py"
click node_structuring "https://github.com/barbosaetn/ppga-analytics/tree/main/parser/src"

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_frontend,node_manager toneBlue
class node_server,node_app,node_database,node_env toneAmber
class node_pdf,node_extract,node_structuring toneMint
class node_consult,node_indicators,node_comparison,node_reports toneRose
```

## Components

### User interface

- [Web interface](https://github.com/barbosaetn/ppga-analytics/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### Backend API

- [API server](https://github.com/barbosaetn/ppga-analytics/blob/main/backend/src/server.js): `backend/src/server.js`
- [Health endpoint](https://github.com/barbosaetn/ppga-analytics/blob/main/backend/src/app.js): `backend/src/app.js`
- [SQLite database](https://github.com/barbosaetn/ppga-analytics/blob/main/backend/src/database/connection.js): `backend/src/database/connection.js`
- [DB configuration](https://github.com/barbosaetn/ppga-analytics/blob/main/backend/src/config/env.js): `backend/src/config/env.js`

### PDF processing

- [Lattes PDF](https://github.com/barbosaetn/ppga-analytics/blob/main/parser/src/main.py): `parser/src/main.py`
- [PDF extraction](https://github.com/barbosaetn/ppga-analytics/blob/main/parser/src/main.py): `parser/src/main.py`
- [Academic structuring](https://github.com/barbosaetn/ppga-analytics/tree/main/parser/src): `parser/src`

### Planned analytics

- **Data consultation**
- **Indicators and dashboards**
- **Rankings and comparison**
- **Analytical reports**

### Other components

- **Program user**

## Connections

- API server → Health endpoint: serves (evidence: `backend/src/server.js`)
- Health endpoint → SQLite database: authenticates (evidence: `backend/src/app.js`)
- SQLite database → DB configuration: reads settings (evidence: `backend/src/database/connection.js`)
- Lattes PDF → PDF extraction: opens PDF (evidence: `parser/src/main.py`)
- Program user → Web interface: uses (evidence: `README.md`)
- Program user → Lattes PDF: provides PDF (evidence: `README.md`)
- PDF extraction → Academic structuring: structures data (evidence: `README.md`)
- Academic structuring → Data consultation: enables consultation (evidence: `README.md`)
- Academic structuring → Indicators and dashboards: supports indicators (evidence: `README.md`)
- Academic structuring → Rankings and comparison: supports comparison (evidence: `README.md`)
- Academic structuring → Analytical reports: supports reports (evidence: `README.md`)
- Program user → Data consultation: reviews results (evidence: `README.md`)
