Перейти к содержимому

Работа без Telegram

Core можно запустить как браузерный магазин с регистрацией по email. Telegram остаётся дополнительным каналом входа и уведомлений. Числовой user_id — внутренний ключ базы, telegram_id — отдельная подтверждённая привязка. Публичный minishop_id имеет вид ms_ и 32 шестнадцатеричных символа UUID; для новых основных записей Remnawave он используется как username.

В .env задайте как минимум:

TELEGRAM_ENABLED=False
BOT_TOKEN=
ADMIN_IDS=
WEBAPP_ENABLED=True
EMAIL_LOGIN_ENABLED=True
EMAIL_AUTH_SECRET=<постоянный случайный секрет>
WEBAPP_SESSION_SECRET=<другой постоянный случайный секрет>
PUBLIC_APP_URL=https://shop.example.com/
WEBHOOK_BASE_URL=https://api.example.com
POSTGRES_USER=<пользователь>
POSTGRES_PASSWORD=<пароль>
POSTGRES_DB=<база>
SMTP_HOST=<smtp-сервер>
SMTP_PORT=587
SMTP_FROM_EMAIL=shop@example.com

Заполните доступы к своему Remnawave и платёжным провайдерам отдельно. EMAIL_AUTH_SECRET и WEBAPP_SESSION_SECRET должны быть устойчивыми между перезапусками и одинаковыми на репликах. Генерируйте каждый независимо, например openssl rand -hex 32, и храните вне Git. PUBLIC_APP_URL — адрес браузерного кабинета и ссылка в письмах; WEBHOOK_BASE_URL — адрес входящих вебхуков API. SMTP может работать и при EMAIL_LOGIN_ENABLED=False, если письма нужны для уведомлений.

После запуска backend, worker и frontend зарегистрируйте аккаунт в браузерном кабинете. Его ID вида ms_… виден в профиле. Первый владелец назначается только из доверенной оболочки сервера:

docker compose exec backend python backend/scripts/bootstrap_owner.py --minishop-id ms_<id>

Для подтверждённого email вместо ID можно передать --email owner@example.com. Команда отказывает, если владелец существует. Первому случайному зарегистрированному пользователю права не выдаются. Владелец управляет ролями owner и admin в разделе «Настройки → Общие → Администраторы» админки. Последнюю роль владельца отозвать нельзя; серверная команда остаётся способом восстановления доступа при первоначальной настройке.

  1. Сохраните резервную копию PostgreSQL и текущей конфигурации. Зафиксируйте ожидающие оплаты, recurring-подписки и ссылки на пользователей в панели.
  2. Разверните обновлённый backend и worker и примените обычные миграции. Миграции 0090, 0091 и 0092 добавляют UUID, minishop_id, роли, фактическое имя пользователя и отпечаток панели, а также последовательность для новых внутренних ключей. Они не перенумеровывают старые аккаунты и не переписывают их платежи.
  3. Пока панель отвечает на сохранённые native ID, запустите python backend/scripts/capture_panel_usernames.py, затем python backend/scripts/capture_panel_usernames.py --apply из доверенной оболочки. Команда считывает фактические username только по ссылкам с подтверждённой Telegram identity, проверенным email или точным сохранённым username и не меняет панель; ненайденные связи остаются в отчёте для ручной сверки. Запускайте её против той же панели, с которой были созданы связи: совпавший числовой native ID другой панели не доказывает принадлежность аккаунта. Сделайте это до обновления панели 2.8 → 3.x: после смены поколения старый UUID может стать нечитаемым через API. Проверьте уникальность account_id и minishop_id и сохранность panel_user_uuid. Миграция БД не угадывает panel_username по email или Telegram ID. Старые ADMIN_IDS импортируются в роли только через явно записанный telegram_id; неразрешённые ID видны в журнале миграции и требуют ручного решения.
  4. Подтвердите email владельца и назначьте роль командой выше, если она ещё не импортирована. Только после проверки админского входа отключайте Telegram через TELEGRAM_ENABLED=False.
  5. Сверьте суммы и статусы платежей, балансы, подарки, recurring-состояния, подписки и связи с панелью с резервной копией. Повторные вебхуки должны оставаться идемпотентными.

Новые username панели используют minishop_id. Исторические tg_* и em_* остаются фактическими именами до отдельного подтверждённого переименования в версии Remnawave, где оно поддерживается. Код ищет старую запись по сохранённому panel_username и native ID; он не объявляет переименование завершённым. Если у аккаунта уже есть ссылка на запись панели, но её невозможно подтвердить, Core сохраняет эту ссылку для ручной сверки и не создаёт новую запись автоматически. Обновление Minishop само по себе не меняет username, подписочную ссылку или ключи подключения в панели.

Telegram identity можно свободно привязать к существующему аккаунту без изменения user_id, account_id, minishop_id, подписки или роли. Если она уже принадлежит другому аккаунту (в том числе созданному командой /start), обычная привязка предлагает явное объединение. Тот же сценарий работает для существующих Google, Yandex ID, Discord и email-аккаунтов и не содержит отдельных правил для каждой пары провайдеров.

После свежей авторизации второго аккаунта backend сохраняет подписанное доказательство владения на 10 минут. GET /api/account/merge/status показывает способы повторного входа в текущий, сохраняемый аккаунт. OAuth с purpose=merge подтверждает именно его уже привязанную identity; passkey использует /api/account/merge/passkey/options и /api/account/merge/passkey/verify. При доступном email-входе можно вместо этого запросить код через POST /api/account/merge/request. Включённый SMTP и подтверждённый email не обязательны, если аккаунт подтверждается провайдером или passkey.

POST /api/account/merge/confirm завершает объединение после явного согласия пользователя: передаётся email_code либо пустое тело после повторного входа. POST /api/account/merge/cancel отменяет сохранённое подтверждение. Доказательства привязаны к участникам и конкретной попытке; сервер повторно проверяет владельца identity под блокировкой обоих аккаунтов. Сохраняется текущий аккаунт, его Minishop ID, права и основные настройки; способы входа и связанные данные второго переносятся штатным механизмом. Разные identity одного провайдера, несовместимые права и другие конфликты отклоняются без частичного переноса.

Аккаунт с историей административных ролей требует отдельного ручного разбора. Удалённый числовой ID записывается как исторический alias для старых обязательств, но не даёт доступа старой сессии. Если сверка двух записей панели не завершилась, ответ помечает panel_reconciliation_pending; оператор проверяет связи и доступ перед закрытием инцидента. Прежние /api/account/telegram/merge/request и /confirm остаются совместимыми со сценарием email-кода и свежих подписанных Telegram-данных.

Отдельно синхронизация автоматически объединяет записи панели с одинаковым Telegram ID, когда основная запись уже привязана к аккаунту Minishop. Например, при добавлении Telegram ID к единственной ранее созданной вручную записи сохраняются именно её UUID, username и нативная ссылка подключения. Подписка Minishop сохраняет свой ID, тариф, оплаченные лимиты, историю и согласие на продление; активные сроки объединяются, а существующая публичная ссылка Minishop перепривязывается к сохраняемой записи без замены токена. Созданный магазином дубль удаляется только после успешного обновления сохраняемой записи. Повтор после сбоя не начисляет дни второй раз и учитывает последующие покупки, смену лимитов или отмену подписки. Несколько внешних записей или неизвестное происхождение требуют ручного разбора. Если дубль связан с другим локальным аккаунтом Minishop, используется описанная выше процедура подтверждения обеих учётных записей.

После создания аккаунтов, чей внутренний ID отличается от Telegram ID, старый образ приложения небезопасен: он снова считает числовой ключ Telegram-адресом. Используйте совместимый релиз, понимающий новые идентификаторы и роли, либо восстанавливайте базу и внешние операции на согласованную контрольную точку. Возврат одного образа не откатывает платежи или состояние Remnawave. Перед восстановлением остановите обработку новых вебхуков и сохраните их очередь для повторного воспроизведения.

Кампании, ссылки, предложения и проверка источника покупки описаны в разделе рекламы.