# Changelog

Alle wichtigen Änderungen an dieser Extension werden in dieser Datei dokumentiert.

Das Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.0.0/),
und dieses Projekt folgt [Semantic Versioning](https://semver.org/lang/de/).


## [1.5.0] - 2026-08-23

### Geändert

- **Composer-Paketname von `storetown/module-tax-sync` auf
  `storetown-media/module-tax-sync` geändert.** Damit tragen alle Storetown-Media-Module
  denselben Vendor-Namespace. Der alte Name ist über `replace` hinterlegt: Composer erkennt
  beide als dasselbe Paket, eine versehentliche Doppelinstallation ist ausgeschlossen.
- Das feste `version`-Feld wurde aus der `composer.json` entfernt; maßgeblich ist der Git-Tag.

### Unverändert

- PHP-Namespace `Storetown\TaxSync\` und Magento-Modulname `Storetown_TaxSync` bleiben,
  damit bestehende Installationen nicht brechen. Es ändert sich ausschließlich der Name,
  unter dem Composer das Paket bezieht.

### Umstieg

```bash
composer remove storetown/module-tax-sync
composer require storetown-media/module-tax-sync
```

## [1.4.2] - 2026-06-17

### Behoben

- **PHP 8.4-Kompatibilität.** Die implizit-nullable Konstruktor-Parameter in `Model/Config/Backend/CronFrequency.php` (`$resource`, `$resourceCollection`) sind jetzt explizit als nullable typisiert (`?AbstractResource` bzw. `?AbstractDb`). Behebt die Meldung *„Deprecated: Implicitly marking parameter as nullable"*, die unter **PHP 8.4** `bin/magento setup:di:compile` (und damit den Produktiv-Deploy) abbrechen ließ.

## [1.4.1] - 2026-06-16

### Behoben

- **Admin „Letzte Synchronisierung" zeigte ein falsches Datum** (z. B. 17.12.2021) und schien sich nach „Jetzt synchronisieren" nicht zu ändern. Ursache: Der Anzeige-Block reichte den gespeicherten `Y-m-d H:i:s`-UTC-Zeitstempel an `TimezoneInterface::date()` weiter — das parst Strings über das SHORT-Format der Locale und verwürfelt ISO-Datumswerte (falsches Datum, fehlende Sekunden). Der Zeitstempel wurde stets **korrekt gespeichert**, nur die Darstellung war defekt; der Sync (CLI wie Admin-Button) funktionierte. Fix: expliziter Parse als UTC + Umrechnung in die Shop-Zeitzone in `Block/Adminhtml/System/Config/LastSync.php`.

---

## [1.4.0] - 2026-06-16

### Behoben

- **CRITICAL: Veraltete Datenquelle.** Die bisherige Primärquelle `euvatrates.com` wird seit 2016 nicht mehr gepflegt (`"last_updated":"2016-01-01"`) und liefert falsche Standardsätze (z. B. Rumänien 20 % statt aktuell 21 %). Da der Endpunkt weiterhin mit HTTP 200 und gültigem JSON antwortet, wurde er von der Verfügbarkeitsprüfung fälschlich als „erreichbar" eingestuft — der Fallback griff nie. `EuVatRates` ist jetzt dauerhaft als nicht verfügbar markiert und wird nicht mehr ausgewählt.

### Hinzugefügt

- **`Model/Api/VatApiEu.php` — neue, gepflegte Primärquelle [vat-api.eu](https://vat-api.eu/)** (kostenlos, ohne API-Key). Liefert aktuelle Standardsätze für alle 27 EU-Mitgliedstaaten und ist neuer Standard (`tax_sync/general/api_source = vatapieu`).
- **`Model/Data/EuVatReducedRates.php`** — kuratierte Map der ermäßigten Sätze (Hauptsatz pro Land) als einzige Quelle der Wahrheit, gemeinsam genutzt von `VatApiEu` und `Fallback` (kein Drift mehr zwischen Live-Quelle und Fallback).
- **`Model/Data/NonEuVatRates.php`** — geteilte statische Sätze für CH/GB/NO. Da vat-api.eu nur die 27 EU-Staaten liefert, ergänzt die Live-Quelle diese Länder, sodass „Nicht-EU-Länder einbeziehen" jetzt auch mit der Live-Quelle funktioniert (zuvor wurden CH/NO über die Live-Quelle nie synchronisiert).
- Strukturprüfung in `VatApiEu`: Antworten mit weniger als 20 verwertbaren Ländern werden abgelehnt (Schutz gegen degradierte, aber HTTP-200-antwortende API).

### Geändert

- **Hybrider Datenansatz:** Der **Standardsatz** wird live aus vat-api.eu gezogen (rechtlich kritisch, häufig geändert, zuverlässig); der **ermäßigte Satz** kommt aus der kuratierten Map. Hintergrund: Länder haben mehrere ermäßigte Sätze (super-reduziert/ermäßigt/Park) ohne maschinenlesbaren Typ, und vat-api.eu enthält bei ermäßigten Sätzen vereinzelt Fehler (z. B. FI 13,5 % statt 14 %).
- **Aktualisierte statische Fallback-Daten (Stand Juni 2026):** Estland Standard 22 % → 24 % (seit 2025-07-01); Rumänien Standard 19 % → 21 % und ermäßigt 9 % → 11 % (seit 2025-08-01); Slowakei ermäßigt 10 % → 5 % (alter 10 %-Satz 2025 abgeschafft).
- `Model/Config/Source/ApiSource.php` — Dropdown: „VAT-API.eu (Empfohlen)" als erste Option; `euvatrates` als „(Veraltet – Daten von 2016)" gekennzeichnet.
- `etc/csp_whitelist.xml` — CSP-Whitelist-Host von `euvatrates.com` auf `vat-api.eu` umgestellt.

### Hinweis zum Update

- Bestehende Installationen mit gespeicherter Quelle `euvatrates` wechseln automatisch auf vat-api.eu (die alte Quelle ist nicht mehr wählbar/verfügbar). Kein Setup-Upgrade nötig — nach Composer-Update genügt `bin/magento setup:di:compile` und `cache:flush`.

---

## [1.3.1] - 2026-06-09

### Behoben

- **Magento 2.4.7 / 2.4.8 Kompatibilität:** Composer-Constraint `magento/module-email: ^101.2` auf `^101.1` korrigiert. Version `101.2` existiert in keinem Magento-2.4.x-Release (höchste ist `101.1.x`), wodurch `composer require storetown/module-tax-sync` mit „could not be resolved" fehlschlug. Betraf alle bisherigen Releases (1.1.0–1.3.0).

---

## [1.3.0] - 2026-05-14

### Geändert

- **Erstes öffentliches Open-Source-Release auf GitHub** unter MIT-Lizenz
- **Distribution via Packagist** — `composer require storetown/module-tax-sync` ohne Custom-Repository möglich

### Entfernt (für OSS-Release)

- `stm/module-license` Dependency aus `composer.json` — Extension läuft jetzt ohne Lizenz-Check, voll funktional für alle User
- `STM_License`-Sequence aus `etc/module.xml`
- `STM\License\Model\ExtensionRegistry`-Block aus `etc/di.xml`
- `LicenseServiceInterface`-Import + Constructor-Injection + License-Check in `Model/TaxSyncService.php`

### Hinzugefügt (OSS-Hygiene)

- `.github/ISSUE_TEMPLATE/bug_report.md` — strukturiertes Bug-Report-Template
- `.github/ISSUE_TEMPLATE/feature_request.md` — Feature-Request-Template
- `SECURITY.md` — Security-Policy mit responsible-disclosure-Workflow
- `CONTRIBUTING.md` — Contributor-Guide (PSR-12, Magento-2-Standards, Conventional Commits)
- `composer.json` — `support.issues`, `support.source`, `support.docs` aktualisiert auf den neuen GitHub-Repo
- README erweitert um Cross-Linking zu den 4 kommerziellen Schwester-Extensions

---

## [1.2.0] - 2026-03-09

### Hinzugefügt

- STM License Integration — Lizenzprüfung über `stm/module-license` Modul
- `di.xml` — Extension-Registrierung bei `STM\License\Model\ExtensionRegistry` (Key: `storetown_taxsync`)

### Geändert

- `composer.json` — Dependency `stm/module-license: ^1.0` hinzugefügt
- `module.xml` — `STM_License` in Modul-Sequence aufgenommen

---

## [1.1.0] - 2026-03-07

### Behoben

- **CRITICAL:** Cron-Job lief nie — Backend Model `CronFrequency` erstellt, das Frequenz-Auswahl in Cron-Expression schreibt
- **HIGH:** `ApiSourcePool` konnte bei fehlendem Fallback crashen — Defensive Prüfung mit `LocalizedException` hinzugefügt
- **HIGH:** `TaxSyncService::getLastSyncDate()` versuchte auf geschütztes `scopeConfig`-Property zuzugreifen — Methode in `Config` Helper verlagert
- **HIGH:** Generische Exceptions durch `LocalizedException` ersetzt
- **HIGH:** Concurrency-Schutz via `LockManagerInterface` im Sync-Prozess
- **HIGH:** Fehlendes `lockManager`-Argument in `di.xml` ergänzt
- **HIGH:** `<e>` Tag in `StatusCommand` durch `<error>` ersetzt (Symfony Console 6.x Kompatibilität)
- **MEDIUM:** Modul-Versionanzeige in Info-Block nutzt jetzt `PackageInfo` statt veraltetes `setup_version`
- **MEDIUM:** Hardcoded German Strings in `NotificationService` durch `__()` Aufrufe ersetzt (i18n-fähig)

### Hinzugefügt

- `Model/Config/Backend/CronFrequency.php` — Backend Model für Cron-Frequenz-Konfiguration
- `view/adminhtml/email/sync_error.html` — Fehler-Benachrichtigungs-E-Mail-Template
- `etc/csp_whitelist.xml` — CSP-Whitelist für euvatrates.com API-Aufrufe
- `i18n/de_DE.csv` — Deutsche Übersetzungen (34 Strings)
- `phpunit.xml.dist` — PHPUnit Konfiguration
- 9 PHPUnit Test-Dateien mit 82 Tests und 471 Assertions
- Copyright-Header auf allen PHP-Dateien
- PHPCS Magento2 Coding Standard — vollständig compliant (0 Errors, 0 Warnings)

### Geändert

- `module.xml` — `setup_version` entfernt (Magento 2.4+ Best Practice), Sequence-Dependencies erweitert
- `composer.json` — `magento/module-cron` Dependency hinzugefügt, Version-Constraints auf `^` (Caret) umgestellt
- `config.xml` — Standard Cron-Schedule `0 3 * * 1` (Montag 3:00 Uhr) als Default hinzugefügt
- Code-Qualität: Alle Dateien auf PHPCS Magento2 Standard geprüft und angepasst

---

## [1.0.3] - 2026-01-22

### Hinzugefügt

- `NotificationService` — Zentrale Klasse für E-Mail- und Admin-Benachrichtigungen
- E-Mail-Template `rate_changed.html` für Steuersatz-Änderungen
- Admin-Notification über `Magento\AdminNotification\Model\Inbox` bei Änderungen
- Konfigurationsoptionen für Benachrichtigungen unter `tax_sync/notifications/`
- `email_templates.xml` — Template-Registrierung für Transaktions-E-Mails

### Geändert

- `TaxSyncService::sync()` ruft jetzt `NotificationService` nach erfolgreicher Synchronisierung auf
- `di.xml` — `NotificationService` als Dependency für `TaxSyncService` ergänzt
- Admin-Konfiguration um Benachrichtigungs-Tab erweitert (`system.xml`)

### Behoben

- Rate-Vergleich nutzt jetzt Toleranz `abs($old - $new) > 0.001` statt striktem `!=` (Float-Precision)
- Sync-Ergebnis enthält jetzt detailliertes `changes`-Array mit altem und neuem Steuersatz

---

## [1.0.2] - 2025-12-12

### Hinzugefügt

- `Block/Adminhtml/System/Config/SyncButton.php` — Manueller Sync-Button in Admin-Konfiguration
- `Block/Adminhtml/System/Config/LastSync.php` — Anzeige des letzten Sync-Zeitpunkts
- `Block/Adminhtml/System/Config/Info.php` — Modul-Infoanzeige mit Version und Status
- `Controller/Adminhtml/Sync/Run.php` — AJAX-Controller für manuellen Sync aus Admin
- `etc/adminhtml/routes.xml` — Admin-Routen für Sync-Controller
- `etc/acl.xml` — ACL-Ressource `Storetown_TaxSync::config` für Zugriffskontrolle
- Admin-Konfiguration um Sync-Tab mit Buttons und Status-Anzeige erweitert

### Geändert

- `system.xml` — Komplette Überarbeitung der Admin-Oberfläche mit drei Tabs (Allgemein, Tax Rules, Sync)
- `Config` Helper um `getLastSyncDate()` erweitert
- `TaxSyncService::sync()` speichert jetzt Timestamp des letzten Syncs in Core-Config

### Behoben

- Country-Filter: API-Daten werden jetzt korrekt gegen konfigurierte Länderliste gefiltert
- Reduced-Rate wird nur importiert wenn > 0 (verhindert leere 0%-Steuersätze)

---

## [1.0.1] - 2025-11-18

### Hinzugefügt

- `Model/Api/VatComply.php` — Alternative API-Quelle (vatcomply.com) als zweite Datenquelle
- `Model/ApiSourcePool.php` — Source-Pool-Pattern für flexible API-Quellen-Verwaltung
- `Api/TaxRateSourceInterface.php` — Interface für austauschbare API-Quellen
- `Model/Config/Source/ApiSource.php` — Dropdown für API-Quellen-Auswahl in Admin
- Konfigurationsoption `tax_sync/general/api_source` zur Auswahl der Datenquelle
- Automatischer Fallback: Wenn primäre API nicht erreichbar, wird nächste Quelle probiert
- `StatusCommand` — CLI-Befehl `tax:sync:status` zeigt aktuellen Sync-Status und Konfiguration
- `Logger/Logger.php` und `Logger/Handler.php` — Dediziertes Logging nach `var/log/tax_sync.log`

### Geändert

- `TaxSyncService` refactored — API-Aufruf über `ApiSourcePool` statt direktem HTTP-Client
- `di.xml` — Source-Pool mit konfigurierbarer Quellen-Liste
- `system.xml` — API-Quellen-Auswahl im Admin hinzugefügt
- Logging von `Psr\Log\LoggerInterface` auf dedizierten `TaxSync\Logger\Logger` umgestellt

### Behoben

- Tax Rate Code-Format vereinheitlicht: `{COUNTRY}-Standard` / `{COUNTRY}-Reduced` (vorher inkonsistent)
- Fehlerbehandlung bei API-Timeouts: Exception wird geloggt statt Abbruch

---

## [1.0.0] - 2025-02-03

### Hinzugefügt

- Erster Release
- Import aller 27 EU-Länder Steuersätze (Standard + ermäßigt)
- Optionaler Import von CH, GB, NO (Nicht-EU-Länder)
- Automatische Tax Rule Erstellung pro Land mit konfigurierbaren Customer/Product Tax Classes
- Cron-basierte Synchronisierung (täglich/wöchentlich/monatlich wählbar)
- CLI-Befehl `tax:sync:run` für manuellen Sync mit `--force` Option
- EU VAT Rates API (euvatrates.com) als primäre Datenquelle
- `Model/Api/Fallback.php` — Statische Fallback-Daten (Stand Januar 2025)
- Vollständige Admin-Konfiguration unter Stores > Configuration > Storetown > Tax Sync
- `Helper/Config.php` — Zentrale Konfigurationsverwaltung mit allen Getter-Methoden
- `Model/TaxSyncService.php` — Kern-Service für Steuersatz-Synchronisierung
- `Cron/SyncTaxRates.php` — Cron-Handler für automatische Ausführung
- `Model/Config/Source/Frequency.php` — Frequenz-Options für Admin-Dropdown

### Datenquellen

- **Primär:** EU VAT Rates API (euvatrates.com)
- **Fallback:** Statische Daten, manuell gepflegt

### Unterstützte Magento-Versionen

- Magento 2.4.x
- PHP 8.1+

---

## Support

Bei Fragen oder Problemen kontaktieren Sie uns:

- moin@storetown-media.de
- www.storetown-media.de