Sindbad~EG File Manager

/**
 * @swagger
 * components:
 *   schemas:
 *     AdditionalInterest:
 *       type: object
 *       properties:
 *         interest:
 *           type: object
 *           properties:
 *             interest:
 *               type: string
 *               description: The type of interest
 *             description:
 *               type: string
 *               description: Description of the interest
 *             interest_is_payor:
 *               type: boolean
 *               description: Indicates if the interest is a payor
 *             information_billing:
 *               type: boolean
 *               description: Indicates if billing information is required
 *             rank:
 *               type: string
 *               description: Rank of the interest
 *             policy_frequency:
 *               type: string
 *               description: Frequency of the policy
 *             policy_required:
 *               type: string
 *               description: Requirement for the policy
 *             reference:
 *               type: string
 *               description: Reference information
 *             certificate_frequency:
 *               type: string
 *               description: Frequency of the certificate
 *             certificate_required:
 *               type: string
 *               description: Requirement for the certificate
 *             billing_frequency:
 *               type: string
 *               description: Frequency of billing
 *         name_and_address:
 *           type: object
 *           properties:
 *             name:
 *               type: string
 *               description: Name of the contact
 *             street_address:
 *               type: string
 *               description: Street address
 *             apt:
 *               type: string
 *               description: Apartment number
 *             address_line:
 *               type: string
 *               description: Additional address line
 *             country:
 *               type: string
 *               description: Country of the address
 *             city:
 *               type: string
 *               description: City of the address
 *             province:
 *               type: string
 *               description: Province of the address
 *             county:
 *               type: string
 *               description: County of the address
 *             zip_code:
 *               type: number
 *               description: ZIP code
 *             interest_phone:
 *               type: object
 *               properties:
 *                 value:
 *                   type: string
 *                   description: Phone number
 *                 type:
 *                   type: string
 *                   description: Type of phone (e.g., mobile, landline)
 *                 ext:
 *                   type: string
 *                   description: Extension number
 *             alternative_phone:
 *               type: object
 *               properties:
 *                 value:
 *                   type: string
 *                   description: Alternative phone number
 *                 type:
 *                   type: string
 *                   description: Type of phone (e.g., mobile, landline)
 *                 ext:
 *                   type: string
 *                   description: Extension number
 *             policy_date_required:
 *               type: string
 *               description: Date when policy is required
 *             certificate_date:
 *               type: string
 *               description: Date of certificate
 *             interest_end_date:
 *               type: string
 *               description: End date of interest
 *             percentage_of_interest:
 *               type: string
 *               description: Percentage of interest
 *             lien_amount:
 *               type: string
 *               description: Amount of lien
 *             worker_compensation_coverage:
 *               type: string
 *               description: Worker compensation coverage details
 *             evidence:
 *               type: object
 *               properties:
 *                 certificate:
 *                   type: boolean
 *                   description: Whether certificate evidence is required
 *                 policy:
 *                   type: boolean
 *                   description: Whether policy evidence is required
 *                 send_bill:
 *                   type: boolean
 *                   description: Whether to send the bill
 *         interest_in_item_no:
 *           type: object
 *           properties:
 *             location:
 *               type: string
 *               description: Location of the item
 *             building:
 *               type: string
 *               description: Building where the item is located
 *             vehicle:
 *               type: string
 *               description: Vehicle associated with the item
 *             boat:
 *               type: string
 *               description: Boat associated with the item
 *             item_class:
 *               type: string
 *               description: Class of the item
 *             item:
 *               type: string
 *               description: Item identifier
 *             item_description:
 *               type: string
 *               description: Description of the item
 *         policy_id:
 *           type: string
 *           description: Reference to the Policy ID
 *       example:
 *         interest:
 *           interest: "Primary"
 *           description: "Main interest for the policy"
 *           interest_is_payor: true
 *           information_billing: true
 *           rank: "A"
 *           policy_frequency: "Annual"
 *           policy_required: "Yes"
 *           reference: "Ref123"
 *           certificate_frequency: "Monthly"
 *           certificate_required: "Yes"
 *           billing_frequency: "Quarterly"
 *         name_and_address:
 *           name: "John Doe"
 *           street_address: "123 Main St"
 *           apt: "4B"
 *           address_line: "Suite 400"
 *           country: "USA"
 *           city: "New York"
 *           province: "NY"
 *           county: "Kings"
 *           zip_code: 10001
 *           interest_phone:
 *             value: "+1-555-1234"
 *             type: "mobile"
 *             ext: "101"
 *           alternative_phone:
 *             value: "+1-555-5678"
 *             type: "landline"
 *             ext: "102"
 *           policy_date_required: "2024-09-01"
 *           certificate_date: "2024-08-21"
 *           interest_end_date: "2025-08-21"
 *           percentage_of_interest: "10%"
 *           lien_amount: "$5000"
 *           worker_compensation_coverage: "Full"
 *           evidence:
 *             certificate: true
 *             policy: true
 *             send_bill: false
 *         interest_in_item_no:
 *           location: "Warehouse A"
 *           building: "Bldg 5"
 *           vehicle: "Truck 123"
 *           boat: "Boat A"
 *           item_class: "Electronics"
 *           item: "Item 001"
 *           item_description: "High-end camera"
 *         policy_id: "60d5f6d8c6e8b22f63b2e8b0"
 */
/**
 * @swagger
 * tags:
 *   - name: AdditionalInterest
 *     description: Operations related to Additional Interest
 */

/**
 * @swagger
 * /additional-interest/list:
 *   get:
 *     summary: Returns the list of additional interests
 *     tags: [AdditionalInterest]
 *     security:
 *       - bearerAuth: []
 *     parameters:
 *       - in: query
 *         name: policy_id
 *         schema:
 *           type: string
 *         required: false
 *         description: ID of the policy to filter the additional interests
 *     responses:
 *       200:
 *         description: The list of additional interests
 *         content:
 *           application/json:
 *             schema:
 *               type: array
 *               items:
 *                 $ref: '#/components/schemas/AdditionalInterest'
 */

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

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

/**
 * @swagger
 * /additional-interest/delete/{id}:
 *   delete:
 *     summary: Delete the additional interest by ID
 *     tags: [AdditionalInterest]
 *     security:
 *       - bearerAuth: []
 *     parameters:
 *       - in: path
 *         name: id
 *         schema:
 *           type: string
 *         required: true
 *         description: The ID of the additional interest to delete
 *     responses:
 *       200:
 *         description: The additional interest was successfully deleted
 *         content:
 *           application/json:
 *             schema:
 *               type: object
 *               properties:
 *                 message:
 *                   type: string
 *                   example: "Additional interest deleted successfully"
 */