chore: Move the security schema for the controller to its own file

Author: matiasperrone

app/Http/Controllers/Apis/Protected/Summit/OAuth2SummitBadgesApiController.php

@@ -64,7 +64,7 @@ protected function getSummitRepository(): ISummitRepository
         path: '/api/v1/summits/{id}/badges',
         summary: 'Get all attendee badges for a summit',
         description: 'Retrieves a paginated list of attendee badges for a specific summit. Badges are issued to attendees and contain ticket information, badge type, printing details, and feature assignments (ribbons, special access indicators, etc.).',
-        security: [['Bearer' => [SummitScopes::ReadAllSummitData]]],
+        security: [['summit_badges_api_oauth2' => [SummitScopes::ReadAllSummitData]]],
         tags: ['Summit Badges'],
         parameters: [
             new OA\Parameter(
@@ -185,7 +185,7 @@ function(){
         path: '/api/v1/summits/{id}/badges/csv',
         summary: 'Export all attendee badges for a summit to CSV',
         description: 'Exports a CSV file containing all attendee badges for a specific summit. Supports the same filtering and ordering capabilities as the standard list endpoint.',
-        security: [['oauth2_security_scope' => [SummitScopes::ReadAllSummitData]]],
+        security: [['summit_badges_api_oauth2' => [SummitScopes::ReadAllSummitData]]],
         tags: ['Summit Badges'],
         parameters: [
             new OA\Parameter(

app/Swagger/Security/SummitBadgesOauth2Schema.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Swagger\schemas;
+
+use App\Security\SummitScopes;
+use OpenApi\Attributes as OA;
+
+#[OA\SecurityScheme(
+        type: 'oauth2',
+        securityScheme: 'summit_badges_api_oauth2',
+        flows: [
+            new OA\Flow(
+                authorizationUrl: L5_SWAGGER_CONST_AUTH_URL,
+                tokenUrl: L5_SWAGGER_CONST_TOKEN_URL,
+                flow: 'authorizationCode',
+                scopes: [
+                    SummitScopes::ReadAllSummitData => 'Read All Summit Data',
+                ],
+            ),
+        ],
+    )
+]
+class SummitBadgesOAuth2Schema{}