AI-бот Супер Валера для записи на кузовной ремонт и покраску

Open-source проект для создания AI-powered Telegram ботов для автосервисов кузовного ремонта

---

🎯 О проекте

Super Valera - это open-source Ruby on Rails проект, который позволяет владельцам автосервисов запускать своих AI-powered Telegram ботов для автоматизации консультаций и записи клиентов.

Для кого этот проект?

Целевая аудитория проекта:

• 🏢 Владельцы автосервисов - хотят запустить AI-бота для своего бизнеса
• 👨‍💻 Разработчики - хотят контрибьютить в open-source
• 🚀 Предприниматели - хотят создать решение на базе проекта

О терминологии: ПРОЕКТ = этот репозиторий, ПРОДУКТ = созданный AI-бот. Подробнее см. Глоссарий

---

✨ Что можно создать с этим проектом

Возможности созданного AI-бота (продукта):

Для клиентов автосервиса:

• 🤖 Естественный диалог - общение как с живым консультантом
• 📸 AI-анализ повреждений - оценка стоимости по фото
• 🔍 Визуальная оценка - определение типов повреждений
• 📋 Работа со страховыми - помощь с ОСАГО/КАСКО
• 📊 Фотоотчеты - прозрачность на каждом этапе
• ⚡ Быстрая запись - на бесплатный осмотр

Для владельцев автосервисов:

• 📈 Увеличение конверсии - до 40% из фото в заявку
• 💰 Высокий средний чек - фокус на кузовном ремонте
• 🤝 Снижение нагрузки - автоматизация консультаций
• 🎯 Страховые клиенты - автоматизация ОСАГО/КАСКО
• 📊 Аналитика - полная история взаимодействий

Бизнес-метрики продукта: См. docs/product/business-metrics.md

---

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

Полное руководство по установке: docs/development/SETUP.md

Краткие требования:

• Ruby 3.4+, PostgreSQL 14+
• Telegram Bot Token, AI API key

Быстрая установка:

git clone https://github.com/dapi/valera.git
cd valera
bundle install
bin/rails db:create db:migrate
bin/rails telegram:bot:poller

Production deployment: docs/deployment/README.md

---

🛠️ Технологии

Основной стек: Ruby on Rails 8.1 + ruby_llm + Telegram + PostgreSQL

AI провайдеры: Anthropic Claude, DeepSeek (OpenAI, GigaChat в разработке)

Подробнее о технологиях: docs/development/stack.md

---

📸 Пример диалога

Клиент: Здравствуйте, у меня вмятина на двери
Супер Валера: Добрый день! Пришлите фото повреждения,
        и я сделаю предварительную оценку стоимости.

---

🗺️ План развития

Полный roadmap: docs/ROADMAP.md

Текущий статус: Phase 2 - AI-анализ фотографий повреждений и визуальная оценка стоимости

---

🤝 Для контрибьюторов

Мы приветствуем контрибьюции!

Начать здесь:

• Product Constitution - требования к продукту
• Development Guide - руководство для разработчиков
• Open Issues - задачи для участия

Полная документация: docs/INDEX.md

---

📚 Документация

Основная документация: docs/INDEX.md

Ключевые разделы:

• Development Guide - для разработчиков
• Product Constitution - требования к продукту
• Глоссарий - терминология проекта

---

📄 Лицензия

(TODO: добавить лицензию)

---

💬 Контакты

• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

Версия проекта: 0.2.0 (MVP+) Статус: Active Development