Руководство по интерактивному генератору технического задания CRM

Пошаговая инструкция о том, как спроектировать и выгрузить Техническое задание (ТЗ) на архитектуру CRM: от сущностей базы данных и матрицы связей до регламентов воронки, прав доступа и серверного контура.

📑 1. Шаг 1: Паспорт проекта и выбор отрасли

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

• Название компании / проекта: Официальное наименование вашей организации или внедряемого продукта (например, ООО «КонсалтГрупп»).
• Автор ТЗ и ответственный: ФИО и должность специалиста, ведущего проект (например, «Михаил Смирнов, операционный директор»).
• Контактные данные: Telegram, рабочий телефон или e-mail ответственного лица.
• Масштаб команды пользователей: Планируемое количество рабочих мест (1–5, 5–15, 15–30 или более 50). От масштаба зависят требования к мощности сервера и разграничению прав доступа.

Выбор отраслевого сценария:

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

Как управлять отраслевыми базисами:

• Переключение в 1 клик: Кликните по любой плашке отрасли внутри карточки паспорта проекта. Верстак моментально загрузит соответствующую структуру сущностей и настроек.
• Свободное редактирование: Нажмите значок карандаша ✏️ у названия отрасли, чтобы переименовать её под свою компанию.
• Добавление своей отрасли: Нажмите кнопку ➕, чтобы создать пустую чистую ветку для уникального направления бизнеса.
• Удаление отрасли: Кнопка крестика ✕ удаляет лишнюю отрасль. В системе всегда остается минимум один рабочий базис.

🎯 2. Шаг 2: Источники лидов и защита от дублей

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

• Формы на сайте и лендингах: Прием заявок через вебхук с сохранением рекламных UTM-меток в карточке лида.
• Telegram-боты и мессенджеры: Фиксация входящих обращений и привязка аккаунтов к контакту.
• Корпоративная почта: Создание лидов из входящих писем с прикреплением файлов.
• Поочередное распределение (Round-Robin): Назначение ответственных менеджеров по кругу или по наименьшей загрузке для равномерной работы команды.
• Защита от дублей: Автоматическая склейка повторных заявок по номеру телефона и email с обновлением истории в существующей карточке.
• Добавление и редактирование: Кнопка ➕ Добавить канал позволяет вписать любой уникальный источник, а перетаскивание ⋮⋮ настраивает их приоритет.

🗄️ 3. Шаг 3: Архитектура сущностей и матрица связей (База данных)

Инженерный фундамент системы. Сущность (Entity) — это отдельная таблица в базе данных со своими полями и правилами (например, «Контрагенты», «Сделки», «Склады», «Наряды цеха»).

Типы архитектурных связей:

• Один ко многим (1:M, belongsTo / hasMany): У одного Контрагента может быть множество Сделок. У одной Сделки может быть множество счетов и актов. Каждая дочерняя запись четко знает своего родителя.
• Многие ко многим (M:M): Несколько сотрудников могут работать над несколькими проектами одновременно.
• Добавление своих сущностей: Нажмите кнопку + Добавить сущность, введите название, системный код и укажите связи со смежными таблицами.
• Сортировка: Зажмите ручку ⋮⋮ слева от сущности и перетащите её на нужное место в иерархии.

📊 4. Шаг 4: Воронка продаж и нормативы SLA

Этапы воронки определяют жизненный цикл сделки от первого знакомства до успешной оплаты:

• Норматив времени (SLA): Задает жесткий лимит нахождения сделки на стадии (например, «Квалификация — до 2 часов», «Подготовка КП — до 24 часов»). При превышении лимита CRM автоматически уведомит руководителя.
• Условия перехода (Критерии завершения): Чек-лист обязательных требований, без выполнения которых система физически не разрешит перевести карточку на следующий шаг (например, «Прикреплен скан договора с подписью» или «Внесена предоплата 50%»).
• Добавление и настройка: Кнопка ➕ Добавить этап позволяет вставить промежуточный шаг, а чекбоксами можно временно отключать этапы из регламента.

🔐 5. Шаг 5: Безопасность и серверный контур (Защита и сервер)

Пятый шаг объединяет разграничение прав доступа и требования к серверной инфраструктуре платформы:

Ролевая модель и правила безопасности:

• Иерархия ролей: Администратор (полный доступ), РОП (доступ ко всем сделкам отдела), Линейный менеджер (только свои назначенные записи).
• Field-Level Security (Безопасность на уровне полей): Скрытие конфиденциальных полей (себестоимость, маржа, личные контакты учредителей) от стажеров и менеджеров.
• Запрет удаления: Менеджеры не имеют права безвозвратно удалять карточки клиентов — только перемещать в архив с обязательным указанием причины отказа.

Серверный контур и оркестрация:

• On-Premise (Собственный сервер): Размещение CRM на независимом VPS под управлением AlmaLinux 9. Никаких зарубежных облаков и абонентских плат за количество сотрудников.
• Docker Compose: Изоляция каждого сервиса в своем контейнере (EspoCRM, СУБД MariaDB, фоновый демон Cron). Это исключает конфликты библиотек и гарантирует стабильность.
• Автоматические резервные копии: Еженощный дамп базы данных и архивация пользовательских файлов на удаленное независимое хранилище.
• Внешняя интеграционная шина (n8n): Тяжелые внешние интеграции (мессенджеры, DaData, 1С, службы доставки, банковские выписки) подключаются через независимый сервер автоматизаций n8n. Это сохраняет ядро CRM легким и быстрым.

📄 6. Шаг 6: Готовое ТЗ, предпросмотр и экспорт в PDF

Финальный этап собирает проект воедино:

• Инженерная сводка: На экране отображается карточка проекта с подсчетом всех настроенных каналов, сущностей базы данных, активных связей, этапов воронки и правил безопасности.
• Предпросмотр документа: Кнопка 📄 Посмотреть ТЗ (Печать) на нижней панели открывает структурированный типографский документ A4.
• Живая правка заголовков: Перед отправкой на печать кликните по заголовку или подзаголовку на листе — вы можете дописать номер редакции или специфические требования.
• Печать на принтер: Кнопка 🖨️ Распечатать открывает системный диалог печати. Вы можете отправить ТЗ на бумагу или выбрать «Сохранить как PDF».
• Прямой экспорт в PDF: Синяя кнопка 📥 Скачать PDF формирует официальный многостраничный PDF-файл.
• Копирование текста: Кнопка 📋 Скопировать текст помещает весь текст ТЗ в буфер обмена для быстрой вставки в Word, Notion или чаты.

💾 7. Сохранение проекта, экспорт и импорт JSON

Все ваши наработки надежно защищены от потери:

• Автосохранение в браузере: Любые правки немедленно сохраняются в LocalStorage вашего браузера. Вы можете закрыть вкладку и продолжить работу в любой момент.
• Экспорт проекта в файл: Кнопка 💾 Сохранить скачивает файл .json на ваш компьютер. Это полная резервная копия конфигурации всех отраслей.
• Импорт из файла: Кнопка 📂 Открыть загружает сохраненный проект на любом компьютере или в другом браузере.
• Новый проект с нуля: Кнопка 📄 Новый очищает текущий шаблон, позволяя собрать индивидуальную архитектуру с чистого листа.
• Сброс к базовым: Кнопка 🔄 Сброс к базовым восстанавливает эталонные отраслевые пресеты по умолчанию.

💡 8. Стандарты чистого внедрения: как не сломать EspoCRM