Первый этам разметки Readme.md
This commit is contained in:
parent
8064e107a2
commit
b447389479
154
README.md
154
README.md
@ -1,110 +1,83 @@
|
|||||||
# Bot_of_Pray
|
# Telegram-бот для молитвенного поминания
|
||||||
Telegram-бот для молитвенного поминания
|
## Описание проекта
|
||||||
Описание проекта
|
|
||||||
|
|
||||||
Бот предоставляет пользователям возможность отправлять имена для молитвенного поминания священнику. Система позволяет добавлять имена в разные типы записок, оставлять комментарии и управлять своими записями.
|
Бот предоставляет пользователям возможность отправлять имена для молитвенного поминания священнику. Система позволяет добавлять имена в разные типы записок, оставлять комментарии и управлять своими записями.
|
||||||
Основные функции
|
## Основные функции
|
||||||
|
|
||||||
Типы записок:
|
### Типы записок:
|
||||||
|
* О здравии
|
||||||
|
* За упокой
|
||||||
|
* Комментарии
|
||||||
|
|
||||||
О здравии
|
### Управление записями:
|
||||||
|
* Просмотр текущих записей
|
||||||
|
* Добавление новых имен
|
||||||
|
* Очистка записей
|
||||||
|
* Сохранение изменений
|
||||||
|
|
||||||
За упокой
|
###Админ-панель:
|
||||||
|
* Получение уведомлений о новых записях
|
||||||
|
* Статистика использования
|
||||||
|
* Управление записями
|
||||||
|
|
||||||
Комментарии
|
## Архитектура проекта
|
||||||
|
|
||||||
Управление записями:
|
### Структура папок:
|
||||||
|
* handlers/ - обработчики команд и callback-запросов
|
||||||
|
* utils/ - вспомогательные функции
|
||||||
|
* messages.py - текстовые сообщения
|
||||||
|
* main.py - точка входа приложения
|
||||||
|
* prefixes.json - файл с префиксами
|
||||||
|
* requirements.txt - зависимости проекта
|
||||||
|
|
||||||
Просмотр текущих записей
|
## Основные компоненты
|
||||||
|
|
||||||
Добавление новых имен
|
### Обработчики:
|
||||||
|
* Пользовательские команды
|
||||||
|
* Callback-запросы
|
||||||
|
* Админ-команды
|
||||||
|
* Базовые функции
|
||||||
|
* Утилиты:
|
||||||
|
* Работа с базой данных
|
||||||
|
|
||||||
Очистка записей
|
### Форматирование сообщений
|
||||||
|
* Отправка уведомлений
|
||||||
|
* Логирование
|
||||||
|
|
||||||
Сохранение изменений
|
## Требования и установка
|
||||||
|
|
||||||
Админ-панель:
|
###Необходимые зависимости:
|
||||||
|
|
||||||
Получение уведомлений о новых записях
|
* Python 3.8+
|
||||||
|
* Python-telegram-bot
|
||||||
|
* Дополнительные библиотеки из requirements.txt
|
||||||
|
|
||||||
Статистика использования
|
## Настройка и запуск
|
||||||
|
|
||||||
Управление записями
|
|
||||||
|
|
||||||
Архитектура проекта
|
|
||||||
|
|
||||||
Структура папок:
|
|
||||||
|
|
||||||
handlers/ - обработчики команд и callback-запросов
|
|
||||||
|
|
||||||
utils/ - вспомогательные функции
|
|
||||||
|
|
||||||
messages.py - текстовые сообщения
|
|
||||||
|
|
||||||
main.py - точка входа приложения
|
|
||||||
|
|
||||||
prefixes.json - файл с префиксами
|
|
||||||
|
|
||||||
requirements.txt - зависимости проекта
|
|
||||||
|
|
||||||
Основные компоненты
|
|
||||||
|
|
||||||
Обработчики:
|
|
||||||
|
|
||||||
Пользовательские команды
|
|
||||||
|
|
||||||
Callback-запросы
|
|
||||||
|
|
||||||
Админ-команды
|
|
||||||
|
|
||||||
Базовые функции
|
|
||||||
|
|
||||||
Утилиты:
|
|
||||||
|
|
||||||
Работа с базой данных
|
|
||||||
|
|
||||||
Форматирование сообщений
|
|
||||||
|
|
||||||
Отправка уведомлений
|
|
||||||
|
|
||||||
Логирование
|
|
||||||
|
|
||||||
Требования и установка
|
|
||||||
|
|
||||||
Необходимые зависимости:
|
|
||||||
|
|
||||||
Python 3.8+
|
|
||||||
|
|
||||||
Python-telegram-bot
|
|
||||||
|
|
||||||
Дополнительные библиотеки из requirements.txt
|
|
||||||
|
|
||||||
Настройка и запуск
|
|
||||||
|
|
||||||
Настройка окружения:
|
|
||||||
|
|
||||||
Создайте файл .env с необходимыми переменными:
|
|
||||||
|
|
||||||
|
### Настройка окружения:
|
||||||
|
* Создайте файл .env с необходимыми переменными:
|
||||||
|
```bash
|
||||||
TELEGRAM_TOKEN_FILE=path/to/token.txt
|
TELEGRAM_TOKEN_FILE=path/to/token.txt
|
||||||
TELEGRAM_DATABASE=path/to/database.json
|
TELEGRAM_DATABASE=path/to/database.json
|
||||||
TELEGRAM_ADMINS=path/to/admins.txt
|
TELEGRAM_ADMINS=path/to/admins.txt
|
||||||
|
```
|
||||||
|
|
||||||
Установка зависимостей:
|
###Установка зависимостей:
|
||||||
|
```bash
|
||||||
pip install -r requirements.txt
|
pip install -r requirements.txt
|
||||||
|
```
|
||||||
Запуск бота:
|
###Запуск бота:
|
||||||
|
``` bash
|
||||||
python main.py
|
python main.py
|
||||||
|
```
|
||||||
|
|
||||||
Структура данных
|
##Структура данных
|
||||||
|
|
||||||
База данных:
|
**База данных: **
|
||||||
|
|
||||||
Хранится в формате JSON
|
Хранится в формате JSON
|
||||||
|
|
||||||
Структура:
|
### Структура:
|
||||||
|
```
|
||||||
{
|
{
|
||||||
"user_id": {
|
"user_id": {
|
||||||
"О здравии": ["имя1", "имя2"],
|
"О здравии": ["имя1", "имя2"],
|
||||||
@ -112,18 +85,15 @@ pip install -r requirements.txt
|
|||||||
"Комментарий": "текст комментария"
|
"Комментарий": "текст комментария"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
```
|
||||||
|
##Развертывание
|
||||||
|
|
||||||
Развертывание
|
### Рекомендации:
|
||||||
|
|
||||||
Рекомендации:
|
* Используйте Docker для деплоя
|
||||||
|
* Настройте мониторинг состояния бота
|
||||||
Используйте Docker для деплоя
|
* Добавьте систему автоматического перезапуска
|
||||||
|
* Обеспечьте регулярное резервное копирование данных
|
||||||
Настройте мониторинг состояния бота
|
|
||||||
|
|
||||||
Добавьте систему автоматического перезапуска
|
|
||||||
|
|
||||||
Обеспечьте регулярное резервное копирование данных
|
|
||||||
|
|
||||||
Поддержка и развитие
|
Поддержка и развитие
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user