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

max_bot/CHANGELOG.md

@@ -1,24 +1,23 @@
-# Changelog
+# Changelog — AegisOne MAX Bot
 
-## v1.6.0 (2026-05-24)
-
-### Bug Fixes
-- **Features**: Исправлен feature_key `auto_notifications` → `notifications` (фича теперь отображается в меню)
-- **Features**: Исправлен feature_key `commercial_offer` → `commercial` (унификация с кодом)
-- **Заявки**: Исправлена критическая ошибка — `db.flush()` вместо `db.commit()` во всех write-эндпоинтах (данные не сохранялись)
-- **Заявки**: Кнопка "Создать" теперь корректно сохраняет заявку в БД
-- **Тест-прогон**: Исправлено — тестовые сообщения бота теперь содержат `role: "bot"`, отображаются в результате
-- **Router proxy**: Добавлен `try/except` во все прокси-эндпоинты (500 → 503 с сообщением)
-- **Mojibake**: Исправлена кириллица на всех страницах бота (добавлен `page_name` в `ctx()`)
-- **Broadcast**: Добавлена колонка `recipient_ids` в таблицу `bot_broadcasts`
-
-### New Features
-- **Рассылки**: Добавлена отдельная страница **Рассылки** в меню Чат-бот Max (роут + шаблон + sidebar)
-- **Категории**: Полностью обновлены категории обращений (7 новых с иконками и описаниями)
-- **Permissions**: Добавлены `bot_*` права для роли `engineer` в `role_menu_permissions`
-- **Deploy**: Улучшен `max_bot_deploy.sh` — теперь использует `docker exec -i` pipe вместо `docker cp`
-- **Deploy**: Главный `deploy.sh` теперь включает развёртывание max_bot
-
-### Infrastructure
-- **Database**: `get_db()` теперь корректно вызывает `session.commit()` при выходе (аналогично py_service)
-- **Permission config**: Добавлены все пропущенные маршруты в `ROUTE_PERMISSIONS`
+## 1.7.0 (29.05.2026)
+### Новые функции
+- **Рефакторинг архитектуры:** плоская структура модулей (models.py, yandex_gpt.py, keyboards.py, email_sender.py, config_reader.py) вместо вложенных пакетов
+- **VCF + User Model (Q2):**
+  - BotUser расширен: patronymic, email, organization, address, vcf_raw, contact_hash, phone_verified, email_verified
+  - VCF-парсер: FN, N, TEL, EMAIL, ORG, ADR — все поля сохраняются
+  - Upsert пользователя при повторном контакте (greeting.py)
+  - total_conversations инкремент, last_interaction обновление
+  - handle_contact_share сохраняет все VCF-поля (handoff.py)
+  - total_tickets инкремент в _finalize_ticket (inquiry.py)
+- **NLP history context:** _get_user_history_context() — последние 10 сообщений + открытые заявки → YandexGPT
+- **Broadcast с превью и таймером (Q1):** модалка подтверждения с таймером 10 секунд
+- **CSS-переменные (Q3):** var(--white)→var(--bg-card), var(--text)→var(--text-primary)
+- **bot_settings (Q4):** showNotification(), max_bot_id редактируемый
+- **Webhook secret (Q5):** проброс X-Max-Bot-Api-Secret через прокси
+- Маскировка sensitive API-ключей в /api/bot/settings
+- dialog_cleared handler — сброс состояния диалога
+- Миграции через _add_column_if_not_exists() — новые колонки BotUser
+- Rate limit в broadcast: asyncio.sleep(0.5) после каждых 10
+- Уточнение сообщения (contact.py) с учётом conv.intent
+- Тесты: test_yandex_gpt.py, test_email_sender.py