🏢 RentBot KZ - Telegram бот для управления арендой

Автоматизация учёта арендных платежей и коммунальных услуг через Telegram

🎬 Демонстрация

Внесение оплаты за 5 секунд — без Excel, без звонков, без головной боли! ✨

RentBot — это бесплатный Telegram-бот для автоматизации управления арендой коммерческой недвижимости. Создан владельцем автоцентра в Актау, Казахстан, для управления 13 арендными боксами.

Решает проблемы:

❌ Было:

• Ручной учёт в Excel
• Постоянные звонки "Вы оплатили?"
• Забытые платежи
• Путаница с коммунальными платежами
• 10+ часов в месяц на администрирование

✅ Стало:

• Всё в одном боте
• Автоматические напоминания
• PDF-отчёты одной кнопкой
• WhatsApp-рассылка должникам
• 30 минут в месяц на управление

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

💰 Учёт платежей

• ✅ Внесение оплат по месяцам и арендаторам
• 📊 Автоматические отчёты по должникам
• 📤 Генерация текстов для выставления счетов
• 📱 WhatsApp-рассылка напоминаний

💧 Учёт коммунальных услуг

• 🚰 Вода
• 🔥 Отопление
• 🗑 Вывоз ТБО (мусор)
• Автоматический расчёт по арендаторам

📄 Отчёты и документы

• 📊 Жировка для бухгалтера — сводный PDF-отчёт по всем арендаторам
• 👥 Жировка для арендаторов — индивидуальные счета
• 📈 Отчёты по оплатам — кто должен, кто оплатил
• ⚡ Всё за 2 клика!

🎥 Демонстрация

📺 Смотреть видео-обзор (3 минуты)

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

Требования

• Google Аккаунт (для Google Sheets + Apps Script)
• Telegram аккаунт
• 15 минут времени

Установка (5 шагов)

1️⃣ Создайте Telegram бота

1. Откройте @BotFather в Telegram
2. Отправьте /newbot
3. Введите имя: "Мой RentBot"
4. Введите username: "my_rentbot"
5. Скопируйте TOKEN

2️⃣ Скопируйте шаблон Google Sheets

📋 НАЖМИТЕ СЮДА → Создать копию таблицы

Нажмите "Создать копию" → Таблица готова! ✅

3️⃣ Настройте Google Apps Script

1. В вашей таблице: Расширения → Apps Script
2. Удалите весь код
3. Скопируйте код из rentbot.js
4. Замените YOUR_TELEGRAM_BOT_TOKEN на ваш токен
5. Файл → Сохранить

4️⃣ Разверните веб-приложение

1. Развернуть → Новое развертывание
2. Тип: Веб-приложение
3. Доступ: "Все"
4. Скопируйте URL

5️⃣ Установите Webhook

Откройте в браузере:
https://api.telegram.org/botYOUR_TOKEN/setWebhook?url=ВАШ_URL_ИЗ_ШАГА_4

✅ Готово!

Откройте бота в Telegram и отправьте /start

Полная инструкция: INSTALL.md

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

• 📖 Полная инструкция по установке
• ⚙️ Настройка под ваши нужды
• 🐛 Решение проблем
• 🎨 Кастомизация
• ❓ FAQ

🏗 Архитектура

┌─────────────┐
│  Telegram   │  ← Пользователь нажимает кнопки
│    Bot      │
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   Google    │  ← Webhook обрабатывает запросы
│ Apps Script │
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   Google    │  ← Хранение данных
│   Sheets    │
└─────────────┘

Стек:

• Frontend: Telegram Bot API
• Backend: Google Apps Script (JavaScript)
• Database: Google Sheets
• PDF Generation: Google Sheets native export
• Hosting: Бесплатный (Google)

🌍 Кому подходит

✅ Владельцы торговых комплексов
✅ Автоцентры с арендой боксов
✅ Бизнес-центры
✅ Коворкинги
✅ Складские комплексы
✅ Паркинги и гаражные кооперативы
✅ Управляющие компании (ЖКХ)

🇰🇿 Локализация

Бот изначально создан для Казахстана и включает:

• 🇷🇺 Русский язык
• 🇰🇿 Казахстанская терминология (ТБО, жировка)
• 💱 Тенге (₸) как валюта
• 📱 WhatsApp интеграция (популярен в КЗ)
• 📄 Шаблоны документов по ГОСТу РК

Легко адаптируется под другие страны!

💡 Roadmap

✅ Реализовано (v1.0)

• Учёт арендных платежей
• Учёт коммуналки (вода, отопление, ТБО)
• PDF-отчёты для бухгалтера
• Индивидуальные счета арендаторам
• WhatsApp рассылка должникам
• Автоматическая синхронизация чекбоксов

🚧 В разработке (v1.1)

• Статистика и аналитика
• История платежей по арендатору
• Автоматические напоминания по расписанию
• Экспорт в Excel для бухгалтерии

🎯 Планируется (v2.0)

• Интеграция с Kaspi.kz (автоматическое подтверждение оплат)
• Интеграция с 1С
• Мультиязычность (English, Қазақша)
• Мобильное приложение
• Веб-дашборд

🤝 Поддержать проект

Этот проект создаётся и поддерживается бесплатно. Если он помог вам сэкономить время и деньги — поддержите развитие!

💖 Способы поддержки:

🌟 GitHub Sponsors

Уровни поддержки:

• ☕ $5/месяц — Спасибо! (имя в README)
• 🍕 $15/месяц — Supporter (логотип в README + приоритет в Issues)
• 🚀 $50/месяц — Contributor (доступ к закрытому Telegram-чату + ранний доступ к новым фичам)
• 💎 $200/месяц — Partner (видео-консультация 1 раз/месяц + кастомная фича)

🎨 Patreon

Преимущества:

• Закрытые обновления и инсайты
• Приоритетная поддержка
• Влияние на roadmap

💳 Разовый донат

• Kaspi Gold: +7 (XXX) XXX-XX-XX
• Buy Me a Coffee: buymeacoffee.com/YOUR_USERNAME

👥 Контрибьюторы

Спасибо всем, кто помогает развивать проект! ❤️

🙏 Спонсоры

Большое спасибо спонсорам проекта:

💎 Diamond Sponsors ($200+/мес)

Станьте первым Diamond спонсором!

🚀 Gold Sponsors ($50+/мес)

Станьте первым Gold спонсором!

🍕 Silver Sponsors ($15+/мес)

Станьте первым Silver спонсором!

📜 Лицензия

Этот проект распространяется под MIT License — можете свободно использовать, изменять и распространять.

См. LICENSE для подробностей.

📞 Контакты и Поддержка

• 📧 Email: your.email@example.com
• 💬 Telegram: @your_username
• 🐛 Issues: GitHub Issues
• 💡 Идеи: GitHub Discussions

👥 Сообщество

• 📱 Telegram-группа пользователей
• 💬 Discord сервер

⭐ Нравится проект?

Поставьте звезду на GitHub — это мотивирует! 🌟

📈 Статистика

Сделано с ❤️ в Казахстане 🇰🇿

_{Если этот проект сэкономил вам время — угостите меня кофе ☕}