Compare commits

..
84 Commits
Author SHA1 Message Date
tremble7681 caed1c340e fix(mechanic): вернуть выдачу резины и запчастей — слить origin/main (пропали после деплоя 05.10 из feat/driver-pwa без складских экранов)
Разрешение конфликтов: ремонты/хуки — наша ветка (в проде с 05.10),
склад/меню/маршруты — origin/main; меню — эмодзи-стиль владельца + все
плитки; в repairsCreate добавлены PartCatalogItem/searchParts для складских
экранов.
2026-10-08 18:54:06 +10:00
tremble7681 782f079cc7 Merge remote-tracking branch 'origin/main' into feat/driver-pwa
# Conflicts:
#	mechanic-pwa/frontend/src/App.tsx
#	mechanic-pwa/frontend/src/api/repairsCreate.ts
#	mechanic-pwa/frontend/src/api/repairsFeed.ts
#	mechanic-pwa/frontend/src/pages/ActionMenu.tsx
#	mechanic-pwa/frontend/src/pages/repairs/CreateRepairPage.tsx
#	mechanic-pwa/frontend/src/pages/repairs/EditRepairPage.tsx
#	mechanic-pwa/frontend/src/pages/repairs/RepairDetailPage.tsx
#	mechanic-pwa/frontend/src/pages/repairs/RepairsFeedPage.tsx
2026-10-08 18:50:38 +10:00
tremble7681 16c932d0b1 feat(bonuses): экран «Бонусы» возвращён — только участникам, остальным закрыто
Поэтапное внедрение вышло на старт: программы запущены, водители
подключаются адресно. Вход на главной и витрина — только у водителей
с включёнными программами (programs_enabled); неучастнику — заглушка.
Внутри — карточки только его программ (уровень = программа «Стаж»),
цели уже фильтрует бэкенд по адресности. Revert экрана (f6bc3da)
откатан, экран доработан под адресность.
2026-10-06 20:59:57 +10:00
tremble7681 7034c6aaae Reapply "feat(bonuses): экран «Бонусы» — уровень, серии, цели, история"
This reverts commit f6bc3da47b.
2026-10-06 20:51:29 +10:00
tremble7681 205e6d6d10 fix(inspections): фото больше не теряются — сжатие + персистентная очередь (6929)
Причина потерь: камера отдаёт 3–8 МБ, по LTE PUT длится дольше осмотра,
механик закрывал PWA — fetch убивался, фото пропадало (1010 шт за полгода).
- сжатие до 1600px JPEG q0.82 перед отправкой (~10x быстрее)
- очередь на IndexedDB: сериально, 5 попыток с бэкоффом, доигрывается
  после перезапуска приложения; фолбэк в память без IDB
- «Завершить осмотр» заблокирован, пока грузятся фото (N в кнопке)
- слот: «В очереди/Загружаю…», при отказе — «Повторить»
- карточка осмотра: failed-фото не показываем пустышками, бейдж
  «не загрузилось фото: N»; слот с failed предлагает снять заново
2026-10-06 00:36:07 +10:00
tremble7681 7d1864fa63 chore(bonuses): комментарий-маяк про спрятанный экран и catch-all для старых push-ссылок 2026-10-05 23:59:05 +10:00
tremble7681 f6bc3da47b Revert "feat(bonuses): экран «Бонусы» — уровень, серии, цели, история"
This reverts commit e6e1d705b3.
2026-10-05 23:53:42 +10:00
tremble7681 e6e1d705b3 feat(bonuses): экран «Бонусы» — уровень, серии, цели, история
- /bonuses: уровень (Новичок→Легенда) с прогрессом до следующего, заработанное,
  карточки программ (заказы недели с тиром, скидка 70+, оплата вовремя,
  без нарушений, код друга), ближайшие цели, история начислений
- карточка-вход на главной под «Пополнить» (скрывается, если бонус-API недоступен)
- push «Бонус начислен» ведёт сюда же (deep link через guard+returnTo)
2026-10-05 22:53:45 +10:00
tremble7681andClaude Opus 5.5 ab2ad8d471 feat(nav): кнопка «Назад» на каждом экране + правило для новых разделов (задача 6385)
На айфоне у установленного приложения нет системной «назад», а жест от края
после холодного старта или открытия из пуша не делает ничего — водитель
застревал в «Уведомлениях», на ожидании Telegram и оплаты, на спиннере штрафа.

- Все экраны заводятся в таблице src/routes.tsx с обязательным родителем
  (null — только у главной и входа); App рисует <Route> только из неё.
- BackBar над маршрутами показывает «Назад» (44 px) в любом состоянии экрана.
  Логика в lib/back.ts: есть история этого запуска (history.state.idx > 0) —
  шаг назад, нет — на родителя с replace.
- Тест-сторож обходит таблицу с зависшей сетью и требует «Назад» на каждом
  экране с родителем; список «корневых» экранов закреплён.
- После входа/оплаты/выхода переходы с replace — «Назад» не возвращает на
  отработанную форму; экраны входа уводят вошедшего на главную.
- Фильтр выписки (?kind=, период) и вход по коду (?by=code) — в адресе:
  «Назад» из штрафа возвращает к списку штрафов.
- ErrorBoundary вместо белого экрана при падении.
- driver-pwa/CLAUDE.md — правило и чек-лист нового раздела.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 21:53:48 +10:00
tremble7681andClaude Opus 5 7d8f4b8998 feat(login): вход по номеру телефона основным способом + починка уведомлений
Экран входа через МТС ID (/login/mts) и перестановка приоритетов: «Войти по
номеру телефона» теперь первая кнопка, Telegram и код ушли вниз запасными.
Показ решает бэкенд (/driver/auth/mts/status), а не флаг во фронте: пустой
client_id возвращает Telegram на первое место — экрана без единой кнопки входа
быть не должно.

Отказ оператора ведёт в Telegram, а не в повтор. Причина денежная: каждая
попытка через оператора платная, и при сбое доставки (видели на Tele2) водитель
сжигал бы по нескольку подряд, так и не войдя.

От Seamless отказались. Запрос к оператору обязан уйти с устройства по HTTP, а мы
работаем по HTTPS: из кода это режет mixed content, и остаётся всплывающее окно,
которое установленное PWA даёт через раз. Две живые проверки дали СМС, а выигрыш
был бы в секундах, не в деньгах. Тест сторожит, чтобы окно не вернулось молча.

Починки, найденные по дороге:

* поле телефона срезало ведущую «7», но не «8»: набор с восьмёрки давал сдвинутый
  номер (+7 890 250-61-09 вместо +7 902 506-10-90) и отказ «номер не найден».
  Плюс «+7» рисовался маской и появлялся лишь после первой цифры — по пустому
  экрану было не понять, с какой цифры начинать. Теперь префикс отдельным
  элементом и виден всегда;
* подписка на пуши расходилась с сервером молча. `currentState` считал уведомления
  включёнными по наличию подписки В БРАУЗЕРЕ, не спрашивая сервер. Подписка
  переживает выход и смену водителя — после входа другим водителем приложение
  прятало кнопку, а сервер про подписку не знал. Кнопки «выключить» нет намеренно,
  так что выхода из этого состояния не было. Теперь при каждом входе подписка
  молча отдаётся серверу заново (эндпоинт переписывает её на текущего водителя),
  а строка состояния больше не молчит: «Уведомления включены» вместо пустоты;
* `serviceWorker.ready` при незарегистрированном воркере не резолвится НИКОГДА —
  включение зависало без тоста и без следа на сервере. Сторож на 10 секунд;
* любой сбой включения превращался в «Не удалось включить уведомления» без
  причины. Теперь в скобках код: (sw-timeout), (AbortError) — по нему чинится;
* `isStandalone` звал window.matchMedia без проверки: в части WebView его нет, и
  падал бы весь экран входа из-за необязательной подсказки.

Предложение поставить приложение на домашний экран — на экране входа. Где браузер
даёт `beforeinstallprompt` (Chrome, Edge, Samsung) — настоящая кнопка установки;
на iOS дословная инструкция, потому что без установки там не работают пуши вовсе.
Слушатель события висит с загрузки модуля: Chrome стреляет им один раз и обычно
до монтирования React.

В текстах для водителя убраны штрафы и долги как повод что-то сделать: «поставьте
приложение, чтобы мы сообщали о штрафах» читается угрозой и работает против самой
просьбы. Зовём удобством.

Иконки: углы были залиты белым, скругление нарисовано прямо в файле. У maskable
это ломало Android — он обрезает своей маской, а там вокруг скруглённого квадрата
ещё и белые поля. Все четыре пересобраны как плоский красный с белым глифом;
скругление отдано системе.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-22 21:53:49 +10:00
tremble7681andClaude Fable 5 a2557897a0 fix(login): обратный отсчёт кода + возврат на оплату после входа
Жалоба: по ссылке на оплату жмёшь «получить код» — «слишком часто».
- на шаге кода кнопка «отправить ещё раз» с отсчётом (60с, синхронно с
  бэкендом); на 429 ведём отсчёт по Retry-After и не пугаем
- кнопка «Получить код» блокируется на время кулдауна
- RequireAuth запоминает путь (ссылку на оплату); после входа по коду и
  через Telegram возвращаем туда, а не на баланс

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-27 15:22:05 +10:00
tremble7681andClaude Fable 5 a7d5f27b53 tests(pwa): часы в тестах баланса заморожены — мок-штраф не выпадает из окна недели
Экран режет постановления по периоду «последние 7 дней от сегодня», а даты
в моках фиксированные: с 21.08 штраф от 13.08 вышел из окна, и два теста
падали на чистом HEAD. Морозим только Date (таймеры настоящие, иначе
userEvent/waitFor зависнут) на 18.08 — день, когда появился фильтр.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-24 20:49:54 +10:00
tremble7681andClaude Fable 5 0c433280fe balance: экран опрашивает себя после оплаты — итог обновляется на глазах
Первая обратная связь: «очень долго обновляется баланс». Экран показывал
старый итог, пока приложение не перезапустят: перезапроса по расписанию не
было вовсе.

- баланс опрашивается каждые 4 сек, пока висит «Зачисляется» ЛИБО в последние
  5 минут была платёжная активность (lib/paymentWatch, отметка в
  sessionStorage — переживает перезагрузку страницы при возврате из банка)
- отметка ставится при создании платежа (TopupPage) и при факте оплаты
  (PaymentPage): опрос успевает застать появление «Зачисляется» при
  запаздывающем вебхуке и не гаснет раньше, чем снимок баланса догонит платёж
  при сбое точечного обновления на бэке

Парная правка бэкенда — crm2 b64ea35 (запись в 1С каждые 15 сек + точечный
снимок баланса).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-24 20:38:49 +10:00
tremble7681andClaude Opus 5 80ac25ee0f Продление сессии: приложение подхватывает свежий токен из ответа
Бэкенд с пятого дня жизни токена кладёт продлённый в заголовок X-Driver-Token
(crm2, modules/payments/driver_auth). Здесь — подмена: тридцать дней начинают
считаться от последнего захода, а не от входа, и водитель перестаёт раз в месяц
упираться в экран входа.

Подменяем только тот токен, с которым сами ушли. Сеанс мог смениться, пока
запрос был в пути — водитель вышел, сотрудник начал просмотр от чужого лица, —
и продление чужого ответа вернуло бы закрытый сеанс к жизни. Просмотр от лица
водителя не продлеваем: его восемь часов сознательные.

README: приложение запущено для всех 22.08.2026, гейт по номерам снят. Раздел
оставлен как инструкция на случай, если вход снова понадобится сузить.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-22 22:19:42 +10:00
tremble7681andClaude Opus 5 00006ed51b Лента уведомлений: колокольчик, экран и честная отметка «прочитано»
Пуш живёт до первого смахивания, сообщение в боте тонет в переписке — и
разговор «мне ничего не приходило» упирался в слово против слова. Теперь у
водителя есть место, куда посмотреть, а у парка — отметка о прочтении, которая
ставится ровно тогда, когда человек открыл ленту или нажал на уведомление.

Отмечаем ПОСЛЕ показа списка, а не при загрузке: иначе счётчик гаснет у того,
кто мазнул по экрану и ушёл. Время первого прочтения бэкенд не переписывает.

Нажатие по пушу: воркер сам отметить не может (токен лежит в хранилище
страницы, ему недоступном), поэтому номер уведомления приезжает в пуше, воркер
добавляет его к адресу параметром, а страница отмечает и параметр убирает.

Колокольчик по умолчанию выключен в общей шапке и включён только на главной:
шапка стоит на каждом экране, и незачем ходить за счётчиком с оплаты.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-19 23:24:55 +10:00
tremble7681andClaude Opus 5 9aa71d6ca7 feat(pwa): тумблер боевой оплаты в отладке
Выключен по умолчанию: пополнение под просмотром открывает учебный экран. Включён
— платёж уходит в банк, и над кнопкой «Оплатить» появляется предупреждение, что
деньги спишутся по-настоящему и зачислятся водителю.

Режим гаснет вместе с выходом из учётки сотрудника: следующий раз он включается
осознанно, а не достаётся по наследству.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-19 17:30:55 +10:00
tremble7681andClaude Opus 5 7342a6c9d5 feat(pwa): на экране только включение уведомлений, выключения нет
Строка предлагает включить, пока уведомления выключены, и исчезает, когда они
включены. Кнопка «выключить» рядом с балансом только подталкивала бы отказаться
от двух событий, ради которых приложение и открывают.

Отключение при этом никуда не делось: оно осталось системным — в настройках
уведомлений телефона или в настройках сайта в браузере, там же, где человек
управляет всеми остальными приложениями.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-19 13:30:19 +10:00
tremble7681andClaude Opus 5 4b30b4bbbe feat(pwa): предложение включить уведомления после установки
Карточка появляется в установленном приложении (и сразу по событию appinstalled),
объясняет пользу — новый штраф, дошедшее пополнение — и только по кнопке вызывает
системное окно.

Порядок именно такой, потому что системное окно показывается ОДИН раз за
установку: отказ браузер запоминает навсегда, и переспросить нечем. Своё
предложение отказа не стоит — «не сейчас» откладывает разговор на неделю.

Во вкладке браузера карточку не показываем: на iPhone уведомления существуют
только в установленном приложении, а человеку, ещё не решившему, нужен ли ему
сайт, вопрос про уведомления мешает.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-19 10:50:23 +10:00
tremble7681andClaude Opus 5 562a6d35fe feat(pwa): свой сервис-воркер и включение уведомлений
Воркер теперь собирается через injectManifest: generateSW умеет только кэш, а
уведомление показывает именно воркер — страница при этом может быть закрыта.
Нажатие на уведомление переиспользует уже открытое окно, а не плодит второе.

Включение — строкой на главном экране, по нажатию. Не всплывающим окном на
входе: разрешение спрашивается один раз за установку, отказ браузер запоминает
навсегда, и потраченная впустую попытка закрывает канал. Если сервер уведомления
не настроил — разрешение не запрашиваем вовсе.

Отдельные тексты вместо молчания: на iPhone без установки на домашний экран
уведомления невозможны в принципе, и об этом сказано прямо.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-19 10:29:43 +10:00
tremble7681andClaude Opus 5 0a09570d98 refactor(pwa): штрафы живут только на главном экране
Отдельный список штрафов удалён: два списка одного и того же в разных местах
сбивали с толку. Фильтр «Штрафы» внизу главного экрана теперь показывает сами
постановления, а не проводки по ним, и ведёт в карточку с фотографией.

Разница между постановлением и проводкой здесь принципиальная: штраф, который
водитель оплатил сам, парк не выставлял — проводки нет, и в выписке он бы не
появился вовсе (Морозов, штраф от 16.08). Строка «Долг по штрафам» вверху теперь
включает этот фильтр, а не уводит на другой экран.

Период действует и на штрафы: календарь над списком не должен стоять, ничего не
меняя.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 19:40:06 +10:00
tremble7681andClaude Opus 5 62f8baa80f fix(pwa): под иконкой одно слово — «Водитель»
«Премиум Водитель» под иконкой не помещается: Android обрезает подпись примерно
на двенадцати символах, и на экране оставалось «Премиум» — неотличимо от других
приложений парка. Короткое имя теперь «Водитель», полное («Премиум Водитель»)
осталось для установки и списка приложений.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 19:24:16 +10:00
tremble7681andClaude Opus 5 7204290e45 fix(pwa): штрафы не прячутся за вкладкой «Не погашены»
Водитель, оплативший штраф сам, видел пустой экран: список открывался на
«Не погашены», а там у него ноль (Морозов, штраф от 16.08 — оплачен им, парк его
не выставлял). Выглядело как «приложение потеряло мои штрафы».

Теперь вкладка выбирается по данным: есть непогашенные — открываем их, нет —
открываем «Все». Заодно один запрос вместо двух: список короткий, фильтруем на
месте, и переключение вкладок стало мгновенным.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 19:22:16 +10:00
tremble7681andClaude Opus 5 b0a6b7ec12 fix(pwa): под иконкой подписано «Премиум Водитель»
short_name был «Премиум» — под иконкой на телефоне стояло именно оно, и от
приложения механика оно ничем не отличалось. Плюс apple-mobile-web-app-title:
iOS подпись из манифеста не читает и берёт её только из этого мета-тега.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 18:29:42 +10:00
tremble7681andClaude Opus 5 53394b9478 fix(pwa): иконка приложения — значок сайта, а не отвергнутый знак
Предыдущая иконка была собрана из assets/logos/premium_park_favicon_pack — это
неудачный вариант знака, владелец его забраковал. Ставим то, что стоит на самом
сайте: красная плитка --s-accent с белой «П», как в pptaxi.ru/favicon.svg. Значок
в браузере, на экране телефона и на сайте теперь один.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 18:28:59 +10:00
tremble7681andClaude Opus 5 388c8e7343 feat(pwa): иконка приложения — фирменный знак парка
Была нарисованная «карта» на кремовом фоне из первых набросков. Теперь знак
«Премиум Парк» из фирменного набора, на белой подложке сайта.

Собирается из вектора скриптом scripts/gen-icons.py (три пути, команды M/L/H/V/C,
сглаживание сверхдискретизацией ×4) — прежний gen-icons.mjs рисовал плитку
вручную и к логотипу отношения не имел. Готовый PNG из набора не подошёл: знак
внутри него занимает 264×195 из 512, и на иконке он бы размылился.

Отдельная maskable-версия с полями: Android режет иконку по кругу, и знак без
запаса теряет края. Ссылка apple-touch-icon в index.html — iOS манифест не
читает и берёт иконку «на экран Домой» только оттуда.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 18:08:00 +10:00
tremble7681andClaude Opus 5 3bdd5ce818 feat(pwa): переход в штраф из выписки, заметные даты, минус раздел пополнений
Дата в выписке и в списке штрафов встала первой строкой чернильным цветом: в
этих списках ищут «что было 12-го», а бледная подпись под заголовком для этого
не годилась.

Строка штрафа в выписке стала кнопкой в карточку — там фотография и подробности.
Остальные строки не притворяются ссылками.

Раздел «Мои пополнения» удалён вместе с кнопкой: он показывал только наши
платежи и у большинства водителей был пуст (1С проводит пополнения сама), а те
же операции видны в выписке фильтром «Пополнения».

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 17:58:28 +10:00
tremble7681andClaude Opus 5 0c7735ef85 style(pwa): палитра приложения переведена на палитру сайта pptaxi.ru
Светлый сине-серый фон #EEF1F5, белые карточки, чернильный текст #0F172A,
фирменный красный акцент #DC2626 у кнопки действия, зелёный #059669 у прихода
денег, янтарный #D97706 у предупреждений — токены сняты с живого сайта
(переменные --s-* в его инлайн-CSS).

Имена токенов теперь роли, а не краски: canvas / surface / line / ink / muted /
accent / pos / neg / warn. Прежние cream и ink описывали конкретный цвет, и при
смене палитры «cream» стал бы синим.

Тема браузера и манифест PWA переведены на новый фон — иначе шторка адресной
строки и заставка запуска остаются от прежней темы.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 17:53:08 +10:00
tremble7681andClaude Opus 5 3bf26d3650 fix(pwa): в штрафах только факт и сумма, без кухни расчётов
С карточки убраны строки про номинал постановления, скидку и «в ГИБДД
постановление закрыто», из списка — абзац о том, кто и как платит ГИБДД.
Остаётся то, ради чего экран делался: фотография нарушения, статья, место,
скорость, начисленная сумма и погашен ли долг.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 17:42:59 +10:00
tremble7681andClaude Opus 5 eac59b823c fix(pwa): в штрафах «погашен», а не «оплачен»
Слово «оплачен» водитель читает как «я ничего не должен», а постановление к тому
моменту оплачено парком — не им. Поэтому в списке и карточке состояние теперь
«не погашен / погашен / не выставлялся / уточняется», долг в шапке берётся из
баланса 1С, а карточка объясняет расхождение сумм: «постановление — 750 ₽, парк
оплатил его со скидкой и выставил вам фактическую сумму».

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 17:36:01 +10:00
tremble7681andClaude Opus 5 f4a9da25cf feat(pwa): экран штрафов с фотографиями нарушений
Список с вкладками «Неоплаченные / Все» и суммой долга в шапке; в карточке —
фотография с камеры первой, до реквизитов: по ней водитель узнаёт свою машину и
свою поездку. Дальше сумма, скидка с датой (то, ради чего заходят вовремя),
скорость и разрешённый предел, постановление, камера, ссылка на PDF.

Строка «Долг по штрафам» на главном экране теперь ведёт сюда, а не сразу к
оплате: платить, не поняв за что, человек не станет. Аренда по-прежнему ведёт к
оплате — за тем её и открывают.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 17:18:58 +10:00
tremble7681andClaude Opus 5 9187b5766e feat(pwa): значки операций в выписке
За неделю у активного водителя два десятка строк, и половина одинаковая по виду
(«аренда автомобиля» каждый день) — список сливается в стену текста. Значок даёт
зацепку для глаза: нужное находится, не читая каждую строку.

Подбор по тегу 1С, а не по знаку суммы: аренда, пени, штраф, ДТП, депозит,
пополнение, компенсация, коррекция — у каждого свой. Общий компонент, как в
складе CRM: разложенные по местам иконки разъезжаются размерами при первой правке.

Монохромные намеренно — цвет в этом списке уже занят и означает направление
денег, цветной значок с ним бы спорил.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 17:06:02 +10:00
tremble7681andClaude Opus 5 6becdd036c feat(pwa): аренда и штрафы видны прямо на главном экране
Две статьи, которые водитель проверяет каждый день: за них он платит и из-за них
ему звонят. Стоят под итогом, нажатие ведёт сразу к оплате этой статьи — чаще
всего человек за тем и открыл приложение, а заход в шторку это лишний шаг.

Остальные статьи (депозит, повреждения, прочее) на экран не выносим: они редкие,
им хватает шторки, иначе экран снова превращается в столбик из шести строк и
выписка уезжает за нижний край телефона.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 17:02:13 +10:00
tremble7681andClaude Opus 5 2d4b66d51f feat(pwa): главный экран из двух половин — деньги сверху, выписка снизу
По образцу приложения вендора: баланс в парке и «зачисляется», под ними крупная
кнопка «Пополнить», ниже — период с календарями, фильтры и список операций
(аренда, пени, штрафы, пополнения).

Разбивка по статьям переехала в шторку «Пополнить». Она нужна ровно в момент
выбора, куда платить; всё остальное время это шесть строк, отодвигающих выписку
за нижний край телефона. В шторке только те статьи, в которые платёж проводится.

Экран суммы, придя из шторки, показывает выбранную категорию строкой, а не рядом
чипов: второй выбор того же самого сбивает с толку.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 16:35:01 +10:00
tremble7681andClaude Opus 5 8b0ce4cf45 fix(pwa): экран баланса повторяет карточку CRM
Итог берётся с сервера, а не складывается из строк (1С округляет статьи до
рублей, итог держит с копейками: −8 976 против −8 976,25). Статья, в которую
платёж провести нечем, показывается, но не притворяется кнопкой — «Страховка».
Пустой снимок 1С даёт «Уточняется» вместо нулей.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 15:46:35 +10:00
tremble7681andClaude Opus 5 39ee2b7a49 fix(pwa): код двухфакторки уходит сам, а не ждёт кнопки
Второй шаг входа сотрудника не отправлялся вовсе: у поля с кодом не было ни
обработки Enter, ни автоотправки, а «Готово» на клавиатуре телефона — это как
раз Enter. Со стороны выглядело как «код не принят», хотя запрос на /auth/2fa
не уходил ни разу (в логах бэкенда — только login с ответом «нужен второй шаг»).

Теперь шесть цифр отправляются сразу, Enter тоже работает, поле получает фокус и
autocomplete=one-time-code (подсказка кода из СМС/менеджера паролей).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 15:19:11 +10:00
tremble7681andClaude Opus 5 a0ada7de67 feat(pwa): просмотр чужого экрана больше не выбрасывает из своего аккаунта
Сотрудник, вошедший водителем, при переключении на чужую карточку терял
собственный вход: токен один на приложение, и «посмотреть, как выглядит у
другого» означало заново входить через Telegram.

Теперь свой сеанс откладывается и возвращается кнопкой «Вернуться к своему
аккаунту». Откладывается ровно один раз — на переходе из обычного сеанса:
смена водителя внутри просмотра не должна подменять отложенное чужим токеном.

Заодно вход для сотрудника достижим изнутри приложения: длинный тап по названию
в шапке ведёт на /dev. Ссылкой на экране это не делаем — водителю она ни к чему,
а сотруднику иначе приходится набирать адрес руками.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 15:00:22 +10:00
tremble7681andClaude Opus 5 ceec3db364 feat(pwa): вход для сотрудника, просмотр от лица водителя и вкладка «Отладка»
Приложение обкатывается на боевом контуре, поэтому интерфейс надо проверять на
живых данных — а живые данные лежат у настоящих водителей.

* «Вход для сотрудника» (/dev) — логин учётки CRM, поддержан второй шаг 2FA;
  дальше поиск водителя по ФИО/телефону/id и просмотр его экранов.
* Плашка «Смотрю как …» над всеми экранами: интерфейс в этом режиме неотличим
  от водительского, и чужой баланс легко принять за свой.
* Вкладка «Отладка» (/debug, водителю недоступна): смена водителя, driver_id,
  режим, срок токена, адрес API, коммит и время сборки, журнал последних
  40 ответивших запросов, сброс кэша сервис-воркера.
* Пополнение под просмотром идёт в учебный контур: экран /mock-pay/:orderId
  выбирает, что «ответит» банк, а настоящий экран оплаты разбирает эти статусы
  своим боевым кодом. Ни рубля, ни чека 54-ФЗ.

Заодно доезжает незакоммиченная работа прошлой сессии: дев-прокси в
vite.config.ts, его тест и разобранный .env.example.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 13:15:02 +10:00
tremble7681andClaude Opus 5 aff1a45006 feat(pwa): подтверждение входа, копейки, выбор категории долга
- pairing-сессия хранит poll_secret и confirm_code (lib/pairing), опрос ушёл
  на POST: pair_session уезжал в query-параметре и оседал в access-логах, а
  это половина ключа к JWT. Вторая половина в deep-link не уходит;
- на экране ожидания видно число, которое обязан назвать бот. По чужой ссылке
  человек его не увидит — подтверждать нечего, токен не выдаётся;
- онбординг больше не просит вернуться и запросить код: Telegram подтверждает
  номер шарингом контакта, приложение забирает токен опросом;
- суммы с копейками. formatMoney округлял до рубля, и «к оплате 350 ₽»
  расходилось и со списанием банка, и с чеком (комиссия почти всегда даёт
  копейки). Клавиша разделителя, нарисованная на клавиатуре, наконец работает;
- категорию долга выбирает водитель. Хардкод «Долг аренда» отправлял платёж
  в аренду даже тем, у кого её нет; список приходит с сервера и там же
  проверяется;
- ошибки бэкенда показываются словами (минимум СБП, потолок суммы) вместо
  молчаливого «не удалось», статусы истории переведены полностью, возврат
  денег отличим от отказа.

Тесты: 33 зелёных, tsc чист.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-16 23:54:04 +10:00
tremble7681andClaude Opus 5 5dbf9b1549 feat(mechanic): раздел «История ремонта» в PWA
Задача CRM 4439. Плитка в меню действий → поиск по госномеру → список ремонтов
машины (дата, госномер, модель, пробег, состав работ) → существующая карточка
ремонта. Вход в историю есть и прямо из карточки авто, там же блок последних
ремонтов.

Что стоило внимания:
- поиск ищет и по машинам, выведенным из парка (их ремонты никуда не делись,
  и в осмотрах такая машина видна), но не по проданным — парк ими не занимается.
  Текст пустого результата говорит ровно это: механик с опечаткой в номере
  делает вывод по этой строке, и она обязана совпадать с поведением бэкенда;
- сбой сети отличим от «ничего не нашли», и под ошибкой не остаётся выдача
  прошлого запроса — иначе можно тапнуть и уехать в историю чужой машины;
- «Назад» возвращает туда, откуда пришли (лента, история машины, карточка авто),
  а не в ленту всего парка. Прямая ссылка при пустом стеке не запирает экран;
- форма правки больше не оставляет лишнюю запись в стеке: до этого «Назад» из
  карточки ремонта после «Отмены» возвращал обратно в форму правки;
- история и блок в карточке авто запрашивают ленту без фото — превью там не
  рисуется, а бэкенд ради него лазил в хранилище на каждую строку.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-07 18:24:21 +10:00
tremble7681andClaude Opus 5 1dca1fe3c9 feat(pwa): экран оплаты честно показывает отказ, таймаут и возврат
Экран успеха рисовался только при PAID. При любом другом финальном статусе
опрос останавливался, а человек навсегда оставался на «Ожидаем оплату…» со
спиннером — то есть два из трёх тестовых сценариев СБП глазами не проверить.

- ветки отказа (в том числе исчерпанных попыток), истёкшего срока и возврата
  средств: у возврата свой текст, новая попытка там ни при чём;
- ошибка запроса больше не выглядит как честное ожидание: после серии неудач
  подряд экран говорит, что не может проверить оплату, и даёт повторить.
  Раньше 404, 500 и рестарт бэкенда были неотличимы от «ждём оплату»;
- плашка способа оплаты показывала «СБП» и при оплате картой;
- после перезагрузки страницы сумма бралась из пустого router state и
  показывалась как 0 ₽ — лучше не показать ничего, чем показать неправду.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-06 18:12:13 +10:00
tremble7681 9742da439a feat(pwa): balance hero shows net «Баланс» (was «Общий долг» of negatives) 2026-06-20 00:59:53 +10:00
tremble7681andclaude-flow d2cd7632a5 fix(pwa): keep PWA alive during TG login (anchor opens Telegram, app polls on /tg-wait)
window.location.href=deep_link navigated the whole PWA to t.me, destroying the
/tg-wait polling screen -> the authenticated token was never fetched. Prefetch
the pairing session and open Telegram via an <a href> (OS app-switch, PWA stays
mounted polling); add an Open-Telegram fallback link on the wait screen.

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-19 23:44:57 +10:00
tremble7681andclaude-flow 5ab4e9e74e fix(pwa): TgWaitPage redirects to login when no pairing session
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-19 23:07:06 +10:00
tremble7681 01c36ce935 feat(pwa): Telegram login primary + code fallback + TgWaitPage 2026-06-19 23:00:31 +10:00
tremble7681 0ec8f0b540 feat(pwa): usePairPoll hook (polls tg pairing, sets session) 2026-06-19 22:56:26 +10:00
tremble7681 bd1a4a31bd feat(pwa): tg verified-login api (tgSession/tgPoll) + schemas 2026-06-19 22:52:52 +10:00
tremble7681andclaude-flow b419a456fe fix(pwa): onboarding deep_links — make tg/max optional (MAX not configured in prod)
Backend omits channels without a configured username; strict zod schema
threw on missing 'max', surfacing as 'Не удалось отправить код' instead of
routing to the onboarding screen. Make both optional + regression test.

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 23:05:12 +10:00
tremble7681andclaude-flow 08ebc09814 docs(pwa): plan fix (keypad reduce) + gitignore tsbuildinfo
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 22:23:32 +10:00
tremble7681andclaude-flow e5a2874ba7 feat(driver-pwa): onboarding renders only configured bot channels
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 22:05:08 +10:00
tremble7681andclaude-flow adad929769 feat(driver-pwa): friendly toast on 429 (rate-limited code request)
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 20:33:46 +10:00
tremble7681andclaude-flow 479b9699ea feat(driver-pwa): top-up fetches commission rate from backend (no hardcoded rate)
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 20:27:39 +10:00
tremble7681andclaude-flow b7dc826f0f feat(driver-pwa): real MVP PWA icons (192/512, cream+card motif) + generator
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 20:10:33 +10:00
tremble7681andclaude-flow 15d7f34689 polish(driver-pwa): error states, typed catch, drop dead avatar, terminal poll
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:59:38 +10:00
tremble7681andclaude-flow 0fba967cd8 feat(driver-pwa): PWA manifest + placeholder icons
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:42:18 +10:00
tremble7681andclaude-flow 66ef403bc0 feat(driver-pwa): payments history screen
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:39:58 +10:00
tremble7681andclaude-flow 0a164634f8 feat(driver-pwa): payment screen + auto status polling
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:36:49 +10:00
tremble7681andclaude-flow 372dc0ede7 feat(driver-pwa): top-up with custom keypad
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:34:00 +10:00
tremble7681andclaude-flow d769845d88 feat(driver-pwa): balance screen (hero total + accounts)
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:30:59 +10:00
tremble7681andclaude-flow 6f76809e9e feat(driver-pwa): onboarding (connect TG/MAX bot)
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:27:21 +10:00
tremble7681andclaude-flow 9a116ad94e feat(driver-pwa): login (phone -> TG/MAX code)
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:24:37 +10:00
tremble7681andclaude-flow f74f3688ae feat(driver-pwa): shared UI + router with auth guard
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:21:10 +10:00
tremble7681andclaude-flow a7032692f1 feat(driver-pwa): auth store + ky client + typed driver API (zod)
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:17:12 +10:00
tremble7681andclaude-flow 34d3554f72 feat(driver-pwa): pure money/phone/amount helpers + tests
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:13:16 +10:00
tremble7681andclaude-flow 19b91d65c8 feat(driver-pwa): design tokens, entry, test setup
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:10:48 +10:00
tremble7681andclaude-flow 54ba4edb94 chore(driver-pwa): scaffold Vite+PWA+Tailwind project
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 19:08:41 +10:00
tremble7681andclaude-flow 19dc1b31a6 docs(driver-pwa): Премиум Водитель PWA implementation plan
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 18:58:30 +10:00
tremble7681andclaude-flow cc76cc5698 docs(driver-pwa): Премиум Водитель PWA design spec
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-18 18:47:04 +10:00
tremble7681andclaude-flow 100a29f8c7 fix(repairs): ростер механиков по пути repairs/mechanics-roster
prefixUrl=/api/v1/mechanic, эндпоинт под роутером /v1/mechanic/repairs →
путь обязан включать repairs/ (иначе 404, пикер механиков не грузился). Код-ревью #1.

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-10 20:07:52 +03:00
tremble7681andclaude-flow f7ccc7ce77 feat(repairs): блок «Механики» — несколько механиков на ремонт, делёж 1/N
MechanicsField (чипы + пикер ростера) в Create/Edit; mechanic_ids в payload;
RepairDetail показывает работавших + долю 1/N. Ростер: GET /v1/mechanic/mechanics-roster.

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-10 19:39:36 +03:00
tremble7681andclaude-flow 416ea3391b feat(pwa): rename Салон→Салон перед, add Салон зад + Багажник slots
Extract photo slots to tested lib/inspectionSlots; rename interior label,
add interior-rear + trunk slots (all inspection types). 3 new tests.

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-05 18:49:31 +03:00
tremble7681andclaude-flow b2969f36c3 refactor(pwa): extract shared WorksPickerModal from Create/EditRepairPage
The two repair forms genuinely diverged in UX (inline price-unlock + photos
vs modal override, no photos), so a single merged form would be worse. The
real duplication was the works-catalog picker modal — extracted into one
tested presentational component, removing ~75 duplicated lines.

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-05 17:32:11 +03:00
tremble7681andclaude-flow fab8b4496b test(pwa): add vitest+RTL harness and extract tested lib helpers
- vitest + @testing-library + jsdom; `npm test`; test files excluded from tsc build
- extract date-grouping/format (lib/repairsFeed) and submit-gating (lib/repairForm)
  out of RepairsFeedPage/CreateRepairPage into tested modules
- 29 tests: VLA day-grouping, plural/money format, repair-form validation,
  CarSelectPage external-car entry flow

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-05 17:28:49 +03:00
tremble7681andclaude-flow 8c9caedb03 feat(repairs): 'с улицы' badge in PWA feed
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-05 14:14:27 +03:00
tremble7681andclaude-flow d0ebd9ddf5 feat(repairs): external mode in create form + /repairs/new-external route
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-05 14:12:57 +03:00
tremble7681andclaude-flow 7e6817b3ff feat(repairs): street-car entry button + sheet on car select
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-05 14:11:03 +03:00
tremble7681andclaude-flow 3d875642f8 feat(repairs): external_car in create payload type
Co-Authored-By: claude-flow <ruv@ruv.net>
2026-06-05 14:09:45 +03:00
tremble7681 10492e52a4 feat(repairs): month-to-date header + per-day separators
Header 'Итого' (sum of loaded items) -> 'За этот месяц' (sum + count
from 1st VLAT to now) via new /v1/mechanic/repairs/stats/month endpoint.

List now grouped by local day with a dashed separator showing date
('Сегодня' / 'Вчера' / '26 мая') + day total + repair count.

Bundle: index-BKRX_okx.js
2026-05-26 23:27:54 +10:00
tremble7681 fd0ec64da9 feat(pwa/repairs): show price per row + total sum header
В каждой карточке ленты ремонтов справа от строки работ выводим сумму
работ (works_total из бэка, без запчастей). Шапка над лентой переехала:
слева «Итого: NNN ₽ (X ремонтов)», справа кнопка «Обновить» (раньше
была одна сверху-справа).
2026-05-25 21:52:24 +10:00
tremble7681 3b7b2ae56d fix(pwa/repairs): allow clearing price input without sticky 0
В CreateRepairPage поле «Цена применённая» хранило цифру через
price_applied: number. При удалении символов React сразу подставлял 0
и его нельзя было стереть — приходилось каретку перед нулём ставить
руками. Поменяли тип на number | "" в WorkRow и в onChange оставляем
пустую строку в стейте, пока юзер не ввёл новую цифру. На submit и в
сумму "" трактуется как 0 (Number("") === 0).

EditRepairPage не задет — там цена правится через модалку, цена там
уже жила как string (useState(String(...))) и пустое было допустимо.
2026-05-25 21:43:07 +10:00
tremble7681 205078c5ce fix(pwa/repairs): drop duplicate mileage input under «Замена масла»
При создании/редактировании ремонта в форме был отдельный «Пробег на
момент замены» внутри блока замены масла — auto-sync от шапочного с
soft-dirty флагом по У24. На практике это всё равно заставляло механика
вводить значение дважды, если шапочный пробег вводился вручную (StarLine
недоступен): момент включения галочки случался после ручного ввода,
soft-sync не успевал отработать или механик не понимал что поле
автозаполнилось.

Упростили: единственный пробег — «Пробег (км)» в шапке формы. На submit
он же подставляется в oil_change.mileage_at_change. Поле «Следующая через»
оставили — это интервал, а не значение пробега.

Бэкенд не трогаем — схема та же (mileage_at_change всё ещё в payload).
2026-05-25 21:29:26 +10:00
tremble7681 8eac0b74fc fix(pwa): drop stale parts-suggestion responses to stop input self-erasing
В CreateRepairPage queryPartSuggestions после await перезаписывал
partsDraft.name значением q из момента старта запроса. При быстром вводе
("К" → "Ке" → "Кеп" → "Кепу") поздно вернувшийся ответ для "К" откатывал
поле обратно на "К" — пользователи это видели как «текст частично сам
стирается». Делаем функциональный setState и роняем ответ если name уже
другой. EditRepairPage не задет (там корректный паттерн).
2026-05-25 12:44:41 +10:00
tremble7681 9642eb6e45 fix(pwa): safe-area padding for full-screen page-replacement modals
Юзер обнаружил, что при поиске работ (worksPicker в Create/EditRepairPage)
шапка с инпутом всё ещё уезжает под status-bar. Эти модалки и аналоги
(PhotoAnnotateStep, ZoneDetailView, InspectionEditor) используют
fixed inset-0 — моё прежнее правило для .fixed.top-0 их не покрывало.
Добавил отдельный селектор для .fixed.inset-0.bg-background[/\95];
bg-black/40·50·90 (диалоги, фото-вьюверы) намеренно не задеты.
2026-05-25 12:13:30 +10:00
tremble7681 087693877d fix(pwa): respect iOS safe-area-inset on body + sticky/fixed headers
В iOS PWA при viewport-fit=cover и apple-mobile-web-app-status-bar-style=
black-translucent статус-бар прозрачно накладывается на шапки страниц
(пользователи жаловались скринами с overlap «11:37» поверх «Ремонт #12»).

Body теперь имеет padding-top/bottom env(safe-area-inset-*) — fix initial-
рендер и нижних кнопок. Для sticky/fixed .top-0 хедеров отдельно overrid'им
top: env(safe-area-inset-top), т.к. sticky прилипает к top:0 viewport, а
не к содержимому body. Селектор узкий (.sticky.top-0 / .fixed.top-0) —
не задевает .fixed.inset-0 полноэкранные модалки.
2026-05-25 12:04:08 +10:00
tremble7681 85f3a5c682 wip(local): repairs Edit+Detail snapshot 2026-05-25
Untracked: EditRepairPage, RepairDetailPage
Modified: App.tsx, repairsFeed.ts, InspectionEditor.tsx, CreateRepairPage.tsx
+ public/icons docx files (oferta, 1032_*)

Snapshot to prevent loss; main untouched at a5bd730.
2026-05-25 00:18:41 +10:00
156 changed files with 19289 additions and 1794 deletions

No files matched your search

+1
View File
@@ -38,3 +38,4 @@ Thumbs.db
# IDE # IDE
.idea/ .idea/
.vscode/ .vscode/
.superpowers/
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,68 @@
# Премиум Водитель — PWA (дизайн)
**Дата:** 2026-06-18
**Статус:** дизайн согласован (брейншторм + визуальный компаньон). Код не начат.
**Цель:** PWA-приложение водителя «Премиум Водитель» — вход по телефону (код через TG/MAX), просмотр баланса (счета из CRM-леджера), пополнение через Т-Банк (СБП/карта), история пополнений. Поверхность для уже построенного бэкенда (Фаза 1 платежей + авторизация водителя в `crm2/app/modules/payments`).
## Размещение и стек
- Новый PWA — **сиблинг** `PremiumDriverApp/driver-pwa/frontend/` (рядом с `mechanic-pwa/`), на том же стеке: **React + Vite + vite-plugin-pwa + TypeScript + Tailwind + @tanstack/react-query + ky + zod + react-router-dom + react-hook-form + zustand + sonner (тосты) + lucide-react + vitest**. Структура `src/{api,components,pages,hooks,lib,store}` как у mechanic-pwa.
- Хостинг: **app.pptaxi.ru** (статика + Caddy; деплой как у mechanic — build → dist → tar/rsync, см. mechanic deploy flow).
- Имя приложения (везде в UI, манифест PWA, заголовок): **«Премиум Водитель»**.
## Визуальный язык — Cream Minimal
- Палитра (без жёлтого): фон `#F3EEE3` (cream), карточка/поверхность `#FBF8F1`, линия-разделитель `#E4DCCB`, чернила `#1C1B19`, вторичный текст `#7C7361`/opacity. Кнопки primary — тёмные `#1C1B19` с текстом `#F3EEE3`. Долг (минус) `#C0493A`, плюс/депозит `#3B6E4A`.
- Типографика: **Inter** (один шрифт), без эмодзи. Иконки — lucide (тонкие, монохром).
- Скругления 12–16px, тонкие 1px-границы, мягкие тени минимально. Крупные тап-таргеты (мобайл-фёрст). App-like / edit-first: минимум лишних кнопок, экран сам реагирует.
## Экраны (MVP)
1. **Вход.**
- Шаг 1: поле телефона `+7 ___ ___-__-__` → «Получить код». → `POST /api/driver/auth/request {phone}`.
- Если ответ `code_sent` → шаг 2: ввод кода (свой цифровой кейпад) → `POST /api/driver/auth/verify {phone, code}` → сохраняем driver JWT → на «Баланс».
- Если ответ `onboarding` → экран «Подключите бота»: две кнопки **Telegram** / **MAX** (открывают `deep_links.tg`/`.max`); подсказка «нажмите Старт у бота, затем вернитесь и запросите код снова». Кнопка «Я подключил — запросить код».
2. **Баланс** (компоновка B: hero + список).
- Шапка: «Премиум Водитель» + инициалы водителя.
- **Hero-блок «Общий долг»** — крупная сумма (сумма отрицательных счетов).
- **Список счетов** (bucket из `/api/driver/balance`): название + подпись (марка/госномер для аренды, «N неоплаченных» для штрафов) + значение (минус — красный, плюс — зелёный).
- Кнопка **«Пополнить»** (primary). Тап по счёту/кнопке → «Пополнение» с предвыбранным счётом.
- Внизу/в меню: «История», «Выйти».
3. **Пополнение** (компоновка C: свой кейпад).
- Заголовок «Пополнить · <счёт>». Крупная сумма. Строка «к оплате X ₽ (комиссия Y ₽)» — пересчёт на лету по ставке (получаем из ответа `/topup` или показываем оценку и уточняем).
- **Свой цифровой кейпад** (1–9, 0, ·, ⌫) — без системной клавиатуры; крупные клавиши. Быстрые суммы 500/1000/2000 (чипы).
- Сегмент **СБП / Картой**.
- Кнопка **«Оплатить»** → `POST /api/driver/topup {bucket, amount, method}` → получаем `{order_id, pay_url}`.
4. **Оплата / статус** (вариант A: авто-статус, без QR).
- Иконка «СБП», сумма к оплате, кнопка **«Оплатить через СБП»** (или «Оплатить картой») → открывает `pay_url` (СБП deep-link `qr.nspk.ru/...` → приложение банка; карта → форма `pay.tbank.ru`). **QR не показываем, «оплата с другого устройства» убрана** — водитель платит на том же телефоне через приложение банка.
- Под кнопкой — авто-статус «Ожидаем оплату…» (спиннер). Приложение **опрашивает статус** платежа; при `PAID` → экран **«Оплачено»** (зелёная галочка, «<счёт> пополнен на N ₽») → кнопка «На главную» (баланс перезапрашивается).
5. **История пополнений.**
- Список из `driver_payments` водителя: дата, счёт, сумма, статус (Оплачено/Ожидает/Отклонён), способ. Пусто → «Пока нет пополнений».
6. **Выход** — очистка JWT, возврат на «Вход».
## Поток данных / API (crm2 BFF, префикс `/api`)
Готово (Фаза 1 + авторизация):
- `POST /driver/auth/request {phone}` → `{status:"code_sent",channel}` | `{status:"onboarding",deep_links:{tg,max}}`
- `POST /driver/auth/verify {phone, code}` → `{token, driver_id}`
- `GET /driver/balance` (Bearer) → `{accounts:[{bucket, balance}]}`
- `POST /driver/topup {bucket, amount, method}` (Bearer) → `{order_id, pay_url, commission, total}`
**Нужно добавить на бэкенде (зависимость этого PWA — отдельные backend-задачи):**
- `GET /driver/payments` (Bearer) → история пополнений водителя (из `driver_payments`: order_id, bucket, amount, commission, method, status, created_at, paid_at).
- `GET /driver/payment/{order_id}` (Bearer) → `{status}` для авто-опроса статуса оплаты (NEW/FORM/PAID/REJECTED). (Альтернатива: опрашивать `/driver/balance` и сравнивать — но явный статус надёжнее и показывает «Оплачено».)
- (Опц.) В `/driver/topup` вернуть и `commission_rate`, чтобы кейпад считал «к оплате» локально до запроса.
## Сессия / клиент
- driver JWT (typ='driver', 30 дн) хранится в `localStorage`; `ky`-инстанс добавляет `Authorization: Bearer`. На 401 → разлогин (на «Вход»).
- `@tanstack/react-query` для balance/history (кэш + рефетч); `zod` валидирует ответы; `zustand` — сессия (token, driver_id). Тосты ошибок — `sonner`.
- База API из env (`VITE_API_BASE`, по умолчанию `https://crm.pptaxi.ru/api`). CORS: бэкенд должен разрешить origin `https://app.pptaxi.ru` для `/api/driver/*` (backend-задача).
## PWA
- `vite-plugin-pwa`: manifest (name «Премиум Водитель», cream theme `#F3EEE3`, иконки 192/512, standalone, портрет), service worker (precache оболочки, network-first для API). Устанавливается на телефон без сторов (по ссылке app.pptaxi.ru → «На экран Домой»).
## Обработка ошибок
- Телефон не найден (404) → «Номер не найден. Обратитесь в парк.» Неверный код (401) → «Неверный или просроченный код» + повтор. Платёж не создан → тост + остаёмся на «Пополнении». Авто-опрос: таймаут N минут → «Не дождались оплаты» + кнопка «Проверить ещё раз»/«Вернуться».
## Тестирование
- vitest + @testing-library/react: рендер экранов, кейпад (ввод/⌫/быстрые суммы, пересчёт «к оплате»), форма телефона/кода, маппинг ответов API (zod-схемы), guard приватных роутов (нет токена → «Вход»), авто-статус (мок таймера/опроса → success). API мокается (msw или ky-mock), без сети.
## Скоуп / порядок
MVP-экраны: Вход (+онбординг) · Баланс · Пополнение · Оплата/статус · История · Выход. **Вне MVP:** push-уведомления, вывод средств, профиль/настройки, мультиязычность.
Порядок сборки (для плана): каркас приложения+PWA+API-клиент+сессия → Вход/онбординг → Баланс → Пополнение(кейпад) → Оплата/авто-статус → История → деплой app.pptaxi.ru. Бэкенд-зависимости (`/driver/payments`, `/driver/payment/{order_id}`, CORS) — отдельные мелкие задачи в crm2 (сделать до/параллельно соответствующим экранам).
+48
View File
@@ -0,0 +1,48 @@
# Премиум Водитель — PWA водителя (app.pptaxi.ru)
Фронт: `frontend/` (React + Vite + react-router 6, BrowserRouter). Как поднять и
проверить — `frontend/README.md`.
## Кнопка «Назад» на каждом экране
**Зачем.** У установленного PWA на iPhone нет системной кнопки «назад», жест от
края ненадёжен, а после холодного старта (иконка, пуш, ссылка) истории нет вовсе.
Водитель застревал, например, в «Уведомлениях» (задача 6385). Android-«назад»
должен вести туда же, куда кнопка в интерфейсе.
**Правило.**
- Любой экран, кроме главной (`/`) и входа (`/login`), показывает «Назад» слева
сверху во всех состояниях: загрузка, ошибка, пусто, не найдено, итог.
- Поведение одно (`src/lib/back.ts`): есть история этого запуска
(`history.state.idx > 0`) — `navigate(-1)`, нет — родитель с `replace`.
Голый `navigate(-1)` и `navigate(родитель)` без `replace` запрещены.
- Родитель экрана — поле `parent` в таблице `src/routes.tsx` (обязательное;
`null` только у `/` и `/login`; можно функцией от параметров/входа).
- После действия, которое «съедает» форму или запись (создали платёж, выбрали
исход, вошли, вышли), уходим с `{ replace: true }`. Экраны входа —
`guard: "guest"`: вошедшего уводят на главную, и шаг назад после входа по
ссылке не попадает на отработавший вход.
- Режим, заменяющий экран целиком, где это дёшево, получает свой адрес (push) и
перенацеливает верхнюю «Назад» через `useBackOverride`; второй кнопки не рисует.
Свой `BackButton` — только на экране без родителя (вход по коду, `?by=code`).
- Выбор на экране (фильтр, период) держим в адресе, меняем с `replace`.
**Новый раздел — чек-лист.**
1. Добавить строку в `ROUTES` (`src/routes.tsx`) с `parent`. В `App.tsx`
`<Route>` руками не писать, вложенных `<Routes>` в страницах не заводить.
2. Свою «Назад» не рисовать: её ставит `BackBar` над маршрутами.
3. `navigate()` после мутаций — с `replace`. Кнопка «уйти с экрана» внутри
страницы — `useRouteBack()`, адрес родителя в странице не повторять.
4. `npm test` — сторож `src/routes.test.tsx` обязан пройти.
**Где что.**
- `src/lib/back.ts` — `canGoBackInApp()`, `useBack(parent, { mode })`,
`useRouteBack()`, `useBackOverride({ to, mode })`.
- `src/components/BackBar.tsx` — `BackProvider` (родитель по таблице) и `BackBar`.
- `src/components/BackButton.tsx` — сама кнопка (ChevronLeft + «Назад», 44 px).
- `src/components/ErrorBoundary.tsx` — вместо белого экрана «Перезагрузить»,
на главной и входе ещё «На главную».
- `src/routes.test.tsx` — сторож: все экраны при вечно висящей сети, родитель
существует и не сам экран, ни одного `<Route>` мимо таблицы.
**Команды** (из `frontend/`): `npm test`, `npx tsc -b`, `npm run build`.
+26
View File
@@ -0,0 +1,26 @@
# Премиум Водитель (PWA) — переменные сборки.
# Как поднять фронт локально — README.md рядом с этим файлом.
# --- VITE_API_BASE: база API для ky (src/api/client.ts) ----------------------
#
# Боевой сборке задавать её НЕ обязательно: если переменной нет, client.ts
# подставляет https://crm.pptaxi.ru/api. Поэтому строка ниже закомментирована
# намеренно — скопированный в .env боевой адрес сборке ничего не добавляет,
# а локальную разработку ломает: значение из файла приоритетнее дев-дефолта,
# и `npm run dev` начнёт бить в боевой терминал вместо локального бэкенда.
#
#VITE_API_BASE=https://crm.pptaxi.ru/api
# --- Локальная разработка ----------------------------------------------------
#
# Копировать этот файл в .env не нужно. `npm run dev` сам ставит
# VITE_API_BASE=/api и проксирует /api на локальный бэкенд (vite.config.ts),
# то есть запрос идёт с того же origin, что и страница, и CORS не участвует —
# CORS_ALLOW_LOCALHOST в backend/.env для этого фронта не нужен.
#
# Свой адрес бэкенда, поход в API мимо прокси, PowerShell-вариант команд —
# в README.md. Рецепты держим в одном месте: разъедутся — поверят не тому.
#
# ВНИМАНИЕ: crm.pptaxi.ru — боевой терминал Т-Банка и боевая касса АТОЛ.
# Пополнение, сделанное «просто посмотреть», — это реальные деньги водителя,
# реальный чек 54-ФЗ и реальная проводка в леджере.
+5
View File
@@ -0,0 +1,5 @@
node_modules
dist
.env
.env.local
*.tsbuildinfo
+148
View File
@@ -0,0 +1,148 @@
# Премиум Водитель — PWA водителя
React + Vite + TypeScript. Прод: **https://app.pptaxi.ru**.
Бэкенд — модуль `payments` в Premium CRM (`https://crm.pptaxi.ru/api`,
репозиторий `crm2`, `backend/app/modules/payments/`).
## Как поднять локально
```bash
npm install
npm run dev # http://localhost:5174
```
Отдельно поднимается бэкенд `crm2` на **127.0.0.1:8000** (тот же порт, что в
`backend/Dockerfile`). Больше настраивать нечего: dev-сервер сам подставляет
`VITE_API_BASE=/api` и проксирует `/api` на бэкенд — см. `vite.config.ts`.
**Почему через прокси, а не «разрешить localhost в CORS бэкенда».** Прокси
делает запрос ОДНОГО происхождения со страницей (`http://localhost:5174/api/…`),
поэтому CORS в разработке не участвует вообще. Боевой список origin'ов на
бэкенде остаётся закрытым, а `CORS_ALLOW_LOCALHOST=true` в `backend/.env` для
этого фронта включать не надо. (Раньше рецепт с `CORS_ALLOW_LOCALHOST` тут и не
работал: прокси не было, и фронт по умолчанию уходил на боевой домен, а не на
локальный бэкенд.)
Сервис-воркер в режиме разработки не регистрируется (`devOptions` у
`vite-plugin-pwa` по умолчанию выключены) — старый кэш прод-версии в дев не
лезет.
### Бэкенд не на `127.0.0.1:8000`
```bash
VITE_API_TARGET=http://127.0.0.1:8090 npm run dev
```
В PowerShell инлайн-префикса `VAR=... команда` нет — переменную ставят отдельно:
```powershell
$env:VITE_API_TARGET="http://127.0.0.1:8090"; npm run dev
```
Имя переменной то же, что в CRM (`crm2/frontend/vite.config.ts`), — рецепт один
на оба фронта.
### Ходить в API напрямую, мимо прокси
`.env.local` (в git не попадает):
```
VITE_API_BASE=http://127.0.0.1:8000/api
```
Своя настройка приоритетнее дев-дефолта — специально, чтобы `npm run dev` её не
перебивал. Для похода в чужой origin бэкенду понадобится
`CORS_ALLOW_LOCALHOST=true` в `backend/.env` и рестарт.
> ⚠️ `crm.pptaxi.ru` — боевой терминал Т-Банка и боевая касса АТОЛ. Пополнение,
> сделанное «просто посмотреть», — это реальные деньги водителя, реальный чек
> 54-ФЗ и реальная проводка в леджере. Поэтому прокси по умолчанию смотрит в
> локальный бэкенд, а не в прод.
## Проверки
```bash
npx tsc -b # типы
npm test # vitest run
```
`npx tsc --noEmit` **без `-b`** здесь всегда зелёный и ничего не значит:
корневой `tsconfig.json` — solution-файл (`files: []` + `references`), под него
не попадает ни один файл (`tsc --noEmit --listFiles` печатает пустоту). Типы
живут в `tsconfig.app.json` (`src`) и `tsconfig.node.json` (конфиги +
`dev-proxy.test.ts`), и до обоих добирается только `tsc -b`.
## Сборка
```bash
npm run build # tsc -b && vite build → dist/
```
Дев-дефолт `VITE_API_BASE=/api` подставляется только при запущенном dev-сервере
и в бандл не попадает: в собранном `assets/index-*.js` лежит
`https://crm.pptaxi.ru/api` (проверено сборкой). Поэтому `VITE_API_BASE` боевой
сборке задавать не обязательно — без неё `src/api/client.ts` подставляет ровно
этот адрес.
> ⚠️ `npm run preview` поднимает **уже собранный** бандл, а база в нём
> абсолютная: запросы уходят на боевой `crm.pptaxi.ru` мимо прокси dev-сервера.
> Смотреть локальные правки — только `npm run dev`.
Куда выкладывается `dist/` — в плане проекта:
`../../docs/superpowers/plans/2026-06-18-premium-driver-pwa.md`, раздел
«Deployment notes»: статика на `app.pptaxi.ru`, Caddy с фолбэком на `index.html`.
## Кто может войти и как смотреть чужой экран
> **Запущено 22.08.2026: вход открыт всем водителям.** Список номеров ниже пуст,
> то есть гейт выключен. Раздел оставлен как инструкция на случай, если вход
> снова понадобится сузить — например под обкатку следующей крупной правки.
### 1. Вход только по списку номеров (сейчас выключено)
Переменная бэкенда (`crm2/backend/.env`, читается в `app/config.py`):
```
DRIVER_APP_ALLOWED_PHONES=+7 (914) 123-45-67, 79990001122
```
Разделители — запятая, точка с запятой, перенос строки (пробел разделителем не
считается: номер вписывают в привычном виде). Сверяются последние 10 цифр.
**Пусто — гейт выключен, вход открыт всем водителям.**
Проверка стоит в единственной воронке выдачи токена
(`modules/payments/driver_auth.create_driver_token_for`), поэтому закрыты сразу
все пять путей входа: код в бот, кнопка «Войти через Telegram», колбэки своего
бота и два аварийных отката на n8n. Бот отвечает человеку текстом, остальные
пути — 403. Логика гейта: `modules/payments/login_gate.py`.
### 2. Просмотр от лица водителя (сотрудник)
На экране входа внизу — «Вход для сотрудника» (`/dev`): логин и пароль **учётки
CRM**, при включённой двухфакторке спросит код. Дальше поиск по ФИО, телефону
или id — и приложение открывается от лица выбранного водителя.
* Токен помечен claim'ом `imp`, живёт 8 часов (обычный водительский — 30 дней).
* Гейт — `is_admin` в CRM. Каждая выдача пишется в аудит (`driver_app.impersonate`).
* Кнопка «Отозвать доступ» в CRM гасит и просмотр сотрудника — поколение общее.
* Гейт обкатки на этот путь не распространяется: смотреть надо как раз на
водителей, которых в allowlist нет.
Пока просмотр действует, сверху на всех экранах висит плашка «Смотрю как …» со
ссылкой на вкладку **«Отладка»** (`/debug`, водителю недоступна):
* от чьего лица открыт экран и кнопка сменить водителя;
* `driver_id`, режим, сотрудник, когда истекает токен, адрес API, коммит и время
сборки, состояние сети;
* журнал последних 40 ответивших запросов (метод, путь, статус, миллисекунды);
* сброс кэша сервис-воркера с перезагрузкой — лечит «правка не приехала»;
* выходы: из просмотра, из учётки сотрудника.
### Деньги под просмотром: учебный платёж
Пополнение под `imp`-токеном **не идёт в банк**. Проверки суммы, категории и
расчёт комиссии настоящие, а вместо Init на терминале заводится учебный заказ в
Redis (`modules/payments/mock_pay.py`, префикс `mock-`, час жизни). Экран
`/mock-pay/:orderId` даёт выбрать, что «ответит» банк — оплачено, отказ,
истёкший счёт, возврат, — и настоящий экран оплаты разбирает эти статусы своим
боевым кодом. В `driver_payments` не попадает ни строки, чек 54-ФЗ не пробивается.
+103
View File
@@ -0,0 +1,103 @@
// @vitest-environment node
/**
* Локальная разработка PWA водителя.
*
* Гейт CORS на бэкенде (CORS_ALLOW_LOCALHOST, по умолчанию выключен) закрыл
* дыру, но заодно оставил этот фронт без рабочего дева: прокси не было, а
* client.ts по умолчанию уходит на боевой https://crm.pptaxi.ru/api — то есть
* «включи CORS_ALLOW_LOCALHOST» тут не помогало, запрос вообще не доходил до
* локального бэкенда.
*
* Тесты держат обе половины договорённости:
* 1) `npm run dev` доводит фронт до локального бэкенда сам, без правки .env;
* 2) боевая сборка от этого не меняется — относительная дев-база в бандл
* попасть не может (в проде он живёт на app.pptaxi.ru, где /api нет).
*
* Конфиг резолвится по-настоящему (resolveConfig читает vite.config.ts и
* env-файлы) — иначе тест проверял бы не то, что увидит vite.
*
* Файл лежит рядом с vite.config.ts и НЕ называется vite.config.test.ts:
* в дефолтном exclude vitest есть `**\/{...,vite,...}.config.*`, под который
* такое имя попадает целиком — тест молча не запускался бы.
*/
import { describe, it, expect, beforeEach, afterEach } from "vitest";
import path from "path";
import { fileURLToPath } from "url";
import { resolveConfig } from "vite";
const ROOT = path.dirname(fileURLToPath(import.meta.url));
/** Обе переменные — process.env, и dev-дефолт их же и трогает: сохраняем. */
const SAVED = {
base: process.env.VITE_API_BASE,
target: process.env.VITE_API_TARGET,
};
function restore(key: "VITE_API_BASE" | "VITE_API_TARGET", value: string | undefined): void {
if (value === undefined) delete process.env[key];
else process.env[key] = value;
}
beforeEach(() => {
delete process.env.VITE_API_BASE;
delete process.env.VITE_API_TARGET;
});
afterEach(() => {
restore("VITE_API_BASE", SAVED.base);
restore("VITE_API_TARGET", SAVED.target);
});
const resolve = (command: "serve" | "build", mode: "development" | "production") =>
resolveConfig({ root: ROOT, configFile: path.join(ROOT, "vite.config.ts"), logLevel: "silent" },
command, mode, mode);
describe("dev-сервер доводит фронт до локального бэкенда", () => {
it("подставляет относительную базу — запрос идёт со своего origin, CORS не участвует", async () => {
const cfg = await resolve("serve", "development");
expect(cfg.env.VITE_API_BASE).toBe("/api");
});
it("проксирует /api на локальный бэкенд, а не на боевой домен", async () => {
const cfg = await resolve("serve", "development");
const proxy = cfg.server.proxy?.["/api"];
expect(typeof proxy === "object" && proxy.target).toBe("http://127.0.0.1:8000");
});
it("цель прокси переопределяется VITE_API_TARGET (стенд, тайлнет)", async () => {
process.env.VITE_API_TARGET = "http://127.0.0.1:8090";
const cfg = await resolve("serve", "development");
const proxy = cfg.server.proxy?.["/api"];
expect(typeof proxy === "object" && proxy.target).toBe("http://127.0.0.1:8090");
});
it("база и путь прокси — одно и то же", async () => {
// Две половины рецепта живут в разных местах конфига: базу подставляем в
// env, путь перечисляем в server.proxy. Разъедутся (например, база станет
// "/backend") — dev-сервер отдаст на этот путь index.html вместо ответа
// бэкенда, и падать будет уже в разборе JSON, далеко от причины.
const cfg = await resolve("serve", "development");
expect(Object.keys(cfg.server.proxy ?? {})).toContain(cfg.env.VITE_API_BASE);
});
it("не перебивает базу, заданную разработчиком", async () => {
process.env.VITE_API_BASE = "https://stand.example/api";
const cfg = await resolve("serve", "development");
expect(cfg.env.VITE_API_BASE).toBe("https://stand.example/api");
});
});
describe("боевая сборка остаётся боевой", () => {
it("дев-дефолт в сборку не течёт: base пустая → client.ts берёт прод-адрес", async () => {
const cfg = await resolve("build", "production");
expect(cfg.env.VITE_API_BASE).toBeUndefined();
expect(process.env.VITE_API_BASE).toBeUndefined();
});
it("ни один env-файл не подсовывает сборке относительную базу", async () => {
// Относительный /api в проде означал бы app.pptaxi.ru/api — такого нет.
// Ловит и коммит .env с дев-значением, и локальный .env на машине сборки.
const cfg = await resolve("build", "production");
expect(cfg.env.VITE_API_BASE).not.toBe("/api");
});
});
+21
View File
@@ -0,0 +1,21 @@
<!doctype html>
<html lang="ru">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
<meta name="theme-color" content="#EEF1F5" />
<link rel="icon" type="image/png" sizes="192x192" href="/icons/icon-192.png" />
<!-- iOS манифест не читает: иконку «на экран Домой» он берёт только отсюда. -->
<link rel="apple-touch-icon" href="/icons/apple-touch-icon.png" />
<!-- iOS берёт подпись под иконкой отсюда, а не из манифеста. -->
<meta name="apple-mobile-web-app-title" content="Водитель" />
<link rel="manifest" href="/manifest.webmanifest" />
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;600;700;800&display=swap" rel="stylesheet" />
<title>Премиум Водитель</title>
</head>
<body>
<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
</body>
</html>
File diff suppressed because it is too large. Load diff
+44
View File
@@ -0,0 +1,44 @@
{
"name": "driver-pwa",
"private": true,
"version": "0.1.0",
"type": "module",
"scripts": {
"dev": "vite",
"build": "tsc -b && vite build",
"preview": "vite preview",
"lint": "eslint .",
"test": "vitest run",
"test:watch": "vitest"
},
"dependencies": {
"@tanstack/react-query": "^5.51.0",
"ky": "^1.7.2",
"lucide-react": "^0.454.0",
"react": "^18.3.1",
"react-dom": "^18.3.1",
"react-router-dom": "^6.26.0",
"sonner": "^1.5.0",
"zod": "^3.23.8",
"zustand": "^4.5.5"
},
"devDependencies": {
"@testing-library/jest-dom": "^6.5.0",
"@testing-library/react": "^16.0.1",
"@testing-library/user-event": "^14.5.2",
"@types/node": "^22.5.0",
"@types/react": "^18.3.5",
"@types/react-dom": "^18.3.0",
"@vitejs/plugin-react": "^4.3.1",
"autoprefixer": "^10.4.20",
"jsdom": "^25.0.0",
"postcss": "^8.4.45",
"tailwindcss": "^3.4.10",
"typescript": "^5.5.4",
"vite": "^5.4.2",
"vite-plugin-pwa": "^0.20.5",
"vitest": "^2.0.5",
"workbox-core": "^7.4.1",
"workbox-precaching": "^7.4.1"
}
}
+1
View File
@@ -0,0 +1 @@
export default { plugins: { tailwindcss: {}, autoprefixer: {} } };
Binary file not shown.

After

Width:  |  Height:  |  Size: 606 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 652 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 KiB

@@ -0,0 +1,14 @@
{
"name": "Премиум Водитель",
"short_name": "Водитель",
"start_url": "/",
"display": "standalone",
"orientation": "portrait",
"background_color": "#EEF1F5",
"theme_color": "#EEF1F5",
"icons": [
{ "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "any" },
{ "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any" },
{ "src": "/icons/icon-maskable-512.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable" }
]
}
+63
View File
@@ -0,0 +1,63 @@
"""Иконки приложения — тот же значок, что у сайта pptaxi.ru.
Сайт отдаёт `favicon.svg`: красная скруглённая плитка --s-accent и белая «П».
Повторяем её здесь, чтобы значок в браузере, на экране телефона и на сайте был
один и тот же.
Рисуем сами (Pillow), потому что тянуть растеризатор SVG ради одной плитки с
буквой незачем. Сглаживание — сверхдискретизацией ×4.
Запуск (нужен Pillow):
python scripts/gen-icons.py
"""
from pathlib import Path
from PIL import Image, ImageDraw, ImageFont
OUT = Path(__file__).resolve().parent.parent / "public" / "icons"
ACCENT = (220, 38, 38, 255) # --s-accent сайта
PAPER = (255, 255, 255, 255) # --s-paper
SS = 4
# Шрифт ищем среди системных: у сайта заголовки набраны Manrope, но ради одной
# буквы тащить файл шрифта в репозиторий не стоит — берём ближайший гротеск.
FONT_CANDIDATES = [
r"C:\Windows\Fonts\segoeuib.ttf",
r"C:\Windows\Fonts\arialbd.ttf",
"/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf",
]
def _font(size: int) -> ImageFont.FreeTypeFont:
for path in FONT_CANDIDATES:
if Path(path).exists():
return ImageFont.truetype(path, size)
raise SystemExit("не нашёл жирный шрифт для буквы")
def compose(size: int, inset: float, radius_ratio: float = 0.22) -> Image.Image:
"""inset — доля стороны под плитку. У maskable она меньше: Android режет
иконку по кругу, и плитка без запаса теряет углы."""
big = size * SS
img = Image.new("RGBA", (big, big), PAPER)
draw = ImageDraw.Draw(img)
pad = big * (1 - inset) / 2
box = (pad, pad, big - pad, big - pad)
draw.rounded_rectangle(box, radius=(box[2] - box[0]) * radius_ratio, fill=ACCENT)
letter = "П"
font = _font(int((box[3] - box[1]) * 0.72))
l, t, r, b = draw.textbbox((0, 0), letter, font=font)
draw.text(((box[0] + box[2] - (r - l)) / 2 - l,
(box[1] + box[3] - (b - t)) / 2 - t), letter, font=font, fill=PAPER)
return img.resize((size, size), Image.LANCZOS)
if __name__ == "__main__":
OUT.mkdir(parents=True, exist_ok=True)
for name, size, inset in (("icon-192.png", 192, 1.0),
("icon-512.png", 512, 1.0),
("icon-maskable-512.png", 512, 0.72),
("apple-touch-icon.png", 180, 1.0)):
compose(size, inset).save(OUT / name)
print("собрано", name)
+192
View File
@@ -0,0 +1,192 @@
import { describe, it, expect, vi, beforeEach, beforeAll, afterAll } from "vitest";
import { render, screen, waitFor } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { BrowserRouter, MemoryRouter, useLocation } from "react-router-dom";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import { useEffect, type ReactNode } from "react";
vi.mock("@/api/driver", () => ({
// Карточка бонусов на главной: null -> карточка спрятана, тестам баланса
// она не мешает.
getBonuses: vi.fn(async () => null),
getNotifications: vi.fn(async () => ({
items: [
{ id: 5, kind: "fine", title: "Новый штраф", body: "Постановление от 13.08.2026.",
url: "/fines/12", created_at: "2026-08-18T10:15:00+10:00", read_at: null },
],
unread: 1,
})),
markNotificationsRead: vi.fn(async () => ({ marked: 1 })),
getBalance: vi.fn(async () => ({
accounts: [
{ bucket: "Долг аренда", balance: -3050, payable: true },
{ bucket: "Долг по штрафам", balance: -618.75, payable: true },
],
total: -3668.75, synced_at: null, pending_topup: 0,
})),
getStatement: vi.fn(async () => ({ items: [], from: "2026-08-11", to: "2026-08-18", kind: "all" })),
getFines: vi.fn(async () => ({
items: [{
id: 12, number: "18810525260813035846", date: "2026-08-13",
article: "12.09.2 - Превышение скорости", address: "", car_number: "А947УТ125",
amount: 618.75, settled: "owed" as const, cancelled: false, has_photo: false,
}],
open_count: 1, debt: -618.75,
})),
getFine: vi.fn(async () => ({
id: 12, number: "18810525260813035846", date: "2026-08-13",
article: "12.09.2 - Превышение скорости", address: "", car_number: "А947УТ125",
amount: 618.75, settled: "owed" as const, cancelled: false, has_photo: false,
photos: [], document: null, post_date: null, camera: null,
speed: null, speed_limit: null, speed_excess: null,
})),
// Экран входа: МТС ID и Telegram выключены — остаётся вход по коду.
mtsStatus: vi.fn(async () => ({ enabled: false })),
tgSession: vi.fn(async () => ({ pair_session: "S", poll_secret: "P", confirm_code: "1", deep_link: null })),
authRequest: vi.fn(async () => ({ status: "code_sent", channel: "tg" })),
authVerify: vi.fn(async () => ({ token: "t", driver_id: 42 })),
apiErrorText: vi.fn(async (_e: unknown, fallback: string) => fallback),
retryAfterSeconds: vi.fn(() => null),
}));
import App from "@/App";
import * as driver from "@/api/driver";
import { useAuth } from "@/store/auth";
// Штраф от 13.08 должен попадать в «последние 7 дней» — морозим только Date.
beforeAll(() => {
vi.useFakeTimers({ toFake: ["Date"] });
vi.setSystemTime(new Date("2026-08-18T12:00:00Z"));
});
afterAll(() => vi.useRealTimers());
const withQuery = (children: ReactNode) => (
<QueryClientProvider client={new QueryClient({ defaultOptions: { queries: { retry: false } } })}>
{children}
</QueryClientProvider>
);
const idx = () => (window.history.state as { idx?: number } | null)?.idx;
describe("выход с экранов назад (задача 6385)", () => {
beforeEach(() => {
window.history.replaceState(null, "", "/");
useAuth.getState().setSession("t", 42);
vi.clearAllMocks();
});
it("лента, открытая пушем с холодного старта: «Назад» ведёт на главную", async () => {
// Так это и выглядело на iPhone: пуш открыл /notifications?n=5, истории
// позади нет, системной кнопки нет — выйти было нечем.
render(withQuery(
<MemoryRouter initialEntries={["/notifications?n=5"]}><App /></MemoryRouter>
));
expect(await screen.findByText("Новый штраф")).toBeInTheDocument();
expect(driver.markNotificationsRead).toHaveBeenCalledWith([5], "push");
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
expect(screen.queryByRole("heading", { name: "Уведомления" })).not.toBeInTheDocument();
});
it("главная → колокольчик → лента → «Назад» возвращает шагом по истории", async () => {
render(withQuery(<BrowserRouter><App /></BrowserRouter>));
await userEvent.click(await screen.findByRole("button", { name: "Уведомления" }));
expect(await screen.findByRole("heading", { name: "Уведомления" })).toBeInTheDocument();
expect(idx()).toBe(1);
const len = window.history.length;
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
await waitFor(() => expect(window.location.pathname).toBe("/"));
// Вернулись назад, а не положили главную новой записью поверх ленты.
expect(idx()).toBe(0);
expect(window.history.length).toBe(len);
expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
});
it("из карточки штрафа «Назад» возвращает к списку штрафов", async () => {
render(withQuery(<BrowserRouter><App /></BrowserRouter>));
await userEvent.click(await screen.findByRole("button", { name: /Долг по штрафам/ }));
await waitFor(() => expect(window.location.search).toBe("?kind=fines"));
// Фильтр — не шаг истории: сменили заменой.
expect(idx()).toBe(0);
await userEvent.click(await screen.findByRole("button", { name: /Превышение скорости/ }));
expect(await screen.findByText("Начислено вам")).toBeInTheDocument();
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
await waitFor(() => expect(window.location.pathname + window.location.search).toBe("/?kind=fines"));
expect(await screen.findByRole("button", { name: /Превышение скорости/ })).toBeInTheDocument();
});
it("вход сотрудника с холодного старта: «Я водитель» ведёт туда же, куда «Назад»", async () => {
// Водитель вошёл, а /dev открыт заново (перезагрузка, ссылка): родитель по
// таблице — главная. Раньше кнопка на странице знала только /login.
const seen: string[] = [];
function Seen() {
const { pathname } = useLocation();
useEffect(() => { seen.push(pathname); }, [pathname]);
return null;
}
render(withQuery(<MemoryRouter initialEntries={["/dev"]}><Seen /><App /></MemoryRouter>));
await userEvent.click(screen.getByRole("button", { name: "Я водитель" }));
expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
expect(seen).toEqual(["/dev", "/"]);
});
it("карточка штрафа с холодного старта: «Назад» — в список штрафов", async () => {
render(withQuery(<MemoryRouter initialEntries={["/fines/12"]}><App /></MemoryRouter>));
expect(await screen.findByText("Начислено вам")).toBeInTheDocument();
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
expect(await screen.findByRole("button", { name: /Превышение скорости/ })).toBeInTheDocument();
expect(driver.getFines).toHaveBeenCalled();
});
});
describe("после входа «Назад» не возвращает к экрану входа", () => {
beforeEach(() => {
useAuth.getState().clear();
sessionStorage.clear();
vi.clearAllMocks();
});
async function loginByCode() {
await userEvent.click(await screen.findByRole("button", { name: "Войти по коду" }));
await userEvent.type(screen.getByLabelText("Номер телефона"), "9143054400");
await userEvent.click(screen.getByRole("button", { name: "Получить код" }));
await userEvent.type(await screen.findByPlaceholderText("Код из сообщения"), "1234");
await userEvent.click(screen.getByRole("button", { name: "Войти" }));
}
it("открыл экран, не войдя (пуш, ссылка на оплату): вошёл — «Назад» на главную", async () => {
// Охрана заменяет адрес экраном входа (запись 0), вход по коду кладёт свою
// запись (1), а успешный вход заменяет лишь её. Позади остаётся отработавший
// экран входа — шаг назад на него раньше показывал вошедшему выбор способа
// входа без «Назад» и без пути дальше.
window.history.replaceState(null, "", "/notifications");
render(withQuery(<BrowserRouter><App /></BrowserRouter>));
await loginByCode();
expect(await screen.findByRole("heading", { name: "Уведомления" })).toBeInTheDocument();
expect(idx()).toBe(1);
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
await waitFor(() => expect(idx()).toBe(0));
await waitFor(() => expect(window.location.pathname).toBe("/"));
expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
expect(screen.queryByText("Вход в приложение")).not.toBeInTheDocument();
});
it("вход по коду: системный «назад» с главной не открывает выбор способа входа", async () => {
window.history.replaceState(null, "", "/login");
render(withQuery(<BrowserRouter><App /></BrowserRouter>));
await loginByCode();
expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
expect(idx()).toBe(1);
window.history.back();
await waitFor(() => expect(idx()).toBe(0));
await waitFor(() => expect(window.location.pathname).toBe("/"));
expect(await screen.findByText("−3 668,75 ₽")).toBeInTheDocument();
expect(screen.queryByText("Вход в приложение")).not.toBeInTheDocument();
});
});
+25
View File
@@ -0,0 +1,25 @@
import { describe, it, expect, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import { MemoryRouter } from "react-router-dom";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import App from "./App";
import { useAuth } from "@/store/auth";
function renderAt(path: string) {
const qc = new QueryClient();
return render(
<QueryClientProvider client={qc}>
<MemoryRouter initialEntries={[path]}>
<App />
</MemoryRouter>
</QueryClientProvider>
);
}
describe("routing guard", () => {
beforeEach(() => useAuth.getState().clear());
it("redirects to login when no token", () => {
renderAt("/");
expect(screen.getByText(/Вход в приложение/i)).toBeInTheDocument();
});
});
+136
View File
@@ -0,0 +1,136 @@
import type { ReactNode } from "react";
import { useEffect, useState } from "react";
import { Navigate, Route, Routes, useLocation, useNavigate } from "react-router-dom";
import { useAuth } from "@/store/auth";
import { useStaff } from "@/store/staff";
import { setReturnTo } from "@/lib/returnTo";
import { ImpersonationBar } from "@/components/ImpersonationBar";
import { BackBar, BackProvider } from "@/components/BackBar";
import { ErrorBoundary } from "@/components/ErrorBoundary";
import { ROUTES, findRoute, type AppRoute } from "@/routes";
import { markNotificationsRead } from "@/api/driver";
import { syncSubscription } from "@/lib/push";
function RequireAuth({ children }: { children: ReactNode }) {
const token = useAuth((s) => s.token);
const loc = useLocation();
if (token) return <>{children}</>;
// Запоминаем, куда шёл водитель (напр. ссылку на оплату), чтобы вернуть его
// туда после входа, а не на баланс.
setReturnTo(loc.pathname + loc.search);
return <Navigate to="/login" replace />;
}
/** Отладка существует только для сотрудника: либо он вошёл учёткой CRM, либо
* прямо сейчас смотрит от лица водителя. Обычному водителю адрес /debug ничего
* не даёт — его уводит на главную. */
function RequireStaff({ children }: { children: ReactNode }) {
const impersonated = useAuth((s) => s.impersonated);
const staffToken = useStaff((s) => s.token);
return impersonated || staffToken ? <>{children}</> : <Navigate to="/" replace />;
}
/**
* Экраны входа — только тому, кто ещё не вошёл. Вход после ссылки или пуша
* заменяет лишь последнюю запись истории, и экран входа остаётся позади: шаг
* назад (кнопкой или жестом) показал бы вошедшему выбор способа входа — без
* «Назад» и без пути дальше, кроме нового, платного входа. Отсюда — на главную.
*
* Смотрим на вход, с которым ПРИШЛИ на эту запись: токен, появившийся уже здесь,
* значит, что экран сам довёл вход и сейчас уведёт водителя туда, куда тот шёл
* (returnTo). Перебить его уходом на главную — потерять ссылку на оплату.
*/
function GuestOnly({ children }: { children: ReactNode }) {
const signedIn = useAuth((s) => !!s.token);
const { key } = useLocation();
const [arrived, setArrived] = useState({ key, signedIn });
if (arrived.key !== key) setArrived({ key, signedIn });
const wasSignedIn = arrived.key === key ? arrived.signedIn : signedIn;
return wasSignedIn ? <Navigate to="/" replace /> : <>{children}</>;
}
/**
* Нажатие по пушу — единственный честный признак, что уведомление увидели.
* Сам воркер отметить его не может: токен водителя лежит в хранилище страницы,
* ему недоступном. Поэтому воркер добавляет к адресу `?n=<номер>`, а отмечает
* страница — и тут же убирает параметр, чтобы он не остался в истории.
*/
function MarkPushRead() {
const loc = useLocation();
const nav = useNavigate();
useEffect(() => {
const params = new URLSearchParams(loc.search);
const raw = params.get("n");
if (!raw) return;
const id = Number(raw);
if (Number.isFinite(id) && id > 0) void markNotificationsRead([id], "push");
params.delete("n");
const rest = params.toString();
nav(loc.pathname + (rest ? `?${rest}` : ""), { replace: true });
}, [loc.search, loc.pathname, nav]);
return null;
}
/**
* Подписка на пуши живёт в браузере и переживает выход и смену водителя, а на
* сервере она привязана к тому, кто подписался. Разъехаться они могут молча:
* приложение видит подписку и считает уведомления включёнными, а сервер шлёт их
* прежнему водителю — или никому. Кнопки «выключить» у нас нет, так что выйти из
* этого состояния человеку нечем.
*
* Поэтому при каждом входе отдаём подписку серверу заново: эндпоинт переписывает
* её по endpoint на текущего водителя. Молча — водителю тут показывать нечего,
* а разрешения этот вызов не спрашивает.
*/
function SyncPushSubscription() {
const driverId = useAuth((s) => s.driverId);
useEffect(() => {
if (!driverId) return;
void syncSubscription().catch(() => undefined);
}, [driverId]);
return null;
}
function guarded(r: AppRoute): ReactNode {
if (r.guard === "staff") return <RequireAuth><RequireStaff>{r.element}</RequireStaff></RequireAuth>;
if (r.guard === "auth") return <RequireAuth>{r.element}</RequireAuth>;
if (r.guard === "guest") return <GuestOnly>{r.element}</GuestOnly>;
return r.element;
}
export default function App() {
const loc = useLocation();
// Упавшей главной или экрану входа «Назад» сверху не положен — вместо него
// страховка сама предложит «На главную».
const root = findRoute(loc.pathname)?.route.parent === null;
return (
<BackProvider>
{/* Отступ сверху не меньше системной полосы iPhone: если приложение когда-нибудь
начнёт рисовать под ней, «Назад» всё равно останется под пальцем. */}
<div className="mx-auto max-w-md min-h-full px-4 pt-[max(0.75rem,env(safe-area-inset-top))] pb-8">
{/* Плашка живёт над маршрутами: чей экран открыт, видно на каждом из них,
а не только там, где про неё вспомнили. Сама решает, показываться ли. */}
<ImpersonationBar />
{/* «Назад» — тоже над маршрутами и вне страховки от падений: есть на любом
экране кроме главной и входа, в любом его состоянии (см. routes.tsx). */}
<BackBar />
<SyncPushSubscription />
<MarkPushRead />
{/* Ключ — адрес целиком: выбор на экране живёт в строке запроса
(?kind=, ?by=code), и уход с неё — уже другой экран. */}
<ErrorBoundary resetKey={loc.pathname + loc.search} home={root}>
<Routes>
{/* Экраны — только из таблицы ROUTES: по ней же BackBar ищет родителя,
а тест-сторож проверяет «Назад». Сюда <Route> руками не добавлять. */}
{ROUTES.map((r) => (
<Route key={r.path} path={r.path} element={guarded(r)} />
))}
<Route path="*" element={<Navigate to="/" replace />} />
</Routes>
</ErrorBoundary>
</div>
</BackProvider>
);
}
@@ -0,0 +1,56 @@
import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
import { api } from "./client";
import { useAuth } from "@/store/auth";
/**
* Продление сеанса: бэкенд кладёт свежий токен в заголовок `X-Driver-Token`,
* приложение обязано молча его подменить. Без этого 30 дней жизни токена
* считались бы от входа, и раз в месяц водителя выкидывало бы на экран входа —
* при том, что пароля у него нет и «войти» означает сходить в бота за кодом.
*/
function answer(headers: Record<string, string> = {}) {
return vi.fn(async () =>
new Response(JSON.stringify({ ok: true }), {
status: 200,
headers: { "Content-Type": "application/json", ...headers },
}));
}
describe("продление токена водителя", () => {
beforeEach(() => {
useAuth.setState({ token: "OLD", driverId: 7, impersonated: false, driverName: null, own: null });
});
afterEach(() => vi.unstubAllGlobals());
it("подменяет токен, когда ответ принёс свежий", async () => {
vi.stubGlobal("fetch", answer({ "X-Driver-Token": "NEW" }));
await api.get("driver/balance").json();
expect(useAuth.getState().token).toBe("NEW");
expect(useAuth.getState().driverId).toBe(7);
});
it("без заголовка ничего не трогает", async () => {
vi.stubGlobal("fetch", answer());
await api.get("driver/balance").json();
expect(useAuth.getState().token).toBe("OLD");
});
it("не продлевает просмотр от лица водителя", async () => {
// Восемь часов просмотра — сознательный предел для чужого баланса на чужом
// ноутбуке. Бэкенд заголовок и не пришлёт, но полагаться на это нельзя:
// ответ на запрос, ушедший ДО начала просмотра, может прийти уже после.
useAuth.setState({ token: "IMP", driverId: 9, impersonated: true, driverName: "Петров" });
vi.stubGlobal("fetch", answer({ "X-Driver-Token": "NEW" }));
await api.get("driver/balance").json();
expect(useAuth.getState().token).toBe("IMP");
});
it("не воскрешает сеанс, закрытый пока запрос был в пути", async () => {
vi.stubGlobal("fetch", vi.fn(async () => {
useAuth.getState().clear(); // водитель нажал «выйти»
return new Response("{}", { status: 200, headers: { "X-Driver-Token": "NEW" } });
}));
await api.get("driver/balance").json();
expect(useAuth.getState().token).toBeNull();
});
});
+66
View File
@@ -0,0 +1,66 @@
import ky, { type KyInstance } from "ky";
import { pushEntry, shortPath } from "@/lib/reqlog";
import { useAuth } from "@/store/auth";
export const API_BASE = import.meta.env.VITE_API_BASE ?? "https://crm.pptaxi.ru/api";
/** Засечка времени на конкретный запрос. WeakMap — чтобы не держать Request'ы. */
const started = new WeakMap<Request, number>();
/**
* Заголовок, которым бэкенд отдаёт ПРОДЛЁННЫЙ токен водителя (см. driver_auth.py).
*
* Токен живёт 30 дней, и без продления они считались бы от входа: раз в месяц
* водителя выкидывало бы на экран входа, а «войти» для него означает сходить в
* бота за кодом. Начиная с пятого дня жизни токена бэкенд кладёт в ответ свежий,
* мы его молча подменяем — и 30 дней начинают считаться от последнего захода.
*/
const RENEWED_TOKEN_HEADER = "X-Driver-Token";
/** Подменить токен на продлённый, если ответ его принёс. */
function adoptRenewedToken(request: Request, response: Response): void {
const fresh = response.headers.get(RENEWED_TOKEN_HEADER);
if (!fresh) return;
const auth = useAuth.getState();
// Сеанс мог смениться, пока запрос был в пути: водитель вышел, сотрудник начал
// просмотр от чужого лица. Подменяем только тот токен, с которым сами ушли, —
// иначе продление чужого ответа вернёт закрытый сеанс к жизни.
if (auth.impersonated || auth.driverId == null) return;
if (request.headers.get("Authorization") !== `Bearer ${auth.token}`) return;
auth.setSession(fresh, auth.driverId);
}
export const api: KyInstance = ky.create({
prefixUrl: API_BASE,
timeout: 30_000,
retry: { limit: 2, methods: ["get"] },
hooks: {
beforeRequest: [
(request) => {
started.set(request, performance.now());
const token = useAuth.getState().token;
if (token) request.headers.set("Authorization", `Bearer ${token}`);
},
],
// В журнал попадают ОТВЕТИВШИЕ запросы, включая 4xx/5xx. Запрос, оборвавшийся
// без ответа (таймаут, пропавшая сеть), ky сюда не приносит — на экране
// отладки об этом сказано прямо, чтобы пустая строка не читалась как «дошло».
afterResponse: [
(request, _options, response) => {
pushEntry({
method: request.method,
path: shortPath(request.url),
status: response.status,
ms: Math.round(performance.now() - (started.get(request) ?? performance.now())),
});
adoptRenewedToken(request, response);
},
],
beforeError: [
(error) => {
if (error.response?.status === 401) useAuth.getState().clear();
return error;
},
],
},
});
@@ -0,0 +1,44 @@
import { describe, it, expect } from "vitest";
import { BalanceSchema, TopupSchema, PaymentsSchema, AuthRequestSchema, TgSessionSchema, TgPollSchema } from "./driver";
describe("driver api schemas", () => {
it("parses balance", () => {
const v = BalanceSchema.parse({ accounts: [{ bucket: "Долг аренда", balance: -3200 }] });
expect(v.accounts[0].bucket).toBe("Долг аренда");
});
it("parses topup", () => {
const v = TopupSchema.parse({ order_id: "o1", pay_url: "https://x", commission: 52, total: 1052 });
expect(v.pay_url).toBe("https://x");
});
it("parses auth request onboarding + code_sent", () => {
expect(AuthRequestSchema.parse({ status: "code_sent", channel: "tg" }).status).toBe("code_sent");
const pair = { pair_session: "S", poll_secret: "SEC", confirm_code: "4217" };
const o = AuthRequestSchema.parse({ status: "onboarding", deep_links: { tg: "t", max: "m" }, ...pair });
expect(o.status === "onboarding" && o.deep_links.tg).toBe("t");
// prod: MAX bot not configured → backend omits `max`, must still parse (regression guard)
const tgOnly = AuthRequestSchema.parse({ status: "onboarding", deep_links: { tg: "t" }, ...pair });
expect(tgOnly.status === "onboarding" && tgOnly.deep_links.tg).toBe("t");
});
it("parses payments history", () => {
const v = PaymentsSchema.parse({ payments: [{ order_id: "o1", bucket: "b", amount: 100,
commission: 5.2, method: "qr", status: "PAID", created_at: "2026-06-18T09:00:00Z", paid_at: null }] });
expect(v.payments[0].status).toBe("PAID");
});
});
describe("tg verified-login schemas", () => {
it("parses tg session", () => {
const v = TgSessionSchema.parse({ pair_session: "S", poll_secret: "SEC", confirm_code: "4217",
deep_link: "https://t.me/x?start=S" });
expect(v.pair_session).toBe("S");
expect(v.poll_secret).toBe("SEC");
// вторая половина ключа в deep-link не уходит
expect(v.deep_link).not.toContain("SEC");
});
it("parses tg poll states", () => {
expect(TgPollSchema.parse({ status: "pending" }).status).toBe("pending");
expect(TgPollSchema.parse({ status: "expired" }).status).toBe("expired");
const a = TgPollSchema.parse({ status: "authenticated", token: "T", driver_id: 7 });
expect(a.status === "authenticated" && a.token).toBe("T");
});
});
+346
View File
@@ -0,0 +1,346 @@
import { HTTPError } from "ky";
import { z } from "zod";
import { api } from "./client";
/** Pairing-сессия входа. `poll_secret` не покидает приложение (в deep-link уходит
* только `pair_session`), `confirm_code` человек сверяет с сообщением бота. */
export const TgSessionSchema = z.object({
pair_session: z.string(),
poll_secret: z.string(),
confirm_code: z.string(),
deep_link: z.string().nullable(),
});
export const AuthRequestSchema = z.union([
z.object({ status: z.literal("code_sent"), channel: z.string() }),
z.object({
status: z.literal("onboarding"),
deep_links: z.object({ tg: z.string().optional(), max: z.string().optional() }),
pair_session: z.string(),
poll_secret: z.string(),
confirm_code: z.string(),
}),
]);
export type AuthRequest = z.infer<typeof AuthRequestSchema>;
export const VerifySchema = z.object({ token: z.string(), driver_id: z.number() });
export const BalanceSchema = z.object({
accounts: z.array(z.object({
bucket: z.string(),
balance: z.number(),
// Можно ли платить в эту статью. «Страховка» приходит из 1С, но платежом не
// закрывается — строку показываем, нажатие не предлагаем.
payable: z.boolean().default(true),
})),
// Итог берём с сервера, а не суммой строк: 1С округляет статьи до рублей, а итог
// держит с копейками, и сумма строк с ним не сходится (−8 976 против −8 976,25).
total: z.number().nullable().default(null),
synced_at: z.string().nullable().default(null),
// Принято нами, но ещё не проведено в 1С. В сумму баланса не входит.
pending_topup: z.number().default(0),
});
export const BucketsSchema = z.object({
buckets: z.array(z.string()),
with_debt: z.array(z.string()),
});
export const TopupSchema = z.object({
order_id: z.string(), pay_url: z.string(), commission: z.number(), total: z.number(),
// Учебный платёж: сотрудник смотрит от лица водителя, банка в этой ветке нет
// (см. backend modules/payments/mock_pay.py). У обычного водителя всегда false.
mock: z.boolean().default(false),
});
export const PaymentStateSchema = z.object({ order_id: z.string(), status: z.string() });
export const CommissionSchema = z.object({ rate: z.number() });
export const PaymentsSchema = z.object({
payments: z.array(z.object({
order_id: z.string(), bucket: z.string(), amount: z.number(), commission: z.number(),
method: z.string(), status: z.string(),
created_at: z.string().nullable(), paid_at: z.string().nullable(),
reversed_at: z.string().nullable().default(null),
})),
});
export const TgPollSchema = z.union([
z.object({ status: z.literal("pending") }),
z.object({ status: z.literal("expired") }),
z.object({ status: z.literal("authenticated"), token: z.string(), driver_id: z.number() }),
]);
/**
* Текст ошибки от бэкенда.
*
* Раньше все отказы схлопывались в «Не удалось создать платёж», и осмысленные
* сообщения — про минимум СБП, про потолок суммы, про неизвестную категорию —
* до водителя не доходили: экран просто не реагировал.
*/
export async function apiErrorText(err: unknown, fallback: string): Promise<string> {
if (err instanceof HTTPError) {
try {
const body = await err.response.json();
const detail = (body as { detail?: unknown })?.detail;
if (typeof detail === "string" && detail.trim()) return detail;
} catch {
/* тело не JSON — отдадим запасной текст */
}
}
return fallback;
}
/**
* Сколько секунд ждать перед повторным запросом кода. Берём из заголовка
* Retry-After ответа 429; если его нет — null (вызывающий решит сам).
*/
export function retryAfterSeconds(err: unknown): number | null {
if (err instanceof HTTPError) {
const raw = err.response.headers.get("Retry-After");
const n = raw ? parseInt(raw, 10) : NaN;
if (Number.isFinite(n) && n > 0) return n;
}
return null;
}
export const tgSession = async () =>
TgSessionSchema.parse(await api.post("driver/auth/tg/session").json());
/** POST, а не GET: в query-параметре pair_session оседал в access-логах. */
export const tgPoll = async (pairSession: string, pollSecret: string) =>
TgPollSchema.parse(
await api.post("driver/auth/tg/poll", {
json: { pair_session: pairSession, poll_secret: pollSecret },
}).json(),
);
export const authRequest = async (phone: string) =>
AuthRequestSchema.parse(await api.post("driver/auth/request", { json: { phone } }).json());
export const authVerify = async (phone: string, code: string) =>
VerifySchema.parse(await api.post("driver/auth/verify", { json: { phone, code } }).json());
export const getBalance = async () =>
BalanceSchema.parse(await api.get("driver/balance").json());
export const getBuckets = async () =>
BucketsSchema.parse(await api.get("driver/buckets").json());
export const topup = async (bucket: string, amount: number, method: "qr" | "card",
live = false) =>
TopupSchema.parse(await api.post("driver/topup", {
json: { bucket, amount, method, live },
}).json());
export const getPaymentState = async (orderId: string) =>
PaymentStateSchema.parse(await api.get(`driver/payment/${orderId}`).json());
export const getPayments = async () =>
PaymentsSchema.parse(await api.get("driver/payments").json());
export const getCommission = async () =>
CommissionSchema.parse(await api.get("driver/commission").json());
/** Исход учебного платежа. Работает только под просмотром сотрудника. */
export const mockPayOutcome = async (
orderId: string, outcome: "paid" | "rejected" | "expired" | "reversed",
) => PaymentStateSchema.parse(
await api.post(`driver/mock-pay/${orderId}`, { json: { outcome } }).json(),
);
export const StatementSchema = z.object({
items: z.array(z.object({
date: z.string().nullable(),
title: z.string(),
description: z.string().default(""),
amount: z.number(),
kind: z.enum(["charges", "payments", "fines"]),
// Карточка штрафа, если постановление у нас есть. null — строка не ссылка.
fine_id: z.number().nullable().default(null),
})),
from: z.string(),
to: z.string(),
kind: z.string(),
});
export type StatementKind = "all" | "charges" | "payments" | "fines";
/** Выписка по счёту за период. Даты — ISO (ГГГГ-ММ-ДД), как их понимает бэкенд. */
export const getStatement = async (from: string, to: string, kind: StatementKind) =>
StatementSchema.parse(await api.get("driver/statement", {
searchParams: { from, to, kind },
}).json());
const FineBriefSchema = z.object({
id: z.number(),
number: z.string(),
date: z.string().nullable(),
article: z.string(),
address: z.string().default(""),
car_number: z.string().default(""),
// Сумма, начисленная ВОДИТЕЛЮ. Номинала постановления, скидки и расчётов парка
// с ГИБДД в приложении нет намеренно — водителю нужен факт штрафа и сумма.
amount: z.number(),
// Погашен ли штраф водителем перед парком. Постановление парк гасит авансом,
// и на этот признак его расчёты не влияют.
settled: z.enum(["owed", "paid", "not_charged", "cancelled", "unknown"]),
cancelled: z.boolean().default(false),
has_photo: z.boolean().default(false),
});
export type FineBrief = z.infer<typeof FineBriefSchema>;
export const FinesSchema = z.object({
items: z.array(FineBriefSchema),
open_count: z.number(),
// Долг по штрафам из 1С — тот же, что на главном экране (отрицательный).
debt: z.number(),
});
export const FineDetailSchema = FineBriefSchema.extend({
post_date: z.string().nullable().default(null),
speed: z.number().nullable().default(null),
speed_limit: z.number().nullable().default(null),
speed_excess: z.number().nullable().default(null),
camera: z.string().default(""),
// Ссылки подписанные и живут час — держать их в кэше дольше нет смысла.
photos: z.array(z.string()).default([]),
document: z.string().nullable().default(null),
});
export const getFines = async (status: "all" | "open") =>
FinesSchema.parse(await api.get("driver/fines", { searchParams: { status } }).json());
export const getFine = async (id: number) =>
FineDetailSchema.parse(await api.get(`driver/fines/${id}`).json());
export const NotificationSchema = z.object({
id: z.number(),
kind: z.string(),
title: z.string(),
body: z.string(),
url: z.string().nullable().default(null),
created_at: z.string().nullable().default(null),
read_at: z.string().nullable().default(null),
});
export type DriverNotification = z.infer<typeof NotificationSchema>;
export const NotificationsSchema = z.object({
items: z.array(NotificationSchema),
unread: z.number(),
});
export const getNotifications = async () =>
NotificationsSchema.parse(await api.get("driver/notifications").json());
/** Отметить прочитанным. Без списка — «всё»: так отмечает открытие ленты. */
export const markNotificationsRead = async (ids?: number[], source: "app" | "push" = "app") =>
api.post("driver/notifications/read", { json: { ids: ids ?? null, source } }).json();
export const PushKeySchema = z.object({ key: z.string(), enabled: z.boolean() });
export const getPushKey = async () =>
PushKeySchema.parse(await api.get("driver/push/key").json());
export const subscribePush = async (sub: { endpoint: string; p256dh: string; auth: string }) =>
api.post("driver/push/subscribe", { json: sub }).json();
export const unsubscribePush = async (endpoint: string) =>
api.post("driver/push/unsubscribe", { json: { endpoint } }).json();
/** Пробное уведомление себе. Доступно только при просмотре сотрудником. */
export const sendTestPush = async () => api.post("driver/push/test").json();
// ── Бонусы (система лояльности) ──────────────────────────────────────────────
export const BonusesSchema = z.object({
level: z.object({
code: z.string(),
title: z.string(),
subtitle: z.string(),
days: z.number(),
next: z.object({ title: z.string(), days_left: z.number() }).nullable(),
series_start: z.string().nullable().default(null),
}),
week: z.object({
monday: z.string(),
orders: z.object({
yandex: z.number(),
maxim: z.number(),
total: z.number(),
tier_amount: z.number().default(0),
next_tier: z.object({ minimum: z.number(), amount: z.number() }).nullable().default(null),
}),
}),
payment_streak: z.object({
weeks: z.number(), weekly_amount: z.number(), monthly_cap: z.number(),
}),
clean: z.object({
days: z.number(),
next: z.object({ days: z.number(), amount: z.number() }).nullable().default(null),
}),
discount: z.object({
active: z.boolean(),
per_day: z.number(),
series: z.number(),
max_series: z.number(),
threshold: z.number(),
this_week_best: z.number(),
ends_at: z.string().nullable().default(null),
}),
sums: z.object({ pending: z.number(), earned: z.number(), this_month: z.number() }),
referral: z.object({
code: z.string(),
connect_amount: z.number(),
days_amount: z.number(),
work_days: z.number(),
invited: z.array(z.object({
driver_id: z.number(), days: z.number(), connected: z.boolean(),
})).default([]),
}),
goals: z.array(z.object({
kind: z.string(), text: z.string(), left: z.number(),
})).default([]),
accruals: z.array(z.object({
id: z.number(), program: z.string(), kind: z.string(), amount: z.number(),
title: z.string(), status: z.string(), date: z.string().nullable().default(null),
})).default([]),
// Что реально работает у водителя (глобально И адресно). Пусто/все false —
// водитель в бонусной программе не участвует: экран и вход закрыты.
programs_enabled: z.record(z.string(), z.boolean()).default({}),
});
export type Bonuses = z.infer<typeof BonusesSchema>;
export const getBonuses = async () =>
BonusesSchema.parse(await api.get("driver/bonuses").json());
// ── Вход по номеру через МТС ID ──────────────────────────────────────────────
// Оператор подтверждает владение номером sim-push'ем, а если push не дошёл —
// СМС с кодом. Ответ от МТС приезжает нам колбэком СНАРУЖИ, поэтому приложение
// опрашивает сервер, а не ждёт ответа на свой запрос.
export const MtsStatusSchema = z.object({ enabled: z.boolean() });
export const MtsStartSchema = z.object({
session: z.string(),
poll_secret: z.string(),
status: z.string(),
expires_in: z.number(),
// Seamless: GET по этому адресу должно сделать УСТРОЙСТВО пользователя через
// мобильную сеть — так оператор определяет номер по заголовкам сети.
hhe_uri: z.string().nullable().default(null),
});
export const MtsPollSchema = z.union([
z.object({ status: z.literal("pending") }),
z.object({ status: z.literal("sms_required") }),
z.object({ status: z.literal("expired") }),
z.object({ status: z.literal("failed"), message: z.string() }),
z.object({ status: z.literal("authenticated"), token: z.string(), driver_id: z.number() }),
]);
/** Показывать ли кнопку входа по номеру. Пока креды МТС не заведены — false. */
export const mtsStatus = async () =>
MtsStatusSchema.parse(await api.get("driver/auth/mts/status").json());
export const mtsStart = async (phone: string) =>
MtsStartSchema.parse(await api.post("driver/auth/mts/start", { json: { phone } }).json());
/** POST, а не GET: session в query-параметре оседает в access-логах Caddy. */
export const mtsPoll = async (session: string, pollSecret: string) =>
MtsPollSchema.parse(
await api.post("driver/auth/mts/poll", {
json: { session, poll_secret: pollSecret },
}).json(),
);
export const mtsCode = async (session: string, pollSecret: string, code: string) =>
api.post("driver/auth/mts/code", {
json: { session, poll_secret: pollSecret, code },
}).json();
+85
View File
@@ -0,0 +1,85 @@
import ky from "ky";
import { z } from "zod";
import { pushEntry, shortPath } from "@/lib/reqlog";
import { API_BASE } from "./client";
import { useStaff } from "@/store/staff";
/**
* Учётка CRM внутри приложения водителя — только ради просмотра от чужого лица.
*
* Свой экземпляр ky, а не общий `api`: тот подставляет ВОДИТЕЛЬСКИЙ токен, и на
* запросе к /driver/staff/* заголовок оказался бы чужим. Плюс 401 здесь означает
* «протух сеанс сотрудника», а не «водителя выкинуло».
*/
const started = new WeakMap<Request, number>();
const staffApi = ky.create({
prefixUrl: API_BASE,
timeout: 30_000,
hooks: {
beforeRequest: [
(request) => {
started.set(request, performance.now());
const token = useStaff.getState().token;
if (token) request.headers.set("Authorization", `Bearer ${token}`);
},
],
afterResponse: [
(request, _o, response) => {
pushEntry({
method: request.method, path: shortPath(request.url), status: response.status,
ms: Math.round(performance.now() - (started.get(request) ?? performance.now())),
});
},
],
beforeError: [
(error) => {
if (error.response?.status === 401) useStaff.getState().clear();
return error;
},
],
},
});
export const LoginSchema = z.object({
access_token: z.string().nullable().default(null),
requires_2fa: z.boolean().default(false),
partial_token: z.string().nullable().default(null),
});
export const DriverBriefSchema = z.object({
id: z.number(),
fio: z.string(),
phone: z.string(),
status: z.string(),
driver_kind: z.string(),
});
export type DriverBrief = z.infer<typeof DriverBriefSchema>;
export const DriversSchema = z.object({ drivers: z.array(DriverBriefSchema) });
export const ImpersonateSchema = z.object({
token: z.string(),
driver: DriverBriefSchema,
});
/** Логин CRM. Форма, а не JSON: эндпоинт принимает OAuth2PasswordRequestForm. */
export const staffLogin = async (username: string, password: string) => {
const body = new URLSearchParams({ username, password });
return LoginSchema.parse(await staffApi.post("auth/login", { body }).json());
};
/** Второй шаг, если у учётки включена двухфакторка. */
export const staffLogin2fa = async (partialToken: string, code: string) =>
LoginSchema.parse(await staffApi.post("auth/2fa", {
json: { partial_token: partialToken, code, remember_device: false },
}).json());
export const searchDrivers = async (q: string) =>
DriversSchema.parse(await staffApi.get("driver/staff/drivers", {
searchParams: { q, limit: 30 },
}).json());
export const impersonate = async (driverId: number) =>
ImpersonateSchema.parse(await staffApi.post("driver/staff/impersonate", {
json: { driver_id: driverId },
}).json());
@@ -0,0 +1,41 @@
import { useNavigate } from "react-router-dom";
import { useRef } from "react";
import { NotificationsBell } from "@/pages/NotificationsPage";
/** Долгое нажатие, после которого открывается вход для сотрудника. */
const LONG_PRESS_MS = 1500;
/** Колокольчик по умолчанию выключен: он тянет счётчик уведомлений, а шапка
* стоит на каждом экране — незачем ходить за ним с оплаты или из штрафа.
* Включается там, откуда водитель и правда пойдёт читать: на главной. */
export function AppHeader({ bell = false }: { bell?: boolean } = {}) {
const nav = useNavigate();
const timer = useRef<number | null>(null);
// Ссылки «для сотрудника» на экранах водителя нет намеренно: водителю она
// ничего не даёт, а место занимает. Но сотруднику, уже вошедшему водителем,
// адрес /dev иначе приходится набирать руками — отсюда долгий тап по названию.
const start = () => {
timer.current = window.setTimeout(() => nav("/dev"), LONG_PRESS_MS);
};
const cancel = () => {
if (timer.current) window.clearTimeout(timer.current);
timer.current = null;
};
return (
<header className="mb-4 flex items-center justify-between">
<span
className="text-sm font-bold select-none"
onPointerDown={start}
onPointerUp={cancel}
onPointerLeave={cancel}
onContextMenu={(e) => e.preventDefault()}
>
Премиум Водитель
</span>
{bell && <NotificationsBell />}
</header>
);
}
@@ -0,0 +1,43 @@
import { useContext, useState, type ReactNode } from "react";
import { useLocation } from "react-router-dom";
import { findRoute, resolveParent } from "@/routes";
import { BackContext, type BackTarget } from "@/lib/back";
import { useAuth } from "@/store/auth";
import { BackButton } from "@/components/BackButton";
/**
* Родитель текущего экрана — один раз по таблице маршрутов, для всех: кнопки
* над экраном (BackBar) и выходов внутри страниц (useRouteBack). Здесь же живёт
* цель, которую страница может задать сама (useBackOverride).
*/
export function BackProvider({ children }: { children: ReactNode }) {
const loc = useLocation();
const signedIn = useAuth((s) => !!s.token);
const [override, setOverride] = useState<BackTarget | null>(null);
const hit = findRoute(loc.pathname);
const parent =
hit && hit.route.parent !== null
? {
to: resolveParent(hit.route.parent, {
params: hit.params,
search: new URLSearchParams(loc.search),
signedIn,
}),
mode: hit.route.back,
}
: null;
return <BackContext.Provider value={{ parent, override, setOverride }}>{children}</BackContext.Provider>;
}
/**
* Строка «Назад» над экраном. Стоит в App над маршрутами, а не в страницах:
* так она есть в любом состоянии экрана — загрузка, ошибка, пустота, редирект
* охраны, — и новый раздел получает её сам, стоит завести его в таблице
* маршрутов с родителем. У главной и входа родителя нет — строки тоже.
*/
export function BackBar() {
const { parent, override } = useContext(BackContext);
if (!parent) return null;
const target = override ?? parent;
return <BackButton to={target.to} mode={target.mode} />;
}
@@ -0,0 +1,26 @@
import { ChevronLeft } from "lucide-react";
import { useBack, type BackMode } from "@/lib/back";
/**
* Кнопка «Назад» — одна на всё приложение, всегда в левом верхнем углу.
*
* Обычно её ставит BackBar по таблице маршрутов; сама страница рисует её только
* для своего режима, у которого есть адрес, а родителя в таблице нет (вход по
* коду). Высота 44 px — палец попадает с первого раза, подпись словом, а не
* одной стрелкой: так её находят и те, кто не привык к значкам.
*/
export function BackButton({ to, mode }: { to: string; mode?: BackMode }) {
const back = useBack(to, { mode });
return (
<div className="mb-1">
<button
type="button"
onClick={back}
className="-ml-2 inline-flex items-center gap-0.5 h-11 min-w-11 pl-1 pr-3 text-sm font-semibold text-ink-soft active:text-ink"
>
<ChevronLeft size={22} aria-hidden="true" />
Назад
</button>
</div>
);
}
@@ -0,0 +1,86 @@
import { useEffect, useState } from "react";
import { Search } from "lucide-react";
import { toast } from "sonner";
import { apiErrorText } from "@/api/driver";
import { impersonate, searchDrivers, type DriverBrief } from "@/api/staff";
import { useAuth } from "@/store/auth";
import { Spinner } from "@/components/Spinner";
/**
* Выбор водителя, от лица которого смотреть. Один компонент на два места:
* первый вход сотрудника (/dev) и смена водителя на вкладке «Отладка».
*/
export function DriverPicker({ onPicked }: { onPicked: (d: DriverBrief) => void }) {
const startImpersonation = useAuth((s) => s.startImpersonation);
const [q, setQ] = useState("");
const [list, setList] = useState<DriverBrief[]>([]);
const [loading, setLoading] = useState(true);
const [busyId, setBusyId] = useState<number | null>(null);
useEffect(() => {
let alive = true;
setLoading(true);
// Пауза перед запросом: иначе поиск уходит на каждую букву, и ответы
// возвращаются вперемешку — список прыгает.
const t = setTimeout(() => {
searchDrivers(q)
.then((r) => { if (alive) setList(r.drivers); })
.catch(async (e) => { if (alive) toast.error(await apiErrorText(e, "Не удалось найти водителей")); })
.finally(() => { if (alive) setLoading(false); });
}, 300);
return () => { alive = false; clearTimeout(t); };
}, [q]);
async function pick(d: DriverBrief) {
setBusyId(d.id);
try {
const r = await impersonate(d.id);
startImpersonation(r.token, r.driver.id, r.driver.fio);
onPicked(r.driver);
} catch (e: unknown) {
toast.error(await apiErrorText(e, "Не удалось открыть приложение за водителя"));
} finally {
setBusyId(null);
}
}
return (
<div>
<div className="card flex items-center gap-2 px-3 py-2.5 mb-3 bg-surface">
<Search size={16} className="text-muted shrink-0" />
<input
autoFocus
value={q}
onChange={(e) => setQ(e.target.value)}
placeholder="ФИО, телефон или id"
className="w-full text-base bg-transparent outline-none"
/>
</div>
{loading ? (
<div className="flex justify-center py-8"><Spinner /></div>
) : list.length === 0 ? (
<p className="text-muted text-sm text-center py-8">Никого не нашли</p>
) : (
<div className="card divide-y divide-line">
{list.map((d) => (
<button
key={d.id}
disabled={busyId !== null}
onClick={() => pick(d)}
className="w-full text-left px-4 py-3 flex items-center justify-between gap-3 disabled:opacity-50"
>
<span className="min-w-0">
<span className="block text-sm font-semibold truncate">{d.fio}</span>
<span className="block text-muted text-xs truncate">
#{d.id}{d.phone ? ` · ${d.phone}` : ""}{d.status ? ` · ${d.status}` : ""}
</span>
</span>
{busyId === d.id ? <Spinner /> : <span className="text-muted text-xs shrink-0">смотреть</span>}
</button>
))}
</div>
)}
</div>
);
}
@@ -0,0 +1,66 @@
import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
import { cleanup, render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { MemoryRouter } from "react-router-dom";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
// Карточка штрафа, падающая при отрисовке, — как упал бы любой экран на
// неожиданных данных.
vi.mock("@/pages/FineDetailPage", () => ({
FineDetailPage: () => {
throw new Error("сломалось");
},
}));
// Экран входа тоже падает — у него, в отличие от карточки, «Назад» сверху нет.
vi.mock("@/pages/LoginPage", () => ({
LoginPage: () => {
throw new Error("сломалось");
},
}));
import App from "@/App";
import { useAuth } from "@/store/auth";
const renderAt = (url: string) =>
render(
<QueryClientProvider client={new QueryClient({ defaultOptions: { queries: { retry: false } } })}>
<MemoryRouter initialEntries={[url]}><App /></MemoryRouter>
</QueryClientProvider>
);
describe("экран упал при отрисовке", () => {
beforeEach(() => {
vi.stubGlobal("fetch", vi.fn(() => new Promise<Response>(() => {})));
// React громко пишет пойманную ошибку в консоль — в тесте это шум.
vi.spyOn(console, "error").mockImplementation(() => undefined);
window.history.replaceState(null, "", "/");
useAuth.getState().setSession("t", 42);
});
afterEach(() => {
cleanup();
vi.unstubAllGlobals();
vi.restoreAllMocks();
useAuth.getState().clear();
});
it("вместо белого экрана — «Перезагрузить» и «Назад», и уйти можно", async () => {
renderAt("/fines/1");
expect(screen.getByRole("button", { name: "Перезагрузить" })).toBeInTheDocument();
// Выход с экрана — «Назад» сверху; вторая кнопка ухода тут лишняя.
expect(screen.queryByRole("button", { name: "На главную" })).not.toBeInTheDocument();
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
// Ушли с упавшего экрана — обёртка сбрасывается и рисует главную.
expect(screen.queryByRole("button", { name: "Перезагрузить" })).not.toBeInTheDocument();
expect(screen.getByRole("button", { name: /^Пополнить$/ })).toBeInTheDocument();
});
it("упал экран без «Назад» — есть «На главную», а не только перезагрузка", () => {
// Перезагрузка вернула бы тот же адрес (?by=code) — и то же падение.
useAuth.getState().clear();
renderAt("/login?by=code");
expect(screen.getByRole("button", { name: "Перезагрузить" })).toBeInTheDocument();
expect(screen.getByRole("button", { name: "На главную" })).toBeInTheDocument();
expect(screen.queryByRole("button", { name: "Назад" })).not.toBeInTheDocument();
});
});
@@ -0,0 +1,54 @@
import { Component, type ErrorInfo, type ReactNode } from "react";
import { RotateCw } from "lucide-react";
/**
* Страховка от белого экрана: упавший при отрисовке экран раньше оставлял
* пустоту без единой кнопки. Теперь вместо него — «Перезагрузить», а «Назад»
* остаётся сверху: BackBar стоит вне этой обёртки.
*
* `resetKey` — адрес экрана: ушли с упавшего экрана — пробуем рисовать снова.
* `home` — у экрана нет «Назад» (главная, вход): выход — «На главную» начисто.
* Перезагрузка вернула бы тот же адрес с тем же выбором (?kind=, ?by=code), а
* с ним и то же падение.
*/
export class ErrorBoundary extends Component<
{ resetKey: string; home: boolean; children: ReactNode },
{ failed: boolean }
> {
state = { failed: false };
static getDerivedStateFromError() {
return { failed: true };
}
componentDidCatch(error: Error, info: ErrorInfo) {
console.error(error, info.componentStack);
}
componentDidUpdate(prev: { resetKey: string }) {
if (this.state.failed && prev.resetKey !== this.props.resetKey) this.setState({ failed: false });
}
render() {
if (!this.state.failed) return this.props.children;
return (
<div className="pt-16 text-center">
<p className="text-sm font-semibold mb-1">Экран не открылся</p>
<p className="text-muted text-xs mb-6">Перезагрузите приложение — обычно этого достаточно.</p>
<button
className="btn-primary flex items-center justify-center gap-2"
onClick={() => window.location.reload()}
>
<RotateCw size={16} aria-hidden="true" /> Перезагрузить
</button>
{this.props.home && (
// Полная загрузка с чистого адреса: сбрасывает и строку запроса, и
// всё, что приложение успело держать в памяти.
<button className="btn-ghost mt-3" onClick={() => window.location.replace("/")}>
На главную
</button>
)}
</div>
);
}
}
@@ -0,0 +1,38 @@
import { useLocation, useNavigate } from "react-router-dom";
import { Eye } from "lucide-react";
import { useRouteBack } from "@/lib/back";
import { useAuth } from "@/store/auth";
/**
* Плашка «вы смотрите чужой экран». Видна на каждом экране и всегда, пока
* действует токен просмотра.
*
* Она не украшение: интерфейс в этом режиме неотличим от водительского — те же
* суммы, те же долги, та же история. Без постоянного напоминания легко принять
* чужой баланс за свой и, например, позвонить водителю с чужими цифрами.
*/
export function ImpersonationBar() {
const nav = useNavigate();
const loc = useLocation();
const { impersonated, driverName, driverId } = useAuth();
// С отладки — туда, откуда на неё пришли (иначе к её родителю в routes.tsx),
// а не новой записью главной поверх: системный «назад» вернул бы на отладку.
const back = useRouteBack();
if (!impersonated) return null;
const onDebug = loc.pathname === "/debug";
return (
<div className="flex items-center gap-2 mb-3 px-3 py-2 rounded-xl2 border border-warn/40 bg-warn/10 text-warn text-xs">
<Eye size={14} className="shrink-0" />
<span className="min-w-0 truncate">
Смотрю как <b>{driverName ?? `водитель #${driverId}`}</b>
</span>
<button
className="ml-auto shrink-0 underline underline-offset-2"
onClick={() => (onDebug ? back() : nav("/debug"))}
>
{onDebug ? "к приложению" : "отладка"}
</button>
</div>
);
}
@@ -0,0 +1,53 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
vi.mock("@/lib/install", () => ({
subscribe: vi.fn(() => () => undefined),
canPrompt: vi.fn(() => false),
isIos: vi.fn(() => false),
shouldOffer: vi.fn(() => true),
promptInstall: vi.fn(async () => true),
}));
import { InstallHint } from "./InstallHint";
import * as install from "@/lib/install";
describe("InstallHint", () => {
beforeEach(() => vi.clearAllMocks());
it("установленному приложению не предлагаем ничего", () => {
// Подсказка про то, что уже сделано, приучает не читать подсказки вовсе.
vi.mocked(install.shouldOffer).mockReturnValue(false);
const { container } = render(<InstallHint />);
expect(container).toBeEmptyDOMElement();
});
it("где браузер даёт штатную установку — кнопка, а не инструкция", async () => {
vi.mocked(install.shouldOffer).mockReturnValue(true);
vi.mocked(install.canPrompt).mockReturnValue(true);
render(<InstallHint />);
await userEvent.click(screen.getByRole("button", { name: /Установить/i }));
expect(install.promptInstall).toHaveBeenCalled();
});
it("на iOS объясняем шаги: штатного окна установки там нет", () => {
// А без установки на iOS не работают push-уведомления вовсе — значит текст
// должен быть дословным, а не «добавьте на главный экран».
vi.mocked(install.shouldOffer).mockReturnValue(true);
vi.mocked(install.canPrompt).mockReturnValue(false);
vi.mocked(install.isIos).mockReturnValue(true);
render(<InstallHint />);
expect(screen.getByText(/Поделиться/i)).toBeInTheDocument();
expect(screen.getByText(/На экран/i)).toBeInTheDocument();
expect(screen.queryByRole("button")).not.toBeInTheDocument();
});
it("остальным — общая подсказка про меню браузера", () => {
vi.mocked(install.shouldOffer).mockReturnValue(true);
vi.mocked(install.canPrompt).mockReturnValue(false);
vi.mocked(install.isIos).mockReturnValue(false);
render(<InstallHint />);
expect(screen.getByText(/меню браузера/i)).toBeInTheDocument();
});
});
@@ -0,0 +1,62 @@
import { useSyncExternalStore } from "react";
import { Download } from "lucide-react";
import { canPrompt, isIos, promptInstall, shouldOffer, subscribe } from "@/lib/install";
/**
* Предложение поставить приложение на домашний экран. Живёт на экране входа.
*
* Почему именно там: это единственный экран, который видит человек, открывший
* приложение впервые, — и единственный момент, когда он ещё ничего не начал и
* готов потратить десять секунд на установку.
*
* Про штрафы и долги в текстах — ни слова. Установку предлагаем ради удобства:
* «поставьте, чтобы мы сообщали вам о штрафах» читается как угроза, а не как
* приглашение, и работает против самой просьбы.
*
* Установленному приложению не показываем ничего: предлагать сделать то, что уже
* сделано, — верный способ, чтобы подсказки перестали читать вовсе.
*/
export function InstallHint() {
// Через useSyncExternalStore, а не useState+useEffect: `beforeinstallprompt`
// прилетает ДО монтирования React (слушатель висит с загрузки модуля), и
// эффект, подписавшийся позже, о нём бы не узнал.
const installable = useSyncExternalStore(subscribe, canPrompt, () => false);
if (!shouldOffer()) return null;
if (installable) {
return (
<div className="card p-4 mt-8">
<p className="text-sm font-semibold mb-1">Это приложение</p>
<p className="text-muted text-xs mb-3">
Поставьте его на главный экран — будет открываться в одно касание,
как обычное приложение.
</p>
<button
className="btn-ghost flex items-center justify-center gap-1.5"
onClick={() => { void promptInstall(); }}
>
<Download size={16} strokeWidth={1.5} /> Установить
</button>
</div>
);
}
// Safari штатного окна установки не даёт — только руками. Без уведомлений на
// iOS приложение наполовину бесполезно, поэтому объясняем шаги дословно.
if (isIos()) {
return (
<p className="text-muted text-xs text-center mt-8">
Это приложение. Чтобы открывать его в одно касание, нажмите «Поделиться»
внизу браузера и выберите «На экран „Домой“».
</p>
);
}
return (
<p className="text-muted text-xs text-center mt-8">
Это приложение. Его можно поставить на главный экран — в меню браузера
выберите «Установить приложение».
</p>
);
}
@@ -0,0 +1,57 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
vi.mock("@/lib/push", () => ({
currentState: vi.fn(async () => "off"),
enable: vi.fn(async () => "on"),
installed: vi.fn(() => true),
}));
import { NotificationsPrompt } from "./NotificationsPrompt";
import * as push from "@/lib/push";
describe("предложение включить уведомления", () => {
beforeEach(() => {
localStorage.clear();
vi.clearAllMocks();
vi.mocked(push.installed).mockReturnValue(true);
vi.mocked(push.currentState).mockResolvedValue("off");
});
it("установленному приложению предлагаем — своей карточкой, а не системным окном", async () => {
render(<NotificationsPrompt />);
expect(await screen.findByText("Сообщать об изменениях?")).toBeInTheDocument();
// Системное окно вызывается только по кнопке: оно показывается один раз за
// установку, и отказ браузер запоминает навсегда.
expect(push.enable).not.toHaveBeenCalled();
await userEvent.click(screen.getByRole("button", { name: "Включить" }));
expect(push.enable).toHaveBeenCalled();
});
it("во вкладке браузера не предлагаем: на iPhone это всё равно не работает", async () => {
vi.mocked(push.installed).mockReturnValue(false);
render(<NotificationsPrompt />);
expect(screen.queryByText("Сообщать об изменениях?")).not.toBeInTheDocument();
});
it("«не сейчас» откладывает на неделю, а не отказывает навсегда", async () => {
render(<NotificationsPrompt />);
await userEvent.click(await screen.findByRole("button", { name: "Не сейчас" }));
expect(screen.queryByText("Сообщать об изменениях?")).not.toBeInTheDocument();
const until = Number(localStorage.getItem("pp-push-prompt-later"));
const days = (until - Date.now()) / 86400_000;
expect(days).toBeGreaterThan(6.5);
expect(days).toBeLessThan(7.5);
// Пока срок не вышел — не показываем повторно.
render(<NotificationsPrompt />);
expect(screen.queryByText("Сообщать об изменениях?")).not.toBeInTheDocument();
});
it("уже включено — карточки нет", async () => {
vi.mocked(push.currentState).mockResolvedValue("on");
render(<NotificationsPrompt />);
expect(screen.queryByText("Сообщать об изменениях?")).not.toBeInTheDocument();
});
});
@@ -0,0 +1,87 @@
import { useEffect, useState } from "react";
import { Bell } from "lucide-react";
import { toast } from "sonner";
import { currentState, enable, errorCode, installed, type PushState } from "@/lib/push";
/**
* Предложение включить уведомления — после установки приложения.
*
* Почему своя карточка, а не сразу системное окно. Системное показывается ОДИН
* раз за установку: отказ браузер запоминает навсегда, и переспросить нельзя.
* Своё предложение отказа не стоит — «не сейчас» просто откладывает его на
* неделю, и вернуться к разговору можно.
*
* Почему после установки, а не на входе. На iPhone уведомления работают только в
* установленном приложении, а человеку, который ещё не решил, нужен ли ему этот
* сайт вообще, вопрос про уведомления мешает.
*/
const DELAY_KEY = "pp-push-prompt-later";
const REMIND_AFTER_DAYS = 7;
function postponed(): boolean {
const raw = localStorage.getItem(DELAY_KEY);
if (!raw) return false;
const until = Number(raw);
return Number.isFinite(until) && Date.now() < until;
}
export function NotificationsPrompt() {
const [state, setState] = useState<PushState | null>(null);
const [hidden, setHidden] = useState(postponed());
const [busy, setBusy] = useState(false);
useEffect(() => {
let alive = true;
const refresh = () => currentState().then((s) => { if (alive) setState(s); });
refresh();
// Приложение только что поставили на домашний экран — самое время спросить,
// человек как раз занят настройкой.
const onInstalled = () => { setHidden(false); refresh(); };
window.addEventListener("appinstalled", onInstalled);
return () => { alive = false; window.removeEventListener("appinstalled", onInstalled); };
}, []);
// Показываем только установленному приложению и только пока разрешение не
// спрашивали: «включить» для остальных живёт строкой внизу экрана.
if (hidden || state !== "off" || !installed()) return null;
async function turnOn() {
setBusy(true);
try {
const next = await enable();
setState(next);
if (next !== "on") toast.error("Уведомления не включились");
} catch (e) {
// Код в скобках — не украшение: без него причина теряется навсегда, а
// водитель всё равно не разберёт ни одну формулировку. Зато по «AbortError»
// или «sw-timeout» чинится за минуту.
toast.error(`Не удалось включить уведомления (${errorCode(e)})`);
} finally {
setBusy(false);
}
}
function later() {
localStorage.setItem(DELAY_KEY, String(Date.now() + REMIND_AFTER_DAYS * 86400_000));
setHidden(true);
}
return (
<div className="card p-4 mb-3">
<div className="flex items-start gap-3">
<Bell size={18} strokeWidth={1.5} className="text-muted shrink-0 mt-0.5" />
<div className="min-w-0">
<p className="text-sm font-semibold mb-1">Сообщать об изменениях?</p>
<p className="text-muted text-xs">
Не придётся заходить и проверять — сообщим сами, когда баланс
изменится.
</p>
</div>
</div>
<div className="flex gap-2 mt-3">
<button className="btn-primary" disabled={busy} onClick={turnOn}>Включить</button>
<button className="btn-ghost" disabled={busy} onClick={later}>Не сейчас</button>
</div>
</div>
);
}
@@ -0,0 +1,63 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
vi.mock("@/lib/push", () => ({
currentState: vi.fn(async () => "off"),
enable: vi.fn(async () => "on"),
}));
import { NotificationsRow } from "./NotificationsRow";
import * as push from "@/lib/push";
describe("строка уведомлений", () => {
beforeEach(() => {
vi.clearAllMocks();
vi.mocked(push.currentState).mockResolvedValue("off");
});
it("выключенные уведомления предлагает включить", async () => {
render(<NotificationsRow />);
await userEvent.click(await screen.findByRole("button", { name: /Включить уведомления/ }));
expect(push.enable).toHaveBeenCalled();
});
it("включённые — строки нет: отказаться от них мы не предлагаем", async () => {
// Отключение остаётся системным (настройки телефона или сайта в браузере) —
// рядом с балансом кнопка «выключить» только подталкивала бы к отказу.
vi.mocked(push.currentState).mockResolvedValue("on");
const { container } = render(<NotificationsRow />);
await vi.waitFor(() => expect(container.textContent).toBe(""));
expect(screen.queryByText(/Выключить/)).not.toBeInTheDocument();
});
it("запрещённые в браузере — объясняем, а не предлагаем кнопку", async () => {
vi.mocked(push.currentState).mockResolvedValue("denied");
render(<NotificationsRow />);
expect(await screen.findByText(/запрещены в настройках браузера/)).toBeInTheDocument();
expect(screen.queryByRole("button")).not.toBeInTheDocument();
});
});
describe("строка всегда сообщает состояние", () => {
it("включено — говорим об этом, но отключить не предлагаем", async () => {
// Отключать уведомления водитель не должен: ими парк сообщает о долгах.
// Но молчащий экран неотличим от сломанного — на этом мы и встали 22.09.2026.
vi.mocked(push.currentState).mockResolvedValue("on");
render(<NotificationsRow />);
expect(await screen.findByText(/Уведомления включены/i)).toBeInTheDocument();
expect(screen.queryByRole("button")).not.toBeInTheDocument();
});
it("браузер не умеет — тоже говорим", async () => {
vi.mocked(push.currentState).mockResolvedValue("unsupported");
render(<NotificationsRow />);
expect(await screen.findByText(/не умеет уведомления/i)).toBeInTheDocument();
});
it("проверка упала — не оставляем пустоту", async () => {
vi.mocked(push.currentState).mockRejectedValue(new Error("сломалось"));
render(<NotificationsRow />);
expect(await screen.findByText(/не умеет уведомления/i)).toBeInTheDocument();
});
});
@@ -0,0 +1,96 @@
import { useEffect, useState } from "react";
import { Bell } from "lucide-react";
import { toast } from "sonner";
import { currentState, enable, errorCode, type PushState } from "@/lib/push";
/**
* Включение уведомлений — одной строкой на главном экране.
*
* Не всплывающим окном на входе: разрешение спрашивается один раз за установку,
* и потраченная впустую попытка закрывает канал навсегда. Здесь водитель жмёт
* сам, увидев, ради чего.
*
* Выключения здесь НЕТ намеренно (решение владельца 19.08.2026). Включённые
* уведомления — это ровно те два события, ради которых приложение и открывают;
* кнопка «выключить» рядом с балансом только предлагает от них отказаться.
* Способ отключить остаётся системный: настройки уведомлений телефона или
* настройки сайта в браузере — там же, где человек управляет всеми остальными
* приложениями.
*/
export function NotificationsRow() {
const [state, setState] = useState<PushState | null>(null);
const [busy, setBusy] = useState(false);
useEffect(() => {
let alive = true;
currentState()
.then((s) => { if (alive) setState(s); })
// Упавшая проверка — тоже состояние. Без этого строка навсегда оставалась
// бы пустой, и экран молча врал бы, что всё в порядке.
.catch(() => { if (alive) setState("unsupported"); });
return () => { alive = false; };
}, []);
// Пока состояние не известно — не мигаем строкой. Все остальные случаи ниже
// имеют текст: экран, который молчит, неотличим от сломанного. Именно на этом
// мы встали 22.09.2026 — уведомления не приходили, а на экране не было ничего.
if (state === null) return null;
// Выключить уведомления водитель не может намеренно: их включает парк, чтобы
// сообщать о долгах и штрафах. Но ЗНАТЬ, включены ли они, он должен.
if (state === "on") {
return (
<p className="text-muted text-xs text-center mt-6 flex items-center justify-center gap-1.5">
<Bell size={15} /> Уведомления включены
</p>
);
}
if (state === "unsupported") {
return (
<p className="text-muted text-xs text-center mt-6">
Этот браузер не умеет уведомления. Откройте приложение с домашнего экрана.
</p>
);
}
async function turnOn() {
setBusy(true);
try {
setState(await enable());
} catch (e) {
// Код в скобках — не украшение: без него причина теряется навсегда, а
// водитель всё равно не разберёт ни одну формулировку. Зато по «AbortError»
// или «sw-timeout» чинится за минуту.
toast.error(`Не удалось включить уведомления (${errorCode(e)})`);
} finally {
setBusy(false);
}
}
if (state === "needs-install") {
return (
<p className="text-muted text-xs text-center mt-6">
Чтобы получать уведомления, добавьте приложение на домашний экран.
</p>
);
}
if (state === "denied") {
return (
<p className="text-muted text-xs text-center mt-6">
Уведомления запрещены в настройках браузера — включить их можно только там.
</p>
);
}
return (
<button
className="flex items-center justify-center gap-1.5 text-muted text-xs mt-6 w-full"
disabled={busy}
onClick={turnOn}
>
<Bell size={15} /> Включить уведомления
</button>
);
}
@@ -0,0 +1,19 @@
interface Props { value: string; options: { value: string; label: string }[]; onChange: (v: string) => void; }
export function Segment({ value, options, onChange }: Props) {
return (
<div className="flex gap-1.5">
{options.map((o) => (
<button
key={o.value}
type="button"
onClick={() => onChange(o.value)}
className={`flex-1 py-2.5 rounded-xl2 text-xs border ${
value === o.value ? "bg-ink text-white border-ink font-bold" : "bg-surface border-line text-muted"
}`}
>
{o.label}
</button>
))}
</div>
);
}
@@ -0,0 +1,52 @@
import { useEffect, type ReactNode } from "react";
/**
* Шторка снизу — выбор, который не уводит с экрана.
*
* Отдельным экраном такой выбор стоит дороже, чем кажется: человек теряет из
* виду то, ради чего пришёл (баланс), и возвращается кнопкой «назад», которой на
* телефоне ещё надо попасть. Здесь выбор происходит поверх экрана, а закрывается
* тапом мимо, кнопкой и клавишей Escape.
*/
export function Sheet({ open, onClose, title, children }: {
open: boolean;
onClose: () => void;
title: string;
children: ReactNode;
}) {
useEffect(() => {
if (!open) return;
const onKey = (e: KeyboardEvent) => { if (e.key === "Escape") onClose(); };
document.addEventListener("keydown", onKey);
// Фон не должен уезжать под шторкой: иначе список категорий листает страницу.
const prev = document.body.style.overflow;
document.body.style.overflow = "hidden";
return () => {
document.removeEventListener("keydown", onKey);
document.body.style.overflow = prev;
};
}, [open, onClose]);
if (!open) return null;
return (
<div className="fixed inset-0 z-50 flex items-end justify-center">
<button
aria-label="Закрыть"
className="absolute inset-0 bg-ink/40"
onClick={onClose}
/>
<div
role="dialog"
aria-modal="true"
aria-label={title}
className="relative w-full max-w-md bg-surface rounded-t-2xl pb-6 pt-2 max-h-[80vh] overflow-y-auto"
>
{/* Полоска-ручка: на телефоне она объясняет, что панель тянется, лучше любой подписи. */}
<div className="mx-auto mb-3 h-1 w-10 rounded-full bg-line" />
<p className="px-5 pb-2 text-sm font-bold">{title}</p>
{children}
</div>
</div>
);
}
@@ -0,0 +1,3 @@
export function Spinner() {
return <span className="inline-block w-3.5 h-3.5 border-2 border-line border-t-ink rounded-full animate-spin" />;
}
@@ -0,0 +1,153 @@
import { useQuery } from "@tanstack/react-query";
import { useNavigate } from "react-router-dom";
import { ChevronRight, Image as ImageIcon } from "lucide-react";
import { getFines, getStatement, type StatementKind } from "@/api/driver";
import { fineStatusText, isOwed } from "@/lib/fineStatus";
import { formatDate, formatMoney } from "@/lib/format";
import { OperationIcon } from "@/components/operationIcon";
import { Spinner } from "@/components/Spinner";
const FILTERS: { key: StatementKind; label: string }[] = [
{ key: "all", label: "Все операции" },
{ key: "charges", label: "Начисления" },
{ key: "payments", label: "Пополнения" },
{ key: "fines", label: "Штрафы" },
];
/**
* Нижняя половина главного экрана: за что списаны деньги.
*
* Три фильтра показывают проводки 1С, а «Штрафы» — сами постановления, а не
* проводки по ним. Разница существенная: штраф, который водитель оплатил сам,
* парк не выставлял, проводки по нему нет, и в выписке он бы не появился вовсе.
* Отдельного экрана штрафов нет намеренно — два списка одного и того же в разных
* местах сбивают с толку.
*/
export function Statement({ from, to, kind, onFrom, onTo, onKind }: {
from: string;
to: string;
kind: StatementKind;
onFrom: (v: string) => void;
onTo: (v: string) => void;
onKind: (k: StatementKind) => void;
}) {
const nav = useNavigate();
const showFines = kind === "fines";
const ops = useQuery({
queryKey: ["statement", from, to, kind],
queryFn: () => getStatement(from, to, kind),
enabled: !showFines,
});
const fines = useQuery({
queryKey: ["fines"],
queryFn: () => getFines("all"),
enabled: showFines,
});
const active = showFines ? fines : ops;
// Период распространяется и на штрафы: иначе календарь над списком стоял бы,
// ничего не меняя, — это хуже, чем его отсутствие.
const fineRows = (fines.data?.items ?? []).filter(
(f) => !f.date || (f.date >= from && f.date <= to),
);
const opRows = ops.data?.items ?? [];
const isEmpty = showFines ? fineRows.length === 0 : opRows.length === 0;
const rowCls = "w-full flex items-center gap-3 py-2.5 border-b border-line last:border-0 text-left";
return (
<div>
<div className="flex items-center gap-2 mb-3">
{/* Нативный date-input: календарь телефона знакомее любого нашего. */}
<input type="date" value={from} max={to} onChange={(e) => onFrom(e.target.value)}
aria-label="Начало периода"
className="card flex-1 px-3 py-2 text-xs bg-surface" />
<span className="text-muted text-xs">—</span>
<input type="date" value={to} min={from} onChange={(e) => onTo(e.target.value)}
aria-label="Конец периода"
className="card flex-1 px-3 py-2 text-xs bg-surface" />
</div>
<div className="flex gap-1.5 mb-3 overflow-x-auto">
{FILTERS.map((f) => (
<button
key={f.key}
onClick={() => onKind(f.key)}
className={`shrink-0 px-3 py-2 rounded-xl2 text-xs border ${
f.key === kind ? "border-ink bg-surface font-semibold" : "border-line text-muted"
}`}
>
{f.label}
</button>
))}
</div>
{active.isLoading ? (
<div className="flex justify-center py-8"><Spinner /></div>
) : active.isError ? (
<div className="text-center py-6">
<p className="text-muted text-sm mb-3">Не удалось загрузить операции</p>
<button className="btn-ghost" onClick={() => active.refetch()}>Повторить</button>
</div>
) : isEmpty ? (
<p className="text-muted text-sm text-center py-8">
{showFines ? "Штрафов за период нет" : "Нет операций за выбранный период"}
</p>
) : showFines ? (
<div>
{fineRows.map((f) => (
// Штраф ведёт в карточку: там фотография с камеры, место и скорость.
<button key={f.id} className={rowCls} onClick={() => nav(`/fines/${f.id}`)}>
<OperationIcon title="Штраф" />
<span className="min-w-0 flex-1">
<span className="flex items-center gap-1.5 text-xs font-semibold">
{formatDate(f.date)}
{f.has_photo && <ImageIcon size={12} strokeWidth={1.5} className="text-muted" />}
</span>
<span className="block text-sm truncate">{f.article}</span>
<span className="block text-muted text-xs">
{fineStatusText(f)}{f.car_number ? ` · ${f.car_number}` : ""}
</span>
</span>
<b className={`shrink-0 ${isOwed(f) ? "text-neg" : "text-muted"}`}>
{formatMoney(f.amount)}
</b>
<ChevronRight size={16} className="text-muted shrink-0" />
</button>
))}
</div>
) : (
<div>
{opRows.map((op, idx) => {
const row = (
<>
<OperationIcon title={op.title} />
<span className="min-w-0 flex-1">
{/* Дата — первой строкой: в выписке ищут «что было 12-го», а не
название операции. */}
<span className="block text-xs font-semibold">{formatDate(op.date)}</span>
<span className="block text-sm">{op.title}</span>
{op.description && (
<span className="block text-muted text-xs truncate">{op.description}</span>
)}
</span>
<b className={`shrink-0 ${op.amount < 0 ? "text-neg" : "text-pos"}`}>
{formatMoney(op.amount)}
</b>
</>
);
return op.fine_id != null ? (
<button key={`${op.date}-${idx}`} className={rowCls}
onClick={() => nav(`/fines/${op.fine_id}`)}>
{row}
<ChevronRight size={16} className="text-muted shrink-0" />
</button>
) : (
<div key={`${op.date}-${idx}`} className={rowCls}>{row}</div>
);
})}
</div>
)}
</div>
);
}
@@ -0,0 +1,25 @@
import { describe, it, expect } from "vitest";
import { operationIcon } from "./operationIcon";
/** Названия — настоящие теги 1С из выписки (finance_ledger_entries.tag). */
describe("значок операции", () => {
it("разные виды операций различаются", () => {
const names = [
"Аренда автомобиля",
"Пени",
"Штраф ГИБДД",
"Пополнение баланса через мобильное приложение",
"ДТП",
"Перевод с депозита на баланс",
].map((t) => operationIcon(t));
expect(new Set(names).size).toBe(names.length);
});
it("штраф ГИБДД и штраф компании — один значок: для водителя это одно и то же", () => {
expect(operationIcon("Штраф ГИБДД")).toBe(operationIcon("Штраф компании"));
});
it("незнакомый тег получает нейтральный значок, а не пустоту", () => {
expect(operationIcon("Списание за что-то новое")).toBeTruthy();
});
});
@@ -0,0 +1,53 @@
import {
Banknote, Car, Flag, Gavel, Gift, HandCoins, Percent, PiggyBank, Receipt,
RefreshCcw, ShieldAlert, TriangleAlert, Wrench, type LucideIcon,
} from "lucide-react";
/**
* Значок операции в выписке — по тегу 1С, а не по знаку суммы.
*
* Список сливается в стену текста: за неделю у активного водителя два десятка
* строк, и половина из них — одинаковая по виду «аренда автомобиля». Значок
* даёт зацепку для глаза, чтобы взгляд находил нужное, не читая каждую строку.
*
* Общий компонент, а не иконка на месте применения: тот же приём, что в складе
* CRM (modules/warehouse/categoryIcons.tsx). Разложены по местам — и размеры с
* толщиной линии разъезжаются при первой же правке.
*
* Монохромные намеренно: цвет в этом списке уже занят и означает направление
* денег (красное — списали, зелёное — пришло). Цветной значок спорил бы с ним.
*/
const BY_TAG: [RegExp, LucideIcon][] = [
[/аренда/i, Car],
[/пени/i, Percent],
[/штраф/i, Gavel],
[/дтп|повреждени/i, TriangleAlert],
[/депозит/i, PiggyBank],
[/пополнение|оплата/i, Banknote],
[/ремонт|запчаст/i, Wrench],
[/компенсац/i, HandCoins],
[/акци|бонус|подар/i, Gift],
[/коррекц|сторно|перерасч/i, RefreshCcw],
[/страхов/i, ShieldAlert],
[/остаток|opening/i, Flag],
];
export function operationIcon(title: string): LucideIcon {
for (const [re, icon] of BY_TAG) {
if (re.test(title)) return icon;
}
return Receipt;
}
/** Значок в рамке — как в списке склада: одинаковый размер у всех строк. */
export function OperationIcon({ title }: { title: string }) {
const Icon = operationIcon(title);
return (
<span
aria-hidden
className="shrink-0 w-8 h-8 rounded-xl2 border border-line bg-canvas flex items-center justify-center text-muted"
>
<Icon size={16} strokeWidth={1.5} />
</span>
);
}
@@ -0,0 +1,43 @@
// src/hooks/usePairPoll.test.tsx
import { renderHook, waitFor } from "@testing-library/react";
import { describe, it, expect, vi, beforeEach } from "vitest";
import { usePairPoll } from "./usePairPoll";
import * as driver from "@/api/driver";
import { useAuth } from "@/store/auth";
beforeEach(() => { useAuth.getState().clear(); vi.restoreAllMocks(); });
describe("usePairPoll", () => {
it("sets session on authenticated", async () => {
vi.spyOn(driver, "tgPoll").mockResolvedValue({ status: "authenticated", token: "T", driver_id: 7 } as any);
const { result } = renderHook(() => usePairPoll("SESS", "SEC"));
await waitFor(() => expect(result.current.status).toBe("authenticated"));
expect(useAuth.getState().token).toBe("T");
expect(useAuth.getState().driverId).toBe(7);
});
it("stays pending then expired", async () => {
vi.spyOn(driver, "tgPoll").mockResolvedValue({ status: "expired" } as any);
const { result } = renderHook(() => usePairPoll("SESS", "SEC"));
await waitFor(() => expect(result.current.status).toBe("expired"));
});
it("does nothing when session is null", () => {
const spy = vi.spyOn(driver, "tgPoll");
const { result } = renderHook(() => usePairPoll(null, "SEC"));
expect(result.current.status).toBe("pending");
expect(spy).not.toHaveBeenCalled();
});
it("does not poll without the secret half of the key", () => {
// pair_session уходит боту в deep-link и оседает в логах; одной его половины
// для получения токена быть недостаточно.
const spy = vi.spyOn(driver, "tgPoll");
const { result } = renderHook(() => usePairPoll("SESS", null));
expect(result.current.status).toBe("pending");
expect(spy).not.toHaveBeenCalled();
});
it("sends both halves to the backend", async () => {
const spy = vi.spyOn(driver, "tgPoll").mockResolvedValue({ status: "expired" } as any);
const { result } = renderHook(() => usePairPoll("SESS", "SEC"));
await waitFor(() => expect(result.current.status).toBe("expired"));
expect(spy).toHaveBeenCalledWith("SESS", "SEC");
});
});
@@ -0,0 +1,49 @@
// src/hooks/usePairPoll.ts
import { useEffect, useRef, useState } from "react";
import { tgPoll } from "@/api/driver";
import { useAuth } from "@/store/auth";
type Status = "pending" | "authenticated" | "expired";
const INTERVAL_MS = 2000;
const TIMEOUT_MS = 5 * 60 * 1000;
/**
* Опрос pairing-сессии. Нужны ОБЕ половины ключа: `pairSession` уходит боту в
* deep-link, `pollSecret` остаётся только здесь — знать одну сессию (например,
* подсмотрев её в access-логе) для получения токена уже недостаточно.
*/
export function usePairPoll(pairSession: string | null,
pollSecret: string | null): { status: Status } {
const [status, setStatus] = useState<Status>("pending");
const setSession = useAuth((s) => s.setSession);
const startedAt = useRef<number>(0);
useEffect(() => {
if (!pairSession || !pollSecret) return;
let alive = true;
let timer: ReturnType<typeof setTimeout>;
startedAt.current = Date.now();
const tick = async () => {
if (!alive) return;
try {
const r = await tgPoll(pairSession, pollSecret);
if (!alive) return;
if (r.status === "authenticated") {
setSession(r.token, r.driver_id);
setStatus("authenticated");
return;
}
if (r.status === "expired") { setStatus("expired"); return; }
} catch {
// transient — keep polling until timeout
}
if (Date.now() - startedAt.current > TIMEOUT_MS) { setStatus("expired"); return; }
timer = setTimeout(tick, INTERVAL_MS);
};
tick();
return () => { alive = false; clearTimeout(timer); };
}, [pairSession, pollSecret, setSession]);
return { status };
}
@@ -0,0 +1,39 @@
import { useEffect, useState } from "react";
import { useQuery } from "@tanstack/react-query";
import { getPaymentState } from "@/api/driver";
// финальные статусы: дальше опрашивать нечего, экран показывает итог —
// оплачено, отказ, истёкший срок или ошибка
const TERMINAL = new Set([
"PAID", "CONFIRMED", "REJECTED", "REVERSED", "REFUNDED",
"PARTIAL_REVERSED", "PARTIAL_REFUNDED",
"CANCELED", "AUTH_FAIL", "DEADLINE_EXPIRED", "ATTEMPTS_EXPIRED", "ERROR",
]);
export function usePaymentStatus(orderId: string) {
const query = useQuery({
queryKey: ["payment", orderId],
queryFn: () => getPaymentState(orderId),
refetchInterval: (q) => (q.state.data && TERMINAL.has(q.state.data.status) ? false : 1500),
// повтором здесь работает сам опрос через 1.5 с, а внутренние ретраи с backoff
// только оттягивают момент, когда сбой станет виден на экране
retry: false,
});
// серию неудач считаем сами: failureCount обнуляется в начале каждого опроса
// и о том, сколько раз подряд не ответил бэкенд, ничего не говорит
const [failStreak, setFailStreak] = useState(0);
useEffect(() => {
if (query.errorUpdatedAt) setFailStreak((n) => n + 1);
}, [query.errorUpdatedAt]);
useEffect(() => {
if (query.dataUpdatedAt) setFailStreak(0);
}, [query.dataUpdatedAt]);
// пока ни одного удачного ответа не было, на время запроса isError снова гаснет
// (react-query возвращает статус в pending) — экран бы моргал ожиданием на каждом опросе.
// отметки времени такого провала не дают и гаснут ровно тогда, когда пришли данные
const lastFailed = query.errorUpdatedAt > query.dataUpdatedAt;
return { ...query, failStreak, lastFailed };
}
+16
View File
@@ -0,0 +1,16 @@
@tailwind base;
@tailwind components;
@tailwind utilities;
html, body, #root { height: 100%; }
body { @apply bg-canvas text-ink font-sans antialiased; margin: 0; }
button { font-family: inherit; }
@layer components {
/* Кнопки повторяют сайт: действие — фирменным красным с белым текстом
(.s-btn--accent), второстепенное — белым с чернильным текстом и рамкой
(.s-btn--ghost). */
.btn-primary { @apply bg-accent text-white rounded-xl2 py-3.5 px-4 text-sm font-bold text-center w-full active:bg-accent-press disabled:opacity-50; }
.btn-ghost { @apply bg-surface border border-line text-ink rounded-xl2 py-3 px-4 text-sm font-semibold text-center w-full active:bg-canvas-soft; }
.card { @apply bg-surface border border-line rounded-2xl; }
}
@@ -0,0 +1,33 @@
import { describe, it, expect } from "vitest";
import { keypadReduce, parseAmount, withCommission } from "./amount";
describe("amount keypad", () => {
it("appends digits, ignores leading zero, caps length", () => {
expect(keypadReduce("0", "5")).toBe("5");
expect(keypadReduce("100", "0")).toBe("1000");
expect(keypadReduce("", "0")).toBe("");
expect(keypadReduce("999999", "9")).toBe("999999");
});
it("backspace removes last digit", () => {
expect(keypadReduce("105", "back")).toBe("10");
expect(keypadReduce("", "back")).toBe("");
});
it("withCommission computes total at given rate", () => {
expect(withCommission(1000, 0.052)).toEqual({ commission: 52, total: 1052 });
expect(withCommission(333, 0.052)).toEqual({ commission: 17.32, total: 350.32 });
});
it("separator key builds kopecks — раньше клавиша была нарисована, но не работала", () => {
expect(keypadReduce("100", ",")).toBe("100,");
expect(keypadReduce("100,", "5")).toBe("100,5");
expect(keypadReduce("100,5", "2")).toBe("100,52");
expect(keypadReduce("100,52", "9")).toBe("100,52"); // копеек ровно две
expect(keypadReduce("100,52", ",")).toBe("100,52"); // второй разделитель не нужен
expect(keypadReduce("", ",")).toBe("0,");
expect(keypadReduce("100,5", "back")).toBe("100,");
});
it("parseAmount reads the keypad string", () => {
expect(parseAmount("100,52")).toBe(100.52);
expect(parseAmount("100,")).toBe(100);
expect(parseAmount("")).toBe(0);
});
});
+40
View File
@@ -0,0 +1,40 @@
const MAX_DIGITS = 6; // целая часть
const SEP = ","; // русский разделитель — как на клавише
/**
* Одно нажатие клавиатуры суммы.
*
* Разделитель раньше был нарисован на клавише, но ничего не делал: `press`
* молча игнорировал его, а `keypadReduce` принимал только цифры. Заплатить
* точный долг вроде 1234,56 было нечем.
*/
export function keypadReduce(current: string, key: string): string {
if (key === "back") return current.slice(0, -1);
if (key === SEP || key === "." || key === "·") {
if (current.includes(SEP)) return current; // второй разделитель не нужен
return current === "" ? "0" + SEP : current + SEP;
}
if (!/^\d$/.test(key)) return current;
const [whole, frac] = current.split(SEP);
if (frac !== undefined) {
if (frac.length >= 2) return current; // копеек ровно две
return `${whole}${SEP}${frac}${key}`;
}
if (current === "0") return key === "0" ? "0" : key; // replace leading zero
if (current === "" && key === "0") return ""; // no leading zero from empty
if (current.length >= MAX_DIGITS) return current;
return current + key;
}
/** Строка с клавиатуры → число рублей. Незавершённое «100,» читается как 100. */
export function parseAmount(raw: string): number {
if (!raw) return 0;
const n = parseFloat(raw.replace(SEP, "."));
return Number.isFinite(n) ? Math.round(n * 100) / 100 : 0;
}
export function withCommission(base: number, rate: number): { commission: number; total: number } {
const commission = Math.round(base * rate * 100) / 100;
const total = Math.round((base + commission) * 100) / 100;
return { commission, total };
}
+124
View File
@@ -0,0 +1,124 @@
import { describe, it, expect, beforeEach } from "vitest";
import { render, screen, waitFor } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { BrowserRouter, Link, MemoryRouter, Route, Routes, useLocation } from "react-router-dom";
import { BackButton } from "@/components/BackButton";
import { BackBar, BackProvider } from "@/components/BackBar";
import { canGoBackInApp, useBackOverride } from "./back";
// Настоящий BrowserRouter поверх истории jsdom: только так виден счётчик idx.
// Родитель экрана /a/b — главная, а позади в истории — /a: по тому, куда
// попали, видно, какой из двух путей сработал.
function Where() {
const loc = useLocation();
return <p data-testid="where">{loc.pathname}</p>;
}
function app() {
return render(
<BrowserRouter>
<Where />
<Routes>
<Route path="/" element={<Link to="/a">в раздел</Link>} />
<Route path="/a" element={<Link to="/a/b">глубже</Link>} />
<Route path="/a/b" element={<BackButton to="/" />} />
</Routes>
</BrowserRouter>
);
}
const idx = () => (window.history.state as { idx?: number } | null)?.idx;
describe("canGoBackInApp", () => {
it("смотрит на счётчик записей BrowserRouter, а не на длину истории", () => {
window.history.replaceState(null, "", "/");
expect(canGoBackInApp()).toBe(false);
window.history.replaceState({ idx: 0 }, "", "/");
expect(canGoBackInApp()).toBe(false);
window.history.replaceState({ idx: 2 }, "", "/");
expect(canGoBackInApp()).toBe(true);
});
});
describe("кнопка «Назад»", () => {
beforeEach(() => window.history.replaceState(null, "", "/"));
it("есть история в приложении — ровно один шаг назад", async () => {
app();
await userEvent.click(screen.getByRole("link", { name: "в раздел" }));
await userEvent.click(screen.getByRole("link", { name: "глубже" }));
expect(idx()).toBe(2);
const len = window.history.length;
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
// popstate в jsdom асинхронный — ждём.
await waitFor(() => expect(screen.getByTestId("where").textContent).toBe("/a"));
expect(window.location.pathname).toBe("/a");
expect(idx()).toBe(1);
expect(window.history.length).toBe(len);
});
it("холодный старт (пуш, ссылка) — на родителя заменой, история не растёт", async () => {
window.history.replaceState(null, "", "/a/b");
app();
expect(idx()).toBe(0);
const len = window.history.length;
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
expect(screen.getByTestId("where").textContent).toBe("/");
expect(window.location.pathname).toBe("/");
expect(idx()).toBe(0);
expect(window.history.length).toBe(len);
});
it("режим parent — на родителя даже при истории позади", async () => {
render(
<BrowserRouter>
<Where />
<Routes>
<Route path="/" element={<Link to="/a">в раздел</Link>} />
<Route path="/a" element={<BackButton to="/b" mode="parent" />} />
<Route path="/b" element={<p>родитель</p>} />
</Routes>
</BrowserRouter>
);
await userEvent.click(screen.getByRole("link", { name: "в раздел" }));
const len = window.history.length;
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
expect(screen.getByText("родитель")).toBeInTheDocument();
expect(idx()).toBe(1);
expect(window.history.length).toBe(len);
});
});
describe("страница перенацеливает «Назад» над экраном", () => {
beforeEach(() => window.history.replaceState(null, "", "/"));
it("цель страницы важнее родителя из таблицы и уходит вместе со страницей", async () => {
// /topup в таблице с родителем «/»; режим внутри страницы ведёт в ленту.
function Mode() {
useBackOverride({ to: "/notifications" });
return <p>режим</p>;
}
render(
<MemoryRouter initialEntries={["/topup"]}>
<BackProvider>
<BackBar />
<Routes>
<Route path="/" element={<p>главная</p>} />
<Route path="/topup" element={<Mode />} />
<Route path="/notifications" element={<p>лента</p>} />
</Routes>
</BackProvider>
</MemoryRouter>
);
// Кнопка по-прежнему одна — страница не рисует вторую.
expect(screen.getAllByRole("button", { name: "Назад" })).toHaveLength(1);
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
expect(screen.getByText("лента")).toBeInTheDocument();
// Страница ушла — с ней и её цель: у ленты снова родитель из таблицы.
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
expect(screen.getByText("главная")).toBeInTheDocument();
});
});
+89
View File
@@ -0,0 +1,89 @@
import { createContext, useCallback, useContext, useLayoutEffect } from "react";
import { useNavigate } from "react-router-dom";
/**
* «Назад» внутри приложения — одно правило на все экраны.
*
* У установленного PWA на iPhone нет системной кнопки «назад», а жест от края
* экрана ненадёжен и после холодного старта (открыли с иконки, из пуша, по
* ссылке) не делает ничего — истории нет. Водитель застревал на экране без
* выхода (задача 6385). Поэтому на каждом экране, кроме главной и входа, есть
* своя кнопка, и ведёт она так: есть куда вернуться в этом запуске — шаг назад
* по истории, нет — на родительский экран С ЗАМЕНОЙ записи.
*/
/** Есть ли позади в истории экран ЭТОГО запуска приложения.
*
* `idx` — собственный счётчик записей BrowserRouter: 0 — первая запись запуска
* (холодный старт, открытие из пуша, внешняя ссылка), push его увеличивает,
* replace сохраняет. `location.key !== "default"` не годится — после replace
* ключ новый, а позади пусто; `history.length` считает и чужие записи до
* приложения. MemoryRouter window.history не трогает, поэтому в таких тестах
* здесь всегда false — это путь холодного старта. */
export function canGoBackInApp(): boolean {
const idx = (window.history.state as { idx?: unknown } | null)?.idx;
return typeof idx === "number" && idx > 0;
}
/** "history" — шаг назад, если есть куда (по умолчанию); "parent" — всегда на
* родителя: для экранов, где запись позади заведомо не та. */
export type BackMode = "history" | "parent";
/** Обработчик «Назад»; `parent` — куда идти, если позади ничего нет.
*
* Родителя только заменяем, никогда не пушим: запись поверх истории зацикливает
* системный «назад» Android — он возвращал бы на экран, с которого ушли. */
export function useBack(parent: string, opts?: { mode?: BackMode }): () => void {
const nav = useNavigate();
const mode = opts?.mode ?? "history";
return useCallback(() => {
if (mode === "history" && canGoBackInApp()) nav(-1);
else nav(parent, { replace: true });
}, [nav, parent, mode]);
}
/** Куда ведёт «Назад» и каким способом. */
export interface BackTarget {
to: string;
mode?: BackMode;
}
interface BackState {
/** Родитель текущего экрана из таблицы маршрутов; null — главная и вход. */
parent: BackTarget | null;
/** Цель, которую задала сама страница (useBackOverride), — важнее родителя. */
override: BackTarget | null;
setOverride: (t: BackTarget | null) => void;
}
/** Кладёт BackProvider в App: он знает таблицу маршрутов, страницы — нет (иначе
* таблица, импортирующая страницы, импортировалась бы ими же по кругу). */
export const BackContext = createContext<BackState>({
parent: null,
override: null,
setOverride: () => undefined,
});
/** Уйти с экрана к родителю из таблицы — для кнопок внутри страницы вроде
* «Другой способ входа»: свой адрес родителя страница не повторяет, иначе он
* разъезжается с кнопкой «Назад» над экраном. Вне App (тесты страниц) — на главную. */
export function useRouteBack(): () => void {
const { parent } = useContext(BackContext);
return useBack(parent?.to ?? "/", { mode: parent?.mode });
}
/** Перенацелить кнопку «Назад» над экраном: для режима внутри страницы со своим
* адресом или когда родителя знает только она (например, узнав id записи).
* Второй кнопки «Назад» страница не рисует. null — цель из таблицы. Действует
* только на экранах с родителем: у главной и входа верхней кнопки нет. */
export function useBackOverride(target: BackTarget | null): void {
const { setOverride } = useContext(BackContext);
const to = target?.to;
const mode = target?.mode;
// До отрисовки кадра: иначе мелькнула бы кнопка со старой целью.
useLayoutEffect(() => {
if (to === undefined) return;
setOverride({ to, mode });
return () => setOverride(null);
}, [setOverride, to, mode]);
}
+30
View File
@@ -0,0 +1,30 @@
import type { FineBrief } from "@/api/driver";
/**
* Что написать водителю о штрафе.
*
* Ключевое различие, которое интерфейс обязан удерживать: постановление в ГИБДД
* гасит ПАРК, обычно авансом и со скидкой, — и с этого момента штраф закрыт для
* государства, но не для водителя. Водитель возвращает деньги парку, и это видно
* только по балансу «Долг по штрафам». Поэтому слово «оплачен» здесь не
* используется вовсе: оно означало бы для человека «я ничего не должен».
*/
export function fineStatusText(f: Pick<FineBrief, "settled">): string {
switch (f.settled) {
case "owed":
return "не погашен";
case "paid":
return "погашен";
case "not_charged":
return "не выставлялся";
case "cancelled":
return "отменён";
default:
return "уточняется";
}
}
/** Долг именно этого штрафа перед парком — по нему красим сумму. */
export function isOwed(f: Pick<FineBrief, "settled">): boolean {
return f.settled === "owed";
}
@@ -0,0 +1,50 @@
import { describe, it, expect } from "vitest";
import { formatMoney, formatPhone, digitsOnly, nationalDigits, formatNational } from "./format";
describe("format", () => {
it("formatMoney groups thousands and adds ₽", () => {
expect(formatMoney(1000)).toBe("1 000 ₽");
expect(formatMoney(-3200)).toBe("−3 200 ₽");
expect(formatMoney(0)).toBe("0 ₽");
});
it("formatMoney keeps kopecks — раньше Math.round() показывал не ту сумму, что спишет банк", () => {
expect(formatMoney(350.32)).toBe("350,32 ₽");
expect(formatMoney(1052)).toBe("1 052 ₽");
expect(formatMoney(10.5)).toBe("10,50 ₽");
expect(formatMoney(-350.32)).toBe("−350,32 ₽");
});
it("digitsOnly strips non-digits", () => {
expect(digitsOnly("+7 (914) 305-44-00")).toBe("79143054400");
});
it("formatPhone renders +7 mask progressively", () => {
expect(formatPhone("9143054400")).toBe("+7 914 305-44-00");
expect(formatPhone("914305")).toBe("+7 914 305");
});
});
describe("ввод номера телефона", () => {
it("код страны срезается, как бы его ни набрали", () => {
// Раньше срезалась только семёрка, а «8» уезжала в номер — и водитель
// получал «номер не найден» на собственном телефоне.
expect(nationalDigits("89025061090")).toBe("9025061090");
expect(nationalDigits("+7 902 506-10-90")).toBe("9025061090");
expect(nationalDigits("79025061090")).toBe("9025061090");
expect(nationalDigits("9025061090")).toBe("9025061090");
expect(nationalDigits("8 (902) 506-10-90")).toBe("9025061090");
});
it("набор с восьмёрки исправляет сам себя на одиннадцатой цифре", () => {
expect(nationalDigits("8902506109")).toBe("8902506109"); // ещё 10 цифр
expect(nationalDigits("89025061090")).toBe("9025061090"); // стало 11 — код страны
});
it("лишние цифры отбрасываются, а не сдвигают номер", () => {
expect(nationalDigits("902506109012345")).toBe("9025061090");
});
it("маска рисуется без кода страны — его показывает само поле", () => {
expect(formatNational("9143054400")).toBe("914 305-44-00");
expect(formatNational("914305")).toBe("914 305");
expect(formatNational("")).toBe("");
});
});
+80
View File
@@ -0,0 +1,80 @@
export function digitsOnly(s: string): string {
return (s || "").replace(/\D/g, "");
}
/**
* Деньги для показа. Копейки печатаем ТОЛЬКО когда они есть.
*
* Раньше здесь было Math.round(), и водителю показывали одну сумму, а банк
* списывал другую: комиссия 5.2% почти всегда даёт копейки (1000 → 1052,00, но
* 333 → 350,32), и «к оплате 350 ₽» расходилось и со списанием, и с чеком.
*/
export function formatMoney(rub: number): string {
const neg = rub < 0;
const abs = Math.abs(rub);
const kop = Math.round(abs * 100);
const whole = Math.floor(kop / 100);
const rest = kop % 100;
const grouped = whole.toString().replace(/\B(?=(\d{3})+(?!\d))/g, " ");
const tail = rest ? `,${rest.toString().padStart(2, "0")}` : "";
return `${neg ? "−" : ""}${grouped}${tail} ₽`;
}
/**
* Национальные 10 цифр из чего угодно: «8 914 305-44-00», «+7 914…», «914…».
*
* Код страны человек набирает как хочет — и «8», и «+7», и никак. Раньше поле
* ввода срезало только ведущую семёрку, а восьмёрку считало частью номера: набор
* с «8» давал +7 890 250-61-09 вместо +7 902 506-10-90, и вход отвечал «номер не
* найден». Отсюда правило: одиннадцатая цифра при ведущей 7 или 8 — это код
* страны, а не номер. Срабатывает ровно в тот момент, когда цифр становится 11,
* поэтому набор с «8» сам себя исправляет на последней цифре.
*
* Российские мобильные национальные номера начинаются с 9, так что отбросить
* ведущую 8 у 11-значного безопасно.
*/
export function nationalDigits(input: string): string {
const d = digitsOnly(input);
const body = d.length > 10 && (d[0] === "7" || d[0] === "8") ? d.slice(1) : d;
return body.slice(0, 10);
}
/** 10 национальных цифр как 914 305-44-00 — БЕЗ кода страны: его рисует поле. */
export function formatNational(national10: string): string {
const d = digitsOnly(national10).slice(0, 10);
const p: string[] = [];
if (d.length > 0) p.push(d.slice(0, 3));
if (d.length > 3) p.push(" " + d.slice(3, 6));
if (d.length > 6) p.push("-" + d.slice(6, 8));
if (d.length > 8) p.push("-" + d.slice(8, 10));
return p.join("");
}
/** Render a Russian mobile from up-to-10 national digits as +7 914 305-44-00. */
export function formatPhone(national10: string): string {
const d = digitsOnly(national10).slice(0, 10);
const p: string[] = ["+7"];
if (d.length > 0) p.push(" " + d.slice(0, 3));
if (d.length > 3) p.push(" " + d.slice(3, 6));
if (d.length > 6) p.push("-" + d.slice(6, 8));
if (d.length > 8) p.push("-" + d.slice(8, 10));
return p.join("");
}
/** Дата человеку — ДД.ММ.ГГГГ. На проводе и в <input type="date"> остаётся ISO. */
export function formatDate(iso: string | null): string {
if (!iso) return "";
const [y, m, d] = iso.split("-");
return y && m && d ? `${d}.${m}.${y}` : iso;
}
/** ISO-дата на N дней назад от сегодня — для периода выписки по умолчанию. */
export function isoDaysAgo(days: number): string {
const d = new Date();
d.setDate(d.getDate() - days);
return d.toISOString().slice(0, 10);
}
export function isoToday(): string {
return new Date().toISOString().slice(0, 10);
}
+80
View File
@@ -0,0 +1,80 @@
/**
* Установка приложения на домашний экран.
*
* Зачем вообще уговаривать: без установки приложение остаётся вкладкой. На iOS
* push-уведомления в таком виде НЕ работают вовсе — Apple разрешает их только
* приложению с домашнего экрана. А уведомления здесь не украшение: ими парк
* сообщает о штрафах и о том, что платёж дошёл.
*
* Главная тонкость — момент. Chrome стреляет `beforeinstallprompt` один раз, и
* обычно ДО того, как React успеет смонтироваться. Слушатель поэтому вешается
* при импорте модуля (из `main.tsx`), а не в компоненте: подписавшись позже,
* событие уже не поймать, и кнопка установки не появится никогда.
*
* Само событие надо погасить `preventDefault`, иначе Chrome покажет свою плашку
* внизу экрана — поверх нашей, про то же самое.
*/
import { installed } from "./push";
interface InstallPromptEvent extends Event {
prompt: () => Promise<void>;
userChoice: Promise<{ outcome: "accepted" | "dismissed" }>;
}
let deferred: InstallPromptEvent | null = null;
const listeners = new Set<() => void>();
function notify() {
listeners.forEach((l) => l());
}
if (typeof window !== "undefined") {
window.addEventListener("beforeinstallprompt", (e) => {
e.preventDefault();
deferred = e as InstallPromptEvent;
notify();
});
// Установили — предложение больше не нужно, убираем его сразу, не дожидаясь
// перезапуска: приложение в этот момент ещё открыто как вкладка.
window.addEventListener("appinstalled", () => {
deferred = null;
notify();
});
}
/** Подписка для useSyncExternalStore. */
export function subscribe(listener: () => void): () => void {
listeners.add(listener);
return () => listeners.delete(listener);
}
/** Есть ли у браузера штатное предложение установки (Chrome, Edge, Samsung). */
export function canPrompt(): boolean {
return deferred !== null;
}
/** iOS: установка есть, но только руками через «Поделиться». */
export function isIos(): boolean {
return /iPad|iPhone|iPod/.test(navigator.userAgent);
}
/** Нужно ли вообще что-то предлагать. Установленному — нет. */
export function shouldOffer(): boolean {
return !installed();
}
/** Показать штатное окно установки. Возвращает, согласился ли человек.
*
* Событие одноразовое: после показа Chrome второй раз его не отдаёт, поэтому
* ссылку сбрасываем независимо от ответа. Отказался — предложение исчезает до
* следующего запуска, и это правильно: уговаривать дважды за сеанс незачем.
*/
export async function promptInstall(): Promise<boolean> {
const event = deferred;
if (!event) return false;
deferred = null;
notify();
await event.prompt();
const { outcome } = await event.userChoice;
return outcome === "accepted";
}
+40
View File
@@ -0,0 +1,40 @@
/**
* Чтение полезной нагрузки JWT без проверки подписи — для экрана отладки.
*
* Проверять подпись здесь нечем и не нужно: решение о доступе принимает бэкенд,
* а приложению эти поля нужны ровно для того, чтобы показать человеку, чем он
* сейчас держится — до какого времени живёт токен и чей это сеанс.
*/
export interface TokenInfo {
sub: string | null;
exp: number | null;
impersonated: boolean;
}
export function readToken(token: string | null): TokenInfo | null {
if (!token) return null;
const part = token.split(".")[1];
if (!part) return null;
try {
const json = atob(part.replace(/-/g, "+").replace(/_/g, "/"));
const claims = JSON.parse(json) as Record<string, unknown>;
return {
sub: typeof claims.sub === "string" ? claims.sub : null,
exp: typeof claims.exp === "number" ? claims.exp : null,
impersonated: claims.imp === true,
};
} catch {
return null;
}
}
/** «через 7 ч 20 мин» / «истёк» — человеку, а не в секундах. */
export function expiresIn(exp: number | null): string {
if (exp == null) return "—";
const left = exp * 1000 - Date.now();
if (left <= 0) return "истёк";
const h = Math.floor(left / 3_600_000);
const m = Math.floor((left % 3_600_000) / 60_000);
if (h >= 24) return `через ${Math.floor(h / 24)} дн ${h % 24} ч`;
return h > 0 ? `через ${h} ч ${m} мин` : `через ${m} мин`;
}
+45
View File
@@ -0,0 +1,45 @@
/**
* Pairing-сессия входа через Telegram, пока приложение ждёт бота.
*
* Держим в sessionStorage: экран ожидания переживает уход в Telegram и возврат,
* но сессия не должна пережить закрытие вкладки — это половина ключа к JWT.
* Раньше ключи раскладывались по три штуки в каждом экране; теперь одно место,
* чтобы `poll_secret` нельзя было забыть положить или забыть стереть.
*/
const K_SESSION = "pp-pair-session";
const K_SECRET = "pp-pair-secret";
const K_CONFIRM = "pp-pair-confirm";
const K_LINK = "pp-pair-deeplink";
export interface Pairing {
pairSession: string;
pollSecret: string;
confirmCode: string;
deepLink: string | null;
}
export function savePairing(p: {
pair_session: string; poll_secret: string; confirm_code: string; deep_link?: string | null;
}): void {
sessionStorage.setItem(K_SESSION, p.pair_session);
sessionStorage.setItem(K_SECRET, p.poll_secret);
sessionStorage.setItem(K_CONFIRM, p.confirm_code);
if (p.deep_link) sessionStorage.setItem(K_LINK, p.deep_link);
else sessionStorage.removeItem(K_LINK);
}
export function loadPairing(): Pairing | null {
const pairSession = sessionStorage.getItem(K_SESSION);
const pollSecret = sessionStorage.getItem(K_SECRET);
if (!pairSession || !pollSecret) return null;
return {
pairSession,
pollSecret,
confirmCode: sessionStorage.getItem(K_CONFIRM) ?? "",
deepLink: sessionStorage.getItem(K_LINK),
};
}
export function clearPairing(): void {
[K_SESSION, K_SECRET, K_CONFIRM, K_LINK].forEach((k) => sessionStorage.removeItem(k));
}
@@ -0,0 +1,51 @@
/**
* Отметка «водитель только что платил» — общая для экранов пополнения и баланса.
*
* Зачем она нужна, если экран баланса и так опрашивает себя, пока висит
* «Зачисляется» (pending_topup > 0). У опроса по одному этому признаку два
* слепых пятна, и оба приходятся ровно на сбойные сценарии:
*
* 1. Водитель ушёл с экрана оплаты жестом «назад» ДО прихода вебхука банка
* (СБП подтверждается и через 10–60 секунд). Баланс на тот момент отвечает
* pending_topup=0 — опрос не взводится, и когда вебхук наконец ставит PAID,
* перезапросить баланс уже некому: экран оплаты размонтирован вместе со
* своим опросом. Старый итог висит без строки «Зачисляется» бессрочно.
*
* 2. «Зачисляется» гаснет в момент записи платежа в 1С, и в норме итог в том же
* ответе уже новый. Но точечное обновление снимка — не гарантия (1С может
* не ответить, тогда снимок догонит общий синк за ≤2 минуты): опрос,
* выключившийся по pending_topup=0, этот догон уже не увидит — деньги
* «пропадают» с экрана до смены фокуса.
*
* Поэтому платёжная активность (создание платежа, факт оплаты) оставляет
* отметку, и баланс продолжает опрашиваться ещё WATCH_MS после неё — окно с
* запасом накрывает и лаг вебхука, и полный цикл общего синка.
*
* sessionStorage, а не переменная модуля: PWA на телефоне перезагружает
* страницу охотно (нехватка памяти, возврат из банковского приложения), и
* отметка в памяти не пережила бы ровно тот переход, ради которого заведена.
*/
const KEY = "pp-payment-activity-at";
/** Окно опроса после платёжной активности: лаг вебхука (до минуты) + запись в
* 1С (≤15 с) + общий синк снимка (≤2 мин) — с запасом. */
export const WATCH_MS = 5 * 60_000;
export function markPaymentActivity(): void {
try {
sessionStorage.setItem(KEY, String(Date.now()));
} catch {
// Приватный режим или отключённое хранилище: без отметки остаётся опрос по
// «Зачисляется» — деградация до прежнего поведения, а не поломка.
}
}
export function paymentActivityWithin(ms: number = WATCH_MS): boolean {
try {
const t = Number(sessionStorage.getItem(KEY) || 0);
return t > 0 && Date.now() - t < ms;
} catch {
return false;
}
}
+158
View File
@@ -0,0 +1,158 @@
import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
vi.mock("@/api/driver", () => ({
getPushKey: vi.fn(async () => ({ key: "BIIh_RELLY", enabled: true })),
subscribePush: vi.fn(async () => ({ ok: true })),
unsubscribePush: vi.fn(async () => ({ ok: true })),
}));
import { currentState, enable, errorCode, supported, syncSubscription } from "./push";
import * as api from "@/api/driver";
const SUB = {
endpoint: "https://fcm.googleapis.com/fcm/send/abc",
toJSON: () => ({
endpoint: "https://fcm.googleapis.com/fcm/send/abc",
keys: { p256dh: "p256", auth: "auth" },
}),
unsubscribe: vi.fn(async () => true),
};
function stubBrowser(opts: {
permission?: NotificationPermission;
existing?: unknown;
ios?: boolean;
standalone?: boolean;
} = {}) {
const perm = opts.permission ?? "default";
const registration = {
pushManager: {
getSubscription: vi.fn(async () => opts.existing ?? null),
subscribe: vi.fn(async () => SUB),
},
};
vi.stubGlobal("navigator", {
serviceWorker: {
getRegistration: vi.fn(async () => registration),
ready: Promise.resolve(registration),
},
userAgent: opts.ios ? "iPhone" : "Android Chrome",
standalone: opts.standalone,
});
const notification = {
permission: perm,
requestPermission: vi.fn(async () => (opts.permission === "denied" ? "denied" : "granted")),
};
// Notification обязан лежать И в window: supported() проверяет именно его —
// так же, как это делает браузер.
vi.stubGlobal("window", {
PushManager: function () {},
Notification: notification,
matchMedia: () => ({ matches: !!opts.standalone }),
});
vi.stubGlobal("Notification", notification);
return registration;
}
describe("уведомления в приложении", () => {
beforeEach(() => vi.clearAllMocks());
afterEach(() => vi.unstubAllGlobals());
it("iPhone без установки на экран: объясняем, а не молчим", async () => {
vi.stubGlobal("navigator", { userAgent: "iPhone", standalone: false });
vi.stubGlobal("window", { matchMedia: () => ({ matches: false }) });
expect(supported()).toBe(false);
expect(await currentState()).toBe("needs-install");
});
it("разрешение отклонено — переспросить нечем", async () => {
stubBrowser({ permission: "denied" });
expect(await currentState()).toBe("denied");
});
it("подписка уходит на сервер с ключами из браузера", async () => {
stubBrowser();
expect(await enable()).toBe("on");
expect(api.subscribePush).toHaveBeenCalledWith({
endpoint: "https://fcm.googleapis.com/fcm/send/abc",
p256dh: "p256",
auth: "auth",
});
});
it("сервер не настроен — разрешение НЕ спрашиваем", async () => {
// Единственная попытка на установку: потратить её впустую нельзя.
vi.mocked(api.getPushKey).mockResolvedValueOnce({ key: "", enabled: false });
stubBrowser();
expect(await enable()).toBe("off");
expect(Notification.requestPermission).not.toHaveBeenCalled();
expect(api.subscribePush).not.toHaveBeenCalled();
});
});
describe("диагностика включения", () => {
it("зависший service worker не вешает кнопку навсегда", async () => {
// `navigator.serviceWorker.ready` при незарегистрированном воркере не
// резолвится НИКОГДА. Без сторожа включение зависало молча: кнопка крутилась,
// тоста не было, на сервере — тишина. Ровно так это и выглядело 22.09.2026.
vi.useFakeTimers();
vi.mocked(api.getPushKey).mockResolvedValue({ key: "BIIh", enabled: true });
// `supported()` смотрит и на PushManager — без него код уйдёт в "unsupported"
// и до сторожа не дойдёт вовсе.
vi.stubGlobal("PushManager", class {});
vi.stubGlobal("Notification", {
permission: "granted",
requestPermission: vi.fn(async () => "granted"),
});
vi.stubGlobal("navigator", {
serviceWorker: { ready: new Promise(() => {}), getRegistration: vi.fn() },
});
const p = expect(enable()).rejects.toThrow(/service worker/i);
await vi.advanceTimersByTimeAsync(11_000);
await p;
vi.unstubAllGlobals();
vi.useRealTimers();
});
it("код ошибки достаётся из чего угодно", () => {
expect(errorCode(new DOMException("x", "AbortError"))).toBe("AbortError");
expect(errorCode(new Error("просто"))).toBe("неизвестно");
expect(errorCode(null)).toBe("неизвестно");
});
});
describe("подписка не должна расходиться с сервером", () => {
function withSubscription(sub: unknown) {
vi.stubGlobal("PushManager", class {});
vi.stubGlobal("Notification", { permission: "granted", requestPermission: vi.fn(async () => "granted") });
vi.stubGlobal("navigator", {
serviceWorker: {
getRegistration: vi.fn(async () => ({ pushManager: { getSubscription: vi.fn(async () => sub) } })),
},
});
}
it("подписку из браузера отдаём серверу заново", async () => {
// Тупик 22.09.2026: на одном телефоне вошли двумя водителями. Подписка в
// браузере осталась, приложение решило «включено» и спрятало кнопку, а на
// сервере записи для текущего водителя не было — уведомления молча не шли.
withSubscription({
endpoint: "https://fcm.googleapis.com/fcm/send/abc",
toJSON: () => ({ endpoint: "https://fcm.googleapis.com/fcm/send/abc",
keys: { p256dh: "P", auth: "A" } }),
});
expect(await syncSubscription()).toBe(true);
expect(api.subscribePush).toHaveBeenCalledWith({
endpoint: "https://fcm.googleapis.com/fcm/send/abc", p256dh: "P", auth: "A",
});
vi.unstubAllGlobals();
});
it("подписки нет — серверу не звоним", async () => {
vi.mocked(api.subscribePush).mockClear();
withSubscription(null);
expect(await syncSubscription()).toBe(false);
expect(api.subscribePush).not.toHaveBeenCalled();
vi.unstubAllGlobals();
});
});
+170
View File
@@ -0,0 +1,170 @@
import { getPushKey, subscribePush, unsubscribePush } from "@/api/driver";
/**
* Включение уведомлений в приложении.
*
* Главное правило экрана вокруг этого кода: разрешение спрашивается ОДИН раз за
* всю жизнь установки. Отказ браузер запоминает, переспросить нельзя — только
* руками в настройках сайта, куда водитель не пойдёт. Поэтому запрос идёт
* строго по нажатию и только когда сервер подтвердил, что уведомления настроены.
*/
export type PushState =
| "unsupported" // браузер не умеет (или iOS без установки на домашний экран)
| "needs-install" // iOS: умеет, но только когда приложение добавлено на экран
| "denied" // разрешение отклонено — переспросить нечем
| "off" // можно включить
| "on"; // подписка есть
/** Приложение открыто как установленное (с домашнего экрана), а не вкладкой. */
export function installed(): boolean {
return isStandalone();
}
function isStandalone(): boolean {
// matchMedia есть не везде: его нет в jsdom и в части WebView, а падение здесь
// роняло бы весь экран входа из-за необязательной подсказки про установку.
const standaloneByMedia =
typeof window.matchMedia === "function" &&
window.matchMedia("(display-mode: standalone)").matches;
return standaloneByMedia ||
// iOS до 17 не поддерживает display-mode: standalone в matchMedia
(navigator as { standalone?: boolean }).standalone === true;
}
function isIos(): boolean {
return /iPad|iPhone|iPod/.test(navigator.userAgent);
}
export function supported(): boolean {
return "serviceWorker" in navigator && "PushManager" in window && "Notification" in window;
}
export async function currentState(): Promise<PushState> {
if (!supported()) return isIos() && !isStandalone() ? "needs-install" : "unsupported";
if (Notification.permission === "denied") return "denied";
const reg = await navigator.serviceWorker.getRegistration();
const sub = await reg?.pushManager.getSubscription();
return sub ? "on" : "off";
}
/** base64url → байты: ключ VAPID браузер принимает только так.
* Возвращаем ArrayBuffer, а не Uint8Array: типы DOM ждут BufferSource. */
function keyToBytes(base64: string): ArrayBuffer {
const padded = base64.replace(/-/g, "+").replace(/_/g, "/") +
"=".repeat((4 - (base64.length % 4)) % 4);
const raw = atob(padded);
const bytes = new Uint8Array(raw.length);
for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i);
return bytes.buffer;
}
/** Сколько ждём готовности service worker'а, прежде чем признать, что его нет.
*
* `navigator.serviceWorker.ready` — промис, который при незарегистрированном или
* не взявшем управление воркере не резолвится НИКОГДА. Без ограничения включение
* уведомлений просто зависало: кнопка крутилась до закрытия приложения, тоста не
* было, в журнале сервера — тишина. Именно так это и выглядело 22.09.2026:
* приложение забрало ключ VAPID и на этом замолчало. */
const SW_READY_TIMEOUT_MS = 10_000;
class PushError extends Error {
constructor(public readonly code: string, message: string) {
super(message);
this.name = "PushError";
}
}
async function swReady(): Promise<ServiceWorkerRegistration> {
let timer: ReturnType<typeof setTimeout>;
const timeout = new Promise<never>((_, reject) => {
timer = setTimeout(
() => reject(new PushError("sw-timeout", "service worker не готов")),
SW_READY_TIMEOUT_MS);
});
try {
return await Promise.race([navigator.serviceWorker.ready, timeout]);
} finally {
clearTimeout(timer!);
}
}
/** Короткий код случившегося — его показываем в тосте и по нему чинят.
* Универсальный текст без кода уже стоил нам вечера догадок. */
export function errorCode(e: unknown): string {
if (e instanceof PushError) return e.code;
const name = (e as { name?: string })?.name;
return name && name !== "Error" ? name : "неизвестно";
}
/** Отдать серверу подписку, которая уже есть в браузере. True — отдали.
*
* Зачем это нужно отдельно от `enable`. Подписка живёт в браузере и переживает
* и выход, и смену водителя, а `currentState` считает уведомления включёнными
* ровно по её наличию — про сервер он не спрашивает. Отсюда тупик, в который мы
* попали 22.09.2026: на одном телефоне вошли сначала одним водителем, потом
* другим; подписка в браузере осталась, приложение решило «включено» и спрятало
* кнопку, а на сервере записи для текущего водителя нет. Кнопки «выключить» у
* нас нет намеренно, так что выйти из этого состояния было нечем — уведомления
* просто молча не приходили.
*
* Хуже того, без этого вызова подписка на сервере осталась бы привязанной к
* ПРЕЖНЕМУ водителю, и его уведомления о деньгах прилетали бы на телефон,
* которым пользуется уже другой человек.
*
* Эндпоинт переписывает подписку по endpoint на текущего водителя, поэтому
* вызов идемпотентен: звать можно при каждом открытии.
*/
export async function syncSubscription(): Promise<boolean> {
if (!supported()) return false;
const reg = await navigator.serviceWorker.getRegistration();
const sub = await reg?.pushManager.getSubscription();
if (!sub) return false;
const json = sub.toJSON() as { endpoint?: string; keys?: { p256dh?: string; auth?: string } };
await subscribePush({
endpoint: json.endpoint ?? sub.endpoint,
p256dh: json.keys?.p256dh ?? "",
auth: json.keys?.auth ?? "",
});
return true;
}
/** Включить уведомления. Возвращает новое состояние. */
export async function enable(): Promise<PushState> {
if (!supported()) return currentState();
const { key, enabled } = await getPushKey();
// Ключа нет — сервер уведомления не отправляет. Разрешение не спрашиваем:
// потратить единственную попытку впустую нельзя.
if (!enabled || !key) return "off";
const permission = await Notification.requestPermission();
if (permission !== "granted") return permission === "denied" ? "denied" : "off";
const reg = await swReady();
// Подписка могла остаться с прошлого раза. Повторный `subscribe` с другим
// ключом бросает InvalidStateError, а с тем же — вернёт эту же подписку;
// переиспользовать её и дешевле, и надёжнее.
const sub = (await reg.pushManager.getSubscription()) ?? await reg.pushManager.subscribe({
userVisibleOnly: true,
applicationServerKey: keyToBytes(key),
});
const json = sub.toJSON() as { endpoint?: string; keys?: { p256dh?: string; auth?: string } };
await subscribePush({
endpoint: json.endpoint ?? sub.endpoint,
p256dh: json.keys?.p256dh ?? "",
auth: json.keys?.auth ?? "",
});
return "on";
}
/** Выключить: снимаем подписку и в браузере, и на сервере. */
export async function disable(): Promise<PushState> {
const reg = await navigator.serviceWorker.getRegistration();
const sub = await reg?.pushManager.getSubscription();
if (sub) {
// Сначала сервер: не сумеем достучаться — подписка останется живой, и
// уведомления продолжат приходить, а это лучше «выключил, а они идут».
await unsubscribePush(sub.endpoint);
await sub.unsubscribe();
}
return "off";
}
@@ -0,0 +1,28 @@
import { describe, it, expect, beforeEach } from "vitest";
import { clearLog, getLog, pushEntry, shortPath, subscribe } from "./reqlog";
describe("журнал запросов", () => {
beforeEach(() => clearLog());
it("новые записи сверху, старые вытесняются", () => {
for (let i = 0; i < 45; i++) pushEntry({ method: "GET", path: `/api/${i}`, status: 200, ms: 1 });
const log = getLog();
expect(log.length).toBe(40);
expect(log[0].path).toBe("/api/44");
});
it("подписчик узнаёт о записи — на этом держится экран отладки", () => {
let calls = 0;
const off = subscribe(() => { calls += 1; });
pushEntry({ method: "GET", path: "/api/x", status: 200, ms: 1 });
expect(calls).toBe(1);
off();
pushEntry({ method: "GET", path: "/api/y", status: 200, ms: 1 });
expect(calls).toBe(1);
});
it("query отбрасывается: в нём ездят идентификаторы", () => {
expect(shortPath("https://crm.pptaxi.ru/api/driver/payment/x?token=secret"))
.toBe("/api/driver/payment/x");
});
});
+55
View File
@@ -0,0 +1,55 @@
/**
* Кольцевой журнал запросов приложения — для вкладки «Отладка».
*
* Зачем он, если есть DevTools: приложение живёт на телефоне, и половина
* интересных случаев (протухший токен, отвалившийся Wi-Fi, 429 от лимита) видна
* только там, где DevTools нет. Журнал даёт те же четыре факта — метод, путь,
* статус, длительность — прямо на экране.
*
* Живёт в памяти и умирает вместе с вкладкой: это отладочный след, а не история.
* В нём НЕТ ни тел запросов, ни заголовков — токен водителя в отладочный экран
* попасть не должен.
*/
export interface ReqEntry {
id: number;
method: string;
path: string;
status: number | null;
ms: number;
at: number;
}
const LIMIT = 40;
let seq = 0;
let entries: ReqEntry[] = [];
const listeners = new Set<() => void>();
export function pushEntry(e: Omit<ReqEntry, "id" | "at">): void {
seq += 1;
entries = [{ ...e, id: seq, at: Date.now() }, ...entries].slice(0, LIMIT);
listeners.forEach((l) => l());
}
export function clearLog(): void {
entries = [];
listeners.forEach((l) => l());
}
/** Снимок для useSyncExternalStore: ссылка меняется только при новой записи. */
export function getLog(): ReqEntry[] {
return entries;
}
export function subscribe(listener: () => void): () => void {
listeners.add(listener);
return () => listeners.delete(listener);
}
/** Путь без origin и без query: в query ездят идентификаторы, а экран публичный. */
export function shortPath(url: string): string {
try {
return new URL(url).pathname;
} catch {
return url.split("?")[0];
}
}
+32
View File
@@ -0,0 +1,32 @@
/**
* Куда вернуть водителя после входа.
*
* Ссылки на оплату (`/pay/:id`) открываются под RequireAuth: незалогиненного
* бросает на /login. Раньше после входа он попадал на баланс, а не на оплату,
* ради которой пришёл. Запоминаем нужный путь тут (переживает переход через
* /tg-wait и онбординг), после любого успешного входа — забираем и очищаем.
*/
const KEY = "pp-return-to";
/** Путь для сохранения — только внутренние маршруты приложения. */
export function setReturnTo(path: string | null | undefined): void {
try {
if (path && path.startsWith("/") && !path.startsWith("//") && path !== "/login") {
sessionStorage.setItem(KEY, path);
}
} catch {
/* приватный режим/недоступный storage — не критично */
}
}
/** Забрать сохранённый путь (и очистить). По умолчанию — на главную. */
export function takeReturnTo(): string {
try {
const v = sessionStorage.getItem(KEY);
sessionStorage.removeItem(KEY);
if (v && v.startsWith("/") && !v.startsWith("//")) return v;
} catch {
/* см. выше */
}
return "/";
}
+25
View File
@@ -0,0 +1,25 @@
import React from "react";
import ReactDOM from "react-dom/client";
import { BrowserRouter } from "react-router-dom";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import { Toaster } from "sonner";
// Импорт ради побочного эффекта: вешает слушатель `beforeinstallprompt`,
// который Chrome стреляет ОДИН раз и обычно до монтирования React.
import "./lib/install";
import App from "./App";
import "./index.css";
const queryClient = new QueryClient({
defaultOptions: { queries: { retry: 1, staleTime: 15_000 } },
});
ReactDOM.createRoot(document.getElementById("root")!).render(
<React.StrictMode>
<QueryClientProvider client={queryClient}>
<BrowserRouter>
<App />
<Toaster richColors position="top-center" />
</BrowserRouter>
</QueryClientProvider>
</React.StrictMode>
);
@@ -0,0 +1,216 @@
import { describe, it, expect, vi, beforeAll, afterAll } from "vitest";
import { render, screen, within } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { MemoryRouter, Route, Routes, useLocation } from "react-router-dom";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
// Ответ как у настоящего водителя: статьи 1С, итог отдельным числом.
vi.mock("@/api/driver", () => ({
// Колокольчик в шапке главного экрана спрашивает счётчик непрочитанного.
getNotifications: vi.fn(async () => ({ items: [], unread: 0 })),
markNotificationsRead: vi.fn(async () => ({ marked: 0 })),
// Карточка бонусов на главной: та же форма, что отдаёт /driver/bonuses.
getBonuses: vi.fn(async () => ({
level: { code: "rhythm", title: "В ритме", subtitle: "Третья неделя", days: 18,
next: { title: "Первый месяц", days_left: 12 }, series_start: null },
week: { monday: "2026-08-10", orders: { yandex: 90, maxim: 37, total: 127,
tier_amount: 1200, next_tier: { minimum: 140, amount: 1500 } } },
payment_streak: { weeks: 3, weekly_amount: 500, monthly_cap: 3500 },
clean: { days: 18, next: { days: 30, amount: 1000 } },
discount: { active: true, per_day: 500, series: 2, max_series: 3, threshold: 70,
this_week_best: 90, ends_at: "2026-08-16" },
sums: { pending: 700, earned: 4300, this_month: 4300 },
referral: { code: "PP-2630", connect_amount: 2000, days_amount: 8000, work_days: 21,
invited: [{ driver_id: 9001, days: 9, connected: true }] },
goals: [{ kind: "orders", text: "Ещё 13 заказов до 1 500 ₽ за неделю", left: 13 }],
accruals: [],
})),
getBalance: vi.fn(async () => ({
accounts: [
{ bucket: "Долг аренда", balance: -3050, payable: true },
{ bucket: "Долг по штрафам", balance: -5156, payable: true },
{ bucket: "Страховка", balance: 200, payable: false },
],
total: -8976.25,
synced_at: null,
pending_topup: 1500,
})),
getFines: vi.fn(async () => ({
items: [{
id: 12, number: "18810525260813035846", date: "2026-08-13",
article: "12.09.2 - Превышение скорости", address: "", car_number: "А947УТ125",
amount: 618.75, settled: "owed" as const, cancelled: false, has_photo: true,
}],
open_count: 1, debt: -5156,
})),
getStatement: vi.fn(async () => ({
items: [
{ date: "2026-08-17", title: "Аренда автомобиля", description: "ТС А947УТ125",
amount: -2600, kind: "charges" },
{ date: "2026-08-17", title: "Пополнение баланса", description: "", amount: 1000,
kind: "payments" },
],
from: "2026-08-11", to: "2026-08-18", kind: "all",
})),
}));
// Экран режет постановления по периоду «последние 7 дней от сегодня», а даты в
// моках фиксированные: без замороженных часов штраф от 13.08 выпадает из окна,
// как только настоящее «сегодня» уходит за 20.08. Морозим только Date — таймеры
// остаются настоящими, иначе userEvent и waitFor зависнут.
beforeAll(() => {
vi.useFakeTimers({ toFake: ["Date"] });
vi.setSystemTime(new Date("2026-08-18T12:00:00Z"));
});
afterAll(() => vi.useRealTimers());
import { BalancePage, balancePollMs } from "./BalancePage";
import { markPaymentActivity } from "@/lib/paymentWatch";
import * as driver from "@/api/driver";
function Search() {
return <p data-testid="search">{useLocation().search}</p>;
}
function wrap(url = "/") {
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
return render(
<QueryClientProvider client={qc}>
<MemoryRouter initialEntries={[url]}>
<Search />
<Routes>
<Route path="/" element={<BalancePage />} />
<Route path="/topup" element={<p>экран пополнения</p>} />
</Routes>
</MemoryRouter>
</QueryClientProvider>
);
}
describe("главный экран", () => {
it("опрос баланса: пока висит «зачисляется» или водитель недавно платил", () => {
// Водитель после оплаты смотрит на экран и ждёт новый итог — экран обязан
// обновиться сам. Вне платёжных окон опроса быть не должно.
sessionStorage.clear();
expect(balancePollMs({ pending_topup: 1500 })).toBe(4000);
expect(balancePollMs({ pending_topup: 0 })).toBe(false);
expect(balancePollMs(undefined)).toBe(false);
// Свежая платёжная активность держит опрос и без «зачисляется»: вебхук
// банка может запаздывать (опрос обязан застать появление строки), а снимок
// баланса — догонять платёж общим синком уже после её погашения.
markPaymentActivity();
expect(balancePollMs({ pending_topup: 0 })).toBe(4000);
sessionStorage.clear();
});
it("сверху деньги: итог с сервера и строка «зачисляется»", async () => {
wrap();
// Сумма статей дала бы −8 006, а в CRM у водителя −8 976,25. Показываем её.
expect(await screen.findByText("−8 976,25 ₽")).toBeInTheDocument();
expect(screen.getByText("Зачисляется")).toBeInTheDocument();
expect(screen.getByText("1 500 ₽")).toBeInTheDocument();
});
it("снизу выписка за период", async () => {
wrap();
expect(await screen.findByText("Аренда автомобиля")).toBeInTheDocument();
expect(screen.getAllByText(/17\.08\.2026/).length).toBe(2); // обе операции того дня
expect(screen.getByRole("button", { name: "Все операции" })).toBeInTheDocument();
expect(driver.getStatement).toHaveBeenCalled();
});
it("фильтр перезапрашивает операции выбранного вида", async () => {
wrap();
await userEvent.click(await screen.findByRole("button", { name: "Начисления" }));
const calls = vi.mocked(driver.getStatement).mock.calls;
expect(calls[calls.length - 1][2]).toBe("charges");
});
it("фильтр «Штрафы» показывает постановления, а не проводки", async () => {
// Штраф, оплаченный водителем самостоятельно, парк не выставлял — проводки по
// нему нет, и в выписке он бы не появился вовсе (Морозов, 18.08.2026).
wrap();
await userEvent.click(await screen.findByRole("button", { name: "Штрафы" }));
expect(await screen.findByText(/Превышение скорости/)).toBeInTheDocument();
expect(driver.getFines).toHaveBeenCalled();
});
it("аренда и штрафы видны сразу, остальные статьи — нет", async () => {
wrap();
await screen.findByText("−8 976,25 ₽");
// Эти две водитель проверяет каждый день — они на экране.
expect(screen.getByText("Долг аренда")).toBeInTheDocument();
expect(screen.getByText("Долг по штрафам")).toBeInTheDocument();
expect(screen.getByText("−3 050 ₽")).toBeInTheDocument();
// Редкие статьи на экран не лезут: для них есть шторка.
expect(screen.queryByText("Страховка")).not.toBeInTheDocument();
});
it("аренда ведёт к оплате, а штрафы — в свой список", async () => {
wrap();
await userEvent.click(await screen.findByRole("button", { name: /Долг аренда/ }));
expect(await screen.findByText("экран пополнения")).toBeInTheDocument();
});
it("строка штрафов включает фильтр внизу, а не уводит на другой экран", async () => {
wrap();
await userEvent.click(await screen.findByRole("button", { name: /Долг по штрафам/ }));
expect(await screen.findByText(/Превышение скорости/)).toBeInTheDocument();
expect(driver.getFines).toHaveBeenCalled();
// Фильтр записан в адрес — по нему «Назад» из карточки штрафа вернёт сюда же.
expect(screen.getByTestId("search").textContent).toBe("?kind=fines");
});
it("фильтр и период восстанавливаются из адреса", async () => {
// Сюда ведёт «Назад» из карточки штрафа (родитель /?kind=fines) — список
// штрафов должен встретить водителя сразу, без повторного выбора фильтра.
vi.mocked(driver.getStatement).mockClear();
wrap("/?kind=fines&from=2026-08-01&to=2026-08-15");
expect(await screen.findByText(/Превышение скорости/)).toBeInTheDocument();
expect(screen.getByLabelText("Начало периода")).toHaveValue("2026-08-01");
expect(screen.getByLabelText("Конец периода")).toHaveValue("2026-08-15");
// Проводки при фильтре «Штрафы» не запрашиваются — показаны постановления.
expect(driver.getStatement).not.toHaveBeenCalled();
});
it("мусор в адресе не ломает экран — остаются значения по умолчанию", async () => {
wrap("/?kind=bogus&from=вчера");
expect(await screen.findByText("Аренда автомобиля")).toBeInTheDocument();
expect(screen.getByLabelText("Начало периода")).toHaveValue("2026-08-11");
});
it("категории для выбора живут в шторке «Пополнить»", async () => {
wrap();
await screen.findByText("−8 976,25 ₽");
await userEvent.click(screen.getByRole("button", { name: /^Пополнить$/ }));
const sheet = await screen.findByRole("dialog", { name: "Куда пополнить" });
const inSheet = within(sheet);
expect(inSheet.getByText("Долг аренда")).toBeInTheDocument();
expect(inSheet.getByText("Долг по штрафам")).toBeInTheDocument();
// «Страховка» платежом не закрывается — в списке выбора ей делать нечего.
expect(inSheet.queryByText("Страховка")).not.toBeInTheDocument();
});
it("шторка закрывается тапом мимо", async () => {
wrap();
await screen.findByText("−8 976,25 ₽");
await userEvent.click(screen.getByRole("button", { name: /^Пополнить$/ }));
await userEvent.click(await screen.findByRole("button", { name: "Закрыть" }));
expect(screen.queryByRole("dialog")).not.toBeInTheDocument();
});
it("отдельного раздела пополнений нет — они в выписке", async () => {
// Раздел «Мои пополнения» показывал наши платежи и у большинства водителей был
// пуст: 1С проводит пополнения сама, и они уже видны фильтром в выписке.
wrap();
await screen.findByText("−8 976,25 ₽");
expect(screen.queryByText(/Мои пополнения/)).not.toBeInTheDocument();
expect(screen.getByRole("button", { name: "Пополнения" })).toBeInTheDocument();
});
it("баланс не загрузился — экран говорит об этом, а не рисует ноль", async () => {
vi.mocked(driver.getBalance).mockRejectedValueOnce(new Error("boom"));
wrap();
expect(await screen.findByRole("button", { name: /Обновить баланс/ })).toBeInTheDocument();
});
});
@@ -0,0 +1,230 @@
import { useState } from "react";
import { useQuery } from "@tanstack/react-query";
import { useNavigate, useSearchParams } from "react-router-dom";
import { ArrowUp, ChevronRight, Gift, LogOut } from "lucide-react";
import { getBalance, getBonuses, type StatementKind } from "@/api/driver";
import { anyProgramEnabled } from "@/pages/BonusesPage";
import { formatMoney, isoDaysAgo, isoToday } from "@/lib/format";
import { paymentActivityWithin } from "@/lib/paymentWatch";
import { useAuth } from "@/store/auth";
import { AppHeader } from "@/components/AppHeader";
import { NotificationsPrompt } from "@/components/NotificationsPrompt";
import { NotificationsRow } from "@/components/NotificationsRow";
import { Sheet } from "@/components/Sheet";
import { Spinner } from "@/components/Spinner";
import { Statement } from "@/components/Statement";
// Две статьи, которые водитель проверяет каждый день: за них он платит и из-за
// них ему звонят. Остальные (депозит, повреждения, прочее) — редкие, им хватает
// шторки «Пополнить», иначе экран снова превращается в столбик из шести строк.
const MAIN_BUCKETS = ["Долг аренда", "Долг по штрафам"];
// Пока висит «Зачисляется» ЛИБО водитель недавно платил, экран опрашивает
// баланс сам: платёж доезжает до 1С за секунды, и новый итог должен появиться
// на глазах — водитель после оплаты смотрит именно сюда, а перезапускать
// приложение он не обязан. Одного «зачисляется» мало: опрос по нему не
// взводится, пока вебхук банка запаздывает, и гаснет раньше, чем снимок
// баланса догонит платёж при сбое точечного обновления (см. lib/paymentWatch).
// Вне этих окон опрос не нужен: остальные движения баланса водитель не
// караулит у экрана.
export const balancePollMs = (d?: { pending_topup?: number }): number | false =>
(d?.pending_topup ?? 0) > 0 || paymentActivityWithin() ? 4000 : false;
const KINDS: StatementKind[] = ["all", "charges", "payments", "fines"];
const isKind = (v: string | null): v is StatementKind => KINDS.includes(v as StatementKind);
const isIsoDate = (v: string | null): v is string => !!v && /^\d{4}-\d{2}-\d{2}$/.test(v);
/**
* Главный экран из двух половин: сверху деньги, снизу — за что они списаны.
*
* Разбивка по статьям живёт в шторке «Пополнить», а не на экране: водителю она
* нужна ровно в момент, когда он решает, куда платить, а всё остальное время
* это шесть строк, отодвигающих выписку за нижний край телефона.
*/
export function BalancePage() {
const nav = useNavigate();
const clear = useAuth((s) => s.clear);
const { data, isLoading, isError, refetch } = useQuery({
queryKey: ["balance"],
queryFn: getBalance,
refetchInterval: (q) => balancePollMs(q.state.data),
});
const [sheet, setSheet] = useState(false);
// Витрина бонусов на главной: если бонусная подсистема недоступна — карточку
// молча прячем, главный экран не должен падать из-за неё. Тот же ключ кэша,
// что у /bonuses: переход туда не бьёт в API второй раз.
const bonuses = useQuery({
queryKey: ["bonuses"],
queryFn: getBonuses,
retry: 0,
staleTime: 60_000,
});
// Фильтр выписки живёт в адресе (?kind=&from=&to=), а не в памяти экрана:
// вернувшись «Назад» из карточки штрафа, водитель видит тот же список штрафов,
// а не «Все операции», и F5 его не сбрасывает. Меняем заменой записи — выбор
// фильтра не шаг, по которому надо идти назад.
const [params, setParams] = useSearchParams();
const rawKind = params.get("kind");
const kind: StatementKind = isKind(rawKind) ? rawKind : "all";
// Неделя — тот же период, что у вендора: столько человек помнит свои поездки.
const rawFrom = params.get("from");
const rawTo = params.get("to");
const from = isIsoDate(rawFrom) ? rawFrom : isoDaysAgo(7);
const to = isIsoDate(rawTo) ? rawTo : isoToday();
function setFilter(key: "kind" | "from" | "to", value: string) {
setParams((prev) => {
const next = new URLSearchParams(prev);
// Значения по умолчанию в адрес не пишем: «Все операции» и пустая дата —
// это просто отсутствие параметра.
if (!value || (key === "kind" && value === "all")) next.delete(key);
else next.set(key, value);
return next;
}, { replace: true });
}
const setKind = (k: StatementKind) => setFilter("kind", k);
const accounts = data?.accounts ?? [];
const total = data?.total ?? accounts.reduce((s, a) => s + a.balance, 0);
const pending = data?.pending_topup ?? 0;
const noData = !isLoading && !isError && accounts.length === 0;
const payable = accounts.filter((a) => a.payable);
const main = MAIN_BUCKETS.map((b) => accounts.find((a) => a.bucket === b)).filter(
(a): a is NonNullable<typeof a> => a != null,
);
function pick(bucket?: string) {
setSheet(false);
nav("/topup", { state: bucket ? { bucket } : undefined });
}
return (
<div>
<AppHeader bell />
<NotificationsPrompt />
{/* ── Деньги ─────────────────────────────────────────────── */}
<div className="card p-4 mb-3">
<div className="flex justify-between items-baseline">
<span className="text-muted text-xs">Баланс в парке</span>
{isLoading ? (
<Spinner />
) : noData ? (
<span className="text-sm font-semibold">уточняется</span>
) : (
<b className={`text-2xl ${total < 0 ? "text-neg" : "text-pos"}`}>{formatMoney(total)}</b>
)}
</div>
{main.length > 0 && (
<div className="mt-3 pt-3 border-t border-line">
{main.map((a) => (
// Аренда ведёт к оплате — за тем её и открывают. Штрафы включают
// фильтр в списке ниже: «−5 156 ₽» не отвечает на вопрос «за что»,
// а отдельного экрана штрафов нет — два списка одного и того же в
// разных местах сбивали с толку.
<button
key={a.bucket}
disabled={!a.payable}
onClick={() =>
a.bucket === "Долг по штрафам"
? setKind("fines")
: nav("/topup", { state: { bucket: a.bucket } })
}
className="w-full flex justify-between items-baseline py-1.5 text-left disabled:opacity-100"
>
<span className="text-muted text-xs">{a.bucket}</span>
<span className={`text-sm ${a.balance < 0 ? "text-neg" : a.balance > 0 ? "text-pos" : ""}`}>
{formatMoney(a.balance)}
</span>
</button>
))}
</div>
)}
{pending > 0 && (
// Платёж принят нами, но 1С его ещё не провела. В сумму не входит: сложить
// оба источника значило бы показать пополнение дважды после проведения.
<div className="flex justify-between items-baseline mt-3 pt-3 border-t border-line">
<span className="text-muted text-xs">Зачисляется</span>
<span className="text-sm">{formatMoney(pending)}</span>
</div>
)}
{isError && (
<button className="btn-ghost mt-3" onClick={() => refetch()}>Обновить баланс</button>
)}
</div>
<button className="btn-primary flex items-center justify-center gap-2 mb-3"
onClick={() => setSheet(true)}>
<ArrowUp size={18} /> Пополнить
</button>
{/* ── Бонусы ──────────────────────────────────────────────
Вход только участникам: программа поэтапная, водителей включают
адресно (карточка водителя в CRM). Не участвует — закрыто. */}
{bonuses.data && anyProgramEnabled(bonuses.data) && (
<button
className="card w-full flex items-center gap-3 p-4 mb-5 text-left"
onClick={() => nav("/bonuses")}
>
<div className="w-10 h-10 rounded-full bg-accent-soft flex items-center justify-center shrink-0">
<Gift size={20} className="text-accent" />
</div>
<div className="min-w-0 flex-1">
<div className="text-sm font-semibold">Бонусы</div>
<div className="text-muted text-xs truncate">
{bonuses.data.programs_enabled.tenure
? `${bonuses.data.level.title} · ${bonuses.data.level.days} дн.`
: "ваши бонусы"}
{bonuses.data.goals[0] ? ` · ${bonuses.data.goals[0].text}` : ""}
</div>
</div>
<div className="text-right shrink-0">
<b className="text-pos text-sm whitespace-nowrap">
{formatMoney(bonuses.data.sums.earned)}
</b>
<ChevronRight size={16} className="text-muted ml-1 inline" />
</div>
</button>
)}
{/* ── За что списано ─────────────────────────────────────── */}
<Statement from={from} to={to} kind={kind}
onFrom={(v) => setFilter("from", v)} onTo={(v) => setFilter("to", v)} onKind={setKind} />
<NotificationsRow />
<div className="flex justify-center mt-6 text-muted text-xs">
{/* Отдельного раздела «Мои пополнения» нет намеренно: пополнения видны в
выписке выше по фильтру, а дублирующий пустой экран сбивал с толку. */}
<button className="flex items-center gap-1.5" onClick={() => { clear(); nav("/login", { replace: true }); }}>
<LogOut size={15} /> Выйти
</button>
</div>
<Sheet open={sheet} onClose={() => setSheet(false)} title="Куда пополнить">
{payable.length === 0 ? (
<p className="text-muted text-sm px-5 py-4">
Категории пока не загрузились. Попробуйте ещё раз через минуту.
</p>
) : (
payable.map((a) => (
<button
key={a.bucket}
onClick={() => pick(a.bucket)}
className="w-full flex justify-between items-center gap-3 px-5 py-3.5 border-b border-line last:border-0 text-left"
>
<span className="text-sm">{a.bucket}</span>
<span className="flex items-center gap-2 shrink-0">
<b className={a.balance < 0 ? "text-neg" : a.balance > 0 ? "text-pos" : "text-muted"}>
{formatMoney(a.balance)}
</b>
<ChevronRight size={16} className="text-muted" />
</span>
</button>
))
)}
</Sheet>
</div>
);
}
@@ -0,0 +1,127 @@
import { describe, it, expect, vi } from "vitest";
import { render, screen } from "@testing-library/react";
import { MemoryRouter, Route, Routes, useLocation } from "react-router-dom";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
// Экран из презентации владельца: уровень «В ритме», 18/21 день, 127/140
// заказов, скидка активна второй неделей, в истории — подтверждённый бонус.
vi.mock("@/api/driver", () => ({
getBonuses: vi.fn(async () => ({
level: { code: "rhythm", title: "В ритме", subtitle: "Третья неделя", days: 18,
next: { title: "Первый месяц", days_left: 12 }, series_start: null },
week: { monday: "2026-08-10", orders: { yandex: 90, maxim: 37, total: 127,
tier_amount: 1200, next_tier: { minimum: 140, amount: 1500 } } },
payment_streak: { weeks: 3, weekly_amount: 500, monthly_cap: 3500 },
clean: { days: 18, next: { days: 30, amount: 1000 } },
discount: { active: true, per_day: 500, series: 2, max_series: 3, threshold: 70,
this_week_best: 90, ends_at: "2026-08-16" },
sums: { pending: 700, earned: 4300, this_month: 4300 },
referral: { code: "PP-2630", connect_amount: 2000, days_amount: 8000, work_days: 21,
invited: [{ driver_id: 9001, days: 9, connected: true }] },
goals: [
{ kind: "orders", text: "Ещё 13 заказов до 1 500 ₽ за неделю", left: 13 },
{ kind: "level", text: "До уровня «Первый месяц» — 12 дн.", left: 12 },
],
accruals: [
{ id: 1, program: "orders", kind: "money", amount: 1200,
title: "127 заказов за неделю", status: "approved", date: "2026-08-16" },
{ id: 2, program: "payment", kind: "money", amount: 500,
title: "Неделя без просрочки аренды", status: "pending", date: "2026-08-16" },
],
// Участник всех программ: экран и карточки открыты.
programs_enabled: { orders: true, payment: true, discount: true,
clean: true, tenure: true, friend: true },
})),
}));
import { BonusesPage } from "./BonusesPage";
function Search() {
return <p data-testid="search">{useLocation().search}</p>;
}
function wrap(url = "/bonuses") {
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
return render(
<QueryClientProvider client={qc}>
<MemoryRouter initialEntries={[url]}>
<Search />
<Routes>
<Route path="/bonuses" element={<BonusesPage />} />
<Route path="/" element={<p>главная</p>} />
</Routes>
</MemoryRouter>
</QueryClientProvider>
);
}
describe("экран бонусов", () => {
it("уровень, заработанное и путь до следующего уровня", async () => {
wrap();
expect(await screen.findByText("В ритме")).toBeInTheDocument();
expect(screen.getByText("18 дн. в парке")).toBeInTheDocument();
expect(screen.getByText(/до «Первый месяц» — 12 дн./)).toBeInTheDocument();
expect(screen.getByText("4 300 ₽")).toBeInTheDocument(); // заработано
expect(screen.getByText(/700 ₽ ждёт подтверждения/)).toBeInTheDocument();
});
it("заказы недели: сколько есть и сколько до следующего тира", async () => {
wrap();
expect(await screen.findByText("127")).toBeInTheDocument();
expect(screen.getByText("Яндекс 90 · Максим 37")).toBeInTheDocument();
// Тир 120–139 уже набран — показываем его сумму и путь до максимума.
expect(screen.getByText("Тир набран: 1 200 ₽ за неделю")).toBeInTheDocument();
});
it("активная скидка показывается зелёной картой с серией", async () => {
wrap();
expect(await screen.findByText("−500 ₽ в сутки")).toBeInTheDocument();
expect(screen.getByText(/серия 2 из 3/)).toBeInTheDocument();
});
it("серии оплат и «без нарушений» с вехой", async () => {
wrap();
expect(await screen.findByText("3 нед. подряд")).toBeInTheDocument();
expect(screen.getByText(/ещё 12 дн. — и 1 000 ₽/)).toBeInTheDocument();
});
it("код друга и ближайшие цели", async () => {
wrap();
expect(await screen.findByText("PP-2630")).toBeInTheDocument();
expect(screen.getByText("Ещё 13 заказов до 1 500 ₽ за неделю")).toBeInTheDocument();
expect(screen.getByText(/друзей привёл: 1/)).toBeInTheDocument();
});
it("история начислений с разницей «начислено / ждёт»", async () => {
wrap();
expect(await screen.findByText("127 заказов за неделю")).toBeInTheDocument();
expect(screen.getByText("начислено")).toBeInTheDocument();
expect(screen.getByText("ждёт подтверждения")).toBeInTheDocument();
});
it("ошибка загрузки предлагает повторить, а не белый экран", async () => {
const { getBonuses } = await import("@/api/driver");
vi.mocked(getBonuses).mockRejectedValueOnce(new Error("boom"));
wrap();
expect(await screen.findByRole("button", { name: /Попробовать снова/ })).toBeInTheDocument();
});
it("клик по карточке на главной — отдельный маршрут /bonuses", async () => {
// Сам маршрут описан в routes.tsx и покрыт сторожем routes.test.tsx
// («Назад» на каждом экране); здесь проверяем только сам экран.
wrap();
expect(screen.getByTestId("search").textContent).toBe("");
expect(screen.queryByText("главная")).not.toBeInTheDocument();
});
});
describe("экран бонусов: адресность", () => {
it("неучастнику закрыто — вежливая заглушка вместо витрины", async () => {
const { getBonuses } = await import("@/api/driver");
vi.mocked(getBonuses).mockResolvedValueOnce({
...await getBonuses(), programs_enabled: {},
} as never);
wrap();
expect(await screen.findByText(/Вы пока не участвуете/)).toBeInTheDocument();
});
});
@@ -0,0 +1,334 @@
import { useQuery } from "@tanstack/react-query";
import {
BarChart3, CalendarCheck, ChevronRight, Flame, Gift, ShieldCheck, Target,
Trophy, Users,
} from "lucide-react";
import { getBonuses, type Bonuses } from "@/api/driver";
import { Spinner } from "@/components/Spinner";
import { formatDate, formatMoney } from "@/lib/format";
/** Полоса прогресса: тонкая, с мягкими краями — как «до следующей цели». */
function Bar({ value, max, tone = "accent" }: { value: number; max: number; tone?: "accent" | "pos" }) {
const pct = max > 0 ? Math.min(100, Math.round((value / max) * 100)) : 0;
return (
<div className="h-2 rounded-full bg-line-soft overflow-hidden mt-2">
<div
className={`h-full rounded-full ${tone === "pos" ? "bg-pos" : "bg-accent"}`}
style={{ width: `${pct}%` }}
/>
</div>
);
}
function ProgramIcon({ program }: { program: string }) {
const cls = "w-5 h-5 text-accent shrink-0";
switch (program) {
case "orders": return <BarChart3 className={cls} />;
case "discount": return <Flame className={cls} />;
case "payment": return <CalendarCheck className={cls} />;
case "clean": return <ShieldCheck className={cls} />;
case "tenure": return <Trophy className={cls} />;
case "friend": return <Users className={cls} />;
default: return <Gift className={cls} />;
}
}
function Card({ children, tone = "plain" }: { children: React.ReactNode; tone?: "plain" | "pos" }) {
return (
<div
className={`card p-4 ${tone === "pos" ? "border-pos/40 bg-pos/5" : ""}`}
>
{children}
</div>
);
}
const CardTitle = ({ icon, children }: { icon: React.ReactNode; children: React.ReactNode }) => (
<div className="flex items-center gap-2 text-ink-soft text-sm font-medium">
{icon}
<span>{children}</span>
</div>
);
const STATUS_LABEL: Record<string, { text: string; cls: string }> = {
pending: { text: "ждёт подтверждения", cls: "text-muted" },
approved: { text: "начислено", cls: "text-pos font-medium" },
posted: { text: "начислено", cls: "text-pos font-medium" },
};
/** Участвует ли хоть в одной программе (вход на главную закрыт неучастникам). */
export function anyProgramEnabled(b: Bonuses | undefined | null): boolean {
const m = b?.programs_enabled;
return !!m && Object.values(m).some(Boolean);
}
/**
* Бонусы — витрина системы лояльности: уровень, серии, прогресс до следующей
* суммы и история начислений. Числа считаются тем же движком, что и в CRM,
* поэтому с менеджером всегда одинаковые (docs/bonus-rules.md на бэкенде).
*
* Экран живёт только у участников: бонусная программа поэтапная, водителя
* включают адресно (карточка водителя в CRM). Не участвует — закрыто.
*/
export function BonusesPage() {
const { data, error, refetch } = useQuery({
queryKey: ["bonuses"],
queryFn: getBonuses,
staleTime: 60_000,
});
if (error) {
return (
<div>
<h1 className="text-lg font-bold mb-3">Бонусы</h1>
<div className="card p-4 text-sm">
<p className="text-ink-soft">Не удалось загрузить бонусы. Проверьте связь.</p>
<button className="btn-primary mt-3 w-full" onClick={() => void refetch()}>
Попробовать снова
</button>
</div>
</div>
);
}
if (!data) {
return (
<div>
<h1 className="text-lg font-bold mb-3">Бонусы</h1>
<Spinner />
</div>
);
}
if (!anyProgramEnabled(data)) {
return (
<div className="space-y-3">
<h1 className="text-lg font-bold">Бонусы</h1>
<div className="card p-4 text-sm text-ink-soft">
Вы пока не участвуете в бонусной программе парка. Когда менеджер включит
вам бонусы — здесь появятся уровень, серии и заработанное.
</div>
</div>
);
}
return <BonusesBody b={data} />;
}
function BonusesBody({ b }: { b: Bonuses }) {
const o = b.week.orders;
const weekFrom = formatDate(b.week.monday);
const on = {
orders: b.programs_enabled.orders === true,
discount: b.programs_enabled.discount === true,
payment: b.programs_enabled.payment === true,
clean: b.programs_enabled.clean === true,
tenure: b.programs_enabled.tenure === true,
friend: b.programs_enabled.friend === true,
};
const cards = [on.orders, on.discount, on.payment, on.clean, on.friend].filter(Boolean).length;
return (
<div className="space-y-3">
<h1 className="text-lg font-bold">Бонусы</h1>
{/* Уровень + заработанное — первое, ради чего экран открывают.
Уровень — часть программы «Стаж»: не участвует — не показываем. */}
{(on.tenure || cards > 0 || b.sums.earned > 0 || b.sums.pending > 0) && (
<div className="card p-4">
<div className="flex items-start justify-between gap-3">
{on.tenure ? (
<div className="flex items-center gap-3">
<div className="w-11 h-11 rounded-full bg-accent-soft flex items-center justify-center shrink-0">
<Trophy className="w-6 h-6 text-accent" />
</div>
<div>
<div className="text-xl font-bold leading-tight">{b.level.title}</div>
<div className="text-muted text-sm">{b.level.subtitle}</div>
</div>
</div>
) : (
<div className="flex items-center gap-3">
<div className="w-11 h-11 rounded-full bg-accent-soft flex items-center justify-center shrink-0">
<Gift className="w-6 h-6 text-accent" />
</div>
<div>
<div className="text-xl font-bold leading-tight">Бонусы парка</div>
<div className="text-muted text-sm">программы, в которых вы участвуете</div>
</div>
</div>
)}
<div className="text-right shrink-0">
<div className="text-xl font-bold text-pos">{formatMoney(b.sums.earned)}</div>
<div className="text-muted text-xs">заработано</div>
</div>
</div>
{on.tenure && (
<div className="mt-4">
<div className="flex justify-between text-sm">
<span className="text-ink-soft">{b.level.days} дн. в парке</span>
{b.level.next && (
<span className="text-muted">
до «{b.level.next.title}» — {b.level.next.days_left} дн.
</span>
)}
</div>
<Bar value={b.level.days % 30 || 30} max={30} />
</div>
)}
{b.sums.pending > 0 && (
<div className="mt-2 text-xs text-muted">
Ещё {formatMoney(b.sums.pending)} ждёт подтверждения менеджера
</div>
)}
</div>
)}
{/* Ближайшие цели — «ещё 13 заказов и…» (памятка из презентации) */}
{b.goals.length > 0 && (
<div className="card p-4">
<CardTitle icon={<Target className="w-5 h-5 text-accent" />}>До ближайших целей</CardTitle>
<ul className="mt-2 space-y-1.5 text-sm">
{b.goals.map((g, i) => (
<li key={i} className="flex items-start gap-2">
<ChevronRight className="w-4 h-4 text-muted mt-0.5 shrink-0" />
<span>{g.text}</span>
</li>
))}
</ul>
</div>
)}
{/* Заказы за неделю */}
{on.orders && (
<Card>
<CardTitle icon={<BarChart3 className="w-5 h-5 text-accent" />}>
Заказы за неделю (с {weekFrom})
</CardTitle>
<div className="flex items-baseline justify-between mt-1">
<div className="text-2xl font-bold tabular-nums">{o.total}</div>
<div className="text-muted text-sm">Яндекс {o.yandex} · Максим {o.maxim}</div>
</div>
<Bar value={o.total} max={o.next_tier?.minimum ?? 140} />
<div className="mt-2 text-sm text-ink-soft">
{o.tier_amount > 0
? `Тир набран: ${formatMoney(o.tier_amount)} за неделю`
: o.next_tier
? `Ещё ${o.next_tier.minimum - o.total} заказов — и ${formatMoney(o.next_tier.amount)}`
: "Максимальный тир недели"}
</div>
</Card>
)}
{/* Скидка 70+ */}
{on.discount && (b.discount.active ? (
<Card tone="pos">
<CardTitle icon={<Flame className="w-5 h-5 text-pos" />}>Скидка на аренду активна</CardTitle>
<div className="text-2xl font-bold text-pos mt-1">
−{formatMoney(b.discount.per_day)} в сутки
</div>
<div className="mt-1 text-sm text-ink-soft">
до {formatDate(b.discount.ends_at)} · серия {b.discount.series} из {b.discount.max_series}
</div>
<div className="mt-1 text-xs text-muted">
Продли: {b.discount.threshold}+ заказов в одном агрегаторе на этой неделе
</div>
</Card>
) : (
<Card>
<CardTitle icon={<Flame className="w-5 h-5 text-accent" />}>
Скидка за {b.discount.threshold}+ заказов
</CardTitle>
<div className="flex items-baseline justify-between mt-1">
<div className="text-2xl font-bold tabular-nums">{b.discount.this_week_best}</div>
<div className="text-muted text-sm">из {b.discount.threshold} в одном агрегаторе</div>
</div>
<Bar value={b.discount.this_week_best} max={b.discount.threshold} />
<div className="mt-2 text-sm text-ink-soft">
Дальше — −{formatMoney(b.discount.per_day)} с аренды каждый день следующей недели
</div>
</Card>
))}
{/* Оплата вовремя */}
{on.payment && (
<Card>
<CardTitle icon={<CalendarCheck className="w-5 h-5 text-accent" />}>Оплата вовремя</CardTitle>
<div className="text-2xl font-bold mt-1">{b.payment_streak.weeks} нед. подряд</div>
<div className="mt-1 text-sm text-ink-soft">
+{formatMoney(b.payment_streak.weekly_amount)} за каждую неделю без просрочки
</div>
</Card>
)}
{/* Без нарушений */}
{on.clean && (
<Card>
<CardTitle icon={<ShieldCheck className="w-5 h-5 text-accent" />}>Без нарушений</CardTitle>
<div className="text-2xl font-bold mt-1">{b.clean.days} дн.</div>
{b.clean.next && (
<>
<Bar value={b.clean.days} max={b.clean.next.days} tone="pos" />
<div className="mt-2 text-sm text-ink-soft">
ещё {b.clean.next.days - b.clean.days} дн. — и {formatMoney(b.clean.next.amount)}
</div>
</>
)}
</Card>
)}
{/* Приведи друга */}
{on.friend && (
<Card>
<CardTitle icon={<Users className="w-5 h-5 text-accent" />}>Приведи друга</CardTitle>
<div className="flex items-baseline justify-between mt-1">
<div>
<div className="text-muted text-xs">твой код</div>
<div className="text-2xl font-bold tracking-wide">{b.referral.code}</div>
</div>
<div className="text-right text-sm text-ink-soft">
до {formatMoney(b.referral.connect_amount + b.referral.days_amount)}
<div className="text-muted text-xs">
{b.referral.invited.length > 0
? `друзей привёл: ${b.referral.invited.length}`
: `за друга, который проработает ${b.referral.work_days} дн.`}
</div>
</div>
</div>
<div className="mt-2 text-xs text-muted">
Назови код менеджеру при подключении друга — бонус придёт сюда
</div>
</Card>
)}
{/* История начислений */}
<div className="card p-0 overflow-hidden">
<div className="px-4 pt-4 pb-2 text-sm font-medium text-ink-soft">История начислений</div>
{b.accruals.length === 0 && (
<div className="px-4 pb-4 text-muted text-sm">
Пока пусто: начисления появляются после первой закрытой недели
</div>
)}
<ul>
{b.accruals.map((a) => {
const st = STATUS_LABEL[a.status] ?? { text: a.status, cls: "text-muted" };
return (
<li key={a.id} className="flex items-center gap-3 px-4 py-3 border-t border-line">
<ProgramIcon program={a.program} />
<div className="min-w-0 flex-1">
<div className="text-sm">{a.title}</div>
<div className={`text-xs ${st.cls}`}>{st.text}</div>
</div>
<div className="text-sm font-semibold tabular-nums whitespace-nowrap">
{formatMoney(a.amount)}
</div>
</li>
);
})}
</ul>
</div>
</div>
);
}
@@ -0,0 +1,102 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import { MemoryRouter } from "react-router-dom";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
vi.mock("@/api/staff", () => ({
searchDrivers: vi.fn(async () => ({ drivers: [] })),
impersonate: vi.fn(),
}));
// Экран баланса, на который уводит редирект, тянет свои запросы — отдаём пустышки.
vi.mock("@/api/driver", () => ({
apiErrorText: vi.fn(async (_e: unknown, f: string) => f),
getBalance: vi.fn(async () => ({ accounts: [], pending_topup: 0 })),
// Тесты доходят до главного экрана, а у него в шапке колокольчик.
getNotifications: vi.fn(async () => ({ items: [], unread: 0 })),
markNotificationsRead: vi.fn(async () => ({ marked: 0 })),
}));
import App from "@/App";
import { DebugPage } from "./DebugPage";
import { clearLog, pushEntry } from "@/lib/reqlog";
import { useAuth } from "@/store/auth";
import { useStaff } from "@/store/staff";
function renderAt(path: string) {
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
return render(
<QueryClientProvider client={qc}>
<MemoryRouter initialEntries={[path]}><App /></MemoryRouter>
</QueryClientProvider>
);
}
describe("вкладка отладки", () => {
beforeEach(() => { useAuth.getState().clear(); useStaff.getState().clear(); clearLog(); });
it("водителя на /debug не пускает — уводит в приложение", () => {
useAuth.getState().setSession("t", 42);
renderAt("/debug");
expect(screen.queryByRole("heading", { name: "Отладка" })).not.toBeInTheDocument();
});
it("сотруднику показывает, от чьего лица открыт экран", () => {
useAuth.getState().setSession("t", 42, { impersonated: true, driverName: "Петров Пётр" });
renderAt("/debug");
expect(screen.getByRole("heading", { name: "Отладка" })).toBeInTheDocument();
// Плашка живёт над маршрутами и видна на любом экране, включая этот.
expect(screen.getByText(/Смотрю как/)).toBeInTheDocument();
expect(screen.getAllByText(/Петров Пётр/).length).toBeGreaterThan(0);
});
it("плашки нет у обычного водителя", () => {
useAuth.getState().setSession("t", 42);
renderAt("/");
expect(screen.queryByText(/Смотрю как/)).not.toBeInTheDocument();
});
it("журнал запросов виден со статусами и временем", () => {
useAuth.getState().setSession("t", 42, { impersonated: true, driverName: "Петров" });
pushEntry({ method: "GET", path: "/api/driver/balance", status: 401, ms: 123 });
render(
<QueryClientProvider client={new QueryClient()}>
<MemoryRouter><DebugPage /></MemoryRouter>
</QueryClientProvider>
);
expect(screen.getByText("/api/driver/balance")).toBeInTheDocument();
expect(screen.getByText("401")).toBeInTheDocument();
expect(screen.getByText("123 мс")).toBeInTheDocument();
});
});
describe("возврат к своему аккаунту", () => {
beforeEach(() => { useAuth.getState().clear(); useStaff.getState().clear(); clearLog(); });
it("свой вход не теряется при просмотре чужого экрана", () => {
useAuth.getState().setSession("мой-токен", 91);
useAuth.getState().startImpersonation("чужой-токен", 6866, "Тест Тестовый тестович");
let s = useAuth.getState();
expect([s.token, s.driverId, s.impersonated]).toEqual(["чужой-токен", 6866, true]);
// смена водителя внутри просмотра не должна подменять отложенный свой вход
useAuth.getState().startImpersonation("третий-токен", 2869, "Тестик Николай");
expect(useAuth.getState().own).toEqual({ token: "мой-токен", driverId: 91 });
expect(useAuth.getState().stopImpersonation()).toBe(true);
s = useAuth.getState();
expect([s.token, s.driverId, s.impersonated, s.own]).toEqual(["мой-токен", 91, false, null]);
});
it("если своего входа не было — просмотр просто заканчивается выходом", () => {
useAuth.getState().startImpersonation("чужой-токен", 6866, "Тест");
expect(useAuth.getState().stopImpersonation()).toBe(false);
expect(useAuth.getState().token).toBeNull();
});
it("кнопка предлагает вернуться к себе, когда есть куда", async () => {
useAuth.getState().setSession("мой-токен", 91);
useAuth.getState().startImpersonation("чужой-токен", 6866, "Тест Тестовый тестович");
renderAt("/debug");
expect(screen.getByRole("button", { name: /Вернуться к своему аккаунту/ })).toBeInTheDocument();
});
});
+156
View File
@@ -0,0 +1,156 @@
import { useState, useSyncExternalStore } from "react";
import { useNavigate } from "react-router-dom";
import { LogOut, RefreshCw, Trash2, UserCog } from "lucide-react";
import { toast } from "sonner";
import { API_BASE } from "@/api/client";
import { clearLog, getLog, subscribe } from "@/lib/reqlog";
import { expiresIn, readToken } from "@/lib/jwt";
import { useAuth } from "@/store/auth";
import { useStaff } from "@/store/staff";
import { DriverPicker } from "@/components/DriverPicker";
function Row({ k, v }: { k: string; v: string }) {
return (
<div className="flex justify-between gap-3 py-2 border-b border-line last:border-0">
<span className="text-muted text-xs shrink-0">{k}</span>
<span className="text-xs text-right break-all">{v}</span>
</div>
);
}
/**
* Вкладка «Отладка» — то, чего в приложении водителя нет и быть не должно:
* от чьего лица открыт экран, куда ходят запросы, чем они отвечают.
*
* Показывается только сотруднику (есть учётка CRM или действует просмотр). У
* водителя маршрут ведёт на главную — см. App.
*/
export function DebugPage() {
const nav = useNavigate();
const { token, driverId, driverName, impersonated, own, clear, stopImpersonation } = useAuth();
const staff = useStaff();
const log = useSyncExternalStore(subscribe, getLog);
const [switching, setSwitching] = useState(false);
const info = readToken(token);
async function hardReload() {
// Кэш сервис-воркера переживает деплой и показывает вчерашний бандл — на
// отладке это стоит часа «почему правка не приехала».
try {
const regs = await navigator.serviceWorker?.getRegistrations?.();
await Promise.all((regs ?? []).map((r) => r.unregister()));
const keys = await caches?.keys?.();
await Promise.all((keys ?? []).map((k) => caches.delete(k)));
toast.success("Кэш сброшен, перезагружаю");
} catch {
toast.error("Не удалось сбросить кэш");
}
location.reload();
}
return (
<div className="pt-3">
<h1 className="text-lg font-extrabold mb-4">Отладка</h1>
<div className="card p-4 mb-4">
<p className="text-muted text-xs mb-1">Сейчас смотрю</p>
<p className="text-sm font-bold mb-3">
{impersonated ? (driverName ?? `Водитель #${driverId}`) : "Свой аккаунт водителя"}
</p>
<button className="btn-ghost flex items-center justify-center gap-2"
onClick={() => setSwitching((s) => !s)}>
<UserCog size={16} /> {switching ? "Свернуть" : "Сменить водителя"}
</button>
{switching && (
<div className="mt-4">
<DriverPicker onPicked={(d) => { setSwitching(false); toast.success(`Смотрю как ${d.fio}`); }} />
</div>
)}
</div>
{impersonated && (
<div className="card p-4 mb-4">
<p className="text-sm font-semibold mb-1">Боевая оплата</p>
<p className="text-muted text-xs mb-3">
Выключено — пополнение открывает учебный экран, деньги не двигаются.
Включено — платёж уходит в банк по-настоящему: спишется с вашей карты,
чек уйдёт на телефон водителя, сумма зачислится ему в 1С.
</p>
<button
className={staff.livePay ? "btn-primary" : "btn-ghost"}
onClick={() => staff.setLivePay(!staff.livePay)}
>
{staff.livePay ? "Боевая оплата включена — выключить" : "Включить боевую оплату"}
</button>
</div>
)}
<div className="card p-4 mb-4">
<p className="text-muted text-xs mb-2">Сведения</p>
<Row k="driver_id" v={String(driverId ?? "—")} />
<Row k="режим" v={impersonated ? "просмотр сотрудником (imp)" : "обычный вход водителя"} />
{impersonated && (
<Row k="оплата" v={staff.livePay ? "боевая — деньги двигаются" : "учебная"} />
)}
<Row k="сотрудник" v={staff.username ?? "не входил"} />
<Row k="токен истекает" v={expiresIn(info?.exp ?? null)} />
<Row k="API" v={API_BASE} />
<Row k="сборка" v={`${__BUILD_COMMIT__} · ${__BUILD_TIME__}`} />
<Row k="сеть" v={navigator.onLine ? "онлайн" : "офлайн"} />
</div>
<div className="card p-4 mb-4">
<div className="flex items-center justify-between mb-2">
<p className="text-muted text-xs">Последние запросы</p>
<button className="text-muted text-xs flex items-center gap-1" onClick={clearLog}>
<Trash2 size={12} /> очистить
</button>
</div>
{log.length === 0 ? (
<p className="text-muted text-xs py-2">Пока пусто</p>
) : (
<div className="font-mono text-[11px] leading-5">
{log.map((e) => (
<div key={e.id} className="flex gap-2 border-b border-line last:border-0 py-1">
<span className={e.status && e.status >= 400 ? "text-neg" : "text-pos"}>
{e.status ?? "—"}
</span>
<span className="text-muted">{e.method}</span>
<span className="truncate">{e.path}</span>
<span className="ml-auto text-muted shrink-0">{e.ms} мс</span>
</div>
))}
</div>
)}
<p className="text-muted text-[11px] mt-2">
Запрос, оборвавшийся без ответа, сюда не попадает.
</p>
</div>
<button className="btn-ghost flex items-center justify-center gap-2 mb-2" onClick={hardReload}>
<RefreshCw size={16} /> Сбросить кэш и перезагрузить
</button>
<button
className="btn-ghost flex items-center justify-center gap-2"
onClick={() => {
// Свой вход, отложенный на время просмотра, возвращаем на место: иначе
// «посмотреть чужой экран» означало бы заново входить через Telegram.
// Уходим заменой записи: системный «назад» не должен возвращать на
// отладку сеанса, который только что закрыли.
if (impersonated && stopImpersonation()) { nav("/", { replace: true }); return; }
clear();
nav(staff.token ? "/dev" : "/login", { replace: true });
}}
>
<LogOut size={16} />{" "}
{impersonated ? (own ? "Вернуться к своему аккаунту" : "Выйти из просмотра") : "Выйти"}
</button>
{staff.token && (
<button className="text-muted text-xs w-full mt-4"
onClick={() => { clear(); staff.clear(); nav("/login", { replace: true }); }}>
Выйти и из учётки сотрудника
</button>
)}
</div>
);
}
@@ -0,0 +1,85 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { MemoryRouter, Route, Routes, useNavigationType } from "react-router-dom";
vi.mock("@/api/staff", () => ({
staffLogin: vi.fn(async () => ({ access_token: "staff-tok", requires_2fa: false, partial_token: null })),
staffLogin2fa: vi.fn(async () => ({ access_token: "staff-tok", requires_2fa: false, partial_token: null })),
searchDrivers: vi.fn(async () => ({
drivers: [{ id: 42, fio: "Петров Пётр", phone: "+79141234567", status: "Работает", driver_kind: "park" }],
})),
impersonate: vi.fn(async () => ({
token: "driver-tok",
driver: { id: 42, fio: "Петров Пётр", phone: "+79141234567", status: "Работает", driver_kind: "park" },
})),
}));
vi.mock("@/api/driver", () => ({ apiErrorText: vi.fn(async (_e: unknown, f: string) => f) }));
import { DevLoginPage } from "./DevLoginPage";
import * as staffApi from "@/api/staff";
import { useAuth } from "@/store/auth";
import { useStaff } from "@/store/staff";
const wrap = () => render(<MemoryRouter><DevLoginPage /></MemoryRouter>);
describe("DevLoginPage", () => {
beforeEach(() => {
useAuth.getState().clear();
useStaff.getState().clear();
vi.clearAllMocks();
});
it("логин учёткой CRM, выбор водителя — и сеанс помечен как просмотр", async () => {
wrap();
await userEvent.type(screen.getByPlaceholderText("Логин"), "vlad");
await userEvent.type(screen.getByPlaceholderText("Пароль"), "secret");
await userEvent.click(screen.getByRole("button", { name: "Войти" }));
expect(staffApi.staffLogin).toHaveBeenCalledWith("vlad", "secret");
expect(useStaff.getState().token).toBe("staff-tok");
await userEvent.click(await screen.findByRole("button", { name: /Петров Пётр/ }));
expect(staffApi.impersonate).toHaveBeenCalledWith(42);
const auth = useAuth.getState();
// Метка просмотра — то, на чём держатся и плашка, и запрет боевой оплаты.
expect(auth.token).toBe("driver-tok");
expect(auth.driverId).toBe(42);
expect(auth.impersonated).toBe(true);
expect(auth.driverName).toBe("Петров Пётр");
});
it("выбрал водителя — на главную заменой записи: «назад» не вернёт к выбору", async () => {
function Home() {
return <p>главная: {useNavigationType()}</p>;
}
useStaff.getState().setStaff("staff-tok", "vlad");
render(
<MemoryRouter initialEntries={["/login", "/dev"]} initialIndex={1}>
<Routes>
<Route path="/" element={<Home />} />
<Route path="/dev" element={<DevLoginPage />} />
</Routes>
</MemoryRouter>
);
await userEvent.click(await screen.findByRole("button", { name: /Петров Пётр/ }));
expect(await screen.findByText("главная: REPLACE")).toBeInTheDocument();
});
it("двухфакторка: пароль сам по себе сеанса не открывает", async () => {
vi.mocked(staffApi.staffLogin).mockResolvedValueOnce({
access_token: null, requires_2fa: true, partial_token: "partial",
});
wrap();
await userEvent.type(screen.getByPlaceholderText("Логин"), "vlad");
await userEvent.type(screen.getByPlaceholderText("Пароль"), "secret");
await userEvent.click(screen.getByRole("button", { name: "Войти" }));
expect(useStaff.getState().token).toBeNull();
// Шестая цифра отправляет код сама: раньше форма ждала нажатия, а «Готово» на
// клавиатуре телефона ничего не делало — выглядело как «код не принят».
await userEvent.type(await screen.findByPlaceholderText("000000"), "123456");
expect(staffApi.staffLogin2fa).toHaveBeenCalledWith("partial", "123456");
expect(useStaff.getState().token).toBe("staff-tok");
});
});
@@ -0,0 +1,140 @@
import { useState } from "react";
import { useNavigate } from "react-router-dom";
import { toast } from "sonner";
import { apiErrorText } from "@/api/driver";
import { staffLogin, staffLogin2fa } from "@/api/staff";
import { useRouteBack } from "@/lib/back";
import { useStaff } from "@/store/staff";
import { DriverPicker } from "@/components/DriverPicker";
import { Spinner } from "@/components/Spinner";
/**
* Вход сотрудника — тот же логин и пароль, что в CRM.
*
* Экран нужен, пока приложение обкатывается: интерфейс проверяется на живых
* данных, а живые данные лежат у настоящих водителей. Отдельного входа «за
* водителя» здесь нет: сотрудник входит СОБОЙ, а дальше выбирает, чей экран
* смотреть, — и это записывается в аудит CRM.
*/
export function DevLoginPage() {
const nav = useNavigate();
// «Я водитель» — туда же, куда «Назад» над экраном: откуда пришли, а с
// холодного старта — на главную или ко входу, смотря вошёл ли (routes.tsx).
const toDriver = useRouteBack();
const { token: staffToken, username: staffName, setStaff, clear } = useStaff();
const [username, setUsername] = useState("");
const [password, setPassword] = useState("");
const [partial, setPartial] = useState<string | null>(null);
const [code, setCode] = useState("");
const [busy, setBusy] = useState(false);
async function submit() {
if (!username || !password || busy) return;
setBusy(true);
try {
const r = await staffLogin(username, password);
if (r.requires_2fa && r.partial_token) {
setPartial(r.partial_token);
return;
}
if (!r.access_token) throw new Error("no token");
setStaff(r.access_token, username);
} catch (e: unknown) {
toast.error(await apiErrorText(e, "Неверный логин или пароль"));
} finally {
setBusy(false);
}
}
async function submit2fa(value = code) {
if (!partial || value.length < 6 || busy) return;
setBusy(true);
try {
const r = await staffLogin2fa(partial, value);
if (!r.access_token) throw new Error("no token");
setStaff(r.access_token, username);
setPartial(null);
} catch (e: unknown) {
toast.error(await apiErrorText(e, "Код не подошёл"));
} finally {
setBusy(false);
}
}
if (staffToken) {
return (
<div className="pt-10">
<h1 className="text-lg font-extrabold mb-1">Кого смотрим</h1>
<p className="text-muted text-xs mb-5">
Сотрудник: {staffName}. Приложение откроется от лица выбранного водителя,
деньги в этом режиме не двигаются.
</p>
{/* Сеанс уже сменился — выбор отработал. Заменой записи: системный
«назад» с главной не должен возвращать к выбору водителя. */}
<DriverPicker onPicked={() => nav("/", { replace: true })} />
<button className="btn-ghost mt-5" onClick={clear}>Выйти из учётки сотрудника</button>
</div>
);
}
return (
<div className="pt-16">
<h1 className="text-xl font-extrabold mb-1">Вход для сотрудника</h1>
<p className="text-muted text-sm mb-8">Учётная запись Premium CRM</p>
{partial ? (
<>
<p className="text-sm mb-2">Код из приложения-аутентификатора.</p>
<input
autoFocus
inputMode="numeric"
autoComplete="one-time-code"
value={code}
onChange={(e) => {
const next = e.target.value.replace(/\D/g, "").slice(0, 6);
setCode(next);
// Шесть цифр — код собран, ждать нажатия нечего: у TOTP всё равно
// остаётся секунд тридцать. Раньше отправки не было ни по Enter, ни
// по «Готово» на клавиатуре телефона, и это выглядело как «код не принят».
if (next.length === 6) void submit2fa(next);
}}
onKeyDown={(e) => { if (e.key === "Enter") void submit2fa(); }}
placeholder="000000"
className="card w-full px-4 py-3 mb-3 text-base tracking-widest bg-surface"
/>
<button className="btn-primary" disabled={busy || code.length < 6} onClick={() => submit2fa()}>
{busy ? <Spinner /> : "Подтвердить"}
</button>
{/* Не «Назад»: так называется кнопка над экраном, и уводит она с
экрана совсем. Эта — только к вводу логина и пароля. */}
<button className="btn-ghost mt-2" onClick={() => { setPartial(null); setCode(""); }}>
Изменить логин
</button>
</>
) : (
<>
<input
autoCapitalize="none"
autoCorrect="off"
value={username}
onChange={(e) => setUsername(e.target.value)}
placeholder="Логин"
className="card w-full px-4 py-3 mb-2 text-base bg-surface"
/>
<input
type="password"
value={password}
onChange={(e) => setPassword(e.target.value)}
onKeyDown={(e) => { if (e.key === "Enter") submit(); }}
placeholder="Пароль"
className="card w-full px-4 py-3 mb-3 text-base bg-surface"
/>
<button className="btn-primary" disabled={busy || !username || !password} onClick={submit}>
{busy ? <Spinner /> : "Войти"}
</button>
<button className="btn-ghost mt-2" onClick={toDriver}>Я водитель</button>
</>
)}
</div>
);
}
@@ -0,0 +1,113 @@
import { useQuery } from "@tanstack/react-query";
import { useNavigate, useParams } from "react-router-dom";
import { FileText, Gauge } from "lucide-react";
import { getFine } from "@/api/driver";
import { fineStatusText, isOwed } from "@/lib/fineStatus";
import { formatDate, formatMoney } from "@/lib/format";
import { Spinner } from "@/components/Spinner";
function Row({ k, v }: { k: string; v: string }) {
return (
<div className="flex justify-between gap-3 py-2 border-b border-line last:border-0">
<span className="text-muted text-xs shrink-0">{k}</span>
<span className="text-xs text-right">{v}</span>
</div>
);
}
/**
* Карточка штрафа. Главное здесь — фотография с камеры: по ней водитель узнаёт
* свою машину и свою поездку либо понимает, что штраф не его. Поэтому она стоит
* первой, до реквизитов, и открывается в полный размер по нажатию.
*
* Что парк заплатил ГИБДД, со скидкой ли и какой номинал у постановления — здесь
* не показывается: водителю нужен факт штрафа и сумма к возврату, а разбор
* расчётов парка уводит разговор от долга к внутренней кухне.
*/
export function FineDetailPage() {
const { fineId = "" } = useParams();
const nav = useNavigate();
const { data: f, isLoading, isError } = useQuery({
queryKey: ["fine", fineId],
queryFn: () => getFine(Number(fineId)),
});
if (isLoading) return <div className="flex justify-center py-16"><Spinner /></div>;
if (isError || !f) {
return (
<div className="pt-16 text-center">
<p className="text-sm font-semibold mb-1">Штраф не найден</p>
<p className="text-muted text-xs mb-6">Возможно, он больше не числится за вами.</p>
<button className="btn-ghost" onClick={() => nav("/", { replace: true })}>На главную</button>
</div>
);
}
return (
<div className="pt-2 pb-4">
{f.photos.length > 0 ? (
<div className="mb-4 space-y-2">
{f.photos.map((src, i) => (
<a key={src} href={src} target="_blank" rel="noopener noreferrer" className="block">
<img
src={src}
alt={`Фото нарушения ${i + 1}`}
loading="lazy"
className="w-full rounded-xl2 border border-line"
/>
</a>
))}
<p className="text-muted text-[11px]">Нажмите на фото, чтобы открыть в полном размере</p>
</div>
) : (
<p className="text-muted text-xs mb-4">
Фотографии по этому постановлению нет — её присылают не по всем нарушениям.
</p>
)}
<h1 className="text-base font-extrabold mb-1">{f.article}</h1>
<p className="text-muted text-xs mb-4">
{formatDate(f.date)}{f.address ? ` · ${f.address}` : ""}
</p>
<div className="card p-4 mb-4 text-center">
<p className="text-muted text-xs mb-1">Начислено вам</p>
<p className={`text-2xl font-extrabold ${isOwed(f) ? "text-neg" : ""}`}>
{formatMoney(f.amount)}
</p>
<p className="text-muted text-xs mt-1">{fineStatusText(f)}</p>
</div>
{f.speed != null && f.speed_limit != null && (
<div className="card p-4 mb-4 flex items-center gap-3">
<Gauge size={20} strokeWidth={1.5} className="text-muted shrink-0" />
<p className="text-sm">
{f.speed} км/ч при разрешённых {f.speed_limit}
{f.speed_excess ? ` — превышение на ${f.speed_excess}` : ""}
</p>
</div>
)}
<div className="card p-4 mb-4">
<Row k="Постановление" v={f.number} />
{f.post_date && <Row k="Дата постановления" v={formatDate(f.post_date)} />}
{f.car_number && <Row k="Автомобиль" v={f.car_number} />}
{f.camera && <Row k="Камера" v={f.camera} />}
</div>
{f.document && (
<a href={f.document} target="_blank" rel="noopener noreferrer"
className="btn-ghost flex items-center justify-center gap-2 no-underline mb-2">
<FileText size={16} /> Открыть постановление
</a>
)}
{isOwed(f) && (
<button className="btn-primary"
onClick={() => nav("/topup", { state: { bucket: "Долг по штрафам" } })}>
Оплатить штрафы
</button>
)}
</div>
);
}
@@ -0,0 +1,58 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { MemoryRouter, Route, Routes, useLocation } from "react-router-dom";
vi.mock("@/api/driver", () => ({
authRequest: vi.fn(async () => ({ status: "code_sent", channel: "tg" })),
authVerify: vi.fn(async () => ({ token: "T", driver_id: 7 })),
tgSession: vi.fn(async () => ({ pair_session: "sess123", deep_link: null })),
mtsStatus: vi.fn(async () => ({ enabled: false })),
}));
import { LoginPage } from "./LoginPage";
import * as driver from "@/api/driver";
import { useAuth } from "@/store/auth";
const wrap = () => render(<MemoryRouter><LoginPage /></MemoryRouter>);
describe("LoginPage", () => {
beforeEach(() => useAuth.getState().clear());
it("requests code then verifies and stores session", async () => {
wrap();
expect(screen.getByText(/Вход в приложение/i)).toBeInTheDocument();
await userEvent.click(screen.getByRole("button", { name: /Войти по коду/i }));
await userEvent.type(screen.getByLabelText(/Номер телефона/i), "9143054400");
await userEvent.click(screen.getByRole("button", { name: /Получить код/i }));
expect(driver.authRequest).toHaveBeenCalledWith("79143054400");
const codeInput = await screen.findByPlaceholderText(/код/i);
await userEvent.type(codeInput, "123456");
await userEvent.click(screen.getByRole("button", { name: /Войти/i }));
expect(driver.authVerify).toHaveBeenCalledWith("79143054400", "123456");
});
it("вход по коду — отдельный адрес, и из него есть «Назад» к выбору способа", async () => {
// Раньше режим жил в памяти экрана: ни кнопки, ни системного «назад» — с
// экрана ввода номера было не вернуться к Telegram.
function Where() {
const loc = useLocation();
return <p data-testid="where">{loc.pathname + loc.search}</p>;
}
render(
<MemoryRouter initialEntries={["/login"]}>
<Where />
<Routes><Route path="/login" element={<LoginPage />} /></Routes>
</MemoryRouter>
);
// На выборе способа «Назад» нет — это экран входа, возвращаться с него некуда.
expect(screen.queryByRole("button", { name: "Назад" })).toBeNull();
await userEvent.click(screen.getByRole("button", { name: /Войти по коду/i }));
expect(screen.getByTestId("where").textContent).toBe("/login?by=code");
expect(screen.getByLabelText(/Номер телефона/i)).toBeInTheDocument();
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
expect(screen.getByTestId("where").textContent).toBe("/login");
expect(screen.getByRole("button", { name: /Войти по коду/i })).toBeInTheDocument();
});
});
+244
View File
@@ -0,0 +1,244 @@
import { useEffect, useState } from "react";
import { useNavigate, useSearchParams } from "react-router-dom";
import { toast } from "sonner";
import { apiErrorText, authRequest, authVerify, mtsStatus, retryAfterSeconds, tgSession } from "@/api/driver";
import { digitsOnly, formatNational, nationalDigits } from "@/lib/format";
import { savePairing } from "@/lib/pairing";
import { takeReturnTo } from "@/lib/returnTo";
import { useAuth } from "@/store/auth";
import { Spinner } from "@/components/Spinner";
import { InstallHint } from "@/components/InstallHint";
import { BackButton } from "@/components/BackButton";
// Кулдаун повторной отправки кода — синхронно с бэкендом (60с). Точное значение
// приходит в Retry-After на 429; это дефолт после успешной отправки.
const RESEND_COOLDOWN_SEC = 60;
function fmtMMSS(sec: number): string {
const m = Math.floor(sec / 60);
const s = sec % 60;
return `${m}:${String(s).padStart(2, "0")}`;
}
export function LoginPage() {
const nav = useNavigate();
const setSession = useAuth((s) => s.setSession);
const [phone, setPhone] = useState(""); // national 10 digits
const [code, setCode] = useState("");
const [step, setStep] = useState<"phone" | "code">("phone");
const [channel, setChannel] = useState<string>("");
const [busy, setBusy] = useState(false);
// Вход по коду — отдельный шаг со своим адресом (/login?by=code), а не флаг в
// памяти: тогда и «Назад» в интерфейсе, и системный «назад» Android одинаково
// возвращают к выбору способа входа. Раньше выхода из этого режима не было.
const [params, setParams] = useSearchParams();
const mode: "choose" | "code" = params.get("by") === "code" ? "code" : "choose";
// Секунды до разрешённой повторной отправки кода (0 — можно отправлять).
const [cooldown, setCooldown] = useState(0);
// Prefetched pairing session so the «Войти через Telegram» control is a real
// <a href> the OS opens in Telegram (a synchronous user gesture) WITHOUT
// navigating the PWA away — the app stays mounted on /tg-wait and polls.
const [tg, setTg] = useState<{ pair_session: string; poll_secret: string;
confirm_code: string; deep_link: string | null } | null>(null);
// Вход по номеру через МТС ID. Пока креды оператора не заведены, способ
// выключен на бэкенде — и кнопки быть не должно: нажатие упиралось бы в 503.
const [mtsOn, setMtsOn] = useState(false);
const e164 = "7" + phone;
useEffect(() => {
let alive = true;
tgSession().then((r) => { if (alive) setTg(r); }).catch(() => {});
mtsStatus().then((r) => { if (alive) setMtsOn(r.enabled); }).catch(() => {});
return () => { alive = false; };
}, []);
// Тик обратного отсчёта повторной отправки.
useEffect(() => {
if (cooldown <= 0) return;
const t = setTimeout(() => setCooldown((s) => Math.max(0, s - 1)), 1000);
return () => clearTimeout(t);
}, [cooldown]);
function startTg() {
if (!tg) return;
savePairing(tg);
nav("/tg-wait");
}
async function requestCode() {
if (phone.length < 10 || cooldown > 0) return;
setBusy(true);
try {
const r = await authRequest(e164);
if (r.status === "onboarding") {
// Онбординг теперь идёт той же pairing-сессией: бот попросит поделиться
// контактом, Telegram подтвердит номер, приложение заберёт токен опросом.
// Второй раз номер вводить не нужно.
savePairing({ ...r, deep_link: r.deep_links.tg ?? null });
sessionStorage.setItem("pp-onboarding", JSON.stringify({ ...r.deep_links, phone }));
nav("/onboarding");
return;
}
setChannel(r.channel);
setStep("code");
// Запускаем отсчёт до повторной отправки — чтобы водитель не жал повторно
// раньше времени и не упирался в «слишком часто».
setCooldown(RESEND_COOLDOWN_SEC);
} catch (err: unknown) {
const status = (err as { response?: { status?: number } })?.response?.status;
if (status === 429) {
// Точный остаток — из Retry-After; ведём по нему отсчёт и не пугаем.
const wait = retryAfterSeconds(err) ?? RESEND_COOLDOWN_SEC;
setCooldown(wait);
if (step === "phone") setStep("code"); // код мог уйти ранее — дать ввести
toast.info(await apiErrorText(err, `Код уже отправляли. Повторить можно через ${wait} сек.`));
} else {
const fallback =
status === 404 ? "Номер не найден. Обратитесь в парк." :
"Не удалось отправить код";
toast.error(await apiErrorText(err, fallback));
}
} finally {
setBusy(false);
}
}
async function verify() {
if (code.length < 4) return;
setBusy(true);
try {
const r = await authVerify(e164, code);
setSession(r.token, r.driver_id);
// Возврат туда, откуда пришёл (напр. ссылка на оплату), иначе на баланс.
nav(takeReturnTo(), { replace: true });
} catch (err: unknown) {
toast.error(await apiErrorText(err, "Неверный или просроченный код"));
} finally {
setBusy(false);
}
}
return (
<div>
{mode === "code" && <BackButton to="/login" />}
<h1 className="text-xl font-extrabold mb-1 mt-16">Премиум Водитель</h1>
<p className="text-muted text-sm mb-8">Вход в приложение</p>
{mode === "choose" ? (
<>
{/* Основной способ — по номеру телефона: оператор подтверждает номер
сам, без установки мессенджера и без хождения в бота. Telegram
остался ЗАПАСНЫМ и намеренно неприметным: он бесплатный и работает
всегда, а оператор иногда не может доставить подтверждение (видели
22.09.2026 на Tele2) — без запасного пути человек в такой момент не
войдёт вообще никак.
Если МТС ID выключен на бэкенде, Telegram молча становится основным:
экрана без единой кнопки входа быть не должно. */}
{mtsOn ? (
<>
<button className="btn-primary" onClick={() => nav("/login/mts")}>
Войти по номеру телефона
</button>
<p className="text-muted text-xs mt-3">Ваш оператор связи подтвердит номер.</p>
{/* Именно ССЫЛКА, а не кнопка: Telegram открывается операционной
системой по синхронному нажатию на <a href>. Через onClick с
навигацией мессенджер не откроется — приложение молча уедет на
экран ожидания, а водитель так и останется смотреть на спиннер. */}
{tg?.deep_link && (
<a
href={tg.deep_link}
target="_blank"
rel="noopener noreferrer"
className="btn-ghost block text-center mt-4"
onClick={startTg}
>
Войти через Telegram
</a>
)}
</>
) : tg?.deep_link ? (
<>
<a
href={tg.deep_link}
target="_blank"
rel="noopener noreferrer"
className="btn-primary block text-center"
onClick={startTg}
>
Войти через Telegram
</a>
<p className="text-muted text-xs mt-3">Telegram подтвердит ваш номер автоматически.</p>
</>
) : (
<button className="btn-primary" disabled>
<Spinner />
</button>
)}
<button className="btn-ghost mt-2" onClick={() => setParams({ by: "code" })}>Войти по коду</button>
{/* Предложение установки — только на выборе способа входа: это первый
экран, который видит человек, открывший приложение впервые. На
экранах ввода номера и кода оно отвлекало бы от дела. */}
<InstallHint />
{/* Пока идёт обкатка, сотруднику надо попадать внутрь без карточки
водителя и без бота — учёткой CRM. Ссылка неприметная намеренно. */}
<button className="text-muted text-xs w-full mt-6" onClick={() => nav("/dev")}>
Вход для сотрудника
</button>
</>
) : (
<>
{step === "phone" ? (
<>
{/* +7 нарисован отдельным элементом и виден ВСЕГДА, в том числе на
пустом поле. Раньше префикс приходил из маски и появлялся только
после первой цифры — по пустому экрану было не понять, с какой
цифры начинать. <label> нужен, чтобы тап мимо цифр тоже попадал
в поле, а не в пустоту. */}
<label className="card w-full px-4 py-3 mb-3 bg-surface flex items-center gap-2 cursor-text">
<span className="select-none">+7</span>
<input
inputMode="numeric"
aria-label="Номер телефона"
placeholder="914 305-44-00"
value={formatNational(phone)}
onChange={(e) => setPhone(nationalDigits(e.target.value))}
className="flex-1 min-w-0 bg-transparent outline-none text-base"
/>
</label>
<button className="btn-primary" disabled={busy || phone.length < 10 || cooldown > 0} onClick={requestCode}>
{busy ? <Spinner /> : cooldown > 0 ? `Повторить через ${fmtMMSS(cooldown)}` : "Получить код"}
</button>
<p className="text-muted text-xs mt-3">Код придёт в Telegram или MAX.</p>
</>
) : (
<>
<p className="text-sm mb-2">Код отправлен в {channel === "max" ? "MAX" : "Telegram"}.</p>
<input
inputMode="numeric"
placeholder="Код из сообщения"
value={code}
onChange={(e) => setCode(digitsOnly(e.target.value).slice(0, 6))}
className="card w-full px-4 py-3 mb-3 text-base tracking-widest bg-surface"
/>
<button className="btn-primary" disabled={busy || code.length < 4} onClick={verify}>
{busy ? <Spinner /> : "Войти"}
</button>
{/* Повторная отправка прямо здесь: не пришёл код — не надо
возвращаться к номеру и упираться в «слишком часто». Кнопка
ждёт кулдаун и показывает, сколько осталось. */}
<button
className="btn-ghost mt-2"
disabled={busy || cooldown > 0}
onClick={requestCode}
>
{cooldown > 0 ? `Отправить ещё раз через ${fmtMMSS(cooldown)}` : "Отправить код ещё раз"}
</button>
<button className="btn-ghost mt-1" onClick={() => setStep("phone")}>Изменить номер</button>
</>
)}
</>
)}
</div>
);
}
@@ -0,0 +1,42 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { MemoryRouter, Route, Routes } from "react-router-dom";
vi.mock("@/api/driver", () => ({
mockPayOutcome: vi.fn(async () => ({ order_id: "mock-1", status: "PAID" })),
apiErrorText: vi.fn(async (_e: unknown, f: string) => f),
}));
import { MockPayPage } from "./MockPayPage";
import * as driver from "@/api/driver";
import { useAuth } from "@/store/auth";
const wrap = () =>
render(
<MemoryRouter initialEntries={["/mock-pay/mock-1"]}>
<Routes>
<Route path="/mock-pay/:orderId" element={<MockPayPage />} />
<Route path="/pay/:orderId" element={<p>экран оплаты</p>} />
</Routes>
</MemoryRouter>
);
describe("MockPayPage", () => {
beforeEach(() => { useAuth.getState().clear(); vi.clearAllMocks(); });
it("исход уходит на бэкенд и возвращает на настоящий экран оплаты", async () => {
useAuth.getState().setSession("t", 42, { impersonated: true, driverName: "Петров" });
wrap();
await userEvent.click(screen.getByRole("button", { name: /Банк отклонил/ }));
expect(driver.mockPayOutcome).toHaveBeenCalledWith("mock-1", "rejected");
expect(await screen.findByText("экран оплаты")).toBeInTheDocument();
});
it("водителю тут делать нечего", async () => {
useAuth.getState().setSession("t", 42);
wrap();
expect(screen.getByText(/Учебная оплата недоступна/)).toBeInTheDocument();
expect(driver.mockPayOutcome).not.toHaveBeenCalled();
});
});
@@ -0,0 +1,76 @@
import { useState } from "react";
import { useNavigate, useParams } from "react-router-dom";
import { toast } from "sonner";
import { apiErrorText, mockPayOutcome } from "@/api/driver";
import { useAuth } from "@/store/auth";
import { Spinner } from "@/components/Spinner";
/**
* Учебная «касса»: чем закончится платёж, который сотрудник создал под просмотром.
*
* Это подмена банка, а не экрана приложения. Настоящий экран оплаты
* (`/pay/:orderId`) остаётся тем же самым и разбирает те же статусы — иначе
* отладка проверяла бы поведение, которого у водителя не будет.
*/
const OUTCOMES = [
{ key: "paid", label: "Оплата прошла", hint: "PAID — экран «Оплачено»" },
{ key: "rejected", label: "Банк отклонил", hint: "REJECTED — «Оплата не прошла»" },
{ key: "expired", label: "Счёт протух", hint: "DEADLINE_EXPIRED — «Срок оплаты истёк»" },
{ key: "reversed", label: "Деньги вернулись", hint: "REVERSED — «Платёж возвращён»" },
] as const;
export function MockPayPage() {
const { orderId = "" } = useParams();
const nav = useNavigate();
const impersonated = useAuth((s) => s.impersonated);
const [busy, setBusy] = useState<string | null>(null);
async function choose(outcome: (typeof OUTCOMES)[number]["key"]) {
setBusy(outcome);
try {
await mockPayOutcome(orderId, outcome);
nav(`/pay/${orderId}`, { replace: true });
} catch (e: unknown) {
toast.error(await apiErrorText(e, "Не удалось разыграть исход"));
} finally {
setBusy(null);
}
}
if (!impersonated) {
return (
<div className="pt-24 text-center">
<p className="text-sm font-semibold mb-1">Учебная оплата недоступна</p>
<p className="text-muted text-xs mb-6">Этот экран работает только при просмотре сотрудником.</p>
<button className="btn-ghost" onClick={() => nav("/", { replace: true })}>На главную</button>
</div>
);
}
return (
<div className="pt-8">
<h1 className="text-lg font-extrabold mb-1">Учебная оплата</h1>
<p className="text-muted text-xs mb-5">
Банка в этом платеже нет: ни списания, ни чека, ни проводки. Выберите, что
«ответит» банк — приложение покажет ровно то же, что увидел бы водитель.
</p>
<div className="card divide-y divide-line">
{OUTCOMES.map((o) => (
<button
key={o.key}
disabled={busy !== null}
onClick={() => choose(o.key)}
className="w-full text-left px-4 py-3 flex items-center justify-between gap-3 disabled:opacity-50"
>
<span>
<span className="block text-sm font-semibold">{o.label}</span>
<span className="block text-muted text-xs">{o.hint}</span>
</span>
{busy === o.key && <Spinner />}
</button>
))}
</div>
<p className="text-muted text-xs mt-4">Заказ: {orderId}</p>
</div>
);
}
@@ -0,0 +1,133 @@
import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
import { render, screen, waitFor } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { MemoryRouter } from "react-router-dom";
const nav = vi.fn();
vi.mock("react-router-dom", async () => {
const actual = await vi.importActual<typeof import("react-router-dom")>("react-router-dom");
return { ...actual, useNavigate: () => nav };
});
vi.mock("@/api/driver", () => ({
mtsStart: vi.fn(),
mtsPoll: vi.fn(),
mtsCode: vi.fn(),
apiErrorText: vi.fn(async (_e: unknown, fallback: string) => fallback),
}));
import { MtsLoginPage } from "./MtsLoginPage";
import { BackProvider } from "@/components/BackBar";
import * as driver from "@/api/driver";
import { useAuth } from "@/store/auth";
const started = {
session: "S", poll_secret: "P", status: "pending", expires_in: 140, hhe_uri: null,
};
// Как в App: родителя экрана «Другой способ входа» берёт из таблицы маршрутов.
function wrap() {
return render(
<MemoryRouter initialEntries={["/login/mts"]}>
<BackProvider><MtsLoginPage /></BackProvider>
</MemoryRouter>
);
}
async function enterPhone(user: ReturnType<typeof userEvent.setup>) {
await user.type(screen.getByLabelText(/Номер телефона/i), "9143054400");
await user.click(screen.getByRole("button", { name: /Продолжить/i }));
}
describe("MtsLoginPage", () => {
beforeEach(() => {
vi.useFakeTimers({ shouldAdvanceTime: true });
useAuth.getState().clear();
nav.mockClear();
vi.mocked(driver.mtsStart).mockResolvedValue(started);
});
afterEach(() => vi.useRealTimers());
it("подтверждение push'ем: номер → ожидание → вход без кода", async () => {
const user = userEvent.setup({ advanceTimers: vi.advanceTimersByTime });
vi.mocked(driver.mtsPoll)
.mockResolvedValueOnce({ status: "pending" })
.mockResolvedValue({ status: "authenticated", token: "T", driver_id: 7 });
wrap();
await enterPhone(user);
// Номер уезжает в МТС в формате 7XXXXXXXXXX — оператор другого не принимает.
expect(driver.mtsStart).toHaveBeenCalledWith("79143054400");
expect(await screen.findByText(/Подтвердите вход на телефоне/i)).toBeInTheDocument();
await vi.advanceTimersByTimeAsync(5000);
await waitFor(() => expect(useAuth.getState().token).toBe("T"));
expect(useAuth.getState().driverId).toBe(7);
});
it("push не дошёл: появляется поле кода, код уходит в ту же сессию", async () => {
const user = userEvent.setup({ advanceTimers: vi.advanceTimersByTime });
vi.mocked(driver.mtsPoll).mockResolvedValue({ status: "sms_required" });
vi.mocked(driver.mtsCode).mockResolvedValue({ status: "pending" });
wrap();
await enterPhone(user);
await vi.advanceTimersByTimeAsync(2500);
const input = await screen.findByPlaceholderText(/Код из СМС/i);
await user.type(input, "1234");
await user.click(screen.getByRole("button", { name: /^Войти$/i }));
expect(driver.mtsCode).toHaveBeenCalledWith("S", "P", "1234");
// Код принят — экран возвращается к ожиданию, а не объявляет вход: итог
// придёт оператору колбэком, и его заберёт опрос.
expect(await screen.findByText(/Подтвердите вход на телефоне/i)).toBeInTheDocument();
});
it("отказ оператора ведёт в Telegram, а не в платный повтор", async () => {
// Каждая попытка через оператора платная. При сбое доставки водитель легко
// сожжёт несколько подряд, так и не войдя, — поэтому по умолчанию предлагаем
// бесплатный путь, а повтор оставляем второй кнопкой.
const user = userEvent.setup({ advanceTimers: vi.advanceTimersByTime });
vi.mocked(driver.mtsPoll).mockResolvedValue({
status: "failed", message: "Вход отклонён на телефоне.",
});
wrap();
await enterPhone(user);
await vi.advanceTimersByTimeAsync(2500);
expect(await screen.findByText(/Вход отклонён на телефоне/i)).toBeInTheDocument();
await user.click(screen.getByRole("button", { name: /Войти через Telegram/i }));
// К выбору способа (родитель /login/mts в routes.tsx) — заменой записи, а не
// новой поверх (здесь истории нет: MemoryRouter, как холодный старт).
expect(nav).toHaveBeenCalledWith("/login", { replace: true });
expect(useAuth.getState().token).toBeFalsy();
});
it("повтор по номеру всё же доступен — второй кнопкой", async () => {
const user = userEvent.setup({ advanceTimers: vi.advanceTimersByTime });
vi.mocked(driver.mtsPoll).mockResolvedValue({
status: "failed", message: "Вход отклонён на телефоне.",
});
wrap();
await enterPhone(user);
await vi.advanceTimersByTimeAsync(2500);
await user.click(screen.getByRole("button", { name: /Попробовать ещё раз/i }));
expect(await screen.findByLabelText(/Номер телефона/i)).toBeInTheDocument();
});
it("Seamless не используем: всплывающее окно не открываем", async () => {
// Отказались 22.09.2026. Запрос к оператору обязан уйти с устройства по HTTP,
// а мы по HTTPS: из кода это режет mixed content, остаётся всплывающее окно,
// которое установленное PWA даёт через раз. Две живые проверки не прошли, а
// выигрыш — секунды, не деньги. Тест сторожит, чтобы окно не вернулось молча.
const user = userEvent.setup({ advanceTimers: vi.advanceTimersByTime });
const open = vi.fn();
vi.stubGlobal("open", open);
vi.mocked(driver.mtsStart).mockResolvedValue({ ...started, hhe_uri: "http://he-mc.t2.ru/x?k=1" });
vi.mocked(driver.mtsPoll).mockResolvedValue({ status: "pending" });
wrap();
await enterPhone(user);
await vi.advanceTimersByTimeAsync(2500);
expect(open).not.toHaveBeenCalled();
vi.unstubAllGlobals();
});
});
@@ -0,0 +1,212 @@
import { useCallback, useEffect, useRef, useState } from "react";
import { useNavigate } from "react-router-dom";
import { toast } from "sonner";
import { apiErrorText, mtsCode, mtsPoll, mtsStart } from "@/api/driver";
import { digitsOnly, formatNational, nationalDigits } from "@/lib/format";
import { useRouteBack } from "@/lib/back";
import { takeReturnTo } from "@/lib/returnTo";
import { useAuth } from "@/store/auth";
import { Spinner } from "@/components/Spinner";
/**
* Вход по номеру телефона через МТС ID.
*
* Владение номером подтверждает оператор: поднимает push прямо на SIM-карте, а
* если push не дошёл — присылает СМС с кодом. Ответ оператора приезжает не нам
* в ответ на запрос, а отдельным колбэком на сервер, поэтому экран ОПРАШИВАЕТ
* сервер — ровно как экран ожидания Telegram.
*
* Поэтому же «Отправить код ещё раз» здесь нет: код шлёт оператор по своей
* логике, а не мы. Единственный способ повторить — начать вход заново.
*
* Seamless (вход вообще без кода, когда оператор узнаёт номер по заголовкам
* своей сети) НЕ используем — отказались 22.09.2026. Он требует, чтобы запрос к
* оператору ушёл с устройства по HTTP, а мы работаем по HTTPS: из кода такой
* запрос режет mixed content, и остаётся только всплывающее окно. В установленном
* PWA браузер его то даёт, то нет. Две живые проверки Seamless не прошли, а
* выигрыш — секунды, не деньги: авторизация тарифицируется за транзакцию
* независимо от способа. Адрес `hhe_uri` бэкенд по-прежнему сохраняет в сессии —
* как след для разбора и на случай, если МТС объяснит штатный способ для веба.
*/
const POLL_MS = 2000;
// Транзакция у МТС живёт ~140 секунд. Держим окно чуть шире: человеку ещё
// переключиться в СМС и набрать код. Дальше честно говорим «не дождались».
const GIVE_UP_MS = 180_000;
export function MtsLoginPage() {
const nav = useNavigate();
// К выбору способа входа (родитель в routes.tsx) — шагом назад, а не новой
// записью поверх истории: иначе системный «назад» Android возвращал бы сюда.
const toLogin = useRouteBack();
const setSession = useAuth((s) => s.setSession);
const [phone, setPhone] = useState("");
const [code, setCode] = useState("");
const [step, setStep] = useState<"phone" | "waiting" | "code">("phone");
const [busy, setBusy] = useState(false);
// Отказ оператора показываем ОТДЕЛЬНЫМ экраном, а не всплывашкой. Причина
// денежная: каждая попытка входа через оператора — платная операция, и при
// сбое доставки (видели 22.09.2026 на Tele2) водитель легко сожжёт несколько
// подряд, так и не войдя. Поэтому по умолчанию предлагаем бесплатный Telegram,
// а повтор оставляем второй, неприметной кнопкой.
const [failure, setFailure] = useState<string | null>(null);
const pair = useRef<{ session: string; secret: string } | null>(null);
const startedAt = useRef(0);
/** Вернуться к вводу номера. Без текста — это осознанная отмена, а не сбой. */
const reset = useCallback((message?: string) => {
pair.current = null;
setStep("phone");
setCode("");
setFailure(message ?? null);
}, []);
async function start() {
if (phone.length < 10) return;
setFailure(null);
setBusy(true);
try {
const r = await mtsStart("7" + phone);
pair.current = { session: r.session, secret: r.poll_secret };
startedAt.current = Date.now();
setStep("waiting");
} catch (err: unknown) {
const status = (err as { response?: { status?: number } })?.response?.status;
const fallback =
status === 404 ? "Номер не найден. Обратитесь в парк." :
status === 429 ? "Вход уже запрашивали. Подождите немного." :
"Не удалось начать вход";
toast.error(await apiErrorText(err, fallback));
} finally {
setBusy(false);
}
}
// Опрос идёт и на экране ожидания, и на экране ввода кода: подтверждение
// может прийти push'ем, пока человек ищет СМС, — и тогда код уже не нужен.
useEffect(() => {
if (step === "phone" || !pair.current) return;
let alive = true;
const timer = setInterval(async () => {
if (!alive || !pair.current) return;
if (Date.now() - startedAt.current > GIVE_UP_MS) {
reset("Не дождались подтверждения. Попробуйте ещё раз.");
return;
}
try {
const r = await mtsPoll(pair.current.session, pair.current.secret);
if (!alive) return;
if (r.status === "authenticated") {
pair.current = null;
setSession(r.token, r.driver_id);
nav(takeReturnTo(), { replace: true });
} else if (r.status === "sms_required") {
setStep("code");
} else if (r.status === "failed") {
reset(r.message);
} else if (r.status === "expired") {
reset("Время входа истекло. Попробуйте ещё раз.");
}
} catch {
// Сеть моргнула — просто ждём следующего тика. Опрос и так повторяется.
}
}, POLL_MS);
return () => { alive = false; clearInterval(timer); };
}, [step, nav, reset, setSession]);
async function sendCode() {
if (code.length < 4 || !pair.current) return;
setBusy(true);
try {
await mtsCode(pair.current.session, pair.current.secret, code);
// Код принят — дальше оператор досылает подтверждение колбэком, и его
// заберёт опрос. Возвращаем экран ожидания, а не «вы вошли».
setStep("waiting");
setCode("");
} catch (err: unknown) {
toast.error(await apiErrorText(err, "Код не принят"));
} finally {
setBusy(false);
}
}
return (
<div className="pt-16">
<h1 className="text-xl font-extrabold mb-1">Вход по номеру</h1>
<p className="text-muted text-sm mb-8">Номер подтвердит ваш оператор связи</p>
{step === "phone" && failure && (
<div className="text-center">
<p className="text-sm mb-1">{failure}</p>
<p className="text-muted text-xs mb-6">
Такое бывает, когда оператор не может доставить подтверждение.
</p>
<button className="btn-primary" onClick={toLogin}>
Войти через Telegram
</button>
<button className="btn-ghost mt-3" onClick={() => setFailure(null)}>
Попробовать ещё раз по номеру
</button>
</div>
)}
{step === "phone" && !failure && (
<>
{/* +7 виден всегда, даже на пустом поле — см. LoginPage. */}
<label className="card w-full px-4 py-3 mb-3 bg-surface flex items-center gap-2 cursor-text">
<span className="select-none">+7</span>
<input
inputMode="numeric"
aria-label="Номер телефона"
placeholder="914 305-44-00"
value={formatNational(phone)}
onChange={(e) => setPhone(nationalDigits(e.target.value))}
className="flex-1 min-w-0 bg-transparent outline-none text-base"
/>
</label>
<button className="btn-primary" disabled={busy || phone.length < 10} onClick={start}>
{busy ? <Spinner /> : "Продолжить"}
</button>
<p className="text-muted text-xs mt-3">
На телефон придёт запрос подтверждения. Если он не появится — пришлём СМС с кодом.
</p>
</>
)}
{step === "waiting" && (
<div className="text-center py-8">
<Spinner />
<p className="text-sm mt-4">Подтвердите вход на телефоне</p>
<p className="text-muted text-xs mt-2">
Запрос появится на экране. Если его нет — подождите, придёт СМС с кодом.
</p>
</div>
)}
{step === "code" && (
<>
<p className="text-sm mb-2">Код отправлен по СМС.</p>
<input
inputMode="numeric"
placeholder="Код из СМС"
value={code}
onChange={(e) => setCode(digitsOnly(e.target.value).slice(0, 6))}
className="card w-full px-4 py-3 mb-3 text-base tracking-widest bg-surface"
/>
<button className="btn-primary" disabled={busy || code.length < 4} onClick={sendCode}>
{busy ? <Spinner /> : "Войти"}
</button>
</>
)}
{step !== "phone" && (
<button className="btn-ghost mt-4" onClick={() => reset()}>
Изменить номер
</button>
)}
<button className="btn-ghost mt-2" onClick={toLogin}>
Другой способ входа
</button>
</div>
);
}
@@ -0,0 +1,48 @@
import { describe, it, expect, vi, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import { MemoryRouter } from "react-router-dom";
vi.mock("@/api/driver", () => ({
getNotifications: vi.fn(async () => ({
items: [
{ id: 2, kind: "fine", title: "Новый штраф", body: "Постановление от 18.08.2026.",
url: "/fines/12", created_at: "2026-08-18T10:15:00+10:00", read_at: null },
{ id: 1, kind: "topup", title: "Платёж получен", body: "Пополнение принято.",
url: "/", created_at: "2026-08-17T09:00:00+10:00", read_at: "2026-08-17T09:05:00+10:00" },
],
unread: 1,
})),
markNotificationsRead: vi.fn(async () => ({ marked: 1 })),
}));
import { NotificationsPage } from "./NotificationsPage";
import * as api from "@/api/driver";
const show = () => render(<MemoryRouter><NotificationsPage /></MemoryRouter>);
describe("лента уведомлений", () => {
beforeEach(() => vi.clearAllMocks());
it("показывает, что мы писали водителю", async () => {
show();
expect(await screen.findByText("Новый штраф")).toBeInTheDocument();
expect(screen.getByText("Платёж получен")).toBeInTheDocument();
// Дата человеку — ДД.ММ.ГГГГ, не ISO (текст постановления содержит её же).
expect(screen.getByText("18.08.2026 10:15")).toBeInTheDocument();
});
it("открытие ленты отмечает непрочитанное", async () => {
show();
await screen.findByText("Новый штраф");
// Это единственный честный источник отметки: пуш живёт до смахивания, а
// сообщение в боте тонет в переписке — там прочтения не видно вовсе.
expect(api.markNotificationsRead).toHaveBeenCalled();
});
it("без непрочитанного лишний запрос не делаем", async () => {
vi.mocked(api.getNotifications).mockResolvedValueOnce({ items: [], unread: 0 });
show();
expect(await screen.findByText(/Пока ничего не приходило/)).toBeInTheDocument();
expect(api.markNotificationsRead).not.toHaveBeenCalled();
});
});
@@ -0,0 +1,127 @@
import { useEffect, useState } from "react";
import { useNavigate } from "react-router-dom";
import { Bell } from "lucide-react";
import { getNotifications, markNotificationsRead, type DriverNotification } from "@/api/driver";
import { useBack } from "@/lib/back";
import { Spinner } from "@/components/Spinner";
import { OperationIcon } from "@/components/operationIcon";
// Значок берём тем же подбором, что и в выписке: событие приложения переводим
// в тег 1С, чтобы штраф в ленте выглядел так же, как штраф в списке операций.
const ICON_BY_KIND: Record<string, string> = {
fine: "Штраф ГИБДД",
topup: "Пополнение баланса",
};
/**
* Лента уведомлений водителя.
*
* Нужна не только водителю. Пуш живёт до первого смахивания, сообщение в боте
* тонет в переписке — и разговор «мне ничего не приходило» упирался в слово
* против слова. Здесь у водителя есть место, куда посмотреть, а у парка —
* честная отметка «прочитано»: она ставится ровно тогда, когда человек открыл
* этот экран или нажал на само уведомление, и ниоткуда больше.
*
* Отмечаем прочитанным ПОСЛЕ показа, а не при загрузке: иначе счётчик гаснет у
* того, кто просто мазнул по экрану и ушёл.
*/
export function NotificationsPage() {
const nav = useNavigate();
// Уведомление о платеже ведёт на главную — а главная и есть экран, с которого
// сюда пришли. Туда шагом назад, а не новой записью поверх: иначе системный
// «назад» Android возвращал бы в ленту.
const back = useBack("/");
const [items, setItems] = useState<DriverNotification[] | null>(null);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
let alive = true;
getNotifications()
.then((r) => {
if (!alive) return;
setItems(r.items);
if (r.unread > 0) void markNotificationsRead();
})
.catch(() => alive && setError("Не удалось загрузить уведомления"));
return () => {
alive = false;
};
}, []);
// Шапки с названием приложения здесь нет: сверху «Назад» (BackBar в App), под
// ним заголовок экрана — двух строк «откуда» и «где я» достаточно.
return (
<div>
<h1 className="text-lg font-bold mb-3">Уведомления</h1>
{error && <div className="text-sm text-muted">{error}</div>}
{!items && !error && <Spinner />}
{items && items.length === 0 && (
<div className="text-sm text-muted">
Пока ничего не приходило. Здесь будут появляться сообщения о штрафах и платежах.
</div>
)}
<div className="flex flex-col gap-2">
{items?.map((n) => (
<button
key={n.id}
type="button"
className="flex gap-3 items-start text-left bg-surface border border-line rounded-xl p-3"
onClick={() => n.url && (n.url === "/" ? back() : nav(n.url))}
>
<OperationIcon title={ICON_BY_KIND[n.kind] ?? ""} />
<span className="flex-1 min-w-0">
<span className="flex items-baseline gap-2">
<span className="font-semibold text-sm">{n.title}</span>
{!n.read_at && <span className="w-2 h-2 rounded-full bg-accent shrink-0" />}
</span>
<span className="block text-sm text-muted mt-0.5">{n.body}</span>
<span className="block text-xs text-muted mt-1">{when(n.created_at)}</span>
</span>
</button>
))}
</div>
</div>
);
}
/** Дата человеку — ДД.ММ.ГГГГ и время, без ISO. */
function when(ts: string | null): string {
if (!ts) return "";
const d = new Date(ts);
const p = (n: number) => String(n).padStart(2, "0");
return `${p(d.getDate())}.${p(d.getMonth() + 1)}.${d.getFullYear()} ${p(d.getHours())}:${p(d.getMinutes())}`;
}
/** Колокольчик со счётчиком непрочитанного — для шапки главного экрана. */
export function NotificationsBell() {
const nav = useNavigate();
const [unread, setUnread] = useState(0);
useEffect(() => {
let alive = true;
getNotifications()
.then((r) => alive && setUnread(r.unread))
// Молча: колокольчик — не тот элемент, ради которого стоит показывать ошибку.
.catch(() => undefined);
return () => {
alive = false;
};
}, []);
return (
<button type="button" className="relative p-1 -m-1" aria-label="Уведомления"
onClick={() => nav("/notifications")}>
<Bell size={22} strokeWidth={1.5} />
{unread > 0 && (
<span className="absolute -top-0.5 -right-0.5 min-w-4 h-4 px-1 rounded-full bg-accent
text-white text-[10px] leading-4 text-center">
{unread > 9 ? "9+" : unread}
</span>
)}
</button>
);
}
@@ -0,0 +1,42 @@
import { describe, it, expect, beforeEach } from "vitest";
import { render, screen } from "@testing-library/react";
import { MemoryRouter } from "react-router-dom";
import { OnboardingPage } from "./OnboardingPage";
import { savePairing, clearPairing } from "@/lib/pairing";
describe("OnboardingPage", () => {
beforeEach(() => {
clearPairing();
sessionStorage.setItem("pp-onboarding", JSON.stringify({ tg: "https://t.me/b?start=x", max: "https://max.ru/b?start=x", phone: "9143054400" }));
});
it("shows both bot links + back to login", () => {
render(<MemoryRouter><OnboardingPage /></MemoryRouter>);
expect(screen.getByText(/Подключите бот/i)).toBeInTheDocument();
expect(screen.getByRole("link", { name: /Telegram/i })).toHaveAttribute("href", "https://t.me/b?start=x");
expect(screen.getByRole("link", { name: /MAX/i })).toHaveAttribute("href", "https://max.ru/b?start=x");
expect(screen.getByRole("button", { name: /Назад ко входу/i })).toBeInTheDocument();
});
it("renders only Telegram when max is absent", () => {
sessionStorage.setItem("pp-onboarding", JSON.stringify({ tg: "https://t.me/ppdriver_bot?start=x", phone: "9143054400" }));
render(<MemoryRouter><OnboardingPage /></MemoryRouter>);
expect(screen.getByRole("link", { name: /Telegram/i })).toBeInTheDocument();
expect(screen.queryByRole("link", { name: /MAX/i })).toBeNull();
});
it("shows the confirm code the bot must repeat", () => {
// Защита от фишинга: если ссылку прислал посторонний, у человека этого числа
// на экране нет — значит и делиться номером не нужно.
savePairing({ pair_session: "S", poll_secret: "SEC", confirm_code: "4217", deep_link: "https://t.me/b?start=S" });
render(<MemoryRouter><OnboardingPage /></MemoryRouter>);
expect(screen.getByText("4217")).toBeInTheDocument();
});
it("no longer asks the driver to come back for a code", () => {
// Онбординг идёт той же pairing-сессией: Telegram подтверждает номер, и
// приложение забирает токен опросом — второй раз номер вводить не нужно.
render(<MemoryRouter><OnboardingPage /></MemoryRouter>);
expect(screen.queryByRole("button", { name: /запросить код/i })).toBeNull();
});
});
@@ -0,0 +1,52 @@
import { useNavigate } from "react-router-dom";
import { useRouteBack } from "@/lib/back";
import { loadPairing } from "@/lib/pairing";
export function OnboardingPage() {
const nav = useNavigate();
// Ко входу (родитель в routes.tsx) — шагом назад, а не новой записью поверх
// истории (см. lib/back).
const back = useRouteBack();
const raw = sessionStorage.getItem("pp-onboarding");
const data = raw ? (JSON.parse(raw) as { tg?: string; max?: string; phone: string }) : null;
const pairing = loadPairing();
if (!data) return null;
return (
<div className="pt-16">
<h1 className="text-xl font-extrabold mb-1">Подключите бот</h1>
<p className="text-muted text-sm mb-8">
Откройте бот и поделитесь своим номером — Telegram подтвердит его, и вход
произойдёт автоматически. Возвращаться за кодом не нужно.
</p>
{pairing?.confirmCode && (
<div className="card p-4 mb-6 text-center">
<p className="text-muted text-xs mb-1">Код подтверждения</p>
<p className="text-2xl font-extrabold tracking-widest">{pairing.confirmCode}</p>
<p className="text-muted text-xs mt-2">
Бот назовёт это число. Не совпало — закройте бот и не делитесь номером.
</p>
</div>
)}
{data.tg && (
<a
href={data.tg}
target="_blank"
rel="noopener"
className="btn-primary mb-3 no-underline block"
onClick={() => nav("/tg-wait")}
>
Подключить Telegram
</a>
)}
{data.max && (
<a href={data.max} target="_blank" rel="noopener" className="btn-ghost mb-6 no-underline block">
Подключить MAX
</a>
)}
<button className="btn-ghost" onClick={back}>
Назад ко входу
</button>
</div>
);
}
@@ -0,0 +1,49 @@
import { describe, it, expect, vi } from "vitest";
import { render, screen, waitFor } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import { MemoryRouter, Routes, Route, useNavigationType } from "react-router-dom";
const states = ["FORM", "PAID"];
vi.mock("@/api/driver", () => ({
getPaymentState: vi.fn(async () => ({ order_id: "o9", status: states.shift() ?? "PAID" })),
}));
import { PaymentPage } from "./PaymentPage";
function wrap() {
const qc = new QueryClient();
return render(
<QueryClientProvider client={qc}>
<MemoryRouter initialEntries={[{ pathname: "/pay/o9", state: { payUrl: "https://qr.nspk.ru/x", total: 1052, bucket: "Долг аренда", base: 1000 } }]}>
<Routes><Route path="/pay/:orderId" element={<PaymentPage />} /></Routes>
</MemoryRouter>
</QueryClientProvider>
);
}
describe("PaymentPage", () => {
it("shows pay button and flips to success on PAID", async () => {
wrap();
expect(screen.getByRole("link", { name: /Оплатить/i })).toHaveAttribute("href", "https://qr.nspk.ru/x");
await waitFor(() => expect(screen.getByText(/Оплачено/i)).toBeInTheDocument(), { timeout: 3000 });
});
it("с итога на главную — заменой записи, а не поверх «Оплачено»", async () => {
// Иначе системный «назад» с главной возвращал бы на отработавший итог.
function Home() {
return <p>главная: {useNavigationType()}</p>;
}
render(
<QueryClientProvider client={new QueryClient()}>
<MemoryRouter initialEntries={["/", "/pay/o9"]} initialIndex={1}>
<Routes>
<Route path="/" element={<Home />} />
<Route path="/pay/:orderId" element={<PaymentPage />} />
</Routes>
</MemoryRouter>
</QueryClientProvider>
);
await userEvent.click(await screen.findByRole("button", { name: "На главную" }, { timeout: 3000 }));
expect(await screen.findByText("главная: REPLACE")).toBeInTheDocument();
});
});
@@ -0,0 +1,140 @@
import { useEffect } from "react";
import { useLocation, useNavigate, useParams } from "react-router-dom";
import { useQueryClient } from "@tanstack/react-query";
import { Check, Clock, Undo2, WifiOff, X } from "lucide-react";
import { formatMoney } from "@/lib/format";
import { markPaymentActivity } from "@/lib/paymentWatch";
import { Spinner } from "@/components/Spinner";
import { usePaymentStatus } from "@/hooks/usePaymentStatus";
// платёж не состоялся, деньги не ушли — помогает только новая попытка.
// ATTEMPTS_EXPIRED — исчерпаны попытки ввода на форме банка, тот же исход для водителя
const FAILED = new Set(["REJECTED", "AUTH_FAIL", "ERROR", "CANCELED", "ATTEMPTS_EXPIRED"]);
// деньги дошли и вернулись обратно — новая попытка тут ни при чём, человеку нужен другой текст
const RETURNED = new Set(["REVERSED", "REFUNDED", "PARTIAL_REVERSED", "PARTIAL_REFUNDED"]);
// сколько неудач подряд терпим, прежде чем сказать вслух, что связи нет: ~15 секунд опроса.
// одиночный сбой пережидаем молча — следующий опрос обычно всё чинит
const FAIL_LIMIT = 10;
export function PaymentPage() {
const { orderId = "" } = useParams();
const nav = useNavigate();
const qc = useQueryClient();
const st = (useLocation().state as
{ payUrl?: string; total?: number; bucket?: string; base?: number; method?: string } | null) ?? {};
const { data, lastFailed, failStreak, refetch } = usePaymentStatus(orderId);
// Учебный платёж узнаётся по номеру заказа, а не по state роутера: state
// теряется при перезагрузке, а префикс — нет (см. backend mock_pay).
const mock = orderId.startsWith("mock-");
const status = data?.status ?? "";
const paid = status === "PAID";
// пока метод не передан в state — узнаём по ссылке: СБП отдаёт платёжку qr.nspk.ru, карта — форму банка
const card = st.method ? st.method === "card" : !!st.payUrl && !st.payUrl.includes("qr.nspk.ru");
useEffect(() => {
if (paid) {
// Отметка продлевает окно опроса баланса от ФАКТА оплаты: путь до нового
// итога (запись в 1С + снимок) начинается только теперь.
markPaymentActivity();
qc.invalidateQueries({ queryKey: ["balance"] });
}
}, [paid, qc]);
// С итога оплаты на главную — заменой записи: системный «назад» с главной не
// должен возвращать на отработавший экран «Оплачено».
const home = () => nav("/", { replace: true });
const retry = (
<button className="btn-primary mt-8" onClick={() => nav("/topup", { state: { bucket: st.bucket }, replace: true })}>
Пополнить ещё раз
</button>
);
if (paid) {
return (
<div className="pt-24 flex flex-col items-center text-center">
<span className="w-14 h-14 rounded-full bg-pos text-white flex items-center justify-center mb-3"><Check size={28} /></span>
<p className="text-lg font-extrabold">Оплачено</p>
<p className="text-muted text-xs mt-1">
{st.base != null ? `${st.bucket ?? "Баланс"} пополнен на ${formatMoney(st.base)}` : "Баланс пополнен"}
</p>
<button className="btn-primary mt-8" onClick={home}>На главную</button>
</div>
);
}
// без этих веток человек оставался на «Ожидаем оплату…» навсегда: опрос уже остановлен
if (status === "DEADLINE_EXPIRED") {
return (
<div className="pt-24 flex flex-col items-center text-center">
<span className="w-14 h-14 rounded-full bg-neg text-white flex items-center justify-center mb-3"><Clock size={28} /></span>
<p className="text-lg font-extrabold">Срок оплаты истёк</p>
<p className="text-muted text-xs mt-1">Счёт больше не действует. Деньги не списаны — создайте новый.</p>
{retry}
</div>
);
}
if (FAILED.has(status)) {
return (
<div className="pt-24 flex flex-col items-center text-center">
<span className="w-14 h-14 rounded-full bg-neg text-white flex items-center justify-center mb-3"><X size={28} /></span>
<p className="text-lg font-extrabold">Оплата не прошла</p>
<p className="text-muted text-xs mt-1">Банк не провёл перевод. Деньги не списаны — попробуйте ещё раз.</p>
{retry}
</div>
);
}
if (RETURNED.has(status)) {
return (
<div className="pt-24 flex flex-col items-center text-center">
<span className="w-14 h-14 rounded-full bg-neg text-white flex items-center justify-center mb-3"><Undo2 size={28} /></span>
<p className="text-lg font-extrabold">Платёж возвращён</p>
<p className="text-muted text-xs mt-1">Деньги вернулись на счёт, с которого платили. Баланс пересчитаем.</p>
<button className="btn-primary mt-8" onClick={home}>На главную</button>
</div>
);
}
// раньше упавший бэкенд выглядел ровно как честное ожидание оплаты — крутился спиннер.
// сам опрос не прекращаем: как только бэкенд ответит, экран вернётся к оплате
if (lastFailed && failStreak >= FAIL_LIMIT) {
return (
<div className="pt-24 flex flex-col items-center text-center">
<span className="w-14 h-14 rounded-full bg-muted text-white flex items-center justify-center mb-3"><WifiOff size={28} /></span>
<p className="text-lg font-extrabold">Не удаётся проверить оплату</p>
<p className="text-muted text-xs mt-1">Похоже, пропала связь. Если вы уже оплатили, деньги дойдут.</p>
<button className="btn-primary mt-8" onClick={() => refetch()}>Проверить ещё раз</button>
<button className="btn-ghost mt-3" onClick={home}>На главную</button>
</div>
);
}
return (
<div className="pt-10 flex flex-col items-center text-center">
<span className="px-4 py-2.5 rounded-xl2 bg-ink text-white text-sm font-extrabold mb-4">{card ? "Картой" : "СБП"}</span>
<div className="mb-6">
{/* после перезагрузки суммы в state нет: лучше не показать ничего, чем показать 0 ₽ */}
{st.total != null && <p className="text-lg font-extrabold">{formatMoney(st.total)}</p>}
{st.bucket && <p className="text-muted text-xs">{st.bucket}</p>}
</div>
{mock ? (
<>
<button className="btn-primary" onClick={() => nav(`/mock-pay/${orderId}`)}>
Выбрать исход
</button>
<p className="text-muted text-xs mt-2">Учебный платёж — банк не задействован</p>
</>
) : st.payUrl ? (
<>
<a className="btn-primary no-underline" href={st.payUrl} target="_blank" rel="noopener">Оплатить</a>
<p className="text-muted text-xs mt-2">Откроется ваше приложение банка</p>
</>
) : (
<p className="text-muted text-xs">Завершите оплату в приложении банка — экран обновится сам</p>
)}
<div className="flex items-center gap-2 mt-6 text-muted text-xs"><Spinner /> Ожидаем оплату…</div>
</div>
);
}
@@ -0,0 +1,57 @@
import { useEffect } from "react";
import { useNavigate } from "react-router-dom";
import { usePairPoll } from "@/hooks/usePairPoll";
import { clearPairing, loadPairing } from "@/lib/pairing";
import { takeReturnTo } from "@/lib/returnTo";
import { Spinner } from "@/components/Spinner";
export function TgWaitPage() {
const nav = useNavigate();
const pairing = loadPairing();
const { status } = usePairPoll(pairing?.pairSession ?? null, pairing?.pollSecret ?? null);
useEffect(() => {
if (!pairing) { nav("/login", { replace: true }); }
}, [pairing, nav]);
useEffect(() => {
if (status === "authenticated") {
clearPairing();
// Возврат туда, откуда пришёл (напр. ссылка на оплату), иначе на баланс.
nav(takeReturnTo(), { replace: true });
}
if (status === "expired") {
clearPairing();
nav("/login", { replace: true, state: { expired: true } });
}
}, [status, nav]);
return (
<div className="pt-16 text-center">
<h1 className="text-xl font-extrabold mb-2">Премиум Водитель</h1>
<p className="text-muted text-sm mb-6">
Бот назовёт число ниже и попросит подтвердить вход — нажмите «Это я, войти»
(или поделитесь номером, если входите впервые). Затем вернитесь сюда, вход
произойдёт автоматически.
</p>
{pairing?.confirmCode && (
// Число сверки: бот называет его в своём сообщении. Если человек попал в
// бот по чужой ссылке, у него на экране этого числа нет — подтверждать
// нечего, и токен не выдаётся.
<div className="card p-4 mb-6">
<p className="text-muted text-xs mb-1">Код подтверждения</p>
<p className="text-2xl font-extrabold tracking-widest">{pairing.confirmCode}</p>
<p className="text-muted text-xs mt-2">
Это же число должен назвать бот. Не совпало — нажмите в боте «Это не я».
</p>
</div>
)}
{pairing?.deepLink && (
<a href={pairing.deepLink} target="_blank" rel="noopener noreferrer" className="btn-primary block text-center mb-6">
Открыть Telegram
</a>
)}
<Spinner />
</div>
);
}
@@ -0,0 +1,114 @@
import { describe, it, expect, vi } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { MemoryRouter, Route, Routes, useNavigate } from "react-router-dom";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
vi.mock("@/api/driver", () => ({
topup: vi.fn(async () => ({ order_id: "o9", pay_url: "https://qr.nspk.ru/x", commission: 52,
total: 1052, mock: false })),
getCommission: vi.fn(async () => ({ rate: 0.052 })),
getBuckets: vi.fn(async () => ({
buckets: ["Долг аренда", "Долг по штрафам"], with_debt: ["Долг аренда"],
})),
apiErrorText: vi.fn(async (_e: unknown, fallback: string) => fallback),
}));
import { TopupPage } from "./TopupPage";
import * as driver from "@/api/driver";
const wrap = () => {
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
return render(
<QueryClientProvider client={qc}>
<MemoryRouter><TopupPage /></MemoryRouter>
</QueryClientProvider>
);
};
describe("TopupPage", () => {
it("keypad builds amount, shows total, and submits topup", async () => {
wrap();
await userEvent.click(screen.getByRole("button", { name: "1" }));
await userEvent.click(screen.getByRole("button", { name: "0" }));
await userEvent.click(screen.getByRole("button", { name: "0" }));
await userEvent.click(screen.getByRole("button", { name: "0" }));
expect(screen.getByTestId("amount").textContent).toBe("1 000 ₽");
expect(screen.getByTestId("total").textContent).toContain("1 052");
await userEvent.click(screen.getByRole("button", { name: /Оплатить/i }));
expect(driver.topup).toHaveBeenCalledWith("Долг аренда", 1000, "qr", false);
});
it("decimal key builds kopecks and they reach the backend", async () => {
// Клавиша разделителя была нарисована, но ничего не делала: заплатить точный
// долг вроде 1234,56 было нечем.
wrap();
for (const k of ["1", "0", "0", ",", "5", "2"]) {
await userEvent.click(screen.getByRole("button", { name: k }));
}
expect(screen.getByTestId("amount").textContent).toBe("100,52 ₽");
await userEvent.click(screen.getByRole("button", { name: /Оплатить/i }));
expect(driver.topup).toHaveBeenCalledWith("Долг аренда", 100.52, "qr", false);
});
it("lets the driver choose the debt category instead of hardcoding rent", async () => {
wrap();
await screen.findByRole("button", { name: "Долг по штрафам" });
await userEvent.click(screen.getByRole("button", { name: "Долг по штрафам" }));
await userEvent.click(screen.getByRole("button", { name: "5" }));
await userEvent.click(screen.getByRole("button", { name: "0" }));
await userEvent.click(screen.getByRole("button", { name: "0" }));
await userEvent.click(screen.getByRole("button", { name: /Оплатить/i }));
expect(driver.topup).toHaveBeenCalledWith("Долг по штрафам", 500, "qr", false);
});
it("платёж создан — «Назад» с оплаты не возвращает к набору суммы", async () => {
// Экран оплаты подменяет клавиатуру в истории: шаг назад с него ведёт туда,
// откуда пришли пополнять, а не к уже отработавшей форме.
function StepBack() {
const nav = useNavigate();
return <button onClick={() => nav(-1)}>шаг назад</button>;
}
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
render(
<QueryClientProvider client={qc}>
<MemoryRouter initialEntries={["/", "/topup"]} initialIndex={1}>
<Routes>
<Route path="/" element={<p>главная</p>} />
<Route path="/topup" element={<TopupPage />} />
<Route path="/pay/:orderId" element={<StepBack />} />
</Routes>
</MemoryRouter>
</QueryClientProvider>
);
for (const k of ["5", "0", "0"]) await userEvent.click(screen.getByRole("button", { name: k }));
await userEvent.click(screen.getByRole("button", { name: /Оплатить/i }));
await userEvent.click(await screen.findByRole("button", { name: "шаг назад" }));
expect(await screen.findByText("главная")).toBeInTheDocument();
});
});
describe("боевая оплата под просмотром", () => {
it("по умолчанию платёж учебный — флаг в запрос уходит выключенным", async () => {
const { useStaff } = await import("@/store/staff");
useStaff.getState().clear();
wrap();
await userEvent.click(screen.getByRole("button", { name: "5" }));
await userEvent.click(screen.getByRole("button", { name: "0" }));
await userEvent.click(screen.getByRole("button", { name: "0" }));
await userEvent.click(screen.getByRole("button", { name: /Оплатить/i }));
expect(driver.topup).toHaveBeenLastCalledWith("Долг аренда", 500, "qr", false);
});
it("включённая боевая оплата предупреждает и уходит с флагом", async () => {
const { useStaff } = await import("@/store/staff");
useStaff.getState().setLivePay(true);
wrap();
expect(screen.getByText(/деньги спишутся по-настоящему/i)).toBeInTheDocument();
await userEvent.click(screen.getByRole("button", { name: "5" }));
await userEvent.click(screen.getByRole("button", { name: "0" }));
await userEvent.click(screen.getByRole("button", { name: "0" }));
await userEvent.click(screen.getByRole("button", { name: /Оплатить/i }));
expect(driver.topup).toHaveBeenLastCalledWith("Долг аренда", 500, "qr", true);
useStaff.getState().clear();
});
});
+138
View File
@@ -0,0 +1,138 @@
import { useState } from "react";
import { useLocation, useNavigate } from "react-router-dom";
import { useQuery } from "@tanstack/react-query";
import { Delete } from "lucide-react";
import { toast } from "sonner";
import { apiErrorText, topup, getCommission, getBuckets } from "@/api/driver";
import { keypadReduce, parseAmount, withCommission } from "@/lib/amount";
import { formatMoney } from "@/lib/format";
import { markPaymentActivity } from "@/lib/paymentWatch";
import { useStaff } from "@/store/staff";
import { Segment } from "@/components/Segment";
import { Spinner } from "@/components/Spinner";
const QUICK = ["500", "1000", "2000"];
const KEYS = ["1", "2", "3", "4", "5", "6", "7", "8", "9", ",", "0", "back"];
export function TopupPage() {
const nav = useNavigate();
const livePay = useStaff((s) => s.livePay);
const loc = useLocation();
const fromBalance = (loc.state as { bucket?: string } | null)?.bucket;
// Список категорий приходит с сервера — там же он и проверяется. Хардкод
// «Долг аренда» отправлял платёж в аренду даже тем, у кого её нет.
const { data: bucketData } = useQuery({ queryKey: ["buckets"], queryFn: getBuckets });
const options = bucketData?.buckets ?? (fromBalance ? [fromBalance] : []);
const [picked, setPicked] = useState<string | null>(null);
const bucket = picked ?? fromBalance ?? bucketData?.with_debt[0] ?? options[0] ?? "";
const [raw, setRaw] = useState("");
const [method, setMethod] = useState("qr");
const [busy, setBusy] = useState(false);
const { data: commission } = useQuery({ queryKey: ["commission"], queryFn: getCommission });
const rate = commission?.rate ?? 0.052; // fallback only while loading
const base = parseAmount(raw);
const { commission: fee, total } = withCommission(base, rate);
function press(k: string) {
setRaw((r) => keypadReduce(r, k));
}
async function pay() {
if (base <= 0 || !bucket || busy) return;
setBusy(true);
try {
const r = await topup(bucket, base, method as "qr" | "card", livePay);
// Платёж уже создан — клавиатура суммы своё отработала. Уходим с неё
// заменой записи: «Назад» с оплаты ведёт на экран, откуда пришли
// пополнять, а не к повторному набору той же суммы.
// Учебный платёж (сотрудник смотрит от чужого лица): банка нет, платить
// негде — сразу на экран выбора исхода, дальше всё как у водителя.
if (r.mock) {
nav(`/mock-pay/${r.order_id}`, { replace: true, state: { total: r.total, bucket, base, method } });
return;
}
// Отметка ДО ухода на оплату: вернись водитель на баланс жестом «назад»
// раньше вебхука банка, экран обязан опрашивать себя и подхватить платёж.
markPaymentActivity();
nav(`/pay/${r.order_id}`, {
replace: true,
state: { payUrl: r.pay_url, total: r.total, bucket, base, method },
});
} catch (err: unknown) {
// Текст с сервера, а не глухое «не удалось»: минимум СБП, потолок суммы и
// неизвестная категория объясняются словами, иначе экран молча не реагирует.
toast.error(await apiErrorText(err, "Не удалось создать платёж"));
} finally {
setBusy(false);
}
}
return (
<div className="pt-2">
{/* Категорию выбирают в шторке на главном экране. Пришли оттуда — показываем
выбранное строкой, а не рядом чипов: второй выбор того же самого сбивает
с толку. Чипы остаются для входа сюда напрямую (кнопка «Пополнить» без
категории, возврат «пополнить ещё раз» с экрана оплаты). */}
{fromBalance ? (
<p className="text-muted text-xs mb-3">Пополняем: <b className="text-ink">{bucket}</b></p>
) : options.length > 1 ? (
<div className="flex gap-1.5 mb-3 overflow-x-auto">
{options.map((b) => (
<button
key={b}
onClick={() => setPicked(b)}
className={`shrink-0 px-3 py-2 rounded-xl2 text-xs border ${
b === bucket ? "border-line bg-surface font-semibold" : "border-line text-muted"
}`}
>
{b}
</button>
))}
</div>
) : null}
<p data-testid="amount" className="text-3xl font-extrabold text-center mt-2">{formatMoney(base)}</p>
<p data-testid="total" className="text-muted text-xs text-center mb-3">
к оплате {formatMoney(total)} (комиссия {formatMoney(fee)})
</p>
<div className="flex gap-1.5 mb-3">
{QUICK.map((q) => (
<button key={q} className="flex-1 py-2 rounded-xl2 text-xs bg-surface border border-line" onClick={() => setRaw(q)}>
{q}
</button>
))}
</div>
<div className="grid grid-cols-3 gap-2 mb-4">
{KEYS.map((k) => (
<button
key={k}
aria-label={k}
className="bg-surface border border-line rounded-xl2 py-3 text-lg font-semibold flex items-center justify-center"
onClick={() => press(k)}
>
{k === "back" ? <Delete size={18} /> : k}
</button>
))}
</div>
<div className="mb-4">
<Segment value={method} onChange={setMethod} options={[{ value: "qr", label: "СБП" }, { value: "card", label: "Картой" }]} />
</div>
{livePay && (
// Предупреждение прямо над кнопкой: под чужим лицом ошибиться легко, а
// отыграть боевой платёж — это возврат в банке и правка в 1С.
<p className="text-neg text-xs mb-2 text-center">
Боевая оплата: деньги спишутся по-настоящему и зачислятся водителю
</p>
)}
<button className="btn-primary" disabled={busy || base <= 0 || !bucket} onClick={pay}>
{busy ? <Spinner /> : "Оплатить"}
</button>
</div>
);
}
+146
View File
@@ -0,0 +1,146 @@
import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
import { cleanup, render, screen } from "@testing-library/react";
import { MemoryRouter, useLocation } from "react-router-dom";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import App from "@/App";
import appSource from "@/App.tsx?raw";
import { ROUTES, findRoute, resolveParent } from "@/routes";
import { clearPairing, savePairing } from "@/lib/pairing";
import { useAuth } from "@/store/auth";
import { useStaff } from "@/store/staff";
/**
* Сторож правила «Назад на каждом экране» (задача 6385, см. CLAUDE.md).
*
* Ходит по ТОЙ ЖЕ таблице, из которой App рисует маршруты: новый экран попадает
* под проверку сам. Сеть при этом висит вечно — экраны застревают в загрузке, а
* именно в таких состояниях кнопку раньше и теряли (голый спиннер карточки
* штрафа, пустой онбординг).
*/
/** Единственные экраны без «Назад»: главная и вход. Новый экран сюда не
* добавляют — ему заводят родителя в routes.tsx. */
const ROOTS = ["/", "/login"];
/** Адрес-образец: параметры пути заменяем единицей (/fines/:fineId → /fines/1). */
const sample = (path: string) => path.replace(/:[^/]+/g, "1");
/** Исходники приложения, кроме тестов и App: <Route> там быть не должно. */
const sources = import.meta.glob<string>(["./**/*.tsx", "!./**/*.test.tsx", "!./App.tsx"], {
query: "?raw",
import: "default",
eager: true,
});
/** Комментарии упоминают <Route> словами — проверяем только код. */
function stripComments(src: string): string {
return src.replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*\/\/.*$/gm, "");
}
function Where() {
return <p data-testid="where">{useLocation().pathname}</p>;
}
function renderAt(url: string) {
const qc = new QueryClient({ defaultOptions: { queries: { retry: false } } });
return render(
<QueryClientProvider client={qc}>
<MemoryRouter initialEntries={[url]}>
<Where />
<App />
</MemoryRouter>
</QueryClientProvider>
);
}
describe("«Назад» на каждом экране", () => {
beforeEach(() => {
// Любой запрос (ky ходит через глобальный fetch) не отвечает никогда.
vi.stubGlobal("fetch", vi.fn(() => new Promise<Response>(() => {})));
window.history.replaceState(null, "", "/");
// Пускаем всюду: водитель под просмотром сотрудника проходит и RequireAuth,
// и RequireStaff, и учебную оплату; сессия Telegram держит экран ожидания.
useAuth.getState().setSession("t", 42, { impersonated: true, driverName: "Проверка" });
useStaff.getState().setStaff("s", "staff");
savePairing({ pair_session: "S", poll_secret: "P", confirm_code: "1234", deep_link: null });
});
afterEach(() => {
// Сначала размонтировать: иначе сброс входа ниже гонит смонтированный экран
// на /login мимо act().
cleanup();
vi.unstubAllGlobals();
useAuth.getState().clear();
useStaff.getState().clear();
clearPairing();
});
it.each(ROUTES.map((r) => [r.path, r] as const))("%s", (_path, r) => {
// Экраны входа пускают только того, кто ещё не вошёл.
if (r.guard === "guest") useAuth.getState().clear();
const url = sample(r.path);
renderAt(url);
// Проверяем сам экран, а не тот, куда увела охрана маршрута.
expect(screen.getByTestId("where").textContent).toBe(url);
const back = screen.queryAllByRole("button", { name: "Назад" });
// Ровно одна: две кнопки с одним именем и разным поведением путают.
expect(back).toHaveLength(r.parent === null ? 0 : 1);
});
it.each(ROUTES.filter((r) => r.guard === "guest").map((r) => r.path))(
"вошедшего %s уводит на главную",
(path) => {
// Так «Назад» после входа по ссылке не возвращает к отработавшему входу.
renderAt(path);
expect(screen.getByTestId("where").textContent).toBe("/");
}
);
it("родителя нет только у главной и входа", () => {
const roots = ROUTES.filter((r) => r.parent === null).map((r) => r.path);
expect(roots.sort()).toEqual([...ROOTS].sort());
});
it("адрес находит свой же экран, а родитель — другой существующий", () => {
for (const r of ROUTES) {
const hit = findRoute(sample(r.path));
// BackBar должен взять тот же экран, что нарисовал <Routes>.
expect(hit?.route, r.path).toBe(r);
if (r.parent === null) continue;
for (const signedIn of [true, false]) {
const to = resolveParent(r.parent, { params: hit!.params, search: new URLSearchParams(), signedIn });
const target = findRoute(to.split("?")[0]);
// Опечатка в родителе или родитель-сам-себе: с холодного старта «Назад»
// заменил бы экран им же — кнопка есть, а уйти нельзя.
expect(target, `${r.path} → ${to}`).not.toBeNull();
expect(target!.route, `${r.path} → ${to}`).not.toBe(r);
}
}
});
it("родитель может зависеть от входа: вход сотрудника ведёт туда, откуда пришли", () => {
const hit = findRoute("/dev");
expect(hit).not.toBeNull();
const ctx = { params: hit!.params, search: new URLSearchParams() };
// Уже вошёл водителем (долгий тап с главной) — на главную; нет — ко входу.
expect(resolveParent(hit!.route.parent!, { ...ctx, signedIn: true })).toBe("/");
expect(resolveParent(hit!.route.parent!, { ...ctx, signedIn: false })).toBe("/login");
});
it("App рисует экраны только из таблицы маршрутов", () => {
// <Route>, вписанный в App мимо таблицы, остался бы без «Назад» и без
// проверки выше. Разрешены только ROUTES.map и перехват неизвестных адресов.
const code = stripComments(appSource);
expect(code.match(/<Route\s/g)).toHaveLength(2);
expect(code).toContain("<Route key={r.path} path={r.path}");
expect(code).toContain('<Route path="*"');
});
it("вложенных <Routes> в страницах и компонентах нет", () => {
// Экран, заведённый внутри страницы, тоже прошёл бы мимо таблицы.
const nested = Object.entries(sources)
.filter(([, src]) => /<Routes?[\s>/]/.test(stripComments(src)))
.map(([file]) => file);
expect(Object.keys(sources).length).toBeGreaterThan(10);
expect(nested).toEqual([]);
});
});
+81
View File
@@ -0,0 +1,81 @@
import type { ReactNode } from "react";
import { matchRoutes, type Params } from "react-router-dom";
import type { BackMode } from "@/lib/back";
import { LoginPage } from "@/pages/LoginPage";
import { MtsLoginPage } from "@/pages/MtsLoginPage";
import { TgWaitPage } from "@/pages/TgWaitPage";
import { OnboardingPage } from "@/pages/OnboardingPage";
import { BalancePage } from "@/pages/BalancePage";
import { TopupPage } from "@/pages/TopupPage";
import { PaymentPage } from "@/pages/PaymentPage";
import { DevLoginPage } from "@/pages/DevLoginPage";
import { DebugPage } from "@/pages/DebugPage";
import { MockPayPage } from "@/pages/MockPayPage";
import { FineDetailPage } from "@/pages/FineDetailPage";
import { NotificationsPage } from "@/pages/NotificationsPage";
import { BonusesPage } from "@/pages/BonusesPage";
/** Что известно при выборе родителя: параметры пути, строка запроса, вход. */
export interface ParentCtx {
params: Params;
search: URLSearchParams;
/** Есть токен водителя — свой вход или просмотр сотрудником. */
signedIn: boolean;
}
/** Куда ведёт «Назад», когда в истории этого запуска позади ничего нет.
* null — только у главной и у экранов входа: там кнопки «Назад» нет. */
export type Parent = string | ((ctx: ParentCtx) => string) | null;
export interface AppRoute {
path: string;
element: ReactNode;
/** Обязателен: экран без родителя не соберётся. См. CLAUDE.md приложения. */
parent: Parent;
/** "auth" — только вошедшему водителю, "staff" — ещё и только сотруднику,
* "guest" — экран входа: вошедшего уводит на главную (см. GuestOnly в App). */
guard?: "auth" | "staff" | "guest";
/** По умолчанию «Назад» идёт шагом по истории — см. BackMode. */
back?: BackMode;
}
/**
* Все экраны приложения — единственный источник и для <Routes> в App, и для
* кнопки «Назад» (BackBar), и для теста-сторожа, который проверяет её на каждом.
*/
export const ROUTES: AppRoute[] = [
{ path: "/", element: <BalancePage />, guard: "auth", parent: null },
{ path: "/login", element: <LoginPage />, guard: "guest", parent: null },
{ path: "/login/mts", element: <MtsLoginPage />, guard: "guest", parent: "/login" },
{ path: "/tg-wait", element: <TgWaitPage />, guard: "guest", parent: "/login" },
{ path: "/onboarding", element: <OnboardingPage />, guard: "guest", parent: "/login" },
// Сотрудник, уже вошедший водителем, попадает сюда долгим тапом с главной —
// туда и возвращаем; без входа возвращаться некуда, кроме экрана входа.
{ path: "/dev", element: <DevLoginPage />, parent: ({ signedIn }) => (signedIn ? "/" : "/login") },
{ path: "/notifications", element: <NotificationsPage />, guard: "auth", parent: "/" },
// Бонусы открывают карточкой с главной и пушем «Бонус начислен» — оба
// случая возвращаются на главную.
{ path: "/bonuses", element: <BonusesPage />, guard: "auth", parent: "/" },
{ path: "/topup", element: <TopupPage />, guard: "auth", parent: "/" },
{ path: "/pay/:orderId", element: <PaymentPage />, guard: "auth", parent: "/" },
{ path: "/mock-pay/:orderId", element: <MockPayPage />, guard: "auth", parent: "/" },
// Карточку открывают из списка штрафов — к нему и возвращаем, даже если её
// открыли пушем «Новый штраф» с холодного старта.
{ path: "/fines/:fineId", element: <FineDetailPage />, guard: "auth", parent: "/?kind=fines" },
// Экран «Бонусы» спрятан до поэтапного внедрения (октябрь 2026). Старые
// push-ссылки /bonuses ловит catch-all в App и ведут на главную.
{ path: "/debug", element: <DebugPage />, guard: "staff", parent: "/" },
];
/** Маршрут из таблицы, под который попадает адрес, — с параметрами пути. */
export function findRoute(pathname: string): { route: AppRoute; params: Params } | null {
// Тем же ранжированием, что у <Routes> (статичный сегмент сильнее параметра),
// а не первым совпадением по порядку таблицы: иначе «Назад» взял бы родителя
// не того экрана, что нарисован.
const hit = matchRoutes(ROUTES, pathname)?.[0];
return hit ? { route: hit.route, params: hit.params } : null;
}
export function resolveParent(parent: Exclude<Parent, null>, ctx: ParentCtx): string {
return typeof parent === "function" ? parent(ctx) : parent;
}
+79
View File
@@ -0,0 +1,79 @@
import { create } from "zustand";
import { persist } from "zustand/middleware";
/** Кем открыт сеанс: сам водитель или сотрудник, смотрящий от его лица.
* Признак приезжает из токена (claim `imp`), здесь он только продублирован для
* интерфейса — проверять его на бэкенде по этому полю нельзя и не нужно. */
export interface ViewAs {
impersonated: boolean;
/** ФИО водителя — показывать в плашке. У обычного входа неизвестно и не нужно. */
driverName: string | null;
}
/** Собственный сеанс, отложенный на время просмотра чужого. */
interface OwnSession {
token: string;
driverId: number | null;
}
interface AuthState extends ViewAs {
token: string | null;
driverId: number | null;
/** Сеанс, к которому вернёт «выйти из просмотра». null — возвращаться некуда. */
own: OwnSession | null;
setSession: (token: string, driverId: number, view?: Partial<ViewAs>) => void;
/** Начать просмотр от лица водителя, отложив собственный вход. */
startImpersonation: (token: string, driverId: number, driverName: string) => void;
/** Вернуться к себе. true — вернулись, false — своего входа не было. */
stopImpersonation: () => boolean;
clear: () => void;
}
export const useAuth = create<AuthState>()(
persist(
(set, get) => ({
token: null,
driverId: null,
impersonated: false,
driverName: null,
own: null,
setSession: (token, driverId, view) =>
set({
token,
driverId,
impersonated: view?.impersonated ?? false,
driverName: view?.driverName ?? null,
}),
startImpersonation: (token, driverId, driverName) => {
const s = get();
// Свой вход откладываем ОДИН раз — при переходе из обычного сеанса. Смена
// водителя внутри просмотра не должна затирать отложенное собственным
// чужим токеном, иначе «вернуться к себе» вернёт к предыдущему водителю.
const own = s.impersonated
? s.own
: s.token
? { token: s.token, driverId: s.driverId }
: null;
set({ token, driverId, impersonated: true, driverName, own });
},
stopImpersonation: () => {
const own = get().own;
if (!own) {
set({ token: null, driverId: null, impersonated: false, driverName: null });
return false;
}
set({
token: own.token,
driverId: own.driverId,
impersonated: false,
driverName: null,
own: null,
});
return true;
},
clear: () =>
set({ token: null, driverId: null, impersonated: false, driverName: null, own: null }),
}),
{ name: "pp-driver-auth" }
)
);
+36
View File
@@ -0,0 +1,36 @@
import { create } from "zustand";
import { persist } from "zustand/middleware";
/**
* Сеанс СОТРУДНИКА — учётка CRM, которой берут просмотр от лица водителя.
*
* Хранится отдельно от водительского: это два разных токена с разным смыслом.
* «Перестать смотреть за водителя» обязано оставлять сотрудника залогиненным,
* иначе смена водителя каждый раз означала бы новый ввод пароля; и наоборот —
* `clear()` водительского сеанса не должен трогать сотрудника.
*/
interface StaffState {
token: string | null;
username: string | null;
/** Боевая оплата под просмотром: платёж уходит в банк и зачисляется водителю.
* Выключено по умолчанию — под чужим лицом легко забыть, кого пополняешь. */
livePay: boolean;
setStaff: (token: string, username: string) => void;
setLivePay: (on: boolean) => void;
clear: () => void;
}
export const useStaff = create<StaffState>()(
persist(
(set) => ({
token: null,
username: null,
livePay: false,
setStaff: (token, username) => set({ token, username }),
setLivePay: (livePay) => set({ livePay }),
// Выход сотрудника гасит и боевой режим: следующий раз он включается осознанно.
clear: () => set({ token: null, username: null, livePay: false }),
}),
{ name: "pp-driver-staff" }
)
);
+76
View File
@@ -0,0 +1,76 @@
/// <reference lib="webworker" />
import { cleanupOutdatedCaches, precacheAndRoute } from "workbox-precaching";
import { clientsClaim } from "workbox-core";
/**
* Сервис-воркер приложения.
*
* Свой, а не сгенерированный: `generateSW` умеет только кэш, а нам нужны
* обработчики `push` и `notificationclick` — уведомления показывает именно
* воркер, страница для этого может быть закрыта.
*
* Кэш остаётся прежним (precache от workbox), поведение обновления тоже:
* `skipWaiting` + `clientsClaim`, как было при registerType: "autoUpdate".
*/
declare const self: ServiceWorkerGlobalScope;
precacheAndRoute(self.__WB_MANIFEST);
cleanupOutdatedCaches();
self.skipWaiting();
clientsClaim();
interface PushPayload {
title?: string;
body?: string;
url?: string;
tag?: string;
/** Номер уведомления в журнале — по нему отмечается прочтение. */
id?: number;
}
self.addEventListener("push", (event: PushEvent) => {
let data: PushPayload = {};
try {
data = event.data ? (event.data.json() as PushPayload) : {};
} catch {
// Пуш без разбираемой нагрузки: показать что-то всё равно надо — молчание
// выглядит как «уведомления не работают».
data = {};
}
const title = data.title || "Премиум Водитель";
event.waitUntil(
self.registration.showNotification(title, {
body: data.body || "",
icon: "/icons/icon-192.png",
badge: "/icons/icon-192.png",
// tag схлопывает однотипные: пять штрафов подряд не завалят шторку.
tag: data.tag,
data: { url: data.url || "/", id: data.id },
}),
);
});
self.addEventListener("notificationclick", (event: NotificationEvent) => {
event.notification.close();
const url = (event.notification.data?.url as string) || "/";
const id = event.notification.data?.id as number | undefined;
// Нажатие — единственный честный признак, что уведомление увидели. Отметить
// его прямо отсюда нельзя: токен водителя лежит в хранилище страницы, а
// воркеру оно недоступно. Поэтому номер едет параметром, а отмечает страница.
const target = id ? `${url}${url.includes("?") ? "&" : "?"}n=${id}` : url;
event.waitUntil(
(async () => {
const all = await self.clients.matchAll({ type: "window", includeUncontrolled: true });
// Уже открытое окно приложения переиспользуем: второй экземпляр рядом с
// первым сбивает с толку, и водитель теряет то, что было на экране.
for (const client of all) {
if ("focus" in client) {
await client.focus();
if ("navigate" in client) await client.navigate(target);
return;
}
}
await self.clients.openWindow(target);
})(),
);
});
+1
View File
@@ -0,0 +1 @@
import "@testing-library/jest-dom/vitest";
+14
View File
@@ -0,0 +1,14 @@
/// <reference types="vite/client" />
interface ImportMetaEnv {
readonly VITE_API_BASE?: string;
}
interface ImportMeta {
readonly env: ImportMetaEnv;
}
// Подставляются на сборке (vite.config.ts → define). Нужны экрану отладки:
// показывают, какой именно бандл сейчас открыт.
declare const __BUILD_COMMIT__: string;
declare const __BUILD_TIME__: string;
+38
View File
@@ -0,0 +1,38 @@
/** @type {import('tailwindcss').Config} */
export default {
content: ["./index.html", "./src/**/*.{ts,tsx}"],
theme: {
extend: {
/**
* Палитра сайта pptaxi.ru — снята с ЖИВОГО сайта (переменные --s-* в его
* инлайн-CSS), а не из локального чекаута: тот отстал на редизайн и
* предлагал тёмно-синюю тему, которой на сайте давно нет.
*
* Имена — роли, а не краски: «canvas» останется фоном страницы, даже если
* однажды перестанет быть светлым.
*/
colors: {
canvas: "#EEF1F5", // --s-bg — фон страницы
"canvas-soft": "#F5F7FA", // --s-bg-soft — подложка под блоками
surface: "#FFFFFF", // --s-paper — карточки, поля ввода
line: "#DDE3EC", // --s-line — границы и разделители
"line-soft": "#E5EAF1",
ink: "#0F172A", // --s-ink — основной текст
"ink-soft": "#475569", // --s-ink-soft — вторичный текст
muted: "#94A3B8", // --s-ink-mute — подписи
accent: "#DC2626", // --s-accent — фирменный красный, кнопка действия
"accent-press": "#B91C1C",
"accent-soft": "#FEF2F2",
warn: "#D97706", // --s-warn
// Деньги: приход зелёным (--s-ok), долг — фирменным красным. Свой оттенок
// тут заводить не стали: у долга и главного действия один цвет намеренно,
// это то, ради чего экран открывают.
pos: "#059669",
neg: "#DC2626",
},
fontFamily: { sans: ["Inter", "system-ui", "sans-serif"] },
borderRadius: { xl2: "12px" }, // --s-radius-md
},
},
plugins: [],
};
+11
View File
@@ -0,0 +1,11 @@
{
"compilerOptions": {
"target": "ES2021", "useDefineForClassFields": true, "lib": ["ES2021", "DOM", "DOM.Iterable", "WebWorker"],
"module": "ESNext", "skipLibCheck": true, "moduleResolution": "bundler",
"allowImportingTsExtensions": true, "resolveJsonModule": true, "isolatedModules": true,
"noEmit": true, "jsx": "react-jsx", "strict": true, "noUnusedLocals": true,
"noUnusedParameters": true, "noFallthroughCasesInSwitch": true,
"baseUrl": ".", "paths": { "@/*": ["src/*"] }, "types": ["vite-plugin-pwa/client", "vitest/globals", "@testing-library/jest-dom"]
},
"include": ["src"]
}
+4
View File
@@ -0,0 +1,4 @@
{
"files": [],
"references": [{ "path": "./tsconfig.app.json" }, { "path": "./tsconfig.node.json" }]
}
Loaded 100 of 156 files, more files were not shown because too many files have changed in this diff. Show more