feat: add backups feature

2026-05-27 13:53:30 +03:00
parent e90988ea5c
commit 3aede8fe95
55 changed files with 3032 additions and 70 deletions
@@ -92,7 +92,7 @@ docker compose logs -f backend
 - `/auth/telegram/start` и `/auth/telegram/callback` проходят через frontend nginx в `backend:8081`;
 - в браузере после callback нет статуса `telegram_auth=invalid_state`, `invalid_token`, `not_configured`, `unauthorized` или `failed`.

-Подробности по маршрутам и настройке OAuth: [веб-приложение / Mini App](../features/web-app.md).
+Подробности по маршрутам и настройке OAuth: [Telegram-авторизация](../features/telegram-auth.md).

 ## После изменения конфигурации

@@ -1,6 +1,6 @@
 # Обслуживание

-Плановое обслуживание обычно сводится к обновлению образов, проверке миграций, логов и резервных копий PostgreSQL.
+Плановое обслуживание обычно сводится к обновлению образов, проверке миграций, логов и резервных копий. Подробная инструкция по автоматическим ZIP-бэкапам и восстановлению вынесена в [бэкапы и восстановление](../features/backups.md).

 ## Обновление

@@ -16,6 +16,19 @@ docker compose logs -f migrate backend worker
 docker compose exec -T postgres sh -c 'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB"' > backup.sql
 ```

+## Автоматические бэкапы
+
+Worker может собирать ZIP-архивы с дампом PostgreSQL и snapshot compose-папки, отправлять их в Telegram и хранить последние архивы в `data/backups`. Настройка и восстановление описаны в [отдельном разделе](../features/backups.md).
+
+После изменения backup-настроек в `.env` перезапустите backend и worker:
+
+```bash
+docker compose up -d --build backend worker
+docker compose logs -f backend worker
+```
+
+Восстановление из архива доступно в админке **Система -> Бэкапы**. Там же можно загрузить ZIP вручную, выбрать `БД` и/или `compose-папка`, а backend проверит архив перед запуском. Подробности: [бэкапы и восстановление](../features/backups.md#восстановление-из-админки).
+
 ## Проверки после работ

 - `docker compose ps`