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

py_service/docs/Инструкция по админ-панели.md

@@ -0,0 +1,85 @@
+# Инструкция по админ-панели AegisOne
+
+## Вход в систему
+
+1. Перейдите на `https://aegisone.ru/service/`
+2. Введите логин и пароль, выданные владельцем
+3. При 3 неверных попытках — блокировка на 3 минуты
+
+## Дашборд
+
+Главная страница после входа. Карточки показывают ключевые метрики:
+- **Активные объекты** — количество обслуживаемых объектов
+- **Активные задачи** — открытые и в работе
+- **Открытые инциденты** — текущие инциденты
+- **SLA контракты** — активные договоры
+- **SLA Compliance** — процент соблюдения SLA
+- **SHS** — общий индекс здоровья системы
+
+Нажмите на любую карточку для перехода в соответствующий раздел.
+
+## Управление сотрудниками (только владелец)
+
+- Создание учётных записей с ролями: Владелец / Инженер / Техник
+- Блокировка/разблокировка сотрудников
+- Сброс пароля
+
+## Объекты
+
+- Добавление объектов с параметрами: тип, площадь, регион
+- Автоматическое создание из опросника
+- Просмотр Risk Score, Object Index, SLA цены
+
+## Назначения
+
+Привязка сотрудников к объектам. Роль сотрудника определяется автоматически из его профиля.
+
+## SLA контракты
+
+- Создание контрактов с привязкой к объекту
+- Номер договора (для синхронизации с 1С)
+- Уровень обслуживания: Start / Business / Enterprise
+- Гибкое время реакции (в часах)
+
+## Опросник объекта
+
+Пошаговое обследование объекта:
+1. **Коммерческий** — название, тип, адрес, контакты
+2. **Технический** — видеонаблюдение, СКУД, пожарная сигнализация, инфраструктура
+3. **Эксплуатация** — текущее обслуживание, регламенты, проблемы
+4. **Риски** — критические риски объекта
+5. **Расчёт SLA** — уровень обслуживания, дополнительные требования
+
+После завершения автоматически рассчитываются: Risk Score, Complexity Index, Object Index, SLA цена.
+
+## Блог
+
+- Создание/редактирование статей
+- **Slug** — адрес статьи, генерируется автоматически из заголовка (можно изменить вручную)
+- **Категории**: Аудит, SLA, Инциденты, Технадзор, Документация, Риск-инжиниринг, Кейсы
+- **Содержание** — HTML-формат. Используйте тулбар над редактором для вставки форматирования
+- Статусы: Черновик → Опубликовать → Архив
+
+## Документация
+
+- Файлы `.md` в папке `service/docs/` автоматически обнаруживаются
+- Владелец управляет доступом инженеров к каждому документу
+- Инженер видит только разрешённые документы
+
+## Примеры из практики (карусель на главной)
+
+- Добавление кейсов с заголовком, описанием и эффектом
+- Поле «Порядок» определяет порядок в карусели
+- Флажок «Активен» — показывает/скрывает кейс на главной
+
+## CEO дашборд (только владелец)
+
+Обзор бизнес-метрик: MRR, удержание клиентов, конверсия, производительность.
+
+## Коэффициенты формул
+
+Все расчётные коэффициенты можно редактировать. Изменения применяются ко всем новым расчётам.
+
+## Паспорта объектов
+
+Автоматически генерируются при завершении опросника. Содержат полный расчёт рисков и рекомендаций.