v1.7.0: refactor max_bot to flat structure, add VCF+UserModel+NLP history context, portal pages and proxy fixes

- Refactored max_bot from nested packages to flat module structure - Q2: Extended BotUser model (patronymic, email, org, address, vcf_raw, contact_hash, phone_verified, email_verified, last_interaction, total_conversations, total_tickets) - Q2: VCF parser (FN, N, TEL, EMAIL, ORG, ADR), upsert on re-contact, NLP history context (_get_user_history_context -> YandexGPT) - Q1: Broadcast preview modal with 10s confirmation timer - Q3: CSS var(--white)->var(--bg-card), var(--text)->var(--text-primary) - Q4: bot_settings showNotification(), editable max_bot_id - Q5: Webhook secret passthrough via X-Max-Bot-Api-Secret - Masking sensitive keys, dialog_cleared handler, migrate via _add_column_if_not_exists() - Rate limit (asyncio.sleep 0.5 per 10), dead code removed, conv.intent context in contact.py - Portal pages: bot_consent, bot_kb (edit), bot_settings, bot_test, bot_tickets, portal_settings - Tests: 21/21 passing, added test_yandex_gpt.py, test_email_sender.py - Deploy: deploy_full.sh, schema.sql, seed_knowledge_base.sql
2026-05-29 02:30:30 +03:00
parent 493e0b37a1
commit 72b6879f4b
234 changed files with 26768 additions and 6240 deletions
@@ -0,0 +1,340 @@
+Ниже — тебе не “скрипты продаж”, а инженерная система входа в аудит, адаптированная под Краснодарский край и B2B-реальность (УК, гостиницы, склады, собственники).
+
+Главная идея:
+
+> Ты не продаёшь аудит. Ты предлагаешь проверку рисков объекта.
+
+
+
+
+---
+
+1. ПСИХОЛОГИЯ ПРОДАЖ АУДИТА (ВАЖНО)
+
+Что продаёт аудит на самом деле:
+
+снижение рисков проверок (МЧС, внутренние, страховые)
+
+уверенность, что система реально работает
+
+снятие ответственности с менеджера/собственника
+
+“независимое мнение инженера”
+
+
+
+---
+
+Что НЕ работает:
+
+“проверим камеры”
+
+“сделаем диагностику”
+
+“обслуживание дешевле”
+
+
+
+---
+
+Рабочая позиция:
+
+> “Мы делаем техническую проверку систем безопасности объекта с выдачей инженерного заключения по рискам эксплуатации.”
+
+
+
+
+---
+
+2. ВХОД В ПРОДАЖУ (3 КАНАЛА)
+
+
+---
+
+2.1 Холодный вход (самый важный в регионе)
+
+Кому пишем:
+
+гостиницы
+
+апарт-отели
+
+склады
+
+УК
+
+коммерческая недвижимость
+
+
+
+---
+
+2.2 Тёплый вход (через знакомства)
+
+электрики
+
+IT
+
+строители
+
+подрядчики
+
+проектировщики
+
+
+
+---
+
+2.3 Вход через контент
+
+Telegram / статьи / кейсы
+
+
+---
+
+3. СТРУКТУРА ПРОДАЖИ АУДИТА
+
+
+---
+
+1. Контакт
+2. Короткое позиционирование
+3. Выявление боли
+4. Предложение аудита
+5. Подтверждение логики
+6. Назначение выезда
+
+
+---
+
+4. ХОЛОДНЫЙ СКРИПТ (ТЕКСТ + WA / TG)
+
+Вариант 1 — максимально инженерный (основной)
+
+Добрый день.
+
+Мы занимаемся техническим сопровождением систем безопасности коммерческих объектов в Краснодарском крае.
+
+Перед тем как брать объекты на обслуживание, обычно делаем технический аудит:
+— проверка видеонаблюдения (архив, запись, питание)
+— проверка СКУД
+— проверка пожарной сигнализации
+— оценка рисков эксплуатации
+
+По практике, на большинстве объектов выявляются скрытые проблемы, которые не видны в ежедневной работе.
+
+Если у вас есть задача понять текущее состояние систем — можем провести аудит и дать инженерное заключение по рискам.
+
+Подскажите, у вас сейчас системы на обслуживании или “как есть работают”?
+
+
+---
+
+Почему это работает:
+
+нет продажи
+
+есть диагностика
+
+есть статус эксперта
+
+есть вопрос (диалог)
+
+
+
+---
+
+5. ВТОРОЙ СООБЩЕНИЕ (если отвечают “работает/есть подрядчик”)
+
+Понял.
+
+В таких случаях чаще всего проблема не в “работает/не работает”, а в том, что:
+— архив не проверяется регулярно
+— резервирование не тестируется
+— часть оборудования работает нестабильно
+— нет объективного контроля состояния
+
+А это всплывает обычно в момент инцидента или проверки.
+
+Мы как раз делаем аудит, который показывает такие скрытые вещи до проблем.
+
+Если интересно — можем сделать экспресс-проверку объекта с коротким отчётом по рискам.
+
+
+---
+
+6. КОНВЕРСИЯ В АУДИТ (КЛЮЧЕВОЙ МОМЕНТ)
+
+Можем сделать так:
+
+— выезд инженера
+— проверка всех систем
+— фиксация состояния
+— короткий инженерный отчёт
+— список рисков и рекомендаций
+
+Обычно это занимает 1–2 дня в зависимости от объекта.
+
+По стоимости — от 15 до 50 тыс, зависит от объёма систем.
+
+Если удобно — могу уточнить объект и сказать точнее по формату.
+
+
+---
+
+7. СКРИПТ ДЛЯ ГОЛОСА (ЕСЛИ ЗВОНЯТ)
+
+структура:
+
+1. Позиционирование (10–15 сек)
+
+Мы занимаемся техническим сопровождением систем безопасности коммерческих объектов.
+Перед обслуживанием всегда делаем аудит состояния систем.
+
+
+---
+
+2. Боль
+
+На большинстве объектов, которые мы смотрим, есть скрытые проблемы — архив, питание, доступ, пожарка.
+Обычно это не видно в ежедневной работе.
+
+
+---
+
+3. Переход
+
+Поэтому предлагаем сначала сделать техническую проверку объекта и дать инженерное заключение.
+
+
+---
+
+4. Закрытие
+
+Если вам актуально — можем согласовать выезд инженера и формат проверки.
+
+
+---
+
+8. ОБРАБОТКА ВОЗРАЖЕНИЙ
+
+
+---
+
+❌ “У нас уже есть подрядчик”
+
+Понял.
+
+Аудит как раз часто показывает, что объект обслуживается формально, но без проверки ключевых параметров:
+архив, резервирование, ошибки, питание.
+
+Мы не конкурируем с подрядчиком — мы даём независимую оценку состояния систем.
+
+
+---
+
+❌ “Дорого”
+
+Аудит не про “сделать дешевле”.
+
+Это проверка рисков, которые могут стоить дороже:
+— потеря архива
+— отказ системы
+— проблемы при проверках
+
+Поэтому стоимость зависит от масштаба объекта, но обычно это разовая диагностика, а не постоянные расходы.
+
+
+---
+
+❌ “Нам не нужно”
+
+Понял.
+
+На практике аудит нужен не всегда “сейчас”, а когда появляются сомнения в стабильности систем или перед проверками.
+
+Если актуализируется — можем подключиться.
+
+
+---
+
+9. СИСТЕМА ДОГРЕВА (ЕСЛИ НЕ КУПИЛИ СРАЗУ)
+
+Через 3–5 дней:
+
+Добрый день.
+
+Подскажите, актуально ли сейчас техническое обследование систем безопасности?
+
+По опыту, на объектах часто всплывают вопросы по архиву и резервированию, которые лучше проверить заранее, чем в момент инцидента.
+
+
+---
+
+10. МИКРО-CRM ЛОГИКА (ВАЖНО)
+
+Каждый контакт делишь на:
+
+не ответил
+
+думает
+
+есть подрядчик
+
+отказ
+
+сделал аудит
+
+ушёл в SLA
+
+
+
+---
+
+11. КЛЮЧЕВОЙ МЕХАНИЗМ ПРОДАЖ
+
+Твоя система должна работать так:
+
+контакт → инженерная диагностика → выявление рисков → логичный переход в SLA
+
+
+---
+
+12. ПОЧЕМУ ЭТО РАБОТАЕТ ИМЕННО В КРАСНОДАРСКОМ КРАЕ
+
+Рынок региона:
+
+много частных объектов
+
+слабая эксплуатация систем
+
+подрядчики “формальные”
+
+мало инженерных компаний уровня SLA
+
+
+👉 значит: ты не конкурируешь по цене — ты создаёшь новый тип услуги
+
+
+---
+
+13. ЕСЛИ ДАЛЬШЕ УСИЛИВАТЬ СИСТЕМУ
+
+Следующий уровень, который я могу тебе собрать:
+
+скрипт “закрытия в SLA после аудита”
+
+таблица квалификации клиента (кого брать/кого нет)
+
+CRM-воронка под SLA (по стадиям)
+
+шаблон отчёта аудита (который продаёт сам себя)
+
+шаблон договора SLA (который не торгуется)
+
+
+И это уже будет не продажи.
+
+Это будет:
+
+инженерная коммерческая система повторяемого дохода.