Pac 973

AGENTS.md

@@ -0,0 +1,142 @@
+# AGENTS.md - import-attribute
+
+## Zweck & Verantwortung
+
+Das `import-attribute` Modul bietet **Attribute Import-Funktionalität** für das Pacemaker Import-System. Es ist ein **Tier 4 Modul** und dient als Basis für Attribute-bezogene Importer.
+
+**Hauptverantwortung:**
+- EAV Attribute Import
+- Attribute Options Import
+- Repository Pattern für Attribute-Persistierung
+- Service Layer für Attribute-Verarbeitung
+- Observer Pattern für Attribute-Hooks
+- 4 Dependents (attribute-set, converter-customer-attr, converter-product-attr)
+
+## Architektur & Design Patterns
+
+### Kern-Klassen
+- **AttributeRepository**: Persistierung von Attributen
+- **AttributeOptionRepository**: Persistierung von Attribute Options
+- **AttributeProcessor**: Service Layer für Attribute-Verarbeitung
+- **AttributeObserver**: Observer für Attribute-Hooks
+- **AttributeOptionObserver**: Observer für Attribute Options
+
+### Verwendete Patterns
+- **Observer Pattern**: Für Attribute-Hooks
+- **Repository Pattern**: Für Daten-Persistierung
+- **Service Layer**: Für Business Logic
+- **Factory Pattern**: Für Object-Erstellung
+
+## Abhängigkeiten
+
+### Externe Pakete
+- **Keine** - Nur Importer-Implementierungen
+
+### TechDivision Dependencies
+- **import** ^18.1 - Core Framework
+
+### Abhängig von diesem Modul (4 Reverse Dependencies)
+1. **import-attribute-set** - Attribute Set Importer
+2. **import-converter-customer-attribute** - Customer Attribute Converter
+3. **import-converter-product-attribute** - Product Attribute Converter
+4. **import-cli-simple** - Master CLI
+
+## Wichtige Entry Points
+
+### Repository Klassen
+```php
+// Attribute Repository
+AttributeRepository::create($row): void
+AttributeRepository::update($row): void
+AttributeRepository::findByCode($code): array
+
+// Attribute Option Repository
+AttributeOptionRepository::create($row): void
+AttributeOptionRepository::findByCode($code): array
+```
+
+### Observer Klassen
+```php
+// Attribute Observer
+AttributeObserver::handle($row): void
+
+// Attribute Option Observer
+AttributeOptionObserver::handle($row): void
+```
+
+## Events & Extension Points
+
+**Keine Events** - Tier 4 Importer-Modul
+
+## Hints für KI-Agenten
+
+### Wichtig zu verstehen
+1. **Tier 4 Modul**: Basis für Attribute-bezogene Importer
+2. **EAV-fokussiert**: Spezialisiert auf EAV Attribute
+3. **Observer Pattern**: Für Attribute-Hooks
+4. **Repository Pattern**: Für Daten-Persistierung
+5. **4 Dependents**: Basis für spezialisierte Importer
+
+### Bei Änderungen
+- **EAV-Kompatibilität**: Beachte EAV-Struktur
+- **Observer-Kompatibilität**: Neue Observers sollten optional sein
+- **Backward Compatibility**: Alte Imports sollten noch funktionieren
+
+### Implementierungs-Hinweise
+- Nutze Observer Pattern für Custom Attribute-Processing
+- Beachte Attribute-Optionen bei Imports
+- Erwäge Attribute-Validierung
+
+## Häufige Use Cases
+
+### CSV-Beispiel: EAV Attribute Import
+```csv
+code,label,frontend_label,attribute_type,input_type
+custom_color,Custom Color,Color,varchar,select
+custom_size,Custom Size,Size,varchar,select
+custom_brand,Brand Name,Brand,text,text
+```
+
+### Szenarien
+1. **Multi-Language Attributes**: Attribute mit Übersetzungen aus Excel
+2. **Custom Product Attributes**: Spezialisierte Attributes für Produktkategorien
+3. **Attribute-Options**: Selectable-Options wie Farben, Größen
+4. **Dropdown-Population**: Tausende von Attribute-Options
+
+## Performance-Überlegungen
+
+- **Attribute-Lookup**: Code-basierte Suche kostet ~2-5ms pro Attribute
+- **Options-Insert**: Batch-Inserts für Options sind 10x schneller als Individual
+- **EAV-Structure**: EAV speichert jedes Attribut separat - mehr Writes als Columns
+- **Optimal für**: 100-1.000 Attributes mit bis zu 10.000 Options
+- **Index-Overhead**: Attribute-Indexes benötigen ~20-30% extra Storage
+
+## Verwandte Module
+
+- **import-attribute-set**: Nutzt Attributes für Attribute-Sets
+- **import-converter-customer-attribute**: Konvertiert Customer Attributes
+- **import-converter-product-attribute**: Konvertiert Product Attributes  
+- **import-attribute** ← **diese Datei**
+
+## Troubleshooting & FAQ
+
+**Q: "Attribute code already exists" Fehler**
+- A: Attributes sind eindeutig per Code. Nutze Update-Mode statt Create, oder andere Codes.
+
+**Q: Attribute-Options werden nicht importiert**
+- A: Options müssen nach Attribute-Erstellung importiert werden. Attribute muss existieren in DB.
+
+**Q: "Unsupported attribute type" Fehler**
+- A: Nur standard Magento Types unterstützt: `varchar`, `text`, `int`, `decimal`, `static`. Custom Types nicht möglich.
+
+## Bekannte Einschränkungen
+
+- **EAV-Only**: Nur EAV Attribute unterstützt
+- **Keine Attribute-Validierung**: Validierung erfolgt in Importern
+- **Keine Attribute-Sets**: Attribute-Sets sind in `import-attribute-set`
+
+## Zusammenfassung
+
+`import-attribute` ist ein **Tier 4 Modul**, das Attribute Import-Funktionalität für das Pacemaker-System bietet. Es ist die Basis für Attribute-bezogene Importer und unterstützt EAV Attribute und Attribute Options.
+
+**Für Agenten:** Verstehe dieses Modul als **Attribute Importer** mit Observer Pattern und Repository Pattern.

CHANGELOG.md

@@ -1,3 +1,13 @@
+# Version 23.2.0
+
+## Features
+
+### PHP 8.5 Compatibility
+
+* Update dependencies
+* Remove PHP 8.2 support
+* Use the project-specific XML loader class instead of the one removed in `symfony/dependency-injection` v8
+
 # Version 23.1.0
 
 ## Features

composer.json

@@ -3,8 +3,8 @@
     "description": "Pacemaker library providing basic Magento 2 attribute import functionality",
     "license": "MIT",
     "require": {
-        "php": "^8.1",
-        "techdivision/import": "^18.1"
+        "php": "^8.3",
+        "techdivision/import": "^18.2"
     },
     "require-dev": {
         "doctrine/dbal": "^4.0.4",

src/Callbacks/OptionValueAndSwatchHandler.php

@@ -298,7 +298,7 @@ protected function prepareAttributeOption($entityTypeId, $attributeCode)
 
         // try to load the option with the highest sort order and raise it by one if available
         if ($attributeOption = $this->loadAttributeOptionByAttributeIdAndHighestSortOrder($attributeId = $attribute[MemberNames::ATTRIBUTE_ID])) {
-            $sortOrder = (integer) $attributeOption[MemberNames::SORT_ORDER] + 1;
+            $sortOrder = (int)$attributeOption[MemberNames::SORT_ORDER] + 1;
         }
 
         // return the prepared attribute option

src/Subjects/OptionSubject.php

@@ -201,7 +201,7 @@ public function castValueByBackendType($backendType, $value)
 
         // cast the value to an integer
         if ($backendType === BackendTypeKeys::BACKEND_TYPE_INT) {
-            return (integer) $value;
+            return (int)$value;
         }
 
         // we don't need to cast strings

symfony/DependencyInjection/ImportExtension.php

@@ -17,7 +17,7 @@
 use Symfony\Component\Config\FileLocator;
 use Symfony\Component\HttpKernel\DependencyInjection\Extension;
 use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
+use TechDivision\Import\DependencyInjection\Loader\XmlFileLoader;
 
 /**
  * The symfony extension implementation for the M2IF import attribute library.
@@ -30,14 +30,14 @@
  */
 class ImportExtension extends Extension
 {
-
     /**
      * Load's the bundles DI configuration.
      *
      * @param array                                                   $configs   The array with the configuration
      * @param \Symfony\Component\DependencyInjection\ContainerBuilder $container The container instance
+     * @return void
      */
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $container): void
     {
         $loader = new XmlFileLoader($container, new FileLocator(dirname(__DIR__) . '/Resources/config'));
         $loader->load('services.xml');