5fd18c35b161ae1b628bc9dd091fed23d3d8d2b3
5 Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
 Дмитрий
|
026e71a283 |
feat(смс-клиент): цена по накоплению за месяц, а не по объёму одного заказа
Этап 3 «Время и цена», Task 6. Строки листа 3.8, 3.9, 3.10, 3.14. Клиент, разбивший месяц на десять рассылок по сто номеров, платил по самой дорогой ступени, хотя отправил тысячу. Авто-СМС и вовсе всегда считалась по самой дорогой: в ступень уезжало число сегментов одного сообщения. Теперь ступень берётся для «сколько отправлено в этом месяце плюс объём самого заказа», и спрашивают об этом все три места сразу — предпросмотр, создание рассылки и авто-СМС на новый лид. Счётчик живёт в одном месте (ClientSmsVolumeCounter): его зовёт цена, а в Task 7 позовёт экран. Отдельного накопительного счётчика в базе не завожу намеренно — счётчик, разъехавшийся с журналом, опаснее лишнего запроса; журнал правдив, потому что деньги списываются той же записью. Считаем в СМС, а не в сообщениях (В-108). Длинное письмо — это два СМС, и платит клиент за два; считая строки журнала, мы держали бы его на дорогой ступени дольше обещанного, а цифра на экране «в этом месяце отправлено N СМС» разошлась бы со списанными деньгами. Ради этого в журнале появилась колонка segments (схема v9.14) и частичный индекс под единственный запрос счётчика. Пусто у старых записей = одно СМС (В-109). Граница месяца — по Москве, а не по Гринвичу (В-110): 31 июля 21:30 UTC это уже 1 августа в Москве. Не путать с окном 10–20 — там время местное у получателя, здесь московское у клиента. Цена по-прежнему фиксируется в момент создания и джобом не пересчитывается (3.14). 🔴 Мина, найденная самопроверкой (В-114): авто-СМС считала бы объём месяца ВНЕ изоляции по клиенту. В запросе экрана контекст ставит middleware, а в очереди — никто, и на бою счётчик вернул бы честный ноль: клиента молча посчитали бы по самой дорогой ступени, без единой ошибки в журнале. Тестами не ловится — на стенде изоляция не применяется. Счёт переехал внутрь tenant-транзакции, как и деньги в том же джобе. 🧹 Убран прежний estimateRub (В-113): он считал смету по ступени для объёма одного заказа, без накопленного, и больше не звался. Оставленный «на всякий случай» второй расчёт цены — это место, которое однажды позовут, и цифры разъедутся. Прогоны: СМС 229/229 (пачками по 3–4 файла — целиком локальная база уже не тянет, В-112), приём лидов 17/17, фронт 1663 зелёных, phpstan 0 своих, pint чисто. Вырезанием проверено четырежды: вернул старый расчёт в контроллер — покраснел тест через настоящий запрос экрана; убрал запись числа СМС в журнал — покраснел тест отправки; засчитал песочные — счётчик дал 12 вместо 1; перенёс границу месяца на Гринвич — покраснел тест границы. Живьём на локальной базе (20:17 МСК, песочница, ДаДата заглушена): предпросмотр до накопления 9.00 ₽, после 5 000 отправленных — 8.00 ₽; песочная рассылка ушла, в журнале «СМС=1», счётчик месяца остался нулём; у прежней рассылки цена так и осталась 9.00 ₽, а новый заказ уже шёл бы по 8.00 ₽. Стенд возвращён как был. Реальное списание по накопленной ступени доказано тестом, а не живьём: в песочнице деньги не двигаются (В-81). 🪤 Урок В-111: джоб авто-СМС глотает любой сбой и молча выходит — «ноль без причины» в тестах надо смотреть в журнале сервера, там лежала точная строка про мою описку. |
||
|
Дмитрий
|
d61b552532 |
feat(смс-клиент): ДаДата даёт регион и оператора всем номерам, снимок дозревает
Этап 3 «Время и цена», Task 5. Строка листа 3.3 закрыта целиком. Номер, про который мы ничего не знаем, перестал быть тупиком: теперь его судьбу решает ДаДата — и решает ОДНИМ платным вопросом, потому что пояс и оператор приезжают в одном ответе. Входов обогащения три, и все три ведут в одно и то же место. Своя база: джоб обогащения контактов кладёт пояс рядом с оператором и догоняет номера, загруженные до Этапа 3, — берёт контакт, у которого пусто хоть что-то одно. Без догона такой номер после выката не получил бы СМС никогда. Рассылка: новый EnrichClientSmsSnapshotRegionJob спрашивает про строки снимка без пояса и пишет туда и пояс, и оператора. У номеров, вписанных руками, оператора не было вовсе — это и есть закрытие старой жалобы В-69. Ставится из контроллера сразу после снимка и только если такие строки есть; узнав регион, сам будит рассылку, чтобы созревшие номера не ждали четверть часа зря. Будит ТОЛЬКО ждущую утра: у остановленной клиентом рассылки статус другой, и повторный запуск затёр бы ей «остановлена» на «готово». Авто-СМС: сделка без региона спрашивает ДаДату по номеру лида (В-100) — иначе заведённый руками лид не получил бы СМС и после этой задачи. За номер платим один раз: узнанный пояс несётся в самом отложенном задании, а «ответила, но пояса нет» помечается отметкой; заново спрашиваем только если вопрос не состоялся — сбой сети или выбранный дневной лимит (В-104). Дозревание: команда добора ставит окончательную причину строкам, которые ждут региона дольше суток, и будит рассылку, чтобы та дописала причину в журнал и закончилась — деньги размораживаются. В журнал пишет джоб отправки, он это и так умеет для всех пропущенных; второго места, пишущего в журнал, не завёл (В-107). Кого НЕ спрашиваем (В-105): строку, у которой пояс есть, а оператор пуст. Она и так уйдёт универсальным каналом, вопрос был бы ради экономии на канале, а ДаДата — наши деньги: рассылка на 20 000 номеров это до 12 000 ₽ при ещё не назначенном потолке расходов (В-90). Платим только там, где без ответа сообщение не уйдёт вовсе. Прогоны: СМС 217/217 (было 202, +15 новых), приём лидов 17/17, фронт 1663 зелёных, phpstan 0, pint чисто. Миграций нет — колонки пояса завёл ещё Task 2. Вырезанием проверено пятью вырезами: убрал запись пояса — покраснел «узнав регион, номер уходит»; убрал суточный срок — покраснел «не узнали за сутки»; убрал вторую половину условия пробуждения — покраснел денежный тест про заморозку; убрал вопрос ДаДате в авто-СМС — покраснели три теста третьего входа; убрал догон старых номеров базы — покраснел «догоняет уже загруженный номер». Живьём на локальной базе (19:19 МСК, ДаДата заглушена, живой ключ не тронут): вписанные руками номера узнали пояс и оператора, московский ушёл сразу, камчатский отложен до 10 утра его времени; номер, про который ДаДата молчит, через сутки получил причину и рассылка стала «готово»; сделка без региона получила авто-СМС по ответу ДаДаты, а сделка, про которую ДаДата молчит, ждёт дальше и в журнал не пишет. Стенд возвращён как был. 🪤 Урок В-106: повторный Http::fake() прежнюю заглушку не заменяет — отвечает первая, и тест «а теперь ДаДата отвечает» молча проверяет старый ответ. 🟢 Запрет на выкат ветки СНЯТ (был из-за В-93): ни один источник больше не отправляет ноль. Выкатывать всё равно рано — Этап 3 не закончен, цена считается по-старому. |
||
|
Дмитрий
|
2460623ae0 |
feat(смс-клиент): ночной лид получает авто-СМС утром и ровно одно
Этап 3 «Время и цена», Task 4. Строка листа 3.6, дозакрыта 3.1. Авто-СМС на новый лид больше не будит людей ночью. Джоб спрашивает про час у того же SmsQuietHours, что и рассылка, и если у ПОЛУЧАТЕЛЯ окно закрыто — переставляет сам себя на момент его открытия. В журнал при этом не пишет ничего: идемпотентность у авто-СМС — по наличию любой записи по этому лиду, и запись «ждём утра» навсегда закрыла бы лиду дорогу (класс поломки В-49). «Ровно одно» держит прежняя защита: три запуска подряд дают одно сообщение. Проверка стоит ПОСЛЕ отбора, а не сразу после идемпотентности, как предлагал план. Сначала выясняется, уйдёт ли номер вообще (стоп-лист, дубль, нет маршрута), и только потом — когда именно. Иначе номеру из стоп-листа вместо окончательной причины досталось бы «ждём региона», и человек ждал бы отправки, которой не будет никогда (В-67). Контрольный тест это стережёт: перенос проверки вперёд его роняет. Москву при пустом регионе не подставляем. План велел «нет региона — считаем московским», но эту запись владелец отменил (В-85, журнал В-98): вставь я её дословно, камчатский лид, пришедший в московский вечер, получил бы СМС в четыре утра. Сделка без региона сутки ждёт уточнения — джоб переставляет себя раз в час и молчит, — потом получает одну честную запись skipped_unknown_region. Подписи причины заведены в обоих словарях экрана сразу (ловушка В-70), хотя журнала авто-СМС на портале пока нет вовсе — это существующая дыра, названа отдельно (В-102). Старым тестам авто-СМС проставлен регион в фикстурах и зафиксирован час: тот же ремонт, что в В-93 — боевое правило не ослаблял. Прогоны: СМС 202/202 (было 195, 7 новых тестов), приём лидов 17/17, фронт 1663 зелёных, phpstan 0, pint чисто, типы — те же 8 чужих давних. Миграций нет. Вырезанием проверено четырежды: убрал проверку окна — покраснели три теста; убрал суточный срок — покраснел тест про честную причину; поставил проверку региона до стоп-листа — покраснели «дверь открыта» и контрольный про стоп-лист; убрал подпись из словаря журнала — покраснел фронтовый тест. Живьём на локальной базе (18:15 в Москве, 03:15 на Камчатке): московский лид ушёл сразу, камчатский отложен на 22:00 UTC — это десять утра следующего дня у него; свежая сделка без региона отложена на час, двухдневная получила причину. Затем открыл окно камчатской и запустил трижды — сообщение одно. Стенд возвращён как был. 🪤 Урок В-101: под тестовой очередью «переставить себя» исполняется немедленно — джоб зовёт себя без конца и прогон виснет. В таких тестах обязателен Queue::fake(). ⚠️ Ветку по-прежнему нельзя выкатывать до Task 5 (В-93). |
||
|
Дмитрий
|
c47c3fb4d5 |
fix(смс-клиент): недосписание при повторе, срок для рассылки по сделкам, заслонка баланса + понятный интерфейс
Корректность/деньги: - джоб рассылки: списание ПОШТУЧНО и атомарно с записью в журнал, ключ идемпотентности на номер, факт из БД — нет недосписания при падении посреди рассылки и повторе - валидация: срок обязателен при source=deals, иначе выборка по всей истории сделок - «Отправить» гаснет при нехватке свободного баланса; index отдаёт баланс/заморозку - помесячный джоб имени: устойчив к пустым настройкам, сигнал в лог при автоотключении за долг - цена одного авто-СМС + подтверждение при включении авто-рассылки - загрузка контактов сообщает число нераспознанных номеров Понятность для клиента: - «СМС» вместо «сегментов», «пробный режим» вместо «песочницы», человеческие причины пропуска, шаги 1-2-3, выгода своего имени, факт вместо оценки в таблице, имя и текст в подтверждении Тесты: бэкенд ClientSms 83/83, фронт СМС 50/50, приём лидов 10/10; pint/stan чисто. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|
Дмитрий
|
51b8f501ae |
feat(смс-клиент): бэкенд имени и авто-рассылки
Жизненный цикл имени: клиент requestSender (freeze первого месяца) / disableSender; админ approve (charge+release, active, paid_until+1мес) / reject / disable. Помесячная оплата ChargeSmsNameFeeJob (проверка средств ДО списания, долг>29 дней→suspended, идемпотентно по external_key), расписание в console.php. Авто-рассылка: DealSmsObserver (защитный, freshness-guard, НИКОГДА не роняет приём лида) → SendAutoSmsForDealJob (best-effort, идемпотентно по deal_id, песочница/деньги/маршрут). Действующее имя кампании = active-имя тенанта иначе liderra.ru. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |