Merge develop for 1.22.0 release

# Conflicts:
#	CHANGELOG.md
#	README.md
#	RELEASE.md
#	shopify-sync/CHANGELOG.md
#	shopify-sync/shopify_sync.py
#	shopify-sync/sync_version.py
#	tests/test_shopify_sync_logging.py

Author: xoquox

.gitignore

@@ -10,14 +10,18 @@ lagerverwaltung.log
 logs/
 settings.local.json
 gls/*.pdf
+gls/
 exports/
 gls/*.txt
 gls/*.env
 gls/*credentials*
 post/*.env
 post/*credentials*
+post/labels/
 lieferschein_*.pdf
 delivery_note_template.pdf
 local_only/
 webspace/
 fonts/
+.codex
+.codex/

CHANGELOG.md

@@ -4,6 +4,31 @@ Nur Releases auf `main`. Entwicklungszwischenstaende werden ueber Git-Branches u
 Release-Eintraege nennen die zugehoerige Shopify-Sync-Version und verweisen auf
 [shopify-sync/CHANGELOG.md](/home/chrisi/Lagerverwaltung/shopify-sync/CHANGELOG.md).
 
+## [1.22.0] - in Vorbereitung
+
+Zugehoeriger Shopify-Sync-Release: `1.0.0`
+
+### Added
+- Versand mit Deutsche Post INTERNETMARKE einschliesslich Produktkatalog, Produktauswahl und Labelerzeugung.
+- Carrier `Adresslabel` fuer reine Adresslabels ohne Sendungsnummer und ohne Shopify-Fulfillment.
+- Lokales Bundle fuer private Dateien und portable Einstellungen mit Import auf neuen Arbeitsplaetzen.
+- Bedienungsanleitung und Versanddoku in deutscher und englischer Sprache.
+
+### Changed
+- Versandablaeufe fuer Einzel-Label, Bulk, Teilausfuehrung und manuelle Labels vereinheitlicht.
+- Carrier-Auswahl, Carrier-Settings und Versandhistory sind generisch fuer mehrere Versanddienstleister organisiert.
+- Bulk-Druck fasst Labels und Lieferscheine je Lauf zu einer gemeinsamen Datei zusammen.
+- Versand- und Lieferscheinordner koennen ueber die Einstellungen ausgewaehlt werden; Standardpfade liegen unter `~/Dokumente/Lagerverwaltung/`.
+- Hauptansicht und Auftragsansicht arbeiten mit lokalen Snapshots fuer schnellere Bedienung bei langsamer Datenbankverbindung.
+- README auf Projektueberblick reduziert und auf Handbuch, Versanddoku und Releases ausgerichtet.
+
+### Fixed
+- Sync-Version und Laufzeitstatus werden zentral gespeichert und in der TUI angezeigt.
+- Shopify-Fulfillment uebertraegt Carrier, Trackingnummer und bei Bedarf Tracking-URL carrierabhaengig.
+- Shopify-Kundendaten stehen fuer manuelle Versandlabels lokal zur Auswahl bereit.
+- Start und Laufzeit bei nicht erreichbarer Datenbank werden mit einem einheitlichen Dialog abgefangen.
+- Versandhistory verwendet durchgaengig die Tabelle `shipping_labels`.
+
 ## [1.20.028] - 2026-03-24
 
 ### Fixed

README.en.md

@@ -0,0 +1,43 @@
+<p align="center">
+  <img src="assets/lager-mc.svg" alt="Lager MC" width="160">
+</p>
+
+# Lagerverwaltung
+
+Terminal-based inventory management with storage locations, order handling, stocktaking, Shopify integration and shipping workflows.
+
+License: [MIT](/home/chrisi/Lagerverwaltung/LICENSE)
+
+## Core features
+
+- maintain items, storage locations and stock quantities
+- import and process Shopify orders
+- create pick lists, delivery notes and shipping labels
+- shipping with GLS, Deutsche Post INTERNETMARKE and address labels
+- partial execution, bulk execution and shipping history
+- stocktaking with snapshots, CSV export and apply step
+- local bundle files for new workstations
+
+## Current shipping state
+
+Implemented carrier integrations:
+
+- `GLS`
+- `Deutsche Post INTERNETMARKE`
+
+Also available:
+
+- `Address label` for internal labels without a carrier API
+
+The carrier structure uses central carrier definitions with shared shipping history and Shopify handover.
+
+## Documentation
+
+- User manual: [docs/bedienungsanleitung.en.md](/home/chrisi/Lagerverwaltung/docs/bedienungsanleitung.en.md)
+- Shipping integration notes: [docs/shipping-providers.en.md](/home/chrisi/Lagerverwaltung/docs/shipping-providers.en.md)
+- Release history: [CHANGELOG.md](/home/chrisi/Lagerverwaltung/CHANGELOG.md)
+- GitHub Releases: <https://github.com/xoquox/Lagerverwaltung/releases>
+
+## Repository variants
+
+- Fork with the core inventory features without Shopify integration and shipping: [simple-storage-core](https://github.com/b4ckspace/simple-storage-core)

README.md

@@ -4,257 +4,43 @@
 
 # Lagerverwaltung
 
-Terminalbasierte Lagerverwaltung fuer kleine bis mittlere Teilelager mit Shopify-Anbindung, Lagerplatzlogik, Picklisten, Lieferscheinen, Inventur und Labeldruck.
+Terminalbasierte Lagerverwaltung mit Lagerplatzpflege, Bestellansicht, Inventur, Shopify-Anbindung und Versandabwicklung.
 
 Lizenz: [MIT](/home/chrisi/Lagerverwaltung/LICENSE)
 
-## Funktionen
+## Kernfunktionen
 
-- Artikel suchen, bearbeiten und lokal anlegen
-- Lagerplaetze nach `Regal / Fach / Platz` pflegen
-- Bestellungen aus Shopify synchronisieren
-- Zahlungs- und Fulfillment-Status im Auftragsfenster anzeigen
-- Picklisten per Drucker drucken
-- Lieferscheine als PDF erzeugen oder per Drucker drucken
-- Brother-QL-Etiketten drucken
-- Inventur starten, zaehlen, exportieren und uebernehmen
-- extern gelagerte Fulfillment-Artikel ausblenden
+- Artikel, Lagerplaetze und Bestandsmengen pflegen
+- Bestellungen aus Shopify einlesen und im Auftragsfenster bearbeiten
+- Picklisten, Lieferscheine und Versandlabels erzeugen
+- Versand mit GLS, Deutsche Post INTERNETMARKE und Adresslabels
+- Teilausfuehrung, Bulk-Ausfuehrung und Versandhistory
+- Inventur mit Snapshot, CSV-Export und Uebernahme
+- lokale Bundle-Dateien fuer neue Arbeitsplaetze
 
-## Projektstruktur
+## Aktueller Versandstand
 
-- [lager_mc.py](/home/chrisi/Lagerverwaltung/lager_mc.py)
-  Hauptanwendung fuer Lager, Bestellungen und Inventur.
-- [label_print.py](/home/chrisi/Lagerverwaltung/label_print.py)
-  Etikettendruck fuer Brother-QL-Drucker.
-- [delivery_note.py](/home/chrisi/Lagerverwaltung/delivery_note.py)
-  PDF-Erzeugung fuer Lieferscheine auf Basis der Vorlage.
-- [app_settings.py](/home/chrisi/Lagerverwaltung/app_settings.py)
-  Laedt Projekt-Defaults und lokale Overrides.
-- [app_version.py](/home/chrisi/Lagerverwaltung/app_version.py)
-  Zentrale Versionsdefinition fuer Release- und Entwicklungsstaende.
-- [settings.json](/home/chrisi/Lagerverwaltung/settings.json)
-  Versionierte Standardkonfiguration des Projekts.
-- [CHANGELOG.md](/home/chrisi/Lagerverwaltung/CHANGELOG.md)
-  Release-Historie fuer Stande auf `main`.
-- [RELEASE.md](/home/chrisi/Lagerverwaltung/RELEASE.md)
-  Branching-, Release- und Changelog-Regeln.
-- [shopify-sync/shopify_sync.py](/home/chrisi/Lagerverwaltung/shopify-sync/shopify_sync.py)
-  Separater Shopify-Sync fuer Produkte, Bestand und Bestellungen.
-- [shopify-sync/sync_version.py](/home/chrisi/Lagerverwaltung/shopify-sync/sync_version.py)
-  Eigene Versionsquelle fuer den separaten Shopify-Sync.
-- [shopify-sync/CHANGELOG.md](/home/chrisi/Lagerverwaltung/shopify-sync/CHANGELOG.md)
-  Release-Historie nur fuer den Shopify-Sync.
-- [post/internetmarke_client.py](/home/chrisi/Lagerverwaltung/post/internetmarke_client.py)
-  Vorbereitung fuer Deutsche Post INTERNETMARKE.
+Produktive Carrier-Integrationen:
 
-## Voraussetzungen
+- `GLS`
+- `Deutsche Post INTERNETMARKE`
 
-- Python 3.11+
-- PostgreSQL
-- `curses`
-- fuer Labeldruck: `Pillow`, `python-barcode`, `brother_ql`
-- fuer Listen-/Lieferschein-Druck: Drucksystem mit `lp`
-- fuer HTML/CSS-Lieferscheine: `WeasyPrint` (inkl. Systembibliotheken wie cairo/pango)
+Zusaetzlich vorhanden:
 
-Die Anwendung erweitert benoetigte Datenbankspalten und legt die Tabellen fuer Bestellungen und Inventur bei Bedarf selbst an.
+- `Adresslabel` fuer interne Labels ohne Carrier-API
 
-## Konfiguration
+Die Carrier-Struktur verwendet zentrale Carrier-Definitionen mit gemeinsamer Versandhistory und Shopify-Anbindung.
 
-Es gibt zwei Ebenen:
+## Dokumentation
 
-- [settings.json](/home/chrisi/Lagerverwaltung/settings.json)
-  versionierte Projekt-Defaults
-- `settings.local.json`
-  lokale, nicht versionierte Laufzeitwerte
+- Bedienungsanleitung: [docs/bedienungsanleitung.md](/home/chrisi/Lagerverwaltung/docs/bedienungsanleitung.md)
+- Versand-Integrationsdoku: [docs/versanddienstleister.md](/home/chrisi/Lagerverwaltung/docs/versanddienstleister.md)
+- English README: [README.en.md](/home/chrisi/Lagerverwaltung/README.en.md)
+- English user manual: [docs/bedienungsanleitung.en.md](/home/chrisi/Lagerverwaltung/docs/bedienungsanleitung.en.md)
+- English shipping integration notes: [docs/shipping-providers.en.md](/home/chrisi/Lagerverwaltung/docs/shipping-providers.en.md)
+- Release-Historie: [CHANGELOG.md](/home/chrisi/Lagerverwaltung/CHANGELOG.md)
+- GitHub Releases: <https://github.com/xoquox/Lagerverwaltung/releases>
 
+## Varianten
 
-Wichtige Einstellungen:
-
-- `db_host`, `db_name`, `db_user`, `db_pass`
-- `language` (`de` oder `en`)
-- `color_theme` (`blue`, `green`, `mono`, `megatrends`, `smoth`, `norton`, `gold-standard`, `subtile`, `monokai`)
-- `color_theme_file` (optional, Pfad zu eigener JSON-Datei mit Themes)
-- `printer_uri`, `printer_model`, `label_size`
-- `label_font_regular`, `label_font_condensed` (optional, lokale TrueType/OpenType Fonts fuer Labeldruck)
-- `location_regex_regal`, `location_regex_fach`, `location_regex_platz`
-- `picklist_printer`
-- `delivery_note_printer`
-- `pdf_output_dir`
-- `delivery_note_template_path` (optional, lokaler Pfad zur PDF-Vorlage ausserhalb von Git)
-- `delivery_note_logo_source` (optional, lokaler Pfad oder `https://`-URL fuer das Logo)
-- `delivery_note_sender_name`
-- `delivery_note_sender_street`
-- `delivery_note_sender_city`
-- `delivery_note_sender_email`
-- `shipping_carrier`
-- `shipping_label_printer_gls`, `shipping_label_printer_dhl`, `shipping_label_printer_post`
-- `shipping_label_format_gls`, `shipping_label_format_dhl`, `shipping_label_format_post`
-- `shipping_label_printer`, `shipping_label_format` (Fallback/Legacy)
-- `shipping_services`, `shipping_packaging_weight_grams`
-- `gls_api_url`, `gls_user`, `gls_password`, `gls_contact_id`
-- `post_api_url`, `post_user`, `post_password`, `post_partner_id`
-
-## Entwicklung und Releases
-
-- `main` bleibt produktiv und enthaelt nur getestete Releases.
-- `develop` ist der Integrationsbranch fuer neue Arbeit.
-- Neue Aufgaben starten in `feature/*` und werden erst nach `develop`, dann nach `main` uebernommen.
-- `CHANGELOG.md` wird nur beim Merge eines fertigen Stands nach `main` ergaenzt.
-- `app_version.py` fuehrt die sichtbare Versionsnummer:
-  - Release auf `main`: z. B. `1.21.0`
-  - Entwicklungsstand auf `develop`: z. B. `1.21.0-dev`
-- Der Shopify-Sync hat zusaetzlich eine eigene Versionsquelle in [sync_version.py](/home/chrisi/Lagerverwaltung/shopify-sync/sync_version.py)
-  und ein eigenes Sync-Changelog in [shopify-sync/CHANGELOG.md](/home/chrisi/Lagerverwaltung/shopify-sync/CHANGELOG.md).
-- Release-Eintraege in [CHANGELOG.md](/home/chrisi/Lagerverwaltung/CHANGELOG.md) enthalten die zugehoerige Sync-Version
-  und verweisen auf das separate Sync-Changelog.
-
-## Shopify-Sync
-
-Der Sync laeuft getrennt von der TUI und kann direkt oder im Container gestartet werden.
-Er hat eine eigene Versionierung und ein eigenes Changelog:
-
-- [shopify-sync/sync_version.py](/home/chrisi/Lagerverwaltung/shopify-sync/sync_version.py)
-- [shopify-sync/CHANGELOG.md](/home/chrisi/Lagerverwaltung/shopify-sync/CHANGELOG.md)
-
-Mindestens benoetigte Shopify-Scopes:
-
-- `read_products`
-- `read_inventory`
-- `write_inventory`
-- `read_locations`
-- `read_orders`
-
-Zusaetzlich:
-
-- `read_all_orders`
-  falls Bestellungen aelter als 60 Tage geladen werden sollen
-
-Der Sync schreibt unter anderem:
-
-- Bestellungen und Positionen
-- Fulfillment-Status
-- Zahlungsstatus
-
-Version der laufenden Sync-Instanz abfragen:
-
-```bash
-python3 shopify-sync/shopify_sync.py --version
-python3 shopify-sync/shopify_sync.py version --json
-```
-
-Im Docker-Container typischerweise:
-
-```bash
-docker exec -it shopify-sync python /app/shopify_sync.py --version
-docker exec -it shopify-sync python /app/shopify_sync.py version --json
-```
-
-Die JSON-Ausgabe liefert Service, Version und Zeitstempel der laufenden Sync-Instanz.
-
-## Installation
-
-Automatische Installation fuer die meisten Linux-Distributionen:
-
-```bash
-git clone <repo-url>
-cd Lagerverwaltung
-./scripts/install-linux.sh
-```
-
-Das Script erkennt `dnf`, `apt`, `pacman` oder `zypper` automatisch, installiert Systempakete, erstellt `.venv` und legt einen Starter unter `~/.local/bin/lager-mc` an.
-
-Manueller Start ohne Install-Script:
-
-```bash
-git clone <repo-url>
-cd Lagerverwaltung
-python3 -m py_compile lager_mc.py
-python3 lager_mc.py
-```
-
-Falls Pakete fehlen:
-
-```bash
-pip install psycopg2-binary pillow python-barcode brother_ql requests python-dotenv
-```
-
-## Druck
-
-### Labeldruck
-
-Etiketten werden ueber [label_print.py](/home/chrisi/Lagerverwaltung/label_print.py) erzeugt. Unterstuetzt werden Brother-QL-Netzwerkdrucker.
-
-Wenn gewuenscht, koennen benutzerdefinierte lokale Fontdateien in den Einstellungen gesetzt werden:
-
-```json
-{
-  "label_font_regular": "/pfad/zu/deinem/font-regular.ttf",
-  "label_font_condensed": "/pfad/zu/deinem/font-condensed.ttf"
-}
-```
-
-### Picklisten
-
-Picklisten werden textbasiert ueber den in den Einstellungen hinterlegten Drucker gesendet.
-
-### Lieferscheine
-
-Lieferscheine werden standardmaessig ueber HTML/CSS mit WeasyPrint erzeugt.
-`delivery_note_template_path` kann optional auf eine `.html`/`.htm`-Datei zeigen, um das Layout frei anzupassen.
-Wenn stattdessen eine `.pdf`-Vorlage hinterlegt wird, nutzt die Anwendung den Legacy-PDF-Renderer.
-
-Beispiel (`settings.local.json`):
-
-```json
-{
-  "delivery_note_template_path": "/home/<user>/Dokumente/lager/lieferschein_template.html",
-  "delivery_note_logo_source": "https://example.com/logo.png"
-}
-```
-
-Unterstuetzt werden:
-
-- PDF-Export
-- getrennten Drucker
-- mehrseitige Ausgabe
-- Seitennummerierung
-
-## Logging
-
-Rotierende Logdateien liegen unter [logs](/home/chrisi/Lagerverwaltung/logs):
-
-- [logs/lagerverwaltung.log](/home/chrisi/Lagerverwaltung/logs/lagerverwaltung.log)
-- [logs/druck.log](/home/chrisi/Lagerverwaltung/logs/druck.log)
-
-Beispiel:
-
-```bash
-export LAGERVERWALTUNG_LOG_LEVEL=DEBUG
-```
-
-## Tests
-
-```bash
-python3 -m unittest discover -s tests -v
-```
-- In den Einstellungen koennen `language` und `color_theme` ueber eine Auswahl (F4) gewaehlt werden, ohne Werte manuell zu tippen.
-
-Beispiel fuer eigene Themes (`color_theme_file`):
-
-```json
-{
-  "themes": {
-    "my-blue": {
-      "pair_1_fg": "white",
-      "pair_1_bg": "blue",
-      "pair_2_fg": "black",
-      "pair_2_bg": "cyan",
-      "pair_3_fg": "white",
-      "pair_3_bg": "black"
-    }
-  }
-}
-```
-
-Erlaubte Farbnamen: `black`, `red`, `green`, `brown`, `yellow`, `blue`, `magenta`, `cyan`, `white`,
-`brightblack`, `brightred`, `brightgreen`, `brightyellow`, `brightblue`, `brightmagenta`, `brightcyan`, `brightwhite`.
+- Fork mit den Kernfunktionen fuer Lagerverwaltung ohne Shopify-Integration und Versand: [simple-storage-core](https://github.com/b4ckspace/simple-storage-core)