05. Бизнес¶

Версия	1.4.0
Количество листов

Оглавление¶

История изменений
1. Описание
2. Данные бизнеса
- 2.1 Параметры Бизнеса(businesses)
- 2.3 CRUD Бизнеса(businesses)
  - 05_2.3_1 Процедура деактивации Бизнеса
  - 05_2.3_2 Процедура активации Бизнеса
3. Данные Представителя бизнеса
- 3.1 Параметры Представителя бизнеса(business_representatives)
3.1_1 Бизнес роль

История изменений¶

№ 1	Дата: 25.08.25	Автор:Демкович Александр	RFC: RPL-1051	Версия: 0.1.0
Добавлено: 3.1_1 Бизнес роль. Изменено: В “05_2.3_2 Процедура активации Бизнеса” изменены параметры “Сообщения коллаборации”.
№2	Дата: 11.09.25	Автор:Ляшук Андрей	RFC: RPL-1288	Версия: 0.2.0
Добавлена: Португальская локаль для “3.1_1 Бизнес роль”.
№3	Дата: 11.09.25	Автор:Ляшук Андрей	RFC: RPL-1317	Версия: 0.3.0
Добавлена: Испанская локаль для “3.1_1 Бизнес роль”.
№4	Дата: 25.09.25	Автор:Ляшук Андрей	RFC: RPL-1208	Версия: 1.0.0
Изменено: В “3.1 Параметрах Представителя бизнеса(business_representatives)” исключен параметр “influencer_filter_audience”. Исключено: 05_3.2_1 Процедура сохранения информации о Фильтре инлюэнсеров по аудитории.
№5	Дата: 07.10.25	Автор:Ляшук Андрей	RFC: RPL-1417	Версия: 1.1.0
Изменено: • Параметр “Является ли системным” заменен на “Тип” в: “05_2.3_1 Процедура деактивации Бизнеса” • “05_2.3_2 Процедура активации Бизнеса”.
№6	Дата: 13.10.25	Автор:Ляшук Андрей	RFC: RPL-1480	Версия: 1.2.0
Изменено: • Добавлена отправка сообщения в веб-сокет в процедурах: “05_2.3_1 Процедура деактивации Бизнеса” • “05_2.3_2 Процедура активации Бизнеса”.
№7	Дата: 15.10.25	Автор:Ляшук Андрей	RFC: RPL-1552	Версия: 1.3.0
Изменено: В “2.1 Параметры Бизнеса(businesses)” добавлен параметр “billing_country_code”.
№8	Дата: 15.10.25	Автор:Ляшук Андрей	RFC: RPL-1540	Версия: 1.4.0
Изменено: • При создании системного сообщения добавлен параметр “Инициатор” в процедурах: “05_2.3_1 Процедура деактивации Бизнеса” • “05_2.3_2 Процедура активации Бизнеса”.
№9	Дата: 20.11.25	Автор:Ляшук Андрей	RFC: RPL-1773	Версия: 1.5.0
Добавлено: • “05_2.3_3 Процедура установки ограничения на бизнес” • “05_2.3_4 Процедура снятие ограничения с бизнеса” • “05_2.3_5 Проверка возможности снятия ограничения с бизнеса”. Изменено: “2.1 Параметры Бизнеса(businesses)” добавлен параметр “is_campaign_creatable”.
№10	Дата: 25.11.25	Автор:Ляшук Андрей	RFC: RPL-1871	Версия: 1.6.0
Изменено: • Добавлена инициация процедуры “07_3.3.2_6 Процедура отправки сообщений коллаборации в веб-сокет” в процедурах: “05_2.3_1 Процедура деактивации Бизнеса” • “05_2.3_2 Процедура активации Бизнеса”.
№11	Дата: 22.02.26	Автор:Ляшук Андрей	RFC: RPL-2043	Версия: 1.7.0
Изменено: Добавлено “Свойство доступности” при создание системных сообщений в “05_2.3_1 Процедура деактивации Бизнеса” и “05_2.3_2 Процедура активации Бизнеса”.
№12	Дата: 31.08.26	Автор:Ляшук Андрей	RFC: RPL-2885	Версия: 1.8.0
Добавлено: Параметр “Отель” в “2.1 Параметры Бизнеса(businesses)”.

1. Описание¶

Бизнесом является организационная структура которая предназначена для управления пользователями, которые могут представлять интересы бизнеса, а также управления Локациями и Кампаниями в этих локациях.

2. Данные бизнеса¶

2.1 Параметры Бизнеса(businesses)¶

Название	Параметр	Формат	Обяз.	Уник.	Примечание
Идентификатор	id	bigserial	да	да
Дата создания	created_at	timestamp	да	нет
Дата обновления	updated_at	timestamp	нет	нет
Заголовок	title	varchar(255)	да	нет
Идентификатор регистратора	registrator_id	bigint	да	нет
Статус активности	is_active	boolean	да	нет
Код страны плательщика	billing_country_code	varchar(2)	да	нет	Код страны.
Возможность создания кампании	is_campaign_creatable	boolean	да	нет	По умолчанию true.
Отель	is_hotel	boolean	да	нет	По умолчанию false.

2.3 CRUD Бизнеса(businesses)¶

05_2.3_1 Процедура деактивации Бизнеса¶

Администратор инициирует деактивацию Бизнеса.
Выполняется:
Изменяются параметры Бизнеса:
1. Дата обновления - изменяется согласно текущей дате;
2. Статус активности - “false”;
Для каждой Коллаборации в одном из статусов “Новая”/“Подтверждена”/”Активная”, которая относится к “Кампании”, которая относится к “Локации”, которая относится к “Бизнесу”, для которого была инициирована данная процедура, выполняется создание “Сообщения коллаборации” с параметрами:
1. Дата создания - согласно текущей дате;
2. Идентификатор коллаборации - Идентификатор коллаборации, для которой должно быть создано сообщение;
3. Тип - Системное;
4. Идентификатор шаблона - 14;
5. Инициатор - Администратор;
6. Свойство доступности - Инфлюэнсер.
Для каждого “Инфлюэнсера”:
1. Который относится к “Коллаборации”, для которой было создано сообщение;
2. Для которого имеется подключение к веб-сокету.
  
  выполняется:
“07_3.3.2_4 Процедура определения количества непрочитанных сообщений пользователя” с параметрами:
Массив коллабораций - Одномерный массив который содержит идентификаторы коллабораций для которых было создано сообщение на этапе “2_b” данной процедуры.
1. Пользователь - Идентификатор пользователя для которого выполняется “2_c” данной процедуры;
  1. Тип - Сообщение.
2. Выполняется отправка сообщения в веб-сокет “Уведомления от сервиса Centrifugo” для канала “notification_{Идентификатор пользователя к которому относится “Аккаунт”}” с параметрами:
  1. type - “messages_counters_changed”;
    1. data - массив “data” который был получен в результате выполнения “07_3.3.2_4 Процедура определения количества непрочитанных сообщений пользователя”.
Выполняется “07_3.3.2_6 Процедура отправки сообщений коллаборации в веб-сокет” с параметрами:
Идентификаторы сообщений коллабораций - Идентификаторы сообщений коллаборации, которые были созданы на этапе “2” данной процедуры.

05_2.3_2 Процедура активации Бизнеса¶

Администратор инициирует активацию Бизнеса.
Выполняется:
Изменяются параметры Бизнеса:
1. Дата обновления - изменяется согласно текущей дате;
2. Статус активности - “true”;
Для каждой Коллаборации в одном из статусов “Новая”/“Подтверждена”/”Активная”, которая относится к “Кампании”, которая относится к “Локации”, которая относится к “Бизнесу”, для которого была инициирована данная процедура, выполняется создание “Сообщения коллаборации” с параметрами:
1. Дата создания - согласно текущей дате;
2. Идентификатор коллаборации - Идентификатор коллаборации, для которой должно быть создано сообщение;
3. Тип - Системное;
4. Идентификатор шаблона - 15;
5. Инициатор - Администратор;
6. Свойство доступности - Инфлюэнсер.
Для каждого “Инфлюэнсера”:
1. Который относится к “Коллаборации”, для которой было создано сообщение;
2. Для которого имеется подключение к веб-сокету.
  
  выполняется:
“07_3.3.2_4 Процедура определения количества непрочитанных сообщений пользователя” с параметрами:
Массив коллабораций - Одномерный массив который содержит идентификаторы коллабораций для которых было создано сообщение на этапе “2_b” данной процедуры.
1. Пользователь - Идентификатор пользователя для которого выполняется “2_c” данной процедуры;
  1. Тип - Сообщение.
2. Выполняется отправка сообщения в веб-сокет “Уведомления от сервиса Centrifugo” для канала “notification_{Идентификатор пользователя к которому относится “Аккаунт”}” с параметрами:
  1. type - “messages_counters_changed”;
  2. data - массив “data” который был получен в результате выполнения “07_3.3.2_4 Процедура определения количества непрочитанных сообщений пользователя”.
Выполняется “07_3.3.2_6 Процедура отправки сообщений коллаборации в веб-сокет” с параметрами:
Идентификаторы сообщений коллабораций - Идентификаторы сообщений коллаборации, которые были созданы на этапе “2” данной процедуры.

05_2.3_3 Процедура установки ограничения возможности создания кампании для бизнеса внешним методом¶

API: POST /businesses/{id}/restrict_campaign_creation

Выполняется инициация данной процедуры:
Администратором;
Запросом “Restrict campaign creation for business”;

с параметрами:

Идентификатор бизнеса.
Выполняется:
Изменение “Возможности создания кампании” бизнеса, для которого инициирована данная процедура - false;
Для каждого “Представителя бизнеса”, который относится к “Бизнесу” для которого инициирована данная процедура и для которого имеется подключение к веб-сокету выполняется:
1. Отправка сообщения в веб-сокет “Уведомления от сервиса Centrifugo” для канала “notification_{Идентификатор пользователя к которому относится “Представитель бизнеса”}” с параметрами:
  1. type - “campaign_creation_restriction”;
  2. data[ ].is_campaign_creation_locked_for_not_answering_messages - true.

05_2.3_4 Процедура снятие ограничения на создание кампании для бизнеса внешним методом¶

API: POST /businesses/{id}/unrestrict_campaign_creation

Выполняется инициация данной процедуры с параметрами:
Идентификатор бизнеса.
Выполняется:
Изменение “Возможности создания кампании” бизнеса, для которого инициирована данная процедура - true;
Для каждого “Представителя бизнеса”, который относится к “Бизнесу” для которого инициирована данная процедура и для которого имеется подключение к веб-сокету выполняется:
1. Отправка сообщения в веб-сокет “Уведомления от сервиса Centrifugo” для канала “notification_{Идентификатор пользователя к которому относится “Представитель бизнеса”}” с параметрами:
  1. type - “campaign_creation_restriction”;
  2. data[ ].is_campaign_creation_locked_for_not_answering_messages - false.

05_2.3_5 Проверка возможности снятия ограничения с бизнеса¶

Выполняется инициация данной проверки с параметрами:
Идентификатор бизнеса.
Выполняется проверка возможности снятия ограничения с бизнеса. С бизнеса могут быть сняты ограничения, если:
1. Не имеется значения параметра “Статусы коллабораций для отслеживания непрочитанных сообщений” настройки “Ограничения на создания новой кампании”;
  или
2. Имеется значения параметра “Статусы коллабораций для отслеживания непрочитанных сообщений” настройки “Ограничения на создания новой кампании” и не имеется “Сообщения коллаборации”, которое:
  1. Относится к “Коллаборации” в одном из статусов, который указан в значении параметра “Статусы коллаборации для отслеживания непрочитанных сообщений” настройки “Ограничения на создания новой кампании”;
  2. Для которого не имеется “Просмотра сообщения пользователем”;
и
Значение параметра “Статус проверки просмотра всех коллабораций” настройки “Ограничения на создания новой кампании”:
1. false;
  или
2. true и для всех “Коллабораций”, которые относятся к “Бизнесу” для которого инициирована данная процедура имеется “Просмотр коллаборации” минимум одним “Представителем бизнеса”, который относится к “Бизнесу” для которого инициирована данная процедура;
и
Значение “Статус проверки коллаборации в статусе новая” настройки “Ограничения на создания новой кампании”:
1. false;
  или
2. true и не имеется “Коллаборации”:
  1. К которой относится “Аккаунт” для которого “Статус верификации” - Verified;
  2. Которая относится “Бизнес” для которого инициирована данная процедура;
  3. В статусе “Новая”.

3. Данные Представителя бизнеса¶

3.1 Параметры Представителя бизнеса(business_representatives)¶

Название	Параметр	Формат	Обяз.	Уник.	Примечание
Идентификатор	id	bigserial	да	да
Идентификатор бизнеса	business_id	bigint	да	нет
Идентификатор пользователя	user_id	bigint	да	нет
Бизнес роль	business_role	enum	да	нет	Возможны следующие роли: 1 - Owner; 2 - General manager; 3 - SMM manager; 4 - Other.
Индексы		Параметры
Уникальный индекс		business_id, user_id

3.1_1 Бизнес роль¶

Локализация значений параметра:

Значение	Локаль	Значение
1	en	Owner
	es	Propietario
	pt	Proprietário
	fr
2	en	General manager
	es	Gerente general
	pt	Gerente general
	fr
3	en	SMM manager
	es	Responsable de redes sociales (SMM)
	pt	Gerente de Mídias Sociais (SMM)
	fr
4	en	Other
	es	Otro
	pt	Outro
	fr