Implement billing functionality and enhance role management

- Introduced billing capabilities, allowing users to request payments for subscription periods (3/6/12 months) with admin approval via Telegram.
- Updated role management to include a `BillingEnabled` property, preventing billing for admin roles.
- Enhanced the `CreateRoleCommand` and `UpdateRoleCommand` to accept billing parameters, ensuring proper handling during role creation and updates.
- Added new endpoints for billing management and integrated billing checks into VPN config creation to enforce payment requirements.
- Updated related services, models, and tests to support the new billing features, ensuring comprehensive coverage and functionality.
- Enhanced documentation to reflect the new billing processes and role management changes.

backend/src/PnvPanel.Application/Common/Interfaces/IIdentityService.cs

@@ -13,7 +13,19 @@ public sealed record CurrentUserProfile(
     bool IsBlocked,
     int MaxConfigs,
     int MaxIpLimit,
-    string SubscriptionToken
+    string SubscriptionToken,
+    bool BillingEnabled,
+    DateTimeOffset? BillingPaidUntil,
+    bool BillingSuspended
+);
+
+/// <summary>Срез биллинг-полей пользователя — для фоновой джобы приостановки (см. BillingService),
+/// не требует полного CurrentUserProfile (роль/квоты там не нужны).</summary>
+public sealed record BillingUserDto(
+    Guid UserId,
+    DateTimeOffset? PaidUntil,
+    bool Suspended,
+    DateTimeOffset? LastWarnedForPaidUntil
 );
 
 public sealed record UserSummaryDto(
@@ -135,4 +147,27 @@ public interface IIdentityService
         Guid exceptUserId,
         CancellationToken cancellationToken
     );
+
+    /// <summary>Пользователи с billing-ролью (role.BillingEnabled), не заблокированные — обход для
+    /// BillingService (приостановка за неуплату / предупреждения).</summary>
+    Task<IReadOnlyList<BillingUserDto>> ListBillingUsersAsync(CancellationToken cancellationToken);
+
+    /// <summary>Гасит конфиги за неуплату на уровне пользователя (BillingSuspended=true) — сами
+    /// конфиги гасит вызывающая сторона (см. BillingService, по образцу BlockUserCommandHandler).</summary>
+    Task<Result> SuspendBillingAsync(Guid userId, CancellationToken cancellationToken);
+
+    /// <summary>Продлевает оплаченный период, снимает приостановку и сбрасывает флаг "предупреждение
+    /// отправлено" (новый срок ещё не близко к истечению). Используется и при подтверждении оплаты,
+    /// и при первичной выдаче грейс-периода.</summary>
+    Task<Result> ExtendBillingPaidUntilAsync(
+        Guid userId,
+        DateTimeOffset paidUntil,
+        CancellationToken cancellationToken
+    );
+
+    Task<Result> MarkBillingWarningSentAsync(
+        Guid userId,
+        DateTimeOffset paidUntil,
+        CancellationToken cancellationToken
+    );
 }