Add Bitrix24 partner ID handling to contact persons

Introduced the ability to set and get the Bitrix24 partner ID for contact persons. Updated tests and documentation to support this new functionality, ensuring comprehensive test coverage and proper documentation.

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Author: mesilov

src/Application/Contracts/ContactPersons/Docs/ContactPersons.md

@@ -25,6 +25,8 @@ Store information about person who installed application
 | `setExternalId()`             | `void`                | Sets external id for contact person from external system                    | -                          |
 | `getExternalId()`             | `?string`             | Returns external id for contact person (if any)                             | -                          |
 | `getBitrix24UserId()`         | `?int`                | Returns bitrix24 user id if contact person mapped on bitrix24 user (if any) | -                          |
+| `getBitrix24PartnerId()`      | `?Uuid`               | Returns bitrix24 partner id if contact person is bitrix24 partner employee  | -                          |
+| `setBitrix24PartnerId()`      | `void`                | Change bitrix24 partner id if contact person is bitrix24 partner employee   | -                          |
 | `getUserAgent()`              | `?string`             | Returns user agent for contact person                                       | -                          |
 | `getUserAgentReferer()`       | `?string`             | Returns user agent referer for contact person                               | -                          |
 | `getUserAgentIp()`            | `?IP`                 | Returns user agent IP for contact person                                    | -                          |
@@ -54,6 +56,8 @@ stateDiagram-v2
     - use case VerifyMobilePhone
     - use case AddComment
     - use case LinkToExternalEntity
+    - use case LinkToBitrix24Partner
+    - use case UnlinkFromBitrix24Partner
 - `public function delete(Uuid $uuid): void;`
     - use case Delete
 - `public function getById(Uuid $uuid): ContactPersonInterface;`

src/Application/Contracts/ContactPersons/Entity/ContactPersonInterface.php

@@ -114,6 +114,16 @@ public function getExternalId(): ?string;
      */
     public function getBitrix24UserId(): ?int;
 
+    /**
+     * @return Uuid|null get bitrix24 partner uuid if contact person is partner employee
+     */
+    public function getBitrix24PartnerId(): ?Uuid;
+
+    /**
+     * @param Uuid|null $uuid set bitrix24 partner uuid if contact person is partner employee
+     */
+    public function setBitrix24PartnerId(?Uuid $uuid): void;
+
     /**
      * get user agent for contact person, use for store metadata in consent agreements facts
      */

src/Application/PortalLicenseFamily.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bitrix24\SDK\Application;
+
+/**
+ * Portal license family enum
+ * @link https://training.bitrix24.com/rest_help/general/app_info.php
+ */
+enum PortalLicenseFamily: string
+{
+    case free = 'free';
+    case basic = 'basic';
+    case std = 'std';
+    case pro = 'pro';
+    case en = 'en';
+    case nfr = 'nfr';
+}