Руководство по интерактивному генератору технического задания CRM
Пошаговая инструкция о том, как спроектировать и выгрузить Техническое задание (ТЗ) на архитектуру CRM: от сущностей базы данных и матрицы связей до регламентов воронки, прав доступа и серверного контура.
Зачем нужен генератор ТЗ: Девять из десяти внедрений CRM проваливаются или затягиваются на долгие месяцы из-за абстрактных хотелок вида «сделайте нам удобно». Без строгой схемы сущностей разработчики лепят всё подряд в одну кучу, а заказчик получает нерабочий хаос. Этот генератор позволяет собрать строгую архитектуру системы по кирпичикам, согласовать её внутри команды и выгрузить типографский документ в PDF для внедренцев.
🏢 1. Отраслевые базисы и готовые шаблоны
В генератор заложены 4 готовых базиса. Каждый базис содержит специфический набор сущностей, связей и полей, проверенных на реальных внедрениях:
🏢 B2B-услуги и проекты
Классический цикл сделок: квалификация, аудит, подготовка КП, подписание договора, счета, проекты и задачи исполнителей.
📦 Оптовые поставки
Торговая архитектура: склады, номенклатура товаров, резервирование остатков, контроль дебиторской задолженности и отгрузки.
🏭 Производство под заказ
Инженерный учет: конструкторские чертежи, спецификации материалов (BOM), наряды цеха, закупка сырья и заводское ОТК.
🔧 Сервисный центр и выезды
Ремонт и поддержка: прием рекламаций, база серийных номеров, учет гарантии, выезды инженеров и акты выполненных работ.
Как управлять отраслевыми базисами:
- Переключение в 1 клик: Кликните по любой плашке отрасли на панели сверху. Верстак моментально загрузит соответствующую структуру сущностей и настроек.
- Свободное редактирование: Кликните по названию или описанию любого кубика, чтобы отредактировать его под свои рабочие термины (например, заменить «Сделка» на «Договор подряда» или «Наряд» на «Лист раскроя»).
- Включение и отключение: Чекбокс слева от каждого пункта временно выключает его из итогового документа, не удаляя насовсем. Кнопка крестика ✕ справа удаляет лишний элемент.
- Сброс к шаблону: Если вы экспериментировали с настройками и хотите вернуть исходный шаблон, нажмите кнопку 🔄 Сброс к базовым в панели инструментов.
📋 2. Паспорт проекта и масштабы команды (Шаг 1)
Первый шаг формирует титульные реквизиты технического задания:
- Название компании / проекта: Официальное наименование вашей организации или внедряемого продукта (будет выведено в шапке титульного листа ТЗ).
- Автор ТЗ и ответственный: ФИО и должность специалиста, ведущего проект (например, «Михаил Смирнов, операционный директор»).
- Контактные данные: Telegram, рабочий телефон или e-mail ответственного лица. Поле выводится на титульный лист готового ТЗ.
- Масштаб команды пользователей: Выбор количества рабочих мест: 1–5, 5–15, 15–30 или более 30 сотрудников. От этого параметра зависят требования к мощности сервера и разграничению прав доступа.
🗄️ 3. Архитектура сущностей и матрица связей (Шаг 2)
Это главный инженерный фундамент всей системы. Сущность (Entity) - это отдельная таблица в базе данных со своими полями и правилами (например, «Контрагенты», «Сделки», «Склады», «Наряды цеха»).
Главная ошибка новичков: Сваливать всю информацию в одну сущность (например, пытаться прямо внутри карточки сделки вести и складской остаток, и чертежи цеха, и акты рекламаций). В правильной CRM каждая сущность отвечает строго за свой объект, а связываются они между собой через системные реляционные связи.
Типы архитектурных связей:
- Один ко многим (1:M, belongsTo / hasMany): У одного Контрагента может быть множество Сделок. У одной Сделки может быть множество счетов и актов. Каждая дочерняя запись четко знает своего родителя.
- Многие ко многим (M:M): Несколько сотрудников могут работать над несколькими проектами одновременно.
- Добавление своих сущностей: Нажмите кнопку + Добавить сущность, введите название, системный код и укажите связи со смежными таблицами.
- Сортировка: Зажмите ручку ⋮⋮ слева от сущности и перетащите её на нужное место в иерархии.
🎯 4. Точки входа лидогенерации и маршрутизация (Шаг 3)
На этом этапе определяется, откуда в CRM поступают потенциальные клиенты и как они распределяются по сотрудникам:
- Формы на сайте и лендингах: Автоматический прием через защищенный вебхук с сохранением UTM-меток маркетинга.
- Telegram-боты и личные сообщения: Авторизация диалогов и прикрепление никнейма Telegram к карточке лида.
- Корпоративная почта: Автоматический парсинг входящих заявок и вложенных файлов (сметы, реквизиты).
- Умное распределение (Round-Robin): Поочередная передача новых входящих обращений дежурным менеджерам для исключения споров и простоев.
- Защита от дублей: Автоматическая склейка повторных обращений по номеру телефона и ИНН организации.
📊 5. Воронка продаж и нормативы SLA (Шаг 4)
Этапы воронки определяют жизненный цикл сделки от первого знакомства до успешной оплаты:
- Норматив времени (SLA): Задает жесткий лимит нахождения сделки на стадии (например, «Квалификация — до 2 часов», «Подготовка КП — до 24 часов»). При превышении лимита CRM автоматически уведомит руководителя.
- Условия перехода (Критерии завершения): Чек-лист обязательных требований, без выполнения которых система физически не разрешит перевести карточку на следующий шаг (например, «Прикреплен скан договора с подписью» или «Внесена предоплата 50%»).
🔐 6. Ролевая модель и контур безопасности (Шаг 5)
Разграничение прав доступа гарантирует сохранность коммерческой тайны и защищает компанию от кражи клиентской базы:
Защита от увода клиентской базы: В стандарте нашего ТЗ для линейных менеджеров жестко заблокирован экспорт данных в Excel/CSV. Скопировать всю базу контактов одним кликом невозможно.
- Иерархия ролей: Администратор (полный доступ), РОП (доступ ко всем сделкам отдела), Линейный менеджер (только свои назначенные записи).
- Field-Level Security (Безопасность на уровне полей): Скрытие конфиденциальных полей (себестоимость, маржа, личные контакты учредителей) от стажеров и менеджеров.
- Запрет удаления: Менеджеры не имеют права безвозвратно удалять карточки клиентов - только перемещать в архив с обязательным указанием причины отказа.
⚙️ 7. Серверный контур и оркестрация (Шаг 6)
Технические требования к серверному развертыванию платформы:
- On-Premise (Собственный сервер): Размещение CRM на независимом VPS под управлением AlmaLinux 9. Никаких зарубежных облаков и абонентских плат за количество сотрудников.
- Docker Compose: Изоляция каждого сервиса в своем контейнере (EspoCRM, СУБД MariaDB, фоновый демон Cron). Это исключает конфликты библиотек и гарантирует стабильность.
- Автоматические резервные копии: Еженощный дамп базы данных и архивация пользовательских файлов на удаленное независимое хранилище.
- Внешняя интеграционная шина (n8n): Тяжелые внешние интеграции (Telegram-боты, DaData, 1С, службы доставки, банковские выписки) подключаются через независимый сервер автоматизаций n8n. Это сохраняет ядро CRM легким и быстрым.
📄 8. Просмотр, редактирование и печать ТЗ в PDF
Нажмите кнопку 📄 Посмотреть ТЗ (Печать) на нижней панели генератора. Откроется окно предпросмотра сгенерированного документа:
- Живая правка заголовков: Перед отправкой на печать кликните по заголовку или подзаголовку на листе - вы можете дописать номер редакции или специфические требования.
- Печать на принтер: Кнопка 🖨️ Распечатать открывает системный диалог печати. Вы можете отправить ТЗ на бумагу или выбрать «Сохранить как PDF».
- Прямой экспорт в PDF: Синяя кнопка 📥 Скачать PDF формирует официальный многостраничный PDF-файл.
- Копирование текста: Кнопка 📋 Скопировать текст помещает весь текст ТЗ в буфер обмена для быстрой вставки в Word, Notion или Telegram.
💾 9. Сохранение проекта, экспорт и импорт JSON
Все ваши наработки надежно защищены от потери:
- Автосохранение в браузере: Любые правки немедленно сохраняются в LocalStorage вашего браузера. Вы можете закрыть вкладку и продолжить работу в любой момент.
- Экспорт проекта в файл: Кнопка 💾 Сохранить скачивает файл .json на ваш компьютер. Это полная резервная копия конфигурации всех отраслей.
- Импорт из файла: Кнопка 📂 Открыть загружает сохраненный проект на любом компьютере или в другом браузере.
- Новый проект с нуля: Кнопка 📄 Новый очищает текущий шаблон, позволяя собрать индивидуальную архитектуру с чистого листа.
💡 10. Стандарты чистого внедрения: как не сломать EspoCRM
- Никогда не трогайте ядро: Все кастомные сущности, связи и формулы должны создаваться строго через папку
custom/Espo/Custom/. Это гарантирует, что система сможет обновляться без поломок.
- Всегда прописывайте связи зеркально: Если сущность A имеет связь
hasMany с сущностью B, то сущность B обязана иметь ответную связь belongsTo. Односторонние связи ведут к фатальным ошибкам при пересборке метаданных.
- Проверяйте воронку до запуска: Прежде чем отдавать систему менеджерам, протестируйте сценарии в нашей Интерактивной карте процессов и регламентов.