chore: include PR requested changes

Author: matiasperrone

app/Swagger/Models/SummitBadgeFeatureTypeSchema.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Swagger\schemas;
+
+use OpenApi\Attributes as OA;
+
+
+#[OA\Schema(
+    schema: 'SummitBadgeFeatureType',
+    type: 'object',
+    properties: [
+        new OA\Property(property: 'id', type: 'integer', example: 1),
+        new OA\Property(property: 'created', type: 'integer', example: 1),
+        new OA\Property(property: 'last_edited', type: 'integer', example: 1),
+        new OA\Property(property: 'name', type: 'string'),
+        new OA\Property(property: 'description', type: 'string'),
+        new OA\Property(property: 'template_content', type: 'string'),
+        new OA\Property(property: 'summit_id', type: 'integer'),
+        new OA\Property(property: 'image', type: 'string', format: 'url'),
+    ])
+]
+class SummitBadgeFeatureTypeSchema
+{
+}

app/Swagger/Models/SummitBadgeTypeSchema.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace App\Swagger\schemas;
+
+use OpenApi\Attributes as OA;
+
+
+#[OA\Schema(
+    schema: 'SummitBadgeType',
+    type: 'object',
+    properties: [
+        new OA\Property(property: 'id', type: 'integer', example: 1),
+        new OA\Property(property: 'created', type: 'integer', example: 1),
+        new OA\Property(property: 'last_edited', type: 'integer', example: 1),
+        new OA\Property(property: 'name', type: 'string'),
+        new OA\Property(property: 'description', type: 'string'),
+        new OA\Property(property: 'template_content', type: 'string'),
+        new OA\Property(property: 'is_default', type: 'boolean'),
+        new OA\Property(property: 'summit_id', type: 'integer', description: 'Summit ID, use expand=summit for full object details'),
+        new OA\Property(
+            property: 'access_levels',
+            type: 'array',
+            description: 'Array of SummitAccessLevelType IDs, use expand=access_levels for full details',
+            items: new OA\Items(type: 'integer'),
+            example: [1, 2, 3]
+        ),
+        new OA\Property(
+            property: 'badge_features',
+            type: 'array',
+            description: 'Array of SummitBadgeFeatureType IDs, use expand=badge_features for full details',
+            items: new OA\Items(type: 'integer'),
+            example: [1, 2, 3]
+        ),
+        new OA\Property(
+            property: 'allowed_view_types',
+            type: 'array',
+            description: 'Array of SummitBadgeViewType IDs, use expand=allowed_view_types for full details',
+            items: new OA\Items(type: 'integer'),
+            example: [1, 2, 3]
+        ),
+    ])
+]
+class SummitBadgeTypeSchema
+{
+}

app/Swagger/SummitSchemas.php

@@ -15,14 +15,18 @@
         new OA\Property(property: 'qr_code', type: 'string', nullable: true, example: 'QR123456789'),
         new OA\Property(property: 'is_void', type: 'boolean', example: false, description: 'Whether the badge has been voided'),
         new OA\Property(property: 'printed_times', type: 'integer', example: 2, description: 'Number of times this badge has been printed'),
-        new OA\Property(property: 'ticket_id', type: 'integer', example: 123, description: 'Ticket ID, use expand=ticket for full object details (ticket field)'),
-        new OA\Property(property: 'type_id', type: 'integer', example: 5, description: 'BadgeType ID, use expand=type for full object details (type field)'),
+        new OA\Property(property: 'ticket_id', type: 'integer', example: 123, description: 'SummitAttendeeTicket ID, use expand=ticket for full object details'),
+        new OA\Property(property: 'type_id', type: 'integer', example: 5, description: 'SummitBadgeType ID, use expand=type for full object details'),
+        new OA\Property(property: 'type', ref: '#/components/schemas/SummitBadgeType'),
         new OA\Property(property: 'print_excerpt', type: 'string', example: 'John Doe - Speaker', description: 'Short text excerpt for printing'),
         new OA\Property(
             property: 'features',
             type: 'array',
-            description: 'Array of feature IDs assigned to this badge (use expand=features for full details)',
-            items: new OA\Items(type: 'integer'),
+            description: 'Array of SummitBadgeFeatureType IDs assigned to this badge (use expand=features for full details)',
+            items: new OA\Items(oneOf: [
+                new OA\Schema(type: 'integer'),
+                new OA\Schema(ref: '#/components/schemas/SummitBadgeFeatureType'),
+            ]),
             example: [1, 2, 3]
         ),
     ],