# Социальная сеть — Администрирование

Руководство по администрированию корпоративной социальной сети 1Формы: сообщества, публикации, лента, статьи. Собственных Admin API контроллеров у домена нет — настройки распределены по смежным доменам через автоадминку. Документ для администраторов площадки: ключевые SettingsCustom, типы категорий, видимость ленты, служебные категории и типичные ошибки.

## Обзор и механизмы администрирования

Домен social-network охватывает настройку корпоративной социальной сети: сообщества, публикации, лента, статьи. Собственных Admin API контроллеров у домена нет — настройки распределены по смежным доменам. Администрирование использует:

- **Настройки через смежные домены** — `custom-settings` (конфигурация соцсети), `subcategories` (типы категорий), `workplaces` (видимость блока), `users-new-default-settings` (дефолты)

**Автоадминка (dbadmin) — через смежные домены**

| Alias формы | Название | Таблица БД | Полей | Секций | Deps | Папка |
|-------------|----------|-----------|-------|--------|------|-------|
| `custom-settings` | Кастомные настройки | dbo.SettingsCustom | 6 | 1 | 0 | Системные настройки |
| `workplaces` | Рабочие места группы | dbo.UserGroupSettings | 45 | 5 | 0 | Пользовательский интерфейс |
| `users-new-default-settings` | Настройки по умолчанию | dbo.UsersNewDefaultSettings | 38 | 5 | 0 | (корень) |

## Ключевые настройки

### Конфигурация социальной сети (SettingsCustom)

**Где настраивается:** автоадминка -> форма `custom-settings` → запись `Key = socialNetworksSettings`
**Таблица БД:** `dbo.SettingsCustom`

JSON-значение определяет:
- `RootCategoryId` — корневой раздел
- `GroupsForPublicationsId` — категория для открытых публикаций
- `GroupsForClosedPublicationsId` — категория для закрытых публикаций
- `PersonalPublicationsSubcatId` — категория для личных публикаций
- `ArticlesSubcatId` — категория для статей (должна иметь `IsWikiSubcat = 1`)
- `HeaderStyle` — стиль шапки группы соцсети (`0` или `1`)
- `PortalId` — портальная страница, которая выводится над лентой
- `ExtParamCoverId` — ДП для обложки
> ДП обложки привязывается ко всем категориям типа `Chats`, **кроме** категории личных чатов (`Settings.ChatSubcatId`) — с 2.268.x. На существующих инсталляциях single-run миграция `UnbindEpCoverFromPersonalChatsCategory` отвязывает уже привязанный ДП от категории личных чатов, не трогая значения обложек в групповых чатах, каналах и соцсетях.

**Эффект в runtime:** `SocialNetworkService` читает эти настройки для маршрутизации контента по служебным категориям.

#### Портал над лентой социальной сети

Параметр `PortalId` задаёт портальную страницу, которая выводится над лентой: над потоком публикаций появляются виджеты этой страницы. Параметр необязательный — без него лента открывается как обычно.

Над лентой портал всегда рисуется раскладкой CSS Grid. Если у указанной страницы другая раскладка, вместо виджетов выводится «Для отображения над лентой нужен портал типа CssGrid». Если страница удалена, недоступна по правам или не загрузилась, выводится «Портал недоступен» — сама лента при этом работает.

Виджеты берутся из портальной страницы, отдельно привязывать их не нужно. Правая кнопка мыши по фону портала даёт пункт «Открыть портал» — переход на страницу в режиме просмотра. На саму портальную страницу и на редактор порталов вывод над лентой не влияет.

### Тип категории, видимость ленты и портальный блок

**Тип категории для соцсети (Subcategories)**

**Где настраивается:** автоадминка -> FormsGenerator `subcategories`
**Таблица БД:** `dbo.Subcategories`

| Поле | Что контролирует |
|------|------------------|
| `SubcatTypeID` = «Группы соц. сети» | Категория работает как сообщество/публикации |
| `SubcatTypeID` = «Пространство» + `IsWikiSubcat = 1` | Категория доступна как пространство для статей |
| `OneFMainVisibilityMode` | Попадание записей в ленты и списки |
| `AllowGroupSubcription` | Подписка участников и видимость контента |

**Видимость блока «Лента корп. сети» (UserGroupSettings)**

**Где настраивается:** автоадминка -> форма `workplaces`
**Таблица БД:** `dbo.UserGroupSettings`

| Поле | Что контролирует |
|------|------------------|
| `CorporateNetworkFeedVisibleType` | Показывает/скрывает блок в левом меню |

**Дефолт для новых пользователей (UsersNewDefaultSettings)**

**Где настраивается:** автоадминка -> форма `users-new-default-settings`
**Таблица БД:** `dbo.UsersNewDefaultSettings`

| Поле | Что контролирует |
|------|------------------|
| `IsCorporateNetworkFeedVisible` | Дефолтная видимость ленты соцсети для новых пользователей |

**Портальный блок соцсети**

**Где настраивается:** Admin API порталов -> блок «Лента социальной сети»
**Таблицы БД:** `dbo.PortalGrid*`

Отображение ленты соцсети на портальной странице.

### Служебные категории и права по умолчанию

Раздел и служебные категории социальной сети не требуется создавать вручную. Их ID задаются в `socialNetworksSettings`, а категории должны находиться в системном разделе социальной сети.

| Параметр | Служебная категория | Тип категории | Права группы «Все пользователи» по умолчанию |
|----------|---------------------|---------------|----------------------------------------------|
| `GroupsForPublicationsId` | Группы для публикаций | «Группы соц.сетей» | `Исполнять`, `Просмотр всех задач`, `Создавать задачи`, `Менять заказчика` |
| `GroupsForClosedPublicationsId` | Группы для закрытых публикаций | «Группы соц.сетей» | `Создавать задачи` |
| `PersonalPublicationsSubcatId` | Личные публикации | «Группы соц.сетей» | `Исполнять`, `Просмотр всех задач`, `Создавать задачи`, `Менять заказчика` |
| `ArticlesSubcatId` | Статьи | «Пространство» | Права настраиваются как для пространства; категория используется при создании статьи из публикации |

⚠️ При смене типа сообщества «Открытое»/«Закрытое» задача сообщества автоматически переносится между категориями `GroupsForPublicationsId` и `GroupsForClosedPublicationsId`. Права для группы «Все пользователи» переназначаются в зависимости от целевой категории.

Для личных публикаций после первого поста пользователя в категории `PersonalPublicationsSubcatId` создаётся агрегатор-задача `Публикации. {Фамилия Имя Отчество}` от лица пользователя. Последующие посты пользователя хранятся в этой задаче как сообщения.

### Полная структура `socialNetworksSettings`

Ниже приведён полный JSON-объект настройки социальной сети с описанием каждого поля.

```json
{
  "RootCategoryId": 4441,
  "PersonalPublicationsSubcatId": 62720,
  "HeaderStyle": 1,
  "GroupsForPublicationsId": 62730,
  "GroupsForClosedPublicationsId": 62900,
  "ArticlesSubcatId": 62830,
  "PortalId": 5041,
  "ExtParams": {
    "ExtParamCoverId": 100020
  }
}
```

| Параметр | Назначение |
|----------|------------|
| `RootCategoryId` | ID системного раздела социальной сети |
| `PersonalPublicationsSubcatId` | ID категории личных публикаций |
| `HeaderStyle` | Необязательный стиль шапки группы: `0` — аватар группы и автор после контента, `1` — имя и аватар автора в шапке |
| `GroupsForPublicationsId` | ID категории открытых сообществ |
| `GroupsForClosedPublicationsId` | ID категории закрытых сообществ |
| `ArticlesSubcatId` | ID категории статей с типом «Пространство» |
| `ExtParams.ExtParamCoverId` | ID файлового ДП для обложки |
| `PortalId` | Необязательный ID портальной страницы, которая выводится над лентой соцсети |

Подробные пользовательские сценарии публикаций, сообществ и `HeaderStyle` описаны в [business.md](https://help.1forma.ru/domains/social-network/business.md); в admin.md фиксируются только параметры настройки и их эффект на маршрутизацию контента.

## Типичные ошибки и связанные документы

В таблице перечислены наиболее частые симптомы неправильной настройки социальной сети, их причины и способы диагностики.

| Симптом | Причина | Где проверить | SQL-диагностика |
|---------|---------|---------------|-----------------|
| Публикации создаются «не туда» | Неверные ID категорий в `socialNetworksSettings` | Форма `custom-settings` | `select [Value] from dbo.SettingsCustom where [Key] = 'socialNetworksSettings'` |
| Не создаётся статья из публикации | `ArticlesSubcatId` указывает на категорию без `IsWikiSubcat` | `dbo.Subcategories` | `select Id, SubcatTypeID, IsWikiSubcat from dbo.Subcategories where Id = {articlesSubcatId}` |
| Не виден блок соцсети в меню | `CorporateNetworkFeedVisibleType` выключен | Форма `workplaces` | `select GroupId, CorporateNetworkFeedVisibleType from dbo.UserGroupSettings` |
| Лента соцсети пустая в портале | Некорректный блок или нет доступа к сообществам | Блок портала | Проверить конфигурацию блока и доступ к категориям |
| Тип сообщества не распознаётся | Категория не имеет правильный `SubcatTypeID` | `dbo.Subcategories` | `select Id, SubcatTypeID from dbo.Subcategories where Id = {subcatId}` |
| Над лентой вместо виджетов заглушка | В `PortalId` указана страница с другой раскладкой (нужен CSS Grid) либо страница удалена или недоступна по правам | Форма `custom-settings`, страница портала | `select [Value] from dbo.SettingsCustom where [Key] = 'socialNetworksSettings'` |