# gisintelugu/polygonsequentialnumbering architecture

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

- Interactive diagram: https://gitdiagram.com/gisintelugu/polygonsequentialnumbering
- Repository: https://github.com/gisintelugu/polygonsequentialnumbering

## Overview

PolygonSequentialNumbering is a QGIS plugin for assigning sequential values to polygon attributes. A user opens the plugin dialog for the active polygon layer, configures the target field and numbering options, then starts a map-tool session. The tool supports manual clicks, selected features, and spatial ordering; it edits layer attributes and provides highlighting and undo. The dialog also handles field selection/creation and numbering previews. Relationships are based on the excerpts and README; unsampled dialog and map-tool code may contain additional behavior not shown.

Main entry points: [`polygon_sequential_numbering.py`](https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/polygon_sequential_numbering.py) (Plugin controller), [`numbering_map_tool.py`](https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/numbering_map_tool.py) (Numbering map tool), [`numbering_dialog.py`](https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/numbering_dialog.py) (Numbering dialog), [`__init__.py`](https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/__init__.py) (Plugin entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["Plugin lifecycle"]
  node_plugin_entry["Plugin entry<br/>[__init__.py]"]
  node_plugin_controller["Plugin controller"]
end

subgraph group_configuration["Configuration UI"]
  node_numbering_dialog["Numbering dialog"]
end

subgraph group_numbering["Numbering session"]
  node_map_tool["Numbering map tool"]
  node_modes["Numbering modes"]
  node_undo_history["Undo history"]
end

subgraph group_qgis["QGIS runtime"]
  node_vector_layer[("Polygon vector layer")]
  node_map_canvas["QGIS map canvas"]
end

node_user(("QGIS user"))

node_user -->|"loads plugin"| node_plugin_entry
node_plugin_entry -->|"creates plugin"| node_plugin_controller
node_user -->|"starts plugin"| node_plugin_controller
node_plugin_controller -->|"opens dialog"| node_numbering_dialog
node_numbering_dialog -->|"reads and edits fields"| node_vector_layer
node_numbering_dialog -->|"emits session settings"| node_plugin_controller
node_plugin_controller -->|"creates tool"| node_map_tool
node_plugin_controller -->|"sets map tool"| node_map_canvas
node_map_tool -->|"dispatches numbering"| node_modes
node_map_tool -->|"reads and writes attributes"| node_vector_layer
node_map_tool -->|"records changes"| node_undo_history
node_map_tool -->|"highlights features"| node_map_canvas
node_plugin_controller -->|"requests undo"| node_map_tool

click node_plugin_entry "https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/__init__.py"
click node_plugin_controller "https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/polygon_sequential_numbering.py"
click node_numbering_dialog "https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/numbering_dialog.py"
click node_map_tool "https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/numbering_map_tool.py"
click node_modes "https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/numbering_map_tool.py"
click node_undo_history "https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/numbering_map_tool.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_entry,node_plugin_controller,node_user toneBlue
class node_numbering_dialog toneAmber
class node_map_tool,node_modes,node_undo_history toneMint
class node_vector_layer,node_map_canvas toneRose
```

## Components

### Plugin lifecycle

- [Plugin entry](https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/__init__.py): `__init__.py`
- [Plugin controller](https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/polygon_sequential_numbering.py): `polygon_sequential_numbering.py`

### Configuration UI

- [Numbering dialog](https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/numbering_dialog.py): `numbering_dialog.py`

### Numbering session

- [Numbering map tool](https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/numbering_map_tool.py): `numbering_map_tool.py`
- [Numbering modes](https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/numbering_map_tool.py): `numbering_map_tool.py`
- [Undo history](https://github.com/gisintelugu/polygonsequentialnumbering/blob/main/numbering_map_tool.py): `numbering_map_tool.py`

### QGIS runtime

- **Polygon vector layer**
- **QGIS map canvas**

### Other components

- **QGIS user**

## Connections

- QGIS user → Plugin entry: loads plugin (evidence: `__init__.py`)
- Plugin entry → Plugin controller: creates plugin (evidence: `__init__.py`)
- QGIS user → Plugin controller: starts plugin (evidence: `polygon_sequential_numbering.py`)
- Plugin controller → Numbering dialog: opens dialog (evidence: `polygon_sequential_numbering.py`)
- Numbering dialog → Polygon vector layer: reads and edits fields (evidence: `numbering_dialog.py`)
- Numbering dialog → Plugin controller: emits session settings (evidence: `polygon_sequential_numbering.py`)
- Plugin controller → Numbering map tool: creates tool (evidence: `polygon_sequential_numbering.py`)
- Plugin controller → QGIS map canvas: sets map tool (evidence: `polygon_sequential_numbering.py`)
- Numbering map tool → Numbering modes: dispatches numbering (evidence: `numbering_map_tool.py`)
- Numbering map tool → Polygon vector layer: reads and writes attributes (evidence: `numbering_map_tool.py`)
- Numbering map tool → Undo history: records changes (evidence: `numbering_map_tool.py`)
- Numbering map tool → QGIS map canvas: highlights features (evidence: `numbering_map_tool.py`)
- Plugin controller → Numbering map tool: requests undo (evidence: `polygon_sequential_numbering.py`)
