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.

CLAUDE.md

@@ -10,8 +10,9 @@
 [`ThreeXui.Net`](https://github.com/mrleo1nid/ThreeXui.Net) и хранит проекцию домена в PostgreSQL.
 Живые обновления — SignalR. Поставка — **единый Docker-образ** (фронт+бек+бот) + PostgreSQL в compose.
 
-> Собрано и покрыто тестами, единый образ и compose-стек проверены живьём. Осознанно не реализовано:
-> тарифы, лимиты трафика/срока на конфиг, полное самообслуживание в боте — см. [tech-stack.md](docs/tech-stack.md).
+> Собрано и покрыто тестами, единый образ и compose-стек проверены живьём. Есть опциональный биллинг
+> (подписка по сроку, per-роль). Осознанно не реализовано: лимиты трафика на конфиг, полное
+> самообслуживание в боте — см. [tech-stack.md](docs/tech-stack.md).
 
 ## Документация (single source of truth)
 
@@ -92,6 +93,12 @@
   админский путь дополнительно пишет `AuditLog` (`UserDeleted`) и шлёт Telegram-DM.
 - **Аудит**: значимые действия (активация/блок/роль/отзыв/ноды/инбаунды/удаление) — `AuditLog`
   (append-only, источник Web/Telegram/System).
+- **Биллинг** (`AppRole.BillingEnabled`, недоступен для `admin`): пользователь оформляет
+  `PaymentRequest` на 3/6/12 мес (сумма — по `PricingSettings`, заморожена на заявке), админ
+  подтверждает/отклоняет на сайте или в Telegram (`pay:*`). Пока заявка `AwaitingConfirmation` —
+  конфиги не гасятся, даже если срок истёк (не по вине пользователя, что админ не успел). Просрочка
+  без заявки → `VpnConfig.Suspend()` (статус `Expired`, отдельно от `Disable()`/блокировки админом) —
+  см. [domain-model.md](docs/domain-model.md#billing--подписка-по-сроку).
 - **Ротация конфига** (`Rotate()`) — новый UUID/ссылка, квоту не тратит. **Бот read-only** по конфигам.
 - **Подписка**: агрегированная (`AppUser.SubscriptionToken`) + по конфигу. API без версионирования
   (`/api`, без `v1`); подписка отдаёт `Subscription-Userinfo`.
@@ -168,9 +175,9 @@ docker compose up -d        # api + postgres (+ web)
 ## Ключевые решения
 
 См. [tech-stack.md](docs/tech-stack.md#ключевые-решения-по-домену-и-поведению): CQRS — собственный
-диспетчер (не MediatR); одна роль на пользователя; секреты нод — ASP.NET Data Protection; тарифы `Plan`
-не реализованы; i18n — RU+EN (react-i18next); Telegram — long polling, только привязка (не signup);
-история трафика — простая таблица + TTL; логирование — Serilog.
+диспетчер (не MediatR); одна роль на пользователя; секреты нод — ASP.NET Data Protection; биллинг
+опционален per-роль (недоступен для `admin`); i18n — RU+EN (react-i18next); Telegram — long polling,
+только привязка (не signup); история трафика — простая таблица + TTL; логирование — Serilog.
 
 ## Рабочие принципы