# rnd95/sort_vf_qt architecture

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

- Interactive diagram: https://gitdiagram.com/rnd95/sort_vf_qt
- Repository: https://github.com/rnd95/sort_vf_qt

## Overview

This small PyQt5 utility sorts verification files from district ZIP archives into a structured output folder. Showing the window triggers the workflow: it discovers district directories, extracts archives, locates month/bank verification folders, copies their contents, and logs progress or errors in the UI. The UI module supplies the window widgets and logging list; no persistent database or external service is shown. The graph follows the sampled files; the README provides no additional capability details.

Main entry points: [`main.py`](https://github.com/rnd95/sort_vf_qt/blob/master/main.py) (Archive sorter), [`MainWindow.py`](https://github.com/rnd95/sort_vf_qt/blob/master/MainWindow.py) (Window UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Sorting workflow"]
  node_app["Application startup<br/>[main.py]"]
  node_sorter["Archive sorter<br/>[main.py]"]
end

subgraph group_ui["Desktop interface"]
  node_window_ui["Window UI<br/>[MainWindow.py]"]
end

subgraph group_filesystem["Local files"]
  node_districts["District folders"]
  node_archives["ZIP archives"]
  node_extracted["Extracted files"]
  node_sorted_output["Sorted output"]
end

node_user(("User"))

node_user -->|"launches"| node_app
node_app -->|"sets up"| node_window_ui
node_app -->|"creates"| node_sorter
node_sorter -->|"scans"| node_districts
node_sorter -->|"extracts"| node_archives
node_sorter -->|"copies from"| node_extracted
node_sorter -->|"copies to"| node_sorted_output
node_sorter -->|"logs progress"| node_window_ui
node_window_ui -->|"shows status"| node_user

click node_app "https://github.com/rnd95/sort_vf_qt/blob/master/main.py"
click node_sorter "https://github.com/rnd95/sort_vf_qt/blob/master/main.py"
click node_window_ui "https://github.com/rnd95/sort_vf_qt/blob/master/MainWindow.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_app,node_sorter,node_user toneBlue
class node_window_ui toneAmber
class node_districts,node_archives,node_extracted,node_sorted_output toneMint
```

## Components

### Sorting workflow

- [Application startup](https://github.com/rnd95/sort_vf_qt/blob/master/main.py): `main.py`
- [Archive sorter](https://github.com/rnd95/sort_vf_qt/blob/master/main.py): `main.py`

### Desktop interface

- [Window UI](https://github.com/rnd95/sort_vf_qt/blob/master/MainWindow.py): `MainWindow.py`

### Local files

- **District folders**
- **ZIP archives**
- **Extracted files**
- **Sorted output**

### Other components

- **User**

## Connections

- User → Application startup: launches (evidence: `main.py`)
- Application startup → Window UI: sets up (evidence: `main.py`)
- Application startup → Archive sorter: creates (evidence: `main.py`)
- Archive sorter → District folders: scans (evidence: `main.py`)
- Archive sorter → ZIP archives: extracts (evidence: `main.py`)
- Archive sorter → Extracted files: copies from (evidence: `main.py`)
- Archive sorter → Sorted output: copies to (evidence: `main.py`)
- Archive sorter → Window UI: logs progress (evidence: `main.py`)
- Window UI → User: shows status (evidence: `MainWindow.py`)
