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-ct105-vectors.sh

@@ -3,12 +3,15 @@
 # Запускать на хосте Proxmox под root. Использует pct exec.
 # Результат: /mnt/backup/other/ct105-vectors/vectors-YYYYMMDD-HHMM.tar.gz
 set -e
+export PATH="/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:${PATH:-}"
 
 CT_ID=105
-REMOTE_PATH="/home/rag-service/data/vectors"
 BACKUP_DIR="/mnt/backup/other/ct105-vectors"
 RETENTION_DAYS=14
 
+# Минимальный размер архива (байт). Пустой gzip ≈ 20 байт — каталог пуст или путь неверный.
+MIN_BACKUP_BYTES=512
+
 if [ "$(id -u)" -ne 0 ]; then
   echo "Запускайте под root."
   exit 1
@@ -17,15 +20,31 @@ fi
 mkdir -p "$BACKUP_DIR"
 DATE=$(date +%Y%m%d-%H%M)
 OUTPUT="$BACKUP_DIR/vectors-$DATE.tar.gz"
+ERR=$(mktemp)
+trap "rm -f '$ERR'" EXIT
 
-pct exec $CT_ID -- tar cf - -C /home/rag-service/data vectors 2>/dev/null | gzip > "$OUTPUT"
+pct exec $CT_ID -- tar cf - -C /home/rag-service/data vectors 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} байт). Проверьте /home/rag-service/data/vectors в CT $CT_ID."
+  [ -s "$ERR" ] && cat "$ERR" >&2
   rm -f "$OUTPUT"
   exit 1
 fi
 
 find "$BACKUP_DIR" -name 'vectors-*.tar.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="Резервное копирование завершено.
+Объекты: архив векторов RAG (CT 105, vectors.npz).
+Размер копии: ${SIZE}."
+  [ "$SIZE_BYTES" -lt 10240 ] 2>/dev/null && BODY="${BODY}
+⚠️ Подозрительно малый размер — проверьте /home/rag-service/data/vectors в CT 105."
+  "$NOTIFY_SCRIPT" "📐 Векторы RAG" "$BODY" || true
+fi