📚 Документация

💎 Тарифные планы

🔄 Процесс получения лицензии

⏱️ Trial (автоматически)

1. Клиент находит бота @kcp_licensing_bot в Telegram
2. Отправляет команду /start
3. Открывает KCP → кнопка "🔐 Лицензия"
4. Вкладка "Trial" → кнопка "Запросить Trial"
5. Ключ автоматически приходит в чат с ботом!
6. Активирует ключ в приложении

💎 Standard / Professional (с оплатой)

1. Клиент находит бота @kcp_licensing_bot в Telegram
2. Отправляет команду /start
3. Открывает KCP → кнопка "🔐 Лицензия"
4. Вкладка "Тарифы" → выбирает Standard или Professional
5. Нажимает "Запросить лицензию"
6. ВАМ приходит уведомление СО ЗВУКОМ с Telegram клиента
7. Связываетесь с клиентом для уточнения способа оплаты
8. После получения оплаты нажимаете кнопку "✅ Оплачено - Выдать ключ"
9. Бот автоматически отправляет ключ клиенту в чат
10. Клиент активирует ключ в приложении

🔧 Технические детали

Hardware ID (HWID)

Уникальный идентификатор компьютера, основанный на:

• CPU (модель, количество ядер)
• MAC адрес сетевой карты
• Hostname компьютера
• UUID материнской платы

SHA-256 хэш всех компонентов → 32 символа (16 байт hex)

Валидация HWID

• При открытии окна лицензирования → HWID отправляется на сервер
• Регистрируется в таблице hwid_telegram_mapping
• Окно валидности: 10 минут
• При запросе лицензии → проверка что HWID был зарегистрирован
• Защита от подделки HWID

Связь HWID ↔ Telegram

• Клиент пишет /start → сохраняется username + chat_id
• Клиент открывает окно → регистрируется HWID
• При запросе → сервер связывает HWID с Telegram (по времени)
• Бот знает кому отправлять ключ!

Генерация ключей

Trial: SHA-256(HWID + plan + dates + secret)

Платные: AES-256-CBC шифрование payload

Формат: KCP-XXXX-XXXX-XXXX-XXXX-XXXX

Проверка лицензии

• Локально: при каждом запуске приложения
• Онлайн: раз в 30 дней
• Grace period: 90 дней работы без интернета
• HWID: проверка при каждой активации

💾 Базы данных

telegram_users

Регистрация пользователей Telegram (команда /start)

• telegram_username - username с @
• chat_id - для отправки сообщений
• first_seen - первая регистрация
• last_seen - последняя активность

hwid_telegram_mapping

Связь Hardware ID с Telegram username

• hwid - Hardware ID клиента
• telegram_username - @username
• registered_at - время регистрации
• last_seen - последняя активность
• platform - ОС клиента
• version - версия KCP

📡 API Endpoints

POST /api/license/register-hwid

Регистрация HWID (вызывается при открытии окна лицензирования)

Body: { hwid, platform, version }

POST /api/license/request

Запрос лицензии от клиента

Body: { hwid, plan, email }

Валидация: HWID должен быть зарегистрирован (последние 10 мин)

POST /api/license/activate

Активация лицензионного ключа

Body: { key, hwid, version }

POST /api/license/validate

Онлайн валидация лицензии

Body: { key, hwid }

🤖 Команды Telegram Bot

/start

Регистрация пользователя в системе

• Сохраняет username + chat_id
• Отправляет приветствие с инструкцией
• Необходимо для получения ключей

/status

Проверка статуса запросов на лицензию

• Показывает последние 5 запросов
• Статус каждого запроса

Callback кнопки (для админа)

• ✅ Оплачено - Выдать ключ - генерация и отправка ключа
• ❌ Отклонить - отклонение запроса

⚙️ Как это работает

Шаг 1: Регистрация (клиент)

1. Клиент пишет боту /start
2. Бот сохраняет в БД: username → chat_id

Шаг 2: Открытие окна (клиент)

1. Клиент нажимает "🔐 Лицензия" в приложении
2. Приложение автоматически отправляет HWID на сервер
3. Сервер сохраняет HWID с timestamp

Шаг 3: Запрос лицензии (клиент)

1. Клиент выбирает план и нажимает "Запросить"
2. Приложение отправляет: HWID + plan + email
3. Сервер проверяет HWID (зарегистрирован ли?)
4. Сервер ищет Telegram по времени (последние 10 мин)
5. Связывает HWID ↔ Telegram

Шаг 4: Обработка (бот)

Для Trial:

• Генерирует ключ автоматически
• Отправляет клиенту в чат
• Уведомляет админа БЕЗ ЗВУКА 🔕

Для Standard/Professional:

• Отправляет админу СО ЗВУКОМ 🔔
• Показывает Telegram клиента
• Админ связывается → оплата
• Админ жмет кнопку → ключ клиенту

⚙️ Настройка (через веб-интерфейс)

Перейдите на страницу 🤖 Bot Admin

1. Создайте бота через @BotFather: /newbot
2. Получите ваш ID через @userinfobot: /start
3. Заполните форму на странице Bot Admin
4. Нажмите "🧪 Проверить бота" (валидация)
5. Нажмите "💾 Сохранить настройки"
6. Нажмите "🔄 Перезапустить сервер"
7. ✅ Готово! Бот работает

🔒 Безопасность

Hardware ID

• Уникальный для каждого компьютера
• SHA-256 хэш аппаратных компонентов
• Невозможно подделать без доступа к железу

Валидация

• HWID проверяется на сервере (окно 10 минут)
• Telegram проверяется через /start (окно 10 минут)
• Автоматическая связь HWID ↔ Telegram
• Защита от подмены данных

Ключи

• Trial: SHA-256 хэш с секретным ключом
• Платные: AES-256-CBC шифрование
• Привязка к Hardware ID
• Невозможно использовать на другом ПК (кроме Professional с лимитом)

🔧 Решение проблем

"Telegram не определен"

1. Убедитесь что клиент написал боту /start
2. У клиента должен быть установлен username в Telegram
3. Между /start и запросом должно пройти менее 10 минут

"Invalid HWID"

1. Клиент должен сначала открыть окно лицензирования
2. Между открытием и запросом - менее 10 минут

Бот не отвечает

1. Проверьте настройки на странице Bot Admin
2. Проверьте токен бота (кнопка "🧪 Проверить")
3. Перезапустите сервер (кнопка "🔄")