chore: Add the correct security and x attributes and create security schema, fix path routes and change schema to be defined as requested

Author: matiasperrone

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

@@ -16,7 +16,9 @@
  **/
 use App\Http\Utils\BooleanCellFormatter;
 use App\Http\Utils\EpochCellFormatter;
+use App\Models\Foundation\Main\IGroup;
 use App\Models\Foundation\Summit\Repositories\IPresentationSpeakerSummitAssistanceConfirmationRequestRepository;
+use App\Security\SummitScopes;
 use Illuminate\Http\Response;
 use Illuminate\Support\Facades\Log;
 use Illuminate\Support\Facades\Request;
@@ -83,9 +85,13 @@ public function __construct
      */
     #[OA\Get(
         path: "/api/v1/summits/{id}/speakers-assistances",
+        operationId: 'getBySummit',
         summary: "Get all speaker assistances for a summit",
-        security: [["Bearer" => []]],
-        tags: ["summit-speakers-assistances"],
+        security: [["summit_speaker_assistances_oauth2" => [SummitScopes::ReadAllSummitData]]],
+        tags: ["Summit Speakers Assistances"],
+        x: [
+            "authz_groups" => [IGroup::SuperAdmins, IGroup::Administrators, IGroup::SummitAdministrators]
+        ],
         parameters: [
             new OA\Parameter(
                 name: "id",
@@ -227,9 +233,13 @@ public function getBySummit($summit_id)
      */
     #[OA\Get(
         path: "/api/v1/summits/{id}/speakers-assistances/csv",
+        operationId: 'getBySummitCSV',
         summary: "Export speaker assistances to CSV",
-        security: [["Bearer" => []]],
-        tags: ["summit-speakers-assistances"],
+        security: [["summit_speaker_assistances_oauth2" => [SummitScopes::ReadAllSummitData]]],
+        tags: ["Summit Speakers Assistances"],
+        x: [
+            "authz_groups" => [IGroup::SuperAdmins, IGroup::Administrators, IGroup::SummitAdministrators]
+        ],
         parameters: [
             new OA\Parameter(
                 name: "id",
@@ -340,9 +350,13 @@ public function getBySummitCSV($summit_id){
      */
     #[OA\Post(
         path: "/api/v1/summits/{id}/speakers-assistances",
+        operationId: 'addSpeakerSummitAssistance',
         summary: "Create a speaker assistance confirmation request",
-        security: [["Bearer" => []]],
-        tags: ["summit-speakers-assistances"],
+        security: [["summit_speaker_assistances_oauth2" => [SummitScopes::WriteSummitSpeakerAssistanceData, SummitScopes::WriteSummitData]]],
+        tags: ["Summit Speakers Assistances"],
+        x: [
+            "authz_groups" => [IGroup::SuperAdmins, IGroup::Administrators, IGroup::SummitAdministrators]
+        ],
         parameters: [
             new OA\Parameter(
                 name: "id",
@@ -427,9 +441,13 @@ public function addSpeakerSummitAssistance($summit_id)
      */
     #[OA\Put(
         path: "/api/v1/summits/{id}/speakers-assistances/{assistance_id}",
+        operationId: 'updateSpeakerSummitAssistance',
         summary: "Update a speaker assistance confirmation request",
-        security: [["Bearer" => []]],
-        tags: ["summit-speakers-assistances"],
+        security: [["summit_speaker_assistances_oauth2" => [SummitScopes::WriteSummitSpeakerAssistanceData, SummitScopes::WriteSummitData]]],
+        tags: ["Summit Speakers Assistances"],
+        x: [
+            "authz_groups" => [IGroup::SuperAdmins, IGroup::Administrators, IGroup::SummitAdministrators]
+        ],
         parameters: [
             new OA\Parameter(
                 name: "id",
@@ -521,9 +539,13 @@ public function updateSpeakerSummitAssistance($summit_id, $assistance_id)
      */
     #[OA\Delete(
         path: "/api/v1/summits/{id}/speakers-assistances/{assistance_id}",
+        operationId: 'deleteSpeakerSummitAssistance',
         summary: "Delete a speaker assistance confirmation request",
-        security: [["Bearer" => []]],
-        tags: ["summit-speakers-assistances"],
+        security: [["summit_speaker_assistances_oauth2" => [SummitScopes::WriteSummitSpeakerAssistanceData, SummitScopes::WriteSummitData]]],
+        tags: ["Summit Speakers Assistances"],
+        x: [
+            "authz_groups" => [IGroup::SuperAdmins, IGroup::Administrators, IGroup::SummitAdministrators]
+        ],
         parameters: [
             new OA\Parameter(
                 name: "id",
@@ -579,9 +601,13 @@ public function deleteSpeakerSummitAssistance($summit_id, $assistance_id)
      */
     #[OA\Get(
         path: "/api/v1/summits/{id}/speakers-assistances/{assistance_id}",
+        operationId: 'getSpeakerSummitAssistanceBySummit',
         summary: "Get a speaker assistance confirmation request by id",
-        security: [["Bearer" => []]],
-        tags: ["summit-speakers-assistances"],
+        security: [["summit_speaker_assistances_oauth2" => [SummitScopes::ReadAllSummitData]]],
+        tags: ["Summit Speakers Assistances"],
+        x: [
+            "authz_groups" => [IGroup::SuperAdmins, IGroup::Administrators, IGroup::SummitAdministrators]
+        ],
         parameters: [
             new OA\Parameter(
                 name: "id",

app/Swagger/Security/SpeakerAssistancesAuthSchema.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Swagger\schemas;
+
+use App\Security\SummitScopes;
+use OpenApi\Attributes as OA;
+
+
+#[OA\SecurityScheme(
+        type: 'oauth2',
+        securityScheme: 'summit_speaker_assistances_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',
+                    SummitScopes::WriteSummitSpeakerAssistanceData => 'Write Summit Speaker Assistance Data',
+                    SummitScopes::WriteSummitData => 'Write Summit Data',
+                ],
+            ),
+        ],
+    )
+]
+class SpeakerAssistancesAuthSchema{}

app/Swagger/SummitPresentationSchemas.php

@@ -20,11 +20,8 @@
         new OA\Property(property: "summit_id", type: "integer"),
         new OA\Property(property: "speaker_email", type: "string"),
         new OA\Property(property: "speaker_full_name", type: "string"),
+        new OA\Property(property: "speaker_id", type: "integer", description: "PresentationSpeaker Id, full object available in 'speaker' expand (speaker field)"),
         new OA\Property(property: "confirmation_date", type: "integer", nullable: true),
-    ],
-    anyOf:[
-        new OA\Property(property: "speaker_id", type: "integer"),
-        new OA\Property(property: "speaker", type: "PresentationSpeaker"),
     ]
 )]
 class PresentationSpeakerSummitAssistanceConfirmationRequest