RepairDesk Bot

Открытая система учета для мастеров по ремонту ПК / ноутбуков / телефонов на базе Telegram.

Этот проект родился как ответ на растущие цены и избыточную сложность коммерческих CRM. Простой, самодостаточный Telegram-бот, который берет на себя ключевые задачи мастерской: приёмку устройств, ведение базы клиентов и отслеживание статусов ремонта.

Бот разработан мастером для мастеров. Он представляет собой минимально жизнеспособный продукт (MVP), который уже можно использовать в работе. Код открыт — вы можете свободно развернуть его для себя, адаптировать или дополнить полезными функциями.

✨ Возможности MVP

• 📝 Полная приёмка устройства: Создание нового заказа с записью данных клиента, модели устройства, серийного номера, комплектации и описания неисправности — прямо в диалоге с ботом.
• 👥 Умная база клиентов: Автоматическое сохранение и связывание клиентов с их устройствами. Поиск по истории обращений.
• 🔄 Управление статусами: Простая система статусов заказа: Принят, В диагностике, Ждет запчасти, В ремонте, Готов, Выдан.
• 🔍 Быстрый поиск: Поиск заказов по номеру, фамилии клиента, модели устройства или серийному номеру.
• 🤖 Удобный интерфейс: Вся работа через интуитивные кнопки и формы Telegram — не нужно осваивать сложные интерфейсы.

🚀 Быстрый старт

1. Создайте бота через @BotFather и получите токен.
2. Подготовьте окружение:

   git clone https://github.com/your-username/repairdesk-bot.git
   cd repairdesk-bot
   # Установите зависимости
   pip install -r requirements.txt

3. Настройте конфигурацию: Скопируйте файл .env.example в .env и вставьте ваш токен:

   BOT_TOKEN=ВАШ_ТОКЕН_ОТ_BOTFATHER
   ADMIN_ID=ВАШ_ID_В_TELEGRAM
   DATABASE_URL=sqlite:///repair_database.db  - поменяю на PostgreSQL (асинхронная), так как будет доступ для клиентов, они смогут сами забрать цек, квитанцию, статус..
   

4. Запустите бота:

   python3 bot.py

5. Перейдите в Telegram и начните диалог с вашим ботом. Используйте команду /start.

Полная инструкция по развертыванию, включая настройку вебхука и работы с PostgreSQL, находится в DEPLOY.md.

🗂 Структура проекта (упрощённо)

repairdesk-bot/
├── bot.py                 # Основная логика бота (хендлеры, States)
├── database.py            # Модели и работа с БД (SQLAlchemy)
├── keyboards.py           # Клавиатуры и inline-кнопки
├── config.py              # Загрузка настроек
├── .env                   # Конфиденциальные данные (не в репозитории)
├── requirements.txt       # Зависимости Python
└── README.md              # Этот файл

🤝 Почему открытый исходный код?

Потому что инструмент мастера должен быть:

• Подконтрольным: Вы не зависите от чужого графика обновлений и ценовой политики.
• Адаптируемым: Можно «заточить» логику под специфику именно вашей мастерской.
• Сообщественным: Каждый может улучшить функционал для всех (ведь у всех разные «хотелки»).

Ваш вклад приветствуется! Есть идея, баг или готовый код? Смело создавайте Issue или Pull Request. Давайте вместе сделаем этот инструмент лучше.

📝 Планы развития (Roadmap)

• QR код для подключения клиента.
• Система учета запчастей (приход/расход).
• Формирование простых чеков/актов приёмки.
• Напоминания клиентам о готовности.
• База знаний по частым неисправностям.
• Ведение финансовой статистики (доходы/расходы).

---

📄 Лицензия

Этот проект распространяется под лицензией MIT. Это означает, что вы можете свободно использовать, изменять и распространять код, даже в коммерческих целях, при условии сохранения уведомления об авторских правах.

⚠️ Отказ от ответственности

Этот бот предоставляется «как есть». Автор не несет ответственности за любые прямые или косвенные убытки, связанные с использованием этого программного обеспечения в вашем бизнесе. Перед полноценным внедрением рекомендуется протестировать его в работе.