Enhance Docker setup and user notification features

- Updated docker-compose.yml to include environment variables and health checks for the app service. - Modified Dockerfile to install curl for health checks and adjusted the build process for backend services. - Improved user notification handling in activation, blocking, and config revocation commands by integrating Telegram notifications. - Added new test cases to validate the updated command handlers and Telegram notifier functionality. - Enhanced documentation to reflect the new Telegram bot features and user management improvements.
2026-07-02 01:16:53 +03:00
parent 7b6fe9ad78
commit ed07221ca5
15 changed files with 404 additions and 34 deletions
@@ -64,23 +64,31 @@
 - Фронт: таблицы пользователей/конфигов/ролей, журнал аудита, графики трафика (Recharts), сводки.
 - **Готово, когда**: админ видит статистику и журнал, управляет пользователями/ролями/конфигами; блокировка гасит VPN.

-## M7 — Telegram-бот
+## M7 — Telegram-бот ✅
 - Библиотека Telegram.Bot, `TelegramBotHostedService` (long polling) в процессе Api, `IOptions<TelegramOptions>`.
 - Домен: поля Telegram у `AppUser`, `TelegramLinkToken`, `TelegramLoginRequest`.
 - Флоу привязки (`LinkTelegramCommand`) + эндпоинт `link-token`/`unlink`.
- Passwordless-вход: `login-request` + подтверждение в боте (`ApproveTelegramLoginCommand`) → выпуск JWT; поллинг/SignalR-завершение на фронте.
- Восстановление пароля через бота (`/resetpassword` → одноразовая ссылка на смену пароля).
- Команды бота: `/start`, меню, «Мои конфиги» (`GetMyConfigsQuery`), «Открыть сайт», `/login`, `/unlink`, `/help`; QR в боте.
+- Passwordless-вход: `login-request` + подтверждение в боте (`ApproveTelegramLoginCommand`) → выпуск JWT; поллинг завершения на фронте (`GET /api/auth/telegram/login-request/{id}`).
+- Команды бота: `/start`, меню, «Мои конфиги» (`GetMyConfigsQuery`), `/login`, `/unlink`, `/requests`, `/help`.
 - **Админ в боте**: уведомления о запросах активации + inline «Активировать/Отклонить», `/requests` (по Telegram id из env).
- **DM-уведомления юзеру**: активация, отзыв конфига админом, блокировка (если Telegram привязан). Бот — read-only по конфигам.
- Фронт: кнопки «Войти через Telegram» и «Привязать Telegram» (deep-link/QR + ожидание подтверждения).
- **Готово, когда**: юзер привязывает Telegram, входит без пароля, видит конфиги; админ активирует запросы прямо в боте.
+- **DM-уведомления юзеру**: активация (`ApproveActivationCommandHandler`), блокировка (`BlockUserCommandHandler`), принудительный отзыв конфига админом (`ForceRevokeConfigCommandHandler`) — если Telegram привязан. Бот — read-only по конфигам.
+- **Готово, когда**: юзер привязывает Telegram, входит без пароля, видит конфиги; админ активирует запросы прямо в боте. ✅ Достигнуто.
+- **Перенесено в backlog** (не реализовано в MVP): восстановление пароля через бота (`/resetpassword` с одноразовой ссылкой) — сейчас сброс пароля только через админа (`ResetUserPasswordCommand`); QR прямо в сообщениях бота; фронтовые кнопки «Войти через Telegram»/«Привязать Telegram» (бэкенд-контракт готов, фронт не реализовывался в эту итерацию).

-## M8 — Закалка (hardening)
- Полный набор тестов (Domain/Application/Integration с Testcontainers).
- Rate-limiting, аудит-лог действий, единообразные ProblemDetails, ретеншн `TrafficSample`.
- Прод-конфиг docker-compose (secrets, том для key-ring Data Protection, healthchecks); TLS — внешним прокси.
- **Готово, когда**: зелёный CI, покрытие ключевых сценариев, готовность к деплою.
+## M8 — Закалка (hardening) ✅
+- Тесты: `PnvPanel.Domain.Tests` (54, чистые unit-тесты инвариантов сущностей), `PnvPanel.Application.Tests`
+  (71, CQRS-хендлеры на EF Core InMemory + NSubstitute-моки портов), `PnvPanel.IntegrationTests`
+  (Testcontainers.PostgreSql + `WebApplicationFactory<Program>` — реальный HTTP-контракт, включая
+  проверку `pg_advisory_xact_lock` под параллельной нагрузкой на квоту конфигов).
+- Rate-limiting, аудит-лог, единообразные `ProblemDetails`, ретеншн `TrafficSample` — сделаны в M5/M6.
+- CI (`.github/workflows/ci.yml`): `dotnet build/test` (backend, включая интеграционные — на
+  `ubuntu-latest` Docker доступен) + `pnpm lint/typecheck/build` (frontend), без деплоя.
+- Прод-`docker-compose.yml`: `env_file: .env` прокидывает все секреты в контейнер `app`, том
+  `dp_keys` для key-ring Data Protection (переживает пересоздание контейнера), healthcheck `app`
+  через `GET /health` (curl добавлен в runtime-образ). TLS — внешним прокси (без изменений).
+- **Готово, когда**: зелёный CI, покрытие ключевых сценариев, готовность к деплою. ✅ Достигнуто
+  (интеграционные тесты не запускались локально — Docker Desktop недоступен на машине разработки;
+  зависят от Docker в CI для первого реального прогона).

 ## Backlog (после MVP)
 - Полное самообслуживание в боте (создание/ротация/отзыв конфигов) — в MVP бот read-only.
@@ -16,9 +16,10 @@ Telegram-бот — **второй канал доставки** (presentation-
   о запросе активации с комментарием заявителя и жмёт «Активировать / Отклонить» прямо в боте.
 5. **DM-уведомления пользователю** — если Telegram привязан, бот шлёт личные уведомления о ключевых
   событиях: «аккаунт активирован», «конфиг отозван админом», «вы заблокированы».
-6. **Восстановление пароля** — если пароль забыт, привязанный пользователь через бота получает
-   одноразовую ссылку на страницу задания нового пароля (или входит passwordless и меняет пароль в
-   настройках). Без привязки Telegram восстановление делает только админ.
+6. **Восстановление пароля** — реализовано через passwordless-вход: привязанный пользователь входит
+   через бота (`/login`) и меняет пароль в настройках (`ChangePasswordCommand`). Без привязки
+   Telegram сброс делает только админ (`ResetUserPasswordCommand`). Отдельная команда бота
+   `/resetpassword` с одноразовой ссылкой на смену пароля — **backlog**, в MVP не реализована.

 > **Скоуп бота в MVP — просмотр (read-only) по конфигам.** Создание/ротация/отзыв конфигов — только
 > на сайте. Полное самообслуживание в боте (создание/отзыв) — в backlog.
@@ -104,18 +105,18 @@ Telegram  ──updates──►  TelegramBotHostedService (Api)

 | Команда / кнопка       | Действие                                                        | Требует привязки |
 | ---------------------- | -------------------------------------------------------------- | ---------------- |
-| `/start`               | Приветствие + меню (Открыть сайт / Мои конфиги / Войти)         | нет              |
+| `/start`               | Приветствие + справка по командам                               | нет              |
 | `/start link_<t>`      | Привязка аккаунта по токену                                     | нет              |
-| `/start login_<n>`     | Подтверждение passwordless-входа                               | да               |
-| «Открыть сайт»         | Ссылка на веб-панель (опц. одноразовый auto-login deep link)   | нет / да         |
+| `/start login_<n>`     | Подтверждение passwordless-входа (deep-link с сайта)            | да               |
 | `/configs`             | Список конфигов                                                | да               |
-| `/login`               | Инициировать/подтвердить вход                                  | да               |
-| `/resetpassword`       | Одноразовая ссылка на смену пароля (восстановление)            | да               |
 | `/unlink`              | Отвязать Telegram от аккаунта                                  | да               |
 | `/help`                | Справка                                                        | нет              |
 | «Активировать/Отклонить» | (admin) решение по запросу активации                         | админ по env     |
 | `/requests`            | (admin) список ожидающих запросов активации                    | админ по env     |

+> Passwordless-вход и `/resetpassword` инициируются с сайта (кнопка «Войти через Telegram»),
+> не отдельной командой бота — см. пункт 6 выше про `/resetpassword` (backlog).
+
 ## Безопасность

 - Токены привязки и nonce входа: высокоэнтропийные, **короткоживущие** (≈2–5 мин), **одноразовые**.