Оргструктура — Администрирование

Точки входа

Интерфейс	Путь
Автоадминка	org-structure (единицы), org-structure-type (типы), org-structure-appointment (должности)
Admin API	/api/admin/org-structure/*
UI администратора	Пользователи и группы → Оргструктура

1. Типы орг. единиц

Автоадминка: org-structure-type | Таблица: dbo.OrgStructureType

Поле	Назначение
Name	Название типа (Филиал, Департамент, Отдел, Группа, Должность)
Order	Числовой уровень — дочерний элемент должен иметь строго больший Order
IsPosition	Признак «должность» — только один тип с этим флагом; элементы этого типа могут иметь Appointment
IsCommercialInfo, HideInUserInfo	Флаги видимости

Типы настраиваются до создания оргструктуры.

2. Орг. единицы

Автоадминка: org-structure | Таблица: dbo.OrgStructureUnit

Вкладки карточки единицы

Настройки: - Имя, Тип, Входит в (ParentId) - При выборе значения «Входит в» в списке доступны только организационные единицы, которые могут быть родительскими. Единицы типа с флагом IsPosition не показываются, потому что должности нельзя использовать как родительские узлы. - Порядковый номер типа (Order) сам по себе не определяет, может ли единица быть родительской. Для фильтрации используется именно признак IsPosition, поэтому в списке могут отображаться единицы с любым уровнем, если они не являются должностями. - Связанная группа (LinkedGroupId) — привязка к группе для автосинхронизации - Должность (AppointmentId) — только для типа IsPosition - Является руководящей (IsDirector) — определяет руководителя подчинённых - Актуальность (IsActual) — неактуальные отображаются серым - Не показывать в оргструктуре (DoNotShowInOrgStructure) - Функциональная (IsFuncGroup) - Комментарий (Comment) — отображается под названием в UI - Цвет (Color)

Состав: список пользователей в данной единице (UserOrgStructureUnit).

Должности: назначение должности из справочника OrgStructureAppointment.

Массовые операции

Операция	API
Связать поддерево с группами	POST /api/admin/org-structure/orgunit/{unitId}/link-sub-tree-with-group
Синхронизировать группы	POST /api/admin/org-structure/syncgroups
Экспорт в Excel	GET /api/admin/org-structure/export-to-excel?withUsers={bool}

3. Должности

Автоадминка: org-structure-appointment | Таблица: dbo.OrgStructureAppointment

Плоский справочник (ID, Name). Должность назначается конкретной орг. единице через SetAppointmentForOrgUnit.

4. Кастомные настройки приложения

Настройка	Что делает
OrgStructure_AllowNonUniqueOrgUnitNames	Разрешить/запретить дубликаты имён в одной ветке (по умолчанию: разрешено)
CustomUserDirectorIds	Ручное переопределение руководителя: userId1:directorId1,userId2:directorId2
customWorkersDictionarySP	Кастомная SP вместо стандартного справочника сотрудников

5. SQL-диагностика

-- Дерево единиц
SELECT Id, Name, ParentId, OrgStructureTypeId, LinkedGroupId, IsActual, IsDirector
FROM dbo.OrgStructureUnit
ORDER BY ParentId, Name;

-- Типы
SELECT * FROM dbo.OrgStructureType ORDER BY [Order];

-- Должности
SELECT * FROM dbo.OrgStructureAppointment;

-- Пользователи в оргструктуре
SELECT u.UserID, u.OrgStructureUnitId, u.IsPrimary, osu.Name
FROM dbo.UserOrgStructureUnit u
JOIN dbo.OrgStructureUnit osu ON osu.Id = u.OrgStructureUnitId;

-- Единицы без связанной группы (потенциальная проблема)
SELECT Id, Name
FROM dbo.OrgStructureUnit
WHERE LinkedGroupId IS NULL AND IsActual = 1;

-- Пользователи без основной единицы
SELECT UserID
FROM dbo.UserOrgStructureUnit
GROUP BY UserID
HAVING SUM(CASE WHEN IsPrimary = 1 THEN 1 ELSE 0 END) = 0;