документация: обновить адрес Gitea

# Conflicts:
#	.gitea/workflows/deploy.yml

.gitattributes

@@ -0,0 +1,3 @@
+components/theme-client.php text eol=lf
+components/theme-switch.php text eol=lf
+components/theme-style.php text eol=lf

.gitea/workflows/deploy.yml

@@ -1,70 +1,136 @@
 name: deploy-preland
 
-# После коммита в main — заливка преленда на хостинги всех целей (FTP с TLS) и проверка страницы каждой цели.
+# Решение владельца 19.10.2026, preland#4: только stage.
-# Цель — домен со своим хостингом (список — matrix ниже): реквизиты — секреты репозитория <prefix>_FTP_HOST,
+# Production выкаты временно отключены; Барбариска больше не используется.
-# <prefix>_FTP_USER, <prefix>_FTP_PASS (порт 21). Цели независимы: сбой одного хостинга остальные не останавливает.
-# Заливаются файлы репозитория (git ls-files), кроме служебных (.gitea/, README.md, .gitignore) и тех, что живут
-# только на хостинге: config.json (в git его нет) и requisites.html (реквизиты заполняют на месте — пустой файл
-# из git их бы затёр). На хостинге ничего не удаляется: удалённое из репозитория убирать вручную.
-
 on:
   push:
     branches:
-      - main
+      - staging
 
 jobs:
-  deploy:
+  deploy-zoomstage:
-    name: deploy ${{ matrix.name }}
+    name: deploy zoomstage.online
-    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/staging'
-
+    runs-on: zoomzilla-production
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          # name — имя цели, url — адрес преленда (для проверки), prefix — префикс секретов <prefix>_FTP_*,
-          # dir — каталог сайта на FTP ("" — корень FTP, как на beget). Новый домен — новая запись и три секрета;
-          # config.json (и requisites.html) создают на хостинге цели — без него проверка страницы не пройдёт.
-          - name: barbariskatest
-            url: https://preland.anton.barbariskatest.ru
-            prefix: PRELAND
-            dir: ""
-
     defaults:
       run:
         shell: sh
-
     env:
-      PRELAND_URL: ${{ matrix.url }}
+      PRELAND_URL: https://zoomstage.online
-      REMOTE_DIR: ${{ matrix.dir }}
+      REMOTE_DIR: domains/zoomstage.online
-
     steps:
-      - name: Install tools (Alpine)
+      - name: Install tools
-        run: apk add --no-cache git curl
+        run: apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates git curl openssh-client sshpass php-cli php-imagick
 
-      - name: Checkout repository
+      - name: Checkout staging branch
-        uses: actions/checkout@v4
-
-      - name: Upload over FTP (TLS)
         env:
-          FTP_HOST: ${{ secrets[format('{0}_FTP_HOST', matrix.prefix)] }}
+          RELEASE_SHA: ${{ github.sha }}
-          FTP_USER: ${{ secrets[format('{0}_FTP_USER', matrix.prefix)] }}
-          FTP_PASS: ${{ secrets[format('{0}_FTP_PASS', matrix.prefix)] }}
         run: |
           set -eu
-          [ -n "$FTP_HOST" ] && [ -n "$FTP_USER" ] && [ -n "$FTP_PASS" ] || { echo "нет секретов ${{ matrix.prefix }}_FTP_*"; exit 1; }
+          git clone --depth 1 --branch staging http://git.dira89kv.beget.tech:3000/anton/preland.git .
-          dir=$(printf '%s' "$REMOTE_DIR" | sed 's#^/*##; s#/*$##')
+          git fetch --depth 1 origin "$RELEASE_SHA"
-          case "$dir" in *[!A-Za-z0-9._/-]*) echo "недопустимый dir: $dir"; exit 1 ;; esac
+          git checkout --detach "$RELEASE_SHA"
+          [ "$(git rev-parse HEAD)" = "$RELEASE_SHA" ]
+
+      - name: Validate release and current stage sets before upload
+        run: |
+          set -eu
+          php bin/release-assets.php --check
+          for test in tests/check-*.php; do php "$test"; done
+          php bin/release-assets.php --primary
+          # preland#22: /N/ — runtime. Проверяем config и декодируем все 90
+          # обязательных изображений используемых наборов, не сверяем с Git SHA.
+          php bin/release-assets.php --stage-sets "$PRELAND_URL"
+
+      - name: Apply approved domain brand only if needed
+        env:
+          SFTP_HOST: ${{ secrets.ZOOMPIXEL_SFTP_HOST }}
+          SFTP_USER: ${{ secrets.ZOOMPIXEL_SFTP_USER }}
+          SFTP_PASS: ${{ secrets.ZOOMPIXEL_SFTP_PASS }}
+          SFTP_KNOWN_HOSTS: ${{ secrets.ZOOMPIXEL_SFTP_KNOWN_HOSTS }}
+        run: |
+          set -eu
+          status=0
+          php bin/release-brand.php --status "$PRELAND_URL" || status=$?
+          case "$status" in 0) exit 0 ;; 10) ;; *) exit "$status" ;; esac
+          # Только точная ранее согласованная пара заменяется по preland#12.
+          # Обычные выпуски с правильным брендом сюда не доходят.
           umask 077
-          netrc=$(mktemp); list=$(mktemp)
+          known_hosts=$(mktemp); batch=$(mktemp); files=$(mktemp)
-          trap 'rm -f "$netrc" "$list"' EXIT
+          trap 'rm -f "$known_hosts" "$batch" "$files"' EXIT
-          printf 'machine %s login %s password %s\n' "$FTP_HOST" "$FTP_USER" "$FTP_PASS" > "$netrc"
+          printf '%s\n' "$SFTP_KNOWN_HOSTS" > "$known_hosts"
-          git ls-files | grep -vE '^(\.gitea/|README\.md$|\.gitignore$|config\.json$|requisites\.html$)' > files.txt
+          php bin/release-brand.php --files "$PRELAND_URL" > "$files"
-          # имя уходит в адрес ftp:// как есть — пробелы и прочее экранирование не поддерживаем
+          revision=$(git rev-parse HEAD)
-          if grep -q '[^A-Za-z0-9._/-]' files.txt; then echo "имена с недопустимыми символами:"; grep '[^A-Za-z0-9._/-]' files.txt; exit 1; fi
+          while read -r source target; do
-          # один curl на все файлы — одно соединение FTP+TLS вместо соединения на файл
+            # Оборванный put не должен оставлять усечённый действующий SVG.
-          while read -r f; do printf 'upload-file = "%s"\nurl = "ftp://%s/%s%s"\n' "$f" "$FTP_HOST" "${dir:+$dir/}" "$f"; done < files.txt > "$list"
+            printf '%s\n' "put -p $source $REMOTE_DIR/$target.upload-$revision" >> "$batch"
-          curl -sS --ssl-reqd --netrc-file "$netrc" --ftp-create-dirs --retry 3 --fail-early -K "$list"
+            printf '%s\n' "rename $REMOTE_DIR/$target.upload-$revision $REMOTE_DIR/$target" >> "$batch"
-          echo "залито файлов: $(wc -l < files.txt)"
+          done < "$files"
+          SSHPASS="$SFTP_PASS" sshpass -e sftp -oBatchMode=no -oStrictHostKeyChecking=yes -oUserKnownHostsFile="$known_hosts" -b "$batch" "$SFTP_USER@$SFTP_HOST"
+          php bin/release-brand.php --status "$PRELAND_URL"
+      - name: Upload over SFTP
+        env:
+          SFTP_HOST: ${{ secrets.ZOOMPIXEL_SFTP_HOST }}
+          SFTP_USER: ${{ secrets.ZOOMPIXEL_SFTP_USER }}
+          SFTP_PASS: ${{ secrets.ZOOMPIXEL_SFTP_PASS }}
+          SFTP_KNOWN_HOSTS: ${{ secrets.ZOOMPIXEL_SFTP_KNOWN_HOSTS }}
+        run: |
+          set -eu
+          [ -n "$SFTP_HOST" ] && [ -n "$SFTP_USER" ] && [ -n "$SFTP_PASS" ] && [ -n "$SFTP_KNOWN_HOSTS" ] || { echo "не заданы секреты ZOOMPIXEL_SFTP_*"; exit 1; }
+          umask 077
+          known_hosts=$(mktemp)
+          batch=$(mktemp)
+          files=$(mktemp)
+          dirs=$(mktemp)
+          trap 'rm -f "$known_hosts" "$batch" "$files" "$dirs"' EXIT
+          printf '%s\n' "$SFTP_KNOWN_HOSTS" > "$known_hosts"
+          # Наборы `/N/` на stage — редактируемый контент. Кодовая доставка их
+          # намеренно не перезаписывает. Обновление набора через админку не требует Git.
+          # Положительный список: admin/tests/bin/планы/секреты не публикуются.
+          php bin/release-assets.php --files | grep -vE '^(config\.json$|[0-9]+/)' > "$files"
+          if grep -q '[^A-Za-z0-9._/-]' "$files"; then echo "имена с недопустимыми символами:"; grep '[^A-Za-z0-9._/-]' "$files"; exit 1; fi
+          printf '%s\n' "-mkdir $REMOTE_DIR" > "$batch"
+          while read -r file; do
+            case "$file" in
+              */*) dir=${file%/*} ;;
+              *) continue ;;
+            esac
+            while [ -n "$dir" ]; do
+              printf '%s\n' "$dir" >> "$dirs"
+              case "$dir" in */*) dir=${dir%/*} ;; *) break ;; esac
+            done
+          done < "$files"
+          sort -u "$dirs" | while read -r dir; do printf '%s\n' "-mkdir $REMOTE_DIR/$dir" >> "$batch"; done
+          while read -r file; do printf '%s\n' "put -p $file $REMOTE_DIR/$file" >> "$batch"; done < "$files"
+          SSHPASS="$SFTP_PASS" sshpass -e sftp -oBatchMode=no -oStrictHostKeyChecking=yes -oUserKnownHostsFile="$known_hosts" -b "$batch" "$SFTP_USER@$SFTP_HOST"
+          echo "залито файлов: $(wc -l < "$files")"
+
+      # api#326/#327: сначала совместимый PHP-код, затем точечная миграция UTM.
+      # chob→banch меняет только токен имени; веса/default владельца сохраняются.
+      # Остальные поля владельца и их JSON-типы сохраняются.
+      - name: Migrate numeric UTM in preserved host config
+        env:
+          SFTP_HOST: ${{ secrets.ZOOMPIXEL_SFTP_HOST }}
+          SFTP_USER: ${{ secrets.ZOOMPIXEL_SFTP_USER }}
+          SFTP_PASS: ${{ secrets.ZOOMPIXEL_SFTP_PASS }}
+          SFTP_KNOWN_HOSTS: ${{ secrets.ZOOMPIXEL_SFTP_KNOWN_HOSTS }}
+        run: |
+          set -eu
+          umask 077
+          known_hosts=$(mktemp); batch=$(mktemp); config=$(mktemp)
+          trap 'rm -f "$known_hosts" "$batch" "$config"' EXIT
+          printf '%s\n' "$SFTP_KNOWN_HOSTS" > "$known_hosts"
+          printf '%s\n' "get -p $REMOTE_DIR/config.json $config" > "$batch"
+          SSHPASS="$SFTP_PASS" sshpass -e sftp -oBatchMode=no -oStrictHostKeyChecking=yes -oUserKnownHostsFile="$known_hosts" -b "$batch" "$SFTP_USER@$SFTP_HOST"
+          changed=0
+          php bin/ensure-utm-config.php "$config" || changed=$?
+          case "$changed" in
+            0) ;;
+            10) revision=$(git rev-parse HEAD)
+                printf '%s\n' "put -p $config $REMOTE_DIR/config.json.upload-$revision" "rename $REMOTE_DIR/config.json.upload-$revision $REMOTE_DIR/config.json" > "$batch"
+                SSHPASS="$SFTP_PASS" sshpass -e sftp -oBatchMode=no -oStrictHostKeyChecking=yes -oUserKnownHostsFile="$known_hosts" -b "$batch" "$SFTP_USER@$SFTP_HOST" ;;
+            *) exit "$changed" ;;
+          esac
 
       - name: Check the page
         run: |
@@ -72,13 +138,52 @@ jobs:
           page=$(curl -fsS --max-time 30 "$PRELAND_URL/?nc=$(date +%s)")
           api=$(printf '%s' "$page" | grep -o 'const createApiUrl = "[^"]*"' || true)
           echo "$api"
-          case "$api" in
+          case "$api" in *'zoomzilla.ru\/api\/images\/public\/create'*) ;; *) echo "на странице нет адреса загрузки Zoomzilla"; exit 1 ;; esac
-            *'\/api\/images\/public\/create'*) ;;
+          printf '%s' "$page" | grep -q 'claim?key=' || { echo "переход не на claim"; exit 1; }
-            *) echo "на странице нет адреса загрузки"; exit 1 ;;
+          # Список наборов берётся из runtime config, а не фиксируется как /1/ и /2/.
-          esac
+          # Полная проверка изображений ниже; одиночный HTTP200 недостаточен.
-          own=$(printf '%s' "$PRELAND_URL" | sed -E 's#^https?://([^/]+).*#\1#')
+          php bin/release-assets.php --remote "$PRELAND_URL"
-          case "$api" in
+          php bin/release-brand.php --status "$PRELAND_URL"
-            *"$own"*) echo "загрузка уходит на сам преленд: на хостинге нет config.json с host"; exit 1 ;;
+
-          esac
+      - name: Remove previously published internal files
-          printf '%s' "$page" | grep -q 'claim?key=' || { echo "переход не на claim — залит старый код?"; exit 1; }
+        env:
-          echo "страница в порядке"
+          SFTP_HOST: ${{ secrets.ZOOMPIXEL_SFTP_HOST }}
+          SFTP_USER: ${{ secrets.ZOOMPIXEL_SFTP_USER }}
+          SFTP_PASS: ${{ secrets.ZOOMPIXEL_SFTP_PASS }}
+          SFTP_KNOWN_HOSTS: ${{ secrets.ZOOMPIXEL_SFTP_KNOWN_HOSTS }}
+        run: |
+          set -eu
+          umask 077
+          known_hosts=$(mktemp); batch=$(mktemp)
+          trap 'rm -f "$known_hosts" "$batch"' EXIT
+          printf '%s\n' "$SFTP_KNOWN_HOSTS" > "$known_hosts"
+          # Только точно известные служебные файлы прежнего deploy, без рекурсии.
+          printf '%s\n' "-rm $REMOTE_DIR/requisites.html" > "$batch"
+          git ls-files tests bin docs/superpowers | while read -r file; do
+            printf '%s\n' "-rm $REMOTE_DIR/$file" >> "$batch"
+          done
+          SSHPASS="$SFTP_PASS" sshpass -e sftp -oBatchMode=no -oStrictHostKeyChecking=yes -oUserKnownHostsFile="$known_hosts" -b "$batch" "$SFTP_USER@$SFTP_HOST"
+
+      - name: Remove obsolete demo directories
+        env:
+          SFTP_HOST: ${{ secrets.ZOOMPIXEL_SFTP_HOST }}
+          SFTP_USER: ${{ secrets.ZOOMPIXEL_SFTP_USER }}
+          SFTP_PASS: ${{ secrets.ZOOMPIXEL_SFTP_PASS }}
+          SFTP_KNOWN_HOSTS: ${{ secrets.ZOOMPIXEL_SFTP_KNOWN_HOSTS }}
+        run: |
+          set -eu
+          umask 077
+          known_hosts=$(mktemp)
+          batch=$(mktemp)
+          trap 'rm -f "$known_hosts" "$batch"' EXIT
+          printf '%s\n' "$SFTP_KNOWN_HOSTS" > "$known_hosts"
+          for set in demo demo-2; do
+            for example in 1 2 3 4 5; do
+              for file in source.avif source.jpg source.webp result.avif result.jpg result.webp thumb.avif thumb.jpg thumb.webp source_mob.avif result_mob.avif thumb_mob.avif; do
+                printf '%s\n' "-rm $REMOTE_DIR/images/$set/$example/$file" >> "$batch"
+              done
+              printf '%s\n' "-rmdir $REMOTE_DIR/images/$set/$example" >> "$batch"
+            done
+            printf '%s\n' "-rmdir $REMOTE_DIR/images/$set" >> "$batch"
+          done
+          SSHPASS="$SFTP_PASS" sshpass -e sftp -oBatchMode=no -oStrictHostKeyChecking=yes -oUserKnownHostsFile="$known_hosts" -b "$batch" "$SFTP_USER@$SFTP_HOST"

.gitignore

@@ -1 +0,0 @@
-config.json