chore(api): fixed swagger doc for attributes

Author: tleon

src/ApiPlatform/Resources/Attribute/Attribute.php

@@ -92,6 +92,14 @@ class Attribute
     public int $attributeGroupId;
 
     #[LocalizedValue]
+    #[ApiProperty(
+        openapiContext: [
+            'type' => 'object',
+            'example' => ['en-US' => 'Value name', 'fr-FR' => 'Nom de la valeur'],
+            'description' => 'Localized attribute names indexed by locale (e.g., en-US, fr-FR). Required for creation.',
+        ]
+    )]
+    #[Assert\NotBlank(groups: ['Create'])]
     #[DefaultLanguage(groups: ['Create'], fieldName: 'names')]
     #[DefaultLanguage(groups: ['Update'], fieldName: 'names', allowNull: true)]
     #[Assert\All(constraints: [
@@ -107,6 +115,7 @@ class Attribute
     #[Assert\NotBlank(allowNull: true)]
     public array $shopIds;
 
+    #[ApiProperty(writable: false)]
     public int $position;
 
     public const QUERY_MAPPING = [
@@ -116,7 +125,7 @@ class Attribute
     ];
 
     public const CREATE_COMMAND_MAPPING = [
-        '[names]' => '[localizedValue]',
+        '[names]' => '[localizedNames]',
         '[shopIds]' => '[associatedShopIds]',
     ];