# erisonbarros/pluginqgis_geometria_onr architecture

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

- Interactive diagram: https://gitdiagram.com/erisonbarros/pluginqgis_geometria_onr
- Repository: https://github.com/erisonbarros/pluginqgis_geometria_onr

## Overview

The product is an early QGIS plugin for inspecting polygon layers and exporting a TXT geometry description. Its principal workflow is: choose a polygon layer and features, select an output CRS, validate and transform geometries, calculate GRS80 area/perimeter and enumerate parts/rings/vertices, then save the report. The repository also contains a separate ONR-oriented PyQGIS script. The README documents further ONR preparation guidance, but explicitly says shapefile submission support and ONR upload are outside the plugin; unsampled details are not inferred.

Main entry points: [`gerador_descricao_poligonos/plugin.py`](https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/gerador_descricao_poligonos/plugin.py) (Export Dialog), [`script_onr.py`](https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/script_onr.py) (ONR Description Script), [`gerador_descricao_poligonos/__init__.py`](https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/gerador_descricao_poligonos/__init__.py) (Plugin Loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["QGIS Plugin"]
  node_plugin_loader["Plugin Loader<br/>[__init__.py]"]
  node_plugin_controller["Plugin Controller<br/>[plugin.py]"]
  node_plugin_dialog["Export Dialog<br/>[plugin.py]"]
  node_layer_selection["Layer Selection<br/>[plugin.py]"]
  node_geometry_report["Geometry Report<br/>[plugin.py]"]
  node_txt_file["TXT Report"]
end

subgraph group_onr["ONR Script"]
  node_onr_script["ONR Description Script<br/>[script_onr.py]"]
  node_onr_txt["ONR TXT Report"]
end

node_qgis_user(("QGIS User"))
node_qgis_host["QGIS Host"]
node_onr_user(("PyQGIS User"))

node_qgis_user -.->|"loads plugin"| node_plugin_loader
node_plugin_loader -->|"creates controller"| node_plugin_controller
node_plugin_controller -->|"opens dialog"| node_plugin_dialog
node_qgis_host -->|"provides interface"| node_plugin_controller
node_plugin_dialog -->|"populates layers"| node_layer_selection
node_layer_selection -->|"reads project layers"| node_qgis_host
node_plugin_dialog -->|"builds report"| node_geometry_report
node_geometry_report -->|"uses CRS services"| node_qgis_host
node_plugin_dialog -->|"writes report"| node_txt_file
node_onr_user -->|"runs script"| node_onr_script
node_onr_script -->|"reads layer and transforms"| node_qgis_host
node_onr_script -->|"writes report"| node_onr_txt

click node_plugin_loader "https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/gerador_descricao_poligonos/__init__.py"
click node_plugin_controller "https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/gerador_descricao_poligonos/plugin.py"
click node_plugin_dialog "https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/gerador_descricao_poligonos/plugin.py"
click node_layer_selection "https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/gerador_descricao_poligonos/plugin.py"
click node_geometry_report "https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/gerador_descricao_poligonos/plugin.py"
click node_onr_script "https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/script_onr.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_plugin_loader,node_plugin_controller,node_plugin_dialog,node_layer_selection,node_geometry_report,node_txt_file,node_qgis_user,node_onr_user toneBlue
class node_onr_script,node_onr_txt toneAmber
class node_qgis_host toneIndigo
```

## Components

### QGIS Plugin

- [Plugin Loader](https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/gerador_descricao_poligonos/__init__.py): `gerador_descricao_poligonos/__init__.py`
- [Plugin Controller](https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/gerador_descricao_poligonos/plugin.py): `gerador_descricao_poligonos/plugin.py`
- [Export Dialog](https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/gerador_descricao_poligonos/plugin.py): `gerador_descricao_poligonos/plugin.py`
- [Layer Selection](https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/gerador_descricao_poligonos/plugin.py): `gerador_descricao_poligonos/plugin.py`
- [Geometry Report](https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/gerador_descricao_poligonos/plugin.py): `gerador_descricao_poligonos/plugin.py`
- **TXT Report**

### ONR Script

- [ONR Description Script](https://github.com/erisonbarros/pluginqgis_geometria_onr/blob/erison.barros/script_onr.py): `script_onr.py`
- **ONR TXT Report**

### Other components

- **QGIS User**
- **QGIS Host**
- **PyQGIS User**

## Connections

- QGIS User → Plugin Loader: loads plugin
- Plugin Loader → Plugin Controller: creates controller (evidence: `gerador_descricao_poligonos/__init__.py`)
- Plugin Controller → Export Dialog: opens dialog (evidence: `gerador_descricao_poligonos/plugin.py`)
- QGIS Host → Plugin Controller: provides interface (evidence: `gerador_descricao_poligonos/plugin.py`)
- Export Dialog → Layer Selection: populates layers (evidence: `gerador_descricao_poligonos/plugin.py`)
- Layer Selection → QGIS Host: reads project layers (evidence: `gerador_descricao_poligonos/plugin.py`)
- Export Dialog → Geometry Report: builds report (evidence: `gerador_descricao_poligonos/plugin.py`)
- Geometry Report → QGIS Host: uses CRS services (evidence: `gerador_descricao_poligonos/plugin.py`)
- Export Dialog → TXT Report: writes report (evidence: `gerador_descricao_poligonos/plugin.py`)
- PyQGIS User → ONR Description Script: runs script (evidence: `script_onr.py`)
- ONR Description Script → QGIS Host: reads layer and transforms (evidence: `script_onr.py`)
- ONR Description Script → ONR TXT Report: writes report (evidence: `script_onr.py`)
