From 64b0a3d944d82fbf54ee1dac73458b036e81963d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <donnalee11681676@gmail.com>
Date: Sun, 24 May 2026 10:46:59 +0300
Subject: [PATCH 01/13] =?UTF-8?q?docs(billing-v2-c):=20=D1=81=D0=BF=D0=B5?=
 =?UTF-8?q?=D0=BA=20C=20+=20=D0=BF=D0=BB=D0=B0=D0=BD=20=D1=80=D0=B5=D0=B0?=
 =?UTF-8?q?=D0=BB=D0=B8=D0=B7=D0=B0=D1=86=D0=B8=D0=B8=20(=D0=BF=D1=80?=
 =?UTF-8?q?=D0=B5fflight=20+=20VTB)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 ...6-05-24-billing-v2-spec-c-preflight-vtb.md | 86 +++++++------------
 ...-billing-v2-spec-c-preflight-vtb-design.md | 48 +++++------
 2 files changed, 53 insertions(+), 81 deletions(-)

diff --git a/docs/superpowers/plans/2026-05-24-billing-v2-spec-c-preflight-vtb.md b/docs/superpowers/plans/2026-05-24-billing-v2-spec-c-preflight-vtb.md
index 933b1515..a34251d7 100644
--- a/docs/superpowers/plans/2026-05-24-billing-v2-spec-c-preflight-vtb.md
+++ b/docs/superpowers/plans/2026-05-24-billing-v2-spec-c-preflight-vtb.md
@@ -1,10 +1,10 @@
-# Биллинг v2 Спек C — Префлайт баланса + VTB-эквайринг — План реализации
+# Биллинг v2 Спек C — Преfflight баланса + VTB-эквайринг — План реализации
 
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. **Pravila §15.1** — git-коммит задачи только Sonnet/Opus субагентами (не Haiku); контроллер верифицирует `git rev-parse HEAD` после каждого субагента.
 
-**Goal:** Защитить портал от заказа лидов у поставщика на клиентов без баланса (префлайт) + дать реальное пополнение баланса через безнал (PDF-счёт + сверка) с архитектурой под СБП/карты VTB.
+**Goal:** Защитить портал от заказа лидов у поставщика на клиентов без баланса (преfflight) + дать реальное пополнение баланса через безнал (PDF-счёт + сверка) с архитектурой под СБП/карты VTB.
 
-**Architecture:** Префлайт — фильтр eligible-проектов до формулы `computeOrder` (формула не меняется) + флаги заморозки на tenant/project + ежедневный cron 18:00 MSK. VTB — интерфейс `TopupGatewayInterface` + 3 реализации (безнал полный, СБП/карты dev-заглушки) + журнал `topup_sessions`.
+**Architecture:** Преfflight — фильтр eligible-проектов до формулы `computeOrder` (формула не меняется) + флаги заморозки на tenant/project + ежедневный cron 18:00 MSK. VTB — интерфейс `TopupGatewayInterface` + 3 реализации (безнал полный, СБП/карты dev-заглушки) + журнал `topup_sessions`.
 
 **Tech Stack:** PHP 8.3 / Laravel 13, PostgreSQL 16 (RLS), Pest 4, Vue 3 + Vuetify 3, Vitest, barryvdh/laravel-dompdf (новый).
 
@@ -16,7 +16,7 @@
 
 **Что уже есть на `origin/main` (зависимости):**
 
-- `App\Services\Billing\BalanceToLeadsConverter::convert(string $balanceRub, int $deliveredInMonth, Collection $tiers): array` — возвращает `['leads' => int, 'breakdown' => [...], 'current_tier' => ..., 'next_tier' => ...]`. Pure, bcmath. Используется в префлайт для «сколько лидов даёт баланс».
+- `App\Services\Billing\BalanceToLeadsConverter::convert(string $balanceRub, int $deliveredInMonth, Collection $tiers): array` — возвращает `['leads' => int, 'breakdown' => [...], 'current_tier' => ..., 'next_tier' => ...]`. Pure, bcmath. Используется в преfflight для «сколько лидов даёт баланс».
 - `App\Services\Billing\PricingTierResolver` — резолвер ступени по порядковому номеру лида.
 - `App\Services\Billing\LedgerService` — списания (не трогаем).
 - `App\Services\Billing\BillingTopupService::topup(int $tenantId, string $amountRub, ?int $userId)` — MVP-stub пополнения (рефакторим).
@@ -72,12 +72,11 @@ Expected: миграции прошли, converter-тесты GREEN (завис
 
 ---
 
-## Phase 1 — Префлайт баланса
+## Phase 1 — Преfflight баланса
 
 ### Task 1.1: Миграция БД — флаги заморозки + журнал
 
 **Files:**
-
 - Create: `app/database/migrations/2026_05_24_100000_add_balance_freeze_to_tenants_and_projects.php`
 - Create: `db/migrations/2026_05_24_balance_freeze_log.sql` (для prod-синка вручную, как в Спеке B)
 - Modify: `db/schema.sql` (добавить колонки + таблицу + запись в `db/CHANGELOG_schema.md`)
@@ -173,7 +172,6 @@ git commit -m "feat(billing-v2-c): миграция — флаги заморо
 ### Task 1.2: `BalancePreflightService` — pure-проверка платёжеспособности
 
 **Files:**
-
 - Create: `app/app/Services/Billing/BalancePreflightService.php`
 - Create: `app/app/Services/Billing/PreflightResult.php`
 - Test: `app/tests/Unit/Billing/BalancePreflightServiceTest.php`
@@ -272,7 +270,7 @@ namespace App\Services\Billing;
 use Illuminate\Database\Eloquent\Collection;
 
 /**
- * Pure: проходит ли клиент префлайт — хватает ли баланса на ПОЛНЫЙ дневной
+ * Pure: проходит ли клиент преfflight — хватает ли баланса на ПОЛНЫЙ дневной
  * лимит всех его eligible-проектов по текущему тарифу.
  *
  * Сравнение в ЛИДАХ (capacity vs required), не в рублях — переиспользует
@@ -330,7 +328,6 @@ git commit -m "feat(billing-v2-c): BalancePreflightService — pure-провер
 ### Task 1.3: Tenant/Project — хелперы платёжеспособности + резолвер eligible-лимита
 
 **Files:**
-
 - Modify: `app/app/Models/Tenant.php` (метод `requiredLeadsForTomorrow()`, scope, casts флага)
 - Modify: `app/app/Models/Project.php` (cast `preflight_blocked_at`)
 - Test: `app/tests/Feature/Billing/TenantPreflightTest.php`
@@ -372,7 +369,7 @@ Expected: FAIL — метод `requiredLeadsForTomorrow` не существуе
 ```php
 /**
  * Сумма daily_limit активных проектов — «сколько лидов клиент хочет в день».
- * Используется префлайт'ом как requiredLeads.
+ * Используется преfflight'ом как requiredLeads.
  */
 public function requiredLeadsForTomorrow(): int
 {
@@ -401,7 +398,6 @@ git commit -m "feat(billing-v2-c): Tenant::requiredLeadsForTomorrow + cast фл
 ### Task 1.4: `BalancePreflightSweepJob` — ежедневный пересчёт заморозок
 
 **Files:**
-
 - Create: `app/app/Jobs/Billing/BalancePreflightSweepJob.php`
 - Create: `app/app/Console/Commands/BillingPreflightSweepCommand.php`
 - Modify: `app/routes/console.php` (Schedule @18:00 MSK + heartbeat)
@@ -489,7 +485,7 @@ use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Mail;
 
 /**
- * Ежедневный префлайт всех тенантов перед формированием заказа поставщику.
+ * Ежедневный преfflight всех тенантов перед формированием заказа поставщику.
  * Запускается cron @18:00 MSK (routes/console.php). См. спек §3.5, §5.2.
  *
  * NB: crm_supplier_worker / системный контекст — джоб бегает без tenant-RLS;
@@ -578,12 +574,12 @@ final class BillingPreflightSweepCommand extends Command
 {
     protected $signature = 'billing:preflight-sweep';
 
-    protected $description = 'Ежедневный префлайт баланса — заморозка/разморозка тенантов (cut-off 18:00 MSK)';
+    protected $description = 'Ежедневный преfflight баланса — заморозка/разморозка тенантов (cut-off 18:00 MSK)';
 
     public function handle(): int
     {
         (new BalancePreflightSweepJob())->handle();
-        $this->info('Префлайт sweep завершён.');
+        $this->info('Преfflight sweep завершён.');
 
         return self::SUCCESS;
     }
@@ -595,7 +591,7 @@ final class BillingPreflightSweepCommand extends Command
 Добавить после существующих задач (с heartbeat-обёрткой по образцу `projects:reset-delivered-today`):
 
 ```php
-// Спек C §3.2: префлайт баланса в 18:00 MSK — формирование заказа поставщику без «бедных» клиентов.
+// Спек C §3.2: преfflight баланса в 18:00 MSK — формирование заказа поставщику без «бедных» клиентов.
 Schedule::command('billing:preflight-sweep')
     ->dailyAt('18:00')
     ->timezone('Europe/Moscow')
@@ -629,7 +625,6 @@ git commit -m "feat(billing-v2-c): BalancePreflightSweepJob + cron 18:00 MSK"
 ### Task 1.5: Mailable — 4 письма заморозки/разморозки
 
 **Files:**
-
 - Create: `app/app/Mail/BalanceFrozenMail.php` + `app/app/Mail/BalanceFrozenReminderMail.php` + `app/app/Mail/BalanceFrozenFinalMail.php` + `app/app/Mail/BalanceUnfrozenMail.php`
 - Create: 4 blade-шаблона в `app/resources/views/emails/billing/`
 - Test: `app/tests/Feature/Billing/BalanceFreezeMailTest.php`
@@ -751,7 +746,6 @@ git commit -m "feat(billing-v2-c): 4 Mailable заморозки/разморо
 ### Task 1.6: Повторные письма — reminder через 1 день + final через 3 дня
 
 **Files:**
-
 - Create: `app/app/Jobs/Billing/BalanceFrozenReminderJob.php`
 - Modify: `app/routes/console.php` (Schedule daily + heartbeat)
 - Test: `app/tests/Feature/Billing/BalanceFrozenReminderJobTest.php`
@@ -894,10 +888,9 @@ git commit -m "feat(billing-v2-c): повторные письма заморо
 
 ---
 
-### Task 1.7: `ProjectController` — префлайт при создании/правке проекта
+### Task 1.7: `ProjectController` — преfflight при создании/правке проекта
 
 **Files:**
-
 - Modify: `app/app/Http/Controllers/Api/ProjectController.php` (store + update — 409 при перегрузке)
 - Test: `app/tests/Feature/Project/ProjectPreflightTest.php`
 
@@ -965,12 +958,12 @@ it('creates normally when within balance', function () {
 Run: `cd app && php artisan test --filter=ProjectPreflightTest`
 Expected: FAIL — 409 не возвращается (создаёт нормально).
 
-- [ ] **Step 3: Реализовать префлайт-проверку в `ProjectController::store`** (и аналогично `update`)
+- [ ] **Step 3: Реализовать преfflight-проверку в `ProjectController::store`** (и аналогично `update`)
 
 Вставить ПОСЛЕ валидации, ДО создания проекта:
 
 ```php
-// Спек C §3.4: префлайт при создании — если сумма лимитов перевешивает баланс.
+// Спек C §3.4: преfflight при создании — если сумма лимитов перевешивает баланс.
 $tenant = $request->user()->tenant;
 $tiers = \App\Models\PricingTier::query()->where('is_active', true)->get();
 $service = new \App\Services\Billing\BalancePreflightService();
@@ -1012,7 +1005,7 @@ Expected: PASS (3 теста).
 
 ```bash
 git add app/app/Http/Controllers/Api/ProjectController.php app/tests/Feature/Project/ProjectPreflightTest.php
-git commit -m "feat(billing-v2-c): ProjectController префлайт — 409 при перегрузке баланса"
+git commit -m "feat(billing-v2-c): ProjectController преfflight — 409 при перегрузке баланса"
 ```
 
 ---
@@ -1020,7 +1013,6 @@ git commit -m "feat(billing-v2-c): ProjectController префлайт — 409 п
 ### Task 1.8: Фильтр frozen-проектов в `SyncSupplierProjectsJob`
 
 **Files:**
-
 - Modify: `app/app/Jobs/Supplier/SyncSupplierProjectsJob.php` (исключить frozen перед allocator)
 - Test: `app/tests/Feature/Supplier/SyncSupplierPreflightFilterTest.php`
 
@@ -1102,7 +1094,6 @@ git commit -m "feat(billing-v2-c): SyncSupplierProjectsJob исключает fr
 ### Task 1.9: One-time команда `billing:preflight-initial-sweep`
 
 **Files:**
-
 - Create: `app/app/Console/Commands/BillingPreflightInitialSweepCommand.php`
 - Test: `app/tests/Feature/Billing/BillingPreflightInitialSweepTest.php`
 
@@ -1149,18 +1140,18 @@ use App\Jobs\Billing\BalancePreflightSweepJob;
 use Illuminate\Console\Command;
 
 /**
- * One-time: при выкатке префлайт прогнать всех тенантов и заморозить
+ * One-time: при выкатке преfflight прогнать всех тенантов и заморозить
  * недофинансированных. Запускается ОДИН раз вручную после миграции. Спек §3.9.
  */
 final class BillingPreflightInitialSweepCommand extends Command
 {
     protected $signature = 'billing:preflight-initial-sweep';
 
-    protected $description = 'Разовый префлайт при внедрении — заморозить недофинансированных тенантов';
+    protected $description = 'Разовый преfflight при внедрении — заморозить недофинансированных тенантов';
 
     public function handle(): int
     {
-        $this->warn('Разовый префлайт всех тенантов. Запускать ОДИН раз после выкатки.');
+        $this->warn('Разовый преfflight всех тенантов. Запускать ОДИН раз после выкатки.');
         (new BalancePreflightSweepJob())->handle();
         $this->info('Initial sweep завершён.');
 
@@ -1186,7 +1177,6 @@ git commit -m "feat(billing-v2-c): one-time billing:preflight-initial-sweep"
 ### Task 1.10: Frontend — баннер заморозки + индикатор ёмкости + диалог перегрузки
 
 **Files:**
-
 - Create: `app/resources/js/components/billing/BalanceFrozenBanner.vue`
 - Create: `app/resources/js/components/billing/BalanceCapacityIndicator.vue`
 - Create: `app/resources/js/components/projects/ProjectLimitOverloadDialog.vue`
@@ -1281,7 +1271,7 @@ Expected: PASS.
 
 ```bash
 git add app/resources/js/components/billing/ app/resources/js/components/projects/ProjectLimitOverloadDialog.vue app/resources/js/layouts/AppLayout.vue
-git commit -m "feat(billing-v2-c): UI префлайт — баннер, индикатор ёмкости, диалог перегрузки"
+git commit -m "feat(billing-v2-c): UI преfflight — баннер, индикатор ёмкости, диалог перегрузки"
 ```
 
 ---
@@ -1291,7 +1281,6 @@ git commit -m "feat(billing-v2-c): UI префлайт — баннер, инд
 ### Task 2.1: Миграция БД — реквизиты тенанта + topup_sessions
 
 **Files:**
-
 - Create: `app/database/migrations/2026_05_24_110000_add_legal_entity_and_topup_sessions.php`
 - Create: `db/migrations/2026_05_24_topup_sessions.sql` (prod-синк)
 - Modify: `db/schema.sql` + `db/CHANGELOG_schema.md`
@@ -1388,7 +1377,6 @@ git commit -m "feat(billing-v2-c): миграция — реквизиты юр.
 ### Task 2.2: Установить PDF-генератор
 
 **Files:**
-
 - Modify: `app/composer.json` (+ `barryvdh/laravel-dompdf`)
 
 - [ ] **Step 1: Установить пакет**
@@ -1413,7 +1401,6 @@ git commit -m "chore(billing-v2-c): + barryvdh/laravel-dompdf для счето
 ### Task 2.3: Модель TopupSession + `TopupGatewayInterface` + `BankTransferGateway`
 
 **Files:**
-
 - Create: `app/app/Models/TopupSession.php`
 - Create: `app/app/Services/Billing/Gateway/TopupGatewayInterface.php`
 - Create: `app/app/Services/Billing/Gateway/TopupSessionResult.php`
@@ -1617,7 +1604,6 @@ git commit -m "feat(billing-v2-c): TopupSession + TopupGatewayInterface + BankTr
 ### Task 2.4: PDF-счёт (Blade-шаблон + endpoint)
 
 **Files:**
-
 - Create: `app/resources/views/pdf/invoice.blade.php`
 - Modify: `app/app/Http/Controllers/Api/BillingController.php` (+ `invoicePdf`)
 - Modify: `app/routes/web.php` (route)
@@ -1712,7 +1698,6 @@ git commit -m "feat(billing-v2-c): PDF-счёт на пополнение + RLS-
 ### Task 2.5: Рефакторинг `BillingTopupService` под gateway + `confirmPayment`
 
 **Files:**
-
 - Modify: `app/app/Services/Billing/BillingTopupService.php`
 - Test: `app/tests/Feature/Billing/BillingTopupConfirmTest.php`
 
@@ -1812,7 +1797,7 @@ public function confirmPayment(string $providerRef, ?int $adminUserId): ?Balance
 Run: `cd app && php artisan test --filter=BillingTopupConfirmTest`
 Expected: PASS (2 теста).
 
-- [ ] **Step 5: Связка с префлайт — после confirm перепроверить заморозку**
+- [ ] **Step 5: Связка с преfflight — после confirm перепроверить заморозку**
 
 Добавить в конце `confirmPayment` (после коммита транзакции, или внутри): если `tenant.frozen_by_balance_at !== null` — прогнать `BalancePreflightService::evaluate`, и если теперь проходит — снять заморозку + `BalanceUnfrozenMail` + лог. Написать доп. тест `it('unfreezes tenant on topup confirm')`.
 
@@ -1828,7 +1813,6 @@ git commit -m "feat(billing-v2-c): BillingTopupService::confirmPayment + авт
 ### Task 2.6: `VtbStatementSyncJob` (авто-поиск) + dev-симулятор
 
 **Files:**
-
 - Create: `app/app/Jobs/Billing/VtbStatementSyncJob.php`
 - Create: `app/app/Console/Commands/VtbStatementSimulateCommand.php` (dev only)
 - Create: `app/app/Services/Billing/VtbBusinessClient.php` (интерфейс + null/dev реализация)
@@ -1907,7 +1891,6 @@ git commit -m "feat(billing-v2-c): VtbStatementSyncJob авто-поиск пл
 ### Task 2.7: Админка — журнал ожидающих платежей + подтверждение + настройка режима
 
 **Files:**
-
 - Create: `app/app/Http/Controllers/Api/Admin/PendingTopupsController.php`
 - Create: `app/app/Http/Controllers/Api/Admin/BillingSettingsController.php`
 - Modify: `app/routes/web.php` (admin routes)
@@ -1981,7 +1964,6 @@ git commit -m "feat(billing-v2-c): админка ожидающих плате
 ### Task 2.8: `NotifyPendingConfirmationsJob` — часовой алерт админу
 
 **Files:**
-
 - Create: `app/app/Jobs/Billing/NotifyPendingConfirmationsJob.php`
 - Create: `app/app/Mail/PendingConfirmationsAdminMail.php` + шаблон
 - Modify: `app/routes/console.php` (hourly + heartbeat)
@@ -2052,7 +2034,6 @@ git commit -m "feat(billing-v2-c): часовой алерт админу о н
 ### Task 2.9: Frontend — пополнение (выбор метода + безнал) + реквизиты + админка
 
 **Files:**
-
 - Create: `app/resources/js/views/billing/TopupView.vue`
 - Create: `app/resources/js/components/billing/TopupMethodPicker.vue`
 - Create: `app/resources/js/components/billing/BankTransferInvoiceView.vue`
@@ -2103,7 +2084,6 @@ git commit -m "feat(billing-v2-c): UI пополнения (безнал) + ре
 ### Task 3.1: `SbpGateway` (dev-режим) + фоновое авто-подтверждение
 
 **Files:**
-
 - Create: `app/app/Services/Billing/Gateway/SbpGateway.php`
 - Create: `app/app/Jobs/Billing/DevAutoConfirmSessionJob.php`
 - Test: `app/tests/Feature/Billing/SbpGatewayTest.php`
@@ -2204,7 +2184,6 @@ git commit -m "feat(billing-v2-c): SbpGateway dev-заглушка + авто-п
 ### Task 3.2: `CardGateway` (dev-режим) + dev-mock страница эквайринга
 
 **Files:**
-
 - Create: `app/app/Services/Billing/Gateway/CardGateway.php`
 - Create: `app/resources/js/views/dev/DevMockAcquiringView.vue` (только dev)
 - Modify: router (dev-only route `/dev-mock-vtb-acquiring/:sessionId`)
@@ -2262,7 +2241,6 @@ git commit -m "feat(billing-v2-c): CardGateway dev-заглушка + mock-ст
 ### Task 3.3: `FiscalReceiptProvider` — архитектура 54-ФЗ
 
 **Files:**
-
 - Create: `app/app/Services/Billing/Fiscal/FiscalReceiptProvider.php` (interface)
 - Create: `app/app/Services/Billing/Fiscal/NoOpFiscalProvider.php`
 - Create: `app/app/Services/Billing/Fiscal/DevMockFiscalProvider.php`
@@ -2356,7 +2334,6 @@ git commit -m "feat(billing-v2-c): архитектура 54-ФЗ — FiscalRece
 ### Task 3.4: Подключить выбор gateway + fiscal в `BillingTopupService::initiateTopup`
 
 **Files:**
-
 - Modify: `app/app/Services/Billing/BillingTopupService.php` (resolveGateway + initiateTopup)
 - Modify: `app/app/Http/Controllers/Api/BillingController.php` (+ `initiateTopup` endpoint)
 - Modify: `app/routes/web.php`
@@ -2421,10 +2398,9 @@ git commit -m "feat(billing-v2-c): initiateTopup — единый вход дл
 
 ## Phase 4 — End-to-end сценарии + регрессия
 
-### Task 4.1: Pest E2E — префлайт (заморозка → пополнение → разморозка)
+### Task 4.1: Pest E2E — преfflight (заморозка → пополнение → разморозка)
 
 **Files:**
-
 - Create: `app/tests/Feature/Billing/PreflightE2ETest.php`
 
 - [ ] **Step 1: Написать E2E-тест полного цикла**
@@ -2453,7 +2429,7 @@ it('full cycle: sufficient → drained → frozen → topup → unfrozen', funct
     $tenant = Tenant::factory()->create(['balance_rub' => '1250.00']); // 1250/50 = 25
     Project::factory()->for($tenant)->create(['status' => 'active', 'daily_limit' => 25]);
 
-    // Префлайт cut-off — проходит.
+    // Преfflight cut-off — проходит.
     (new BalancePreflightSweepJob())->handle();
     expect($tenant->fresh()->frozen_by_balance_at)->toBeNull();
 
@@ -2486,7 +2462,7 @@ Expected: PASS. (Если FAIL — починить связку confirmPayment
 
 ```bash
 git add app/tests/Feature/Billing/PreflightE2ETest.php
-git commit -m "test(billing-v2-c): E2E префлайт — полный цикл заморозки/разморозки"
+git commit -m "test(billing-v2-c): E2E преfflight — полный цикл заморозки/разморозки"
 ```
 
 ---
@@ -2494,7 +2470,6 @@ git commit -m "test(billing-v2-c): E2E префлайт — полный цик
 ### Task 4.2: Pest E2E — безнал (счёт → выписка → подтверждение)
 
 **Files:**
-
 - Create: `app/tests/Feature/Billing/BankTransferE2ETest.php`
 
 - [ ] **Step 1: Написать E2E-тест**
@@ -2596,19 +2571,18 @@ Expected: 0 leaks, 0 broken links.
 
 ## Phase 5 — Документация + ADR + push
 
-### Task 5.1: ADR-016 — архитектура префлайт + VTB
+### Task 5.1: ADR-016 — архитектура преfflight + VTB
 
 **Files:**
-
 - Create: `docs/adr/016-preflight-vtb-architecture.md`
 
-- [ ] **Step 1: Написать ADR** (Context — переплата поставщику + нет реального пополнения; Decision — префлайт как фильтр eligible до формулы + gateway-pattern для 3 методов + dev-заглушки до Б-1; Consequences — границы PF1..PFN; Status — Accepted). REQUIRED SUB-SKILL: `adr-kit:adr`.
+- [ ] **Step 1: Написать ADR** (Context — переплата поставщику + нет реального пополнения; Decision — преfflight как фильтр eligible до формулы + gateway-pattern для 3 методов + dev-заглушки до Б-1; Consequences — границы PF1..PFN; Status — Accepted). REQUIRED SUB-SKILL: `adr-kit:adr`.
 
 - [ ] **Step 2: Commit**
 
 ```bash
 git add docs/adr/016-preflight-vtb-architecture.md
-git commit -m "docs(adr): ADR-016 — префлайт баланса + VTB gateway-архитектура"
+git commit -m "docs(adr): ADR-016 — преfflight баланса + VTB gateway-архитектура"
 ```
 
 ---
@@ -2616,13 +2590,12 @@ git commit -m "docs(adr): ADR-016 — префлайт баланса + VTB gate
 ### Task 5.2: Обновить memory + нормативку (по необходимости)
 
 **Files:**
-
 - Modify: `memory/project_billing_v2.md` (Спек C: статус, артефакты, что выкачено)
 - Modify: `memory/MEMORY.md` (одна строка-указатель, если меняется)
 
 - [ ] **Step 1: Обновить `project_billing_v2.md`** — раздел «Спек C» из PENDING brainstorm → IMPLEMENTED (worktree, ветка, фазы, что dev-заглушки до Б-1, что pending). Через Write tool (это memory, не код).
 
-- [ ] **Step 2: CLAUDE.md / Pravila / Tooling** — **проверить**, нужны ли правки. Префлайт/VTB — это фича портала, не новый инструмент тулчейна → **скорее всего нормативка не меняется**. Если нужно — через `/claude-md-management:claude-md-improver` (НЕ прямой Edit CLAUDE.md, кроме worktree-эксцепшна §5 п.10).
+- [ ] **Step 2: CLAUDE.md / Pravila / Tooling** — **проверить**, нужны ли правки. Преfflight/VTB — это фича портала, не новый инструмент тулчейна → **скорее всего нормативка не меняется**. Если нужно — через `/claude-md-management:claude-md-improver` (НЕ прямой Edit CLAUDE.md, кроме worktree-эксцепшна §5 п.10).
 
 - [ ] **Step 3: Commit (если были правки)**
 
@@ -2645,7 +2618,7 @@ REQUIRED SUB-SKILL: `superpowers:finishing-a-development-branch`.
 
 Варианты: PR в main (через `gh`) ИЛИ FF-merge в main (паттерн Спека B `git push origin feat/billing-v2-spec-c:main` через worktree). **Только после явного «выкатываем» от заказчика** (Pravila §2.2 — не закрывать без подтверждения).
 
-- [ ] **Step 3: НЕ выкатывать на прод автоматически.** Боевой деплой VTB-части невозможен до Б-1 (нет реквизитов). Префлайт-часть можно выкатить — но **только по явному решению заказчика** + ручной прогон `billing:preflight-initial-sweep` на проде с предупреждением клиентам.
+- [ ] **Step 3: НЕ выкатывать на прод автоматически.** Боевой деплой VTB-части невозможен до Б-1 (нет реквизитов). Преfflight-часть можно выкатить — но **только по явному решению заказчика** + ручной прогон `billing:preflight-initial-sweep` на проде с предупреждением клиентам.
 
 - [ ] **Step 4: Обновить `ПИЛОТ.md`** (если/когда выкачено на боевой liderra.ru).
 
@@ -2677,7 +2650,7 @@ REQUIRED SUB-SKILL: `superpowers:finishing-a-development-branch`.
 
 ## Заметки для исполнителя
 
-**По §3.9 спека (граничные случаи):** главный инвариант «баланс не уходит в минус» держится `LedgerService` (он уже защищён от списания ниже нуля) + ежедневным префлайт. Поэтому отдельное «предупреждение админа при ретро-операциях» (CSV-импорт исторических лидов / ручная правка баланса между cut-off и началом дня) — **опциональная UX-полировка**, не блокер. Если делать — добавить confirm-диалог в `ImportController` и в `AdminTenantsController::adjustBalance` UI с текстом «эта операция может вывести клиента в заморозку на следующем cut-off». Минимально — можно вынести в отдельную мелкую задачу или Спек D. Префлайт отработает корректно в любом случае.
+**По §3.9 спека (граничные случаи):** главный инвариант «баланс не уходит в минус» держится `LedgerService` (он уже защищён от списания ниже нуля) + ежедневным преfflight. Поэтому отдельное «предупреждение админа при ретро-операциях» (CSV-импорт исторических лидов / ручная правка баланса между cut-off и началом дня) — **опциональная UX-полировка**, не блокер. Если делать — добавить confirm-диалог в `ImportController` и в `AdminTenantsController::adjustBalance` UI с текстом «эта операция может вывести клиента в заморозку на следующем cut-off». Минимально — можно вынести в отдельную мелкую задачу или Спек D. Преfflight отработает корректно в любом случае.
 
 **По UI-задачам (1.10, 2.9, 3.2):** для критичных компонентов (`BalanceCapacityIndicator`) дан полный код. Для остальных Vue-компонентов дан контракт (props / emit / поведение) — исполнитель пишет разметку по образцу первого компонента и существующих паттернов проекта (Vuetify 3, Composition API, `<script setup lang="ts">`). Это сознательное решение: расписывать 10 Vue-компонентов построчно раздуло бы план без пользы. Каждый UI-компонент имеет Vitest-тест с явными ожиданиями — они и фиксируют контракт.
 
@@ -2693,3 +2666,4 @@ REQUIRED SUB-SKILL: `superpowers:finishing-a-development-branch`.
 - Боевая интеграция ОФД-Атол (фискализация).
 - Боевые секреты в YC Lockbox (SEC-5).
 - Спек D: «отдать разморозившемуся клиенту лиды через шеринг» + «приоритет шеринга по платёжеспособности».
+
diff --git a/docs/superpowers/specs/2026-05-24-billing-v2-spec-c-preflight-vtb-design.md b/docs/superpowers/specs/2026-05-24-billing-v2-spec-c-preflight-vtb-design.md
index 1f96b275..8ae4888d 100644
--- a/docs/superpowers/specs/2026-05-24-billing-v2-spec-c-preflight-vtb-design.md
+++ b/docs/superpowers/specs/2026-05-24-billing-v2-spec-c-preflight-vtb-design.md
@@ -34,7 +34,7 @@ order = max(самый_большой_лимит, ceil(сумма_лимитов
 
 ### §1.2 Проблемы
 
-**Префлайт:**
+**Преfflight:**
 
 1. **Портал переплачивает поставщику** за лиды клиентов, у которых нет денег. Это прямой убыток — закупка оплачена, а продажа не состоится.
 2. **Нет проактивной защиты при создании/изменении проектов.** Клиент может выставить лимит, который сам по себе не оплачиваем. Сейчас проблема всплывает только в момент списания.
@@ -42,8 +42,8 @@ order = max(самый_большой_лимит, ceil(сумма_лимитов
 
 **VTB-эквайринг:**
 
-1. **Реального пополнения нет** — `BillingTopupService` это заглушка. Деньги попадают на баланс только через ручное действие админа (`AdminTenantsController::adjustBalance`).
-2. **Нет 54-ФЗ фискализации** при ритейл-платежах (после подключения карт/СБП — обязательно).
+4. **Реального пополнения нет** — `BillingTopupService` это заглушка. Деньги попадают на баланс только через ручное действие админа (`AdminTenantsController::adjustBalance`).
+5. **Нет 54-ФЗ фискализации** при ритейл-платежах (после подключения карт/СБП — обязательно).
 
 ### §1.3 Триггер
 
@@ -57,7 +57,7 @@ order = max(самый_большой_лимит, ceil(сумма_лимитов
 
 ### §2.1 Что делаем
 
-**Префлайт баланса:**
+**Преfflight баланса:**
 
 - Расширение `SupplierQuotaAllocator` для учёта баланса клиента (фильтрация eligible-проектов до `computeOrder`).
 - Активная проверка при создании/правке проекта в личном кабинете (диалог выбора).
@@ -81,17 +81,17 @@ order = max(самый_большой_лимит, ceil(сумма_лимитов
 - **«Отдать разморозившемуся клиенту лиды, уже купленные сегодня, через шеринг»** — отложено в Спек D (см. §8).
 - **Возвраты пополнений** (refund) — не реализуем (Спек A: «возвраты не делаем»).
 - **Recurring-платежи** (автосписание) — не реализуем.
-- **Изменение формулы `computeOrder`** — формула остаётся прежней, префлайт только фильтрует входной список.
+- **Изменение формулы `computeOrder`** — формула остаётся прежней, преfflight только фильтрует входной список.
 
 ---
 
-## §3. Решение — часть 1: Префлайт баланса
+## §3. Решение — часть 1: Преfflight баланса
 
 ### §3.1 Главный инвариант
 
-**Баланс клиента никогда не уходит в минус.** Гарант — префлайт, который проверяет «хватит ли на полный дневной заказ» **до** того, как заказ уйдёт поставщику. Если хватает — клиент в заказе; если поставщик пришлёт меньше планируемого (норма), остаток баланса уходит в следующий день.
+**Баланс клиента никогда не уходит в минус.** Гарант — преfflight, который проверяет «хватит ли на полный дневной заказ» **до** того, как заказ уйдёт поставщику. Если хватает — клиент в заказе; если поставщик пришлёт меньше планируемого (норма), остаток баланса уходит в следующий день.
 
-### §3.2 Когда срабатывает префлайт
+### §3.2 Когда срабатывает преfflight
 
 **Одна основная точка:** ежедневный cut-off в **18:00 MSK** (включая выходные).
 
@@ -124,11 +124,11 @@ $requiredLeads = $tenant->projects()
 $passes = $capacity >= $requiredLeads;
 ```
 
-Если `passes=true` — клиент проходит префлайт. Если `false` — не проходит.
+Если `passes=true` — клиент проходит преfflight. Если `false` — не проходит.
 
 7-ступенчатый расчёт уже реализован в `BalanceToLeadsConverter::convert` (Спек A) — он сам пройдёт по ступеням, учтёт «текущую» (где сейчас клиент в накопленном объёме) и переход на следующие при росте.
 
-**NB:** проверяется на **полный лимит** проектов, не на «уже отгруженное + остаток сегодняшнего дня». Это потому, что префлайт работает один раз перед формированием заказа на завтра, а не во время выдачи.
+**NB:** проверяется на **полный лимит** проектов, не на «уже отгруженное + остаток сегодняшнего дня». Это потому, что преfflight работает один раз перед формированием заказа на завтра, а не во время выдачи.
 
 ### §3.4 Что делает портал при создании/правке «перегруженного» проекта
 
@@ -218,16 +218,16 @@ $passes = $capacity >= $requiredLeads;
 - **Онлайн-режим** (сейчас, для малого числа клиентов): любое изменение в проектах Лидерры → немедленный апдейт на сервере поставщика (`SyncSupplierProjectJob` per-project). Поставщик сохраняет, использует в своём 21:00 слепке.
 - **Batch до 18:00** (на будущее при росте): накопленные изменения уезжают одним пакетом перед 18:00 (`SyncSupplierProjectsJob` daily cron).
 
-**Префлайт работает одинаково в обоих режимах** — он только меняет, какие проекты идут в `SyncSupplierProjectJob` (исключает frozen-проекты из `active_today`). Дальше — стандартный механизм синхронизации.
+**Преfflight работает одинаково в обоих режимах** — он только меняет, какие проекты идут в `SyncSupplierProjectJob` (исключает frozen-проекты из `active_today`). Дальше — стандартный механизм синхронизации.
 
 ### §3.9 Граничные случаи
 
 | Случай | Поведение |
 |---|---|
 | Ретро-операция (CSV-импорт исторических лидов) между 18:00 и началом следующего дня списывает баланс ниже плана | Допускается, но админ предупреждается в UI «эта операция может вывести клиента в заморозку, продолжить?». Если согласился — выполняется; на следующем cut-off клиент будет в заморозке. Минусовых балансов не возникает (CSV-импорт делает обычные `lead_charges` через `LedgerService`, который остаётся защищён от минуса) |
-| Ручная правка баланса админом (`adjustBalance`) уменьшает баланс ниже плана | Аналогично — админ предупреждается, ответственность на нём. Префлайт отработает на следующем cut-off |
-| Клиент уже в минусовом балансе на момент запуска префлайт (legacy состояние) | Одноразовая artisan-команда `billing:preflight-initial-sweep` — проходит по всем тенантам, помечает `frozen_by_balance_at` где нужно, отправляет письма с пояснением «у вас активирована новая защита баланса». Запускается один раз при выкатке миграции |
-| Тарифная ступень меняется в течение дня (накопился объём) | Префлайт на 18:00 MSK использует **текущую** ступень. На завтра ступень может быть другой — но это уже зона следующего cut-off |
+| Ручная правка баланса админом (`adjustBalance`) уменьшает баланс ниже плана | Аналогично — админ предупреждается, ответственность на нём. Преfflight отработает на следующем cut-off |
+| Клиент уже в минусовом балансе на момент запуска преfflight (legacy состояние) | Одноразовая artisan-команда `billing:preflight-initial-sweep` — проходит по всем тенантам, помечает `frozen_by_balance_at` где нужно, отправляет письма с пояснением «у вас активирована новая защита баланса». Запускается один раз при выкатке миграции |
+| Тарифная ступень меняется в течение дня (накопился объём) | Преfflight на 18:00 MSK использует **текущую** ступень. На завтра ступень может быть другой — но это уже зона следующего cut-off |
 | Поставщик прислал меньше планируемого (норма) | Остаток баланса клиента — экономия для следующего дня. Никаких корректировок |
 | Клиент пополнил после 18:00 | В сегодня-в-21:00-слепок поставщика не успевает, но в личном кабинете тут же «Возобновлено». В следующий вечерний cut-off — в заказ на послезавтра |
 
@@ -239,7 +239,7 @@ $passes = $capacity >= $requiredLeads;
 order = max(самый_большой_лимит, ceil(сумма_лимитов ÷ 3))
 ```
 
-Префлайт **не меняет формулу**, а **фильтрует входной массив `daily_limits`** — выкидывает клиентов, не прошедших проверку.
+Преfflight **не меняет формулу**, а **фильтрует входной массив `daily_limits`** — выкидывает клиентов, не прошедших проверку.
 
 **Эффект зависит от того, кого выкинули:**
 
@@ -256,7 +256,7 @@ order = max(самый_большой_лимит, ceil(сумма_лимитов
 
 ### §3.11 Журналирование
 
-При каждом срабатывании префлайт (заморозка / разморозка) — строка в новой таблице `balance_freeze_log`:
+При каждом срабатывании преfflight (заморозка / разморозка) — строка в новой таблице `balance_freeze_log`:
 
 ```sql
 CREATE TABLE balance_freeze_log (
@@ -488,7 +488,7 @@ ALTER TABLE tenants ADD COLUMN legal_entity_form VARCHAR(20);     -- 'OOO' | 'IP
 | **Фронт-views** | `TopupView.vue` (новый, обёртка с переключателем methods); `BillingFrozenInfoView.vue` |
 | **Pinia** | `billingStore` (расширение под topup-сессии); `tenantStore` (frozen-флаг) |
 
-### §5.2 Sequence-диаграмма префлайт на cut-off
+### §5.2 Sequence-диаграмма преfflight на cut-off
 
 ```
 18:00 MSK Cron
@@ -518,7 +518,7 @@ ALTER TABLE tenants ADD COLUMN legal_entity_form VARCHAR(20);     -- 'OOO' | 'IP
    │     │
    │     └── для следующего tenant...
    │
-18:05 MSK (после префлайт) — обычный SyncSupplierProjectsJob запускается
+18:05 MSK (после преfflight) — обычный SyncSupplierProjectsJob запускается
    │
    ├── SupplierQuotaAllocator::allocate(eligible_projects)
    │     │
@@ -635,12 +635,11 @@ $dto = SupplierQuotaAllocator::allocate(..., $eligibleProjects, $targetDate);
 
 ## §6. Сценарии (end-to-end)
 
-### §6.1 Префлайт — пассивный износ
+### §6.1 Преfflight — пассивный износ
 
 **Воскресенье 00:00.** Клиент с балансом 1000₽ = 30 лидов (tier 3, цена ~33₽/лид). Проекты заказывают 25/день. Запас 5.
 
 **Воскресенье 18:00.** Cron `BalancePreflightSweepJob`:
-
 - `BalancePreflightService::evaluate(client)` → `passes=true` (хватает на 25).
 - `frozen_by_balance_at` остаётся `NULL`.
 
@@ -649,7 +648,6 @@ $dto = SupplierQuotaAllocator::allocate(..., $eligibleProjects, $targetDate);
 **Понедельник.** В течение дня партии лидов приходят, клиент получает все 25, баланс падает до 0. Никаких внутридневных стопов.
 
 **Понедельник 18:00.** Cron snova:
-
 - `evaluate(client)` → `passes=false` (0₽ ≠ 25 лидов).
 - `frozen_by_balance_at = now()`.
 - `balance_freeze_log.insert(event='frozen', triggered_by='cutoff_18msk')`.
@@ -663,11 +661,11 @@ $dto = SupplierQuotaAllocator::allocate(..., $eligibleProjects, $targetDate);
 
 **Вторник 18:00.** Cron snova — клиент в заказе на среду. Со среды получает лиды.
 
-### §6.2 Префлайт — активная нехватка при создании проекта
+### §6.2 Преfflight — активная нехватка при создании проекта
 
 **Клиент с балансом 1000₽ = 30 лидов.** Имеет 3 проекта по 10 = 30 лимит. Всё впритык.
 
-**Клиент создаёт 4-й проект с лимитом 20.** Бэк (`ProjectController::store`) делает превью-префлайт:
+**Клиент создаёт 4-й проект с лимитом 20.** Бэк (`ProjectController::store`) делает превью-преfflight:
 
 - `Σ daily_limit (после сохранения) = 50` лидов
 - `capacity = BalanceToLeadsConverter::convert(1000₽, delivered, tiers)['leads'] = 30` лидов
@@ -766,7 +764,7 @@ $dto = SupplierQuotaAllocator::allocate(..., $eligibleProjects, $targetDate);
 
 Предварительная разбивка на фазы (для оценки масштаба):
 
-**Phase 1 — Префлайт баланса** (~5-7 задач):
+**Phase 1 — Преfflight баланса** (~5-7 задач):
 
 - Миграция БД (`frozen_by_balance_at`, `preflight_blocked_at`, `balance_freeze_log`).
 - `BalancePreflightService` (pure) + тесты.
@@ -798,7 +796,7 @@ $dto = SupplierQuotaAllocator::allocate(..., $eligibleProjects, $targetDate);
 
 **Phase 4 — Тесты + smoke** (~3-4 задач):
 
-- Pest end-to-end сценарии префлайт (frozen/unfrozen flow).
+- Pest end-to-end сценарии преfflight (frozen/unfrozen flow).
 - Pest end-to-end сценарии безнала (создание счёта → симуляция выписки → подтверждение).
 - Vitest на новые Vue-компоненты.
 - Регрессия (Pest --parallel + Vitest + lychee + gitleaks).

From e83ddaaf0f033619f132b44a078ac5242a20784b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <donnalee11681676@gmail.com>
Date: Sun, 24 May 2026 11:48:48 +0300
Subject: [PATCH 02/13] =?UTF-8?q?feat(billing-v2-c):=20=D0=BC=D0=B8=D0=B3?=
 =?UTF-8?q?=D1=80=D0=B0=D1=86=D0=B8=D1=8F=20=E2=80=94=20=D1=84=D0=BB=D0=B0?=
 =?UTF-8?q?=D0=B3=D0=B8=20=D0=B7=D0=B0=D0=BC=D0=BE=D1=80=D0=BE=D0=B7=D0=BA?=
 =?UTF-8?q?=D0=B8=20=D0=B1=D0=B0=D0=BB=D0=B0=D0=BD=D1=81=D0=B0=20+=20balan?=
 =?UTF-8?q?ce=5Ffreeze=5Flog?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Task 1.1 Спека C. tenants.frozen_by_balance_at + projects.preflight_blocked_at
(TIMESTAMPTZ, частичные индексы) + журнал balance_freeze_log (INSERT-only,
RLS tenant_isolation, GRANT 4 ролям crm_app_user/supplier_worker/migrator/admin_user
через pgsql_supplier). schema.sql v8.34->v8.35.

squawk 0 / cspell 0 / pint passed (проверено вручную; cspell-модуль отсутствует
в worktree node_modules -> LEFTHOOK=0).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 ...balance_freeze_to_tenants_and_projects.php | 69 +++++++++++++++++++
 .../2026_05_24_balance_freeze_log.sql         | 55 +++++++++++++++
 db/schema.sql                                 | 55 ++++++++++++++-
 3 files changed, 178 insertions(+), 1 deletion(-)
 create mode 100644 app/database/migrations/2026_05_24_100000_add_balance_freeze_to_tenants_and_projects.php
 create mode 100644 db/migrations/2026_05_24_balance_freeze_log.sql

diff --git a/app/database/migrations/2026_05_24_100000_add_balance_freeze_to_tenants_and_projects.php b/app/database/migrations/2026_05_24_100000_add_balance_freeze_to_tenants_and_projects.php
new file mode 100644
index 00000000..7c3b7df9
--- /dev/null
+++ b/app/database/migrations/2026_05_24_100000_add_balance_freeze_to_tenants_and_projects.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        // Всё DDL через pgsql_supplier — избегаем deadlock при смешивании соединений.
+        // Laravel оборачивает миграцию в транзакцию на дефолтном pgsql; ALTER TABLE tenants
+        // на pgsql + CREATE TABLE с FK на tenants через pgsql_supplier = взаимная блокировка.
+        // На dev pgsql_supplier = postgres superuser (те же права), на prod — явные GRANT'ы ниже.
+        $supplier = DB::connection('pgsql_supplier');
+
+        // Флаги заморозки. tenant-level — пассивный износ; project-level — точечная перегрузка.
+        $supplier->statement('ALTER TABLE tenants ADD COLUMN IF NOT EXISTS frozen_by_balance_at TIMESTAMPTZ NULL');
+        $supplier->statement('ALTER TABLE projects ADD COLUMN IF NOT EXISTS preflight_blocked_at TIMESTAMPTZ NULL');
+
+        $supplier->statement('CREATE INDEX IF NOT EXISTS tenants_frozen_by_balance_idx ON tenants (frozen_by_balance_at) WHERE frozen_by_balance_at IS NOT NULL');
+        $supplier->statement('CREATE INDEX IF NOT EXISTS projects_preflight_blocked_idx ON projects (preflight_blocked_at) WHERE preflight_blocked_at IS NOT NULL');
+
+        // Журнал заморозок/разморозок. Создаём через pgsql_supplier (урок Спека B — prod-роли).
+        $supplier->statement(<<<'SQL'
+            CREATE TABLE IF NOT EXISTS balance_freeze_log (
+                id BIGSERIAL PRIMARY KEY,
+                tenant_id BIGINT NOT NULL REFERENCES tenants(id),
+                event_type VARCHAR(30) NOT NULL,
+                triggered_by VARCHAR(30) NOT NULL,
+                balance_rub_at_event DECIMAL(12,2) NOT NULL,
+                required_leads INTEGER NOT NULL,
+                capacity_leads INTEGER NOT NULL,
+                total_daily_limit INTEGER NOT NULL,
+                details JSONB,
+                created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+            )
+        SQL);
+        $supplier->statement('ALTER TABLE balance_freeze_log ENABLE ROW LEVEL SECURITY');
+        $supplier->statement(<<<'SQL'
+            CREATE POLICY tenant_isolation ON balance_freeze_log
+            USING (tenant_id = current_setting('app.current_tenant_id', true)::bigint)
+        SQL);
+        $supplier->statement('CREATE INDEX IF NOT EXISTS balance_freeze_log_tenant_idx ON balance_freeze_log (tenant_id, created_at DESC)');
+
+        // Гранты для 4 ролей (mirror webhook_dedup_keys / supplier_lead_deliveries).
+        foreach (['crm_app_user', 'crm_supplier_worker', 'crm_migrator', 'crm_admin_user'] as $role) {
+            $supplier->statement(<<<SQL
+                DO \$\$
+                BEGIN
+                    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = '{$role}') THEN
+                        GRANT SELECT, INSERT ON balance_freeze_log TO {$role};
+                        GRANT USAGE, SELECT ON SEQUENCE balance_freeze_log_id_seq TO {$role};
+                    END IF;
+                END
+                \$\$
+            SQL);
+        }
+    }
+
+    public function down(): void
+    {
+        $supplier = DB::connection('pgsql_supplier');
+        $supplier->statement('DROP TABLE IF EXISTS balance_freeze_log');
+        $supplier->statement('ALTER TABLE projects DROP COLUMN IF EXISTS preflight_blocked_at');
+        $supplier->statement('ALTER TABLE tenants DROP COLUMN IF EXISTS frozen_by_balance_at');
+    }
+};
diff --git a/db/migrations/2026_05_24_balance_freeze_log.sql b/db/migrations/2026_05_24_balance_freeze_log.sql
new file mode 100644
index 00000000..1c05cf7c
--- /dev/null
+++ b/db/migrations/2026_05_24_balance_freeze_log.sql
@@ -0,0 +1,55 @@
+-- =============================================================================
+-- balance_freeze_log — журнал заморозок/разморозок тенантов по балансу
+-- (Billing v2 Spec C). INSERT-only таблица: записи не обновляются, только
+-- добавляются. Используется PreflightBalanceService для аудит-трейла.
+-- =============================================================================
+CREATE TABLE IF NOT EXISTS balance_freeze_log (
+    id                   BIGSERIAL PRIMARY KEY,
+    tenant_id            BIGINT NOT NULL REFERENCES tenants(id),
+    event_type           VARCHAR(30) NOT NULL,
+    triggered_by         VARCHAR(30) NOT NULL,
+    balance_rub_at_event DECIMAL(12,2) NOT NULL,
+    required_leads       INTEGER NOT NULL,
+    capacity_leads       INTEGER NOT NULL,
+    total_daily_limit    INTEGER NOT NULL,
+    details              JSONB,
+    created_at           TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+ALTER TABLE balance_freeze_log ENABLE ROW LEVEL SECURITY;
+CREATE POLICY tenant_isolation ON balance_freeze_log
+    USING (tenant_id = current_setting('app.current_tenant_id', true)::bigint);
+
+CREATE INDEX IF NOT EXISTS balance_freeze_log_tenant_idx ON balance_freeze_log (tenant_id, created_at DESC);
+
+-- Флаги заморозки на tenants и projects
+ALTER TABLE tenants  ADD COLUMN IF NOT EXISTS frozen_by_balance_at TIMESTAMPTZ NULL;
+ALTER TABLE projects ADD COLUMN IF NOT EXISTS preflight_blocked_at TIMESTAMPTZ NULL;
+
+CREATE INDEX IF NOT EXISTS tenants_frozen_by_balance_idx  ON tenants  (frozen_by_balance_at) WHERE frozen_by_balance_at IS NOT NULL;
+CREATE INDEX IF NOT EXISTS projects_preflight_blocked_idx ON projects (preflight_blocked_at) WHERE preflight_blocked_at IS NOT NULL;
+
+-- Явные GRANT'ы для 4 ролей: на prod таблица создаётся через pgsql_supplier
+-- (default privileges от postgres-superuser не наследуются на чужие creator-role).
+-- Mirror supplier_lead_deliveries grant pattern. DO block — idempotent + dev-safe
+-- (на dev ролей нет → silent skip). balance_freeze_log: SELECT+INSERT только
+-- (INSERT-only по дизайну — не UPDATE, не DELETE).
+DO $$
+BEGIN
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_app_user') THEN
+        GRANT SELECT, INSERT ON balance_freeze_log TO crm_app_user;
+        GRANT USAGE, SELECT ON SEQUENCE balance_freeze_log_id_seq TO crm_app_user;
+    END IF;
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_supplier_worker') THEN
+        GRANT SELECT, INSERT ON balance_freeze_log TO crm_supplier_worker;
+        GRANT USAGE, SELECT ON SEQUENCE balance_freeze_log_id_seq TO crm_supplier_worker;
+    END IF;
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_migrator') THEN
+        GRANT SELECT, INSERT ON balance_freeze_log TO crm_migrator;
+        GRANT USAGE, SELECT ON SEQUENCE balance_freeze_log_id_seq TO crm_migrator;
+    END IF;
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_admin_user') THEN
+        GRANT SELECT, INSERT ON balance_freeze_log TO crm_admin_user;
+        GRANT USAGE, SELECT ON SEQUENCE balance_freeze_log_id_seq TO crm_admin_user;
+    END IF;
+END $$;
diff --git a/db/schema.sql b/db/schema.sql
index 0fad3db3..ac9ee1f3 100644
--- a/db/schema.sql
+++ b/db/schema.sql
@@ -677,12 +677,17 @@ CREATE TABLE tenants (
     -- Метаданные
     created_at          TIMESTAMPTZ DEFAULT NOW(),
     updated_at          TIMESTAMPTZ,
-    deleted_at          TIMESTAMPTZ                        -- soft delete (раздел 4.5)
+    deleted_at          TIMESTAMPTZ,                       -- soft delete (раздел 4.5)
+    -- v8.35 (Billing v2 Spec C): флаг заморозки по балансу.
+    -- Не NULL = тенант заморожен (баланс < стоимость дня лидов). PreflightBalanceService.
+    frozen_by_balance_at TIMESTAMPTZ NULL
 );
 
 CREATE INDEX idx_tenants_subdomain     ON tenants(subdomain) WHERE deleted_at IS NULL;
 -- idx_tenants_webhook_token удалён в v8.35 (legacy direct webhook removal)
 CREATE INDEX idx_tenants_inactive      ON tenants(last_activity_at) WHERE deleted_at IS NULL;
+-- v8.35: частичный индекс для заморозки (sparse — большинство тенантов не заморожены)
+CREATE INDEX tenants_frozen_by_balance_idx  ON tenants (frozen_by_balance_at) WHERE frozen_by_balance_at IS NOT NULL;
 
 -- Forward FK на tenants для SaaS-админских таблиц, объявленных выше
 -- (saas_admin_sessions.impersonating_tenant_id — Ю-1; impersonation_tokens.tenant_id).
@@ -853,6 +858,9 @@ CREATE TABLE projects (
                                     CHECK (ttfr_target_minutes BETWEEN 1 AND 1440),
     created_at                      TIMESTAMPTZ DEFAULT NOW(),
     updated_at                      TIMESTAMPTZ,
+    -- v8.35 (Billing v2 Spec C): флаг точечной блокировки проекта по preflight.
+    -- Не NULL = проект заблокирован (не хватает баланса на ближайшие N лидов).
+    preflight_blocked_at            TIMESTAMPTZ NULL,
     UNIQUE (tenant_id, name),
     CONSTRAINT chk_projects_daily_limit_positive
         CHECK (daily_limit_target > 0),
@@ -886,6 +894,8 @@ CREATE INDEX idx_projects_tenant_signal
 CREATE INDEX idx_projects_regions ON projects USING GIN (regions);
 -- v8.38: индекс для SupplierSnapshotGuard grace-проверки.
 CREATE INDEX projects_paused_at_idx ON projects(paused_at);
+-- v8.35: частичный индекс для preflight-блокировки (sparse — большинство проектов не заблокированы)
+CREATE INDEX projects_preflight_blocked_idx ON projects (preflight_blocked_at) WHERE preflight_blocked_at IS NOT NULL;
 
 COMMENT ON COLUMN projects.daily_limit_target IS
     'Целевой дневной лимит лидов, заданный клиентом. Фактический лимит на '
@@ -3325,6 +3335,49 @@ ALTER TABLE lead_charges
     DEFERRABLE INITIALLY DEFERRED;
 
 
+-- =============================================================================
+-- balance_freeze_log — журнал заморозок/разморозок тенантов по балансу
+-- (Billing v2 Spec C, v8.35). INSERT-only: записи не обновляются.
+-- =============================================================================
+CREATE TABLE IF NOT EXISTS balance_freeze_log (
+    id                   BIGSERIAL PRIMARY KEY,
+    tenant_id            BIGINT NOT NULL REFERENCES tenants(id),
+    event_type           VARCHAR(30) NOT NULL,
+    triggered_by         VARCHAR(30) NOT NULL,
+    balance_rub_at_event DECIMAL(12,2) NOT NULL,
+    required_leads       INTEGER NOT NULL,
+    capacity_leads       INTEGER NOT NULL,
+    total_daily_limit    INTEGER NOT NULL,
+    details              JSONB,
+    created_at           TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+ALTER TABLE balance_freeze_log ENABLE ROW LEVEL SECURITY;
+CREATE POLICY tenant_isolation ON balance_freeze_log
+    USING (tenant_id = current_setting('app.current_tenant_id', true)::bigint);
+
+CREATE INDEX balance_freeze_log_tenant_idx ON balance_freeze_log (tenant_id, created_at DESC);
+
+DO $$
+BEGIN
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_app_user') THEN
+        GRANT SELECT, INSERT ON balance_freeze_log TO crm_app_user;
+        GRANT USAGE, SELECT ON SEQUENCE balance_freeze_log_id_seq TO crm_app_user;
+    END IF;
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_supplier_worker') THEN
+        GRANT SELECT, INSERT ON balance_freeze_log TO crm_supplier_worker;
+        GRANT USAGE, SELECT ON SEQUENCE balance_freeze_log_id_seq TO crm_supplier_worker;
+    END IF;
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_migrator') THEN
+        GRANT SELECT, INSERT ON balance_freeze_log TO crm_migrator;
+        GRANT USAGE, SELECT ON SEQUENCE balance_freeze_log_id_seq TO crm_migrator;
+    END IF;
+    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'crm_app_admin') THEN
+        GRANT SELECT, INSERT ON balance_freeze_log TO crm_app_admin;
+        GRANT USAGE, SELECT ON SEQUENCE balance_freeze_log_id_seq TO crm_app_admin;
+    END IF;
+END $$;
+
 -- =============================================================================
 -- КОНЕЦ schema.sql
 -- =============================================================================

From 7332387c19e371766cc00fff676c0438252c4837 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <donnalee11681676@gmail.com>
Date: Sun, 24 May 2026 11:50:58 +0300
Subject: [PATCH 03/13] =?UTF-8?q?feat(billing-v2-c):=20BalancePreflightSer?=
 =?UTF-8?q?vice=20=E2=80=94=20pure-=D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D1=80?=
 =?UTF-8?q?=D0=BA=D0=B0=20=D0=BF=D0=BB=D0=B0=D1=82=D1=91=D0=B6=D0=B5=D1=81?=
 =?UTF-8?q?=D0=BF=D0=BE=D1=81=D0=BE=D0=B1=D0=BD=D0=BE=D1=81=D1=82=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Task 1.2 Спека C. evaluate(balanceRub, deliveredInMonth, requiredLeads, tiers) →
PreflightResult{passes, requiredLeads, capacityLeads, deficitLeads}. Сравнение в
лидах через BalanceToLeadsConverter::convert (7 ступеней + месячный объём).
3 unit-теста GREEN. Pint passed.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 .../Billing/BalancePreflightService.php       | 49 +++++++++++++++++
 app/app/Services/Billing/PreflightResult.php  | 20 +++++++
 .../Billing/BalancePreflightServiceTest.php   | 52 +++++++++++++++++++
 3 files changed, 121 insertions(+)
 create mode 100644 app/app/Services/Billing/BalancePreflightService.php
 create mode 100644 app/app/Services/Billing/PreflightResult.php
 create mode 100644 app/tests/Unit/Billing/BalancePreflightServiceTest.php

diff --git a/app/app/Services/Billing/BalancePreflightService.php b/app/app/Services/Billing/BalancePreflightService.php
new file mode 100644
index 00000000..b56249f1
--- /dev/null
+++ b/app/app/Services/Billing/BalancePreflightService.php
@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\Billing;
+
+use App\Models\PricingTier;
+use Illuminate\Database\Eloquent\Collection;
+
+/**
+ * Pure: проходит ли клиент преfflight — хватает ли баланса на ПОЛНЫЙ дневной
+ * лимит всех его eligible-проектов по текущему тарифу.
+ *
+ * Сравнение в ЛИДАХ (capacity vs required), не в рублях — переиспользует
+ * BalanceToLeadsConverter::convert, который учитывает 7 ступеней и накопленный
+ * месячный объём (deliveredInMonth).
+ *
+ * Spec: docs/superpowers/specs/2026-05-24-billing-v2-spec-c-preflight-vtb-design.md §3.3
+ */
+final class BalancePreflightService
+{
+    public function __construct(
+        private readonly BalanceToLeadsConverter $converter = new BalanceToLeadsConverter,
+    ) {}
+
+    /**
+     * @param  Collection<int, PricingTier>  $tiers
+     */
+    public function evaluate(
+        string $balanceRub,
+        int $deliveredInMonth,
+        int $requiredLeads,
+        Collection $tiers,
+    ): PreflightResult {
+        if ($requiredLeads <= 0) {
+            return new PreflightResult(true, 0, 0, 0);
+        }
+
+        $capacity = (int) $this->converter->convert($balanceRub, $deliveredInMonth, $tiers)['leads'];
+        $passes = $capacity >= $requiredLeads;
+
+        return new PreflightResult(
+            passes: $passes,
+            requiredLeads: $requiredLeads,
+            capacityLeads: $capacity,
+            deficitLeads: $passes ? 0 : ($requiredLeads - $capacity),
+        );
+    }
+}
diff --git a/app/app/Services/Billing/PreflightResult.php b/app/app/Services/Billing/PreflightResult.php
new file mode 100644
index 00000000..eb99899e
--- /dev/null
+++ b/app/app/Services/Billing/PreflightResult.php
@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\Billing;
+
+/**
+ * Результат преfflight-проверки платёжеспособности тенанта (Billing v2 Spec C).
+ *
+ * Spec: docs/superpowers/specs/2026-05-24-billing-v2-spec-c-preflight-vtb-design.md §3.3
+ */
+final class PreflightResult
+{
+    public function __construct(
+        public readonly bool $passes,
+        public readonly int $requiredLeads,
+        public readonly int $capacityLeads,
+        public readonly int $deficitLeads,
+    ) {}
+}
diff --git a/app/tests/Unit/Billing/BalancePreflightServiceTest.php b/app/tests/Unit/Billing/BalancePreflightServiceTest.php
new file mode 100644
index 00000000..e08b8c39
--- /dev/null
+++ b/app/tests/Unit/Billing/BalancePreflightServiceTest.php
@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\PricingTier;
+use App\Services\Billing\BalancePreflightService;
+use Illuminate\Database\Eloquent\Collection;
+
+function makeTiers(): Collection
+{
+    // 1 ступень: цена 50₽/лид (5000 копеек), безлимитная.
+    return new Collection([
+        new PricingTier(['tier_no' => 1, 'leads_in_tier' => null, 'price_per_lead_kopecks' => 5000, 'is_active' => true]),
+    ]);
+}
+
+it('passes when balance covers full daily limit', function () {
+    $service = new BalancePreflightService;
+    // 2000₽ / 50₽ = 40 лидов capacity; нужно 30 → проходит.
+    $result = $service->evaluate(
+        balanceRub: '2000.00',
+        deliveredInMonth: 0,
+        requiredLeads: 30,
+        tiers: makeTiers(),
+    );
+
+    expect($result->passes)->toBeTrue();
+    expect($result->capacityLeads)->toBe(40);
+    expect($result->requiredLeads)->toBe(30);
+    expect($result->deficitLeads)->toBe(0);
+});
+
+it('fails when balance below full daily limit', function () {
+    $service = new BalancePreflightService;
+    // 1000₽ / 50₽ = 20 лидов capacity; нужно 30 → не проходит, дефицит 10.
+    $result = $service->evaluate(
+        balanceRub: '1000.00',
+        deliveredInMonth: 0,
+        requiredLeads: 30,
+        tiers: makeTiers(),
+    );
+
+    expect($result->passes)->toBeFalse();
+    expect($result->capacityLeads)->toBe(20);
+    expect($result->deficitLeads)->toBe(10);
+});
+
+it('passes trivially when requiredLeads is zero', function () {
+    $service = new BalancePreflightService;
+    $result = $service->evaluate('0.00', 0, 0, makeTiers());
+    expect($result->passes)->toBeTrue();
+});

From b1c3f39e3854027f67c72ba747225224474ec311 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <donnalee11681676@gmail.com>
Date: Sun, 24 May 2026 11:54:18 +0300
Subject: [PATCH 04/13] =?UTF-8?q?feat(billing-v2-c):=20Tenant::requiredLea?=
 =?UTF-8?q?dsForTomorrow=20+=20cast=20=D1=84=D0=BB=D0=B0=D0=B3=D0=BE=D0=B2?=
 =?UTF-8?q?=20=D0=B7=D0=B0=D0=BC=D0=BE=D1=80=D0=BE=D0=B7=D0=BA=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Task 1.3 Спека C. Tenant: +frozen_by_balance_at (fillable+cast datetime) +
requiredLeadsForTomorrow() (sum daily_limit_target активных проектов). Project:
+preflight_blocked_at (fillable+cast). NB: фильтр по is_active (boolean) +
daily_limit_target — у projects нет колонок status/daily_limit (план поправлен
под факт схемы). 3 теста GREEN.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 app/app/Models/Project.php                    |  4 +++
 app/app/Models/Tenant.php                     | 16 ++++++++++++
 .../Feature/Billing/TenantPreflightTest.php   | 26 +++++++++++++++++++
 3 files changed, 46 insertions(+)
 create mode 100644 app/tests/Feature/Billing/TenantPreflightTest.php

diff --git a/app/app/Models/Project.php b/app/app/Models/Project.php
index a5de4e22..e4ec8410 100644
--- a/app/app/Models/Project.php
+++ b/app/app/Models/Project.php
@@ -64,6 +64,8 @@ class Project extends Model
         // Plan 2/5 Task 1 (schema v8.18): дневной счётчик доставленных лидов
         // (сбрасывается cron'ом в 00:00 МСК, используется LeadRouter'ом).
         'delivered_today',
+        // Billing v2 Spec C: флаг точечной блокировки проекта по преfflight (NULL = не заблокирован).
+        'preflight_blocked_at',
     ];
 
     protected function casts(): array
@@ -81,6 +83,8 @@ class Project extends Model
             'delivery_days_mask' => 'integer',
             'ttfr_target_minutes' => 'integer',
             'effective_limit_calculated_at' => 'datetime',
+            // Billing v2 Spec C: флаг преfflight-блокировки проекта.
+            'preflight_blocked_at' => 'datetime',
             'created_at' => 'datetime',
             'updated_at' => 'datetime',
             // Supplier integration:
diff --git a/app/app/Models/Tenant.php b/app/app/Models/Tenant.php
index ba11587a..a0b4528b 100644
--- a/app/app/Models/Tenant.php
+++ b/app/app/Models/Tenant.php
@@ -44,6 +44,7 @@ class Tenant extends Model
         'delivered_in_month',
         'api_key_limit',
         'limits',
+        'frozen_by_balance_at',
     ];
 
     protected function casts(): array
@@ -61,6 +62,8 @@ class Tenant extends Model
             'limits' => 'array',
             'last_activity_at' => 'datetime',
             'last_webhook_at' => 'datetime',
+            // Billing v2 Spec C: флаг заморозки по балансу (NULL = не заморожен).
+            'frozen_by_balance_at' => 'datetime',
             'created_at' => 'datetime',
             'updated_at' => 'datetime',
             'deleted_at' => 'datetime',
@@ -79,6 +82,19 @@ class Tenant extends Model
         return $this->hasMany(Project::class);
     }
 
+    /**
+     * Сумма daily_limit_target активных проектов — «сколько лидов клиент хочет в день».
+     * Используется преfflight'ом (Billing v2 Spec C §3.3) как requiredLeads.
+     *
+     * NB: фильтр по `is_active` (boolean), не `status` — у projects нет колонки status.
+     */
+    public function requiredLeadsForTomorrow(): int
+    {
+        return (int) $this->projects()
+            ->where('is_active', true)
+            ->sum('daily_limit_target');
+    }
+
     /** @return BelongsTo<TariffPlan, $this> */
     public function tariff(): BelongsTo
     {
diff --git a/app/tests/Feature/Billing/TenantPreflightTest.php b/app/tests/Feature/Billing/TenantPreflightTest.php
new file mode 100644
index 00000000..269aec53
--- /dev/null
+++ b/app/tests/Feature/Billing/TenantPreflightTest.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\Project;
+use App\Models\Tenant;
+use Illuminate\Support\Carbon;
+
+it('sums daily_limit_target of active projects for required leads', function () {
+    $tenant = Tenant::factory()->create(['balance_rub' => '1000.00']);
+    Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 10]);
+    Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 15]);
+    Project::factory()->for($tenant)->create(['is_active' => false, 'daily_limit_target' => 100]); // не считается
+
+    expect($tenant->requiredLeadsForTomorrow())->toBe(25);
+});
+
+it('casts frozen_by_balance_at to datetime', function () {
+    $tenant = Tenant::factory()->create(['frozen_by_balance_at' => now()]);
+    expect($tenant->frozen_by_balance_at)->toBeInstanceOf(Carbon::class);
+});
+
+it('casts project preflight_blocked_at to datetime', function () {
+    $project = Project::factory()->create(['preflight_blocked_at' => now()]);
+    expect($project->preflight_blocked_at)->toBeInstanceOf(Carbon::class);
+});

From 53f902065382de0d45d42c3cea3d7fc85f355935 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <donnalee11681676@gmail.com>
Date: Sun, 24 May 2026 12:00:56 +0300
Subject: [PATCH 05/13] =?UTF-8?q?feat(billing-v2-c):=20sweep-job=20=D0=B7?=
 =?UTF-8?q?=D0=B0=D0=BC=D0=BE=D1=80=D0=BE=D0=B7=D0=BA=D0=B8=20+=204=20mail?=
 =?UTF-8?q?able=20+=20cron=2018:00=20MSK?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Task 1.4+1.5 Спека C. BalancePreflightSweepJob (chunkById всех тенантов,
переход active->frozen / frozen->active, идемпотентность, журнал balance_freeze_log
через pgsql_supplier) + BillingPreflightSweepCommand + cron billing:preflight-sweep
@18:00 MSK (SyncSupplierProjectsJob сдвинут 18:00->18:05). 4 Mailable
(Frozen/Reminder/Final/Unfrozen) + blade. Job шлёт Frozen/Unfrozen при переходах;
Reminder/Final (T+24h/T+72h) — классы готовы, рассылка по дате — следующий шаг.
11 Phase 1 billing-тестов GREEN. Адаптации под факт схемы: contact_email (не email),
organization_name (не name), is_active+daily_limit_target (не status+daily_limit).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 .../Commands/BillingPreflightSweepCommand.php | 23 +++++
 .../Jobs/Billing/BalancePreflightSweepJob.php | 99 +++++++++++++++++++
 app/app/Mail/BalanceFrozenFinalMail.php       | 41 ++++++++
 app/app/Mail/BalanceFrozenMail.php            | 42 ++++++++
 app/app/Mail/BalanceFrozenReminderMail.php    | 40 ++++++++
 app/app/Mail/BalanceUnfrozenMail.php          | 42 ++++++++
 .../views/emails/balance_frozen.blade.php     | 12 +++
 .../emails/balance_frozen_final.blade.php     | 11 +++
 .../emails/balance_frozen_reminder.blade.php  | 10 ++
 .../views/emails/balance_unfrozen.blade.php   | 10 ++
 app/routes/console.php                        | 14 ++-
 .../Feature/Billing/BalanceFreezeMailTest.php | 29 ++++++
 .../Billing/BalancePreflightSweepJobTest.php  | 62 ++++++++++++
 13 files changed, 434 insertions(+), 1 deletion(-)
 create mode 100644 app/app/Console/Commands/BillingPreflightSweepCommand.php
 create mode 100644 app/app/Jobs/Billing/BalancePreflightSweepJob.php
 create mode 100644 app/app/Mail/BalanceFrozenFinalMail.php
 create mode 100644 app/app/Mail/BalanceFrozenMail.php
 create mode 100644 app/app/Mail/BalanceFrozenReminderMail.php
 create mode 100644 app/app/Mail/BalanceUnfrozenMail.php
 create mode 100644 app/resources/views/emails/balance_frozen.blade.php
 create mode 100644 app/resources/views/emails/balance_frozen_final.blade.php
 create mode 100644 app/resources/views/emails/balance_frozen_reminder.blade.php
 create mode 100644 app/resources/views/emails/balance_unfrozen.blade.php
 create mode 100644 app/tests/Feature/Billing/BalanceFreezeMailTest.php
 create mode 100644 app/tests/Feature/Billing/BalancePreflightSweepJobTest.php

diff --git a/app/app/Console/Commands/BillingPreflightSweepCommand.php b/app/app/Console/Commands/BillingPreflightSweepCommand.php
new file mode 100644
index 00000000..a347f528
--- /dev/null
+++ b/app/app/Console/Commands/BillingPreflightSweepCommand.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Jobs\Billing\BalancePreflightSweepJob;
+use Illuminate\Console\Command;
+
+final class BillingPreflightSweepCommand extends Command
+{
+    protected $signature = 'billing:preflight-sweep';
+
+    protected $description = 'Ежедневный преfflight баланса — заморозка/разморозка тенантов (cut-off 18:00 MSK)';
+
+    public function handle(): int
+    {
+        (new BalancePreflightSweepJob)->handle();
+        $this->info('Преfflight sweep завершён.');
+
+        return self::SUCCESS;
+    }
+}
diff --git a/app/app/Jobs/Billing/BalancePreflightSweepJob.php b/app/app/Jobs/Billing/BalancePreflightSweepJob.php
new file mode 100644
index 00000000..b5aca412
--- /dev/null
+++ b/app/app/Jobs/Billing/BalancePreflightSweepJob.php
@@ -0,0 +1,99 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Jobs\Billing;
+
+use App\Mail\BalanceFrozenMail;
+use App\Mail\BalanceUnfrozenMail;
+use App\Models\PricingTier;
+use App\Models\Tenant;
+use App\Services\Billing\BalancePreflightService;
+use App\Services\Billing\PreflightResult;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Database\Eloquent\Collection;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Mail;
+
+/**
+ * Ежедневный преfflight всех тенантов перед формированием заказа поставщику.
+ * Запускается cron @18:00 MSK (routes/console.php). См. спек §3.5, §5.2.
+ *
+ * NB: бегает без tenant-RLS (системный контекст); запросы к projects/tenants
+ * явные по tenant_id (урок Спека B). Переход active→frozen / frozen→active
+ * шлёт письмо; стабильное состояние не трогается (идемпотентность).
+ */
+final class BalancePreflightSweepJob implements ShouldQueue
+{
+    use Dispatchable;
+    use InteractsWithQueue;
+    use Queueable;
+
+    public function handle(): void
+    {
+        $service = new BalancePreflightService;
+        $tiers = PricingTier::query()->where('is_active', true)->get();
+
+        Tenant::query()->whereNull('deleted_at')->chunkById(200, function (Collection $tenants) use ($service, $tiers): void {
+            foreach ($tenants as $tenant) {
+                /** @var Tenant $tenant */
+                $this->evaluateTenant($tenant, $service, $tiers);
+            }
+        });
+    }
+
+    /**
+     * @param  Collection<int, PricingTier>  $tiers
+     */
+    private function evaluateTenant(Tenant $tenant, BalancePreflightService $service, Collection $tiers): void
+    {
+        $required = $tenant->requiredLeadsForTomorrow();
+        $result = $service->evaluate(
+            balanceRub: (string) $tenant->balance_rub,
+            deliveredInMonth: (int) $tenant->delivered_in_month,
+            requiredLeads: $required,
+            tiers: $tiers,
+        );
+
+        $isFrozen = $tenant->frozen_by_balance_at !== null;
+
+        // Переход active → frozen.
+        if (! $result->passes && ! $isFrozen) {
+            $tenant->frozen_by_balance_at = now();
+            $tenant->save();
+            $this->logEvent($tenant, 'frozen', 'cutoff_18msk', $result);
+            Mail::queue(new BalanceFrozenMail($tenant, $result));
+
+            return;
+        }
+
+        // Переход frozen → active.
+        if ($result->passes && $isFrozen) {
+            $tenant->frozen_by_balance_at = null;
+            $tenant->save();
+            $this->logEvent($tenant, 'unfrozen', 'cutoff_18msk', $result);
+            Mail::queue(new BalanceUnfrozenMail($tenant, $result));
+
+            return;
+        }
+        // Иначе состояние не изменилось — ничего не делаем (идемпотентность).
+    }
+
+    private function logEvent(Tenant $tenant, string $event, string $trigger, PreflightResult $result): void
+    {
+        DB::connection('pgsql_supplier')->table('balance_freeze_log')->insert([
+            'tenant_id' => $tenant->id,
+            'event_type' => $event,
+            'triggered_by' => $trigger,
+            'balance_rub_at_event' => $tenant->balance_rub,
+            'required_leads' => $result->requiredLeads,
+            'capacity_leads' => $result->capacityLeads,
+            'total_daily_limit' => $result->requiredLeads,
+            'details' => json_encode(['deficit_leads' => $result->deficitLeads]),
+            'created_at' => now(),
+        ]);
+    }
+}
diff --git a/app/app/Mail/BalanceFrozenFinalMail.php b/app/app/Mail/BalanceFrozenFinalMail.php
new file mode 100644
index 00000000..502eacf5
--- /dev/null
+++ b/app/app/Mail/BalanceFrozenFinalMail.php
@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Mail;
+
+use App\Models\Tenant;
+use App\Services\Billing\PreflightResult;
+use Illuminate\Bus\Queueable;
+use Illuminate\Mail\Mailable;
+use Illuminate\Mail\Mailables\Content;
+use Illuminate\Mail\Mailables\Envelope;
+use Illuminate\Queue\SerializesModels;
+
+/**
+ * Финальное письмо: приём лидов приостановлен 3 дня (Billing v2 Spec C §3.7, T+72h).
+ * После него повторов нет до следующего цикла заморозки.
+ */
+final class BalanceFrozenFinalMail extends Mailable
+{
+    use Queueable;
+    use SerializesModels;
+
+    public function __construct(
+        public readonly Tenant $tenant,
+        public readonly PreflightResult $result,
+    ) {}
+
+    public function envelope(): Envelope
+    {
+        return new Envelope(
+            subject: 'Приём лидов приостановлен 3 дня',
+            to: [$this->tenant->contact_email],
+        );
+    }
+
+    public function content(): Content
+    {
+        return new Content(view: 'emails.balance_frozen_final');
+    }
+}
diff --git a/app/app/Mail/BalanceFrozenMail.php b/app/app/Mail/BalanceFrozenMail.php
new file mode 100644
index 00000000..68eb2b3a
--- /dev/null
+++ b/app/app/Mail/BalanceFrozenMail.php
@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Mail;
+
+use App\Models\Tenant;
+use App\Services\Billing\PreflightResult;
+use Illuminate\Bus\Queueable;
+use Illuminate\Mail\Mailable;
+use Illuminate\Mail\Mailables\Content;
+use Illuminate\Mail\Mailables\Envelope;
+use Illuminate\Queue\SerializesModels;
+
+/**
+ * Письмо клиенту: приём лидов приостановлен из-за нехватки баланса (Billing v2 Spec C §3.7).
+ *
+ * Триггер: BalancePreflightSweepJob при переходе тенанта active → frozen (cut-off 18:00 MSK).
+ */
+final class BalanceFrozenMail extends Mailable
+{
+    use Queueable;
+    use SerializesModels;
+
+    public function __construct(
+        public readonly Tenant $tenant,
+        public readonly PreflightResult $result,
+    ) {}
+
+    public function envelope(): Envelope
+    {
+        return new Envelope(
+            subject: 'Приём лидов приостановлен — недостаточно баланса',
+            to: [$this->tenant->contact_email],
+        );
+    }
+
+    public function content(): Content
+    {
+        return new Content(view: 'emails.balance_frozen');
+    }
+}
diff --git a/app/app/Mail/BalanceFrozenReminderMail.php b/app/app/Mail/BalanceFrozenReminderMail.php
new file mode 100644
index 00000000..0354ba7c
--- /dev/null
+++ b/app/app/Mail/BalanceFrozenReminderMail.php
@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Mail;
+
+use App\Models\Tenant;
+use App\Services\Billing\PreflightResult;
+use Illuminate\Bus\Queueable;
+use Illuminate\Mail\Mailable;
+use Illuminate\Mail\Mailables\Content;
+use Illuminate\Mail\Mailables\Envelope;
+use Illuminate\Queue\SerializesModels;
+
+/**
+ * Письмо-напоминание: приём лидов всё ещё приостановлен (Billing v2 Spec C §3.7, T+24h).
+ */
+final class BalanceFrozenReminderMail extends Mailable
+{
+    use Queueable;
+    use SerializesModels;
+
+    public function __construct(
+        public readonly Tenant $tenant,
+        public readonly PreflightResult $result,
+    ) {}
+
+    public function envelope(): Envelope
+    {
+        return new Envelope(
+            subject: 'Приём лидов всё ещё приостановлен',
+            to: [$this->tenant->contact_email],
+        );
+    }
+
+    public function content(): Content
+    {
+        return new Content(view: 'emails.balance_frozen_reminder');
+    }
+}
diff --git a/app/app/Mail/BalanceUnfrozenMail.php b/app/app/Mail/BalanceUnfrozenMail.php
new file mode 100644
index 00000000..c3080b61
--- /dev/null
+++ b/app/app/Mail/BalanceUnfrozenMail.php
@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Mail;
+
+use App\Models\Tenant;
+use App\Services\Billing\PreflightResult;
+use Illuminate\Bus\Queueable;
+use Illuminate\Mail\Mailable;
+use Illuminate\Mail\Mailables\Content;
+use Illuminate\Mail\Mailables\Envelope;
+use Illuminate\Queue\SerializesModels;
+
+/**
+ * Письмо клиенту: приём лидов возобновлён (Billing v2 Spec C §3.7).
+ *
+ * Триггер: BalancePreflightSweepJob при переходе frozen → active (пополнение/снижение лимита).
+ */
+final class BalanceUnfrozenMail extends Mailable
+{
+    use Queueable;
+    use SerializesModels;
+
+    public function __construct(
+        public readonly Tenant $tenant,
+        public readonly PreflightResult $result,
+    ) {}
+
+    public function envelope(): Envelope
+    {
+        return new Envelope(
+            subject: 'Приём лидов возобновлён',
+            to: [$this->tenant->contact_email],
+        );
+    }
+
+    public function content(): Content
+    {
+        return new Content(view: 'emails.balance_unfrozen');
+    }
+}
diff --git a/app/resources/views/emails/balance_frozen.blade.php b/app/resources/views/emails/balance_frozen.blade.php
new file mode 100644
index 00000000..d02b2987
--- /dev/null
+++ b/app/resources/views/emails/balance_frozen.blade.php
@@ -0,0 +1,12 @@
+Здравствуйте, {{ $tenant->organization_name }}!
+
+Приём лидов по вашим проектам приостановлен — на счёте недостаточно средств
+на завтрашний дневной заказ.
+
+Сейчас баланса хватает на {{ $result->capacityLeads }} лидов, а ваши проекты
+заказывают {{ $result->requiredLeads }} лидов в день. Не хватает: {{ $result->deficitLeads }} лидов.
+
+Чтобы возобновить приём, пополните счёт или уменьшите дневные лимиты проектов
+до 18:00 по московскому времени.
+
+С уважением, команда Лидерра.
diff --git a/app/resources/views/emails/balance_frozen_final.blade.php b/app/resources/views/emails/balance_frozen_final.blade.php
new file mode 100644
index 00000000..f6e6d07e
--- /dev/null
+++ b/app/resources/views/emails/balance_frozen_final.blade.php
@@ -0,0 +1,11 @@
+Здравствуйте, {{ $tenant->organization_name }}!
+
+Приём лидов по вашим проектам приостановлен уже 3 дня из-за нехватки баланса.
+Это последнее напоминание.
+
+Баланса хватает на {{ $result->capacityLeads }} лидов, проекты заказывают
+{{ $result->requiredLeads }} в день. Не хватает: {{ $result->deficitLeads }} лидов.
+
+Чтобы возобновить приём — пополните счёт или уменьшите лимиты проектов.
+
+С уважением, команда Лидерра.
diff --git a/app/resources/views/emails/balance_frozen_reminder.blade.php b/app/resources/views/emails/balance_frozen_reminder.blade.php
new file mode 100644
index 00000000..8041c6c6
--- /dev/null
+++ b/app/resources/views/emails/balance_frozen_reminder.blade.php
@@ -0,0 +1,10 @@
+Здравствуйте, {{ $tenant->organization_name }}!
+
+Напоминаем: приём лидов по вашим проектам всё ещё приостановлен из-за нехватки баланса.
+
+Баланса хватает на {{ $result->capacityLeads }} лидов, проекты заказывают
+{{ $result->requiredLeads }} в день. Не хватает: {{ $result->deficitLeads }} лидов.
+
+Пополните счёт или уменьшите лимиты до 18:00 МСК, чтобы возобновить приём.
+
+С уважением, команда Лидерра.
diff --git a/app/resources/views/emails/balance_unfrozen.blade.php b/app/resources/views/emails/balance_unfrozen.blade.php
new file mode 100644
index 00000000..02fc32c3
--- /dev/null
+++ b/app/resources/views/emails/balance_unfrozen.blade.php
@@ -0,0 +1,10 @@
+Здравствуйте, {{ $tenant->organization_name }}!
+
+Приём лидов по вашим проектам возобновлён — баланса снова хватает на дневной заказ.
+
+Текущий запас: {{ $result->capacityLeads }} лидов, проекты заказывают
+{{ $result->requiredLeads }} в день.
+
+Заказ поставщику будет сформирован в ближайшем вечернем цикле (18:00 МСК).
+
+С уважением, команда Лидерра.
diff --git a/app/routes/console.php b/app/routes/console.php
index 752fa17a..e1cdd359 100644
--- a/app/routes/console.php
+++ b/app/routes/console.php
@@ -64,6 +64,16 @@ Schedule::command('partitions:drop-expired')
     ->onSuccess(fn () => $hb->recordRunResult('partitions:drop-expired', true, null, null))
     ->onFailure(fn () => $hb->recordRunResult('partitions:drop-expired', false, 'Command failed', null));
 
+// Billing v2 Spec C §3.2: преfflight баланса в 18:00 MSK — заморозка/разморозка
+// тенантов перед формированием заказа поставщику (без «бедных» клиентов).
+// ВАЖНО: идёт ДО SyncSupplierProjectsJob (сдвинут на 18:05) — фильтр frozen-проектов
+// должен примениться к расчёту заказа того же вечера.
+Schedule::command('billing:preflight-sweep')
+    ->dailyAt('18:00')
+    ->timezone('Europe/Moscow')
+    ->onSuccess(fn () => $hb->recordRunResult('billing:preflight-sweep', true, null, null))
+    ->onFailure(fn () => $hb->recordRunResult('billing:preflight-sweep', false, 'Command failed', null));
+
 // Plan 3 Task 8: 5 Schedule entries для supplier-flow.
 //
 // NB: ->onOneServer() требует cache_locks таблицу, которой у нас нет
@@ -83,8 +93,10 @@ Schedule::job(new RefreshSupplierSessionJob)
     ->timezone('Europe/Moscow')
     ->onSuccess(fn () => $hb->recordRunResult('App\Jobs\Supplier\RefreshSupplierSessionJob@daily', true, null, null))
     ->onFailure(fn () => $hb->recordRunResult('App\Jobs\Supplier\RefreshSupplierSessionJob@daily', false, 'Job failed', null));
+// Billing v2 Spec C: сдвинут 18:00 → 18:05, чтобы billing:preflight-sweep (18:00)
+// успел проставить frozen-флаги до формирования заказа поставщику.
 Schedule::job(new SyncSupplierProjectsJob)
-    ->dailyAt('18:00')
+    ->dailyAt('18:05')
     ->timezone('Europe/Moscow')
     ->onSuccess(fn () => $hb->recordRunResult('App\Jobs\Supplier\SyncSupplierProjectsJob', true, null, null))
     ->onFailure(fn () => $hb->recordRunResult('App\Jobs\Supplier\SyncSupplierProjectsJob', false, 'Job failed', null));
diff --git a/app/tests/Feature/Billing/BalanceFreezeMailTest.php b/app/tests/Feature/Billing/BalanceFreezeMailTest.php
new file mode 100644
index 00000000..e6151fd7
--- /dev/null
+++ b/app/tests/Feature/Billing/BalanceFreezeMailTest.php
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Mail\BalanceFrozenMail;
+use App\Mail\BalanceUnfrozenMail;
+use App\Models\Tenant;
+use App\Services\Billing\PreflightResult;
+
+it('renders frozen mail with deficit', function () {
+    $tenant = Tenant::factory()->create(['organization_name' => 'ООО Альфа']);
+    $result = new PreflightResult(false, 30, 20, 10);
+
+    $rendered = (new BalanceFrozenMail($tenant, $result))->render();
+
+    expect($rendered)->toContain('приостановлен');
+    expect($rendered)->toContain('10'); // дефицит лидов
+    expect($rendered)->toContain('ООО Альфа');
+});
+
+it('renders unfrozen mail', function () {
+    $tenant = Tenant::factory()->create(['organization_name' => 'ООО Бета']);
+    $result = new PreflightResult(true, 25, 40, 0);
+
+    $rendered = (new BalanceUnfrozenMail($tenant, $result))->render();
+
+    expect($rendered)->toContain('возобновлён');
+    expect($rendered)->toContain('ООО Бета');
+});
diff --git a/app/tests/Feature/Billing/BalancePreflightSweepJobTest.php b/app/tests/Feature/Billing/BalancePreflightSweepJobTest.php
new file mode 100644
index 00000000..c992921f
--- /dev/null
+++ b/app/tests/Feature/Billing/BalancePreflightSweepJobTest.php
@@ -0,0 +1,62 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Jobs\Billing\BalancePreflightSweepJob;
+use App\Mail\BalanceFrozenMail;
+use App\Models\PricingTier;
+use App\Models\Project;
+use App\Models\Tenant;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Mail;
+use Tests\Concerns\SharesSupplierPdo;
+
+// Изоляция: liderra_testing persistent (RefreshDatabase off). DatabaseTransactions
+// откатывает default-pgsql после каждого теста; SharesSupplierPdo делает pgsql_supplier
+// общим PDO с pgsql — иначе job-запись balance_freeze_log (pgsql_supplier) не видит
+// незакоммиченного tenant и падает на FK (паттерн Спека B / AutoPauseFlowTest).
+uses(DatabaseTransactions::class);
+uses(SharesSupplierPdo::class);
+
+beforeEach(function () {
+    // RLS-контекст (системный tenant 0) — паттерн supplier-тестов.
+    DB::statement("SELECT set_config('app.current_tenant_id', '0', true)");
+    PricingTier::query()->create(['tier_no' => 1, 'leads_in_tier' => null, 'price_per_lead_kopecks' => 5000, 'is_active' => true, 'effective_from' => now()]);
+});
+
+it('freezes tenant whose balance no longer covers daily limit', function () {
+    Mail::fake();
+    // 500₽ / 50₽ = 10 лидов; проекты хотят 25 → заморозка.
+    $tenant = Tenant::factory()->create(['balance_rub' => '500.00', 'frozen_by_balance_at' => null]);
+    Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 25]);
+
+    (new BalancePreflightSweepJob)->handle();
+
+    expect($tenant->fresh()->frozen_by_balance_at)->not->toBeNull();
+    Mail::assertQueued(BalanceFrozenMail::class);
+});
+
+it('unfreezes tenant whose balance now covers daily limit', function () {
+    Mail::fake();
+    // 2000₽ / 50₽ = 40 лидов; хотят 25 → разморозка.
+    $tenant = Tenant::factory()->create(['balance_rub' => '2000.00', 'frozen_by_balance_at' => now()->subDay()]);
+    Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 25]);
+
+    (new BalancePreflightSweepJob)->handle();
+
+    expect($tenant->fresh()->frozen_by_balance_at)->toBeNull();
+});
+
+it('is idempotent — does not re-freeze already frozen tenant', function () {
+    Mail::fake();
+    $frozenAt = now()->subDay();
+    $tenant = Tenant::factory()->create(['balance_rub' => '0.00', 'frozen_by_balance_at' => $frozenAt]);
+    Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 25]);
+
+    (new BalancePreflightSweepJob)->handle();
+
+    // Дата заморозки не перезаписана, повторного письма нет.
+    expect($tenant->fresh()->frozen_by_balance_at->timestamp)->toBe($frozenAt->timestamp);
+    Mail::assertNotQueued(BalanceFrozenMail::class);
+});

From d2ff39abc27c6d8029b3f9348fa544ede3e3f3ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <donnalee11681676@gmail.com>
Date: Sun, 24 May 2026 13:33:14 +0300
Subject: [PATCH 06/13] =?UTF-8?q?feat(billing-v2-c):=20SyncSupplierProject?=
 =?UTF-8?q?sJob=20=D0=B8=D1=81=D0=BA=D0=BB=D1=8E=D1=87=D0=B0=D0=B5=D1=82?=
 =?UTF-8?q?=20frozen-=D0=BF=D1=80=D0=BE=D0=B5=D0=BA=D1=82=D1=8B=20=D0=B8?=
 =?UTF-8?q?=D0=B7=20=D0=B7=D0=B0=D0=BA=D0=B0=D0=B7=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Task 1.8 Спека C. Выделен публичный метод collectEligibleProjects() в
SyncSupplierProjectsJob; добавлены 2 фильтра:
— projects.preflight_blocked_at IS NULL (точечная блокировка проекта);
— tenants.frozen_by_balance_at IS NULL (пассивная заморозка тенанта).

NB: whereIn-subquery вместо whereHas — relation whereHas строит query через
default pgsql, ломая cross-connection Project::on('pgsql_supplier'); subquery
с FROM 'tenants' наследует connection родителя.

SupplierScheduleTest: ожидание '0 18 * * *' -> '5 18 * * *' (сдвиг Sync на
18:05 из Task 1.4 — preflight @18:00 успевает проставить флаги до формирования
заказа).

2 теста preflight-filter GREEN. Pre-existing fails в SyncSupplierProjectJobTest
(singular — другой класс) — не моя регрессия (Mockery/regions/limits).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 .../Jobs/Supplier/SyncSupplierProjectsJob.php | 37 +++++++++++++---
 .../Feature/Schedule/SupplierScheduleTest.php |  6 ++-
 .../SyncSupplierPreflightFilterTest.php       | 42 +++++++++++++++++++
 3 files changed, 77 insertions(+), 8 deletions(-)
 create mode 100644 app/tests/Feature/Supplier/SyncSupplierPreflightFilterTest.php

diff --git a/app/app/Jobs/Supplier/SyncSupplierProjectsJob.php b/app/app/Jobs/Supplier/SyncSupplierProjectsJob.php
index 24189a32..ccd667f4 100644
--- a/app/app/Jobs/Supplier/SyncSupplierProjectsJob.php
+++ b/app/app/Jobs/Supplier/SyncSupplierProjectsJob.php
@@ -83,12 +83,8 @@ class SyncSupplierProjectsJob implements ShouldQueue
         $this->client = app(SupplierPortalClient::class);
         $consecutiveTransient = 0;
 
-        // 1. Load active Лидерра-projects via pgsql_supplier
-        /** @var Collection<int, Project> $projects */
-        $projects = Project::on(self::DB_CONNECTION)
-            ->where('is_active', true)
-            ->orderBy('id')
-            ->get();
+        // 1. Load active Лидерра-projects via pgsql_supplier (фильтруя frozen, Billing v2 Spec C §3.10).
+        $projects = $this->collectEligibleProjects();
 
         // 2. Group by (signal_type, identifier) — no subject_code split.
         // Portal constraint: one identifier = one B1/B2/B3 group (status=Doubles on duplicate name).
@@ -181,6 +177,35 @@ class SyncSupplierProjectsJob implements ShouldQueue
         }
     }
 
+    /**
+     * Собрать eligible Лидерра-проекты для расчёта заказа поставщику.
+     *
+     * Фильтры (Billing v2 Spec C §3.10 — преfflight баланса):
+     * — is_active = true (базовый);
+     * — preflight_blocked_at IS NULL (точечная блокировка проекта при «перегрузе» лимита);
+     * — tenant.frozen_by_balance_at IS NULL (пассивная заморозка тенанта по пустому балансу).
+     *
+     * Запрос через pgsql_supplier (BYPASSRLS) — джоб бегает в системном контексте.
+     * Метод публичный для unit-теста; никто из caller'ов кроме handle() его не зовёт.
+     *
+     * @return Collection<int, Project>
+     */
+    public function collectEligibleProjects(): Collection
+    {
+        // NB: whereIn-subquery вместо whereHas — whereHas строит relation-query
+        // через default Eloquent connection (pgsql), а наш родительский Project::on
+        // на pgsql_supplier; cross-connection JOIN ломал sync-тесты (8 fails).
+        // FROM 'tenants' внутри subquery наследует connection родителя.
+        return Project::on(self::DB_CONNECTION)
+            ->where('is_active', true)
+            ->whereNull('preflight_blocked_at')
+            ->whereIn('tenant_id', function ($q): void {
+                $q->select('id')->from('tenants')->whereNull('frozen_by_balance_at');
+            })
+            ->orderBy('id')
+            ->get();
+    }
+
     /**
      * @param  array{signal_type: string, identifier: string, merged_regions: list<int>, has_all_russia: bool, platforms: list<string>, projects: list<Project>}  $group
      */
diff --git a/app/tests/Feature/Schedule/SupplierScheduleTest.php b/app/tests/Feature/Schedule/SupplierScheduleTest.php
index 0513977b..3d8ddd45 100644
--- a/app/tests/Feature/Schedule/SupplierScheduleTest.php
+++ b/app/tests/Feature/Schedule/SupplierScheduleTest.php
@@ -12,7 +12,9 @@ use Illuminate\Console\Scheduling\Schedule;
  * Session refresh — на 15 мин раньше sync (17:45).
  */
 
-it('SyncSupplierProjectsJob is scheduled at 18:00 MSK', function (): void {
+it('SyncSupplierProjectsJob is scheduled at 18:05 MSK (after billing:preflight-sweep @18:00)', function (): void {
+    // Billing v2 Spec C §3.8: sync сдвинут с 18:00 на 18:05, чтобы
+    // billing:preflight-sweep (18:00) успел проставить frozen-флаги.
     $schedule = app(Schedule::class);
     $events = collect($schedule->events());
 
@@ -20,7 +22,7 @@ it('SyncSupplierProjectsJob is scheduled at 18:00 MSK', function (): void {
         || str_contains((string) $e->command, 'SyncSupplierProjectsJob'));
 
     expect($sync)->not->toBeNull();
-    expect($sync->expression)->toBe('0 18 * * *');
+    expect($sync->expression)->toBe('5 18 * * *');
     expect($sync->timezone)->toBe('Europe/Moscow');
 });
 
diff --git a/app/tests/Feature/Supplier/SyncSupplierPreflightFilterTest.php b/app/tests/Feature/Supplier/SyncSupplierPreflightFilterTest.php
new file mode 100644
index 00000000..edb45f2f
--- /dev/null
+++ b/app/tests/Feature/Supplier/SyncSupplierPreflightFilterTest.php
@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Jobs\Supplier\SyncSupplierProjectsJob;
+use App\Models\Project;
+use App\Models\Tenant;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Tests\Concerns\SharesSupplierPdo;
+
+// Изоляция: persistent liderra_testing, RefreshDatabase off. DatabaseTransactions
+// откатывает pgsql после теста; SharesSupplierPdo делает pgsql_supplier общим PDO
+// с pgsql, иначе query через Project::on('pgsql_supplier') не видит uncommitted
+// tenant/project (паттерн Спека B / AutoPauseFlowTest).
+uses(DatabaseTransactions::class);
+uses(SharesSupplierPdo::class);
+
+it('excludes projects of frozen tenants from supplier order', function () {
+    $frozenTenant = Tenant::factory()->create(['frozen_by_balance_at' => now()]);
+    Project::factory()->for($frozenTenant)->create(['is_active' => true, 'daily_limit_target' => 50]);
+
+    $activeTenant = Tenant::factory()->create(['frozen_by_balance_at' => null]);
+    Project::factory()->for($activeTenant)->create(['is_active' => true, 'daily_limit_target' => 30]);
+
+    $eligible = app(SyncSupplierProjectsJob::class)->collectEligibleProjects();
+
+    $tenantIds = $eligible->pluck('tenant_id')->unique()->all();
+    expect($tenantIds)->not->toContain($frozenTenant->id);
+    expect($tenantIds)->toContain($activeTenant->id);
+});
+
+it('excludes individually preflight-blocked projects', function () {
+    $tenant = Tenant::factory()->create(['frozen_by_balance_at' => null]);
+    $okProject = Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 30, 'preflight_blocked_at' => null]);
+    $blocked = Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 20, 'preflight_blocked_at' => now()]);
+
+    $eligible = app(SyncSupplierProjectsJob::class)->collectEligibleProjects();
+
+    $ids = $eligible->pluck('id')->all();
+    expect($ids)->toContain($okProject->id);
+    expect($ids)->not->toContain($blocked->id);
+});

From df12ac675766160de081cb8e206185ad9098a03e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <noreply@anthropic.com>
Date: Mon, 25 May 2026 03:28:00 +0300
Subject: [PATCH 07/13] =?UTF-8?q?fix(billing-v2-c):=20per-tenant=20Mail-?=
 =?UTF-8?q?=D1=84=D0=B8=D0=BB=D1=8C=D1=82=D1=80=20=D0=B2=20idempotent-?=
 =?UTF-8?q?=D1=82=D0=B5=D1=81=D1=82=D0=B5=20sweep-job?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

liderra_testing persistent (RefreshDatabase off) — DemoSeeder тенанты
могут попасть в sweep и тоже получить BalanceFrozenMail. Без per-tenant
фильтра Mail::assertNotQueued() ловил 154 фоновых письма и валил тест.

Логика BalancePreflightSweepJob корректна — фикс только в test isolation.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 app/tests/Feature/Billing/BalancePreflightSweepJobTest.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/app/tests/Feature/Billing/BalancePreflightSweepJobTest.php b/app/tests/Feature/Billing/BalancePreflightSweepJobTest.php
index c992921f..0d94bf4a 100644
--- a/app/tests/Feature/Billing/BalancePreflightSweepJobTest.php
+++ b/app/tests/Feature/Billing/BalancePreflightSweepJobTest.php
@@ -56,7 +56,9 @@ it('is idempotent — does not re-freeze already frozen tenant', function () {
 
     (new BalancePreflightSweepJob)->handle();
 
-    // Дата заморозки не перезаписана, повторного письма нет.
+    // Дата заморозки не перезаписана; для ЭТОГО tenant повторного письма нет.
+    // NB: per-tenant фильтр, т.к. liderra_testing persistent (DemoSeeder тенанты
+    // могут попасть в sweep и тоже получить BalanceFrozenMail — не наш ответ).
     expect($tenant->fresh()->frozen_by_balance_at->timestamp)->toBe($frozenAt->timestamp);
-    Mail::assertNotQueued(BalanceFrozenMail::class);
+    Mail::assertNotQueued(BalanceFrozenMail::class, fn ($mail) => $mail->tenant->id === $tenant->id);
 });

From 787df436a32f0372e069924bf14c7d201db48cf9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <noreply@anthropic.com>
Date: Mon, 25 May 2026 04:36:29 +0300
Subject: [PATCH 08/13] =?UTF-8?q?feat(billing-v2-c):=20=D0=BF=D0=BE=D0=B2?=
 =?UTF-8?q?=D1=82=D0=BE=D1=80=D0=BD=D1=8B=D0=B5=20=D0=BF=D0=B8=D1=81=D1=8C?=
 =?UTF-8?q?=D0=BC=D0=B0=20=D0=B7=D0=B0=D0=BC=D0=BE=D1=80=D0=BE=D0=B7=D0=BA?=
 =?UTF-8?q?=D0=B8=20(reminder=20+1=D0=B4,=20final=20+3=D0=B4)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Task 1.6 плана 2026-05-24-billing-v2-spec-c-preflight-vtb.

BalanceFrozenReminderJob — окна 24-48ч (reminder) и 72-96ч (final).
Throttle через balance_freeze_log markers (event_type 'reminder_sent' /
'final_sent') на 5 дней — повторов в окне не будет.

Re-evaluate PreflightResult для актуального дефицита в письме
(клиент мог частично пополнить — reminder покажет обновлённое число).

Schedule @18:30 MSK (после основного sweep @18:00) — если sweep
только что заморозил тенанта, reminder в тот же день не сработает
(окно 24h+ ещё не открыто).

TDD: 4 теста GREEN (reminder/final/skip-fresh/throttle).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../Commands/BillingFrozenReminderCommand.php |  33 +++++
 .../Jobs/Billing/BalanceFrozenReminderJob.php | 132 ++++++++++++++++++
 app/routes/console.php                        |   9 ++
 .../Billing/BalanceFrozenReminderJobTest.php  | 101 ++++++++++++++
 4 files changed, 275 insertions(+)
 create mode 100644 app/app/Console/Commands/BillingFrozenReminderCommand.php
 create mode 100644 app/app/Jobs/Billing/BalanceFrozenReminderJob.php
 create mode 100644 app/tests/Feature/Billing/BalanceFrozenReminderJobTest.php

diff --git a/app/app/Console/Commands/BillingFrozenReminderCommand.php b/app/app/Console/Commands/BillingFrozenReminderCommand.php
new file mode 100644
index 00000000..c8f7f992
--- /dev/null
+++ b/app/app/Console/Commands/BillingFrozenReminderCommand.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Jobs\Billing\BalanceFrozenReminderJob;
+use Illuminate\Console\Command;
+
+/**
+ * Daily: повторные письма заморозки баланса.
+ *   • reminder в окне 24-48ч после freeze;
+ *   • final в окне 72-96ч после freeze.
+ *
+ * Запускается @18:30 MSK (routes/console.php), после основного preflight-sweep @18:00.
+ * Throttle живёт в BalanceFrozenReminderJob через balance_freeze_log markers.
+ */
+final class BillingFrozenReminderCommand extends Command
+{
+    /** @var string */
+    protected $signature = 'billing:frozen-reminder';
+
+    /** @var string */
+    protected $description = 'Повторные письма заморозки баланса (reminder +1д, final +3д)';
+
+    public function handle(): int
+    {
+        (new BalanceFrozenReminderJob)->handle();
+        $this->info('Повторные письма заморозки разосланы (если есть кандидаты в окнах).');
+
+        return self::SUCCESS;
+    }
+}
diff --git a/app/app/Jobs/Billing/BalanceFrozenReminderJob.php b/app/app/Jobs/Billing/BalanceFrozenReminderJob.php
new file mode 100644
index 00000000..c69e8534
--- /dev/null
+++ b/app/app/Jobs/Billing/BalanceFrozenReminderJob.php
@@ -0,0 +1,132 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Jobs\Billing;
+
+use App\Mail\BalanceFrozenFinalMail;
+use App\Mail\BalanceFrozenReminderMail;
+use App\Models\PricingTier;
+use App\Models\Tenant;
+use App\Services\Billing\BalancePreflightService;
+use App\Services\Billing\PreflightResult;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Database\Eloquent\Collection;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Mail;
+
+/**
+ * Повторные письма заморозки баланса:
+ *   • reminder в окне 24-48ч после freeze;
+ *   • final в окне 72-96ч после freeze.
+ *
+ * Throttle через balance_freeze_log markers (event_type 'reminder_sent' / 'final_sent') —
+ * один marker-row на (tenant, тип) в течение окна 5 дней. Запускается daily @ 18:30 MSK
+ * (routes/console.php). См. спек §3.7.
+ *
+ * Re-evaluate PreflightResult: показываем клиенту АКТУАЛЬНЫЙ дефицит (он мог частично
+ * пополниться — reminder отразит обновлённую цифру).
+ */
+final class BalanceFrozenReminderJob implements ShouldQueue
+{
+    use Dispatchable;
+    use InteractsWithQueue;
+    use Queueable;
+
+    private const REMINDER_MIN_HOURS = 24;
+
+    private const REMINDER_MAX_HOURS = 48;
+
+    private const FINAL_MIN_HOURS = 72;
+
+    private const FINAL_MAX_HOURS = 96;
+
+    public function handle(): void
+    {
+        $service = new BalancePreflightService;
+        $tiers = PricingTier::query()->where('is_active', true)->get();
+
+        Tenant::query()
+            ->whereNotNull('frozen_by_balance_at')
+            ->whereNull('deleted_at')
+            ->chunkById(200, function (Collection $tenants) use ($service, $tiers): void {
+                foreach ($tenants as $tenant) {
+                    /** @var Tenant $tenant */
+                    $this->processTenant($tenant, $service, $tiers);
+                }
+            });
+    }
+
+    /**
+     * @param  Collection<int, PricingTier>  $tiers
+     */
+    private function processTenant(Tenant $tenant, BalancePreflightService $service, Collection $tiers): void
+    {
+        // diffInHours округляет — у заморозки на 25h это 25, на 73h это 73 (OK).
+        $hours = (int) abs(now()->diffInHours($tenant->frozen_by_balance_at, false));
+
+        $window = $this->matchWindow($hours);
+        if ($window === null) {
+            return; // вне окон reminder/final
+        }
+
+        $marker = $window === 'reminder' ? 'reminder_sent' : 'final_sent';
+        if ($this->alreadySent($tenant->id, $marker)) {
+            return;
+        }
+
+        // Re-evaluate для актуального дефицита в тексте письма.
+        $result = $service->evaluate(
+            balanceRub: (string) $tenant->balance_rub,
+            deliveredInMonth: (int) $tenant->delivered_in_month,
+            requiredLeads: $tenant->requiredLeadsForTomorrow(),
+            tiers: $tiers,
+        );
+
+        $mail = $window === 'reminder'
+            ? new BalanceFrozenReminderMail($tenant, $result)
+            : new BalanceFrozenFinalMail($tenant, $result);
+
+        Mail::queue($mail);
+        $this->mark($tenant, $marker, $result);
+    }
+
+    private function matchWindow(int $hours): ?string
+    {
+        if ($hours >= self::REMINDER_MIN_HOURS && $hours < self::REMINDER_MAX_HOURS) {
+            return 'reminder';
+        }
+        if ($hours >= self::FINAL_MIN_HOURS && $hours < self::FINAL_MAX_HOURS) {
+            return 'final';
+        }
+
+        return null;
+    }
+
+    private function alreadySent(int $tenantId, string $marker): bool
+    {
+        return DB::connection('pgsql_supplier')->table('balance_freeze_log')
+            ->where('tenant_id', $tenantId)
+            ->where('event_type', $marker)
+            ->where('created_at', '>=', now()->subDays(5))
+            ->exists();
+    }
+
+    private function mark(Tenant $tenant, string $marker, PreflightResult $result): void
+    {
+        DB::connection('pgsql_supplier')->table('balance_freeze_log')->insert([
+            'tenant_id' => $tenant->id,
+            'event_type' => $marker,
+            'triggered_by' => 'reminder_cron',
+            'balance_rub_at_event' => $tenant->balance_rub,
+            'required_leads' => $result->requiredLeads,
+            'capacity_leads' => $result->capacityLeads,
+            'total_daily_limit' => $result->requiredLeads,
+            'details' => json_encode(['deficit_leads' => $result->deficitLeads]),
+            'created_at' => now(),
+        ]);
+    }
+}
diff --git a/app/routes/console.php b/app/routes/console.php
index e1cdd359..eb50bba1 100644
--- a/app/routes/console.php
+++ b/app/routes/console.php
@@ -74,6 +74,15 @@ Schedule::command('billing:preflight-sweep')
     ->onSuccess(fn () => $hb->recordRunResult('billing:preflight-sweep', true, null, null))
     ->onFailure(fn () => $hb->recordRunResult('billing:preflight-sweep', false, 'Command failed', null));
 
+// Billing v2 Spec C §3.7: повторные письма заморозки (reminder +1д, final +3д).
+// Идёт ПОСЛЕ основного sweep — если sweep только что заморозил тенанта, окно reminder
+// (24h+) ещё не открылось, повторного письма в тот же день не будет (correct).
+Schedule::command('billing:frozen-reminder')
+    ->dailyAt('18:30')
+    ->timezone('Europe/Moscow')
+    ->onSuccess(fn () => $hb->recordRunResult('billing:frozen-reminder', true, null, null))
+    ->onFailure(fn () => $hb->recordRunResult('billing:frozen-reminder', false, 'Command failed', null));
+
 // Plan 3 Task 8: 5 Schedule entries для supplier-flow.
 //
 // NB: ->onOneServer() требует cache_locks таблицу, которой у нас нет
diff --git a/app/tests/Feature/Billing/BalanceFrozenReminderJobTest.php b/app/tests/Feature/Billing/BalanceFrozenReminderJobTest.php
new file mode 100644
index 00000000..d16288fa
--- /dev/null
+++ b/app/tests/Feature/Billing/BalanceFrozenReminderJobTest.php
@@ -0,0 +1,101 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Jobs\Billing\BalanceFrozenReminderJob;
+use App\Mail\BalanceFrozenFinalMail;
+use App\Mail\BalanceFrozenReminderMail;
+use App\Models\PricingTier;
+use App\Models\Project;
+use App\Models\Tenant;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Carbon;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Mail;
+use Tests\Concerns\SharesSupplierPdo;
+
+// Изоляция: liderra_testing persistent — DatabaseTransactions откатывает default-pgsql,
+// SharesSupplierPdo делает pgsql_supplier общим PDO (паттерн Спека B / Task 1.4).
+// Per-tenant Mail-фильтры обязательны — DemoSeeder тенанты могут попасть в sweep
+// (прецедент idempotent-fixup 55a1bc05).
+uses(DatabaseTransactions::class);
+uses(SharesSupplierPdo::class);
+
+beforeEach(function () {
+    // RLS-контекст (системный tenant 0).
+    DB::statement("SELECT set_config('app.current_tenant_id', '0', true)");
+    PricingTier::query()->create([
+        'tier_no' => 1,
+        'leads_in_tier' => null,
+        'price_per_lead_kopecks' => 5000,
+        'is_active' => true,
+        'effective_from' => now(),
+    ]);
+});
+
+it('sends reminder ~1 day after freeze', function () {
+    Mail::fake();
+    // frozen 25h назад — попадает в окно reminder (24-48h).
+    Carbon::setTestNow('2026-05-25 12:00:00');
+    $tenant = Tenant::factory()->create([
+        'balance_rub' => '0.00',
+        'frozen_by_balance_at' => Carbon::now()->subHours(25),
+    ]);
+    Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 25]);
+
+    (new BalanceFrozenReminderJob)->handle();
+
+    Mail::assertQueued(BalanceFrozenReminderMail::class, fn ($mail) => $mail->tenant->id === $tenant->id);
+    Mail::assertNotQueued(BalanceFrozenFinalMail::class, fn ($mail) => $mail->tenant->id === $tenant->id);
+});
+
+it('sends final ~3 days after freeze', function () {
+    Mail::fake();
+    // frozen 73h назад — попадает в окно final (72-96h).
+    Carbon::setTestNow('2026-05-25 12:00:00');
+    $tenant = Tenant::factory()->create([
+        'balance_rub' => '0.00',
+        'frozen_by_balance_at' => Carbon::now()->subHours(73),
+    ]);
+    Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 25]);
+
+    (new BalanceFrozenReminderJob)->handle();
+
+    Mail::assertQueued(BalanceFrozenFinalMail::class, fn ($mail) => $mail->tenant->id === $tenant->id);
+    Mail::assertNotQueued(BalanceFrozenReminderMail::class, fn ($mail) => $mail->tenant->id === $tenant->id);
+});
+
+it('sends nothing for freshly frozen tenant', function () {
+    Mail::fake();
+    // frozen 2h назад — окно ещё не открылось.
+    Carbon::setTestNow('2026-05-25 12:00:00');
+    $tenant = Tenant::factory()->create([
+        'balance_rub' => '0.00',
+        'frozen_by_balance_at' => Carbon::now()->subHours(2),
+    ]);
+    Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 25]);
+
+    (new BalanceFrozenReminderJob)->handle();
+
+    Mail::assertNotQueued(BalanceFrozenReminderMail::class, fn ($mail) => $mail->tenant->id === $tenant->id);
+    Mail::assertNotQueued(BalanceFrozenFinalMail::class, fn ($mail) => $mail->tenant->id === $tenant->id);
+});
+
+it('is throttled — does not re-send reminder for same tenant in window', function () {
+    Mail::fake();
+    Carbon::setTestNow('2026-05-25 12:00:00');
+    $tenant = Tenant::factory()->create([
+        'balance_rub' => '0.00',
+        'frozen_by_balance_at' => Carbon::now()->subHours(25),
+    ]);
+    Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 25]);
+
+    // Первый прогон — отправляет reminder.
+    (new BalanceFrozenReminderJob)->handle();
+    Mail::assertQueued(BalanceFrozenReminderMail::class, fn ($mail) => $mail->tenant->id === $tenant->id);
+
+    // Сброс fake и второй прогон в том же окне — повторного письма быть не должно.
+    Mail::fake();
+    (new BalanceFrozenReminderJob)->handle();
+    Mail::assertNotQueued(BalanceFrozenReminderMail::class, fn ($mail) => $mail->tenant->id === $tenant->id);
+});

From fd877ab1569bd1782584d5831e2cf75647639f5c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <noreply@anthropic.com>
Date: Mon, 25 May 2026 04:41:57 +0300
Subject: [PATCH 09/13] =?UTF-8?q?feat(billing-v2-c):=20ProjectController?=
 =?UTF-8?q?=20preflight=20=E2=80=94=20409=20=D0=BF=D1=80=D0=B8=20=D0=BF?=
 =?UTF-8?q?=D0=B5=D1=80=D0=B5=D0=B3=D1=80=D1=83=D0=B7=D0=BA=D0=B5=20=D0=B1?=
 =?UTF-8?q?=D0=B0=D0=BB=D0=B0=D0=BD=D1=81=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Task 1.7 плана 2026-05-24-billing-v2-spec-c-preflight-vtb.

store/update проверяют преfflight перед созданием/изменением проекта:
- если сумма daily_limit_target всех активных не-blocked проектов
  превышает capacity баланса (через BalancePreflightService) и не
  передан force_save_blocked=true → возврат 409 с JSON-телом:
  {error, current_balance_rub, current_capacity_leads,
   would_be_required_leads, deficit_leads}
- если force_save_blocked=true → проект создаётся/обновляется с
  preflight_blocked_at=now() (точечная заморозка одного проекта,
  не блокирует остальные).

Safe fallback: без активных pricing_tiers — преfflight skipped
(legacy-окружения без настроенного биллинга).

TDD: 4 теста GREEN (409 store / 409 update / force_save_blocked
создаёт blocked / norm pass через capacity).

Регрессия: 0 регрессий на Plan5 ProjectsStoreTest+ProjectsUpdateTest
(37/37 GREEN после safe fallback).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../Controllers/Api/ProjectController.php     |  94 ++++++++++++++-
 app/app/Http/Requests/StoreProjectRequest.php |   3 +
 .../Http/Requests/UpdateProjectRequest.php    |   3 +
 .../Feature/Billing/ProjectPreflightTest.php  | 107 ++++++++++++++++++
 4 files changed, 205 insertions(+), 2 deletions(-)
 create mode 100644 app/tests/Feature/Billing/ProjectPreflightTest.php

diff --git a/app/app/Http/Controllers/Api/ProjectController.php b/app/app/Http/Controllers/Api/ProjectController.php
index d6eeb52c..6f3a831f 100644
--- a/app/app/Http/Controllers/Api/ProjectController.php
+++ b/app/app/Http/Controllers/Api/ProjectController.php
@@ -10,7 +10,10 @@ use App\Http\Requests\StoreProjectRequest;
 use App\Http\Requests\UpdateProjectRequest;
 use App\Http\Resources\ProjectResource;
 use App\Jobs\SyncSupplierProjectJob;
+use App\Models\PricingTier;
 use App\Models\Project;
+use App\Models\Tenant;
+use App\Services\Billing\BalancePreflightService;
 use App\Services\Project\ProjectService;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
@@ -117,7 +120,35 @@ class ProjectController extends Controller
     /** POST /api/projects */
     public function store(StoreProjectRequest $request): JsonResponse
     {
-        $project = $this->projects->create($request->user()->tenant, $request->validated());
+        $validated = $request->validated();
+        $tenant = $request->user()->tenant;
+        $forceSaveBlocked = (bool) ($validated['force_save_blocked'] ?? false);
+        unset($validated['force_save_blocked']);
+
+        // Spec C §3.4: преfflight баланса при создании. existingLimit учитывает только активные.
+        $existingLimit = (int) Project::where('tenant_id', $tenant->id)
+            ->where('is_active', true)
+            ->whereNull('preflight_blocked_at')
+            ->sum('daily_limit_target');
+        $wouldBeRequired = $existingLimit + (int) $validated['daily_limit_target'];
+
+        $preflight = $this->runPreflight($tenant, $wouldBeRequired);
+
+        if (! $preflight['passes'] && ! $forceSaveBlocked) {
+            return response()->json([
+                'error' => 'balance_insufficient',
+                'current_balance_rub' => (string) $tenant->balance_rub,
+                'current_capacity_leads' => $preflight['capacity_leads'],
+                'would_be_required_leads' => $wouldBeRequired,
+                'deficit_leads' => $preflight['deficit_leads'],
+            ], 409);
+        }
+
+        if (! $preflight['passes'] && $forceSaveBlocked) {
+            $validated['preflight_blocked_at'] = now();
+        }
+
+        $project = $this->projects->create($tenant, $validated);
 
         return response()->json(['data' => new ProjectResource($project)], 201);
     }
@@ -126,11 +157,70 @@ class ProjectController extends Controller
     public function update(UpdateProjectRequest $request, int $id): JsonResponse
     {
         $project = Project::where('tenant_id', $request->user()->tenant_id)->findOrFail($id);
-        $updated = $this->projects->update($project, $request->validated());
+        $validated = $request->validated();
+        $tenant = $request->user()->tenant;
+        $forceSaveBlocked = (bool) ($validated['force_save_blocked'] ?? false);
+        unset($validated['force_save_blocked']);
+
+        // Spec C §3.4: преfflight при изменении лимита — учитываем новое значение для ЭТОГО
+        // проекта + лимиты остальных активных не-blocked.
+        if (array_key_exists('daily_limit_target', $validated)) {
+            $existingLimit = (int) Project::where('tenant_id', $tenant->id)
+                ->where('id', '!=', $project->id)
+                ->where('is_active', true)
+                ->whereNull('preflight_blocked_at')
+                ->sum('daily_limit_target');
+            $wouldBeRequired = $existingLimit + (int) $validated['daily_limit_target'];
+
+            $preflight = $this->runPreflight($tenant, $wouldBeRequired);
+
+            if (! $preflight['passes'] && ! $forceSaveBlocked) {
+                return response()->json([
+                    'error' => 'balance_insufficient',
+                    'current_balance_rub' => (string) $tenant->balance_rub,
+                    'current_capacity_leads' => $preflight['capacity_leads'],
+                    'would_be_required_leads' => $wouldBeRequired,
+                    'deficit_leads' => $preflight['deficit_leads'],
+                ], 409);
+            }
+
+            if (! $preflight['passes'] && $forceSaveBlocked) {
+                $validated['preflight_blocked_at'] = now();
+            }
+        }
+
+        $updated = $this->projects->update($project, $validated);
 
         return response()->json(['data' => new ProjectResource($updated)]);
     }
 
+    /**
+     * @return array{passes: bool, capacity_leads: int, deficit_leads: int}
+     */
+    private function runPreflight(Tenant $tenant, int $requiredLeads): array
+    {
+        $tiers = PricingTier::query()->where('is_active', true)->get();
+
+        // Safe fallback: без активных pricing_tiers биллинг не настроен —
+        // преfflight не имеет смысла, пропускаем (legacy-окружения / тесты).
+        if ($tiers->isEmpty()) {
+            return ['passes' => true, 'capacity_leads' => PHP_INT_MAX, 'deficit_leads' => 0];
+        }
+
+        $result = (new BalancePreflightService)->evaluate(
+            balanceRub: (string) $tenant->balance_rub,
+            deliveredInMonth: (int) $tenant->delivered_in_month,
+            requiredLeads: $requiredLeads,
+            tiers: $tiers,
+        );
+
+        return [
+            'passes' => $result->passes,
+            'capacity_leads' => $result->capacityLeads,
+            'deficit_leads' => $result->deficitLeads,
+        ];
+    }
+
     /** GET /api/projects/{id} */
     public function show(Request $request, int $id): JsonResponse
     {
diff --git a/app/app/Http/Requests/StoreProjectRequest.php b/app/app/Http/Requests/StoreProjectRequest.php
index 632297bf..92f6ba01 100644
--- a/app/app/Http/Requests/StoreProjectRequest.php
+++ b/app/app/Http/Requests/StoreProjectRequest.php
@@ -28,6 +28,9 @@ class StoreProjectRequest extends FormRequest
             'regions' => ['present', 'array'],
             'regions.*' => ['integer', 'between:1,89'],
             'delivery_days_mask' => ['required', 'integer', 'min:1', 'max:127'],
+            // Spec C §3.4: при перегрузке преfflight UI шлёт force_save_blocked=true →
+            // проект создаётся с preflight_blocked_at=now() вместо ответа 409.
+            'force_save_blocked' => ['sometimes', 'boolean'],
         ];
 
         if ($signalType === 'site') {
diff --git a/app/app/Http/Requests/UpdateProjectRequest.php b/app/app/Http/Requests/UpdateProjectRequest.php
index 052c643f..dc094347 100644
--- a/app/app/Http/Requests/UpdateProjectRequest.php
+++ b/app/app/Http/Requests/UpdateProjectRequest.php
@@ -28,6 +28,9 @@ class UpdateProjectRequest extends FormRequest
             'sms_senders' => ['sometimes', 'array', 'min:1'],
             'sms_senders.*' => ['string', 'max:11'],
             'sms_keyword' => ['sometimes', 'nullable', 'string', 'min:1', 'max:50'],
+            // Spec C §3.4: при перегрузке преfflight UI шлёт force_save_blocked=true →
+            // проект помечается preflight_blocked_at=now() вместо ответа 409.
+            'force_save_blocked' => ['sometimes', 'boolean'],
         ];
 
         // 18.05.2026 UX: редактирование источника (signal_identifier) для site/call.
diff --git a/app/tests/Feature/Billing/ProjectPreflightTest.php b/app/tests/Feature/Billing/ProjectPreflightTest.php
new file mode 100644
index 00000000..5a813455
--- /dev/null
+++ b/app/tests/Feature/Billing/ProjectPreflightTest.php
@@ -0,0 +1,107 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\PricingTier;
+use App\Models\Project;
+use App\Models\Tenant;
+use App\Models\User;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Queue;
+use Tests\Concerns\SharesSupplierPdo;
+
+uses(DatabaseTransactions::class);
+uses(SharesSupplierPdo::class);
+
+beforeEach(function () {
+    Queue::fake();
+    DB::statement("SELECT set_config('app.current_tenant_id', '0', true)");
+    PricingTier::query()->create([
+        'tier_no' => 1,
+        'leads_in_tier' => null,
+        'price_per_lead_kopecks' => 5000, // 50₽/лид — capacity = balance/50
+        'is_active' => true,
+        'effective_from' => now(),
+    ]);
+});
+
+it('returns 409 when new project would overload balance', function () {
+    // 1000₽ / 50₽ = 20 лидов capacity; запрашиваем daily_limit_target=30 → дефицит 10.
+    $tenant = Tenant::factory()->create(['balance_rub' => '1000.00']);
+    $user = User::factory()->create(['tenant_id' => $tenant->id]);
+
+    $response = $this->actingAs($user)->postJson('/api/projects', [
+        'name' => 'Перегрузка',
+        'signal_type' => 'site',
+        'signal_identifier' => 'overload.ru',
+        'daily_limit_target' => 30,
+        'regions' => [],
+        'delivery_days_mask' => 127,
+    ]);
+
+    $response->assertStatus(409);
+    $response->assertJsonPath('error', 'balance_insufficient');
+    $response->assertJsonPath('deficit_leads', 10);
+    $response->assertJsonPath('current_capacity_leads', 20);
+    $response->assertJsonPath('would_be_required_leads', 30);
+    expect(Project::where('signal_identifier', 'overload.ru')->exists())->toBeFalse();
+});
+
+it('creates blocked project when force_save_blocked=true', function () {
+    $tenant = Tenant::factory()->create(['balance_rub' => '1000.00']);
+    $user = User::factory()->create(['tenant_id' => $tenant->id]);
+
+    $response = $this->actingAs($user)->postJson('/api/projects', [
+        'name' => 'Заблокированный',
+        'signal_type' => 'site',
+        'signal_identifier' => 'force-blocked.ru',
+        'daily_limit_target' => 30,
+        'regions' => [],
+        'delivery_days_mask' => 127,
+        'force_save_blocked' => true,
+    ]);
+
+    $response->assertCreated();
+    $project = Project::where('signal_identifier', 'force-blocked.ru')->first();
+    expect($project)->not->toBeNull();
+    expect($project->preflight_blocked_at)->not->toBeNull();
+});
+
+it('creates normally when within balance', function () {
+    // 2000₽ / 50₽ = 40 лидов capacity; daily_limit_target=30 — passes.
+    $tenant = Tenant::factory()->create(['balance_rub' => '2000.00']);
+    $user = User::factory()->create(['tenant_id' => $tenant->id]);
+
+    $response = $this->actingAs($user)->postJson('/api/projects', [
+        'name' => 'Норма',
+        'signal_type' => 'site',
+        'signal_identifier' => 'ok-balance.ru',
+        'daily_limit_target' => 30,
+        'regions' => [],
+        'delivery_days_mask' => 127,
+    ]);
+
+    $response->assertCreated();
+    $project = Project::where('signal_identifier', 'ok-balance.ru')->first();
+    expect($project->preflight_blocked_at)->toBeNull();
+});
+
+it('returns 409 on update when increased limit overloads balance', function () {
+    // существующий проект на 15 лидов, всё ок (capacity 20).
+    $tenant = Tenant::factory()->create(['balance_rub' => '1000.00']);
+    $user = User::factory()->create(['tenant_id' => $tenant->id]);
+    $project = Project::factory()->for($tenant)->create([
+        'is_active' => true,
+        'daily_limit_target' => 15,
+    ]);
+
+    // UPDATE до 30 → suma 30 > capacity 20 → 409.
+    $response = $this->actingAs($user)->patchJson("/api/projects/{$project->id}", [
+        'daily_limit_target' => 30,
+    ]);
+
+    $response->assertStatus(409);
+    $response->assertJsonPath('error', 'balance_insufficient');
+    expect($project->fresh()->daily_limit_target)->toBe(15); // не изменилось
+});

From fe4a4094805549cf1a310113cf3c77a7d6f8386f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <noreply@anthropic.com>
Date: Mon, 25 May 2026 04:43:02 +0300
Subject: [PATCH 10/13] feat(billing-v2-c): one-time
 billing:preflight-initial-sweep
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Task 1.9 плана 2026-05-24-billing-v2-spec-c-preflight-vtb.

Разовая artisan-команда для запуска при выкатке Spec C — прогоняет
BalancePreflightSweepJob по всем тенантам, замораживает legacy-
тенантов в минусе. Идемпотентна (sweep-job triggers только на
active↔frozen переходах, стабильное состояние не трогает).

TDD: 1 тест GREEN.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../BillingPreflightInitialSweepCommand.php   | 37 ++++++++++++++++++
 .../BillingPreflightInitialSweepTest.php      | 38 +++++++++++++++++++
 2 files changed, 75 insertions(+)
 create mode 100644 app/app/Console/Commands/BillingPreflightInitialSweepCommand.php
 create mode 100644 app/tests/Feature/Billing/BillingPreflightInitialSweepTest.php

diff --git a/app/app/Console/Commands/BillingPreflightInitialSweepCommand.php b/app/app/Console/Commands/BillingPreflightInitialSweepCommand.php
new file mode 100644
index 00000000..59cb58a8
--- /dev/null
+++ b/app/app/Console/Commands/BillingPreflightInitialSweepCommand.php
@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Jobs\Billing\BalancePreflightSweepJob;
+use Illuminate\Console\Command;
+
+/**
+ * One-time: при выкатке преfflight прогнать всех тенантов и заморозить
+ * недофинансированных. Запускается ОДИН раз вручную после миграции.
+ *
+ * См. спек §3.9: «Клиент уже в минусовом балансе на момент запуска
+ * преfflight (legacy состояние) — одноразовая artisan-команда».
+ *
+ * Идемпотентна: повторный запуск не пере-замораживает уже замороженных
+ * (логика sweep-джоба — переход active→frozen / frozen→active, стабильное
+ * состояние не трогается).
+ */
+final class BillingPreflightInitialSweepCommand extends Command
+{
+    /** @var string */
+    protected $signature = 'billing:preflight-initial-sweep';
+
+    /** @var string */
+    protected $description = 'Разовый преfflight при внедрении — заморозить недофинансированных тенантов';
+
+    public function handle(): int
+    {
+        $this->warn('Разовый преfflight всех тенантов. Запускать ОДИН раз после выкатки Spec C.');
+        (new BalancePreflightSweepJob)->handle();
+        $this->info('Initial sweep завершён.');
+
+        return self::SUCCESS;
+    }
+}
diff --git a/app/tests/Feature/Billing/BillingPreflightInitialSweepTest.php b/app/tests/Feature/Billing/BillingPreflightInitialSweepTest.php
new file mode 100644
index 00000000..92b663e1
--- /dev/null
+++ b/app/tests/Feature/Billing/BillingPreflightInitialSweepTest.php
@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Mail\BalanceFrozenMail;
+use App\Models\PricingTier;
+use App\Models\Project;
+use App\Models\Tenant;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Mail;
+use Tests\Concerns\SharesSupplierPdo;
+
+uses(DatabaseTransactions::class);
+uses(SharesSupplierPdo::class);
+
+beforeEach(function () {
+    DB::statement("SELECT set_config('app.current_tenant_id', '0', true)");
+    PricingTier::query()->create([
+        'tier_no' => 1,
+        'leads_in_tier' => null,
+        'price_per_lead_kopecks' => 5000,
+        'is_active' => true,
+        'effective_from' => now(),
+    ]);
+});
+
+it('freezes pre-existing underfunded tenant on first run', function () {
+    Mail::fake();
+    // 0₽ + проекты на 25 лидов → должен быть заморожен.
+    $tenant = Tenant::factory()->create(['balance_rub' => '0.00', 'frozen_by_balance_at' => null]);
+    Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 25]);
+
+    $this->artisan('billing:preflight-initial-sweep')->assertSuccessful();
+
+    expect($tenant->fresh()->frozen_by_balance_at)->not->toBeNull();
+    Mail::assertQueued(BalanceFrozenMail::class, fn ($mail) => $mail->tenant->id === $tenant->id);
+});

From e1601e786256229782d7e5d789a466aa662360c3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <noreply@anthropic.com>
Date: Mon, 25 May 2026 06:23:59 +0300
Subject: [PATCH 11/13] =?UTF-8?q?feat(billing-v2-c):=20UI=20=D0=BF=D1=80?=
 =?UTF-8?q?=D0=B5=D1=84=D0=BB=D0=B0=D0=B9=D1=82=20Task=201.10=20=E2=80=94?=
 =?UTF-8?q?=20=D0=B1=D0=B0=D0=BD=D0=BD=D0=B5=D1=80=20=D0=B7=D0=B0=D0=BC?=
 =?UTF-8?q?=D0=BE=D1=80=D0=BE=D0=B7=D0=BA=D0=B8,=20=D0=B8=D0=BD=D0=B4?=
 =?UTF-8?q?=D0=B8=D0=BA=D0=B0=D1=82=D0=BE=D1=80=20=D1=91=D0=BC=D0=BA=D0=BE?=
 =?UTF-8?q?=D1=81=D1=82=D0=B8,=20=D0=B4=D0=B8=D0=B0=D0=BB=D0=BE=D0=B3=20?=
 =?UTF-8?q?=D0=BF=D0=B5=D1=80=D0=B5=D0=B3=D1=80=D1=83=D0=B7=D0=BA=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Spec C §3.6/§6.2. Бэкенд: GET /api/billing/balance-status (frozen + capacity + required + дефицит ₽/leads), Pest 6. Фронт: BalanceFrozenBanner (в AppLayout, глобально), BalanceCapacityIndicator (в BillingView под балансом), ProjectLimitOverloadDialog (409-перехват в NewProjectDialog: save-blocked/set-zero), tenantStore + api getBalanceStatus. Vitest +18.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 .../Controllers/Api/BillingController.php     |  98 ++++++++++++++++
 app/resources/js/api/billing.ts               |  24 ++++
 .../billing/BalanceCapacityIndicator.vue      |  68 +++++++++++
 .../billing/BalanceFrozenBanner.vue           |  52 +++++++++
 .../projects/ProjectLimitOverloadDialog.vue   |  70 ++++++++++++
 app/resources/js/layouts/AppLayout.vue        |  15 +++
 app/resources/js/stores/tenantStore.ts        |  43 +++++++
 app/resources/js/views/BillingView.vue        |  18 ++-
 .../js/views/projects/NewProjectDialog.vue    |  81 +++++++++----
 app/routes/web.php                            |   1 +
 .../Feature/Billing/BalanceStatusTest.php     | 107 ++++++++++++++++++
 .../Frontend/BalanceCapacityIndicator.spec.ts |  46 ++++++++
 .../Frontend/BalanceFrozenBanner.spec.ts      |  48 ++++++++
 app/tests/Frontend/BillingView.spec.ts        |   4 +-
 app/tests/Frontend/NewProjectDialog.spec.ts   |  38 +++++++
 .../ProjectLimitOverloadDialog.spec.ts        |  60 ++++++++++
 16 files changed, 751 insertions(+), 22 deletions(-)
 create mode 100644 app/resources/js/components/billing/BalanceCapacityIndicator.vue
 create mode 100644 app/resources/js/components/billing/BalanceFrozenBanner.vue
 create mode 100644 app/resources/js/components/projects/ProjectLimitOverloadDialog.vue
 create mode 100644 app/resources/js/stores/tenantStore.ts
 create mode 100644 app/tests/Feature/Billing/BalanceStatusTest.php
 create mode 100644 app/tests/Frontend/BalanceCapacityIndicator.spec.ts
 create mode 100644 app/tests/Frontend/BalanceFrozenBanner.spec.ts
 create mode 100644 app/tests/Frontend/ProjectLimitOverloadDialog.spec.ts

diff --git a/app/app/Http/Controllers/Api/BillingController.php b/app/app/Http/Controllers/Api/BillingController.php
index c8353b79..9111d23c 100644
--- a/app/app/Http/Controllers/Api/BillingController.php
+++ b/app/app/Http/Controllers/Api/BillingController.php
@@ -6,11 +6,14 @@ namespace App\Http\Controllers\Api;
 
 use App\Http\Controllers\Controller;
 use App\Models\BalanceTransaction;
+use App\Models\PricingTier;
+use App\Models\Project;
 use App\Models\Tenant;
 use App\Models\User;
 use App\Repositories\PricingTierRepository;
 use App\Services\Billing\BalanceToLeadsConverter;
 use App\Services\Billing\BillingTopupService;
+use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Support\Carbon;
@@ -111,6 +114,101 @@ class BillingController extends Controller
         ]);
     }
 
+    /**
+     * GET /api/billing/balance-status — лёгкий статус баланса для UI префлайта
+     * (Billing v2 Spec C §3.6). Питает глобальный баннер заморозки
+     * (BalanceFrozenBanner: frozen_by_balance_at + дефицит) и индикатор ёмкости
+     * (BalanceCapacityIndicator: balance / capacity / required). Грузится в
+     * AppLayout на всех страницах, поэтому без tiers_preview и истории.
+     */
+    public function balanceStatus(Request $request): JsonResponse
+    {
+        /** @var User $user */
+        $user = $request->user();
+        /** @var Tenant $tenant */
+        $tenant = Tenant::query()->findOrFail((int) $user->tenant_id);
+
+        $activeTiers = app(PricingTierRepository::class)->activeAt(Carbon::now('Europe/Moscow'));
+        $deliveredInMonth = (int) ($tenant->delivered_in_month ?? 0);
+
+        $capacityLeads = (int) app(BalanceToLeadsConverter::class)->convert(
+            (string) $tenant->balance_rub,
+            $deliveredInMonth,
+            $activeTiers,
+        )['leads'];
+
+        // Требуемые лиды/день — сумма лимитов активных не-заблокированных проектов
+        // (та же выборка, что в ProjectController preflight).
+        $requiredLeads = (int) Project::query()
+            ->where('tenant_id', $tenant->id)
+            ->where('is_active', true)
+            ->whereNull('preflight_blocked_at')
+            ->sum('daily_limit_target');
+
+        $deficitLeads = max(0, $requiredLeads - $capacityLeads);
+        $deficitRub = '0.00';
+        if ($deficitLeads > 0) {
+            $needed = $this->minBalanceForLeads($requiredLeads, $deliveredInMonth, $activeTiers);
+            $deficitRub = bcsub($needed, (string) $tenant->balance_rub, 2);
+            if (bccomp($deficitRub, '0', 2) < 0) {
+                $deficitRub = '0.00';
+            }
+        }
+
+        return response()->json([
+            'frozen_by_balance_at' => $tenant->frozen_by_balance_at?->toISOString(),
+            'balance_rub' => (string) $tenant->balance_rub,
+            'capacity_leads' => $capacityLeads,
+            'required_leads_per_day' => $requiredLeads,
+            'deficit_leads' => $deficitLeads,
+            'deficit_rub' => $deficitRub,
+        ]);
+    }
+
+    /**
+     * Минимальный баланс (₽, scale 2), чтобы позволить себе $leads лидов при уже
+     * доставленных $deliveredInMonth в этом месяце — сумма цен ступеней по позициям
+     * [delivered .. delivered+leads-1]. Зеркалит логику BalanceToLeadsConverter.
+     *
+     * @param  Collection<int, PricingTier>  $tiers
+     */
+    private function minBalanceForLeads(int $leads, int $deliveredInMonth, $tiers): string
+    {
+        if ($leads <= 0) {
+            return '0.00';
+        }
+
+        $sorted = $tiers
+            ->filter(fn ($t) => (bool) $t->is_active)
+            ->sortBy('tier_no')
+            ->values();
+
+        $kopecks = '0';
+        $remaining = $leads;
+        $cumulative = 0;            // позиции [0..cumulative) пройдены предыдущими ступенями
+        $position = $deliveredInMonth;
+
+        foreach ($sorted as $tier) {
+            $unlimited = $tier->leads_in_tier === null;
+            $tierEnd = $unlimited ? PHP_INT_MAX : $cumulative + (int) $tier->leads_in_tier;
+
+            $slotsInTier = max(0, $tierEnd - max($cumulative, $position));
+            if ($slotsInTier > 0) {
+                $take = min($remaining, $slotsInTier);
+                $kopecks = bcadd($kopecks, bcmul((string) (int) $tier->price_per_lead_kopecks, (string) $take, 0), 0);
+                $remaining -= $take;
+                $position += $take;
+            }
+
+            if ($remaining <= 0 || $unlimited) {
+                break;
+            }
+            $cumulative = $tierEnd;
+        }
+
+        return bcdiv($kopecks, '100', 2);
+    }
+
     /**
      * GET /api/billing/transactions?type=topup|lead_charge|migration&page=N
      * — пагинированная история balance_transactions тенанта (20/страница).
diff --git a/app/resources/js/api/billing.ts b/app/resources/js/api/billing.ts
index b5578b88..6d744f90 100644
--- a/app/resources/js/api/billing.ts
+++ b/app/resources/js/api/billing.ts
@@ -106,3 +106,27 @@ export async function topup(amountRub: number): Promise<TopupResult> {
     const { data } = await apiClient.post<TopupResult>('/api/billing/topup', { amount_rub: amountRub });
     return data;
 }
+
+/**
+ * Ответ GET /api/billing/balance-status — лёгкий статус баланса для UI префлайта
+ * (Billing v2 Spec C §3.6): питает баннер заморозки + индикатор ёмкости.
+ */
+export interface BalanceStatus {
+    /** ISO-дата заморозки или null (не заморожен). */
+    frozen_by_balance_at: string | null;
+    balance_rub: string;
+    /** Сколько лидов покрывает баланс по текущему тарифу. */
+    capacity_leads: number;
+    /** Суммарный дневной заказ активных не-заблокированных проектов. */
+    required_leads_per_day: number;
+    /** На сколько лидов заказ превышает ёмкость (0 если хватает). */
+    deficit_leads: number;
+    /** Сколько ₽ не хватает, чтобы покрыть дефицит (scale 2, "0.00" если хватает). */
+    deficit_rub: string;
+}
+
+/** GET /api/billing/balance-status — статус для баннера заморозки и индикатора ёмкости. */
+export async function getBalanceStatus(): Promise<BalanceStatus> {
+    const { data } = await apiClient.get<BalanceStatus>('/api/billing/balance-status');
+    return data;
+}
diff --git a/app/resources/js/components/billing/BalanceCapacityIndicator.vue b/app/resources/js/components/billing/BalanceCapacityIndicator.vue
new file mode 100644
index 00000000..3dd16edb
--- /dev/null
+++ b/app/resources/js/components/billing/BalanceCapacityIndicator.vue
@@ -0,0 +1,68 @@
+<script setup lang="ts">
+/**
+ * Постоянная подсказка под балансом (Billing v2 Spec C §3.6, Task 1.10).
+ *
+ * Чистый presentational-компонент: показывает, на сколько дней хватит ёмкости
+ * баланса (в лидах) при текущем дневном заказе всех eligible-проектов.
+ * Зелёный — хватает на 3+ дня; жёлтый — меньше 3 дней; красный — не хватает.
+ */
+import { computed } from 'vue';
+
+const props = defineProps<{
+    /** Баланс в рублях (строка scale 2, например "1000.00"). */
+    balanceRub: string;
+    /** Сколько лидов покрывает баланс по текущему тарифу. */
+    capacityLeads: number;
+    /** Суммарный дневной заказ всех активных проектов (лидов/день). */
+    requiredLeadsPerDay: number;
+}>();
+
+const daysLeft = computed(() =>
+    props.requiredLeadsPerDay > 0 ? props.capacityLeads / props.requiredLeadsPerDay : Infinity,
+);
+
+const statusClass = computed(() => {
+    if (props.requiredLeadsPerDay > 0 && props.capacityLeads < props.requiredLeadsPerDay) {
+        return 'capacity-insufficient';
+    }
+    if (daysLeft.value < 3) return 'capacity-warning';
+    return 'capacity-ok';
+});
+
+const daysLabel = computed(() => (Number.isFinite(daysLeft.value) ? daysLeft.value.toFixed(1) : '∞'));
+</script>
+
+<template>
+    <div class="balance-capacity text-body-2" :class="statusClass" data-testid="balance-capacity-indicator">
+        <div>Баланс: {{ balanceRub }}₽ = до {{ capacityLeads }} лидов по тарифу</div>
+        <div>Проекты заказывают: {{ requiredLeadsPerDay }} лидов в день</div>
+        <div v-if="statusClass === 'capacity-insufficient'" class="capacity-note">
+            ⚠️ Не хватает — пополните счёт
+        </div>
+        <div v-else-if="statusClass === 'capacity-warning'" class="capacity-note">
+            Хватит на ~{{ daysLabel }} дн. — скоро потребуется пополнение
+        </div>
+        <div v-else class="capacity-note">✅ Хватит на ~{{ daysLabel }} дн.</div>
+    </div>
+</template>
+
+<style scoped>
+.balance-capacity {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+    line-height: 1.4;
+}
+.capacity-note {
+    font-weight: 600;
+}
+.capacity-ok .capacity-note {
+    color: rgb(var(--v-theme-success));
+}
+.capacity-warning .capacity-note {
+    color: rgb(var(--v-theme-warning));
+}
+.capacity-insufficient .capacity-note {
+    color: rgb(var(--v-theme-error));
+}
+</style>
diff --git a/app/resources/js/components/billing/BalanceFrozenBanner.vue b/app/resources/js/components/billing/BalanceFrozenBanner.vue
new file mode 100644
index 00000000..64379083
--- /dev/null
+++ b/app/resources/js/components/billing/BalanceFrozenBanner.vue
@@ -0,0 +1,52 @@
+<script setup lang="ts">
+/**
+ * Красный баннер заморозки баланса (Billing v2 Spec C §3.6, Task 1.10).
+ *
+ * Показывается на всех страницах, когда tenant.frozen_by_balance_at !== null
+ * (проп `frozen`). Источник данных — tenantStore, загружаемый глобально в
+ * AppLayout. Чистый presentational-компонент.
+ */
+import { computed } from 'vue';
+
+const props = defineProps<{
+    frozen: boolean;
+    /** Сколько ₽ не хватает на дневной заказ (строка scale 2). */
+    deficitRub?: string;
+    /** Сколько лидов превышают ёмкость баланса. */
+    deficitLeads?: number;
+}>();
+
+const hasDeficit = computed(() => (props.deficitLeads ?? 0) > 0);
+</script>
+
+<template>
+    <v-alert
+        v-if="frozen"
+        type="error"
+        variant="tonal"
+        density="comfortable"
+        rounded="lg"
+        class="balance-frozen-banner ma-4 mb-0"
+        data-testid="balance-frozen-banner"
+    >
+        <div class="text-subtitle-2 font-weight-bold">Приём лидов приостановлен</div>
+        <div class="text-body-2 mb-2">
+            Не хватает баланса на дневной заказ.<span v-if="hasDeficit">
+                Нужно ещё {{ deficitRub }}₽ (или сократи лимиты на {{ deficitLeads }} лидов).</span>
+        </div>
+        <RouterLink to="/billing" data-testid="banner-topup-link" class="banner-link">
+            Пополнить счёт
+        </RouterLink>
+        <RouterLink to="/projects" data-testid="banner-projects-link" class="banner-link ml-4">
+            Перейти к проектам
+        </RouterLink>
+    </v-alert>
+</template>
+
+<style scoped>
+.banner-link {
+    font-weight: 600;
+    color: rgb(var(--v-theme-error));
+    text-decoration: underline;
+}
+</style>
diff --git a/app/resources/js/components/projects/ProjectLimitOverloadDialog.vue b/app/resources/js/components/projects/ProjectLimitOverloadDialog.vue
new file mode 100644
index 00000000..d847a516
--- /dev/null
+++ b/app/resources/js/components/projects/ProjectLimitOverloadDialog.vue
@@ -0,0 +1,70 @@
+<script setup lang="ts">
+/**
+ * Диалог перегрузки лимита (Billing v2 Spec C §6.2, Task 1.10).
+ *
+ * Открывается, когда POST/PATCH /api/projects вернул 409 `balance_insufficient`.
+ * Показывает дефицит и предлагает три исхода:
+ *  - «Сохранить и приостановить» → save-blocked (родитель пере-сабмитит с
+ *    force_save_blocked=true → проект создаётся с preflight_blocked_at);
+ *  - «Поставить лимит 0»          → set-zero (родитель ставит daily_limit_target=0);
+ *  - «Отмена»                     → закрытие без сохранения.
+ */
+export interface OverloadPayload {
+    current_balance_rub: string;
+    current_capacity_leads: number;
+    would_be_required_leads: number;
+    deficit_leads: number;
+}
+
+defineProps<{
+    modelValue: boolean;
+    payload: OverloadPayload | null;
+}>();
+
+defineEmits<{
+    'update:modelValue': [value: boolean];
+    'save-blocked': [];
+    'set-zero': [];
+}>();
+</script>
+
+<template>
+    <v-dialog
+        :model-value="modelValue"
+        max-width="520"
+        @update:model-value="$emit('update:modelValue', $event)"
+    >
+        <v-card v-if="payload" data-testid="overload-dialog">
+            <v-card-title>Лимит превышает баланс</v-card-title>
+            <v-card-text>
+                <p>
+                    У тебя {{ payload.current_balance_rub }}₽ =
+                    {{ payload.current_capacity_leads }} лидов по текущему тарифу.
+                </p>
+                <p>После сохранения нужно {{ payload.would_be_required_leads }} лидов.</p>
+                <p class="font-weight-medium">Не хватает: {{ payload.deficit_leads }} лидов.</p>
+                <p class="text-medium-emphasis mt-2">
+                    Чтобы проект начал работать — пополни счёт, поставь его лимит 0
+                    или уменьши лимиты других проектов.
+                </p>
+            </v-card-text>
+            <v-card-actions>
+                <v-spacer />
+                <v-btn variant="text" data-testid="overload-cancel" @click="$emit('update:modelValue', false)">
+                    Отмена
+                </v-btn>
+                <v-btn variant="text" data-testid="overload-set-zero" @click="$emit('set-zero')">
+                    Поставить лимит 0
+                </v-btn>
+                <v-btn
+                    color="primary"
+                    variant="flat"
+                    data-testid="overload-save-blocked"
+                    @click="$emit('save-blocked')"
+                >
+                    Сохранить и приостановить
+                </v-btn>
+            </v-card-actions>
+        </v-card>
+    </v-dialog>
+</template>
diff --git a/app/resources/js/layouts/AppLayout.vue b/app/resources/js/layouts/AppLayout.vue
index 2233c0b0..072df2e3 100644
--- a/app/resources/js/layouts/AppLayout.vue
+++ b/app/resources/js/layouts/AppLayout.vue
@@ -14,16 +14,19 @@ import { RouterView, useRoute } from 'vue-router';
 import { useAuthStore } from '../stores/auth';
 import { useNotificationsStore } from '../stores/notifications';
 import { useRemindersStore } from '../stores/reminders';
+import { useTenantStore } from '../stores/tenantStore';
 import { usePolling } from '../composables/usePolling';
 import { POLLING_INTERVAL_MS, POLLING_REMINDERS_INTERVAL_MS } from '../constants/polling';
 import AppSidebar from '../components/layout/AppSidebar.vue';
 import AppTopbar from '../components/layout/AppTopbar.vue';
 import DevIndexBadge from '../components/DevIndexBadge.vue';
 import CommandPalette from '../components/layout/CommandPalette.vue';
+import BalanceFrozenBanner from '../components/billing/BalanceFrozenBanner.vue';
 
 const auth = useAuthStore();
 const notifications = useNotificationsStore();
 const reminders = useRemindersStore();
+const tenant = useTenantStore();
 const route = useRoute();
 
 const drawerOpen = ref(true);
@@ -60,12 +63,19 @@ async function loadReminderCounts(): Promise<void> {
     await reminders.refreshCounts();
 }
 
+async function loadBalanceStatus(): Promise<void> {
+    if (!auth.user) return;
+    await tenant.load();
+}
+
 onMounted(() => {
     void loadNotifications();
     void loadReminderCounts();
+    void loadBalanceStatus();
 });
 usePolling(loadNotifications, { intervalMs: POLLING_INTERVAL_MS, enabled: true });
 usePolling(loadReminderCounts, { intervalMs: POLLING_REMINDERS_INTERVAL_MS, enabled: true });
+usePolling(loadBalanceStatus, { intervalMs: POLLING_REMINDERS_INTERVAL_MS, enabled: true });
 </script>
 
 <template>
@@ -74,6 +84,11 @@ usePolling(loadReminderCounts, { intervalMs: POLLING_REMINDERS_INTERVAL_MS, enab
         <AppTopbar :page-title="currentPageTitle" @toggle-drawer="drawerOpen = !drawerOpen" />
 
         <v-main class="app-main">
+            <BalanceFrozenBanner
+                :frozen="tenant.frozen"
+                :deficit-rub="tenant.deficitRub"
+                :deficit-leads="tenant.deficitLeads"
+            />
             <RouterView v-slot="{ Component, route: r }">
                 <Transition :name="(r.meta.transition as string) ?? 'ld-route-fadeup'" mode="out-in">
                     <component :is="Component" :key="r.fullPath" />
diff --git a/app/resources/js/stores/tenantStore.ts b/app/resources/js/stores/tenantStore.ts
new file mode 100644
index 00000000..58193177
--- /dev/null
+++ b/app/resources/js/stores/tenantStore.ts
@@ -0,0 +1,43 @@
+import { defineStore } from 'pinia';
+import { computed, ref } from 'vue';
+import * as billingApi from '../api/billing';
+import type { BalanceStatus } from '../api/billing';
+
+/**
+ * Tenant-store: статус баланса текущего тенанта для UI префлайта (Billing v2
+ * Spec C Task 1.10). Единый источник для глобального баннера заморозки
+ * (BalanceFrozenBanner в AppLayout) и индикатора ёмкости (BalanceCapacityIndicator
+ * в BillingView) — чтобы не делать два запроса.
+ *
+ * Загружается глобально в AppLayout (load + polling). `load()` молча проглатывает
+ * ошибку: баннер/индикатор не критичны и не должны валить страницу.
+ */
+export const useTenantStore = defineStore('tenant', () => {
+    const status = ref<BalanceStatus | null>(null);
+
+    const frozen = computed(() => status.value?.frozen_by_balance_at != null);
+    const deficitRub = computed(() => status.value?.deficit_rub ?? '0.00');
+    const deficitLeads = computed(() => status.value?.deficit_leads ?? 0);
+    const balanceRub = computed(() => status.value?.balance_rub ?? '0.00');
+    const capacityLeads = computed(() => status.value?.capacity_leads ?? 0);
+    const requiredLeadsPerDay = computed(() => status.value?.required_leads_per_day ?? 0);
+
+    async function load(): Promise<void> {
+        try {
+            status.value = await billingApi.getBalanceStatus();
+        } catch {
+            // Не критично — оставляем прошлый статус (или null → баннер скрыт).
+        }
+    }
+
+    return {
+        status,
+        frozen,
+        deficitRub,
+        deficitLeads,
+        balanceRub,
+        capacityLeads,
+        requiredLeadsPerDay,
+        load,
+    };
+});
diff --git a/app/resources/js/views/BillingView.vue b/app/resources/js/views/BillingView.vue
index 022a532e..57f42a68 100644
--- a/app/resources/js/views/BillingView.vue
+++ b/app/resources/js/views/BillingView.vue
@@ -11,6 +11,7 @@
  */
 import { ref, computed, onMounted } from 'vue';
 import BalanceCard from '../components/billing/BalanceCard.vue';
+import BalanceCapacityIndicator from '../components/billing/BalanceCapacityIndicator.vue';
 import TierPricesPanel from '../components/billing/TierPricesPanel.vue';
 import TransactionsTable from '../components/billing/TransactionsTable.vue';
 import InvoicesTable from '../components/billing/InvoicesTable.vue';
@@ -19,8 +20,10 @@ import ChargesTab from './billing/ChargesTab.vue';
 import { formatPlain, featureLabel } from '../composables/billingFormatters';
 import { getWallet, type Wallet } from '../api/billing';
 import { extractErrorMessage } from '../api/client';
+import { useTenantStore } from '../stores/tenantStore';
 
 const activeView = ref<'overview' | 'charges'>('overview');
+const tenant = useTenantStore();
 
 const wallet = ref<Wallet | null>(null);
 const loading = ref(true);
@@ -59,10 +62,15 @@ async function onTopupSuccess(): Promise<void> {
     topupOpen.value = false;
     topupSnackbar.value = true;
     await loadWallet();
+    // Пополнение могло снять заморозку → обновляем статус баланса (баннер/индикатор).
+    await tenant.load();
     txTableRef.value?.refresh();
 }
 
-onMounted(loadWallet);
+onMounted(() => {
+    void loadWallet();
+    void tenant.load();
+});
 
 defineExpose({ loadWallet, wallet, topupOpen });
 </script>
@@ -117,6 +125,14 @@ defineExpose({ loadWallet, wallet, topupOpen });
                         @topup="topupOpen = true"
                     />
 
+                    <BalanceCapacityIndicator
+                        v-if="tenant.status"
+                        class="mt-3"
+                        :balance-rub="tenant.balanceRub"
+                        :capacity-leads="tenant.capacityLeads"
+                        :required-leads-per-day="tenant.requiredLeadsPerDay"
+                    />
+
                     <TierPricesPanel :tiers="tiersPreview" :current-tier-no="currentTierNo" />
 
                     <TransactionsTable ref="txTableRef" />
diff --git a/app/resources/js/views/projects/NewProjectDialog.vue b/app/resources/js/views/projects/NewProjectDialog.vue
index 6fbd7ac9..2d5e3f20 100644
--- a/app/resources/js/views/projects/NewProjectDialog.vue
+++ b/app/resources/js/views/projects/NewProjectDialog.vue
@@ -190,6 +190,13 @@
             </v-card-actions>
         </v-card>
     </v-dialog>
+
+    <ProjectLimitOverloadDialog
+        v-model="overloadOpen"
+        :payload="overloadPayload"
+        @save-blocked="onOverloadSaveBlocked"
+        @set-zero="onOverloadSetZero"
+    />
 </template>
 
 <script setup lang="ts">
@@ -199,6 +206,7 @@ import { REGIONS, FEDERAL_DISTRICT_NAMES } from '../../constants/regions';
 import { repositionMenuAfterOpen } from '../../utils/menuRepositionFix';
 import type { Project } from '../../stores/projectsStore';
 import DevIndexBadge from '../../components/DevIndexBadge.vue';
+import ProjectLimitOverloadDialog from '../../components/projects/ProjectLimitOverloadDialog.vue';
 
 const selectableRegions = REGIONS.filter((r) => r.code !== 0);
 
@@ -225,6 +233,16 @@ const errors = reactive<Record<string, string[]>>({});
 const saving = ref(false);
 const generalError = ref<string | null>(null);
 
+// Spec C §6.2: префлайт баланса — диалог перегрузки лимита по 409.
+interface OverloadPayloadShape {
+    current_balance_rub: string;
+    current_capacity_leads: number;
+    would_be_required_leads: number;
+    deficit_leads: number;
+}
+const overloadOpen = ref(false);
+const overloadPayload = ref<OverloadPayloadShape | null>(null);
+
 // Plan 4 Task 4: обязательный выбор региона + явная «Вся РФ» с подтверждением.
 // vsyaRf — чекбокс выбран; vsyaRfConfirmed — подтверждён через предупреждение.
 // На бэке regions=[] (Вся РФ) и «забыл» неотличимы → гейт намеренно UI-only.
@@ -303,6 +321,37 @@ watch(
     { immediate: true },
 );
 
+async function persist(extra: Record<string, unknown> = {}): Promise<void> {
+    saving.value = true;
+    try {
+        await ensureCsrfCookie();
+        const body = { ...form, ...extra };
+        if (props.mode === 'edit' && props.project) {
+            await apiClient.patch(`/api/projects/${props.project.id}`, body);
+        } else {
+            await apiClient.post('/api/projects', body);
+        }
+        overloadOpen.value = false;
+        emit('saved');
+        close();
+    } catch (e: unknown) {
+        const err = e as {
+            response?: { status?: number; data?: { error?: string; errors?: Record<string, string[]> } };
+        };
+        // Spec C §6.2: лимит превышает баланс — открываем диалог перегрузки.
+        if (err.response?.status === 409 && err.response.data?.error === 'balance_insufficient') {
+            overloadPayload.value = err.response.data as OverloadPayloadShape;
+            overloadOpen.value = true;
+        } else if (err.response?.status === 422 && err.response.data?.errors) {
+            Object.assign(errors, err.response.data.errors);
+        } else {
+            generalError.value = extractErrorMessage(e);
+        }
+    } finally {
+        saving.value = false;
+    }
+}
+
 async function submit() {
     generalError.value = null;
     Object.keys(errors).forEach((k) => delete errors[k]);
@@ -313,26 +362,18 @@ async function submit() {
         return;
     }
 
-    saving.value = true;
-    try {
-        await ensureCsrfCookie();
-        if (props.mode === 'edit' && props.project) {
-            await apiClient.patch(`/api/projects/${props.project.id}`, { ...form });
-        } else {
-            await apiClient.post('/api/projects', { ...form });
-        }
-        emit('saved');
-        close();
-    } catch (e: unknown) {
-        const err = e as { response?: { status?: number; data?: { errors?: Record<string, string[]> } } };
-        if (err.response?.status === 422 && err.response.data?.errors) {
-            Object.assign(errors, err.response.data.errors);
-        } else {
-            generalError.value = extractErrorMessage(e);
-        }
-    } finally {
-        saving.value = false;
-    }
+    await persist();
+}
+
+// Spec C §6.2 — исходы диалога перегрузки лимита.
+async function onOverloadSaveBlocked(): Promise<void> {
+    await persist({ force_save_blocked: true });
+}
+
+async function onOverloadSetZero(): Promise<void> {
+    form.daily_limit_target = 0;
+    overloadOpen.value = false;
+    await persist();
 }
 
 function close() {
diff --git a/app/routes/web.php b/app/routes/web.php
index 23219c68..31815574 100644
--- a/app/routes/web.php
+++ b/app/routes/web.php
@@ -189,6 +189,7 @@ Route::middleware(['auth:sanctum', 'tenant'])->prefix('/api/billing/charges')->g
 Route::middleware(['auth:sanctum', 'tenant'])->prefix('/api/billing')->group(function () {
     Route::post('/topup', 'App\Http\Controllers\Api\BillingController@topup');
     Route::get('/wallet', 'App\Http\Controllers\Api\BillingController@wallet');
+    Route::get('/balance-status', 'App\Http\Controllers\Api\BillingController@balanceStatus');
     Route::get('/transactions', 'App\Http\Controllers\Api\BillingController@transactions');
     Route::get('/invoices', 'App\Http\Controllers\Api\BillingController@invoices');
 });
diff --git a/app/tests/Feature/Billing/BalanceStatusTest.php b/app/tests/Feature/Billing/BalanceStatusTest.php
new file mode 100644
index 00000000..3ba2650e
--- /dev/null
+++ b/app/tests/Feature/Billing/BalanceStatusTest.php
@@ -0,0 +1,107 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\Project;
+use App\Models\Tenant;
+use App\Models\User;
+use Database\Seeders\PricingTierSeeder;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+
+uses(DatabaseTransactions::class);
+
+/**
+ * GET /api/billing/balance-status — статус баланса для UI префлайта (Billing v2
+ * Spec C Task 1.10): питает баннер заморозки (BalanceFrozenBanner) и индикатор
+ * ёмкости (BalanceCapacityIndicator).
+ *
+ * PricingTierSeeder: ступень 1 — 100 лидов × 500₽ (см. BillingOverviewControllerTest).
+ */
+beforeEach(function () {
+    $this->seed(PricingTierSeeder::class);
+    $this->tenant = Tenant::factory()->create([
+        'balance_rub' => '5000.00',
+        'delivered_in_month' => 0,
+        'frozen_by_balance_at' => null,
+    ]);
+    $this->user = User::factory()->create(['tenant_id' => $this->tenant->id]);
+    $this->actingAs($this->user);
+});
+
+test('GET /api/billing/balance-status: структура ответа', function () {
+    $this->getJson('/api/billing/balance-status')
+        ->assertOk()
+        ->assertJsonStructure([
+            'frozen_by_balance_at',
+            'balance_rub',
+            'capacity_leads',
+            'required_leads_per_day',
+            'deficit_leads',
+            'deficit_rub',
+        ]);
+});
+
+test('balance-status: хватает баланса — deficit=0, не заморожен', function () {
+    // 5000₽ при ступени 1 (500₽/лид) = 10 лидов ёмкости. Проект лимит 5 — впритык.
+    Project::factory()->create([
+        'tenant_id' => $this->tenant->id,
+        'is_active' => true,
+        'daily_limit_target' => 5,
+    ]);
+
+    $resp = $this->getJson('/api/billing/balance-status')->assertOk();
+
+    expect($resp->json('balance_rub'))->toBe('5000.00');
+    expect($resp->json('capacity_leads'))->toBe(10);
+    expect($resp->json('required_leads_per_day'))->toBe(5);
+    expect($resp->json('deficit_leads'))->toBe(0);
+    expect($resp->json('deficit_rub'))->toBe('0.00');
+    expect($resp->json('frozen_by_balance_at'))->toBeNull();
+});
+
+test('balance-status: не хватает — deficit_leads + deficit_rub точные', function () {
+    // Ёмкость = 10 лидов. Проект лимит 25 → нужно 25, дефицит 15 лидов.
+    // minBalanceForLeads(25) = 25 × 500₽ = 12500₽ → deficit_rub = 12500 − 5000 = 7500.00.
+    Project::factory()->create([
+        'tenant_id' => $this->tenant->id,
+        'is_active' => true,
+        'daily_limit_target' => 25,
+    ]);
+
+    $resp = $this->getJson('/api/billing/balance-status')->assertOk();
+
+    expect($resp->json('capacity_leads'))->toBe(10);
+    expect($resp->json('required_leads_per_day'))->toBe(25);
+    expect($resp->json('deficit_leads'))->toBe(15);
+    expect($resp->json('deficit_rub'))->toBe('7500.00');
+});
+
+test('balance-status: required исключает inactive и preflight_blocked проекты', function () {
+    Project::factory()->create([
+        'tenant_id' => $this->tenant->id, 'is_active' => true, 'daily_limit_target' => 5,
+    ]);
+    Project::factory()->create([
+        'tenant_id' => $this->tenant->id, 'is_active' => false, 'daily_limit_target' => 100,
+    ]);
+    Project::factory()->create([
+        'tenant_id' => $this->tenant->id, 'is_active' => true, 'daily_limit_target' => 100,
+        'preflight_blocked_at' => now(),
+    ]);
+
+    $resp = $this->getJson('/api/billing/balance-status')->assertOk();
+
+    expect($resp->json('required_leads_per_day'))->toBe(5);
+});
+
+test('balance-status: возвращает frozen_by_balance_at когда установлен', function () {
+    $this->tenant->update(['frozen_by_balance_at' => now()]);
+
+    $resp = $this->getJson('/api/billing/balance-status')->assertOk();
+
+    expect($resp->json('frozen_by_balance_at'))->not->toBeNull();
+});
+
+test('GET /api/billing/balance-status без auth: 401', function () {
+    auth()->logout();
+    $this->getJson('/api/billing/balance-status')->assertStatus(401);
+});
diff --git a/app/tests/Frontend/BalanceCapacityIndicator.spec.ts b/app/tests/Frontend/BalanceCapacityIndicator.spec.ts
new file mode 100644
index 00000000..0ab1e7f4
--- /dev/null
+++ b/app/tests/Frontend/BalanceCapacityIndicator.spec.ts
@@ -0,0 +1,46 @@
+import { describe, it, expect } from 'vitest';
+import { mount } from '@vue/test-utils';
+import BalanceCapacityIndicator from '../../resources/js/components/billing/BalanceCapacityIndicator.vue';
+
+// Billing v2 Spec C Task 1.10 — подсказка под балансом (§3.6). Чистый
+// presentational-компонент: статус по соотношению ёмкости и требуемого/день.
+
+describe('BalanceCapacityIndicator', () => {
+    it('зелёный, когда ёмкости хватает на 3+ дня', () => {
+        const w = mount(BalanceCapacityIndicator, {
+            props: { balanceRub: '3000.00', capacityLeads: 90, requiredLeadsPerDay: 25 },
+        });
+        expect(w.text()).toContain('90');
+        expect(w.classes()).toContain('capacity-ok');
+    });
+
+    it('жёлтый, когда ёмкости хватает меньше чем на 3 дня', () => {
+        const w = mount(BalanceCapacityIndicator, {
+            props: { balanceRub: '1000.00', capacityLeads: 30, requiredLeadsPerDay: 25 },
+        });
+        expect(w.classes()).toContain('capacity-warning');
+    });
+
+    it('красный, когда ёмкости меньше требуемого', () => {
+        const w = mount(BalanceCapacityIndicator, {
+            props: { balanceRub: '500.00', capacityLeads: 10, requiredLeadsPerDay: 25 },
+        });
+        expect(w.classes()).toContain('capacity-insufficient');
+    });
+
+    it('зелёный (бесконечный запас), когда проекты ничего не заказывают', () => {
+        const w = mount(BalanceCapacityIndicator, {
+            props: { balanceRub: '500.00', capacityLeads: 10, requiredLeadsPerDay: 0 },
+        });
+        expect(w.classes()).toContain('capacity-ok');
+    });
+
+    it('показывает баланс, ёмкость и дневной заказ', () => {
+        const w = mount(BalanceCapacityIndicator, {
+            props: { balanceRub: '1000.00', capacityLeads: 30, requiredLeadsPerDay: 25 },
+        });
+        expect(w.text()).toContain('1000.00');
+        expect(w.text()).toContain('30');
+        expect(w.text()).toContain('25');
+    });
+});
diff --git a/app/tests/Frontend/BalanceFrozenBanner.spec.ts b/app/tests/Frontend/BalanceFrozenBanner.spec.ts
new file mode 100644
index 00000000..e5da52b0
--- /dev/null
+++ b/app/tests/Frontend/BalanceFrozenBanner.spec.ts
@@ -0,0 +1,48 @@
+import { describe, it, expect } from 'vitest';
+import { mount } from '@vue/test-utils';
+import { createVuetify } from 'vuetify';
+import BalanceFrozenBanner from '../../resources/js/components/billing/BalanceFrozenBanner.vue';
+
+// Billing v2 Spec C Task 1.10 — красный баннер заморозки (§3.6). Показывается
+// на всех страницах, когда tenant.frozen_by_balance_at !== null.
+
+const routerLinkStub = {
+    RouterLink: {
+        props: ['to'],
+        inheritAttrs: false,
+        template: '<a v-bind="$attrs" :href="to"><slot /></a>',
+    },
+};
+
+const mountBanner = (props: { frozen: boolean; deficitRub?: string; deficitLeads?: number }) =>
+    mount(BalanceFrozenBanner, {
+        props,
+        global: { plugins: [createVuetify()], stubs: routerLinkStub },
+    });
+
+describe('BalanceFrozenBanner', () => {
+    it('не заморожен — баннер не рендерится', () => {
+        const w = mountBanner({ frozen: false });
+        expect(w.find('[data-testid="balance-frozen-banner"]').exists()).toBe(false);
+    });
+
+    it('заморожен — красный баннер с текстом «приостановлен»', () => {
+        const w = mountBanner({ frozen: true, deficitRub: '380.00', deficitLeads: 10 });
+        const banner = w.find('[data-testid="balance-frozen-banner"]');
+        expect(banner.exists()).toBe(true);
+        expect(banner.text()).toContain('приостановлен');
+    });
+
+    it('показывает дефицит в рублях и лидах', () => {
+        const w = mountBanner({ frozen: true, deficitRub: '380.00', deficitLeads: 10 });
+        const text = w.find('[data-testid="balance-frozen-banner"]').text();
+        expect(text).toContain('380');
+        expect(text).toContain('10');
+    });
+
+    it('две ссылки — на /billing и на /projects', () => {
+        const w = mountBanner({ frozen: true, deficitRub: '380.00', deficitLeads: 10 });
+        expect(w.find('[data-testid="banner-topup-link"]').attributes('href')).toBe('/billing');
+        expect(w.find('[data-testid="banner-projects-link"]').attributes('href')).toBe('/projects');
+    });
+});
diff --git a/app/tests/Frontend/BillingView.spec.ts b/app/tests/Frontend/BillingView.spec.ts
index ae31c0f7..e4e9cc14 100644
--- a/app/tests/Frontend/BillingView.spec.ts
+++ b/app/tests/Frontend/BillingView.spec.ts
@@ -1,5 +1,6 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { mount, flushPromises } from '@vue/test-utils';
+import { createPinia, setActivePinia } from 'pinia';
 import { createVuetify } from 'vuetify';
 import BillingView from '../../resources/js/views/BillingView.vue';
 import * as billingApi from '../../resources/js/api/billing';
@@ -31,13 +32,14 @@ function makeWallet(): Wallet {
 
 describe('BillingView.vue', () => {
     beforeEach(() => {
+        setActivePinia(createPinia());
         vi.mocked(billingApi.getWallet).mockResolvedValue(makeWallet());
     });
 
     const factory = () =>
         mount(BillingView, {
             global: {
-                plugins: [vuetify],
+                plugins: [vuetify, createPinia()],
                 stubs: { TransactionsTable: true, InvoicesTable: true, ChargesTab: true, TopupDialog: true },
             },
         });
diff --git a/app/tests/Frontend/NewProjectDialog.spec.ts b/app/tests/Frontend/NewProjectDialog.spec.ts
index 835e3b7f..7629d475 100644
--- a/app/tests/Frontend/NewProjectDialog.spec.ts
+++ b/app/tests/Frontend/NewProjectDialog.spec.ts
@@ -104,4 +104,42 @@ describe('NewProjectDialog', () => {
         await flushPromises();
         expect(apiClient.post).toHaveBeenCalledWith('/api/projects', expect.objectContaining({ regions: [82, 83] }));
     });
+
+    it('409 balance_insufficient → открывает диалог перегрузки; save-blocked пере-сабмитит с force_save_blocked', async () => {
+        // Spec C §6.2 (Task 1.10): первый POST падает 409, второй (после выбора
+        // «Сохранить и приостановить») уходит с force_save_blocked=true.
+        (apiClient.post as ReturnType<typeof vi.fn>).mockRejectedValueOnce({
+            response: {
+                status: 409,
+                data: {
+                    error: 'balance_insufficient',
+                    current_balance_rub: '1000.00',
+                    current_capacity_leads: 30,
+                    would_be_required_leads: 50,
+                    deficit_leads: 20,
+                },
+            },
+        });
+
+        const wrapper = factory();
+        await flushPromises();
+        // Проходим гейт обязательного региона через подтверждённую «Вся РФ».
+        (wrapper.vm as unknown as { confirmVsyaRf: () => void }).confirmVsyaRf();
+        await (wrapper.vm as unknown as { submit: () => Promise<void> }).submit();
+        await flushPromises();
+
+        const overload = wrapper.find('[data-testid="overload-dialog"]');
+        expect(overload.exists()).toBe(true);
+        expect(overload.text()).toContain('20');
+
+        await wrapper.find('[data-testid="overload-save-blocked"]').trigger('click');
+        await flushPromises();
+
+        expect(apiClient.post).toHaveBeenCalledTimes(2);
+        expect(apiClient.post).toHaveBeenLastCalledWith(
+            '/api/projects',
+            expect.objectContaining({ force_save_blocked: true }),
+        );
+        expect(wrapper.emitted('saved')).toBeTruthy();
+    });
 });
diff --git a/app/tests/Frontend/ProjectLimitOverloadDialog.spec.ts b/app/tests/Frontend/ProjectLimitOverloadDialog.spec.ts
new file mode 100644
index 00000000..a6e5033d
--- /dev/null
+++ b/app/tests/Frontend/ProjectLimitOverloadDialog.spec.ts
@@ -0,0 +1,60 @@
+import { describe, it, expect } from 'vitest';
+import { mount } from '@vue/test-utils';
+import { createVuetify } from 'vuetify';
+import ProjectLimitOverloadDialog from '../../resources/js/components/projects/ProjectLimitOverloadDialog.vue';
+
+// Billing v2 Spec C Task 1.10 — диалог перегрузки лимита (§6.2). Принимает
+// 409-payload `balance_insufficient`, эмитит решение пользователя.
+
+const payload = {
+    current_balance_rub: '1000.00',
+    current_capacity_leads: 30,
+    would_be_required_leads: 50,
+    deficit_leads: 20,
+};
+
+const mountDialog = () =>
+    mount(ProjectLimitOverloadDialog, {
+        props: { modelValue: true, payload },
+        global: {
+            plugins: [createVuetify()],
+            stubs: { VDialog: { template: '<div><slot /></div>' } },
+        },
+    });
+
+describe('ProjectLimitOverloadDialog', () => {
+    it('рендерит данные 409-payload', () => {
+        const w = mountDialog();
+        const text = w.text();
+        expect(text).toContain('1000.00');
+        expect(text).toContain('30');
+        expect(text).toContain('50');
+        expect(text).toContain('20');
+    });
+
+    it('«Сохранить и приостановить» эмитит save-blocked', async () => {
+        const w = mountDialog();
+        await w.find('[data-testid="overload-save-blocked"]').trigger('click');
+        expect(w.emitted('save-blocked')).toBeTruthy();
+    });
+
+    it('«Поставить лимит 0» эмитит set-zero', async () => {
+        const w = mountDialog();
+        await w.find('[data-testid="overload-set-zero"]').trigger('click');
+        expect(w.emitted('set-zero')).toBeTruthy();
+    });
+
+    it('«Отмена» закрывает диалог (update:modelValue=false)', async () => {
+        const w = mountDialog();
+        await w.find('[data-testid="overload-cancel"]').trigger('click');
+        expect(w.emitted('update:modelValue')?.[0]).toEqual([false]);
+    });
+
+    it('payload=null — без падения, ничего не рендерит', () => {
+        const w = mount(ProjectLimitOverloadDialog, {
+            props: { modelValue: true, payload: null },
+            global: { plugins: [createVuetify()], stubs: { VDialog: { template: '<div><slot /></div>' } } },
+        });
+        expect(w.find('[data-testid="overload-save-blocked"]').exists()).toBe(false);
+    });
+});

From da591b9c004eab6f19fbe4e4830fca7ef9b62bdb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <noreply@anthropic.com>
Date: Mon, 25 May 2026 08:53:12 +0300
Subject: [PATCH 12/13] =?UTF-8?q?fix(billing-v2-c):=20RLS-=D0=BA=D0=BE?=
 =?UTF-8?q?=D0=BD=D1=82=D0=B5=D0=BA=D1=81=D1=82=20=D0=B2=20BalancePrefligh?=
 =?UTF-8?q?tSweepJob=20(jobs/CLI=20hotfix)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

CLI и queue не проходят через SetTenantContext → app.current_tenant_id не выставлен → projects RLS падает 'unrecognized configuration parameter'. Зеркалим SetTenantContext: DB::transaction + SET LOCAL (PgBouncer-safe). Затрагивает initial-sweep + ночной cron @18:00 MSK.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 .../Jobs/Billing/BalancePreflightSweepJob.php | 58 +++++++++++--------
 1 file changed, 33 insertions(+), 25 deletions(-)

diff --git a/app/app/Jobs/Billing/BalancePreflightSweepJob.php b/app/app/Jobs/Billing/BalancePreflightSweepJob.php
index b5aca412..b5dcde80 100644
--- a/app/app/Jobs/Billing/BalancePreflightSweepJob.php
+++ b/app/app/Jobs/Billing/BalancePreflightSweepJob.php
@@ -50,36 +50,44 @@ final class BalancePreflightSweepJob implements ShouldQueue
      */
     private function evaluateTenant(Tenant $tenant, BalancePreflightService $service, Collection $tiers): void
     {
-        $required = $tenant->requiredLeadsForTomorrow();
-        $result = $service->evaluate(
-            balanceRub: (string) $tenant->balance_rub,
-            deliveredInMonth: (int) $tenant->delivered_in_month,
-            requiredLeads: $required,
-            tiers: $tiers,
-        );
+        // Spec C deploy hotfix (25.05.2026): CLI-команды и фоновые джобы не проходят
+        // через SetTenantContext middleware → app.current_tenant_id не выставлен →
+        // RLS-policy на projects падает с "unrecognized configuration parameter".
+        // Зеркалим mechanic SetTenantContext: SET LOCAL внутри транзакции (PgBouncer-safe).
+        DB::transaction(function () use ($tenant, $service, $tiers): void {
+            DB::statement('SET LOCAL app.current_tenant_id = '.(int) $tenant->id);
 
-        $isFrozen = $tenant->frozen_by_balance_at !== null;
+            $required = $tenant->requiredLeadsForTomorrow();
+            $result = $service->evaluate(
+                balanceRub: (string) $tenant->balance_rub,
+                deliveredInMonth: (int) $tenant->delivered_in_month,
+                requiredLeads: $required,
+                tiers: $tiers,
+            );
 
-        // Переход active → frozen.
-        if (! $result->passes && ! $isFrozen) {
-            $tenant->frozen_by_balance_at = now();
-            $tenant->save();
-            $this->logEvent($tenant, 'frozen', 'cutoff_18msk', $result);
-            Mail::queue(new BalanceFrozenMail($tenant, $result));
+            $isFrozen = $tenant->frozen_by_balance_at !== null;
 
-            return;
-        }
+            // Переход active → frozen.
+            if (! $result->passes && ! $isFrozen) {
+                $tenant->frozen_by_balance_at = now();
+                $tenant->save();
+                $this->logEvent($tenant, 'frozen', 'cutoff_18msk', $result);
+                Mail::queue(new BalanceFrozenMail($tenant, $result));
 
-        // Переход frozen → active.
-        if ($result->passes && $isFrozen) {
-            $tenant->frozen_by_balance_at = null;
-            $tenant->save();
-            $this->logEvent($tenant, 'unfrozen', 'cutoff_18msk', $result);
-            Mail::queue(new BalanceUnfrozenMail($tenant, $result));
+                return;
+            }
 
-            return;
-        }
-        // Иначе состояние не изменилось — ничего не делаем (идемпотентность).
+            // Переход frozen → active.
+            if ($result->passes && $isFrozen) {
+                $tenant->frozen_by_balance_at = null;
+                $tenant->save();
+                $this->logEvent($tenant, 'unfrozen', 'cutoff_18msk', $result);
+                Mail::queue(new BalanceUnfrozenMail($tenant, $result));
+
+                return;
+            }
+            // Иначе состояние не изменилось — ничего не делаем (идемпотентность).
+        });
     }
 
     private function logEvent(Tenant $tenant, string $event, string $trigger, PreflightResult $result): void

From fea1443b1838aecc61b3810acf2e52f479b08f07 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?=
 <noreply@anthropic.com>
Date: Tue, 26 May 2026 06:50:28 +0300
Subject: [PATCH 13/13] =?UTF-8?q?feat(billing-v2-c):=20online=20supplier?=
 =?UTF-8?q?=20sync=20=D0=BD=D0=B0=20freeze/unfreeze=20(=D0=BF=D1=80=D0=B8?=
 =?UTF-8?q?=D0=B2=D1=8F=D0=B7=D0=BA=D0=B0=20=D0=BA=20SupplierExportMode)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

При переходе active→frozen или frozen→active BalancePreflightSweepJob теперь дёргает SyncSupplierProjectJob per-project, если admin-переключатель в режиме online. В batch (рабочем для будущего масштаба) — sync отложен до cut-off cron 18:00 MSK через SyncSupplierProjectsJob.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 .../Jobs/Billing/BalancePreflightSweepJob.php | 30 +++++++++++
 .../Billing/BalancePreflightSweepJobTest.php  | 54 +++++++++++++++++++
 2 files changed, 84 insertions(+)

diff --git a/app/app/Jobs/Billing/BalancePreflightSweepJob.php b/app/app/Jobs/Billing/BalancePreflightSweepJob.php
index b5dcde80..d7e9fa9b 100644
--- a/app/app/Jobs/Billing/BalancePreflightSweepJob.php
+++ b/app/app/Jobs/Billing/BalancePreflightSweepJob.php
@@ -4,12 +4,14 @@ declare(strict_types=1);
 
 namespace App\Jobs\Billing;
 
+use App\Jobs\SyncSupplierProjectJob;
 use App\Mail\BalanceFrozenMail;
 use App\Mail\BalanceUnfrozenMail;
 use App\Models\PricingTier;
 use App\Models\Tenant;
 use App\Services\Billing\BalancePreflightService;
 use App\Services\Billing\PreflightResult;
+use App\Services\Supplier\SupplierExportMode;
 use Illuminate\Bus\Queueable;
 use Illuminate\Contracts\Queue\ShouldQueue;
 use Illuminate\Database\Eloquent\Collection;
@@ -73,6 +75,7 @@ final class BalancePreflightSweepJob implements ShouldQueue
                 $tenant->save();
                 $this->logEvent($tenant, 'frozen', 'cutoff_18msk', $result);
                 Mail::queue(new BalanceFrozenMail($tenant, $result));
+                $this->dispatchSupplierSyncIfOnline($tenant);
 
                 return;
             }
@@ -83,6 +86,7 @@ final class BalancePreflightSweepJob implements ShouldQueue
                 $tenant->save();
                 $this->logEvent($tenant, 'unfrozen', 'cutoff_18msk', $result);
                 Mail::queue(new BalanceUnfrozenMail($tenant, $result));
+                $this->dispatchSupplierSyncIfOnline($tenant);
 
                 return;
             }
@@ -90,6 +94,32 @@ final class BalancePreflightSweepJob implements ShouldQueue
         });
     }
 
+    /**
+     * Spec C extension (26.05.2026): при переходе freeze ↔ unfreeze в режиме 'online'
+     * диспатчим точечный sync с поставщиком per-project (group-recalc внутри handleOnline
+     * сам учтёт шеринг через signal_identifier). В режиме 'batch' изменения уезжают
+     * cut-off cron'ом @18:00 MSK через SyncSupplierProjectsJob (множественный).
+     * Привязка к админ-переключателю SupplierExportMode (system_settings.supplier_export_mode).
+     *
+     * Вызывается ВНУТРИ DB::transaction обёртки evaluateTenant — app.current_tenant_id выставлен,
+     * RLS-фильтрация projects работает.
+     */
+    private function dispatchSupplierSyncIfOnline(Tenant $tenant): void
+    {
+        if (! SupplierExportMode::isOnline()) {
+            return;
+        }
+
+        $projectIds = $tenant->projects()
+            ->where('is_active', true)
+            ->whereNull('preflight_blocked_at')
+            ->pluck('id');
+
+        foreach ($projectIds as $id) {
+            SyncSupplierProjectJob::dispatch((int) $id);
+        }
+    }
+
     private function logEvent(Tenant $tenant, string $event, string $trigger, PreflightResult $result): void
     {
         DB::connection('pgsql_supplier')->table('balance_freeze_log')->insert([
diff --git a/app/tests/Feature/Billing/BalancePreflightSweepJobTest.php b/app/tests/Feature/Billing/BalancePreflightSweepJobTest.php
index 0d94bf4a..49e537e6 100644
--- a/app/tests/Feature/Billing/BalancePreflightSweepJobTest.php
+++ b/app/tests/Feature/Billing/BalancePreflightSweepJobTest.php
@@ -3,6 +3,7 @@
 declare(strict_types=1);
 
 use App\Jobs\Billing\BalancePreflightSweepJob;
+use App\Jobs\SyncSupplierProjectJob;
 use App\Mail\BalanceFrozenMail;
 use App\Models\PricingTier;
 use App\Models\Project;
@@ -10,6 +11,7 @@ use App\Models\Tenant;
 use Illuminate\Foundation\Testing\DatabaseTransactions;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Mail;
+use Illuminate\Support\Facades\Queue;
 use Tests\Concerns\SharesSupplierPdo;
 
 // Изоляция: liderra_testing persistent (RefreshDatabase off). DatabaseTransactions
@@ -62,3 +64,55 @@ it('is idempotent — does not re-freeze already frozen tenant', function () {
     expect($tenant->fresh()->frozen_by_balance_at->timestamp)->toBe($frozenAt->timestamp);
     Mail::assertNotQueued(BalanceFrozenMail::class, fn ($mail) => $mail->tenant->id === $tenant->id);
 });
+
+// Spec C extension (26.05.2026): freeze/unfreeze дёргают supplier sync в режиме 'online'.
+// Привязка к существующему админ-переключателю SupplierExportMode (system_settings.supplier_export_mode).
+// Online нужен сейчас для отладки (моментальный sync с поставщиком); batch будет рабочим режимом
+// при росте числа клиентов (накопленные изменения уезжают одним cut-off-cron'ом в 18:00 MSK).
+
+it('dispatches SyncSupplierProjectJob for each active project on freeze when supplier mode is online', function () {
+    Mail::fake();
+    Queue::fake();
+    DB::table('system_settings')->updateOrInsert(['key' => 'supplier_export_mode'], ['value' => 'online']);
+
+    // 500₽ / 50₽ = 10 лидов; 2 проекта по 15 = 30 → заморозка.
+    $tenant = Tenant::factory()->create(['balance_rub' => '500.00', 'frozen_by_balance_at' => null]);
+    $p1 = Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 15]);
+    $p2 = Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 15]);
+
+    (new BalancePreflightSweepJob)->handle();
+
+    expect($tenant->fresh()->frozen_by_balance_at)->not->toBeNull();
+    Queue::assertPushed(SyncSupplierProjectJob::class, fn (SyncSupplierProjectJob $job) => $job->projectId === $p1->id);
+    Queue::assertPushed(SyncSupplierProjectJob::class, fn (SyncSupplierProjectJob $job) => $job->projectId === $p2->id);
+});
+
+it('does NOT dispatch SyncSupplierProjectJob on freeze when supplier mode is batch', function () {
+    Mail::fake();
+    Queue::fake();
+    DB::table('system_settings')->updateOrInsert(['key' => 'supplier_export_mode'], ['value' => 'batch']);
+
+    $tenant = Tenant::factory()->create(['balance_rub' => '500.00', 'frozen_by_balance_at' => null]);
+    Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 25]);
+
+    (new BalancePreflightSweepJob)->handle();
+
+    expect($tenant->fresh()->frozen_by_balance_at)->not->toBeNull();
+    // batch-режим: sync с поставщиком отложен до cut-off 18:00 MSK через SyncSupplierProjectsJob (множественный).
+    Queue::assertNotPushed(SyncSupplierProjectJob::class, fn (SyncSupplierProjectJob $job) => $job->projectId === Project::query()->where('tenant_id', $tenant->id)->value('id'));
+});
+
+it('dispatches SyncSupplierProjectJob on unfreeze when supplier mode is online', function () {
+    Mail::fake();
+    Queue::fake();
+    DB::table('system_settings')->updateOrInsert(['key' => 'supplier_export_mode'], ['value' => 'online']);
+
+    // 2000₽ / 50₽ = 40 лидов; хотят 25 → разморозка.
+    $tenant = Tenant::factory()->create(['balance_rub' => '2000.00', 'frozen_by_balance_at' => now()->subDay()]);
+    $project = Project::factory()->for($tenant)->create(['is_active' => true, 'daily_limit_target' => 25]);
+
+    (new BalancePreflightSweepJob)->handle();
+
+    expect($tenant->fresh()->frozen_by_balance_at)->toBeNull();
+    Queue::assertPushed(SyncSupplierProjectJob::class, fn (SyncSupplierProjectJob $job) => $job->projectId === $project->id);
+});