# wwwoper/easy_label architecture

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

- Interactive diagram: https://gitdiagram.com/wwwoper/easy_label
- Repository: https://github.com/wwwoper/easy_label

## Overview

EasyLabelPro is a desktop XLSX delivery-label and report generator. Its main workflow is: a user selects or drops an order spreadsheet, the GUI starts processing, the application parses orders, dispatches them by delivery method, validates and transforms them, and writes a dated workbook. The documented delivery branches are postal, pickup-centre labels and recipient lists, and marketplace deliveries. The graph also shows the shared order models and phone/postal-code validation layer. Some output and GUI behavior is documented or visible only in partial excerpts, so the graph avoids inferring unshown calls.

Main entry points: [`xlsx_processor/main.py`](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/main.py) (XLSX workflow), [`xlsx_processor/processors/__init__.py`](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/processors/__init__.py) (Delivery dispatcher), [`xlsx_processor/processors/strategies/postal.py`](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/processors/strategies/postal.py) (Postal processing), [`xlsx_processor/validators/phone.py`](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/validators/phone.py) (Phone check)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_gui["File GUI<br/>[main.py]"]
  node_worker["Processing worker<br/>[main.py]"]
  node_orchestrator["XLSX workflow<br/>[main.py]"]
  node_config["Runtime config<br/>[config.py]"]
  node_logging["Processing logs<br/>[main.py]"]
end

subgraph group_input["Order input"]
  node_parser["XLSX parser<br/>[parser.py]"]
  node_models["Order models<br/>[models.py]"]
end

subgraph group_processing["Delivery processing"]
  node_dispatcher["Delivery dispatcher<br/>[__init__.py]"]
  node_strategy_base["Strategy contract<br/>[base.py]"]
  node_postal["Postal processing<br/>[postal.py]"]
  node_pickup["Pickup processing<br/>[pickup.py]"]
  node_marketplace["Marketplace processing<br/>[ozon_yandex_wb.py]"]
end

subgraph group_output["Reports and validation"]
  node_validator_base["Validator contract<br/>[base.py]"]
  node_number_validator["Postal code check<br/>[number.py]"]
  node_phone_validator["Phone check<br/>[phone.py]"]
  node_workbook["Output workbook<br/>[main.py]"]
end

node_user(("Desktop user"))

node_user -->|"selects file"| node_gui
node_gui -->|"starts worker"| node_worker
node_worker -->|"runs processing"| node_orchestrator
node_orchestrator -->|"loads settings"| node_config
node_orchestrator -->|"parses workbook"| node_parser
node_parser -->|"creates orders"| node_models
node_orchestrator -->|"dispatches orders"| node_dispatcher
node_dispatcher -->|"processes postal"| node_postal
node_dispatcher -->|"processes pickup"| node_pickup
node_dispatcher -->|"processes marketplace"| node_marketplace
node_dispatcher -->|"uses order types"| node_models
node_postal -->|"implements"| node_strategy_base
node_pickup -->|"implements"| node_strategy_base
node_postal -->|"checks postal code"| node_number_validator
node_postal -->|"checks phone"| node_phone_validator
node_marketplace -->|"checks phone"| node_phone_validator
node_number_validator -->|"implements"| node_validator_base
node_phone_validator -->|"implements"| node_validator_base
node_orchestrator -->|"writes sheets"| node_workbook
node_orchestrator -->|"logs processing"| node_logging

click node_gui "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/main.py"
click node_worker "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/main.py"
click node_orchestrator "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/main.py"
click node_config "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/config/config.py"
click node_parser "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/core/parser.py"
click node_models "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/core/models.py"
click node_dispatcher "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/processors/__init__.py"
click node_strategy_base "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/processors/base.py"
click node_postal "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/processors/strategies/postal.py"
click node_pickup "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/processors/strategies/pickup.py"
click node_marketplace "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/processors/strategies/ozon_yandex_wb.py"
click node_validator_base "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/validators/base.py"
click node_number_validator "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/validators/number.py"
click node_phone_validator "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/validators/phone.py"
click node_workbook "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/main.py"
click node_logging "https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/main.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_gui,node_worker,node_orchestrator,node_config,node_logging,node_user toneBlue
class node_parser,node_models toneAmber
class node_dispatcher,node_strategy_base,node_postal,node_pickup,node_marketplace toneMint
class node_validator_base,node_number_validator,node_phone_validator,node_workbook toneRose
```

## Components

### Desktop application

- [File GUI](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/main.py): `xlsx_processor/main.py`
- [Processing worker](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/main.py): `xlsx_processor/main.py`
- [XLSX workflow](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/main.py): `xlsx_processor/main.py`
- [Runtime config](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/config/config.py): `xlsx_processor/config/config.py`
- [Processing logs](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/main.py): `xlsx_processor/main.py`

### Order input

- [XLSX parser](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/core/parser.py): `xlsx_processor/core/parser.py`
- [Order models](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/core/models.py): `xlsx_processor/core/models.py`

### Delivery processing

- [Delivery dispatcher](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/processors/__init__.py): `xlsx_processor/processors/__init__.py`
- [Strategy contract](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/processors/base.py): `xlsx_processor/processors/base.py`
- [Postal processing](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/processors/strategies/postal.py): `xlsx_processor/processors/strategies/postal.py`
- [Pickup processing](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/processors/strategies/pickup.py): `xlsx_processor/processors/strategies/pickup.py`
- [Marketplace processing](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/processors/strategies/ozon_yandex_wb.py): `xlsx_processor/processors/strategies/ozon_yandex_wb.py`

### Reports and validation

- [Validator contract](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/validators/base.py): `xlsx_processor/validators/base.py`
- [Postal code check](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/validators/number.py): `xlsx_processor/validators/number.py`
- [Phone check](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/validators/phone.py): `xlsx_processor/validators/phone.py`
- [Output workbook](https://github.com/wwwoper/easy_label/blob/develop/xlsx_processor/main.py): `xlsx_processor/main.py`

### Other components

- **Desktop user**

## Connections

- Desktop user → File GUI: selects file (evidence: `README.md`)
- File GUI → Processing worker: starts worker (evidence: `xlsx_processor/main.py`)
- Processing worker → XLSX workflow: runs processing (evidence: `xlsx_processor/main.py`)
- XLSX workflow → Runtime config: loads settings (evidence: `xlsx_processor/main.py`)
- XLSX workflow → XLSX parser: parses workbook (evidence: `xlsx_processor/main.py`)
- XLSX parser → Order models: creates orders (evidence: `xlsx_processor/core/parser.py`)
- XLSX workflow → Delivery dispatcher: dispatches orders (evidence: `xlsx_processor/main.py`)
- Delivery dispatcher → Postal processing: processes postal (evidence: `xlsx_processor/processors/__init__.py`)
- Delivery dispatcher → Pickup processing: processes pickup (evidence: `xlsx_processor/processors/__init__.py`)
- Delivery dispatcher → Marketplace processing: processes marketplace (evidence: `xlsx_processor/processors/__init__.py`)
- Delivery dispatcher → Order models: uses order types (evidence: `xlsx_processor/processors/__init__.py`)
- Postal processing → Strategy contract: implements (evidence: `xlsx_processor/processors/strategies/postal.py`)
- Pickup processing → Strategy contract: implements (evidence: `xlsx_processor/processors/strategies/pickup.py`)
- Postal processing → Postal code check: checks postal code (evidence: `xlsx_processor/processors/strategies/postal.py`)
- Postal processing → Phone check: checks phone (evidence: `xlsx_processor/processors/strategies/postal.py`)
- Marketplace processing → Phone check: checks phone (evidence: `xlsx_processor/processors/strategies/ozon_yandex_wb.py`)
- Postal code check → Validator contract: implements (evidence: `xlsx_processor/validators/number.py`)
- Phone check → Validator contract: implements (evidence: `xlsx_processor/validators/phone.py`)
- XLSX workflow → Output workbook: writes sheets (evidence: `xlsx_processor/main.py`)
- XLSX workflow → Processing logs: logs processing (evidence: `xlsx_processor/main.py`)
