Add IM\Department service for im.department.* methods

[mesilov]

Q	A
Bug fix?	no
New feature?	yes
Deprecations?	no
Issues	Fix #432
License	MIT

Adds Bitrix24\SDK\Services\IM\Department\Service\Department for the im.department.* REST methods that are not present in the local OpenAPI snapshot yet.

Implemented methods:

• get(array $departmentIds, bool $userData = false) for im.department.get
• colleaguesList(bool $userData = false, ?int $offset = null, ?int $limit = null) for im.department.colleagues.list
• employeesGet(array $departmentIds, bool $userData = false) for im.department.employees.get
• managersGet(array $departmentIds, bool $userData = false) for im.department.managers.get

The new service is available through Factory::getServiceBuilder()->getIMScope()->department() and returns typed wrappers for department items, colleague lists, and user lists grouped by department id.

$departmentService = Factory::getServiceBuilder()->getIMScope()->department();

$departments = $departmentService->get([1], true)->items();
$colleagues = $departmentService->colleaguesList(true, limit: 50)->users();
$employeesByDepartment = $departmentService->employeesGet([1], true)->usersByDepartment();
$managersByDepartment = $departmentService->managersGet([1], true)->usersByDepartment();

Test plan

• make oa-schema-build — passed
• make lint-cs-fixer — passed
• make lint-rector — passed
• make lint-phpstan — passed
• make lint-deptrac — passed
• make test-unit — passed: OK (918 tests, 2581 assertions)
• make test-integration-im-department — passed: OK (6 tests, 16 assertions)

Closes #432

🤖 Generated with Claude Code