site_aegisone/max_bot/CHANGELOG.md

# Changelog — AegisOne MAX Bot

## 1.8.2 (02.06.2026)
### Новые функции
- **AGENTS.md:** правила проекта для AI-агентов
- **Отзыв согласия:** handle_revoke_consent(), паттерн «отозвать согласие» в handle_message
- **Удаление бот-пользователей:** DELETE /api/bot/users/{user_id} (каскад: user + conversations + messages + logs)
- **consent_revoked_date:** поле в BotUser для фиксации даты отзыва согласия
### Исправления
- **Диалоги:** одна переписка = одна карточка (убрано создание new conv при completed/escalated)
- **Analyze intent:** агрессивное определение ticket по ключевым словам услуг, улучшен промпт
- **Clarify intent:** ограничение 1 раз за диалог (prev_intent == unknown), маркерные слова пропускают уточнение
- **History context:** фильтр по времени (10 мин) вместо лимита 10 сообщений
- **Быстрые правила:** ticket-паттерны и приветствие до NLP
- **Send message:** параметр conversation_id + сохранение исходящих сообщений в BotMessage

## 1.8.1 (01.06.2026)
### Новые функции
- **YandexGPT-only NLP:** удалены Groq/Gemini, YandexGPT единственный провайдер
- **Unknown questions:** BotUnknownQuestion, автогенерация KB-карточки при 3+ уникальных пользователях, UI
- **Callback dedup:** processed_callbacks set в main.py — пропуск дублей callback_id, очистка при 1000
- **Consent flow:** split-based word matching (_matches_any), refuse words до quick_intent, operator handler
- **DELETE conversations:** каскадное удаление (BotMessage + BotProcessingLog + BotConversation)
- **UTC+3:** moscow_now() в greeting.py и inquiry.py
- **Bot tickets:** contact_name, contact_phone, contact_email в BotTicket
- **Payload parsing:** message_created из body.message.body.text, message_callback из body.callback.payload + recipient.user_id
### Исправления
- **Plain text phones:** MAX Platform не рендерит markdown-ссылки — 📞 +7 (xxx) xxx-xx-xx
- **Webhook secret:** _verify_secret() возвращает True если заголовок пуст (optional)
- **Nginx:** добавлен /webhook proxy на HTTP порт 80

## 1.8.0 (01.06.2026)
### Новые функции
- **Consent keyboard:** consent_keyboard(), contact_keyboard(), return_to_consent_keyboard()
- **Escape hatch:** locked states проверяют analyze_intent — «question» → analyze_and_respond
- **Completed state:** completed/escalated → анализируем и создаём новый диалог
- **handle_greeting fix:** убран analyze_and_respond после приветствия, state=awaiting_input
- **Auto-detect sidebar:** parse_sidebar_menu() определяет пункты меню через API
### Исправления
- **handle_message:** refuse слова проверяются ДО analyze_intent в состояниях consent
- **operator_words:** «оператор» → contacts вместо analyze_intent
- **handle_manual_contact:** refuse words → consent_refused
- **clarify_intent:** temperature 0.1, пост-обработка удаление приветствий, anti-AI-signs

## 1.7.1 (29.05.2026)
### Новые функции
- **Тестовый прогон:** мок MAX API для test user_id (>=999999000) — сообщения не уходят в MAX
### Исправления
- **P1 (CRITICAL):** _add_column_if_not_exists — async def + await, миграции выполняются
- **P2 (CSS):** bot_consent, bot_tickets, bot_kb, bot_settings — var(--light-bg) → var(--bg-card), хардкод цвета → CSS-переменные
- **P3 (Event loop):** email_sender.send_ticket_escalation — обёрнут в run_in_executor
- **P4 (SQL injection):** _add_column_if_not_exists — валидация _validate_sql_name/type
- **C1 (CRITICAL):** BotConversation импортирован в main.py
- **C2 (VCF N-field):** regex исправлен, захватывает полную строку N:
- **C3 (Email typo):** contact.py — user.email вместо user.phone
- **C4 (None user):** inquiry.py — проверка user is None
- **C5 (Висячий тикет):** inquiry.py — flush + единый commit
- **C6 (Secrets):** docker-compose.yml — переменные через .env
- **H1 (Prompt injection):** yandex_gpt.py — instruction boundary, _sanitize_input
- **H2 (Дубль BotMessage):** contact.py — удалён дублирующий save
- **H3 (VCF phone regex):** расширен захват полного номера
- **H4 (Race condition):** greeting.py — try/except + rollback при IntegrityError
- **H5 (Silent error):** email_sender.py — logger.error добавлен
- **M1 (TOCTOU):** main.py — audit-log только при изменении статуса
- **M2 (Двухсессионный дизайн):** inquiry.py — единая транзакция
- **M3 (Stale state):** greeting.py — conv из текущей сессии
- **M4 (Double-load race):** settings_cache.py — asyncio.Lock
- **M5 (ORG regex):** захват полного ORG без обрезки по ;
- **M7 (bot_test.html):** тема наследуется через CSS-переменные + скрипт инициализации
- **bot_test.html:** исправлен ключ localStorage (theme → aegisone_service_theme), var(--bg-page) → var(--bg-body), добавлена стилизация скроллбара
- **L1 (Dead code):** _extract_name_from_vcf удалена
- **L2 (Импорты):** неиспользуемые Optional, json, config_reader удалены
- **L3 (.gitignore):** .opencode/, .env.example добавлены

## 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