CRM для мотосервиса
всё в одном окне

Все сотрудники Основные разделы находятся в боковом меню. На телефоне меню открывается кнопкой в правой части шапки.

1. Аналитика показывает ключевые показатели, популярные услуги и состояние системы.
2. Записи объединяют список, Kanban и календарь.
3. Клиенты содержат карточки клиентов, технику, историю, покупки и переписку.
4. Управление сервисом включает услуги, персонал, склад, графики, мойку и хранение ТС.
5. Онлайн-продажи объединяют Avito, магазин, заказы, промокоды и доставку.
6. Настройки отвечают за интерфейс, реквизиты, интеграции и доступы.

Все сотрудники Откройте Настройки → Настройки аккаунта.

1. Выберите светлую, тёмную или системную тему.
2. Настройте цветное или монохромное отображение статусов.
3. Сохраните изменения — они применятся к текущему аккаунту.

Боковую панель можно свернуть кнопкой в нижней части меню. Состояние запоминается в браузере.

Результат: интерфейс сохраняет выбранный вид при следующем входе.

Администратор Откройте Настройки → Разделы и доступы. Для каждого раздела можно изменить видимость и доступные роли. После сохранения меню сотрудников обновится.

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

Администратор Перейдите в Настройки → Реквизиты.

1. Заполните название, контакты и юридические данные организации.
2. Загрузите логотип в поддерживаемом формате изображения.
3. Проверьте предпросмотр и нажмите «Сохранить».

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

Администратор

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

Учётные записи настраиваются в разделе Сотрудники, профессиональные карточки — в разделе Персонал.

Администратор · Менеджер

1. Откройте раздел Клиенты.
2. Нажмите кнопку «Новый клиент».
3. Укажите ФИО и телефон. При наличии добавьте email и примечание.
4. Проверьте номер телефона: по нему клиент входит в личный кабинет.
5. Сохраните карточку.

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

Администратор · Менеджер В разделе Клиенты используйте поиск по имени, телефону или email. Дополнительные фильтры позволяют выбрать платформу привязки — Telegram, VK, MAX — и источник клиента: сервис или магазин. На мобильном экране фильтры находятся внутри раскрывающегося блока.

Администратор · Менеджер Карточка открывается нажатием на строку клиента и содержит:

• Информация — контакты, источник и основные данные.
• Техника — автомобили и мотоциклы клиента.
• История — записи и обслуживание.
• Покупки — заказы магазина.
• Чат — переписка с клиентом.

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

Администратор · Менеджер Откройте карточку клиента → вкладку «Техника» → «Добавить». Выберите тип транспорта, марку и модель, затем укажите год, VIN, госномер и пробег, если они известны. Сохранённая техника будет доступна при создании записи и в личном кабинете клиента.

Администратор · Менеджер Откройте карточку клиента и нажмите действие редактирования. После изменения контактов сохраните форму. Перед удалением проверьте историю записей, заказы и привязанные социальные сети.

Администратор · Менеджер В списке и карточке клиента отображаются признаки привязки Telegram, VK и MAX. Эти связи создаются только после подтверждённого входа через соответствующее мини-приложение и помогают объединить обращения одного человека.

Администратор · Менеджер

1. Откройте Записи и нажмите «Новая запись».
2. Выберите существующего клиента или создайте нового.
3. Выберите технику клиента и услуги.
4. Укажите дату, временной слот, исполнителя и комментарий.
5. Проверьте итог и сохраните.

Результат: запись появится в списке, Kanban и календаре, а клиент увидит её в личном кабинете.

Все сотрудники с доступом к записям

• Список удобен для поиска, фильтрации и последовательной обработки.
• Kanban группирует карточки по статусам и показывает текущую загрузку.
• Календарь помогает планировать занятость по датам и времени.

Фильтры по датам, механикам и SMS применяются к рабочему представлению.

Администратор · Менеджер · Механик Откройте запись и выберите следующий статус: ожидает → подтверждена → в работе → завершена. Отменённые записи помечаются отдельно. Каждое изменение попадает в историю статусов. Клиент видит актуальный статус и временную шкалу в карточке записи; при настроенных уведомлениях он также получает SMS или push.

Администратор · Менеджер В карточке записи выберите исполнителя, подходящего по типу транспорта, добавьте услуги и необходимые запчасти. Для совместной работы можно назначать сотрудников на отдельные услуги. Перед завершением проверьте фактический состав работ, выданные детали и итоговую стоимость.

Администратор · Менеджер Для переноса откройте карточку и измените дату или временной слот. Для реального отказа клиента используйте «Отменить» — история сохранится, а слот освободится. Удаление предназначено для дублей и ошибочных записей.

Администратор · Менеджер Откройте Настройки записи. Укажите начало и конец рабочего дня, длительность слота, доступные дни и лимиты. Сохраните форму и проверьте предпросмотр слотов. Клиент увидит только доступные даты и время; занятые или отключённые слоты не предлагаются.

Все сотрудники с доступом При открытии карточки выбранная запись добавляется в URL. Скопируйте ссылку из адресной строки и отправьте коллеге. После закрытия карточки или нажатия «Назад» панель возвращается к предыдущему представлению и фильтрам.

Администратор · Менеджер Откройте Услуги → «Добавить услугу». Укажите название, категорию, цену, длительность и применимые типы транспорта. Активные услуги доступны при создании записи и в клиентской онлайн-записи.

Администратор Сначала создайте учётную запись в разделе Сотрудники и назначьте роль входа. Затем создайте или отредактируйте профессиональную карточку в разделе Персонал: должность, контакты, категории и типы транспорта.

Администратор · Менеджер Откройте График работы, выберите период и должность, затем добавьте смены сотрудникам. Фильтр по роли помогает отдельно планировать механиков, мойщиков и мастеров приёмки.

Администратор · Менеджер · Мойщик Раздел Мойка показывает записи с услугами категории «Мойка». Создайте запись, выберите мойщика и меняйте статус по мере выполнения. Недоступные или деактивированные мойщики не предлагаются для новых назначений.

Администратор · Менеджер В разделе Хранение ТС создайте договор хранения, выберите клиента и технику, укажите период, место и условия. Используйте статусы для контроля активных договоров и планируемой выдачи.

Механик После входа механик попадает в отдельный кабинет. В разделе «Мои работы» он видит назначенные услуги, открывает детали, прикладывает фотографии и отмечает выполнение. Завершать можно только собственные назначения; общая запись закрывается после выполнения всех обязательных работ.

Администратор · Менеджер Главная страница показывает выручку, записи и популярные услуги. Раздел Отчёты содержит детальные отчёты и конструктор, Зарплата — начисления сотрудникам, а отчёты магазина и Avito вынесены в соответствующие подразделы онлайн-продаж.

Администратор · Менеджер Подключение настраивается в разделе Телефония. После сохранения параметров номера клиентов становятся доступными для звонка из карточки и панели. История входящих, исходящих и пропущенных вызовов отображается в CRM.

Администратор · Менеджер В разделе Новости создайте материал, добавьте текст и изображение, затем опубликуйте — клиент увидит его в своём приложении. Раздел Рассылки используется для целевых уведомлений. Перед отправкой проверьте аудиторию, текст и канал; массовую отправку нельзя отменить после запуска.

Администратор Откройте Настройки → Контент клиентов. Здесь настраиваются видимые клиенту блоки и сообщения. Используйте короткие понятные формулировки, проверьте результат на мобильном экране и не размещайте внутреннюю служебную информацию.

С введением SMS-верификации вход выглядит так:

• Клиент вводит номер телефона в формате +7.
• Система отправляет 4-значный код через SMS Aero (действует 5 минут).
• Клиент вводит код — существующие пользователи сразу получают токен.
• Новые клиенты заполняют имя один раз при первом входе.

Токен сохраняется в браузере — при повторных открытиях приложения SMS не требуется.

Личный кабинет — это PWA (Progressive Web App). Установка:

• Android (Chrome): открыть сайт → нажать «⋮» → «Установить приложение» или «Добавить на главный экран».
• iOS (Safari): открыть сайт → нажать кнопку «Поделиться» → «На экран Домой».

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

Возможные причины:

• Не настроены переменные SMS_AERO_EMAIL и SMS_AERO_API_KEY — в этом случае в dev-режиме код отображается в ответе API.
• Баланс SMS Aero исчерпан — проверьте в личном кабинете smsaero.ru.
• Прошло менее 60 секунд с предыдущей отправки (rate-limit) — кнопка «Отправить снова» активируется автоматически.
• Номер телефона занесён в стоп-лист оператора — такое случается редко.

Для работы Web Push необходимо:

• Установить переменные VAPID_PUBLIC_KEY и VAPID_PRIVATE_KEY. Сгенерировать их можно командой: node -e "const w=require('web-push'); const k=w.generateVAPIDKeys(); console.log(k)"
• Клиент должен дать разрешение на уведомления в браузере (в личном кабинете есть кнопка «Включить уведомления»).

После этого при каждом изменении статуса записи клиент получает уведомление на телефон.

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

Клиент

1. На главном экране нажмите «Записаться».
2. Выберите технику и необходимые услуги.
3. Выберите доступную дату и время.
4. Добавьте комментарий и проверьте данные.
5. Примените промокод, если он доступен, и подтвердите запись.

Результат: новая запись появится в разделе «Мои записи» со статусом «Ожидает».

Клиент Откройте «Записи». Активные обращения показаны сверху, завершённые и отменённые — в истории. Нажмите на карточку, чтобы увидеть услуги, стоимость, комментарии и последовательность изменений статуса.

Клиент Откройте раздел «Чат» в нижнем меню, выберите диалог и отправьте сообщение. Непрочитанные ответы отмечаются счётчиком. Менеджер получает сообщение в разделе «Сообщения клиентов» панели управления.

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

Клиент Откройте «Магазин», найдите товар по названию или артикулу, откройте карточку и проверьте наличие. Добавьте товар в корзину, укажите количество и перейдите к оформлению. Перед оплатой система повторно проверит цену и остаток.

Администратор · Менеджер В разделе Склад откройте позицию, проверьте название, артикул, цену, остаток, категорию и изображения. Товар должен иметь доступный розничный остаток; позиции, находящиеся только на сервисном складе, не показываются покупателям.

Администратор · Менеджер Откройте Магазин → Промокоды и нажмите создание.

1. Укажите код, период действия и размер скидки.
2. Выберите область применения: магазин, сервис или оба направления.
3. Настройте минимальную сумму, лимит использований и применимые товары или услуги.
4. Сохраните и проверьте предпросмотр расчёта.

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

Администратор · Менеджер Откройте Магазин → Заказы. Проверьте клиента, состав, оплату и способ получения. Переводите заказ по статусам только после фактического действия: подтверждение, сборка, передача в доставку, выдача или отмена.

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

Администратор · Менеджер В разделе Доставка СДЭК проверьте контактные данные, адрес или пункт выдачи, параметры отправления и стоимость. Создайте отправление, сохраните трек-номер и передайте заказ в доставку после сборки.

Клиент Раздел «Заказы» показывает активные покупки и историю. В карточке заказа доступны состав, сумма, применённая скидка, статус оплаты и доставки.

В файле .env задайте три переменные:

SMS_AERO_EMAIL=your@email.ru
SMS_AERO_API_KEY=ваш_api_ключ
SMS_AERO_SIGN=ИмяОтправителя

Логин, ключ и имя отправителя берутся из личного кабинета smsaero.ru. После перезапуска контейнера SMS-отправка активируется автоматически — в настройках CRM появится зелёный индикатор «SMS активны».

SMS отправляется клиенту в следующих случаях:

• При входе в личный кабинет — 4-значный OTP-код верификации.
• При подтверждении записи администратором.
• При изменении статуса заказ-наряда.
• Напоминание накануне визита (за 24 часа, по расписанию).

Все уведомления отправляются асинхронно и не блокируют основной поток обработки.

Индикатор в разделе «Настройки → Интеграции» проверяет наличие трёх переменных: SMS_AERO_EMAIL, SMS_AERO_API_KEY и SMS_AERO_SIGN. Если хотя бы одна из них отсутствует — отображается статус «не настроено». После добавления всех трёх переменных и перезапуска контейнера статус переключается в «активно» без перезагрузки страницы.

Откройте карточку товара на складе (Склад → Позиция). В разделе «Применимость»:

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

Можно добавить неограниченное число связей для одной позиции. Также поддерживается ввод применимости свободным текстом для совместимости с данными из 1С.

Каталог ТС доступен в разделе «Склад → Каталог ТС». Он состоит из двух уровней: марки (бренды) и модели.

Данные можно:

• Добавлять и редактировать вручную прямо в таблице.
• Синхронизировать из 1С — кнопка «Синхронизация с 1С» загружает справочник Catalog_Ф1_МаркиМотоциклов и Catalog_Ф1_МоделиМотоциклов.

Синхронизация обновляет существующие записи и добавляет новые, не удаляя данные, которых нет в 1С.

Типы ТС (мотоцикл, скутер, квадроцикл и т.д.) настраиваются в разделе «Настройки → Типы транспорта». Здесь можно добавить, переименовать или удалить тип. Типы используются при оформлении техники клиента и в форме онлайн-записи.

Для интеграции с 1С:Предприятие через OData задайте переменные окружения:

ONEC_BASE_URL=http://ваш-1с-сервер/base/odata/standard.odata
ONEC_USER=имя_пользователя
ONEC_PASSWORD=пароль

После настройки в панели управления появятся кнопки ручной синхронизации. Автоматическая ночная синхронизация запускается по расписанию cron.

Из 1С синхронизируются:

• Номенклатура — наименование, артикул, цена, единица измерения, остатки.
• Марки мотоциклов — справочник Catalog_Ф1_МаркиМотоциклов.
• Модели мотоциклов — справочник Catalog_Ф1_МоделиМотоциклов с привязкой к маркам.

Синхронизация идёт в одну сторону: 1С → CRM. Изменения в CRM в 1С не записываются.

В панели управления:

• Номенклатура: Склад → кнопка «Синхронизация с 1С» в шапке страницы.
• Каталог ТС: Склад → Каталог ТС → кнопка «Синхронизация с 1С».

Через API: POST /api/admin/warehouse/vehicle-catalog/sync. Синхронизация выполняется асинхронно и возвращает статистику: сколько марок и моделей создано / обновлено.

В реестре персонала поддерживаются четыре должности:

• Механик — назначается на записи ремонта; обязательно указание типов транспорта.
• Мойщик — назначается на записи мойки через специальную доску; обязательно указание типов транспорта.
• Мастер приёмки — работает с входящими записями; типы транспорта не требуются.
• Менеджер по запчастям — работает со складом и заказами; типы транспорта не требуются.

Все должности отображаются в едином разделе «Персонал» с фильтрацией по вкладкам.

Для механиков и мойщиков типы транспорта обязательны — они используются при создании записи для фильтрации доступных специалистов по виду транспорта клиента. Без этих данных система не сможет корректно подобрать мастера.

При попытке сохранить форму без выбора хотя бы одного типа транспорта появляется ошибка «Выберите хотя бы один тип транспорта». Для должностей «Мастер приёмки» и «Менеджер по запчастям» это поле не отображается — оно не обязательно.

Раздел «График работы» отображает смены всего персонала в единой сетке. Вкладки-фильтры над сеткой позволяют ограничить отображение:

• Все — все сотрудники.
• Механик / Мойщик / Мастер приёмки / Менеджер по запчастям — только выбранная должность.

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

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

Назначение также доступно при создании новой записи на мойку через кнопку «+ Новая запись».

Интеграция с Avito настраивается в разделе «Маркетплейс → Настройки Avito»:

• Нажмите «Подключить Avito».
• Вы будете перенаправлены на страницу авторизации Avito (OAuth 2.0).
• Разрешите доступ — и вы вернётесь в CRM с активным подключением.

Токены обновляются автоматически, повторная авторизация не требуется.

Чаты Avito загружаются по запросу — система не использует webhook-подписки (Avito API не предоставляет webhook для чатов). Нажмите кнопку обновления или обновите страницу чатов, чтобы загрузить новые сообщения. Счётчик непрочитанных в навигации обновляется каждые 30 секунд автоматически.

При синхронизации чатов система извлекает данные покупателя (имя, Avito ID) из диалога и создаёт запись клиента в CRM, если её ещё нет. К клиенту привязываются все его чаты и диалоги. Впоследствии клиента можно найти в общем списке и привязать к записи на обслуживание.

Перейдите в раздел «Печатные формы» и нажмите «Новый шаблон». В редакторе:

• Введите название шаблона (например, «Заказ-наряд стандартный»).
• Напишите HTML-разметку документа.
• Вставляйте переменные через двойные фигурные скобки: {{client.fullName}}, {{appointment.number}}.
• При наборе {{ откроется автокомплит с доступными переменными и образцами.

Нажмите «Сохранить», затем «Предпросмотр» — система подставит тестовые данные и покажет результат в PDF.

В шаблоне доступны объекты:

• {{client.*}} — данные клиента: fullName, phone, email.
• {{appointment.*}} — запись: number, date, status, services.
• {{car.*}} — техника: brand, model, vin, mileage, year.
• {{company.*}} — реквизиты вашего сервиса из настроек.
• {{parts}} — массив запчастей с ценами и количеством.

Хелперы: {{money value}}, {{formatDate date}}, {{upper string}}. Полный список — в интерфейсе редактора.

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

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

Проверьте Настройки записи: рабочие часы, длительность слота, выходные дни и лимиты. Затем проверьте уже созданные записи на выбранную дату. Если услуга требует специалиста, убедитесь, что есть активный сотрудник нужной должности и типа транспорта.

Сравните телефоны, email, технику, историю и социальные привязки. Не удаляйте карточку с заказами или записями до переноса необходимых данных. Новых клиентов всегда ищите по телефону перед ручным созданием.

Откройте Настройки → Хранилище и проверьте статус подключения. Убедитесь, что формат и размер файла поддерживаются, а текущая роль имеет доступ к записи или заказ-наряду. При частном S3-хранилище файлы должны загружаться и открываться через авторизованный API.

В разделе Интеграции проверьте обязательные поля и статус соединения. После изменения серверных переменных может потребоваться перезапуск API-контейнера. Для 1С и хранилища дополнительно проверьте доступность адреса из сети сервера.

Проверьте, что запись привязана к правильному клиенту и его номеру телефона. Попросите клиента обновить раздел «Записи». Если запись видна, но уведомление не пришло, отдельно проверьте SMS/push-подписку и журналы отправки.

Подготовьте время ошибки, адрес раздела, роль пользователя, последовательность действий и снимок экрана без персональных данных. Не отправляйте пароли, токены, ключи API, файлы окружения и резервные копии базы через обычную переписку.

Для публичного доступа необходимы:

• 80 / 443 — HTTP/HTTPS для Nginx (панель и личный кабинет).

MongoDB, API и остальные сервисы работают только во внутренней Docker-сети. Не публикуйте наружу порты базы данных и внутренних приложений.

Резервное копирование MongoDB:

docker compose exec mongo mongodump --db s4f --out /backup/$(date +%Y%m%d)

Для PostgreSQL:
docker compose exec postgres pg_dump -U postgres s4f_auth > backup_auth.sql

Рекомендуем настроить cron-задачу для автоматического ежедневного бэкапа с ротацией за последние 7 дней.

Для получения SSL-сертификата через Certbot:

apt install certbot python3-certbot-nginx
certbot --nginx -d panel.s4f-crm.ru -d client.s4f-crm.ru

Certbot автоматически обновит конфигурацию Nginx и настроит автопродление сертификата. Убедитесь, что DNS-записи для обоих доменов указывают на ваш сервер.

API предоставляет внутренний эндпоинт GET /api/healthz, который используется healthcheck-контейнерами.

Логи контейнера:
docker compose logs -f api-server

После развёртывания выполните make post-deploy. Для постоянного внешнего мониторинга можно использовать Uptime Kuma или другую систему, проверяющую публичные HTTPS-адреса.