chore: add operationId and fix schema name

Author: matiasperrone

app/Http/Controllers/Apis/Protected/Main/OAuth2CompaniesApiController.php

@@ -70,11 +70,12 @@ public function __construct
 
     #[OA\Get(
         path: "/api/v1/companies/{id}",
+        operationId: "getCompany",
         summary: "Get a specific company",
         description: "Returns detailed information about a specific company",
         security: [
             [
-                "OAuth2CompaniesApiControllerAuthSchema" => [
+                "companies_oauth2" => [
                     CompanyScopes::Read,
                 ]
             ]
@@ -118,9 +119,10 @@ public function __construct
      */
     #[OA\Get(
         path: "/api/public/v1/companies/{id}",
+        operationId: "getCompanyPublic",
         summary: "Get a specific company (Public)",
         description: "Returns detailed information about a specific company",
-        tags: ["Companies"],
+        tags: ["Companies (Public)"],
         parameters: [
             new OA\Parameter(
                 name: "id",
@@ -155,11 +157,12 @@ public function __construct
     )]
     #[OA\Post(
         path: "/api/v1/companies",
+        operationId: "createCompany",
         summary: "Create a new company",
         description: "Creates a new company",
         security: [
             [
-                "OAuth2CompaniesApiControllerAuthSchema" => [
+                "companies_oauth2" => [
                     CompanyScopes::Write,
                 ]
             ]
@@ -189,11 +192,12 @@ public function __construct
     )]
     #[OA\Put(
         path: "/api/v1/companies/{id}",
+        operationId: "updateCompany",
         summary: "Update a company",
         description: "Updates an existing company",
         security: [
             [
-                "OAuth2CompaniesApiControllerAuthSchema" => [
+                "companies_oauth2" => [
                     CompanyScopes::Write,
                 ]
             ]
@@ -233,11 +237,12 @@ public function __construct
     )]
     #[OA\Delete(
         path: "/api/v1/companies/{id}",
+        operationId: "deleteCompany",
         summary: "Delete a company",
         description: "Deletes a company",
         security: [
             [
-                "OAuth2CompaniesApiControllerAuthSchema" => [
+                "companies_oauth2" => [
                     CompanyScopes::Write,
                 ]
             ]
@@ -267,11 +272,12 @@ public function __construct
     )]
     #[OA\Get(
         path: "/api/v1/companies",
+        operationId: "getAllCompanies",
         summary: "Get all companies",
         description: "Returns a paginated list of companies. Allows ordering, filtering and pagination.",
         security: [
             [
-                "OAuth2CompaniesApiControllerAuthSchema" => [
+                "companies_oauth2" => [
                     CompanyScopes::Read,
                     SummitScopes::ReadSummitData,
                     SummitScopes::ReadAllSummitData,
@@ -336,9 +342,10 @@ public function __construct
 
     #[OA\Get(
         path: "/api/public/v1/companies",
+        operationId: "getAllCompaniesPublic",
         summary: "Get all companies (Public)",
         description: "Returns a paginated list of companies. Allows ordering, filtering and pagination.",
-        tags: ["Companies"],
+        tags: ["Companies (Public)"],
         parameters: [
             new OA\Parameter(
                 name: 'page',
@@ -501,11 +508,12 @@ protected function updateEntity($id, array $payload): IEntity
 
     #[OA\Post(
         path: "/api/v1/companies/{id}/logo",
+        operationId: "addCompanyLogo",
         summary: "Add company logo",
         description: "Uploads a logo image for the company",
         security: [
             [
-                "OAuth2CompaniesApiControllerAuthSchema" => [
+                "companies_oauth2" => [
                     CompanyScopes::Write,
                 ]
             ]
@@ -573,11 +581,12 @@ public function addCompanyLogo(LaravelRequest $request, $company_id)
 
     #[OA\Delete(
         path: "/api/v1/companies/{id}/logo",
+        operationId: "deleteCompanyLogo",
         summary: "Delete company logo",
         description: "Removes the logo image from the company",
         security: [
             [
-                "OAuth2CompaniesApiControllerAuthSchema" => [
+                "companies_oauth2" => [
                     CompanyScopes::Write,
                 ]
             ]
@@ -618,11 +627,12 @@ public function deleteCompanyLogo($company_id)
 
     #[OA\Post(
         path: "/api/v1/companies/{id}/logo/big",
+        operationId: "addCompanyBigLogo",
         summary: "Add company big logo",
         description: "Uploads a big logo image for the company",
         security: [
             [
-                "OAuth2CompaniesApiControllerAuthSchema" => [
+                "companies_oauth2" => [
                     CompanyScopes::Write,
                 ]
             ]
@@ -689,11 +699,12 @@ public function addCompanyBigLogo(LaravelRequest $request, $company_id)
 
     #[OA\Delete(
         path: "/api/v1/companies/{id}/logo/big",
+        operationId: "deleteCompanyBigLogo",
         summary: "Delete company big logo",
         description: "Removes the big logo image from the company",
         security: [
             [
-                "OAuth2CompaniesApiControllerAuthSchema" => [
+                "companies_oauth2" => [
                     CompanyScopes::Write,
                 ]
             ]
@@ -728,4 +739,4 @@ public function deleteCompanyBigLogo($company_id)
             return $this->deleted();
         });
     }
-}
+}