chore(api): fixed swagger doc for attributes

Author: tleon

src/ApiPlatform/Resources/Attribute/Attribute.php

@@ -85,13 +85,21 @@
 )]
 class Attribute
 {
-    #[ApiProperty(identifier: true)]
+    #[ApiProperty(identifier: true, writable: false)]
     public int $attributeId;
 
     #[ApiProperty(openapiContext: ['type' => 'integer', 'example' => 1])]
     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 = [