Sindbad~EG File Manager

/**
 * @swagger
 * components:
 *   schemas:
 *     Employer:
 *       type: object
 *       required:
 *         - company
 *         - title
 *         - street
 *         - city
 *         - state_or_province
 *         - country
 *         - zip_code
 *         - industry
 *         - occupation
 *         - employed_from
 *         - employee_first_name
 *         - employee_last_name
 *         - add_number
 *         - add_email
 *         - line_of_business
 *         - expiration_premium
 *         - term
 *         - related_policy
 *         - x_date_description
 *         - contact_id
 *       properties:
 *         company:
 *           type: string
 *           description: The name of the company
 *         title:
 *           type: string
 *           description: The title of the employee
 *         street:
 *           type: string
 *           description: The street address of the company
 *         apt_or_suite:
 *           type: string
 *           description: The apartment or suite number (if applicable)
 *         city:
 *           type: string
 *           description: The city where the company is located
 *         state_or_province:
 *           type: string
 *           description: The state or province where the company is located
 *         country:
 *           type: string
 *           description: The country where the company is located
 *         zip_code:
 *           type: string
 *           description: The ZIP code of the company's location
 *         employer_web_page:
 *           type: string
 *           description: The web page of the company
 *         industry:
 *           type: string
 *           description: The industry in which the company operates
 *         occupation:
 *           type: string
 *           description: The occupation of the employee
 *         employed_from:
 *           type: string
 *           description: The start date of the employment
 *         employed_to:
 *           type: string
 *           description: The end date of the employment (if applicable)
 *         employee_first_name:
 *           type: string
 *           description: The first name of the employee
 *         employee_last_name:
 *           type: string
 *           description: The last name of the employee
 *         add_number:
 *           type: object
 *           properties:
 *             value:
 *               type: string
 *               description: The phone number of the company
 *             type:
 *               type: string
 *               description: The type of phone number (e.g., office, mobile)
 *         add_email:
 *           type: object
 *           properties:
 *             value:
 *               type: string
 *               description: The email address of the company
 *             type:
 *               type: string
 *               description: The type of email address
 *         comments:
 *           type: string
 *           description: Additional comments about the employment
 *         line_of_business:
 *           type: string
 *           description: The line of business related to the policy
 *         expiration_premium:
 *           type: string
 *           description: The expiration premium amount for the policy
 *         term:
 *           type: array
 *           items:
 *             type: string
 *           description: The terms of the policy
 *         related_policy:
 *           type: string
 *           description: The related policy identifier
 *         x_date_description:
 *           type: string
 *           description: A description of the X date
 *         contact_id:
 *           type: string
 *           description: The ID of the associated contact
 *       example:
 *         company: "Example Company"
 *         title: "CEO"
 *         street: "123 Main St"
 *         apt_or_suite: "Suite 456"
 *         city: "Anytown"
 *         state_or_province: "AnyState"
 *         country: "AnyCountry"
 *         zip_code: "12345"
 *         employer_web_page: "http://www.example.com"
 *         industry: "Technology"
 *         occupation: "Software Engineer"
 *         employed_from: "2022-01-01"
 *         employed_to: "2023-01-01"
 *         employee_first_name: "John"
 *         employee_last_name: "Doe"
 *         add_number:
 *           value: "555-1234"
 *           type: "office"
 *         add_email:
 *           value: "john.doe@example.com"
 *           type: "work"
 *         comments: "Great place to work."
 *         line_of_business: "Insurance"
 *         expiration_premium: "1000.00"
 *         term: ["Monthly", "Annual"]
 *         related_policy: "POL123456"
 *         x_date_description: "Next review date in January"
 *         contact_id: "6679d98f6bc36cd891ccab49"
 *     UpdateResponse:
 *       type: object
 *       properties:
 *         message:
 *           type: string
 *           example: "Data updated successfully"
 *     DeleteResponse:
 *       type: object
 *       properties:
 *         message:
 *           type: string
 *           example: "entry_name and related data deleted successfully"
 *   securitySchemes:
 *     bearerAuth:
 *       type: http
 *       scheme: bearer
 *       bearerFormat: JWT
 */

/**
 * @swagger
 * tags:
 *   - name: Employer
 *     description: Operations related to Employer
 */

/**
 * @swagger
 * /employer/list:
 *   get:
 *     summary: Returns the list of Employers
 *     tags: [Employer]
 *     security:
 *       - bearerAuth: []
 *     responses:
 *       200:
 *         description: The list of Employers
 *         content:
 *           application/json:
 *             schema:
 *               type: array
 *               items:
 *                 $ref: '#/components/schemas/Employer'
 */

/**
 * @swagger
 * /employer/add:
 *   post:
 *     summary: Create a new Employer entry
 *     tags: [Employer]
 *     security:
 *       - bearerAuth: []
 *     requestBody:
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             $ref: '#/components/schemas/Employer'
 *     responses:
 *       201:
 *         description: The Employer entry was successfully created
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/Employer'
 */

/**
 * @swagger
 * /employer/edit/{id}:
 *   put:
 *     summary: Update the Employer entry by ID
 *     tags: [Employer]
 *     security:
 *       - bearerAuth: []
 *     parameters:
 *       - in: path
 *         name: id
 *         schema:
 *           type: string
 *         required: true
 *         description: The ID of the Employer entry
 *     requestBody:
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             $ref: '#/components/schemas/Employer'
 *     responses:
 *       200:
 *         description: The Employer entry was successfully updated
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/UpdateResponse'
 */

/**
 * @swagger
 * /employer/delete/{id}:
 *   delete:
 *     summary: Delete the Employer entry by ID
 *     tags: [Employer]
 *     security:
 *       - bearerAuth: []
 *     parameters:
 *       - in: path
 *         name: id
 *         schema:
 *           type: string
 *         required: true
 *         description: The ID of the Employer entry
 *     responses:
 *       200:
 *         description: The Employer entry was successfully deleted
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/DeleteResponse'

 */