Refactor client update handling to support nullable parameters for name and expiration
- Updated the `UpdateClientAsync` method in `IXuiPanelGateway` to accept nullable parameters for `name` and `expiresAt`, allowing for more flexible client management without unintended modifications. - Adjusted the `BlockUserCommandHandler`, `UnblockUserCommandHandler`, and other related command handlers to utilize the new nullable parameters, ensuring that client names remain unchanged during block/unblock operations and that expiration dates are managed correctly. - Enhanced the billing and configuration handling to reflect the new logic for managing client states based on expiration rather than enabling/disabling, improving reliability in client status management. - Updated tests to cover the new behavior and ensure proper functionality across the application.
This commit is contained in:
+26
-2
@@ -492,7 +492,7 @@ Singleton (как `PricingSettings`) — реквизиты для оплаты
|
||||
висит на подтверждении админом, а срок истёк» из требований: конфиги не гасятся, пока админ не
|
||||
решит (не по вине пользователя, что админ не успел проверить оплату);
|
||||
- `BillingPaidUntil` в прошлом (или `null`) и ещё не `BillingSuspended` → приостановить все `Active`
|
||||
конфиги (`Suspend()` → `Expired`, гейтвей `UpdateClientAsync(enable:false)`, идемпотентно как в
|
||||
конфиги (`Suspend()` → `Expired`, гейтвей `UpdateClientAsync(expiresAt: вчера)`, идемпотентно как в
|
||||
`BlockUserCommandHandler`), `AppUser.BillingSuspended = true`, Telegram-уведомление пользователю,
|
||||
`AuditLog` (`BillingSuspended`, источник `System`). На последующих тиках (уже suspended) — только
|
||||
идемпотентная досуспензия «зависших» `Active`-конфигов (самовосстановление после недоступности
|
||||
@@ -500,9 +500,33 @@ Singleton (как `PricingSettings`) — реквизиты для оплаты
|
||||
- до истечения ≤ 3 дней и предупреждение для этого `PaidUntil` ещё не отправлено
|
||||
(`BillingLastWarnedForPaidUntil != PaidUntil`) → Telegram-предупреждение, отметка отправки.
|
||||
|
||||
#### Приостановка/возврат за неуплату — через expiresAt, не enable
|
||||
|
||||
Приостановка за неуплату (`BillingService`) и возврат (`BillingConfigResumer`) управляют панельным
|
||||
клиентом через `IXuiPanelGateway.UpdateClientAsync(..., expiresAt: ..., enable: null, ...)`, а не через
|
||||
`enable: false/true` — по факту эксплуатации переключение `enable` ненадёжно останавливает уже
|
||||
установленные соединения на стороне Xray/панели, а просроченный `expiryTime` — надёжно, и не зависит
|
||||
от `enable`. Конкретно:
|
||||
- **Приостановка**: `expiresAt = UtcNow.AddDays(-1)` — гарантированно просроченная дата, `enable` не
|
||||
трогаем (`null`, «оставить как есть» — см. ThreeXui.Net `UpdateClientRequest`).
|
||||
- **Возврат**: `expiresAt = newPaidUntil` (реальный новый срок оплаты, не «снять ограничение» на
|
||||
бесконечность) — так панель/Xray сама несёт актуальный срок: если `BillingService` вдруг пропустит
|
||||
тик, панель всё равно перестанет пускать по истечении этой даты независимо от приложения.
|
||||
- **Создание** (`CreateVpnConfigCommandHandler`) уже пушит `expiresAt = profile.BillingPaidUntil` при
|
||||
`BillingEnabled` через `AddClientAsync` — свежий конфиг сразу несёт правильный срок, не «без
|
||||
ограничения» до первого цикла `BillingService`.
|
||||
- **Ротация** (`RotateVpnConfigCommandHandler`) переносит текущий `config.ExpiresAt` на нового клиента
|
||||
— ротация не должна ни продлевать, ни сбрасывать оплаченный период.
|
||||
- Блокировка/разблокировка админом (`Disable()`/`Enable()`) — отдельная ось, управляет только
|
||||
`enable`, `expiresAt: null` (не трогает срок оплаты). Переименование (`EditVpnConfigCommandHandler`)
|
||||
— `enable`/`expiresAt: null` (раньше по ошибке форсировало `enable:true`, тем самым молча снимая
|
||||
приостановку/блокировку простым переименованием конфига — исправлено).
|
||||
|
||||
`CreateVpnConfigCommandHandler` дополнительно не даёт создать **новый** конфиг, если роль billing
|
||||
и оплата просрочена (`ConfigErrors.BillingRequired`) — иначе приостановку можно было бы обойти
|
||||
созданием свежего конфига.
|
||||
созданием свежего конфига. Фронт (`dashboard.tsx`) зеркалит эту же проверку и скрывает кнопку создания
|
||||
конфига заранее, а не только реагирует на 403 от сервера (см. `CreateConfigDialog.tsx` — safety-net на
|
||||
случай гонки состояний).
|
||||
|
||||
`GET/POST /api/billing/*` — пользователь (статус, создание/отмена заявки, «я оплатил», отправка
|
||||
реквизитов в свой Telegram). `GET/PUT/POST /api/admin/billing/*` — админ (настройки, список заявок,
|
||||
|
||||
Reference in New Issue
Block a user