Add notification feature to backup scripts for various services

Enhance backup scripts for Nextcloud, Gitea, Paperless, Vaultwarden, Immich, and VPS configurations by adding Telegram notifications upon completion. Include details such as backup size and objects backed up. Update backup documentation to reflect these changes and ensure clarity on backup processes and retention policies.

scripts/backup-ct104-pgdump.sh

@@ -3,6 +3,7 @@
 # Запускать на хосте Proxmox под root. Использует pct exec.
 # Результат: /mnt/backup/databases/ct104-paperless/paperless-db-YYYYMMDD-HHMM.sql.gz
 set -e
+export PATH="/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:${PATH:-}"
 
 CT_ID=104
 BACKUP_DIR="/mnt/backup/databases/ct104-paperless"
@@ -14,18 +15,47 @@ if [ "$(id -u)" -ne 0 ]; then
   exit 1
 fi
 
+# Минимальный размер дампа (байт). Пустой gzip ≈ 20 байт — значит pg_dump не отдал данные.
+MIN_BACKUP_BYTES=512
+
 mkdir -p "$BACKUP_DIR"
 DATE=$(date +%Y%m%d-%H%M)
 OUTPUT="$BACKUP_DIR/paperless-db-$DATE.sql.gz"
+ERR=$(mktemp)
+trap "rm -f '$ERR'" EXIT
 
-pct exec $CT_ID -- docker exec "$PG_CONTAINER" pg_dump -U paperless paperless 2>/dev/null | gzip > "$OUTPUT"
+# PGPASSWORD из Vaultwarden (объект PAPERLESS, пароль). См. docs/backup/proxmox-phase1-backup.md
+PG_ENV_ARGS=""
+BW_MASTER_PASSWORD_FILE="${BW_MASTER_PASSWORD_FILE:-/root/.bw-master}"
+if [ -f "$BW_MASTER_PASSWORD_FILE" ] && command -v bw >/dev/null 2>&1; then
+  export BW_SESSION=$(bw unlock --passwordfile "$BW_MASTER_PASSWORD_FILE" --raw 2>/dev/null) || true
+  if [ -n "${BW_SESSION:-}" ]; then
+    PGPASS=$(bw get password "PAPERLESS" 2>/dev/null)
+    [ -n "$PGPASS" ] && PG_ENV_ARGS="-e PGPASSWORD=$PGPASS"
+  fi
+fi
+pct exec $CT_ID -- docker exec $PG_ENV_ARGS "$PG_CONTAINER" pg_dump -U paperless paperless 2>"$ERR" | gzip > "$OUTPUT"
 
-if [ -s "$OUTPUT" ]; then
-  echo "Создан: $OUTPUT ($(du -h "$OUTPUT" | cut -f1))"
+SIZE_BYTES=$(stat -c%s "$OUTPUT" 2>/dev/null || echo 0)
+if [ -s "$OUTPUT" ] && [ "$SIZE_BYTES" -ge "$MIN_BACKUP_BYTES" ]; then
+  echo "Создан: $OUTPUT ($(du --apparent-size -h "$OUTPUT" | cut -f1))"
 else
-  echo "Ошибка: дамп пустой или контейнер недоступен."
+  echo "Ошибка: дамп пустой или слишком мал (${SIZE_BYTES} байт). Проверьте контейнер $PG_CONTAINER и пароль БД в Vaultwarden (PAPERLESS)."
+  [ -s "$ERR" ] && cat "$ERR" >&2
   rm -f "$OUTPUT"
   exit 1
 fi
 
 find "$BACKUP_DIR" -name 'paperless-db-*.sql.gz' -mtime +$RETENTION_DAYS -delete
+
+NOTIFY_SCRIPT="${NOTIFY_SCRIPT:-/root/scripts/notify-telegram.sh}"
+if [ -x "$NOTIFY_SCRIPT" ]; then
+  SIZE=$(du --apparent-size -h "$OUTPUT" | cut -f1)
+  SIZE_BYTES=$(stat -c%s "$OUTPUT" 2>/dev/null || echo 0)
+  BODY="Резервное копирование завершено.
+Объекты: дамп БД Paperless (PostgreSQL).
+Размер копии: ${SIZE}."
+  [ "$SIZE_BYTES" -lt 10240 ] 2>/dev/null && BODY="${BODY}
+⚠️ Подозрительно малый размер — проверьте контейнер paperless-db-1 и наличие данных в БД."
+  "$NOTIFY_SCRIPT" "🗄️ Paperless (БД)" "$BODY" || true
+fi