# 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`.