Завершена настройка домена для дева, теста и прода. Соединение через ssh-туннель

README.md

@@ -144,9 +144,9 @@ docker compose -f docker-compose.test.yml down -v   # остановить и с
 
 **Настройка Telegram (когда будете подключать реальный вход):**
 1. Создать бота у [@BotFather](https://t.me/BotFather) → получить **токен** и **username**.
-2. `/setdomain` у BotFather → ваш HTTPS-домен (где открывается приложение).
+2. `/setdomain` у BotFather → оба домена: `forbiddenstars.ru` (prod) и `forbidden-stars.ru` (dev/test).
 3. В `.env`: `TELEGRAM_BOT_TOKEN=...`, `TELEGRAM_BOT_USERNAME=...` (без `@`).
-4. Домену нужен HTTPS (например, Cloudflare Tunnel) — виджет не работает по голому HTTP.
+4. Виджету нужен HTTPS-домен (см. «Домен и публикация») — по голому HTTP/localhost он не работает.
 
 Админ-вход (секретная панель, логин+пароль) — отдельный механизм, доступен во всех окружениях.
 
@@ -184,6 +184,24 @@ docker compose -f docker-compose.test.yml down -v   # остановить и с
 
 Секреты (`.env`) и данные (`data/`, `*.db`) в git не идут — см. `.gitignore`.
 
+## Домен и публикация
+
+Публичные адреса отдаёт **VPS-привратник** (Caddy + HTTPS твоими сертификатами), а
+приложение само открывает к нему SSH-туннель (дома белого IP нет — CGNAT):
+
+| | домен | источник | туннель |
+|---|---|---|---|
+| prod | `forbiddenstars.ru` | Pi, `app:8000` | autossh, постоянно (VPS:9000) |
+| dev/test | `forbidden-stars.ru` | ПК, vite:5173 / app:8080 | `ssh -R`, по требованию (VPS:9001) |
+
+- Прод и dev/test на **разных доменах** → могут работать одновременно. Dev и test делят
+  слот `9001` — по очереди.
+- Публикация локалки: в `.env` поставить `LOCAL_PUBLIC=vps` и запустить `run.ps1` — лаунчер
+  сам поднимет SSH-туннель. `LOCAL_PUBLIC=local` — только localhost.
+- `COOKIE_SECURE` выводится автоматически (HTTPS-домен ⇒ Secure-cookie; dev+localhost ⇒ нет).
+- Пошаговая настройка — в [`deploy/`](deploy/README.md): `vps/` (Caddy, сертификаты, туннель-юзер),
+  `pi/` (Docker-приложение + autossh-служба).
+
 ## Дополнения и фракции
 
 | Дополнение | Фракции |