MVP

README.md

@@ -17,7 +17,7 @@
 python -m venv .venv
 . .venv/Scripts/activate
 pip install -r requirements.txt
-uvicorn main:app --host 0.0.0.0 --port 8080 --reload
+uvicorn main:app --host 0.0.0.0 --port 8080 --reload --env-file .env
 ```
 
 ## Переменные окружения
@@ -38,3 +38,44 @@ uvicorn main:app --host 0.0.0.0 --port 8080 --reload
 
 Для Telegram укажите URL вашего сервиса с путем `/telegram/webhook`.
 Для Gitea включите события `pull_request` и задайте общий секрет.
+
+## Локальная разработка через Tuna
+
+Если бот запущен локально, Gitea/Telegram не смогут достучаться до `localhost` без туннеля.
+
+1. Запустите бота:
+
+```bash
+uvicorn main:app --host 0.0.0.0 --port 8080 --reload --env-file .env
+```
+
+2. Поднимите туннель в Tuna(https://my.tuna.am/) на локальный порт `8080` и получите публичный URL, например:
+
+```text
+https://example.ru.tuna.am
+```
+
+3. Проверьте доступность сервиса:
+
+```text
+https://example.ru.tuna.am/health
+```
+
+4. Настройте webhook в Gitea:
+- Target URL: `https://example.ru.tuna.am/gitea/webhook`
+- Method: `POST`
+- Content Type: `application/json`
+- Secret: тот же, что в `GITEA_WEBHOOK_SECRET`
+- Events: `Pull Request` (Custom Events)
+
+5. Настройте webhook в Telegram:
+
+```text
+https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/setWebhook?url=https://example.ru.tuna.am/telegram/webhook
+```
+
+6. Проверьте, что webhook установлен:
+
+```text
+https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/getWebhookInfo
+```