fix: preserve stage example sets during deploy

.gitea/workflows/deploy.yml

@@ -170,7 +170,10 @@ jobs:
           dirs=$(mktemp)
           trap 'rm -f "$known_hosts" "$batch" "$files" "$dirs"' EXIT
           printf '%s\n' "$SFTP_KNOWN_HOSTS" > "$known_hosts"
-          git ls-files | grep -vE '^(\.gitea/|README\.md$|AGENTS\.md$|CLAUDE\.md$|\.gitignore$|requisites\.html$|config\.json$)' > "$files"
+          # Наборы `/N/` на stage — редактируемый контент. Кодовая доставка их
+          # намеренно не перезаписывает: актуальное содержимое stage фиксируют в Git
+          # отдельной синхронизацией по задаче.
+          git ls-files | grep -vE '^(\.gitea/|README\.md$|AGENTS\.md$|CLAUDE\.md$|\.gitignore$|requisites\.html$|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

AGENTS.md

@@ -30,6 +30,10 @@
   такого выпуска фактический stage-config следует забрать и зафиксировать в Git.
   `requisites.html` также живёт только на хостинге и не перезаписывается. Не
   создавать target-specific конфиги или `config.json.example`.
+- Корневые числовые наборы примеров `/N/` на `zoomstage.online` — редактируемый
+  контент stage. Обычный push в `staging` должен исключать `[0-9]+/` из SFTP-заливки:
+  актуальные примеры нельзя перезаписывать Git-версией. Снимок stage фиксируется в
+  Git отдельной синхронизацией по задаче.
 - Коммит в `main` запускает FTP-автодеплой на все цели workflow; откат через `git revert`
   также запускает выкат. Коммит, push и изменения хостинга — только по прямому поручению.
 - Проверки кода и браузера проводить в Docker без установки ПО на хост.

CLAUDE.md

@@ -3,7 +3,7 @@
 Область действия — репозиторий `preland/`. Общие правила рабочей области находятся в
 [AGENTS.md](../AGENTS.md) и [CLAUDE.md](../CLAUDE.md); канонический процесс и каталог ролей —
 [в общей политике](../.known-base/Соглашения/Процесс%20командной%20разработки%20и%20каталог%20ролей.md).
-Этот файл и [AGENTS.md](AGENTS.md) содержат одинаковые локальные правила; обновлять их вместе.
+Этот файл и [CLAUDE.md](CLAUDE.md) содержат одинаковые локальные правила; обновлять их вместе.
 
 ## Перед работой
 
@@ -21,10 +21,19 @@
   переход напрямую на `/public/upscale` не заменяет передачу владельца через claim.
 - `host` задаёт сайт назначения; HTTPS необходим для `crypto.randomUUID()`.
   Не обходить серверные правила доступа к загрузке и результату обработки.
-- Рабочий `config.json` единственный для всех прилендов: это точная проверенная
-  конфигурация `zoomstage.online`, и каждый FTP/SFTP-deploy обязан доставлять её на
-  stage и production. `requisites.html` по-прежнему живёт только на хостинге и не
-  перезаписывается. Не создавать target-specific конфиги или `config.json.example`.
+- Рабочий `config.json` на каждом хостинге настраивает владелец. Деплой не имеет
+  права перезаписывать его значений. При появлении новой обязательной UTM workflow
+  получает текущий хостовый конфиг и меняет только ключи, которые прямо
+  согласованы в задаче. Иные значения, включая уже настроенные UTM, остаются
+  байт-в-байт прежними. Для #274 `bin/ensure-focus-config.php` — явное
+  исключение: он задаёт только новый `focus=face` (default и rnd). После каждого
+  такого выпуска фактический stage-config следует забрать и зафиксировать в Git.
+  `requisites.html` также живёт только на хостинге и не перезаписывается. Не
+  создавать target-specific конфиги или `config.json.example`.
+- Корневые числовые наборы примеров `/N/` на `zoomstage.online` — редактируемый
+  контент stage. Обычный push в `staging` должен исключать `[0-9]+/` из SFTP-заливки:
+  актуальные примеры нельзя перезаписывать Git-версией. Снимок stage фиксируется в
+  Git отдельной синхронизацией по задаче.
 - Коммит в `main` запускает FTP-автодеплой на все цели workflow; откат через `git revert`
   также запускает выкат. Коммит, push и изменения хостинга — только по прямому поручению.
 - Проверки кода и браузера проводить в Docker без установки ПО на хост.

README.md

@@ -103,6 +103,12 @@ N/05_...
 домена целиком: без переименования, вложения в `images/` и промежуточных
 каталогов. Устаревшие `images/demo*` не являются частью поставки.
 
+Для `zoomstage.online` обычный deploy ветки `staging` намеренно **не загружает**
+корневые числовые каталоги `/N/`: это редактируемый контент stage, а не артефакт
+кодовой доставки. Workflow продолжает проверять их доступность HTTP-smoke. Чтобы
+зафиксировать обновлённый набор, сначала синхронизируйте его со stage в Git по
+отдельной задаче; следующая заливка не перетрёт его старой ревизией.
+
 ## Деплой на произвольный домен
 
 **Требования.** PHP 8.0+ (боевой хостинг — 8.2), веб-сервер с `index.php` в роли индексного файла и **HTTPS**:

tests/check-demo-layout.php

@@ -60,6 +60,10 @@ foreach ([
     }
 }
 
+if (!str_contains($workflow, '|[0-9]+/)')) {
+    $failures[] = 'Stage-деплой не должен перезаписывать корневые наборы /N/: stage владеет их содержимым.';
+}
+
 if (substr_count($workflow, 'while [ -n "$dir" ]; do') < 2) {
     $failures[] = 'SFTP-деплой должен создавать все родительские каталоги для новых наборов assets.';
 }