feat(swagger): add 'Public' tag to all /api/public/ OpenAPI operations

app/Http/Controllers/Apis/CountriesApiController.php

@@ -30,7 +30,7 @@ final class CountriesApiController extends JsonController
         description: "Get all countries with ISO codes",
         summary: 'Get all countries',
         operationId: 'getAllCountries',
-        tags: ['Countries'],
+        tags: ['Countries', 'Public'],
         responses: [
             new OA\Response(
                 response: 200,

app/Http/Controllers/Apis/LanguagesApiController.php

@@ -41,7 +41,7 @@ public function __construct(ILanguageRepository $language_repository)
         description: "Get all available languages with ISO codes",
         summary: 'Get all languages',
         operationId: 'getAllLanguages',
-        tags: ['Languages'],
+        tags: ['Languages', 'Public'],
         responses: [
             new OA\Response(
                 response: 200,

app/Http/Controllers/Apis/Marketplace/AppliancesApiController.php

@@ -41,7 +41,7 @@ public function __construct(IApplianceRepository $repository, IResourceServerCon
         description: "Get all marketplace appliances (OpenStack implementations)",
         summary: 'Get all appliances',
         operationId: 'getAllAppliances',
-        tags: ['Appliances', 'Marketplace'],
+        tags: ['Appliances', 'Marketplace', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'page',

app/Http/Controllers/Apis/Marketplace/ConsultantsApiController.php

@@ -40,7 +40,7 @@ public function __construct(IConsultantRepository $repository, IResourceServerCo
         description: "Get all marketplace consultants and consulting services",
         summary: 'Get all consultants',
         operationId: 'getAllConsultants',
-        tags: ['Consultants'],
+        tags: ['Consultants', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'filter[]',

app/Http/Controllers/Apis/Marketplace/DistributionsApiController.php

@@ -38,7 +38,7 @@ public function __construct(IDistributionRepository $repository, IResourceServer
         description: "Get all marketplace distributions (OpenStack implementations)",
         summary: 'Get all distributions',
         operationId: 'getAllDistributions',
-        tags: ['Marketplace', 'Marketplace Distributions'],
+        tags: ['Marketplace', 'Marketplace Distributions', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'page',

app/Http/Controllers/Apis/Marketplace/PrivateCloudsApiController.php

@@ -37,7 +37,7 @@ public function __construct(IPrivateCloudServiceRepository $repository, IResourc
         description: "Get all marketplace hosted private cloud services (OpenStack implementations)",
         summary: 'Get all hosted private clouds',
         operationId: 'getAllHostedPrivateClouds',
-        tags: ['Marketplace', 'Clouds'],
+        tags: ['Marketplace', 'Clouds', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'page',

app/Http/Controllers/Apis/Marketplace/PublicCloudsApiController.php

@@ -39,7 +39,7 @@ public function __construct(IPublicCloudServiceRepository $repository, IResource
         description: "Get all marketplace public cloud services (OpenStack implementations)",
         summary: 'Get all public clouds',
         operationId: 'getAllPublicClouds',
-        tags: ['Marketplace', 'Clouds'],
+        tags: ['Marketplace', 'Clouds', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'page',

app/Http/Controllers/Apis/Marketplace/RemoteCloudsApiController.php

@@ -36,7 +36,7 @@ public function __construct(IRemoteCloudServiceRepository $repository, IResource
         description: "Get all marketplace remotely managed private cloud services (OpenStack implementations)",
         summary: 'Get all remotely managed private clouds',
         operationId: 'getAllRemotelyManagedPrivateClouds',
-        tags: ['Marketplace', 'Clouds'],
+        tags: ['Marketplace', 'Clouds', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'page',

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

@@ -41,7 +41,7 @@ class OAuth2ChunkedFilesApiController extends UploadController
         description: "Upload files using chunked upload mechanism. Supports large file uploads by splitting them into smaller chunks. The endpoint handles both complete uploads and chunked progress updates.",
         summary: 'Upload file with chunked upload support',
         operationId: 'uploadChunkedFile',
-        tags: ['Files'],
+        tags: ['Files', 'Public'],
         requestBody: new OA\RequestBody(
             required: true,
             content: new OA\MediaType(

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

@@ -144,7 +144,7 @@ public function __construct
         operationId: "getAllCompaniesPublic",
         summary: "Get all companies (Public)",
         description: "Returns a paginated list of companies. Allows ordering, filtering and pagination.",
-        tags: ["Companies (Public)"],
+        tags: ["Companies (Public)", 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'page',
@@ -249,7 +249,7 @@ public function __construct
         operationId: "getCompanyPublic",
         summary: "Get a specific company (Public)",
         description: "Returns detailed information about a specific company",
-        tags: ["Companies (Public)"],
+        tags: ["Companies (Public)", 'Public'],
         parameters: [
             new OA\Parameter(
                 name: "id",

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

@@ -159,7 +159,7 @@ function ($page, $per_page, $filter, $order, $applyExtraFilters) {
         operationId: "getCurrentElection",
         summary: "Get current election",
         description: "Get the current active election",
-        tags: ["Elections (Public)"],
+        tags: ["Elections (Public)", 'Public'],
         parameters: [
             new OA\Parameter(
                 name: "expand",
@@ -261,7 +261,7 @@ public function getById($election_id)
         operationId: "getCurrentElectionCandidates",
         summary: "Get current election candidates",
         description: "Get all accepted candidates for the current election. Supports expand parameter to include member and/or election objects",
-        tags: ["Elections (Public)"],
+        tags: ["Elections (Public)", 'Public'],
         parameters: [
             new OA\Parameter(
                 name: "page",
@@ -471,7 +471,7 @@ function ($page, $per_page, $filter, $order, $applyExtraFilters) use ($election)
         operationId: "getCurrentGoldCandidates",
         summary: "Get current election gold candidates",
         description: "Get all gold (featured) candidates for the current election. Supports expand parameter to include member and/or election objects",
-        tags: ["Elections (Public)"],
+        tags: ["Elections (Public)", 'Public'],
         parameters: [
             new OA\Parameter(
                 name: "page",

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

@@ -50,7 +50,7 @@ public function __construct
         path: '/api/public/v1/legal-documents/{id}',
         summary: 'Get a legal document by ID or slug',
         description: 'Retrieves a legal document (privacy policy, terms of service, etc.) by its numeric ID or URL-friendly slug. This is a public endpoint that does not require authentication.',
-        tags: ['Legal Documents'],
+        tags: ['Legal Documents', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'id',

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

@@ -64,7 +64,7 @@ public function __construct
         operationId: 'getAllMembersPublic',
         summary: 'Get all members',
         description: 'Returns a paginated list of members with optional filtering, sorting and search capabilities',
-        tags: ['Members (Public)'],
+        tags: ['Members (Public)', 'Public'],
         parameters: [
             new OA\Parameter(name: 'page', in: 'query', required: false, description: 'Page number', schema: new OA\Schema(type: 'integer', default: 1)),
             new OA\Parameter(name: 'per_page', in: 'query', required: false, description: 'Items per page', schema: new OA\Schema(type: 'integer', default: 10, maximum: 100)),
@@ -180,7 +180,7 @@ function () use ($current_member, $application_type) {
         operationId: 'getAllMemberCompanies',
         summary: 'Get all member companies',
         description: 'Returns a paginated list of companies from member profiles',
-        tags: ['Members (Public)'],
+        tags: ['Members (Public)', 'Public'],
         parameters: [
             new OA\Parameter(name: 'page', in: 'query', required: false, description: 'Page number', schema: new OA\Schema(type: 'integer', default: 1)),
             new OA\Parameter(name: 'per_page', in: 'query', required: false, description: 'Items per page', schema: new OA\Schema(type: 'integer', default: 10, maximum: 100)),
@@ -341,7 +341,7 @@ public function updateMyMember()
         operationId: 'getMemberById',
         summary: 'Get member by ID',
         description: 'Returns a member profile by ID',
-        tags: ['Members (Public)'],
+        tags: ['Members (Public)', 'Public'],
         parameters: [
             new OA\Parameter(name: 'member_id', in: 'path', required: true, description: 'Member ID', schema: new OA\Schema(type: 'integer')),
             new OA\Parameter(name: 'expand', in: 'query', required: false, description: 'Expand relationships', schema: new OA\Schema(type: 'string')),

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

@@ -151,7 +151,7 @@ protected function updateEntity($id, array $payload): IEntity
         description: "Get all sponsored projects (public endpoint)",
         summary: 'Read All Sponsored Projects (Public)',
         operationId: 'getAllSponsoredProjectsPublic',
-        tags: ['Sponsored Projects (Public)'],
+        tags: ['Sponsored Projects (Public)', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'filter[]',
@@ -341,7 +341,7 @@ function () {
         description: "Get a specific sponsored project (public endpoint)",
         summary: 'Read Sponsored Project (Public)',
         operationId: 'getSponsoredProjectPublic',
-        tags: ['Sponsored Projects (Public)'],
+        tags: ['Sponsored Projects (Public)', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'id',
@@ -507,7 +507,7 @@ function () {
         description: "Get all sponsorship types for a sponsored project (public endpoint)",
         summary: 'Read All Sponsorship Types (Public)',
         operationId: 'getAllSponsorshipTypesPublic',
-        tags: ['Sponsored Projects (Public)', 'Sponsorship Types (Public)'],
+        tags: ['Sponsored Projects (Public)', 'Sponsorship Types (Public)', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'id',
@@ -686,7 +686,7 @@ function ($page, $per_page, $filter, $order, $applyExtraFilters) {
         description: "Get a specific sponsorship type (public endpoint)",
         summary: 'Read Sponsorship Type (Public)',
         operationId: 'getSponsorshipTypePublic',
-        tags: ['Sponsored Projects (Public)', 'Sponsorship Types (Public)'],
+        tags: ['Sponsored Projects (Public)', 'Sponsorship Types (Public)', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'id',
@@ -996,7 +996,7 @@ function ($sponsorship_type_id, $project_id) {
         description: "Get all supporting companies for a sponsorship type (public endpoint)",
         summary: 'Read All Supporting Companies (Public)',
         operationId: 'getSupportingCompaniesPublic',
-        tags: ['Sponsored Projects (Public)', 'Supporting Companies (Public)'],
+        tags: ['Sponsored Projects (Public)', 'Supporting Companies (Public)', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'id',

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

@@ -53,7 +53,7 @@ public function __construct
         operationId: 'getAllUserStories',
         summary: 'Get all user stories',
         description: 'Retrieves a paginated list of user stories showcasing real-world use cases and success stories from the OpenStack community. User stories highlight how organizations use OpenStack in production. This is a public endpoint that can return different data based on authentication (more details for authenticated users).',
-        tags: ['User Stories (Public)'],
+        tags: ['User Stories (Public)', 'Public'],
         parameters: [
             new OA\Parameter(
                 name: 'page',

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

@@ -903,7 +903,7 @@ public function deleteAll($summit_id, $event_id)
         description: "",
         summary: 'Get RSVP Invitation By Token',
         operationId: 'gettByToken',
-        tags: ['RSVP Invitations (Public)'],
+        tags: ['RSVP Invitations (Public)', 'Public'],
         security: [],
         parameters: [
             new OA\Parameter(
@@ -962,7 +962,7 @@ public function getInvitationByToken($summit_id, $event_id, $token)
         description: "",
         summary: 'Accept RSVP Invitation',
         operationId: 'acceptByToken',
-        tags: ['RSVP Invitations (Public)'],
+        tags: ['RSVP Invitations (Public)', 'Public'],
         security: [],
         parameters: [
             new OA\Parameter(
@@ -1021,7 +1021,7 @@ public function acceptByToken($summit_id, $event_id, $token)
         description: "",
         summary: 'Decline RSVP Invitation',
         operationId: 'rejectByToken',
-        tags: ['RSVP Invitations (Public)'],
+        tags: ['RSVP Invitations (Public)', 'Public'],
         security: [],
         parameters: [
             new OA\Parameter(

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

@@ -189,7 +189,7 @@ public function __construct
         path: "/api/public/v1/summits",
         operationId: "getSummitsPublic",
         summary: "Get summits list (public)",
-        tags: ["Summits (Public)"],
+        tags: ["Summits (Public)", 'Public'],
         parameters: [
             new OA\Parameter(
                 name: "page",
@@ -388,7 +388,7 @@ function () {
         path: "/api/public/v1/summits/all",
         operationId: "getAllSummitsPublic",
         summary: "Get all summits (public)",
-        tags: ["Summits (Public)"],
+        tags: ["Summits (Public)", 'Public'],
         parameters: [
             new OA\Parameter(
                 name: "page",
@@ -590,7 +590,7 @@ function () {
         path: "/api/public/v1/summits/{id}",
         operationId: "getSummitPublic",
         summary: "Get summit by ID or slug (public)",
-        tags: ["Summits (Public)"],
+        tags: ["Summits (Public)", 'Public'],
         parameters: [
             new OA\Parameter(
                 name: "id",
@@ -710,7 +710,7 @@ public function getSummit($summit_id)
         path: "/api/public/v1/summits/all/current",
         operationId: "getAllCurrentSummitPublic",
         summary: "Get current summit (public)",
-        tags: ["Summits (Public)"],
+        tags: ["Summits (Public)", 'Public'],
         parameters: [
             new OA\Parameter(
                 name: "relations",
@@ -778,7 +778,7 @@ private function getSummitOr404($id):Summit{
         path: "/api/public/v1/summits/all/{id}",
         operationId: "getAllCurrentSummitByIDOrSlugPublic",
         summary: "Get all summit by ID or Slug (public)",
-        tags: ["Summits (Public)"],
+        tags: ["Summits (Public)", 'Public'],
         parameters: [
             new OA\Parameter(
                 name: "id",

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

@@ -301,7 +301,7 @@ public function getEventsCSV($summit_id)
         operationId: 'getScheduledEventsPublic',
         summary: 'Get all published/scheduled events for a summit',
         description: 'Retrieves a paginated list of all published events for a specific summit.',
-        tags: ['Summit Events (Public)'],
+        tags: ['Summit Events (Public)', 'Public'],
         parameters: [
             new OA\Parameter(name: 'id', in: 'path', required: true, description: 'Summit ID or slug', schema: new OA\Schema(type: 'string')),
             new OA\Parameter(name: 'page', in: 'query', required: false, description: 'Page number', schema: new OA\Schema(type: 'integer', default: 1)),
@@ -361,7 +361,7 @@ public function getScheduledEvents($summit_id)
         operationId: 'getScheduledEventsTags',
         summary: 'Get all tags from published events for a summit',
         description: 'Retrieves a paginated list of tags used in published events for a specific summit. This is a public endpoint.',
-        tags: ['Summit Events (Public)'],
+        tags: ['Summit Events (Public)', 'Public'],
         parameters: [
             new OA\Parameter(name: 'id', in: 'path', required: true, description: 'Summit ID or slug', schema: new OA\Schema(type: 'string')),
             new OA\Parameter(name: 'page', in: 'query', required: false, description: 'Page number', schema: new OA\Schema(type: 'integer', default: 1)),
@@ -889,7 +889,7 @@ public function getEvent($summit_id, $event_id)
         operationId: 'getScheduledEventPublic',
         summary: 'Get a specific published/scheduled event by ID',
         description: 'Retrieves a single published event by its ID for a specific summit.',
-        tags: ['Summit Events (Public)'],
+        tags: ['Summit Events (Public)', 'Public'],
         parameters: [
             new OA\Parameter(name: 'id', in: 'path', required: true, description: 'Summit ID or slug', schema: new OA\Schema(type: 'string')),
             new OA\Parameter(name: 'event_id', in: 'path', required: true, description: 'Event ID', schema: new OA\Schema(type: 'integer')),
@@ -2670,7 +2670,7 @@ public function upgradeEvent($summit_id, $event_id, $type_id)
         operationId: 'getOverflowStreamingInfo',
         summary: 'Get overflow streaming information (Public)',
         description: 'Retrieves overflow streaming information for published events. This is a public endpoint.',
-        tags: ['Summit Events (Public)'],
+        tags: ['Summit Events (Public)', 'Public'],
         parameters: [
             new OA\Parameter(name: 'id', in: 'path', required: true, description: 'Summit ID or slug', schema: new OA\Schema(type: 'string')),
             new OA\Parameter(name: 'k', in: 'query', required: true, description: 'Overflow stream key', schema: new OA\Schema(type: 'string')),

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

@@ -1363,7 +1363,7 @@ public function getAirports($summit_id)
         path: '/api/public/v1/summits/{id}/locations/{location_id}',
         operationId: 'getLocationByIdPublic',
         summary: 'Get a specific location by ID (Public)',
-        tags: ['Summit Locations (Public)'],
+        tags: ['Summit Locations (Public)', 'Public'],
         parameters: [
             new OA\Parameter(name: 'id', in: 'path', required: true, description: 'Summit ID or slug', schema: new OA\Schema(type: 'string')),
             new OA\Parameter(name: 'location_id', in: 'path', required: true, description: 'Location ID', schema: new OA\Schema(type: 'integer')),
@@ -1563,7 +1563,7 @@ public function getLocationEvents($summit_id, $location_id)
         path: '/api/public/v1/summits/{id}/locations/{location_id}/events/published',
         operationId: 'getLocationPublishedEventsPublic',
         summary: 'Get published events for a location (Public)',
-        tags: ['Summit Locations (Public)'],
+        tags: ['Summit Locations (Public)', 'Public'],
         parameters: [
             new OA\Parameter(name: 'id', in: 'path', required: true, description: 'Summit ID or slug', schema: new OA\Schema(type: 'string')),
             new OA\Parameter(name: 'location_id', in: 'path', required: true, description: 'Location ID or "tbd"', schema: new OA\Schema(type: 'string')),
@@ -2999,7 +2999,7 @@ public function deleteVenueRoom($summit_id, $venue_id, $room_id)
         path: '/api/public/v1/summits/{id}/locations/{location_id}/banners',
         operationId: 'getLocationBannersPublic',
         summary: 'Get all banners for a location',
-        tags: ['Summit Locations (Public)'],
+        tags: ['Summit Locations (Public)', 'Public'],
         parameters: [
             new OA\Parameter(name: 'id', in: 'path', required: true, description: 'Summit ID or slug', schema: new OA\Schema(type: 'string')),
             new OA\Parameter(name: 'location_id', in: 'path', required: true, description: 'Location ID', schema: new OA\Schema(type: 'integer')),

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

@@ -821,7 +821,7 @@ public function revokeScheduleShareableLink($summit_id, $member_id)
         path: "/api/public/v1/summits/{id}/members/all/schedule/ics/{cid}",
         operationId: "getCalendarFeedICS",
         description: "Get calendar feed in ICS format for member schedule",
-        tags: ["Summit Members (Public)"],
+        tags: ["Summit Members (Public)", 'Public'],
         parameters: [
             new OA\Parameter(name: "id", description: "Summit ID", in: "path", required: true, schema: new OA\Schema(type: "integer")),
             new OA\Parameter(name: "cid", description: "Calendar ID", in: "path", required: true, schema: new OA\Schema(type: "string")),