# 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 превращает хаотичные чеки и заметки в понятную картину расходов и обслуживания. Для сервиса это аккуратный канал взаимодействия с клиентом, подтвержденная история работ и доверие без лишнего доступа к персональным данным.