Здравствуйте, перед тем как вы скачаете и начнете активно использовать мой проект,
я бы хотел сказать пару слов: проект тестировался только на Windows, если у вас другая ОС, нейросети вам в помощь.
Проект полностью опенсорсный. По всем вопросам я готов отвечать, помогать с установкой и так далее(tg: @ratnik1337)
Этот бот создан исключительно в образовательных целях, хранение персональных данных пользователей без их согласия преследуется по закону.
Всю ответственность я с себя снимаю. Для поддержания этого проекта я вам советую приобретать сервер на
VDS Windows и Linux: аÑенда дедиков | виÑÑÑалÑнÑй VPS ÑеÑÐ²ÐµÑ | End Way - Форум программирования и сливов различных скриптов

я бы хотел сказать пару слов: проект тестировался только на Windows, если у вас другая ОС, нейросети вам в помощь.
Проект полностью опенсорсный. По всем вопросам я готов отвечать, помогать с установкой и так далее(tg: @ratnik1337)
Этот бот создан исключительно в образовательных целях, хранение персональных данных пользователей без их согласия преследуется по закону.
Всю ответственность я с себя снимаю. Для поддержания этого проекта я вам советую приобретать сервер на
VDS Windows и Linux: аÑенда дедиков | виÑÑÑалÑнÑй VPS ÑеÑÐ²ÐµÑ | End Way - Форум программирования и сливов различных скриптов

Для просмотра скрытого содержимого вы должны войти или зарегистрироваться.
Для просмотра скрытого содержимого вы должны войти или зарегистрироваться.
========================
ОСНОВНЫЕ ВОЗМОЖНОСТИ БОТА
========================
1. Сохранение сообщений
- сохранение входящих сообщений;
- хранение текста сообщений;
- хранение информации о редактировании;
- поддержка reply / reply-to-message связей;
- работа с удалёнными сообщениями и служебной историей.
2. Сохранение медиа
- фото;
- видео;
- голосовые сообщения;
- video notes;
- audio;
- документы;
- безопасное хранение путей к файлам;
- owner-aware имена файлов для изоляции данных.
3. Работа с базой данных
- SQLite как основная база;
- миграции;
- обслуживание целостности данных;
- cleanup старых записей;
- пересчёт статистики;
- integrity/readiness проверки.
4. Поиск и просмотр данных
- поиск сообщений;
- поиск по чатам;
- просмотр fulltext;
- просмотр metadata;
- просмотр сохранённых медиа;
- пагинация результатов;
- ограничение доступа к просмотру по ролям и scope.
5. Экспорт и архивирование
- экспорт данных чатов;
- экспорт сообщений;
- архивирование по чатам;
- архивирование по датам;
- копирование медиа в архив;
- безопасная проверка путей перед отправкой архивов и файлов.
6. Статистика и диагностика
- статистика сообщений;
- статистика удалённых и изменённых сообщений;
- временные сравнения;
- scoped-статистика для ограниченных ролей;
- служебные диагностические команды и скрипты.
7. Безопасность
- BOT_TOKEN хранится через `.env`;
- fail-fast при отсутствии токена;
- admin-only защита чувствительных действий;
- fail-closed guard для sensitive-веток;
- защита export / archive / media / fulltext / metadata;
- safe-path проверки для файлов;
- scoped-доступ для ограниченных ролей;
- защита от подмены callback_data;
- защита от утечки данных обычным пользователям.
ОСНОВНЫЕ ВОЗМОЖНОСТИ БОТА
========================
1. Сохранение сообщений
- сохранение входящих сообщений;
- хранение текста сообщений;
- хранение информации о редактировании;
- поддержка reply / reply-to-message связей;
- работа с удалёнными сообщениями и служебной историей.
2. Сохранение медиа
- фото;
- видео;
- голосовые сообщения;
- video notes;
- audio;
- документы;
- безопасное хранение путей к файлам;
- owner-aware имена файлов для изоляции данных.
3. Работа с базой данных
- SQLite как основная база;
- миграции;
- обслуживание целостности данных;
- cleanup старых записей;
- пересчёт статистики;
- integrity/readiness проверки.
4. Поиск и просмотр данных
- поиск сообщений;
- поиск по чатам;
- просмотр fulltext;
- просмотр metadata;
- просмотр сохранённых медиа;
- пагинация результатов;
- ограничение доступа к просмотру по ролям и scope.
5. Экспорт и архивирование
- экспорт данных чатов;
- экспорт сообщений;
- архивирование по чатам;
- архивирование по датам;
- копирование медиа в архив;
- безопасная проверка путей перед отправкой архивов и файлов.
6. Статистика и диагностика
- статистика сообщений;
- статистика удалённых и изменённых сообщений;
- временные сравнения;
- scoped-статистика для ограниченных ролей;
- служебные диагностические команды и скрипты.
7. Безопасность
- BOT_TOKEN хранится через `.env`;
- fail-fast при отсутствии токена;
- admin-only защита чувствительных действий;
- fail-closed guard для sensitive-веток;
- защита export / archive / media / fulltext / metadata;
- safe-path проверки для файлов;
- scoped-доступ для ограниченных ролей;
- защита от подмены callback_data;
- защита от утечки данных обычным пользователям.
========================
ВОЗМОЖНОСТИ АДМИН-ПАНЕЛИ
========================
Админ-панель включает:
- просмотр пользователей;
- просмотр чатов;
- поиск сообщений;
- просмотр медиа;
- просмотр fulltext;
- просмотр metadata;
- экспорт чатов и данных;
- архивирование;
- статистику;
- диагностику;
- пагинацию;
- действия удаления и обслуживания.
Поддерживаются роли и ограничения:
- superadmin;
- admin;
- scoped-роли с ограничением по owner/chat;
- ограничение доступа к данным вне своего scope;
- отдельные sensitive-ветки для export / archive / download / metadata / fulltext.
Обычные пользователи не должны иметь доступа к:
- экспорту;
- архивам;
- полным текстам;
- metadata;
- служебным данным админки;
- внутренним путям к файлам;
- диагностике и admin-only отчётам.
ВОЗМОЖНОСТИ АДМИН-ПАНЕЛИ
========================
Админ-панель включает:
- просмотр пользователей;
- просмотр чатов;
- поиск сообщений;
- просмотр медиа;
- просмотр fulltext;
- просмотр metadata;
- экспорт чатов и данных;
- архивирование;
- статистику;
- диагностику;
- пагинацию;
- действия удаления и обслуживания.
Поддерживаются роли и ограничения:
- superadmin;
- admin;
- scoped-роли с ограничением по owner/chat;
- ограничение доступа к данным вне своего scope;
- отдельные sensitive-ветки для export / archive / download / metadata / fulltext.
Обычные пользователи не должны иметь доступа к:
- экспорту;
- архивам;
- полным текстам;
- metadata;
- служебным данным админки;
- внутренним путям к файлам;
- диагностике и admin-only отчётам.
========================
УСТАНОВКА И ЗАПУСК
========================
Требования:
- Python 3.10+ (рекомендовано);
- Windows / Linux / macOS;
- Telegram Bot Token от botfather.
1. Клонируем / распаковываем проект
Windows PowerShell:
cd "ПУТЬ_К_ПРОЕКТУ"
Linux / macOS bash:
cd /path/to/project
2. Создаём виртуальное окружение
Windows PowerShell:
python -m venv .venv
.\.venv\Scripts\Activate.ps1
Linux / macOS bash:
python3 -m venv .venv
source .venv/bin/activate
3. Устанавливаем зависимости
Windows PowerShell:
pip install -r requirements.txt
Linux / macOS bash:
pip install -r requirements.txt
4. Настраиваем `.env`
Создаём файл `.env` в корне проекта и указываем:
BOT_TOKEN=ВАШ_ТЕЛЕГРАМ_ТОКЕН
Важно:
- не хранить токен в коде;
- не коммитить `.env` в публичный репозиторий;
- использовать только актуальный токен из BotFather.
5. Запуск бота
Windows PowerShell:
python .\business_bot.py
Linux / macOS bash:
python3 ./business_bot.py
========================
СЛУЖЕБНЫЕ ПРОВЕРКИ
========================
Проверка синтаксиса:
python -m py_compile business_bot.py database.py business_bot_config.py migrate_db.py migrate_legacy_access.py scripts/verify_prod_readiness.py scripts/fix_db_integrity.py
Проверка readiness:
python scripts/verify_prod_readiness.py
Проверка целостности БД (dry-run):
python scripts/fix_db_integrity.py
Применение integrity-fix:
python scripts/fix_db_integrity.py --apply
Проверка legacy migration (dry-run):
python migrate_db.py
Применение migration:
python migrate_db.py --apply
Предпросмотр legacy access migration:
python migrate_legacy_access.py --preview-limit 5
УСТАНОВКА И ЗАПУСК
========================
Требования:
- Python 3.10+ (рекомендовано);
- Windows / Linux / macOS;
- Telegram Bot Token от botfather.
1. Клонируем / распаковываем проект
Windows PowerShell:
cd "ПУТЬ_К_ПРОЕКТУ"
Linux / macOS bash:
cd /path/to/project
2. Создаём виртуальное окружение
Windows PowerShell:
python -m venv .venv
.\.venv\Scripts\Activate.ps1
Linux / macOS bash:
python3 -m venv .venv
source .venv/bin/activate
3. Устанавливаем зависимости
Windows PowerShell:
pip install -r requirements.txt
Linux / macOS bash:
pip install -r requirements.txt
4. Настраиваем `.env`
Создаём файл `.env` в корне проекта и указываем:
BOT_TOKEN=ВАШ_ТЕЛЕГРАМ_ТОКЕН
Важно:
- не хранить токен в коде;
- не коммитить `.env` в публичный репозиторий;
- использовать только актуальный токен из BotFather.
5. Запуск бота
Windows PowerShell:
python .\business_bot.py
Linux / macOS bash:
python3 ./business_bot.py
========================
СЛУЖЕБНЫЕ ПРОВЕРКИ
========================
Проверка синтаксиса:
python -m py_compile business_bot.py database.py business_bot_config.py migrate_db.py migrate_legacy_access.py scripts/verify_prod_readiness.py scripts/fix_db_integrity.py
Проверка readiness:
python scripts/verify_prod_readiness.py
Проверка целостности БД (dry-run):
python scripts/fix_db_integrity.py
Применение integrity-fix:
python scripts/fix_db_integrity.py --apply
Проверка legacy migration (dry-run):
python migrate_db.py
Применение migration:
python migrate_db.py --apply
Предпросмотр legacy access migration:
python migrate_legacy_access.py --preview-limit 5
========================
СТРУКТУРА ПРОЕКТА
========================
Ключевые файлы:
- `business_bot.py` — основной файл бота / entrypoint;
- `database.py` — работа с БД;
- `business_bot_config.py` — конфиг проекта;
- `migrate_db.py` — миграции БД;
- `migrate_legacy_access.py` — работа с legacy access;
- `scripts/verify_prod_readiness.py` — проверка готовности проекта;
- `scripts/fix_db_integrity.py` — исправление целостности БД;
- `README.md` и `docs/*` — документация.
Пути проекта:
- база данных: `business_messages.db`
- медиа: `./business_media`
- архивы: `./archives`
========================
ПЛЮСЫ ПРОЕКТА
========================
- готовая база для Telegram backend-проекта;
- уже есть админ-панель;
- уже есть роли и ограничения доступа;
- уже есть экспорт и архивирование;
- уже есть медиа и работа с файлами;
- уже есть служебные verify/fix скрипты;
- уже есть документация;
- уже есть безопасная схема работы с `.env`.
========================
ДОПОЛНИТЕЛЬНО
========================
В проекте уже учтены:
- перенос токена в `.env`;
- защита чувствительных админских веток;
- fail-closed модель доступа;
- scoped-изоляция данных;
- безопасная работа с файлами и архивами;
- базовые readiness / integrity проверки.
Если нужен исходный код, доработка, кастомизация, помощь с запуском, развёртыванием или интеграцией под ваши задачи — пишите в ЛС.
Оригинальный автор: @ratnik1337
СТРУКТУРА ПРОЕКТА
========================
Ключевые файлы:
- `business_bot.py` — основной файл бота / entrypoint;
- `database.py` — работа с БД;
- `business_bot_config.py` — конфиг проекта;
- `migrate_db.py` — миграции БД;
- `migrate_legacy_access.py` — работа с legacy access;
- `scripts/verify_prod_readiness.py` — проверка готовности проекта;
- `scripts/fix_db_integrity.py` — исправление целостности БД;
- `README.md` и `docs/*` — документация.
Пути проекта:
- база данных: `business_messages.db`
- медиа: `./business_media`
- архивы: `./archives`
========================
ПЛЮСЫ ПРОЕКТА
========================
- готовая база для Telegram backend-проекта;
- уже есть админ-панель;
- уже есть роли и ограничения доступа;
- уже есть экспорт и архивирование;
- уже есть медиа и работа с файлами;
- уже есть служебные verify/fix скрипты;
- уже есть документация;
- уже есть безопасная схема работы с `.env`.
========================
ДОПОЛНИТЕЛЬНО
========================
В проекте уже учтены:
- перенос токена в `.env`;
- защита чувствительных админских веток;
- fail-closed модель доступа;
- scoped-изоляция данных;
- безопасная работа с файлами и архивами;
- базовые readiness / integrity проверки.
Если нужен исходный код, доработка, кастомизация, помощь с запуском, развёртыванием или интеграцией под ваши задачи — пишите в ЛС.
Оригинальный автор: @ratnik1337




