Fix | Documentation build (#471)

* feat: Extend Swagger Coverage for controller `OAuth2SummitDocumentsApiController`

* chore: Add the correct security and x attributes and create security schema

* fix: merge issues

---------

Co-authored-by: Matias Perrone <[email protected]>

Author: matiasperrone-exo

app/Swagger/SummitSchemas.php

@@ -292,104 +292,6 @@ class SummitDocumentCreateRequest {}
 )]
 class SummitDocumentUpdateRequest {}
 
-// Summit Documents
-
-#[OA\Schema(
-    schema: "SummitDocument",
-    description: "Summit document",
-    type: "object",
-    properties: [
-        new OA\Property(property: "id", type: "integer", example: 1),
-        new OA\Property(property: "created", type: "integer", description: "Unix timestamp", example: 1640995200),
-        new OA\Property(property: "last_edited", type: "integer", description: "Unix timestamp", example: 1640995200),
-        new OA\Property(property: "name", type: "string", example: "Code of Conduct"),
-        new OA\Property(property: "description", type: "string", example: "Summit code of conduct document"),
-        new OA\Property(property: "show_always", type: "boolean", example: true),
-        new OA\Property(property: "label", type: "string", example: "Code of Conduct"),
-        new OA\Property(property: "file", type: "string", format: "uri", nullable: true, example: "https://example.com/document.pdf"),
-        new OA\Property(property: "web_link", type: "string", format: "uri", nullable: true, example: "https://example.com/page"),
-        new OA\Property(property: "selection_plan_id", type: "integer", nullable: true, description: "SelectionPlan ID, full object description when ?expand=summit (summit)"),
-        new OA\Property(
-            property: "event_types",
-            type: "array",
-            items: new OA\Items(type: "integer"),
-            description: "Array of SummitEventType: objects when expanded, ids otherwise",
-        ),
-        new OA\Property(property: "summit_id", type: "integer", description: "Summit ID, full object description when ?expand=summit (summit)"),
-    ]
-)]
-class SummitDocumentSchema {}
-
-#[OA\Schema(
-    schema: "PaginatedSummitDocumentsResponse",
-    description: "Paginated list of summit documents",
-    allOf: [
-        new OA\Schema(ref: "#/components/schemas/PaginateDataSchemaResponse"),
-        new OA\Schema(
-            properties: [
-                new OA\Property(
-                    property: "data",
-                    type: "array",
-                    items: new OA\Items(ref: "#/components/schemas/SummitDocument")
-                )
-            ]
-        )
-    ]
-)]
-class PaginatedSummitDocumentsResponseSchema {}
-
-#[OA\Schema(
-    schema: "SummitDocumentCreateRequest",
-    description: "Request to create a summit document",
-    required: ["name", "label"],
-    type: "object",
-    properties: [
-        new OA\Property(property: "name", type: "string", example: "Code of Conduct"),
-        new OA\Property(property: "label", type: "string", example: "Code of Conduct"),
-        new OA\Property(property: "description", type: "string", nullable: true, example: "Summit code of conduct document"),
-        new OA\Property(property: "show_always", type: "boolean", nullable: true, example: true),
-        new OA\Property(property: "web_link", type: "string", format: "uri", nullable: true, example: "https://example.com/page"),
-        new OA\Property(property: "selection_plan_id", type: "integer", nullable: true, example: 1),
-        new OA\Property(
-            property: "event_types",
-            type: "array",
-            nullable: true,
-            items: new OA\Items(type: "integer"),
-            example: [1, 2, 3]
-        ),
-        new OA\Property(
-            property: "file",
-            type: "string",
-            format: "binary",
-            nullable: true,
-            description: "Document file upload (required if web_link not provided)"
-        ),
-    ]
-)]
-class SummitDocumentCreateRequest {}
-
-#[OA\Schema(
-    schema: "SummitDocumentUpdateRequest",
-    description: "Request to update a summit document",
-    type: "object",
-    properties: [
-        new OA\Property(property: "name", type: "string", nullable: true, example: "Code of Conduct"),
-        new OA\Property(property: "label", type: "string", nullable: true, example: "Code of Conduct"),
-        new OA\Property(property: "description", type: "string", nullable: true, example: "Summit code of conduct document"),
-        new OA\Property(property: "show_always", type: "boolean", nullable: true, example: true),
-        new OA\Property(property: "web_link", type: "string", format: "uri", nullable: true, example: "https://example.com/page"),
-        new OA\Property(property: "selection_plan_id", type: "integer", nullable: true, example: 1),
-        new OA\Property(
-            property: "event_types",
-            type: "array",
-            nullable: true,
-            items: new OA\Items(type: "integer"),
-            example: [1, 2, 3]
-        ),
-    ]
-)]
-class SummitDocumentUpdateRequest {}
-
 // Summit Attendee Badges
 
 #[OA\Schema(