docs: Improve Swagger JSDoc

server/api/controllers/custom-field-groups/create-in-board.js

@@ -7,10 +7,11 @@
  * @swagger
  * /boards/{boardId}/custom-field-groups:
  *   post:
- *     summary: Create custom field group in board
+ *     summary: Create board custom field group
  *     description: Creates a custom field group within a board. Either `baseCustomFieldGroupId` or `name` must be provided. Requires board editor permissions.
  *     tags:
  *       - Custom Field Groups
+ *     operationId: createBoardCustomFieldGroup
  *     parameters:
  *       - name: boardId
  *         in: path

server/api/controllers/custom-field-groups/create-in-card.js

@@ -7,10 +7,11 @@
  * @swagger
  * /cards/{cardId}/custom-field-groups:
  *   post:
- *     summary: Create custom field group in card
+ *     summary: Create card custom field group
  *     description: Creates a custom field group within a card. Either `baseCustomFieldGroupId` or `name` must be provided. Requires board editor permissions.
  *     tags:
  *       - Custom Field Groups
+ *     operationId: createCardCustomFieldGroup
  *     parameters:
  *       - name: cardId
  *         in: path

server/api/controllers/custom-field-groups/delete.js

@@ -11,6 +11,7 @@
  *     description: Deletes a custom field group. Requires board editor permissions.
  *     tags:
  *       - Custom Field Groups
+ *     operationId: deleteCustomFieldGroup
  *     parameters:
  *       - name: id
  *         in: path

server/api/controllers/custom-field-groups/show.js

@@ -11,6 +11,7 @@
  *     description: Retrieves comprehensive custom field group information, including fields and values. Requires access to the board/card.
  *     tags:
  *       - Custom Field Groups
+ *     operationId: getCustomFieldGroup
  *     parameters:
  *       - name: id
  *         in: path
@@ -40,14 +41,14 @@
  *                   properties:
  *                     customFields:
  *                       type: array
+ *                       description: Related custom fields
  *                       items:
  *                         $ref: '#/components/schemas/CustomField'
- *                       description: Related custom fields
  *                     customFieldValues:
  *                       type: array
+ *                       description: Related custom field values (for card-specific groups)
  *                       items:
  *                         $ref: '#/components/schemas/CustomFieldValue'
- *                       description: Related custom field values (for card-specific groups)
  *       400:
  *         $ref: '#/components/responses/ValidationError'
  *       401:

server/api/controllers/custom-field-groups/update.js

@@ -11,6 +11,7 @@
  *     description: Updates a custom field group. Supports both board-wide and card-specific groups. Requires board editor permissions.
  *     tags:
  *       - Custom Field Groups
+ *     operationId: updateCustomFieldGroup
  *     parameters:
  *       - name: id
  *         in: path