Справка по работе с Catalot

Не нашли ответ? Напишите: support@catalot.ru

Введение

Catalot — это система для управления продуктовым каталогом в дистрибьюторском бизнесе.

Система позволяет:

  • Хранить и структурировать продуктовый каталог
  • Привязывать группы продуктов к клиентам
  • Формировать спецификации (корзины) для полевых сотрудников
  • Управлять доступом через гибкую систему прав на основе сущностей
  • Работать в команде через компании и отделы
Ключевая особенность:
  • Каждый пользователь имеет личную сущность (personal), через которую он действует
  • Компании и отделы — это контейнеры для группировки пользователей и получения прав
  • Email есть только у пользователей. Права на группы передаются по email пользователя, отделу или компании (через выбор в форме)

Памятка: первые шаги

Короткий список — что делать в первый день работы с Catalot.

  1. Подтвердите email.
    После регистрации на вашу почту придёт письмо со ссылкой. Перейдите по ней — без этого вход в систему закрыт.
  2. Войдите в систему.
    Если вас пригласили — перейдите по ссылке из письма-приглашения. Если регистрировались сами — вы сразу попадёте в личное пространство.
  3. Создайте первого клиента.
    Раздел Клиенты → кнопка «Новый клиент». Укажите название, ИНН, email. Клиент — это тот, для кого вы собираете спецификацию.
  4. Посмотрите, что вам доступно.
    • Клиенты — ваши клиенты и те, к кому дали доступ.
    • Группы — каталоги продуктов, к которым у вас есть права.
    • Продукты — все продукты, доступные вам во всех группах.
    • Корзина — то, что собираете для клиента.
  5. Соберите спецификацию.
    Откройте клиента → выберите нужные продукты из его групп → добавьте в корзину. Когда готово — отправьте XLSX-файл клиенту прямо из корзины.
  6. Каждый видит только своё.
    Группы и продукты, на которые у вас нет прав, не отображаются. Клиенты — либо ваши, либо те, к которым вам дали доступ.
  7. Если чего-то не хватает.
    Напишите тому, кто дал вам доступ — он может передать больше групп или клиентов. Или в поддержку: support@catalot.ru.
  8. Если что-то сломалось.
    На экране появится код ошибки вида ERR-2026-09-23-a3f8. Скопируйте его и отправьте в поддержку — так мы быстрее разберёмся.
Полное описание разделов — ниже на этой странице. Если что-то непонятно, заглядывайте сюда.

Развёртывание системы

Инструкция для администратора: как настроить систему с нуля — компанию, сотрудников, каталог и права.

Если вы только что зарегистрировались и не знаете, с чего начать — сначала прочитайте «Памятку: первые шаги». Этот раздел — для того, кто разворачивает систему для команды.
1 Поймите модель сущностей

В системе три типа сущностей: personal (вы), company (контейнер для сотрудников) и department (отдел внутри компании).

Компания и отдел — не просто списки людей, а звенья в цепочке прав. Сотрудники наследуют права контейнера через членство.

Подробнее о сущностях →

2 Создайте компанию

Настройки → Компании и отделы → «Создать компанию».

У компании нет email — она не может войти в систему. Она существует, чтобы приглашать сотрудников и передавать права контейнеру.

Подробнее о компаниях →

3 Пригласите сотрудников

В карточке компании → «Пригласить». Укажите email.

Если пользователь новый — он получит письмо со ссылкой на регистрацию. Если уже зарегистрирован — письмо с подтверждением участия.

Создавайте отделы, если сотрудников много и их нужно группировать по функциям (продажи, закупки, логистика).

Подробнее об отделах →

4 Создайте структуру каталога
Сначала подгруппы, потом продукты. Как только в группу добавлен первый продукт, она навсегда становится «листом». Создать в ней подгруппы будет нельзя.

Каталог → Группы. Постройте всю иерархию до того, как добавлять продукты.

Подробнее о каталоге →

5 Создайте клиентов

Клиенты → «Новый клиент». Укажите название, ИНН, email.

Клиент привязывается к вашей personal-сущности. Вы автоматически получаете право manage на него.

Подробнее о клиентах →

6 Привяжите группы к клиентам

Откройте карточку клиента → Группы → выберите нужные.

Привязывать можно только конечные группы (без подгрупп).

Подробнее о привязке →

7 Передайте права

Каталог → Группы → отметьте группы чекбоксами → «Назначить права на выбранные группы».

Получателем может быть пользователь (по email), отдел (если вы руководитель) или компания (если вы владелец).

Права: view → use → edit → manage. Передавайте не больше, чем нужно.

Подробнее о передаче прав →

8 Проверьте граф прав

Граф прав (🔑) для конкретной группы показывает цепочку: кто кому передал, какие права активны сейчас.

Если что-то передали не так — увидите это здесь и сможете исправить.

Подробнее о графе →

Готово. После этих шагов система настроена: сотрудники приглашены, каталог создан, клиенты заведены, права переданы. Полевые сотрудники могут работать.

Сущности

В системе есть три типа сущностей:

Тип Что это Имеет email Может получать права на группы Действует
personal Пользователь — актор, который действует от своего имени ✅ Да ✅ Да (по email) ✅ Да
company Компания — контейнер для сотрудников ❌ Нет ✅ Да (по выбору из списка, владельцем компании) ❌ Нет
department Отдел — контейнер внутри компании ❌ Нет ✅ Да (по выбору из списка, руководителем отдела) ❌ Нет
Важно:
  • У каждого пользователя есть ровно одна сущность personal. Она создаётся автоматически при регистрации.
  • Email есть только у пользователей. Компании и отделы не имеют email.
  • Права на группу могут быть переданы пользователю, отделу или компании. Отдел и компания — контейнеры, сотрудники наследуют их права через членство.
Контейнер — звено цепочки прав

Отдел и компания — не просто «список пользователей». Это полноценные узлы в цепочке делегирования прав.

Когда права передаются контейнеру, он становится звеном между своим мастером и своими членами:

Автор группы
    │  передача прав
    ▼
Пользователь А
    │  передача прав
    ▼
Отдел (контейнер)
    │  членство
    ▼
Сотрудник отдела

Сотрудник получает доступ не потому, что «система связала его с отделом», а потому, что отдел является звеном в непрерывной цепочке от автора группы.

Если цепочка до контейнера разорвана (например, у пользователя А отозваны права), все члены контейнера теряют доступ — даже если формально запись «отдел → группа» в базе осталась.
Ключевое правило:
  • personal — действует (передаёт права, создаёт клиентов, создаёт группы)
  • company и department — только получают права и передают их сотрудникам через наследование
Роль руководителя отдела

Руководитель отдела (head) — особая роль. От неё зависят права всего отдела.

Что может руководитель:

  • Передавать права своему отделу — как контейнеру.
  • Добавлять и удалять сотрудников своего отдела.

Базовое правило — руководитель «заморожен»:

Пока пользователь является руководителем отдела, с ним нельзя совершать никаких действий, меняющих его роли:
  • нельзя назначить его руководителем другого отдела;
  • нельзя добавить его в другой отдел как сотрудника;
  • нельзя удалить его из компании или отдела.

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

Роль владельца компании

Владелец компании (owner) — тот, кто её создал. Он — источник прав компании.

Базовое правило — владелец не в отделе:

Владельца компании нельзя добавить в отдел его же компании. Он — собственник, а не сотрудник.

Если владельцу нужно ограничить права отдела, он действует через руководителя отдела: сначала просит сократить права, а если руководитель не согласен — снимает его с должности и назначает нового с другим набором прав.

Компании и отделы

Компании и отделы — это контейнеры для группировки пользователей и получения прав.

Создание компании

Перейдите в Настройки → Компании и отделы и нажмите «Создать компанию».

  • Название — наименование компании (обязательно)
Важно: У компании нет email. Компания не может войти в систему. Она существует для получения прав и объединения сотрудников.
Создание отдела

Внутри компании можно создавать отделы.

  • Название — наименование отдела
  • Руководитель отдела — пользователь, который будет управлять отделом

Отделы позволяют группировать сотрудников по функциональным признакам (продажи, закупки, логистика и т.д.).

В списке кандидатов на роль руководителя показываются только сотрудники компании, которые ещё не являются руководителями других отделов и не являются владельцем компании.
Руководитель отдела

Руководитель — центральная фигура для прав отдела. Он:

  • передаёт права своему отделу как контейнеру;
  • добавляет и удаляет сотрудников своего отдела.
Правило «заморозки»

Пока пользователь — руководитель отдела, с ним ничего нельзя делать, что меняет его роли:

  • нельзя назначить его руководителем другого отдела;
  • нельзя добавить его сотрудником в другой отдел;
  • нельзя удалить его из компании или отдела.

Чтобы «развязать» руководителя, нужно сначала снять его с должности (кнопка «Снять руководителя» в карточке отдела). После снятия он становится обычным пользователем, и ограничения снимаются.

Смена руководителя

Смена руководителя — двухшаговый процесс:

  1. Снять текущего руководителя. При снятии:
    • у отдела обнуляется поле «руководитель»;
    • все права отдела на группы отзываются;
    • все сотрудники отдела теряют доступ к группам через отдел.
  2. Назначить нового руководителя из числа сотрудников компании.
Новый руководитель должен заново передать права отделу на нужные группы — старые связи отдела с группами были удалены при снятии предыдущего.
Управление сотрудниками
В компании

Владелец компании может приглашать и удалять сотрудников компании.

  • Приглашение — по email. Пользователь должен быть зарегистрирован.
  • Удаление — сотрудник теряет доступ к правам компании.
В отделе

Управлять сотрудниками отдела может только руководитель отдела:

  • Добавить — из списка сотрудников компании, ещё не входящих в отдел.
  • Удалить — любого члена отдела, кроме себя (себя нельзя — сначала снимите с должности).
В списке кандидатов на добавление в отдел не показываются:
  • владелец компании;
  • руководители других отделов.
Владелец компании
Владельца компании нельзя добавить в отдел его же компании. Он — собственник, а не сотрудник.
Компания как получатель прав

Владелец компании может передать права на группу своей компании — так же, как отделу.

  • На странице управления правами выберите опцию «Компании».
  • Все сотрудники компании получат права через наследование.
  • Компания отображается в графе прав как отдельный узел (🏛️) с указанием email владельца.
Права компании и права отдела — независимые источники. Если отдел получил права от одного мастера, а компания — от другого, сотрудник, состоящий в обоих, получает объединение прав.
Пример: разрыв и восстановление через отдел

Рассмотрим цепочку:

Автор группы
    │
    ▼
Влад
    │  передача прав
    ▼
Валерон (руководитель отдела)
    │  передача прав отделу
    ▼
Тестовый отдел
    │  членство
    ▼
Валерон (как член отдела)
Разрыв

Автор отзывает права у Влада. Что произойдёт:

  • Влад теряет доступ.
  • Валерон теряет доступ (личные права от Влада оборваны).
  • Тестовый отдел теряет доступ (цепочка до отдела оборвана).
  • Записи о передаче остаются в базе — они не удаляются.
Восстановление

Автор снова передаёт Владу права — уже с другим набором. Что произойдёт:

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

Клиенты

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

Создание клиента

Нажмите Новый клиент и заполните поля:

  • Название — обязательно
  • ИНН — опционально, но рекомендуется (используется для дедупликации и наследования)
  • Email — опционально (используется для отправки спецификаций)
Важно: Клиент привязывается к вашей personal сущности. Вы автоматически получаете право manage на созданного клиента.
Передача доступа к клиенту

В карточке клиента нажмите Поделиться (доступно только владельцу).

  • Введите email пользователя, которому хотите передать доступ
  • Если у получателя ещё нет клиента с таким ИНН — система создаст ему копию клиента с ним как автором
  • Если у получателя уже есть клиент с таким ИНН — копия не создаётся
  • В любом случае получатель получает доступ к вашим привязкам групп на этого клиента (см. ниже)
Как это работает:
  • Вы продолжаете работать со своим клиентом — привязываете свои группы, ведёте историю
  • Получатель работает со своей копией — привязывает свои группы, ведёт свою историю
  • Получатель видит на карточке объединённый набор привязок: свои группы + ваши группы, на которые у него есть права
  • Если вы отзовёте доступ — у получателя останется его копия, его привязки и его история
Привязка групп

В карточке клиента нажмите Группы и выберите группы, которые нужно привязать.

Привязывать можно только конечные группы (без подгрупп).

На карточке клиента привязки помечаются бейджами:

  • Вы — группы, которые привязали вы сами
  • от [имя] — группы, привязанные другими пользователями, к чьим клиентам у вас есть доступ

При наведении на бейдж «от [имя]» отображается email отправителя.

Отзыв доступа

На странице «Поделиться» можно отозвать доступ у любого пользователя.

  • У получателя пропадёт доступ к вашим привязкам групп
  • Его собственная копия клиента, его группы и его история корзин сохранятся

Каталог

Каталог состоит из групп и продуктов.

Группы

Группы создаются для объединения продуктов. Они могут иметь вложенные подгруппы.

Особенности групп:
  • Пустая группа: можно создавать подгруппы и добавлять продукты
  • Группа с продуктами: нельзя создавать подгруппы (группа становится «листом» навсегда)
  • Группа с подгруппами: нельзя добавлять продукты
Важно: Как только в группу добавлен первый продукт, она навсегда становится «листом». Даже если позже все продукты будут удалены, создать подгруппы в этой группе уже не получится.
Создание и редактирование
  • Создать группу может любой авторизованный пользователь
  • При создании группы автор получает все права через свою personal сущность
  • Редактировать и удалять группу можно только при наличии права manage
Навигация по группам

Когда вы открываете группу, над её названием показывается путь от корня каталога:

Каталог → Группа А → Подгруппа А1

Каждый элемент — ссылка, по которой можно перейти на нужный уровень.

Если у вас нет прав на родительскую группу, её имя в пути будет показано серым цветом с иконкой замка 🔒. Перейти по ней нельзя — но вы видите, где именно находится текущая группа в общей структуре.

Это защита: вы не можете открыть группу, к которой нет доступа, но всегда понимаете, где вы находитесь.

Список подгрупп

Если у группы есть подгруппы, они отображаются внутри её страницы — списком:

  • Каждая подгруппа — ссылка для перехода внутрь.
  • Справа показывается количество продуктов в подгруппе.
  • Если у группы есть и подгруппы, и продукты одновременно — такого не бывает по правилам каталога.

Так вы можете проваливаться по структуре, не возвращаясь к общему дереву групп.

Продукты

Продукты — это товары или услуги. Каждый продукт имеет:

  • Код — уникальный в пределах группы
  • Название
  • Описание — необязательно. Rich-text с поддержкой таблиц, списков, ссылок
  • Статус — необязательно. Пометка о доступности (см. ниже)
Статус продукта

У продукта может быть один из трёх статусов:

  • Временно недоступен — нельзя добавить в корзину. Уже добавленные позиции можно уменьшать или удалять.
  • Ограничено — добавить можно, но есть ограничения (указаны в заметке к статусу).
  • Снят с производства — устаревший продукт, добавление не блокируется.

К статусу можно приложить заметку — до 200 символов. Например: «до 15 октября» или «не более 2 шт. в заказ».

Статус отображается иконкой рядом с названием продукта во всех списках и в карточке.

Описание продукта

Описание — это богатый текст: заголовки, жирный/курсив, списки, ссылки, таблицы.

Описание используется в двух местах:

  • Отображение — в карточке продукта (модалка) и в письмах со спецификациями.
  • Поиск — при серверном поиске по продуктам учитывается текст описания, включая содержимое таблиц. HTML-теги отбрасываются.
Пример: если в таблице описания указан материал «12Х18Н10Т», поиск по этому значению найдёт продукт. Регистр не важен.
Новости продукта

К каждому продукту можно прикреплять новости — короткие сообщения до 1000 символов.

  • Лента новостей показывается в карточке продукта — внизу, после основной информации.
  • Новости грузятся постранично: сначала 10 последних, ниже кнопка «Показать ещё». Под лентой — счётчик «Показано X из Y».
  • В списках продуктов (каталог, корзина, поиск клиента) у продуктов с новостями показывается значок N, где N — число новостей.

Кто может добавлять новости:

  • Владелец продукта — всегда.
  • Пользователь с правом edit хотя бы на одну группу продукта.

Кто может редактировать и удалять новость: её автор или владелец продукта. Кнопки «карандаш» и «корзина» рядом с новостью показываются только тем, кому доступно действие.

Автор и владелец продукта

У продукта два связанных пользователя:

  • Автор — тот, кто физически создал продукт. Может быть любым пользователем с правом edit на группу.
  • Владелец — тот, кому принадлежит группа, в которой создан продукт. Обычно это хозяин группы.

Если продукт создан вами в своей группе — автор и владелец совпадают. Если продукт создан другим пользователем в вашей группе — автор он, а владелец — вы.

Зачем это разделение: продукт в вашей группе принадлежит вам — даже если физически его создал ваш коллега. Вы управляете им как хозяин группы: привязываете к другим своим группам, удаляете, редактируете.
Продукт в нескольких группах

Один продукт может быть привязан к нескольким группам одновременно. Это удобно, когда один и тот же товар нужен в разных наборах — например, в тематической группе и в группе «Хиты продаж».

Продукт при этом остаётся одним. Изменения кода, названия или описания применяются к нему целиком — независимо от того, в скольких группах он присутствует.

Правило привязки: продукт можно привязать только к группам того же владельца, что и сам продукт. То есть если продукт принадлежит пользователю X, то и группы должны принадлежать X. Привязка к чужим группам запрещена.
Права на действия с продуктами

Для работы с продуктами используется право edit. Право manage управляет только группой (её свойствами, передачей прав, удалением) и не даёт доступа к продуктам.

Действие Необходимое право
Создать продукт edit на группу
Редактировать продукт Владелец продукта,
или edit хотя бы на одну из его групп
Привязать продукт к дополнительной группе edit на целевую группу,
владелец группы = владелец продукта
Добавить новость Владелец продукта,
или edit хотя бы на одну группу
Редактировать/удалить новость Автор новости или владелец продукта
Импорт продуктов edit на группу
Отвязать продукт от группы edit на эту группу
Удалить продукт из каталога Автор или владелец продукта,
и только если продукт отвязан от всех групп
Редактирование действует глобально. Продукт один, независимо от того, в скольких группах он присутствует. Если вы владелец продукта или имеете право edit хотя бы на одну его группу — изменения применяются к продукту целиком.
Управление группами продукта

В карточке редактирования продукта есть блок «Группы продукта». В нём видно:

  • Текущие группы продукта — с путями и кнопкой «Отвязать» у каждой.
  • Добавление в группу — выпадающий список доступных групп и кнопка «Привязать».

Список доступных групп формируется по правилу:

  • Группа конечная (без подгрупп).
  • Владелец группы = владелец продукта.
  • У вас есть edit на группу.
  • Продукт ещё не привязан к ней.

Если таких групп нет — блок покажет «Нет доступных групп для добавления».

Отвязка и удаление

Продукт может находиться в нескольких группах. Удалить его из каталога можно только тогда, когда он отвязан от всех групп.

Порядок действий:

  1. Пользователь с правом edit на группу открывает продукт и нажимает «Отвязать» — продукт исчезает из этой группы, но остаётся в каталоге.
  2. Если продукт был в нескольких группах — эту операцию должен выполнить пользователь с edit на каждую из них.
  3. Когда продукт отвязан от всех групп, удалить его могут автор или владелец продукта.
Почему так: пока продукт находится в группе, где у кого-то есть edit, удалять его нельзя — иначе он исчезнет из чужой группы без согласия её участников.
Карточка продукта

В любом списке продуктов — в группе, в общем каталоге, в поиске на странице клиента, в корзине — можно кликнуть на продукт и открыть его карточку.

В карточке показывается:

  • Код и название продукта.
  • Статус (если задан) с заметкой.
  • Описание с форматированием (включая таблицы).
  • Группы, в которых продукт присутствует (с путём от корня).
  • Ваш источник доступа — от кого вы получили права на группу:
    • Вы — автор группы — если группа ваша.
    • Отдел «X» — если доступ пришёл через отдел.
    • Имя (email) — если права переданы напрямую пользователем.
  • Новости продукта — лента с пагинацией и форма добавления (если есть права).
Все продукты: поиск, фильтры, сортировка

На странице Все продукты есть три инструмента.

Умный поиск

Серверный поиск по полям: код, название, описание (включая текст таблиц), название группы.

Синтаксис:

  • ключ гайки — оба слова должны найтись (порядок и регистр не важны).
  • "ключ гайки" — точная фраза, подстрока подряд.
  • гайки "из стали" — комбинация: слово + точная фраза.

Найденные фрагменты подсвечиваются жёлтым в коде, названии и группе.

Поиск ищет и по продуктам, к которым вы имеете доступ через группы, и по отвязанным продуктам, где вы автор или владелец.
Фильтры по полям

Можно фильтровать по:

  • Код — подстрока.
  • Название — подстрока.
  • Группа — подстрока пути группы.
  • Без группы — чекбокс, показывает только продукты, не привязанные ни к одной группе.

Фильтры работают вместе с умным поиском: результат — пересечение.

Сортировка

Выпадающий список:

  • Код (A→Я) — по умолчанию.
  • Код (Я→A).
  • Название (A→Я).
  • Название (Я→A).

Кнопка «Сбросить» очищает всё: умный поиск, фильтры по полям, чекбокс «Без группы» — и возвращает сортировку по коду.

Импорт продуктов

Поддерживается импорт из:

  • CSV — обязательные колонки code, title, group_name; опционально — description, status, status_note

Описание из CSV очищается и переводится в HTML. По его тексту тоже работает поиск.

Подробная инструкция — на странице импорта.

Корзина

Корзина позволяет формировать спецификации для клиента.

Где находится корзина

Корзина доступна в двух местах, с одинаковым видом:

  • В карточке клиента (/accounts/<uuid>) — компактный блок вверху страницы. Удобно, когда работаешь с конкретным клиентом.
  • На отдельной странице (/cart) — полная корзина с группировкой по группам, отправкой спецификации и историей.

Данные в обоих местах — одни и те же. Добавил в карточке клиента — увидел на /cart.

Добавление продуктов
  • Откройте карточку клиента или страницу /cart.
  • Найдите продукт через список групп или поиск.
  • Укажите количество — продукт сразу попадает в корзину.
  • Количество можно менять кнопками «−» и «+» или вручную.
  • Кнопка «Корзина» (иконка с мусорной корзиной) — удаляет позицию.
Продукты со статусом Временно недоступен добавить нельзя. Если он уже в корзине — уменьшать или удалять разрешено.
Активная корзина

В системе может быть несколько корзин — по одной на клиента. Активная корзина — это та, которую вы видите на /cart.

  • Когда вы открываете карточку клиента, у которого есть товары в корзине, его корзина становится активной.
  • Если корзина клиента пуста — активная корзина не меняется.

Это значит: зашёл к клиенту с товарами, перешёл на /cart — увидел именно его корзину.

Отправка спецификации

На странице /cart внизу — блок «Отправка спецификации».

  • Email получателя — можно несколько адресов через запятую или пробел.
  • Галочки «Клиенту» и «Себе» — быстро подставляют нужный адрес.
  • Комментарий — опционально, добавится в письмо.

К письму прикладывается XLSX-файл со спецификацией.

После отправки: корзина очищается и сохраняется в историю. Вы возвращаетесь в карточку клиента (если корзина была привязана к нему) или в список клиентов.

Сохранить в историю без отправки

Кнопка «Сохранить в историю» — на странице /cart и в карточке клиента.

  • Сохраняет текущее состояние корзины как спецификацию.
  • Не отправляет письмо и не очищает корзину.
  • Полезно, когда нужно зафиксировать «черновик» — а отправить позже.
История корзин

Все отправленные и сохранённые корзины доступны в разделе История (/cart/history).

  • В списке видно дату, клиента, автора, получателя, число продуктов и статус (Отправлено, Сохранено, Получено).
  • Клик по записи открывает просмотр спецификации.
  • Кнопка «Восстановить в корзину» — загружает продукты из спецификации в текущую активную корзину.
Счётчики и очистка
  • В заголовке каждой группы — «N позиций, M шт.». Пересчитывается при изменении количества.
  • Внизу страницы — общий итог: групп, позиций, продуктов.
  • Кнопка «Очистить корзину» — удаляет все позиции. Спросит подтверждение.

Права доступа

Права определяют, какие действия может выполнять пользователь.

Уровни прав
Право Что даёт
view Просмотр группы и её содержимого
use Использование продуктов (добавление в корзину)
edit Редактирование продуктов в группе
manage Полное управление группой (создание, редактирование, удаление, передача прав)
Как проверяются права

При проверке прав у пользователя система проверяет все его сущности:

  1. Прямые права — права, переданные его personal сущности
  2. Права через контейнеры — права, полученные через компании и отделы, в которых он состоит
Пример: Если пользователь состоит в отделе, и отдел имеет права на группу — пользователь автоматически получает эти права.
Если у пользователя несколько источников прав (например, личные права + права через отдел), они объединяются. Пользователь получает максимум из доступного.
Цепочка делегирования

Права можно передавать дальше. Если автор группы передал права пользователю А, тот может передать их пользователю Б, тот — В, и так далее.

Каждый получатель в цепочке имеет свой источник прав (мастера) — того, от кого он получил доступ. Цепочка ведёт к автору группы, у которого есть корневое право.

Пример цепочки: Автор → А → Б → В. Каждый участник видит группу только пока цепочка от него до автора неразрывна.
Правило: права не расширяются

Право активно, только если оно есть у каждого звена цепочки до автора. Нельзя иметь право, которого нет у твоего мастера.

Формально: права получателя = объявленные права получателя ∩ права мастера.

Пример: Автор дал А только view. А передал Б view, use, edit (например, ошибся в форме или данные изменились позже).
Автор
    │  view
    ▼
А (реальные: view)
    │  view, use, edit  ← в базе записано больше, чем у А
    ▼
Б (реальные: view)  ← фактически только view

Б получит только view — то, что есть у А. Права use, edit «висят» в базе, но не работают. Если А когда-нибудь получит use, edit — они оживут автоматически.

Это защищает от эскалации прав: даже если в базе случайно записано больше, чем у мастера, реальные права получателя всё равно ограничены цепочкой.

Разрыв и восстановление цепочки

Цепочка прав может быть разорвана. Это происходит, когда у одного из участников отзывают права. При этом система не удаляет права нижестоящих участников — они сохраняются как неактивные.

Как это работает:

  • Право считается активным, если от получателя до автора группы есть непрерывная цепочка (прямая передача или наследование через контейнер).
  • Если цепочка разорвана — право становится неактивным: получатель временно теряет доступ, но запись о передаче сохраняется.
  • Если цепочка восстановится (например, разорванное звено снова получит права), все нижестоящие права автоматически станут активными — с учётом правила «права не расширяются».
Пример: Цепочка Автор → А → Б → В. Если автор отзовёт права у А, то Б и В тоже временно потеряют доступ. Если позже автор снова передаст права А — Б и В восстановят доступ автоматически, без повторной передачи.

Такой подход позволяет сохранить историю делегирования и не терять данные при временных изменениях в структуре прав.

Права — снимок на момент передачи

Когда вы передаёте права на группу, которая содержит подгруппы, система фиксирует права только для тех подгрупп, которые существуют в этот момент.

Что это значит на практике:
  • Передали права на «Группу А» с тремя подгруппами — получатель видит все три.
  • Позже вы добавили в «Группу А» новую подгруппу — получатель её не увидит.
  • Чтобы дать доступ к новой подгруппе — передайте права на неё отдельно.

Это сделано специально: мотивы доступа могут меняться со временем, и отправитель прав должен быть уверен, что передано ровно то, что он передавал. Права на родительскую группу можно использовать как индикатор того, что «здесь есть делегирование» — при добавлении подгруппы система может напомнить вам о необходимости передать права.

Сложный пример: разрыв, восстановление и пересечение

Полный сценарий, показывающий все правила вместе.

Шаг 1. Исходная цепочка
Автор группы
    │  view, use, manage
    ▼
А
    │  view, use
    ▼
Б
    │  передача отделу
    ▼
Отдел «Продажи»
    │  членство
    ▼
Сотрудник С

Что видят:

  • А: view, use, manage.
  • Б: view, use (пересечение с правами А).
  • Отдел: view, use (пересечение с правами Б).
  • С: view, use (через отдел).
Шаг 2. Разрыв

Автор отзывает права у А.

  • А теряет доступ.
  • Б теряет доступ.
  • Отдел и С теряют доступ.
  • В базе: удалена только связь «Автор → А». Всё остальное сохранилось.
Шаг 3. Восстановление с меньшим набором прав

Автор снова даёт А права — но теперь только view, use (без manage).

Автор
    │  view, use
    ▼
А (реальные: view, use)
    │  view, use
    ▼
Б (реальные: view, use)
    │  передача отделу
    ▼
Отдел (реальные: view, use)
    │  членство
    ▼
С (реальные: view, use)

Все связи ожили автоматически. Все нижестоящие снова видят группу.

Шаг 4. Восстановление с ещё меньшим набором

Допустим, автор дал А только view. Что произойдёт:

  • А: view.
  • Б: view (объявлено view, use, но у А только view).
  • Отдел: view.
  • С: view.
Правило «права не расширяются» работает на каждом звене. Итоговые права — это минимум по всей цепочке. Никто не может иметь больше, чем автор дал самому верхнему звену.

Передача прав

Права на группы можно передавать трём типам получателей.

Кому можно передавать права

Права всегда передаются от вашей personal сущности. Получателем может быть:

  • Пользователь (personal) — по email. Если пользователя нет, он получит приглашение.
  • Отдел — если вы являетесь руководителем отдела. Все сотрудники отдела получат права.
  • Компания — если вы являетесь владельцем компании. Все сотрудники компании получат права.
Важно: Компания и отдел — это контейнеры. Они получают права, а сотрудники наследуют их через членство.
Передача прав на группы
Индивидуальная передача

На странице Граф прав (🔑) для конкретной группы:

  • Выберите получателя: пользователь, отдел или компания
  • Для пользователя укажите email, для отдела и компании — выберите из списка
  • Выберите права (view, use, edit, manage)
  • Нажмите «Назначить»
Массовая передача

В разделе Каталог → Группы:

  • Отметьте группы с помощью чекбоксов
  • Нажмите «Назначить права на выбранные группы»
  • Выберите получателя (пользователь, отдел или компания) и права
В форме массовой передачи доступны только те права, которые есть у вас на всех выбранных группах. Если у групп нет общих прав — массовая передача невозможна.
Передача прав на группу с подгруппами

Если вы передаёте права на группу, которая содержит подгруппы, права будут переданы и на саму группу, и на все её подгруппы, существующие в этот момент.

Что это значит:
  • Права фиксируются на момент передачи — для всех подгрупп, которые существуют сейчас.
  • Если позже вы добавите новую подгруппу — она не получит права автоматически.
  • Чтобы дать доступ к новой подгруппе, передайте права на неё отдельно.

Это сделано специально: мотивы доступа могут меняться со временем, а отправитель должен быть уверен, что передано ровно то, что он передавал. Подробнее — в разделе Права доступа.

Отзыв прав

Чтобы отозвать права у пользователя, откройте форму передачи прав и снимите все галочки, оставив поле email заполненным.

При отзыве прав:

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

На каждом звене цепочки прав действует правило: права нижестоящего — не больше, чем у вышестоящего.

Если вы получили view, use от мастера, а передали получателю view, use, edit, manage — у получателя будут только view, use. Права edit, manage не пройдут через цепочку.

Пример:
Автор группы
    │  view
    ▼
Пользователь А   (реальные права: view)
    │  view, use, manage  (объявлено, но шире, чем у А)
    ▼
Пользователь Б   (реальные права: view)

Пользователь Б фактически имеет только view — потому что больше от А не прошло. Однако в базе запись «А → Б: view, use, manage» сохраняется — если А когда-нибудь получит больше прав, Б автоматически получит use, manage.

Это защищает от «эскалации прав»: никто не может передать больше, чем имеет сам, даже если он как-то записал лишнее.

Наследование прав через отдел

Руководитель отдела может передать права отделу (как контейнеру):

  • На странице управления правами выберите опцию «Отделу»
  • Выберите отдел из выпадающего списка
  • Все сотрудники отдела автоматически получат права через наследование
  • Новые сотрудники, добавленные в отдел позже, также получат эти права
Преимущество: Это удобно для командной работы — не нужно передавать права каждому сотруднику отдельно.
Важно: Личные права сотрудников отдела не изменяются при передаче прав отделу. Если у сотрудника были личные права — они остаются. При проверке доступа права из личного источника и права через отдел объединяются.
Наследование прав через компанию

Владелец компании может передать права компании (как контейнеру):

  • На странице управления правами выберите опцию «Компании»
  • Все сотрудники компании автоматически получат права через наследование
  • Новые сотрудники, добавленные в компанию позже, также получат эти права
Компания отображается в графе прав отдельным узлом (🏛️) с указанием email владельца.
Ограничения при передаче

Система не допустит следующие операции:

  • Передача прав автору группы — автор всегда имеет полный доступ к своей группе.
  • Создание цикла — если передача приведёт к замкнутой цепочке (например, Б даёт права А, при том что А уже дал права Б), операция блокируется с сообщением об ошибке.
  • Передача прав, которых у вас нет — вы не можете передать больше, чем имеете сами. Проверка идёт на каждую группу отдельно.
  • Передача прав от контейнера — отдел и компания не могут передавать права дальше. Только personal-сущности могут быть источником передачи.

Предложения по замене прав

Когда два разных пользователя пытаются передать права одному получателю, возникает конфликт источников.

Когда создаётся предложение
  1. Пользователь А уже передал права пользователю Б на группу.
  2. Пользователь В пытается передать права пользователю Б на ту же группу.
  3. Система видит, что у пользователя Б уже есть другой источник прав.
  4. Создаётся предложение для пользователя Б.
  5. Пользователь Б видит иконку с числом в разделе «Группы».
  6. При клике открывается модальное окно с выбором источника прав.
Предложение также создаётся при попытке отозвать права, если текущий мастер получателя — не вы.
Варианты выбора
  • Оставить текущий источник — права остаются от текущего мастера. Все ожидающие предложения для этой группы автоматически отклоняются.
  • Принять от [имя] — текущие права заменяются на предложенные. Мастером становится отправитель предложения.
Важно: При выборе нового источника ваши текущие права на эту группу удаляются и заменяются новыми. Остальные предложения автоматически отклоняются.
Проверки безопасности

Перед применением предложения система проверяет возможность создания цикла в цепочке прав. Если применение предложения приведёт к замкнутой цепочке — операция блокируется с сообщением об ошибке.

Это защищает систему от некорректных состояний, даже если предложение было создано до того, как цепочка стала циклической.

Уведомления
  • Получатель получает уведомление о новом предложении (в интерфейсе и на email).
  • Отправитель получает уведомление о принятии или отклонении его предложения.
  • При принятии одного предложения остальные автоматически отклоняются, их отправители получают уведомления.

Граф прав

Граф показывает цепочку передач прав на группу.

Что отображается
  • Узлы — пользователи, компании и отделы с их правами.
  • Связи — кто кому и когда передал права.
  • Дата и время — когда была совершена передача.
  • ID записей — для отслеживания конкретных передач.
  • Члены отдела — с указанием руководителя (★).
Какие права показываются

В графе показываются активные (реальные) права узла с учётом всей цепочки до автора группы. Это не то, что записано в форме передачи, а то, что у узла фактически есть.

Если у промежуточного звена права были урезаны, все нижестоящие узлы автоматически покажут урезанный набор.

Пример: В форме было указано, что А передал Б view, use, edit. Но у самого А сейчас только view — значит в графе у Б будет отображаться view, а не полный набор.
Автор
    │  view
    ▼
А   (👁️ view)
    │  было записано view, use, edit
    ▼
Б   (👁️ view)  ← в графе только view

Это соответствует правилу «права не расширяются» (см. раздел Права доступа).

Условные обозначения
  • автор — создатель группы
  • (вы) — текущий пользователь
  • 👤 — пользователь (personal)
  • 🏢 отдел — сущность типа «отдел»
  • 🏛️ компания — сущность типа «компания»
  • ★ — руководитель отдела
  • → — дата и время передачи
Взаимодействие с графом
  • Нажмите на любой узел, чтобы назначить права (только если у вас есть право manage).
  • Пользователь с manage может передавать права.
  • Только получатель может принять предложение о замене прав.
Активные и неактивные ветки

Граф показывает только активные цепочки — те, что непрерывно доходят до автора группы. Если цепочка разорвана (например, у промежуточного пользователя отозваны права), её ветка не отображается.

Записи о разорванных передачах сохраняются в системе — если цепочка восстановится, ветка снова появится в графе с теми же правами (урезанными по цепочке).

Циклы в графе

Система не допускает создания циклов в цепочке прав.

Если при передаче прав возникнет ситуация, когда получатель уже является мастером для отправителя (напрямую или через промежуточных пользователей), операция блокируется с сообщением об ошибке.

Пример: Цепочка Автор → А → Б. Если Б попытается передать права А, возникнет цикл (Б → А и А → Б). Такая передача невозможна.
Что видит пользователь

Граф строится относительно текущего пользователя. Это значит:

  • Автор группы видит весь граф от себя вниз — все передачи и всех получателей.
  • Обычный получатель видит только свою ветку: от своего мастера вверх (если путь доступен) и от себя вниз (кто получил права от него).
  • Ветки, не связанные с текущим пользователем, скрываются.
Это защита приватности: пользователь не видит чужие цепочки делегирования, если он в них не участвует.
Граф показывает все акты передачи прав, включая повторные и возвратные передачи. Это помогает отследить полную историю делегирования прав на группу.

Партнёры

В разделе Партнёры отображаются пользователи, с которыми у вас есть активный обмен правами на группы.

Что отображается
  • Имя и email партнёра
  • Передано — сколько прав вы передали этому пользователю
  • Получено — сколько прав вы получили от него
  • Последняя операция — дата последнего обмена
Список формируется автоматически. Партнёр появляется, как только вы или он передали права на группу.
Права с партнёром

Нажмите Права в строке партнёра, чтобы увидеть:

  • Переданные группы — что вы передали партнёру
  • Полученные группы — что партнёр передал вам

Страница имеет две вкладки — «Переданные» и «Полученные». Группы отмечены с указанием прав.

Безопасность

Подтверждение email

При самостоятельной регистрации система отправляет письмо со ссылкой на указанный email.

  1. Зарегистрируйтесь на странице /register.
  2. На ваш email придёт письмо с ссылкой для подтверждения.
  3. Перейдите по ссылке. Ссылка действительна 3 дня.
  4. После подтверждения вы получите доступ ко всем разделам.

До подтверждения вы видите только страницу ожидания. Там можно запросить письмо повторно.

При регистрации по приглашению (от компании, отдела или при передаче прав) email подтверждается автоматически — вы уже получили письмо-приглашение и перешли по нему.
Сброс пароля

Если вы забыли пароль:

  1. На странице входа нажмите «Забыли пароль?».
  2. Введите email, указанный при регистрации.
  3. На email придёт ссылка для сброса пароля. Ссылка действительна 1 час.
  4. Перейдите по ссылке и установите новый пароль.
Для безопасности система не сообщает, существует ли указанный email в системе. Вы всегда увидите одно и то же сообщение.
Требования к паролю
  • Минимум 6 символов
  • Пароль хранится в виде хеша (BCrypt), не в открытом виде
Конфиденциальность данных
  • В URL отображаются UUID вместо числовых ID — внешние пользователи не могут оценить объём данных системы
  • Данные клиентов, групп и продуктов изолированы по правам доступа
  • Пользователь видит только те данные, к которым у него есть прямой или наследованный доступ

Журнал действий

Все ваши действия логируются:

  • Передача прав
  • Отзыв доступа
  • Отправка корзин
  • Назначение прав на группы
  • Создание и обработка предложений по замене прав

Журнал доступен только вам и показывает только ваши действия или действия, направленные на вас.

Настройки

В настройках вы можете управлять своим профилем и структурой компании.

Профиль
  • Имя — отображается в системе, используется для идентификации
  • Email — изменить нельзя, используется для входа
Пароль

Сменить пароль можно на странице Настройки → Пароль.

  • Введите текущий пароль и новый пароль дважды
  • Новый пароль должен содержать минимум 6 символов
Если вы забыли пароль — используйте ссылку «Забыли пароль?» на странице входа. Подробнее см. раздел «Безопасность».
Компании и отделы

В этом разделе вы можете:

  • Создать компанию (одну на пользователя)
  • Создать отделы внутри компании
  • Приглашать сотрудников и управлять ими
  • Удалять отделы и компанию (если в ней нет отделов)

Подробнее см. раздел «Компании и отделы».

Часто задаваемые вопросы

Доступ можно получить тремя способами:
  1. Самостоятельная регистрация — перейдите на страницу /register, заполните форму, подтвердите email по ссылке из письма.
  2. Приглашение от владельца компании или отдела — вы получаете ссылку на почту, переходите по ней, подтверждаете участие и устанавливаете пароль.
  3. Приглашение при передаче прав на группу — если вы ещё не зарегистрированы, система автоматически создаст учётную запись и отправит приглашение.

Скорее всего, вы не подтвердили email. Проверьте почту — должно прийти письмо со ссылкой для подтверждения.
  • Проверьте папку «Спам»
  • Если письма нет — на странице ожидания нажмите «Отправить письмо повторно»
  • Ссылка действительна 3 дня
Подробнее см. раздел «Безопасность».

На странице входа нажмите «Забыли пароль?», введите email, указанный при регистрации. На него придёт ссылка для сброса пароля (действительна 1 час). Подробнее см. раздел «Безопасность».

Перейдите в Настройки → Компании и отделы, нажмите «Создать компанию» и укажите название компании.

Два способа:
  • Массовая передача — в разделе Каталог → Группы отметьте нужные группы чекбоксами и нажмите «Назначить права на выбранные группы».
  • Индивидуальная передача — откройте Граф прав (🔑) для конкретной группы и заполните форму «Назначить права».
Получателем может быть пользователь (по email), отдел (если вы его руководитель) или компания (если вы её владелец).

Нет. Каждый пользователь может быть владельцем только одной компании. Это ограничение действует, чтобы структура владения была однозначной.

Конечная группа (лист) — это группа, в которой нет подгрупп. Только в такие группы можно добавлять продукты. Если в группу был добавлен хотя бы один продукт, она навсегда становится конечной — создать подгруппы в ней уже нельзя.

Да. Все отправленные и сохранённые корзины сохраняются в истории. Вы можете восстановить любую из них.

При передаче доступа к клиенту система создаёт вам копию клиента. На этой копии вы видите объединённый набор привязок:
  • Ваши группы — помечены бейджем Вы
  • Группы отправителя (те, на которые у вас есть права) — помечены бейджем от [имя]
Если отправитель отзовёт доступ — его группы пропадут из вашей карточки, но ваша копия, ваши группы и история останутся. Подробнее см. раздел «Клиенты».

Вы видите только те клиенты, к которым у вас есть доступ. Доступ передаётся через других пользователей. Попросите владельца клиента передать вам доступ.

  • personal — это вы. Ваша личная сущность. Вы действуете от её имени. Получает права напрямую (по email).
  • company — это компания. Контейнер для сотрудников и получатель прав. Владелец может передать права компании напрямую.
  • department — это отдел. Контейнер внутри компании. Руководитель отдела может передать права отделу напрямую.

Сотрудники наследуют права компании и отдела через членство.

Предложение создаётся, когда два разных пользователя пытаются передать права одному получателю. Получатель может выбрать, от кого он хочет получать права — оставить текущего мастера или принять права от нового. Подробнее см. раздел «Предложения по замене прав».

Когда руководитель отдела передаёт права отделу, все сотрудники отдела получают эти права через членство. Новые сотрудники, добавленные в отдел позже, также получают эти права.

Если у сотрудника есть личные права на ту же группу — они не заменяются и не блокируются. Права из личного источника и права через отдел объединяются: сотрудник получает максимум из доступного.

Если цепочка прав до отдела разорвана — сотрудники временно теряют доступ через отдел, но личные права на группу сохраняются. Если цепочка восстановится — доступ через отдел вернётся автоматически.

Подробнее см. раздел «Передача прав».

Да. Один продукт может находиться в нескольких группах одновременно. Для этого откройте редактирование продукта — там есть блок «Группы продукта» с текущими привязками и выпадающим списком доступных групп.

Правило: привязать продукт можно только к группам того же владельца, что и сам продукт. Если продукт создан в группе пользователя X, то и группы должны принадлежать X.

Если вам нужен продукт другого производителя в своей группе — обратитесь к владельцу продукта, и он привяжет его к нужной группе от своего имени.

  • Автор — тот, кто физически создал продукт. Может быть любым пользователем с правом edit на группу.
  • Владелец — тот, кому принадлежит группа, в которой создан продукт (хозяин группы).

Если продукт создан вами в своей группе — автор и владелец совпадают. Если продукт создан кем-то другим в вашей группе — автор он, а владелец — вы.

Практическое следствие: владелец управляет продуктом как хозяин группы — привязывает к другим своим группам, удаляет. Автор может редактировать продукт, пока имеет право edit на его группы. Подробнее см. раздел «Каталог».

На странице Все продукты и в поиске на странице клиента работает умный поиск. Он ищет по коду, названию, описанию (включая текст таблиц) и группе.

Синтаксис:

  • ключ гайки — оба слова должны найтись (порядок не важен).
  • "ключ гайки" — точная фраза.
  • Регистр не важен.

Найденные фрагменты подсвечиваются жёлтым.

Это короткие сообщения (до 1000 символов), прикреплённые к продукту. Они показываются лентой в карточке продукта.

Кто может:

  • Добавить новость — владелец продукта или пользователь с правом edit на любую группу продукта.
  • Редактировать или удалить — автор новости или владелец продукта.

В списках продуктов у продуктов с новостями показывается значок N, где N — число новостей.

  • Временно недоступен — нельзя добавить в корзину. Уже добавленные позиции можно уменьшать или удалять.
  • Ограничено — добавить можно, но есть ограничения (в заметке).
  • Снят с производства — устаревший продукт, добавление не блокируется.

Статус отображается иконкой рядом с названием и сопровождается заметкой, если она задана.