На айфоне у установленного приложения нет системной «назад», а жест от края
после холодного старта или открытия из пуша не делает ничего — водитель
застревал в «Уведомлениях», на ожидании 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>
Экран входа через МТС 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>
Жалоба: по ссылке на оплату жмёшь «получить код» — «слишком часто».
- на шаге кода кнопка «отправить ещё раз» с отсчётом (60с, синхронно с
бэкендом); на 429 ведём отсчёт по Retry-After и не пугаем
- кнопка «Получить код» блокируется на время кулдауна
- RequireAuth запоминает путь (ссылку на оплату); после входа по коду и
через Telegram возвращаем туда, а не на баланс
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Пуш живёт до первого смахивания, сообщение в боте тонет в переписке — и
разговор «мне ничего не приходило» упирался в слово против слова. Теперь у
водителя есть место, куда посмотреть, а у парка — отметка о прочтении, которая
ставится ровно тогда, когда человек открыл ленту или нажал на уведомление.
Отмечаем ПОСЛЕ показа списка, а не при загрузке: иначе счётчик гаснет у того,
кто мазнул по экрану и ушёл. Время первого прочтения бэкенд не переписывает.
Нажатие по пушу: воркер сам отметить не может (токен лежит в хранилище
страницы, ему недоступном), поэтому номер уведомления приезжает в пуше, воркер
добавляет его к адресу параметром, а страница отмечает и параметр убирает.
Колокольчик по умолчанию выключен в общей шапке и включён только на главной:
шапка стоит на каждом экране, и незачем ходить за счётчиком с оплаты.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Отдельный список штрафов удалён: два списка одного и того же в разных местах
сбивали с толку. Фильтр «Штрафы» внизу главного экрана теперь показывает сами
постановления, а не проводки по ним, и ведёт в карточку с фотографией.
Разница между постановлением и проводкой здесь принципиальная: штраф, который
водитель оплатил сам, парк не выставлял — проводки нет, и в выписке он бы не
появился вовсе (Морозов, штраф от 16.08). Строка «Долг по штрафам» вверху теперь
включает этот фильтр, а не уводит на другой экран.
Период действует и на штрафы: календарь над списком не должен стоять, ничего не
меняя.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Дата в выписке и в списке штрафов встала первой строкой чернильным цветом: в
этих списках ищут «что было 12-го», а бледная подпись под заголовком для этого
не годилась.
Строка штрафа в выписке стала кнопкой в карточку — там фотография и подробности.
Остальные строки не притворяются ссылками.
Раздел «Мои пополнения» удалён вместе с кнопкой: он показывал только наши
платежи и у большинства водителей был пуст (1С проводит пополнения сама), а те
же операции видны в выписке фильтром «Пополнения».
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Список с вкладками «Неоплаченные / Все» и суммой долга в шапке; в карточке —
фотография с камеры первой, до реквизитов: по ней водитель узнаёт свою машину и
свою поездку. Дальше сумма, скидка с датой (то, ради чего заходят вовремя),
скорость и разрешённый предел, постановление, камера, ссылка на PDF.
Строка «Долг по штрафам» на главном экране теперь ведёт сюда, а не сразу к
оплате: платить, не поняв за что, человек не станет. Аренда по-прежнему ведёт к
оплате — за тем её и открывают.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Приложение обкатывается на боевом контуре, поэтому интерфейс надо проверять на
живых данных — а живые данные лежат у настоящих водителей.
* «Вход для сотрудника» (/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>