academe-kit 0.3.7 → 0.3.8

package/dist/types/types/academe-api.d.ts

@@ -542,6 +542,223 @@ export interface paths {
         };
         trace?: never;
     };
+    "/certificate-templates": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all certificate templates
+         * @description Retrieve a list of all certificate templates with optional filtering
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Filter by template name */
+                    name?: string;
+                    /** @description Filter by default template */
+                    isDefault?: boolean;
+                    /** @description Filter by active status */
+                    isActive?: boolean;
+                    /** @description Filter by quiz ID */
+                    quizId?: string;
+                    /** @description Filter by course ID */
+                    courseId?: string;
+                    /** @description Filter by organization ID */
+                    organizationId?: string;
+                    /** @description Filter by institution ID */
+                    institutionId?: string;
+                    /** @description Search in template name */
+                    search?: string;
+                    /** @description Page number */
+                    page?: number;
+                    /** @description Items per page */
+                    limit?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of certificate templates */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["CertificateTemplate"][];
+                            meta?: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        /**
+         * Create a new certificate template
+         * @description Create a new template for certificates
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CreateCertificateTemplateDto"];
+                };
+            };
+            responses: {
+                /** @description Certificate template created successfully */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["CertificateTemplate"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/certificate-templates/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get certificate template by ID
+         * @description Retrieve detailed information about a specific certificate template
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Certificate template information */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["CertificateTemplate"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        /**
+         * Delete certificate template
+         * @description Remove a certificate template from the system
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Certificate template deleted successfully */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update certificate template
+         * @description Update certificate template information
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["UpdateCertificateTemplateDto"];
+                };
+            };
+            responses: {
+                /** @description Certificate template updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["CertificateTemplate"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        trace?: never;
+    };
     "/certificates": {
         parameters: {
             query?: never;
@@ -2561,6 +2778,91 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/institutions/seat-code/{seatCodeId}/classrooms": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List classrooms by seat code (public)
+         * @description Public endpoint to retrieve classrooms associated with an institution via seat code.
+         *     This endpoint validates that:
+         *     - The seat code exists
+         *     - The seat code is not reserved
+         *     - The seat code has not been used (no institution_registration exists)
+         *
+         *     If valid, returns all classrooms from the institution associated with the seat code's seat.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description When true, includes a userCount field with the number of users registered in each classroom */
+                    includeUserCount?: boolean;
+                };
+                header?: never;
+                path: {
+                    /** @description Seat Code ID (must be valid and unused) */
+                    seatCodeId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of institution classrooms */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: (components["schemas"]["InstitutionClassroom"] & {
+                                /**
+                                 * @description Number of users registered in this classroom (only present when includeUserCount=true)
+                                 * @example 25
+                                 */
+                                userCount?: number;
+                            })[];
+                        };
+                    };
+                };
+                /**
+                 * @description Bad request. Possible causes:
+                 *     - Seat code not found or already in use
+                 *     - Seat code is reserved
+                 *     - Seat code is not associated with an institution
+                 */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Seat not found for the seat code */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/institutions/{institutionId}/classrooms": {
         parameters: {
             query?: never;
@@ -2569,7 +2871,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * List all classrooms of an institution
+         * List all classrooms of an institution (authenticated)
          * @description Retrieve a list of all classrooms associated with a specific institution, including shift and serie information. Optionally includes user count for each classroom.
          */
         get: {
@@ -2779,280 +3081,7 @@ export interface paths {
         };
         trace?: never;
     };
-    "/institutions/{institutionId}/groups": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * List all groups of an institution
-         * @description Retrieve a list of all groups associated with a specific institution
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Institution ID */
-                    institutionId: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description List of institution groups */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @example success */
-                            status?: string;
-                            data?: components["schemas"]["InstitutionGroup"][];
-                        };
-                    };
-                };
-                401: components["responses"]["Unauthorized"];
-                404: components["responses"]["NotFound"];
-                500: components["responses"]["ServerError"];
-            };
-        };
-        put?: never;
-        /**
-         * Associate a group with an institution
-         * @description Create a new association between a group and an institution
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Institution ID */
-                    institutionId: string;
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["CreateInstitutionGroupDto"];
-                };
-            };
-            responses: {
-                /** @description Group associated successfully */
-                201: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @example success */
-                            status?: string;
-                            data?: components["schemas"]["InstitutionGroup"];
-                        };
-                    };
-                };
-                400: components["responses"]["BadRequest"];
-                401: components["responses"]["Unauthorized"];
-                404: components["responses"]["NotFound"];
-                409: components["responses"]["Conflict"];
-                500: components["responses"]["ServerError"];
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/institutions/{institutionId}/groups/{groupId}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post?: never;
-        /**
-         * Remove a group from an institution
-         * @description Remove the association between a group and an institution
-         */
-        delete: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Institution ID */
-                    institutionId: string;
-                    /** @description Group ID */
-                    groupId: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Group removed from institution successfully */
-                204: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                400: components["responses"]["BadRequest"];
-                401: components["responses"]["Unauthorized"];
-                404: components["responses"]["NotFound"];
-                500: components["responses"]["ServerError"];
-            };
-        };
-        options?: never;
-        head?: never;
-        /**
-         * Update institution group quantity
-         * @description Update the available quantity for a group in an institution
-         */
-        patch: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Institution ID */
-                    institutionId: string;
-                    /** @description Group ID */
-                    groupId: string;
-                };
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["UpdateInstitutionGroupDto"];
-                };
-            };
-            responses: {
-                /** @description Institution group updated successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @example success */
-                            status?: string;
-                            data?: components["schemas"]["InstitutionGroup"];
-                        };
-                    };
-                };
-                400: components["responses"]["BadRequest"];
-                401: components["responses"]["Unauthorized"];
-                404: components["responses"]["NotFound"];
-                500: components["responses"]["ServerError"];
-            };
-        };
-        trace?: never;
-    };
-    "/institutions/{institutionId}/groups/users": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get all users of all groups in an institution
-         * @description Retrieve all users from all groups associated with a specific institution.
-         *     Returns a map where keys are group IDs and values are arrays of users in each group.
-         *     This is more efficient than calling /groups/{id}/users multiple times.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Institution ID */
-                    institutionId: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Users grouped by group ID */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        /**
-                         * @example {
-                         *       "status": "success",
-                         *       "data": {
-                         *         "group-uuid-1": [
-                         *           {
-                         *             "id": "user-uuid-1",
-                         *             "firstName": "John",
-                         *             "lastName": "Doe",
-                         *             "email": "john@example.com",
-                         *             "assignedAt": "2024-01-15T10:30:00Z"
-                         *           },
-                         *           {
-                         *             "id": "user-uuid-2",
-                         *             "firstName": "Jane",
-                         *             "lastName": "Smith",
-                         *             "email": "jane@example.com",
-                         *             "assignedAt": "2024-01-16T14:20:00Z"
-                         *           }
-                         *         ],
-                         *         "group-uuid-2": [
-                         *           {
-                         *             "id": "user-uuid-3",
-                         *             "firstName": "Bob",
-                         *             "lastName": "Wilson",
-                         *             "email": "bob@example.com",
-                         *             "assignedAt": "2024-01-17T09:15:00Z"
-                         *           }
-                         *         ]
-                         *       }
-                         *     }
-                         */
-                        "application/json": {
-                            /** @example success */
-                            status?: string;
-                            /** @description Map of group IDs to arrays of users */
-                            data?: {
-                                [key: string]: {
-                                    /** Format: uuid */
-                                    id?: string;
-                                    firstName?: string;
-                                    lastName?: string;
-                                    email?: string;
-                                    document?: string;
-                                    phone?: string;
-                                    isActive?: boolean;
-                                    /** Format: date-time */
-                                    assignedAt?: string;
-                                    /** Format: uuid */
-                                    assignedBy?: string;
-                                }[];
-                            };
-                        };
-                    };
-                };
-                401: components["responses"]["Unauthorized"];
-                404: components["responses"]["NotFound"];
-                500: components["responses"]["ServerError"];
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/institutions/{institutionId}/registrations": {
+    "/institutions/{institutionId}/registrations": {
         parameters: {
             query?: never;
             header?: never;
@@ -3595,7 +3624,12 @@ export interface paths {
         };
         /**
          * List all users from an institution
-         * @description Retrieve a paginated list of all users registered in an institution with advanced filtering options
+         * @description Retrieve a paginated list of all users registered in an institution with advanced filtering options.
+         *     Each user includes:
+         *     - User groups (userGroups) with group details
+         *     - User guardians (userGuardians)
+         *     - Institution registration details with classroom information
+         *     - Certificate count (certificatesCount)
          */
         get: {
             parameters: {
@@ -3612,6 +3646,12 @@ export interface paths {
                     hasGuardian?: boolean;
                     /** @description Search by email, first name, last name, or full name (case-insensitive) */
                     search?: string;
+                    /** @description Filter by start date (based on institution_registration table start_date field) */
+                    startDate?: string;
+                    /** @description Filter by end date (based on institution_registration table end_date field) */
+                    endDate?: string;
+                    /** @description Filter by seat ID (based on seats table) */
+                    seatId?: string;
                     /** @description Page number */
                     page?: number;
                     /** @description Items per page */
@@ -3649,7 +3689,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/organizations": {
+    "/institutions/{institutionId}/seat-codes": {
         parameters: {
             query?: never;
             header?: never;
@@ -3657,8 +3697,865 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * List all organizations
-         * @description Retrieve a list of all organizations with optional filters
+         * List all seat codes of an institution (paginated)
+         * @description Retrieve a paginated list of all seat codes associated with a specific institution.
+         *     Can be filtered by seat ID, status, and search term (code or user name).
+         *     Includes institution registration and user information when the code is reserved.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Filter by seat ID */
+                    seatId?: string;
+                    /** @description Search by code or user name (first name or last name) */
+                    search?: string;
+                    /**
+                     * @description Filter by license status:
+                     *     - reserved: Code is reserved (isReserved = true)
+                     *     - active: Code has an associated institution registration (user assigned)
+                     *     - available: Code is not reserved and has no user assigned
+                     */
+                    status?: "reserved" | "active" | "available";
+                    /** @description Page number */
+                    page?: number;
+                    /** @description Number of items per page */
+                    limit?: number;
+                };
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Paginated list of seat codes */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["SeatCode"][];
+                            meta?: {
+                                /** @description Total number of items */
+                                total?: number;
+                                /** @description Current page number */
+                                page?: number;
+                                /** @description Items per page */
+                                limit?: number;
+                                /** @description Total number of pages */
+                                totalPages?: number;
+                            };
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        /**
+         * Generate seat codes for a seat
+         * @description Generate multiple unique seat codes for a specific seat in the institution
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CreateSeatCodesDto"];
+                };
+            };
+            responses: {
+                /** @description Seat codes generated successfully */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["SeatCode"][];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/institutions/{institutionId}/seats/{seatId}/codes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all codes for a specific seat
+         * @description Retrieve all seat codes for a specific seat in the institution
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                    /** @description Seat ID */
+                    seatId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of seat codes */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["SeatCode"][];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        /**
+         * Delete all codes for a seat
+         * @description Delete all seat codes for a specific seat. Cannot delete if any codes are reserved.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                    /** @description Seat ID */
+                    seatId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Seat codes deleted successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: {
+                                /** @description Number of codes deleted */
+                                deletedCount?: number;
+                            };
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/institutions/{institutionId}/seats/{seatId}/codes/available": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List available codes for a specific seat
+         * @description Retrieve all available (not reserved) seat codes for a specific seat
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                    /** @description Seat ID */
+                    seatId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of available seat codes */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["SeatCode"][];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/institutions/{institutionId}/seat-codes/{seatCodeId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a specific seat code
+         * @description Retrieve details of a specific seat code
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                    /** @description Seat Code ID */
+                    seatCodeId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Seat code details */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["SeatCode"];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        /**
+         * Delete a seat code
+         * @description Delete a specific seat code. Cannot delete reserved codes.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                    /** @description Seat Code ID */
+                    seatCodeId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Seat code deleted successfully */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update a seat code
+         * @description Update the reservation status of a seat code
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                    /** @description Seat Code ID */
+                    seatCodeId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["UpdateSeatCodeDto"];
+                };
+            };
+            responses: {
+                /** @description Seat code updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["SeatCode"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        trace?: never;
+    };
+    "/seat-codes/validate/{code}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Validate and get seat code by code string
+         * @description Retrieve seat code details by the code string. Useful for validating codes during registration.
+         *     Returns the seat code with the seat and institution data included.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description The seat code string */
+                    code: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Seat code details with seat and institution */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["SeatCodeWithInstitution"];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/seat-codes/reserve/{code}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Reserve a seat code
+         * @description Reserve a seat code by marking it as reserved (isReserved = true).
+         *     The code must exist and not be already reserved.
+         *     Returns the updated seat code with seat, group, and institution data included.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description The seat code string to reserve */
+                    code: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Seat code reserved successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["SeatCodeWithInstitution"];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                /** @description Seat code is already reserved */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example error */
+                            status?: string;
+                            /** @example Seat code is already reserved */
+                            message?: string;
+                        };
+                    };
+                };
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/seat-codes/send-code": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Send license link via WhatsApp
+         * @description Reserve a seat code and send the dashboard link via WhatsApp webhook.
+         *     The link format is: DASHBOARD_URL/register?code={code}
+         *     Requires WEBHOOK_LICENSE_RELEASE_URL and DASHBOARD_URL environment variables to be configured.
+         *
+         *     The code can be provided in the request body. If not provided, you must provide a seatId
+         *     in the request body to automatically find an available code from that seat.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    /**
+                     * @example {
+                     *       "phone": "+5511999999999",
+                     *       "name": "John Doe",
+                     *       "code": "ABC123",
+                     *       "seatId": "550e8400-e29b-41d4-a716-446655440000"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["SendCodeDto"];
+                };
+            };
+            responses: {
+                /** @description License link sent successfully via WhatsApp */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["SeatCodeWithInstitution"];
+                        };
+                    };
+                };
+                /** @description Bad request (missing phone, webhook not configured, or webhook call failed) */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example error */
+                            status?: string;
+                            /** @example Phone number is required */
+                            message?: string;
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                /** @description Seat code is already reserved */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example error */
+                            status?: string;
+                            /** @example Seat code is already reserved */
+                            message?: string;
+                        };
+                    };
+                };
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/institutions/{institutionId}/seats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all seats of an institution
+         * @description Retrieve a list of all seats associated with a specific institution.
+         *     Each seat includes the number of users currently assigned to the group (usedQuantity).
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of Seats with user count */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Seats"][];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        /**
+         * Associate a seat with an institution
+         * @description Create a new association between a seat and an institution
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CreateSeatsDto"];
+                };
+            };
+            responses: {
+                /** @description Seat associated successfully */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Seats"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                409: components["responses"]["Conflict"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/institutions/{institutionId}/seats/{groupId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Remove a seat from an institution
+         * @description Remove the association between a seat and an institution
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                    /** @description Group ID (seat identifier) */
+                    groupId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Seat removed from institution successfully */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update institution seat quantity
+         * @description Update the available quantity for a seat in an institution
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                    /** @description Group ID */
+                    groupId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["UpdateSeatsDto"];
+                };
+            };
+            responses: {
+                /** @description Institution seat updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Seats"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        trace?: never;
+    };
+    "/institutions/{institutionId}/seats/users": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get all users of all seats in an institution
+         * @description Retrieve all users from all seats associated with a specific institution.
+         *     Returns a map where keys are seat IDs and values are arrays of users in each seat.
+         *     This is more efficient than calling /seats/{id}/users multiple times.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Institution ID */
+                    institutionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Users grouped by group ID */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "status": "success",
+                         *       "data": {
+                         *         "group-uuid-1": [
+                         *           {
+                         *             "id": "user-uuid-1",
+                         *             "firstName": "John",
+                         *             "lastName": "Doe",
+                         *             "email": "john@example.com",
+                         *             "assignedAt": "2024-01-15T10:30:00Z"
+                         *           },
+                         *           {
+                         *             "id": "user-uuid-2",
+                         *             "firstName": "Jane",
+                         *             "lastName": "Smith",
+                         *             "email": "jane@example.com",
+                         *             "assignedAt": "2024-01-16T14:20:00Z"
+                         *           }
+                         *         ],
+                         *         "group-uuid-2": [
+                         *           {
+                         *             "id": "user-uuid-3",
+                         *             "firstName": "Bob",
+                         *             "lastName": "Wilson",
+                         *             "email": "bob@example.com",
+                         *             "assignedAt": "2024-01-17T09:15:00Z"
+                         *           }
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            /** @description Map of group IDs to arrays of users */
+                            data?: {
+                                [key: string]: {
+                                    /** Format: uuid */
+                                    id?: string;
+                                    firstName?: string;
+                                    lastName?: string;
+                                    email?: string;
+                                    document?: string;
+                                    phone?: string;
+                                    isActive?: boolean;
+                                    /** Format: date-time */
+                                    assignedAt?: string;
+                                    /** Format: uuid */
+                                    assignedBy?: string;
+                                }[];
+                            };
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/organizations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all organizations
+         * @description Retrieve a list of all organizations with optional filters
          */
         get: {
             parameters: {
@@ -3669,7 +4566,1208 @@ export interface paths {
                     type?: string;
                     /** @description Filter by active status */
                     isActive?: boolean;
-                    /** @description Search in organization name */
+                    /** @description Search in organization name */
+                    search?: string;
+                    /** @description Page number */
+                    page?: number;
+                    /** @description Items per page */
+                    limit?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of organizations */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Organization"][];
+                            meta?: {
+                                total?: number;
+                                page?: number;
+                                limit?: number;
+                                totalPages?: number;
+                            };
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        /**
+         * Create a new organization
+         * @description Create a new organization in the hierarchy
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CreateOrganizationDto"];
+                };
+            };
+            responses: {
+                /** @description Organization created successfully */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Organization"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/organizations/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get organization by ID
+         * @description Retrieve detailed information about a specific organization
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Organization information */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Organization"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        /**
+         * Delete organization
+         * @description Remove an organization from the system. Cannot delete organizations with children.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Organization deleted successfully */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update organization
+         * @description Update organization information
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["UpdateOrganizationDto"];
+                };
+            };
+            responses: {
+                /** @description Organization updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Organization"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        trace?: never;
+    };
+    "/plans": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get all plans
+         * @description Retrieve a list of all subscription plans
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Search plans by name or code */
+                    search?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of plans */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Plan"][];
+                    };
+                };
+            };
+        };
+        put?: never;
+        /**
+         * Create a new plan
+         * @description Create a new subscription plan
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CreatePlanDto"];
+                };
+            };
+            responses: {
+                /** @description Plan created successfully */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Plan"];
+                    };
+                };
+                /** @description Plan with this code already exists */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/plans/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a plan by ID
+         * @description Retrieve details of a specific plan
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Plan ID */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Plan found */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Plan"];
+                    };
+                };
+                /** @description Plan not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        /**
+         * Delete a plan
+         * @description Delete an existing plan
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Plan ID */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Plan deleted successfully */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Plan not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update a plan
+         * @description Update an existing plan
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Plan ID */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["UpdatePlanDto"];
+                };
+            };
+            responses: {
+                /** @description Plan updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Plan"];
+                    };
+                };
+                /** @description Plan not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        trace?: never;
+    };
+    "/quiz-attempt-answers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all quiz attempt answers
+         * @description Retrieve a list of all answers submitted in quiz attempts
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Filter by quiz attempt ID */
+                    quizAttemptId?: string;
+                    /** @description Filter by quiz question answer ID */
+                    quizQuestionAnswerId?: string;
+                    /** @description Page number */
+                    page?: number;
+                    /** @description Items per page */
+                    limit?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of quiz attempt answers */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizAttemptAnswer"][];
+                            meta?: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        /**
+         * Submit a quiz attempt answer
+         * @description Record a user's answer for a quiz question
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CreateQuizAttemptAnswerDto"];
+                };
+            };
+            responses: {
+                /** @description Quiz attempt answer submitted successfully */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizAttemptAnswer"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/quiz-attempt-answers/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get quiz attempt answer by ID
+         * @description Retrieve detailed information about a specific quiz attempt answer
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Quiz attempt answer information */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizAttemptAnswer"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        /**
+         * Delete quiz attempt answer
+         * @description Remove a quiz attempt answer from the system
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Quiz attempt answer deleted successfully */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/quiz-attempts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all quiz attempts
+         * @description Retrieve a list of all quiz attempts with optional filtering
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Filter by quiz ID */
+                    quizId?: string;
+                    /** @description Filter by user ID */
+                    userId?: string;
+                    /** @description Filter by passed status */
+                    passed?: boolean;
+                    /** @description Filter by completion status */
+                    completed?: boolean;
+                    /** @description Page number */
+                    page?: number;
+                    /** @description Items per page */
+                    limit?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of quiz attempts */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizAttempt"][];
+                            meta?: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        /**
+         * Create a new quiz attempt
+         * @description Start a new quiz attempt for a user
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CreateQuizAttemptDto"];
+                };
+            };
+            responses: {
+                /** @description Quiz attempt created successfully */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizAttempt"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/quiz-attempts/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get quiz attempt by ID
+         * @description Retrieve detailed information about a specific quiz attempt
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Quiz attempt information */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizAttempt"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        /**
+         * Delete quiz attempt
+         * @description Remove a quiz attempt from the system
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Quiz attempt deleted successfully */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update quiz attempt
+         * @description Update quiz attempt information (score, completion, etc.)
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["UpdateQuizAttemptDto"];
+                };
+            };
+            responses: {
+                /** @description Quiz attempt updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizAttempt"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        trace?: never;
+    };
+    "/quiz-question-answers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all quiz question answers
+         * @description Retrieve a list of all answers for quiz questions
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Filter by question ID */
+                    questionId?: string;
+                    /** @description Filter by correct answers */
+                    isCorrect?: boolean;
+                    /** @description Search in answer text */
+                    search?: string;
+                    /** @description Page number */
+                    page?: number;
+                    /** @description Items per page */
+                    limit?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of quiz question answers */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizQuestionAnswer"][];
+                            meta?: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        /**
+         * Create a new quiz question answer
+         * @description Create a new answer option for a quiz question
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CreateQuizQuestionAnswerDto"];
+                };
+            };
+            responses: {
+                /** @description Quiz question answer created successfully */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizQuestionAnswer"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/quiz-question-answers/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get quiz question answer by ID
+         * @description Retrieve detailed information about a specific quiz question answer
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Quiz question answer information */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizQuestionAnswer"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        /**
+         * Delete quiz question answer
+         * @description Remove a quiz question answer from the system
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Quiz question answer deleted successfully */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update quiz question answer
+         * @description Update quiz question answer information
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["UpdateQuizQuestionAnswerDto"];
+                };
+            };
+            responses: {
+                /** @description Quiz question answer updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizQuestionAnswer"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        trace?: never;
+    };
+    "/quiz-questions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all quiz questions
+         * @description Retrieve a list of all quiz questions with optional filtering
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Filter by quiz ID */
+                    quizId?: string;
+                    /** @description Filter by question type */
+                    type?: "multiple_choice" | "true_false" | "open";
+                    /** @description Search in question text */
+                    search?: string;
+                    /** @description Page number */
+                    page?: number;
+                    /** @description Items per page */
+                    limit?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of quiz questions */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizQuestion"][];
+                            meta?: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        /**
+         * Create a new quiz question
+         * @description Create a new question for a quiz
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CreateQuizQuestionDto"];
+                };
+            };
+            responses: {
+                /** @description Quiz question created successfully */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizQuestion"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                409: components["responses"]["Conflict"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/quiz-questions/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get quiz question by ID
+         * @description Retrieve detailed information about a specific quiz question
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Quiz question information */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizQuestion"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        /**
+         * Delete quiz question
+         * @description Remove a quiz question from the system
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Quiz question deleted successfully */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update quiz question
+         * @description Update quiz question information
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["UpdateQuizQuestionDto"];
+                };
+            };
+            responses: {
+                /** @description Quiz question updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizQuestion"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                409: components["responses"]["Conflict"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        trace?: never;
+    };
+    "/quiz": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all quizzes
+         * @description Retrieve a list of all quizzes with optional filtering
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Filter by quiz title */
+                    title?: string;
+                    /** @description Filter by course ID */
+                    courseId?: string;
+                    /** @description Filter by active status */
+                    isActive?: boolean;
+                    /** @description Filter by creator user ID */
+                    createdBy?: string;
+                    /** @description Search in title */
                     search?: string;
                     /** @description Page number */
                     page?: number;
@@ -3682,7 +5780,7 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description List of organizations */
+                /** @description List of quizzes */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -3691,13 +5789,8 @@ export interface paths {
                         "application/json": {
                             /** @example success */
                             status?: string;
-                            data?: components["schemas"]["Organization"][];
-                            meta?: {
-                                total?: number;
-                                page?: number;
-                                limit?: number;
-                                totalPages?: number;
-                            };
+                            data?: components["schemas"]["Quiz"][];
+                            meta?: components["schemas"]["PaginationMeta"];
                         };
                     };
                 };
@@ -3707,8 +5800,8 @@ export interface paths {
         };
         put?: never;
         /**
-         * Create a new organization
-         * @description Create a new organization in the hierarchy
+         * Create a new quiz
+         * @description Create a new quiz with questions
          */
         post: {
             parameters: {
@@ -3719,11 +5812,11 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["CreateOrganizationDto"];
+                    "application/json": components["schemas"]["CreateQuizDto"];
                 };
             };
             responses: {
-                /** @description Organization created successfully */
+                /** @description Quiz created successfully */
                 201: {
                     headers: {
                         [name: string]: unknown;
@@ -3732,7 +5825,7 @@ export interface paths {
                         "application/json": {
                             /** @example success */
                             status?: string;
-                            data?: components["schemas"]["Organization"];
+                            data?: components["schemas"]["Quiz"];
                         };
                     };
                 };
@@ -3747,7 +5840,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/organizations/{id}": {
+    "/quiz/{id}": {
         parameters: {
             query?: never;
             header?: never;
@@ -3755,8 +5848,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get organization by ID
-         * @description Retrieve detailed information about a specific organization
+         * Get quiz by ID
+         * @description Retrieve detailed information about a specific quiz
          */
         get: {
             parameters: {
@@ -3770,7 +5863,7 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Organization information */
+                /** @description Quiz information */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -3779,7 +5872,7 @@ export interface paths {
                         "application/json": {
                             /** @example success */
                             status?: string;
-                            data?: components["schemas"]["Organization"];
+                            data?: components["schemas"]["Quiz"];
                         };
                     };
                 };
@@ -3792,8 +5885,8 @@ export interface paths {
         put?: never;
         post?: never;
         /**
-         * Delete organization
-         * @description Remove an organization from the system. Cannot delete organizations with children.
+         * Delete quiz
+         * @description Remove a quiz from the system
          */
         delete: {
             parameters: {
@@ -3807,7 +5900,7 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Organization deleted successfully */
+                /** @description Quiz deleted successfully */
                 204: {
                     headers: {
                         [name: string]: unknown;
@@ -3823,8 +5916,8 @@ export interface paths {
         options?: never;
         head?: never;
         /**
-         * Update organization
-         * @description Update organization information
+         * Update quiz
+         * @description Update quiz information
          */
         patch: {
             parameters: {
@@ -3838,11 +5931,11 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["UpdateOrganizationDto"];
+                    "application/json": components["schemas"]["UpdateQuizDto"];
                 };
             };
             responses: {
-                /** @description Organization updated successfully */
+                /** @description Quiz updated successfully */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -3851,7 +5944,7 @@ export interface paths {
                         "application/json": {
                             /** @example success */
                             status?: string;
-                            data?: components["schemas"]["Organization"];
+                            data?: components["schemas"]["Quiz"];
                         };
                     };
                 };
@@ -4891,11 +6984,217 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["CreateSerieDto"];
+                    "application/json": components["schemas"]["CreateSerieDto"];
+                };
+            };
+            responses: {
+                /** @description Serie created successfully */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Serie"];
+                            /** @example Serie created successfully */
+                            message?: string;
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/series/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get serie by ID
+         * @description Retrieve detailed information about a specific serie/grade
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Serie information */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Serie"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        /**
+         * Delete serie
+         * @description Remove a serie from the system
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Serie deleted successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            /** @example Serie deleted successfully */
+                            message?: string;
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update serie
+         * @description Update serie information
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["UpdateSerieDto"];
+                };
+            };
+            responses: {
+                /** @description Serie updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Serie"];
+                            /** @example Serie updated successfully */
+                            message?: string;
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        trace?: never;
+    };
+    "/shifts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all shifts
+         * @description Retrieve a list of all institution shifts (manhã, tarde, noite)
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of shifts */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Shift"][];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        /**
+         * Create a new shift
+         * @description Create a new institution shift
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CreateShiftDto"];
                 };
             };
             responses: {
-                /** @description Serie created successfully */
+                /** @description Shift created successfully */
                 201: {
                     headers: {
                         [name: string]: unknown;
@@ -4904,8 +7203,8 @@ export interface paths {
                         "application/json": {
                             /** @example success */
                             status?: string;
-                            data?: components["schemas"]["Serie"];
-                            /** @example Serie created successfully */
+                            data?: components["schemas"]["Shift"];
+                            /** @example Shift created successfully */
                             message?: string;
                         };
                     };
@@ -4921,7 +7220,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/series/{id}": {
+    "/shifts/{id}": {
         parameters: {
             query?: never;
             header?: never;
@@ -4929,8 +7228,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get serie by ID
-         * @description Retrieve detailed information about a specific serie/grade
+         * Get shift by ID
+         * @description Retrieve detailed information about a specific shift
          */
         get: {
             parameters: {
@@ -4944,7 +7243,7 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Serie information */
+                /** @description Shift information */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4953,7 +7252,7 @@ export interface paths {
                         "application/json": {
                             /** @example success */
                             status?: string;
-                            data?: components["schemas"]["Serie"];
+                            data?: components["schemas"]["Shift"];
                         };
                     };
                 };
@@ -4966,8 +7265,8 @@ export interface paths {
         put?: never;
         post?: never;
         /**
-         * Delete serie
-         * @description Remove a serie from the system
+         * Delete shift
+         * @description Remove a shift from the system
          */
         delete: {
             parameters: {
@@ -4981,7 +7280,7 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Serie deleted successfully */
+                /** @description Shift deleted successfully */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -4990,7 +7289,7 @@ export interface paths {
                         "application/json": {
                             /** @example success */
                             status?: string;
-                            /** @example Serie deleted successfully */
+                            /** @example Shift deleted successfully */
                             message?: string;
                         };
                     };
@@ -5004,8 +7303,8 @@ export interface paths {
         options?: never;
         head?: never;
         /**
-         * Update serie
-         * @description Update serie information
+         * Update shift
+         * @description Update shift information
          */
         patch: {
             parameters: {
@@ -5019,11 +7318,11 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["UpdateSerieDto"];
+                    "application/json": components["schemas"]["UpdateShiftDto"];
                 };
             };
             responses: {
-                /** @description Serie updated successfully */
+                /** @description Shift updated successfully */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5032,8 +7331,8 @@ export interface paths {
                         "application/json": {
                             /** @example success */
                             status?: string;
-                            data?: components["schemas"]["Serie"];
-                            /** @example Serie updated successfully */
+                            data?: components["schemas"]["Shift"];
+                            /** @example Shift updated successfully */
                             message?: string;
                         };
                     };
@@ -5046,7 +7345,7 @@ export interface paths {
         };
         trace?: never;
     };
-    "/shifts": {
+    "/subscriptions": {
         parameters: {
             query?: never;
             header?: never;
@@ -5054,39 +7353,40 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * List all shifts
-         * @description Retrieve a list of all institution shifts (manhã, tarde, noite)
+         * Get all subscriptions
+         * @description Retrieve a list of all subscriptions with optional filters
          */
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    /** @description Filter by plan ID */
+                    planId?: string;
+                    /** @description Filter by institution ID */
+                    institutionId?: string;
+                    /** @description Filter by group ID */
+                    groupId?: string;
+                };
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description List of shifts */
+                /** @description List of subscriptions */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            /** @example success */
-                            status?: string;
-                            data?: components["schemas"]["Shift"][];
-                        };
+                        "application/json": components["schemas"]["Subscription"][];
                     };
                 };
-                401: components["responses"]["Unauthorized"];
-                500: components["responses"]["ServerError"];
             };
         };
         put?: never;
         /**
-         * Create a new shift
-         * @description Create a new institution shift
+         * Create a new subscription
+         * @description Create a subscription linking a plan to an institution or group
          */
         post: {
             parameters: {
@@ -5097,28 +7397,26 @@ export interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["CreateShiftDto"];
+                    "application/json": components["schemas"]["CreateSubscriptionDto"];
                 };
             };
             responses: {
-                /** @description Shift created successfully */
+                /** @description Subscription created successfully */
                 201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            /** @example success */
-                            status?: string;
-                            data?: components["schemas"]["Shift"];
-                            /** @example Shift created successfully */
-                            message?: string;
-                        };
+                        "application/json": components["schemas"]["Subscription"];
                     };
                 };
-                400: components["responses"]["BadRequest"];
-                401: components["responses"]["Unauthorized"];
-                500: components["responses"]["ServerError"];
+                /** @description Invalid request (missing required fields) */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
             };
         };
         delete?: never;
@@ -5127,7 +7425,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/shifts/{id}": {
+    "/subscriptions/{id}": {
         parameters: {
             query?: never;
             header?: never;
@@ -5135,119 +7433,111 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get shift by ID
-         * @description Retrieve detailed information about a specific shift
+         * Get a subscription by ID
+         * @description Retrieve details of a specific subscription
          */
         get: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
-                    /** @description Resource ID */
-                    id: components["parameters"]["id"];
+                    /** @description Subscription ID */
+                    id: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Shift information */
+                /** @description Subscription found */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            /** @example success */
-                            status?: string;
-                            data?: components["schemas"]["Shift"];
-                        };
+                        "application/json": components["schemas"]["Subscription"];
                     };
                 };
-                400: components["responses"]["BadRequest"];
-                401: components["responses"]["Unauthorized"];
-                404: components["responses"]["NotFound"];
-                500: components["responses"]["ServerError"];
+                /** @description Subscription not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
             };
         };
         put?: never;
         post?: never;
         /**
-         * Delete shift
-         * @description Remove a shift from the system
+         * Delete a subscription
+         * @description Delete an existing subscription
          */
         delete: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
-                    /** @description Resource ID */
-                    id: components["parameters"]["id"];
+                    /** @description Subscription ID */
+                    id: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Shift deleted successfully */
-                200: {
+                /** @description Subscription deleted successfully */
+                204: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": {
-                            /** @example success */
-                            status?: string;
-                            /** @example Shift deleted successfully */
-                            message?: string;
-                        };
+                    content?: never;
+                };
+                /** @description Subscription not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
                     };
+                    content?: never;
                 };
-                400: components["responses"]["BadRequest"];
-                401: components["responses"]["Unauthorized"];
-                404: components["responses"]["NotFound"];
-                500: components["responses"]["ServerError"];
             };
         };
         options?: never;
         head?: never;
         /**
-         * Update shift
-         * @description Update shift information
+         * Update a subscription
+         * @description Update an existing subscription
          */
         patch: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
-                    /** @description Resource ID */
-                    id: components["parameters"]["id"];
+                    /** @description Subscription ID */
+                    id: string;
                 };
                 cookie?: never;
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["UpdateShiftDto"];
+                    "application/json": components["schemas"]["UpdateSubscriptionDto"];
                 };
             };
             responses: {
-                /** @description Shift updated successfully */
+                /** @description Subscription updated successfully */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            /** @example success */
-                            status?: string;
-                            data?: components["schemas"]["Shift"];
-                            /** @example Shift updated successfully */
-                            message?: string;
-                        };
+                        "application/json": components["schemas"]["Subscription"];
                     };
                 };
-                400: components["responses"]["BadRequest"];
-                401: components["responses"]["Unauthorized"];
-                404: components["responses"]["NotFound"];
-                500: components["responses"]["ServerError"];
+                /** @description Subscription not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
             };
         };
         trace?: never;
@@ -5445,11 +7735,22 @@ export interface paths {
         };
         put?: never;
         /**
-         * Create a new user
+         * Create a new user (authenticated)
          * @description Creates a new user following this flow:
          *     1. Creates the user in Keycloak with username, email, password, and profile information
          *     2. Retrieves the generated Keycloak user ID
-         *     3. Creates the user in MongoDB using the Keycloak ID as the primary key
+         *     3. Creates the user in the database using the Keycloak ID as the primary key
+         *     4. Associates the user with a group and institution using ONE of two methods:
+         *
+         *     **Method 1: Using seatCodeId (recommended)**
+         *     - Provide seatCodeId to automatically derive groupId and institutionId from the seat code
+         *     - The seat code must be valid, not reserved, and not already in use
+         *     - Creates user_group and institution_registration records automatically
+         *
+         *     **Method 2: Using groupId + institutionId**
+         *     - Provide groupId and institutionId manually
+         *     - System will find an available seat_code for the institution + group combination
+         *     - Creates user_group and institution_registration records
          *
          *     Note: The user ID is automatically generated by Keycloak and should NOT be provided in the request.
          */
@@ -5480,7 +7781,7 @@ export interface paths {
                         /** @example +5511999999999 */
                         phone?: string;
                         /** @example 12345678901 */
-                        document?: number;
+                        document: string;
                         /**
                          * @example male
                          * @enum {string}
@@ -5491,11 +7792,35 @@ export interface paths {
                          * @example 1990-01-15T00:00:00.000Z
                          */
                         birthdate?: string;
+                        /**
+                         * Format: uuid
+                         * @description Optional seat code ID to register the user. When provided, groupId and institutionId
+                         *     are not required as they will be derived from the seat code's associated seat.
+                         *     The seat code must be valid, not reserved, and not already in use by another user.
+                         * @example 550e8400-e29b-41d4-a716-446655440002
+                         */
+                        seatCodeId?: string;
+                        /**
+                         * Format: uuid
+                         * @description Optional group ID to associate the user with a group (creates user_group record).
+                         *     Not required if seatCodeId is provided.
+                         * @example 550e8400-e29b-41d4-a716-446655440000
+                         */
+                        groupId?: string;
+                        /**
+                         * Format: uuid
+                         * @description Optional institution ID to register the user in an institution.
+                         *     Requires groupId to be provided. Will automatically find and assign
+                         *     an available seat_code for the institution + group combination.
+                         *     Not required if seatCodeId is provided.
+                         * @example 550e8400-e29b-41d4-a716-446655440001
+                         */
+                        institutionId?: string;
                     };
                 };
             };
             responses: {
-                /** @description User created successfully in both Keycloak and MongoDB */
+                /** @description User created successfully in both Keycloak and database */
                 201: {
                     headers: {
                         [name: string]: unknown;
@@ -5508,9 +7833,39 @@ export interface paths {
                         };
                     };
                 };
-                400: components["responses"]["BadRequest"];
+                /**
+                 * @description Bad request. Possible causes:
+                 *     - Missing required fields
+                 *     - institutionId provided without groupId (when not using seatCodeId)
+                 *     - No seat found for institution + group combination
+                 *     - No available seat codes for the institution and group
+                 *     - Seat code not found or already in use
+                 *     - Seat code is reserved and cannot be used
+                 */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
                 401: components["responses"]["Unauthorized"];
-                /** @description User already exists (either in Keycloak or MongoDB) */
+                /**
+                 * @description Not found. Possible causes:
+                 *     - Group not found
+                 *     - Institution not found
+                 *     - Seat not found for the seat code
+                 */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description User already exists (either in Keycloak or database) */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -5782,12 +8137,126 @@ export interface paths {
                     /** @description Resource ID */
                     id: components["parameters"]["id"];
                 };
-                cookie?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of user's institutions */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Institution"][];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/users/register": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Public user registration
+         * @description Creates a new user without requiring authentication (public endpoint).
+         *     This endpoint has an additional validation: it only allows registration
+         *     for groups that are NOT of type "other".
+         *
+         *     Allowed group types: student, teacher, school-director
+         *     Blocked group type: other
+         *
+         *     The group type is validated based on:
+         *     - The groupId provided directly, OR
+         *     - The group associated with the seatCodeId (derived from seat)
+         *
+         *     This endpoint follows the same user creation flow as POST /users,
+         *     including Keycloak user creation and optional institution/group associations.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @example John */
+                        firstName: string;
+                        /** @example Doe */
+                        lastName: string;
+                        /**
+                         * Format: email
+                         * @example john.doe@example.com
+                         */
+                        email: string;
+                        /**
+                         * @description Password for the user's Keycloak account
+                         * @example SecurePassword123!
+                         */
+                        password: string;
+                        /** @example +5511999999999 */
+                        phone?: string;
+                        /** @example 12345678901 */
+                        document: string;
+                        /**
+                         * @example male
+                         * @enum {string}
+                         */
+                        gender?: "male" | "female" | "other";
+                        /**
+                         * Format: date-time
+                         * @example 1990-01-15T00:00:00.000Z
+                         */
+                        birthdate?: string;
+                        /**
+                         * Format: uuid
+                         * @description Seat code ID to register the user. When provided, groupId and institutionId
+                         *     are derived from the seat code. Required if groupId is not provided.
+                         * @example 550e8400-e29b-41d4-a716-446655440002
+                         */
+                        seatCodeId?: string;
+                        /**
+                         * Format: uuid
+                         * @description Group ID to associate the user. Required if seatCodeId is not provided.
+                         *     The group must NOT be of type "other".
+                         * @example 550e8400-e29b-41d4-a716-446655440000
+                         */
+                        groupId?: string;
+                        /**
+                         * Format: uuid
+                         * @description Institution ID to register the user. Requires groupId.
+                         * @example 550e8400-e29b-41d4-a716-446655440001
+                         */
+                        institutionId?: string;
+                    };
+                };
             };
-            requestBody?: never;
             responses: {
-                /** @description List of user's institutions */
-                200: {
+                /** @description User created successfully */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5795,18 +8264,51 @@ export interface paths {
                         "application/json": {
                             /** @example success */
                             status?: string;
-                            data?: components["schemas"]["Institution"][];
+                            data?: components["schemas"]["User"];
                         };
                     };
                 };
-                400: components["responses"]["BadRequest"];
-                401: components["responses"]["Unauthorized"];
-                404: components["responses"]["NotFound"];
+                /**
+                 * @description Bad request. Possible causes:
+                 *     - Missing required fields
+                 *     - Neither groupId nor seatCodeId provided
+                 *     - Group type is "other" (not allowed for public registration)
+                 *     - Seat code not found or already in use
+                 *     - Seat code is reserved
+                 */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /**
+                 * @description Not found. Possible causes:
+                 *     - Group not found
+                 *     - Seat not found for the seat code
+                 */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description User already exists (either in Keycloak or database) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
                 500: components["responses"]["ServerError"];
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
@@ -5898,28 +8400,28 @@ export interface components {
              * Format: uuid
              * @description Keycloak User ID
              */
-            id?: string;
+            id: string;
             /** @example John */
-            firstName?: string;
+            firstName: string;
             /** @example Doe */
-            lastName?: string;
+            lastName: string;
             /**
              * Format: email
              * @example john.doe@example.com
              */
-            email?: string;
+            email: string;
             /** @example +5511999999999 */
             phone?: string | null;
             /** @example 12345678901 */
-            document?: number | null;
+            document: string;
             /** @enum {string|null} */
             gender?: "male" | "female" | "other" | null;
             /** Format: date-time */
             birthdate?: string | null;
             /** Format: date-time */
-            createdAt?: string;
+            createdAt: string;
             /** Format: date-time */
-            updatedAt?: string;
+            updatedAt: string;
             /** @description User's group associations */
             userGroups?: components["schemas"]["UserGroup"][];
             /** @description User's guardian associations */
@@ -5965,24 +8467,24 @@ export interface components {
              * Format: uuid
              * @description Keycloak Group ID
              */
-            id?: string;
+            id: string;
             /** @example students */
-            name?: string;
+            name: string;
             /**
              * @description If true, group is automatically associated when creating institutions
              * @example false
              */
-            isDefault?: boolean;
+            isDefault: boolean;
             /**
              * @description Type of the group
              * @example student
              * @enum {string}
              */
-            type?: "student" | "teacher" | "school-director" | "other";
+            type: "student" | "teacher" | "school-director" | "other";
             /** Format: date-time */
-            createdAt?: string;
+            createdAt: string;
             /** Format: date-time */
-            updatedAt?: string;
+            updatedAt: string;
         };
         CreateGroupDto: {
             /** @example students */
@@ -6020,19 +8522,19 @@ export interface components {
         };
         UserGroup: {
             /** Format: uuid */
-            id?: string;
+            id: string;
             /** Format: uuid */
-            userId?: string;
+            userId: string;
             /** Format: uuid */
-            groupId?: string;
+            groupId: string;
             /** Format: date-time */
-            assignedAt?: string;
+            assignedAt: string;
             /** Format: uuid */
             assignedBy?: string | null;
             /** Format: date-time */
-            createdAt?: string;
+            createdAt: string;
             /** Format: date-time */
-            updatedAt?: string;
+            updatedAt: string;
             group?: components["schemas"]["Group"];
         };
         UserGuardian: {
@@ -6086,6 +8588,8 @@ export interface components {
              * @example 5
              */
             certificatesCount?: number;
+            /** @description User's group associations */
+            userGroups?: components["schemas"]["UserGroup"][];
             /** @description User's guardian associations */
             userGuardians?: {
                 /** Format: uuid */
@@ -6113,6 +8617,11 @@ export interface components {
                  * @example true
                  */
                 isActive?: boolean;
+                /**
+                 * Format: date-time
+                 * @description Date when the user was registered in the institution
+                 */
+                createdAt?: string;
                 /** @description Classroom assignment details */
                 institutionClassroom?: {
                     /** Format: uuid */
@@ -6153,19 +8662,28 @@ export interface components {
             meta?: components["schemas"]["PaginationMeta"];
         };
         InstitutionRegistration: {
-            /** Format: uuid */
+            /**
+             * Format: uuid
+             * @description Unique identifier
+             */
             id?: string;
-            /** Format: uuid */
+            /**
+             * Format: uuid
+             * @description User ID
+             */
             userId?: string;
-            /** Format: uuid */
+            /**
+             * Format: uuid
+             * @description Institution ID
+             */
             institutionId?: string;
             /**
              * Format: uuid
-             * @description ID of the institution classroom assignment
+             * @description Classroom ID
              */
             institutionClassroomId?: string | null;
             /**
-             * @description Indicates if the user is active in the institution
+             * @description Whether the registration is active
              * @example true
              */
             isActive?: boolean;
@@ -6177,6 +8695,13 @@ export interface components {
             institution?: components["schemas"]["Institution"];
             /** @description Classroom assignment with complete details (classroom, shift, serie) */
             institutionClassroom?: components["schemas"]["InstitutionClassroom"];
+            /**
+             * Format: uuid
+             * @description Seat Code ID
+             */
+            seatCodeId?: string;
+            user?: components["schemas"]["User"];
+            seatCode?: components["schemas"]["SeatCode"];
         };
         InstitutionClassroom: {
             /** Format: uuid */
@@ -6207,9 +8732,9 @@ export interface components {
              * Format: uuid
              * @description Keycloak Role ID
              */
-            id?: string;
+            id: string;
             /** @example admin */
-            name?: string;
+            name: string;
             /**
              * @description Role description
              * @example Administrator role with full permissions
@@ -6223,9 +8748,9 @@ export interface components {
             /** @description Application details if this is a client role */
             application?: components["schemas"]["Application"];
             /** Format: date-time */
-            createdAt?: string;
+            createdAt: string;
             /** Format: date-time */
-            updatedAt?: string;
+            updatedAt: string;
         };
         CreateRoleDto: {
             /** @example admin */
@@ -6253,20 +8778,20 @@ export interface components {
         };
         Institution: {
             /** Format: uuid */
-            id?: string;
+            id: string;
             /** @example Academe Institution */
-            name?: string;
+            name: string;
             /** @example SCH001 */
-            code?: string;
+            code: string;
             /** @example 12.345.678/0001-90 */
-            document?: string;
+            document: string;
             /** Format: email */
-            email?: string;
+            email: string;
             phone?: string | null;
             /** @example 500 */
-            maxStudents?: number;
+            maxStudents: number;
             /** @example true */
-            isActive?: boolean;
+            isActive: boolean;
             /** Format: uri */
             logoUrl?: string | null;
             /** Format: uri */
@@ -6276,9 +8801,9 @@ export interface components {
             /** Format: uuid */
             institutionRewardId?: string | null;
             /** Format: date-time */
-            createdAt?: string;
+            createdAt: string;
             /** Format: date-time */
-            updatedAt?: string;
+            updatedAt: string;
         };
         Organization: {
             /** Format: uuid */
@@ -6363,36 +8888,40 @@ export interface components {
         };
         Certificate: {
             /** Format: uuid */
-            id?: string;
-            /** Format: uuid */
-            userId?: string;
-            /** Format: uuid */
-            courseId?: string | null;
+            id: string;
             /** Format: uuid */
-            courseModuleId?: string | null;
-            quizId?: string | null;
-            quizTitle?: string | null;
-            quizCategory?: string | null;
-            attemptId?: string | null;
-            attemptScore?: number | null;
-            attemptPassed?: boolean | null;
-            attemptTimeTakenInMinutes?: number | null;
-            /** Format: date-time */
-            attemptCompletedAt?: string | null;
-            certificateId?: string | null;
-            certificateNumber?: string | null;
-            /** Format: date-time */
-            certificateIssuedAt?: string | null;
-            /** Format: uri */
-            certificateDownloadUrl?: string | null;
-            /** Format: date-time */
-            dispatchedAt?: string | null;
-            /** Format: date-time */
-            insertedAt?: string | null;
+            userId: string;
+            /**
+             * Format: uuid
+             * @description Quiz attempt that generated the certificate
+             */
+            quizAttemptId?: string | null;
+            /**
+             * Format: uuid
+             * @description Certificate template used
+             */
+            certificateTemplateId: string;
+            /**
+             * @description Unique certificate number
+             * @example CERT-2024-000001
+             */
+            certificateNumber: string;
+            /**
+             * Format: uri
+             * @description URL of the generated certificate PDF
+             * @example https://example.com/certificates/cert-123.pdf
+             */
+            url?: string | null;
             /** Format: date-time */
-            createdAt?: string;
+            createdAt: string;
             /** Format: date-time */
-            updatedAt?: string;
+            updatedAt: string;
+            /** @description User who received the certificate */
+            user?: components["schemas"]["User"];
+            /** @description Quiz attempt details (if applicable) */
+            quizAttempt?: components["schemas"]["QuizAttempt"];
+            /** @description Template used for the certificate */
+            certificateTemplate?: components["schemas"]["CertificateTemplate"];
         };
         Guardian: {
             /** Format: uuid */
@@ -6487,6 +9016,16 @@ export interface components {
             name: string;
             /** @description Application description */
             description?: string | null;
+            /**
+             * @description JSON object with application settings and rules
+             * @example {
+             *       "mike": {
+             *         "enabled": true,
+             *         "daily_limit": 60
+             *       }
+             *     }
+             */
+            settings?: Record<string, never>;
             /** Format: date-time */
             createdAt?: string;
             /** Format: date-time */
@@ -6499,12 +9038,24 @@ export interface components {
             name: string;
             /** @description Application description */
             description?: string;
+            /**
+             * @description JSON object with application settings
+             * @example {
+             *       "mike": {
+             *         "enabled": true,
+             *         "daily_limit": 60
+             *       }
+             *     }
+             */
+            settings?: Record<string, never>;
         };
         UpdateApplicationDto: {
             /** @description Application name */
             name?: string;
             /** @description Application description */
             description?: string;
+            /** @description JSON object with application settings */
+            settings?: Record<string, never>;
         };
         AuthenticatedUser: {
             /** @description Keycloak user ID */
@@ -6553,7 +9104,150 @@ export interface components {
             /** @description Whether the classroom is active in the institution */
             isActive?: boolean;
         };
-        InstitutionGroup: {
+        CreateInstitutionRegistrationDto: {
+            /**
+             * Format: uuid
+             * @description User ID to register in the institution
+             */
+            userId: string;
+            /** @description The seat code to redeem for registration */
+            seatCode: string;
+            /**
+             * Format: uuid
+             * @description Optional classroom ID to assign the user to
+             */
+            institutionClassroomId?: string | null;
+            /**
+             * @description Whether the registration is active
+             * @default true
+             */
+            isActive: boolean;
+        };
+        UpdateInstitutionRegistrationDto: {
+            /**
+             * Format: uuid
+             * @description Classroom ID to assign the user to (null to remove)
+             */
+            institutionClassroomId?: string | null;
+            /** @description Whether the registration is active */
+            isActive?: boolean;
+        };
+        AssignClassroomDto: {
+            /**
+             * Format: uuid
+             * @description Classroom ID to assign the user to (null to remove assignment)
+             */
+            institutionClassroomId?: string | null;
+        };
+        /** @description Seat with institution data included */
+        SeatWithInstitution: {
+            /** Format: uuid */
+            id?: string;
+            name?: string;
+            description?: string;
+            /** Format: uuid */
+            institutionId?: string;
+            /** Format: uuid */
+            groupId?: string;
+            availableQuantity?: number;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+            group?: components["schemas"]["Group"];
+            institution?: components["schemas"]["Institution"];
+        };
+        /** @description Seat code with seat and institution data included */
+        SeatCodeWithInstitution: {
+            /**
+             * Format: uuid
+             * @description Unique identifier
+             */
+            id?: string;
+            /** @description Unique seat code */
+            code?: string;
+            /**
+             * Format: uuid
+             * @description Seat ID this code belongs to
+             */
+            seatId?: string;
+            /** @description Whether the code is reserved (used) */
+            isReserved?: boolean;
+            /** Format: date-time */
+            createdAt?: string;
+            seat?: components["schemas"]["SeatWithInstitution"];
+        };
+        /** @description User associated with the registration */
+        SeatCodeRegistrationUser: {
+            /** Format: uuid */
+            id?: string;
+            /** @description User's first name */
+            firstName?: string;
+            /** @description User's last name */
+            lastName?: string;
+            /** Format: email */
+            email?: string;
+        } | null;
+        /** @description Institution registration associated with this seat code (if reserved) */
+        SeatCodeRegistration: {
+            /** Format: uuid */
+            id?: string;
+            /** Format: uuid */
+            userId?: string;
+            /** Format: uuid */
+            institutionId?: string;
+            isActive?: boolean;
+            /** Format: date-time */
+            createdAt?: string;
+            user?: components["schemas"]["SeatCodeRegistrationUser"];
+        } | null;
+        SeatCode: {
+            /**
+             * Format: uuid
+             * @description Unique identifier
+             */
+            id?: string;
+            /** @description Unique seat code */
+            code?: string;
+            /**
+             * Format: uuid
+             * @description Seat ID this code belongs to
+             */
+            seatId?: string;
+            /** @description Whether the code is reserved (used) */
+            isReserved?: boolean;
+            /** Format: date-time */
+            createdAt?: string;
+            seat?: components["schemas"]["Seats"];
+            institutionRegistration?: components["schemas"]["SeatCodeRegistration"];
+        };
+        CreateSeatCodesDto: {
+            /**
+             * Format: uuid
+             * @description Seat ID to generate codes for
+             */
+            seatId: string;
+            /** @description Number of codes to generate */
+            quantity: number;
+        };
+        SendCodeDto: {
+            /** @description Phone number to send the license link via WhatsApp */
+            phone: string;
+            /** @description Name of the recipient (optional) */
+            name?: string;
+            /** @description Seat code string to send (optional). If not provided, will find an available code from the seatId */
+            code?: string;
+            /**
+             * Format: uuid
+             * @description Seat ID to find an available code from (optional). Required if code is not provided
+             */
+            seatId?: string;
+        };
+        UpdateSeatCodeDto: {
+            /** @description Whether the code is reserved */
+            isReserved?: boolean;
+        };
+        Seats: {
             /**
              * Format: uuid
              * @description Unique identifier
@@ -6563,7 +9257,7 @@ export interface components {
              * Format: uuid
              * @description Institution ID
              */
-            institutionId?: string;
+            institutionId?: string | null;
             /**
              * Format: uuid
              * @description Group ID
@@ -6571,13 +9265,15 @@ export interface components {
             groupId?: string;
             /** @description Available quantity for this group in the institution */
             availableQuantity?: number;
+            /** @description Number of users currently assigned to this group in the institution */
+            usedQuantity?: number;
             /** Format: date-time */
             createdAt?: string;
             /** Format: date-time */
             updatedAt?: string;
             group?: components["schemas"]["Group"];
         };
-        CreateInstitutionGroupDto: {
+        CreateSeatsDto: {
             /**
              * Format: uuid
              * @description Group ID to associate with the institution
@@ -6589,42 +9285,79 @@ export interface components {
              */
             availableQuantity: number;
         };
-        UpdateInstitutionGroupDto: {
+        UpdateSeatsDto: {
             /** @description New available quantity for this group */
             availableQuantity: number;
         };
-        CreateInstitutionRegistrationDto: {
+        Plan: {
             /**
              * Format: uuid
-             * @description User ID to register in the institution
+             * @description Unique identifier for the plan
              */
-            userId: string;
+            id: string;
             /**
-             * Format: uuid
-             * @description Optional classroom ID to assign the user to
+             * @description Unique code for the plan (e.g., gold_plan, free_tier)
+             * @example gold_plan
              */
-            institutionClassroomId?: string | null;
+            code: string;
             /**
-             * @description Whether the registration is active
+             * @description Display name of the plan
+             * @example Plano Gold
+             */
+            name: string;
+            /**
+             * @description JSON object with plan settings and configurations
+             * @example {
+             *       "maxUsers": 100,
+             *       "features": [
+             *         "analytics",
+             *         "support"
+             *       ]
+             *     }
+             */
+            settings: Record<string, never>;
+            /**
+             * @description Whether the plan is currently active
              * @default true
              */
             isActive: boolean;
-        };
-        UpdateInstitutionRegistrationDto: {
             /**
-             * Format: uuid
-             * @description Classroom ID to assign the user to (null to remove)
+             * Format: date-time
+             * @description Timestamp when the plan was created
              */
-            institutionClassroomId?: string | null;
-            /** @description Whether the registration is active */
-            isActive?: boolean;
+            createdAt?: string;
         };
-        AssignClassroomDto: {
+        CreatePlanDto: {
             /**
-             * Format: uuid
-             * @description Classroom ID to assign the user to (null to remove assignment)
+             * @description Unique code for the plan
+             * @example gold_plan
              */
-            institutionClassroomId?: string | null;
+            code: string;
+            /**
+             * @description Display name of the plan
+             * @example Plano Gold
+             */
+            name: string;
+            /**
+             * @description JSON object with plan settings
+             * @example {
+             *       "maxUsers": 100
+             *     }
+             */
+            settings?: Record<string, never>;
+            /**
+             * @description Whether the plan is active
+             * @default true
+             */
+            isActive: boolean;
+        };
+        UpdatePlanDto: {
+            /** @description Display name of the plan */
+            name?: string;
+            /** @description JSON object with plan settings */
+            settings?: Record<string, never>;
+            /** @description Whether the plan is active */
+            isActive?: boolean;
         };
         StudentWithClass: {
             /** Format: uuid */
@@ -6709,12 +9442,72 @@ export interface components {
             totalStudents?: number;
             year?: number;
         };
-        CreateUserDto: {
+        Subscription: {
             /**
              * Format: uuid
-             * @description Keycloak User ID
+             * @description Unique identifier for the subscription
              */
             id: string;
+            /**
+             * Format: uuid
+             * @description ID of the associated plan
+             */
+            planId: string;
+            /**
+             * Format: uuid
+             * @description ID of the associated institution (optional)
+             */
+            institutionId?: string | null;
+            /**
+             * Format: uuid
+             * @description ID of the associated group (optional)
+             */
+            groupId?: string | null;
+            /**
+             * Format: date-time
+             * @description Timestamp when the subscription was created
+             */
+            createdAt?: string;
+            plan?: components["schemas"]["Plan"];
+            institution?: components["schemas"]["Institution"];
+            group?: components["schemas"]["Group"];
+        };
+        /** @description At least one of institutionId or groupId must be provided */
+        CreateSubscriptionDto: {
+            /**
+             * Format: uuid
+             * @description ID of the plan to subscribe to
+             */
+            planId: string;
+            /**
+             * Format: uuid
+             * @description ID of the institution (required if groupId is not provided)
+             */
+            institutionId?: string | null;
+            /**
+             * Format: uuid
+             * @description ID of the group (required if institutionId is not provided)
+             */
+            groupId?: string | null;
+        };
+        UpdateSubscriptionDto: {
+            /**
+             * Format: uuid
+             * @description ID of the plan
+             */
+            planId?: string;
+            /**
+             * Format: uuid
+             * @description ID of the institution
+             */
+            institutionId?: string | null;
+            /**
+             * Format: uuid
+             * @description ID of the group
+             */
+            groupId?: string | null;
+        };
+        CreateUserDto: {
             /** @example John */
             firstName: string;
             /** @example Doe */
@@ -6724,10 +9517,15 @@ export interface components {
              * @example john.doe@example.com
              */
             email: string;
+            /**
+             * @description Password for the user's Keycloak account
+             * @example SecurePassword123!
+             */
+            password: string;
             /** @example +5511999999999 */
             phone?: string;
             /** @example 12345678901 */
-            document?: number;
+            document: string;
             /**
              * @example male
              * @enum {string}
@@ -6738,6 +9536,18 @@ export interface components {
              * @example 1990-01-01T00:00:00Z
              */
             birthdate?: string;
+            /**
+             * Format: uuid
+             * @description Optional group ID to associate the user with a group
+             * @example 550e8400-e29b-41d4-a716-446655440000
+             */
+            groupId?: string;
+            /**
+             * Format: uuid
+             * @description Optional institution ID to register the user (requires groupId)
+             * @example 550e8400-e29b-41d4-a716-446655440001
+             */
+            institutionId?: string;
         };
         UserResponse: components["schemas"]["User"];
         CreateInstitutionDto: {
@@ -6860,40 +9670,25 @@ export interface components {
             /** Format: uuid */
             userId: string;
             /** Format: uuid */
-            courseId?: string;
+            quizAttemptId?: string;
             /** Format: uuid */
-            courseModuleId?: string;
-            quizId?: string;
-            quizTitle?: string;
-            quizCategory?: string;
-            attemptId?: string;
-            attemptScore?: number;
-            attemptPassed?: boolean;
-            attemptTimeTakenInMinutes?: number;
-            /** Format: date-time */
-            attemptCompletedAt?: string;
-            certificateId?: string;
-            certificateNumber?: string;
-            /** Format: date-time */
-            certificateIssuedAt?: string;
-            /** Format: uri */
-            certificateDownloadUrl?: string;
+            certificateTemplateId: string;
+            /** @example CERT-2024-000001 */
+            certificateNumber: string;
+            /**
+             * Format: uri
+             * @example https://example.com/certificates/cert-123.pdf
+             */
+            url?: string;
         };
         UpdateCertificateDto: {
-            quizTitle?: string;
-            quizCategory?: string;
-            attemptScore?: number;
-            attemptPassed?: boolean;
-            attemptTimeTakenInMinutes?: number;
-            /** Format: date-time */
-            attemptCompletedAt?: string;
+            /** Format: uuid */
+            quizAttemptId?: string;
+            /** Format: uuid */
+            certificateTemplateId?: string;
             certificateNumber?: string;
-            /** Format: date-time */
-            certificateIssuedAt?: string;
             /** Format: uri */
-            certificateDownloadUrl?: string;
-            /** Format: date-time */
-            dispatchedAt?: string;
+            url?: string;
         };
         CreateGuardianDto: {
             /**
@@ -6981,6 +9776,275 @@ export interface components {
             /** Format: uuid */
             institutionId: string;
         };
+        Quiz: {
+            /** Format: uuid */
+            id?: string;
+            /** Format: uuid */
+            courseId?: string;
+            /** @example JavaScript Fundamentals Quiz */
+            title?: string;
+            /** @example Test your knowledge of JavaScript basics */
+            description?: string;
+            /**
+             * @default 70
+             * @example 70
+             */
+            passingScore: number;
+            /**
+             * @description Time limit in minutes
+             * @example 60
+             */
+            timeLimit?: number;
+            /** @example 3 */
+            maxAttempts?: number;
+            /** @default false */
+            randomizeQuestions: boolean;
+            /** @default true */
+            showCorrectAnswers: boolean;
+            /** @default true */
+            isActive: boolean;
+            /** Format: uuid */
+            createdBy?: string;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+        };
+        CreateQuizDto: {
+            /** Format: uuid */
+            courseId?: string;
+            /** @example JavaScript Fundamentals Quiz */
+            title: string;
+            /** @example Test your knowledge of JavaScript basics */
+            description?: string;
+            /** @example 70 */
+            passingScore?: number;
+            /** @example 60 */
+            timeLimit?: number;
+            /** @example 3 */
+            maxAttempts?: number;
+            randomizeQuestions?: boolean;
+            showCorrectAnswers?: boolean;
+            isActive?: boolean;
+            /** Format: uuid */
+            createdBy: string;
+        };
+        UpdateQuizDto: {
+            /** Format: uuid */
+            courseId?: string;
+            title?: string;
+            description?: string;
+            passingScore?: number;
+            timeLimit?: number;
+            maxAttempts?: number;
+            randomizeQuestions?: boolean;
+            showCorrectAnswers?: boolean;
+            isActive?: boolean;
+        };
+        QuizQuestion: {
+            /** Format: uuid */
+            id?: string;
+            /** Format: uuid */
+            quizId?: string;
+            /** @example What is a closure in JavaScript? */
+            text?: string;
+            /**
+             * @example multiple_choice
+             * @enum {string}
+             */
+            type?: "multiple_choice" | "true_false" | "open";
+            /**
+             * @default 1
+             * @example 1
+             */
+            order: number;
+            /**
+             * @default 1
+             * @example 1
+             */
+            points: number;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+        };
+        CreateQuizQuestionDto: {
+            /** Format: uuid */
+            quizId: string;
+            /** @example What is a closure in JavaScript? */
+            text: string;
+            /**
+             * @example multiple_choice
+             * @enum {string}
+             */
+            type: "multiple_choice" | "true_false" | "open";
+            order?: number;
+            points?: number;
+        };
+        UpdateQuizQuestionDto: {
+            text?: string;
+            /** @enum {string} */
+            type?: "multiple_choice" | "true_false" | "open";
+            order?: number;
+            points?: number;
+        };
+        QuizQuestionAnswer: {
+            /** Format: uuid */
+            id?: string;
+            /** Format: uuid */
+            questionId?: string;
+            /** @example A closure is a function that has access to its outer function scope */
+            answer?: string;
+            /** @example true */
+            isCorrect?: boolean;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+        };
+        CreateQuizQuestionAnswerDto: {
+            /** Format: uuid */
+            questionId: string;
+            /** @example A closure is a function that has access to its outer function scope */
+            answer: string;
+            /** @example true */
+            isCorrect: boolean;
+        };
+        UpdateQuizQuestionAnswerDto: {
+            answer?: string;
+            isCorrect?: boolean;
+        };
+        QuizAttempt: {
+            /** Format: uuid */
+            id?: string;
+            /** Format: uuid */
+            quizId?: string;
+            /** Format: uuid */
+            userId?: string;
+            /**
+             * @default 0
+             * @example 85
+             */
+            score: number;
+            /**
+             * @default false
+             * @example true
+             */
+            passed: boolean;
+            /** Format: date-time */
+            startedAt?: string;
+            /** Format: date-time */
+            completedAt?: string;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+        };
+        CreateQuizAttemptDto: {
+            /** Format: uuid */
+            quizId: string;
+            /** Format: uuid */
+            userId: string;
+            score?: number;
+            passed?: boolean;
+            /** Format: date-time */
+            startedAt?: string;
+        };
+        UpdateQuizAttemptDto: {
+            score?: number;
+            passed?: boolean;
+            /** Format: date-time */
+            completedAt?: string;
+        };
+        QuizAttemptAnswer: {
+            /** Format: uuid */
+            id?: string;
+            /** Format: uuid */
+            quizAttemptId?: string;
+            /** Format: uuid */
+            quizQuestionAnswerId?: string;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+        };
+        CreateQuizAttemptAnswerDto: {
+            /** Format: uuid */
+            quizAttemptId: string;
+            /** Format: uuid */
+            quizQuestionAnswerId: string;
+        };
+        CertificateTemplate: {
+            /** Format: uuid */
+            id?: string;
+            /** @example Default Certificate Template */
+            name?: string;
+            /** @example Standard certificate template for course completion */
+            description?: string;
+            /**
+             * @example {
+             *       "background_image_url": "https://example.com/bg.png",
+             *       "logo_url": "https://example.com/logo.png",
+             *       "text_color": "#000000",
+             *       "font_family": "Arial"
+             *     }
+             */
+            templateData?: {
+                [key: string]: unknown;
+            };
+            /** @default false */
+            isDefault: boolean;
+            /** Format: uuid */
+            quizId?: string;
+            /** Format: uuid */
+            courseId?: string;
+            /** Format: uuid */
+            organizationId?: string;
+            /** Format: uuid */
+            institutionId?: string;
+            /** @default true */
+            isActive: boolean;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt?: string;
+        };
+        CreateCertificateTemplateDto: {
+            /** @example Default Certificate Template */
+            name: string;
+            /** @example Standard certificate template for course completion */
+            description?: string;
+            templateData?: {
+                [key: string]: unknown;
+            };
+            isDefault?: boolean;
+            /** Format: uuid */
+            quizId?: string;
+            /** Format: uuid */
+            courseId?: string;
+            /** Format: uuid */
+            organizationId?: string;
+            /** Format: uuid */
+            institutionId?: string;
+            isActive?: boolean;
+        };
+        UpdateCertificateTemplateDto: {
+            name?: string;
+            description?: string;
+            templateData?: {
+                [key: string]: unknown;
+            };
+            isDefault?: boolean;
+            /** Format: uuid */
+            quizId?: string;
+            /** Format: uuid */
+            courseId?: string;
+            /** Format: uuid */
+            organizationId?: string;
+            /** Format: uuid */
+            institutionId?: string;
+            isActive?: boolean;
+        };
     };
     responses: {
         /** @description Resource not found */