tg-feedback-bot-ru
Телеграм‑бот для обработки пользовательских обращений: принимает сообщения из личных чатов, пересылает их администраторам и позволяет отвечать пользователям из приватных и групповых чатов. Хранение состояния всегда выполняется в PostgreSQL (SQLAlchemy + aiotgbot storage).
Требования
- Python 3.14+
- PostgreSQL для хранения состояния
Переменные окружения
Приложение полностью конфигурируется через env vars (см. src/tg_feedback_bot_ru/settings.py). Подготовьте файл .env или используйте пример bot_env.example.
| Переменная | Назначение |
|---|---|
TZ |
Часовой пояс процесса (Europe/Moscow, UTC и т.д.). |
TG_TOKEN |
Bot API token. Можно передать напрямую или через Docker secret. |
ADMIN_USERNAME |
Telegram username администратора без @. |
CHAT_LIST_SIZE |
Размер списка последних чатов для быстрых ответов (1–20). |
POSTGRES_DSN |
DSN PostgreSQL в формате SQLAlchemy async (postgresql+asyncpg://…). |
Все переменные обязательны (для CHAT_LIST_SIZE и POSTGRES_DSN есть значения по умолчанию, но в проде лучше задавать их явно).
Локальная разработка
uv sync --group dev
uv run python -m tg_feedback_bot_ru
Полезные команды:
uv run ruff format --check src/tg_feedback_bot_ruuv run ruff check src/tg_feedback_bot_ruuv run mypy src/tg_feedback_bot_ruuv run basedpyright
Docker
Официальный образ собирается GitHub Actions из опубликованной версии PyPI. Локально можно:
docker build --build-arg BOT_VERSION=0.3.0 -t tg-feedback-bot-ru:0.3.0 .
docker run --env-file bot_env.example tg-feedback-bot-ru:0.3.0
В проде используйте образ ghcr.io/gleb-chipiga/tg-feedback-bot-ru:<tag> (теги совпадают с v* релизами). Он ожидает переменные окружения из таблицы выше и запускает консольный скрипт tg-feedback-bot-ru.
Metadata
Release files for tg-feedback-bot-ru 0.4.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tg_feedback_bot_ru-0.4.4.tar.gz | 12.3 kB | Without provenance | Details for tg_feedback_bot_ru-0.4.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tg_feedback_bot_ru-0.4.4-py3-none-any.whl | Python 3 | none | any | Details for tg_feedback_bot_ru-0.4.4-py3-none-any.whl |
Total release size: 28.5 kB
Release files / tg_feedback_bot_ru-0.4.4.tar.gz
| Download URL | tg_feedback_bot_ru-0.4.4.tar.gz |
|---|---|
| Size | 12.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4b2d44697838cfbff6bbd224a002a7fb99be995c94967a1cbfd801fbd0f0aae5
|
|
BLAKE2b-256 checksum How to use checksums |
73d5df18753e7ce39421611f7c7ab5221b793cc6448397789897b24d9fb5bad0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.11 {"installer":{"name":"uv","version":"0.9.11"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / tg_feedback_bot_ru-0.4.4-py3-none-any.whl
| Download URL | tg_feedback_bot_ru-0.4.4-py3-none-any.whl |
|---|---|
| Size | 16.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9cd1c75c34fb02e3faf6a059c57b824407a21a74d8d7beb65638efc027a3ddf9
|
|
BLAKE2b-256 checksum How to use checksums |
6e65a8339d3fa6e33b3f490c23b361a3e41a2cd9e9e3acdc2e74e83b357d6bc4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.11 {"installer":{"name":"uv","version":"0.9.11"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for tg-feedback-bot-ru 0.4.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.