Files
drivers_bot/README.md
2026-05-15 05:17:54 +09:00

8.5 KiB
Raw Blame History

CarPass

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

Для автовладельца

  • Все автомобили в одном гараже.
  • Заправки, ТО, ремонт, страховка, налоги, штрафы, парковки, мойки и другие расходы.
  • Стоимость владения за период, стоимость 1 км и прогноз ближайших расходов.
  • Разделение расходов на фиксированные и переменные: топливо, ремонт, страховка, налоги, штрафы, кредит и другие категории.
  • Кредитный калькулятор: ежемесячный платеж, проценты, переплата и влияние кредита на стоимость владения.
  • Расход топлива по корректным интервалам между полными баками и мягкие предупреждения, если запас хода резко снизился.
  • Мягкий прогресс заполнения профиля авто: VIN, госномер, пробег, масло, параметры обслуживания.
  • Бейджи качества истории без игровых очков и токсичных рейтингов.
  • Напоминания о ТО, страховке и важных событиях.
  • Автоматические рекомендации ТО по пробегу и времени, включая замену масла.
  • Онлайн-запись в проверенное СТО: выбор услуги, свободного окна, комментарий и согласование времени.
  • Мои записи: статусы requested, confirmed, proposed_new_time, cancelled, completed.
  • OCR чеков и разбор свободного текста: пользователь проверяет найденные данные перед сохранением.
  • История одометра: пробег обновляется из записей, а спорные значения требуют подтверждения.

Для СТО

  • Регистрация автосервиса через Mini App.
  • Заявка на проверку и статус модерации.
  • Модерация заявок: approved, rejected, needs changes, suspended.
  • Публичная карточка СТО после подтверждения.
  • Каталог СТО показывает только подтвержденные сервисы, город, специализации, рейтинг и ближайшее свободное окно.
  • Кабинет СТО: подключенные авто, новые заявки, подтвержденные записи, активные заказ-наряды, выручка и предупреждения.
  • Настройка графика: рабочие дни, часы, обед, праздники, длительность слота, параллельные записи и онлайн-запись.
  • Календарь записей: заявки клиентов, подтверждение, отклонение, предложение нового времени.
  • Создание заказ-наряда из подтвержденной записи на базе существующего ServiceVisit.
  • Отзывы, рейтинг и ответы сервиса.
  • Запрос доступа к конкретному автомобилю только с подтверждением владельца.
  • Добавление визитов, работ и рекомендаций с аудитом действий.

Запись и обслуживание

Если автомобиль уже привязан к СТО, владелец может открыть карточку авто и записаться сразу в календарь этого сервиса. Если привязки нет, пользователь выбирает СТО из каталога, смотрит свободные окна и создает заявку.

СТО получает уведомление о новой заявке, подтверждает время, отклоняет запись или предлагает другое окно. Когда запись подтверждена, она появляется в календаре СТО. После визита сервис может создать заказ-наряд из записи, провести работы, отправить результат владельцу и обновить историю автомобиля через существующий сценарий подтверждения визита.

Рекомендации ТО

CarPass создает рекомендации обслуживания из данных автомобиля и истории работ. Сейчас базово поддержана плановая замена масла по интервалу пробега и времени, ручные рекомендации владельца и связь рекомендации с записью в СТО. Просроченные и близкие рекомендации получают приоритет, но формулируются мягко: пользователь видит действие “записаться”, а не тревожную ошибку.

Уведомления

В системе создаются внутренние уведомления и, если настроен Telegram Bot Token, отправляются сообщения в Telegram:

  • СТО получает новую заявку на запись, отмену клиента и решение по предложенному времени.
  • Владелец получает подтверждение, отклонение или предложение нового времени.
  • Рекомендации ТО фиксируются в истории уведомлений.

Безопасность данных

CarPass не раскрывает историю автомобиля по одному VIN или госномеру. СТО видит только разрешенный владельцем объем данных: базовую карточку, историю обслуживания или полный доступ. Любые чувствительные изменения, включая VIN, номер, пробег и технические параметры, проходят подтверждение владельца.

Telegram Mini App

Mini App открывается через кнопку внутри Telegram-бота. Так Telegram передает защищенную авторизацию, а гараж привязывается к аккаунту пользователя. Если страницу открыть напрямую в браузере, CarPass покажет понятное приглашение открыть приложение через Telegram.

Команды бота

  • /start и /menu — правильный вход в Mini App.
  • /garage — список автомобилей.
  • /add_car — быстрое добавление авто.
  • /fuel, /service, /insurance, /tax, /fine — быстрые записи текстом.
  • /analytics — стоимость владения и расход.
  • /sto, /register_sto — каталог и регистрация СТО.
  • /appointments — записи владельца в СТО.
  • /sto_bookings — краткий отчет по заявкам и календарю СТО.

Почему это полезно

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