Навести порядок в deploy и документации проекта

deploy/backup/AGENTS.md

@@ -0,0 +1,30 @@
+# AGENTS для deploy/backup
+
+## Назначение
+- Папка `deploy/backup/` хранит:
+  - тяжёлые локальные бэкапы сервера (НЕ в git);
+  - лёгкую схему восстановления (в git), чтобы можно было поднять сервер даже без полного архива.
+
+## Структура
+- `archive/YYYY-MM-DD/` — полный бэкап конкретной даты.
+- `scheme/shineup.me/` — схема восстановления и ключевые конфиги.
+- `backup-version.properties` — версия контура бэкапа.
+
+## Правила
+- Полный бэкап складывать только в `deploy/backup/archive/`.
+- `deploy/backup/archive/**` не коммитить, кроме `.gitkeep`.
+- Перед production deploy проверить, что свежий бэкап скопирован в `deploy/backup/archive/<дата>/` и есть `MANIFEST.txt`.
+- Любое изменение схемы восстановления фиксировать в git.
+- После обновления схемы увеличивать `backup.schema.version`.
+- После нового полного бэкапа увеличивать `backup.full.version`.
+
+## Как обновлять бэкап
+1. Обновить схему:
+   - `bash deploy/backup/scheme/shineup.me/scripts/refresh_scheme.sh`
+2. Сделать новый полный бэкап:
+   - `bash deploy/backup/scheme/shineup.me/scripts/backup_full.sh`
+3. Проверить `deploy/backup/archive/<дата>/MANIFEST.txt`.
+4. Поднять версии в `deploy/backup/backup-version.properties`.
+
+## Как восстанавливать
+- Смотреть `deploy/backup/scheme/shineup.me/docs/RESTORE.md`.