Инструкция для менеджера по платным заявкам¶

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

В коде: отдельный модуль commercial_requests, пункт меню «Коммерция» (/commercial). Роль процесса — право commercial.role.manager («Роль менеджера коммерции»). Это не отдельная системная роль в БД: право назначается через Роли и права (часто роли manager, director, supervisor или кастомной «Менеджер по платным заявкам»).
Контрагенты и общие настройки площадки — Инструкция для администратора.

За 30 секунд¶

Задача	Куда
Список платных заявок	Боковое меню → Коммерция (`/commercial`)
Канбан по стадиям	Коммерция → вкладка Канбан
Справочник работ/материалов	Коммерция → вкладка Справочник
Смета и сумма	Карточка → вкладка Смета
Оплаты	Карточка → вкладка Оплаты
Исполнение работ	Карточка → вкладка Исполнение
Договор, счёт, акт	Карточка → Документы
Подтвердить оплату	Действие Отправить на оплату / Подтвердить оплату

Отдельный процесс

Платные заявки не смешиваются со списком обычных Заявок (/tickets). Свой жизненный цикл, статусы и роли.

1. Доступ и настройка¶

Для администратора (первичная настройка)¶

Настройки объекта → Модули — включите commercial_module. В меню появится Коммерция → /commercial.
Настройки → Роли и права — выдайте пользователю commercial.role.manager и связанные права: commercial.view, commercial.transition, commercial.documents.*, commercial.payments.confirm (полный список — ниже).
У пользователя должен быть активный профиль персонала на площадке — иначе он не попадёт в кандидаты ответственного менеджера.
Настройте ответственного менеджера для площадки: API GET/PATCH /api/v1/commercial/settings (manager_user_id) или UI плагина коммерции.

Без включения модуля раздел не появится в меню, даже если права уже выданы.

Для менеджера¶

Раздел Коммерция доступен после включения commercial_module администратором (см. выше).

Права менеджера¶

Минимальный набор для менеджера платных заявок:

Право	Назначение
`commercial.view`	Просмотр списка и карточки
`commercial.role.manager`	Действия менеджера в процессе
`commercial.transition`	Переводы статусов
`commercial.edit`	Редактирование карточки
`commercial.estimate.manage`	Смета
`commercial.documents.manage` / `.view`	Документы
`commercial.payments.confirm`	Подтверждение оплаты
`commercial.analytics.view`	Сводка на списке (опционально)

Кандидат в ответственные менеджеры — активный пользователь с активным персоналом на площадке и правом commercial.role.manager. Настройка: API GET/PATCH /api/v1/commercial/settings (manager_user_id); новые заявки могут автоматически назначаться на настроенного менеджера.

Другие роли в процессе¶

Роль процесса	Право	Зона
Диспетчер коммерции	`commercial.role.dispatcher`	Регистрация, координация, выезд
Сметчик	`commercial.role.estimator`	Смета, оценка
Менеджер	`commercial.role.manager`	Документы, оплата, закрытие
Исполнитель	`commercial.role.executor`	Работы после оплаты

2. Жизненный цикл (статусы)¶

Платная заявка проходит отдельную цепочку (актуальный процесс v2):

Черновик → Выезд / подсчёт → Подготовка документов → Ожидание оплаты →
Оплачено → [Закупка] → В работе → Выполнено → Закрытие документов → Закрыто

Статус	Подпись в UI
`draft`	Черновик
`surveying`	Выезд / подсчёт
`preparing_documents`	Подготовка документов
`awaiting_payment`	Ожидание оплаты
`paid`	Оплачено
`procurement_pending`	Закупка
`in_work`	В работе
`on_hold`	На паузе
`completed`	Выполнено
`documents_closing`	Закрытие документов
`closed`	Закрыто

SLA на выполнение работ отсчитывается после оплаты, не на этапе сметы.

3. Работа менеджера по этапам¶

3.1. После выезда / подсчёта¶

Диспетчер или сметчик переводит заявку в Подготовка документов. Менеджер:

Проверяет данные объекта и контакт арендатора (если заявка привязана к арендатору).
На вкладке Смета — позиции из Справочника (работа / материал) или свои строки, количество, цена; при необходимости наценка % или итог вручную.

На вкладке Документы — загрузите счёт (invoice), при необходимости договор, акт.
Вкладка Оплаты — статусы и подтверждение оплаты по процессу.
Вкладка Исполнение — ход работ после оплаты (когда заявка в работе или на паузе).

3.2. Отправка на оплату¶

Действие Отправить на оплату (send_to_payment).
Система проверит: есть смета и загружен счёт.
Укажите срок оплаты и сумму, при необходимости тип оплаты (нал / безнал).

Статус → Ожидание оплаты.

3.3. Подтверждение оплаты¶

После поступления денег — Подтвердить оплату (confirm_payment).
Укажите сумму и тип оплаты.
Статус → Оплачено.

3.4. Закупка (опционально)¶

Если нужны материалы:

В закупку / снабжение (send_to_procurement) — создаётся связь с модулем Отдел снабжения.
Статус → Закупка; после получения материалов — Материалы получены / переход в В работе.

Если закупка не нужна — Пропустить закупку (skip_procurement) → сразу В работе.

→ Инструкция для менеджера отдела снабжения

3.5. Исполнение и закрытие¶

Исполнитель выполняет работы (В работе → Выполнено).
Менеджер инициирует Закрывающие документы — акт должен быть в статусе signed.
Закрыть сделку — финальный статус Закрыто.

4. Экран «Платные заявки»¶

Канбан — колонки по стадиям процесса.
Список — фильтр по статусу и арендатору, поиск, счётчики.
Справочник — каталог работ и материалов для сметы (создание/редактирование при наличии прав на каталог).
Аналитика — сводка (если выдано commercial.analytics.view).
Карточка — шапка со статусом; вкладки Обзор, Смета, Документы, Оплаты, Исполнение, История.

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

5. Документы¶

Типы: договор, счёт, акт, КС-2/КС-3, проект, доп. соглашение, подтверждение оплаты, смета (файл).

Workflow документа: draft → approved → signed. Перед Закрыть сделку нужен подписанный акт.

Чеклист менеджера¶

[ ] Модуль Коммерция включён на объекте
[ ] У учётной записи есть commercial.role.manager
[ ] Смета и счёт загружены до Ожидание оплаты
[ ] Оплата подтверждена с корректной суммой
[ ] Закупка передана в снабжение (если нужна)
[ ] Акт подписан перед закрытием

Что нового¶

История релизов → 9 сентября · CHANGELOG — commercial