Экран входа через МТС 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>
mechanic-pwa
Собственное приложение для сотрудников-механиков PremiumPark — замена вендорского приложения «Механик» (NaughtySoft, com.naughtysoft.ttc). Все данные осмотров уходят в собственную PostgreSQL внутри Premium CRM, фото — в собственный MinIO. Никакого вендора и его 1С на критическом пути.
Контекст
Сейчас механики PremiumPark делают осмотры машин через приложение вендора NaughtySoft, поставляемое на условиях абонентки. Подрядчик заморозил разработку, парк хочет независимости. После разведки вендорского стека (см. recon/findings/01-static-analysis.md) принято решение строить собственное PWA — оно охватывает все ключевые сценарии вендора (фото, метки повреждений, история, дифф «было/стало») и хостится в нашей экосистеме.
Объём проекта
Только приложение механика. Это первый sub-project в umbrella-плане замены вендорских приложений. Будущие sub-projects (не в этом репозитории):
| Sub-project | Описание | Статус |
|---|---|---|
| mechanic-pwa (этот репо) | PWA для сотрудников-механиков парка | в работе |
| driver-app | Приложение для водителей — балансы, штрафы, платежи, обращения | отложено, будем после mechanic |
| vendor-bridge | Импорт исторических осмотров от вендора | отложено |
Структура
mechanic-pwa/ ← корень git репо
├── docs/superpowers/
│ ├── specs/
│ │ ├── 2026-05-11-driver-app-recon-design.md ← разведка обоих вендорских приложений
│ │ └── 2026-05-16-premium-mechanic-design.md ← дизайн нашего mechanic-приложения
│ └── plans/
│ └── 2026-05-16-premium-mechanic-phase1.md ← план реализации Phase 1 MVP
├── mechanic-pwa/
│ ├── frontend/ ← React+Vite PWA (создаётся в Phase G)
│ └── assets/vendor-reference/ ← извлечённые из APK иконки вендора
├── recon/
│ ├── findings/ ← отчёт разведки (карта API, диаграммы)
│ ├── scripts/ ← mitmproxy фильтры, frida-скрипты, утилиты
│ ├── artifacts/ ← APK, декомпил, mitm dumps (не в git, .gitignore)
│ └── patched/ ← патченые APK для перехвата трафика (не в git)
├── ops/
│ ├── Caddyfile.fragment ← конфигурация Caddy для mechanic.pptaxi.ru
│ └── minio-cors.json ← CORS policy для bucket pp-inspections
└── README.md
Внимание: backend-модуль
mechanic(Phase B-F плана) живёт не в этом репо, а в виде веткиfeat/mechanic-mvpвнутри репозиторияpremium-crm. Этот репо — только frontend + специфика, документация и ops.
Текущая фаза
Phase 1 MVP — см. docs/superpowers/plans/2026-05-16-premium-mechanic-phase1.md. 10 phases (A-J), ~40 задач, 3-4 недели разработки.
Деплой
Production URL: https://mechanic.pptaxi.ru (поддомен от 100.64.0.12, обслуживается Caddy)
Бэкенд: модуль mechanic в FastAPI Premium CRM (тот же VDS)
Хранилище фото: MinIO pp-inspections (тот же VDS)