BlackDrive — Telegram-бот расчёта таможни и доставки авто

Telegram-бот для компании по ввозу автомобилей из Кореи, Китая и ОАЭ: пошаговый расчёт таможенных платежей, логистики и итоговой стоимости «под ключ» с прозрачными формулами

Skills & deliverables:
Pythonaiogram 3PydanticPydantic SettingsPyYAMLpsycopgaiohttpcbr-clientasyncio
Timeline:3 недели
Budget:45 000

Project description

Разработал Telegram-бот для автокомпании BlackDrive, который помогает клиентам и менеджерам быстро оценить полную стоимость ввоза автомобиля в РФ.

Пользователь проходит 9-шаговый сценарий (FSM): выбирает страну, тип ТС, валюту и цену, указывает данные авто (тип двигателя, мощность, объём, возраст, физ/юр лицо) — и получает детализированный расчёт.

Ядро проекта — собственный калькулятор таможенных платежей по правилам ЕАЭС/РФ вместо внешнего API: таможенные сборы, пошлина (ЕТС для физлиц / ЕТТ для юрлиц), утилизационный сбор, оформление, акциз и НДС для электромобилей. Все ставки и коэффициенты вынесены в YAML-конфиг и валидируются через Pydantic — правки тарифов без деплоя кода.

Для каждой статьи расходов бот показывает формулу с подстановкой значений и результатом, чтобы расчёт был прозрачным для клиента. Отдельно считаются логистика и комиссия компании по стратегиям для Кореи, Китая и ОАЭ; курсы валют подтягиваются с ЦБ РФ.

Архитектура разделена на слои: domain (бизнес-логика и интерфейсы), infrastructure (курсы, калькулятор), tg_bot (handlers, FSM, middleware). Есть проверка подписки на канал, админ-панель (канал, менеджер, список админов), логирование расчётов в PostgreSQL

Files & attachments