Преленд zoomzilla
Боевые домены — поручение 25.10.2026, preland#21
Три боевые цели: zoompixel.ru на основном сервере, zoomila.ru и zoomika.ru
на двух отдельных хостингах REG.RU. Это отдельное разрешение владельца на первоначальное
размещение/обновление этих целей после заморозки #4. Единственный активный .online —
zoomstage.online, staging прелендингов. zoompixel.online, zoomika.online и
zoomila.online отключены по дополнительному решению владельца; их регистрация сохранена.
Рабочие FTP/SFTP-каталоги не должны содержать директории отключённых .online.
| Домен | Размещение | Пользователь SFTP/FTP | Каталог сайта |
|---|---|---|---|
zoomika.ru |
server197.hosting.reg.ru, 31.31.196.183 |
u3695919 |
/www/zoomika.ru относительно домашнего каталога |
zoomila.ru |
server124.hosting.reg.ru, 37.140.192.195 |
u3695920 |
/www/zoomila.ru относительно домашнего каталога |
zoompixel.ru |
основной сервер, /srv/preland/domains/zoompixel.ru |
существующий административный доступ | отдельный контейнер preland-zoompixel-ru-1 |
REG.RU выдаёт SFTP/SSH и FTP отдельно: SFTP использует порт 22 и пароль из блока
«Доступ в панель управления, SSH, SFTP»; FTP — порт 21 и отдельный пароль из блока
«Доступ к FTP». Пароли смотреть в кабинете REG.RU → нужный хостинг → «Доступы»;
не помещать в Git и журналы. Оба аккаунта уже созданы провайдером, сбрасывать пароли
для размещения не требуется. Полные домашние каталоги — /var/www/<пользователь>/data.
В www каждого REG.RU-аккаунта оставлен только соответствующий .ru. Сайты .online
выключены через ispmanager, их исходные файлы и установочные архивы сохранены вне webroot
в скрытом .preland21-backup/ (каталог site, файлы release.zip, initial-index.html).
На основном сервере zoompixel.online отвечает HTTP/HTTPS 410; его контейнер удалён,
сервис исключён из Compose, исходники сохранены в /srv/preland/backups/preland21-disabled-online/site.
Логотипы для обеих тем — готовые SVG в brands/<домен>/, реестр — release/brands.json.
При первоначальном размещении копировать только положительный список releaseFiles()
и проверенные статические ресурсы (включая /1, /2), затем доменную пару в
docs/logo.svg/docs/logo-alt.svg. Служебные bin/, tests/, .git/, планы и
установочные архивы в webroot не входят. Архивы REG.RU хранить вне /www.
У новых пустых сайтов исходный config — проверенный stage-снимок; существующий
zoompixel.ru/config.json сохраняется байт-в-байт, старые UTM нормализуются в памяти.
Перед трафиком обязательны доверенный TLS (самоподписанный сертификат REG.RU не подходит),
HTTP→HTTPS, проверка двух тем/ширин, примеров, upload→claim→Tour→Join с UTM,
видимой ошибки и повторной попытки. Точный состав, коммиты, результаты и ограничения — #21.
Обычная автоматическая доставка по-прежнему только staging → zoomstage.online;
данное первоначальное размещение не включает production-автодеплой по push main.
Исторические разделы ниже описывают прежние цели; при расхождении действует этот раздел.
Одностраничный лендинг перед основным сайтом (zoomzilla.ru): посетитель с рекламы выбирает фото прямо на
преленде, файл сразу уходит в API сайта, а сам посетитель переходит на сайт — на страницу обработки этого фото.
Варианты страницы и сайта (A/B) задаются метками в адресе. Код — обычный PHP без фреймворка и сборки; переводы —
маленькая заглушка Yii::t в i18n.php.
Активные production: https://zoompixel.ru, https://zoompixel.online; текущая цель выката — только https://zoomstage.online. Пример ссылки входа:
https://zoomstage.online/?indpic=e9st1mm12b&theme=e9st1mm12b°r=e9st2mm12b®=e9st2mm12b&banch=e9st2mm12b&tp=e9st1mm12b&utm_source=test&subid=CLICK1.
Как работает
Метки (api#326)
Из публичного значения учитывается только пятый символ: цифра1–9 выбирает вариант,0 на Preland выбирает его по прежним weights. Отсутствующий, короткий, массивный и невалидный ввод получает default. Открытые 1, rnd, dark, старые имена registration/bchoice/chob/chb больше не выбирают варианты. Точная длина входной строки не ограничена; Unicode-шум не изменяет позицию управляющего символа.
| Метка | Числовые значения |
|---|---|
indpic |
номер настроенного набора1–9 (/1/, /2/ и т.д.) |
theme |
1 dark,2 light |
degr |
номер настроенной группы1–9 |
reg |
1 before (PIN до оплаты),2 after |
banch |
1 без попапа банка,2 с попапом |
tp |
номер настроенной тарифной группы1–9 |
cons |
номер группы согласий1–9; существование проверяет API |
focus |
1 face,2 center |
part |
1 показывать ссылку «Для бизнеса» на сайте,2 скрывать; Preland ссылку не показывает |
config.json хранит публичные числовые weights/default. Внутри PHP сохраняются прежние semantic enum. Runtime-конфиг мигрируется bin/ensure-utm-config.php: только согласованные UTM, с сохранением весов, default и JSON-типов соседних полей. Скрипт идемпотентен; старые focus/cons patch-скрипты больше не вызываются доставкой.
В api#327 публичное chob заменено на banch; внутренний bchoice сохраняется. Мигратор переименовывает текущий host-ключ токенно, сохраняя все остальные байты, включая веса и default. Одновременные banch/chob/bchoice блокируют patch без записи. До миграции код читает прежний host-config; сохранённые recovery-записи с utmDigits.chob или redirectUtm продолжают выбранный вариант и выпускают уже banch.
Перед каждым переходом Preland создаёт для всех девяти меток новый шум из10 ASCII букв/цифр, с уже выбранной цифрой в пятой позиции. Retry и recovery меняют только шум; вариант повторно не выбирается. Выбранные цифры сохраняются в upload record. Старые записи IndexedDB адаптируются только на пути recovery, без публичных alias старого URL.
Чужие параметры (utm_source, keyword, subid и любые другие) сохраняют значения после обычного URL-кодирования. Технические key/id/stage/shown_theme не маскируются; внешний key не может подменить одноразовый ключ загрузки. shown_theme берётся из фактически показанной темы непосредственно при переходе.
Загрузка и переход на сайт
- Браузер проверяет файл: изображение, не больше 6000 px по большей стороне.
- XHR
POST https://<host>/api/images/public/create(multipart/form-data:fileиclient_key— случайный UUID загрузки,crypto.randomUUID()),Accept: application/json. Ответ — JSON с id обработки. - Браузер переходит на
https://<host>/api/images/public/claim?key=<client_key>&<метки>. Сайт кладёт загрузку в сессию посетителя и отвечает 302 на/public/upscale?id=<обработка>&<метки>(уже без ключа); страница сама запускает обработку.
Почему не сразу /public/upscale: XHR с преленда кросс-доменный, и сессия, в которой сайт запомнил загрузку,
посетителю на сайте недоступна — браузеры изолируют или не принимают куки третьей стороны. Страница обработки
пускает только владельца загрузки, поэтому без передачи по ключу посетитель видел 404. Ключ одноразовый и годен
30 минут после загрузки.
<host> — домен сайта из config.json. API сайта принимает загрузку с любого домена (CORS отражает Origin), так
что для нового домена преленда на сайте ничего настраивать не нужно.
Файлы
| Путь | Назначение |
|---|---|
index.php |
вход: конфиг, разбор меток, адреса API и перехода, общие переменные, renderComponent() |
template.php |
разметка страницы: шапка, блок загрузки, примеры, подвал с реквизитами |
components/form.php |
форма выбора файла и загрузка (XHR, client_key, переход на claim) |
components/preview.php, process.php, examples.php |
превью файла, индикатор загрузки, примеры «до/после» |
i18n.php, messages/{ru,en}/ |
заглушка Yii::t и переводы; язык сейчас всегда ru (определение языка закомментировано) |
docs/ |
logo.svg, logo-alt.svg и документы в PDF: тарифы, оферта, соглашение, политика |
requisites.html |
реквизиты для подвала (HTML), если в config.json нет requisites. Без обоих — заглушка «ИП Иванов Иван Иванович» из template.php |
images/, fonts/, favicon/, *.css |
статика; style.min.css встраивается в страницу |
.htaccess |
только сроки кэширования статики (Apache) |
config.json |
снимок актуального stage-конфига и схема. Рабочий конфиг на каждом хостинге настраивает владелец; deploy не заменяет его и меняет только явно согласованные в задаче ключи. После такого изменения актуальный stage-снимок забирают обратно в Git |
config.json
| Ключ | Обязательный | Что задаёт |
|---|---|---|
host |
да | домен сайта, куда идут загрузка и переход (zoomzilla.ru). Без него берётся домен самого преленда — запросы уходят на преленд и получают 404 |
utm |
да | метки: weights (значение → доля трафика для rnd) и default |
requisites |
нет | реквизиты в подвале — список строк, каждая отдельным абзацем (текст экранируется). Важнее requisites.html; без обоих — заглушка «ИП Иванов» |
assetsUriPrefix |
нет | откуда брать статику. Пусто — из своего каталога; если на хостинге нет каталога images, статика берётся с сайта (https://<host>) |
fontsUrl, faviconUrl, spritePath |
нет | адреса шрифтов, иконок и SVG-спрайта, если они не в assetsUriPrefix |
logoAltExt |
устарело | После preland#11 обе темы используют проверенные SVG Zoomzilla; расширение не меняется runtime-конфигом. |
title |
нет | заголовок страницы («Улучшение изображения») |
default_language |
нет | сейчас не действует: язык всегда ru |
Демо-наборы
Preland хранит наборы ровно как Index, поэтому их можно переносить между проектами без переименования и перекладывания файлов:
1/01_desk_1-source.{jpg,webp,avif}
1/01_desk_2-result.{jpg,webp,avif}
1/01_desk_3-thumb.{jpg,webp,avif}
1/01_mob_1-source.{jpg,webp,avif}
1/01_mob_2-result.{jpg,webp,avif}
1/01_mob_3-thumb.{jpg,webp,avif}
...
1/05_...
2/01_...
...
N/05_...
indpic=abcdNefghi выбирает корневой каталог /N/. Набор копируется с Index в корень
домена целиком: без переименования, вложения в images/ и промежуточных
каталогов. Устаревшие images/demo* не являются частью поставки.
Для zoomstage.online обычный deploy ветки staging намеренно не загружает
корневые числовые каталоги /N/: это редактируемый контент stage, а не артефакт
кодовой доставки. По #22 workflow проверяет их полный контракт по фактическому
config через runtime guard. Импорт изменённого набора в Git не требуется;
следующая заливка не перетрёт его старой ревизией.
Деплой на произвольный домен
Требования. PHP 8.0+ (боевой хостинг — 8.2), веб-сервер с index.php в роли индексного файла и HTTPS:
crypto.randomUUID() работает только в защищённом контексте, а сайт отвечает по https.
- Домен. Запись A (или CNAME) на хостинг, сертификат (Let's Encrypt или от хостинга); открыть
https://<домен>/. - Файлы. Содержимое репозитория — в корень сайта, без
.gitи служебного (README.md,.gitea/):git clone https://git.zoomzilla.ru/anton/preland.git && cd preland # дальше — загрузка на хостинг: rsync/scp по SSH или FTP-клиент - Конфиг и реквизиты. Рабочий
config.jsonна хостинге — источник истины. При первичном создании домена его настраивают отдельно; обычный deploy не заменяет его репозиторным снимком и не перезаписываетrequisites.html. Менять можно только явно согласованные ключи после чтения текущего файла. - nginx без Apache (если хостинг не обрабатывает
.htaccess):server { server_name <домен>; root /var/www/<домен>; index index.php; location ~ /(\.git|config\.json|README\.md) { deny all; } location ~ \.php$ { include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_pass unix:/run/php/php8.2-fpm.sock; } location ~* \.(avif|webp|jpe?g|png|svg|ico|woff2?|css|js)$ { expires 1y; add_header Cache-Control "public, immutable"; } } - Сайт (по желанию). Домен преленда сайт определяет сам — по
Refererпервого захода. Свои умолчания меток для этого домена: cpanel → «Метки (UTM)» → «Умолчания по домену прелендинга». - Проверка.
В браузере: открыть
curl -s 'https://<домен>/?nc=1' | grep -o 'const createApiUrl = [^;]*;\|const redirectUrlBase = [^;]*;' # оба адреса — https://<host>/api/images/public/…, а не домен преленда curl -s -o /dev/null -w '%{http_code} %{redirect_url}\n' 'https://<host>/api/images/public/claim?key=x' # 302 на https://<host>/ — точка передачи на сайте естьhttps://<домен>/?indpic=abcd1efghi&theme=abcd1efghi&subid=TEST, выбрать фото — адрес сменится наhttps://<host>/public/upscale?id=…&indpic=<новый шум с1>&theme=<новый шум с1>&subid=TEST…(безkey=), пойдёт обработка. Это настоящая загрузка и обработка на сайте.
Автодеплой (Gitea Actions)
Решение владельца от 19.10.2026, задача preland#4: сейчас выкатываем только stage.
| Экземпляр | Назначение | Выкат |
|---|---|---|
| https://zoomstage.online | Тестовый стенд | Push в staging, SFTP |
| https://zoompixel.ru | Production | Отключён до отдельного поручения |
| https://zoompixel.online | Production | Отключён до отдельного поручения |
Прежний preland.anton.barbariskatest.ru выведен из использования и исключён из workflow. Публикация изменений самого workflow в main не запускает доставку: триггер оставлен только для staging.
Workflow .gitea/workflows/deploy.yml содержит единственную job deploy-zoomstage на
выделенном runner zoomzilla-production. Production возвращается только отдельной задачей
и прямым поручением владельца. Ошибки старого FTP больше не являются блокером выпуска.
Рабочие config.json/requisites.html на хостинге не перезаписываются. Корневые наборы /N/ принадлежат stage и исключены из кодовой доставки. Родительские каталоги создаются штатным SFTP-генератором; smoke проверяет страницу и assets наборов1/2. Откат — отдельный согласованный revert в staging, который обновляет только stage.
Android: фото и файлы (2026-10-19)
Основная кнопка выбирает image/; отдельная ссылка «Выбрать файлы (PDF и др.)» открывает общий picker без ограничения image/. PDF в подписи скрывается по runtime API-policy. iOS/iPad/Desktop сохраняют прежний общий выбор. +много сохраняется в одной компактной mobile-строке. components/browser-upload.php и CSS upload-picker-links.php — лёгкие inline-копии соответствующих компонентов API: отдельный PHP-хост не использует Yii AssetManager, новый внешний запрос не добавляется. При изменении общего контракта синхронизировать обе копии; API mobile-picker.cjs покрывает обе реальные страницы. Android byte-copy FileProvider сохраняет исходные байты/имя/MIME и ограничен max_file_size_bytes; до ответа policy используется консервативный15MB предел копирования. UTM/client_key/claim/config.json не меняются.
Актуальные ресурсы (21.10.2026, preland#11)
- Git main и staging содержат одно проверенное дерево. Источники: текущая zoomzilla.ru — два логотипа Zoomzilla, четыре PDF, favicon и реквизиты; zoomstage.online — все файлы наборов /1 и /2. История Git не переписывается; известная старая заглушка запрещена в рабочей поставке.
- release/assets.json фиксирует SHA-256 всех статических ресурсов (текстовые SVG/CSS/HTML/webmanifest нормализуют CRLF→LF). До выпуска выполнить девять tests/check-*.php, php bin/release-assets.php --check, --primary и --stage-sets https://zoomstage.online. Если источник изменился, сначала синхронизировать актуальные файлы и manifest по задаче, затем повторить проверки. Не отключать guard ради выката.
- --primary читает именно текущую страницу основного сайта и проверяет её актуальные URL/реквизиты: старый сохранённый asset URL не доказывает актуальность. Новые логотипы должны пройти визуальную проверку обеих тем/шапки/подвала. Cache version в components/asset-url.php зависит от содержимого.
- По прямому выбору владельца21.10 requisites.html теперь входит в каноническую поставку. Единственное новое разрешённое изменение runtime-config — ключ requisites из release/requisites.json через bin/ensure-requisites-config.php; остальные байты полей сохраняются, повторный запуск ничего не меняет. Это явное исключение к прежнему host-only правилу реквизитов, а не разрешение заменять весь config.json. Git config.json хранит согласованный снимок; после выпуска сверять runtime в памяти, не сохранять потенциальные секреты в логи.
- /N/ не перезаписывается кодовой доставкой. Требование #11 о сверке runtime-наборов с Git заменено решением #22 от 25.10.2026 (см. ниже).
- SFTP берёт положительный список из bin/release-assets.php --files: никакие tests/bin/release/plans не публикуются. Старые известные служебные файлы удаляются только по точному списку git ls-files, без рекурсивной очистки. После выпуска --remote сверяет все184ресурса.
- Production-преленды остаются замороженными по preland#4. Push main ничего не публикует; staging обновляет только zoomstage.online из точного event SHA.
Повторная проверка выпуска: php bin/release-assets.php --stage-requisites https://zoomstage.online проверяет именно runtime config; успешная загрузка requisites.html сама по себе недостаточна. Все обязательные SFTP-команды выполняются через batch -b и прекращают выкат при ошибке put.
Доменный бренд и минимальный подвал (21.10.2026, preland#12)
Новое поручение владельца заменяет часть требований #11: в подвале остаются логотип и копирайт, без реквизитов и платёжных значков. Копирайт использует текущий HTTP_HOST без порта/trailing-dot, отдельно от config.host API; непроверенные Host и X-Forwarded-Host не выводятся.
Логотипы — готовые SVG-контуры, не текст на лету. Для zoomstage.online утверждено имя ZoomStage, слитно без зоны, обе темы. Источники лежат в brands/zoomstage.online/light.svg и dark.svg; release/brands.json содержит явную цель, имя и SHA. В docs/logo.svg и logo-alt.svg хранятся правильные canonical stage-копии для полного переноса. Их размеры182×47 совпадают с viewBox, чтобы загрузка SVG не меняла геометрию.
Обычный bin/release-assets.php --files исключает оба logo-alias из записи; runtime cache-version рассчитывается по реальному файлу хоста. Отдельный шаг release-brand.php --status разрешает только заранее согласованную миграцию #12:0 — оба SVG уже правильные, записи нет;10 — каждый файл имеет свой известный старый или новый SHA, можно закончить миграцию (включая частичный put);1 — неизвестный домен/хеш, остановка без подмены. --files выдаёт ровно утверждённые source→target. Иные логотипы не перезаписывать общим выкатом. Новые production-домены требуют отдельного добавления готовых пар и явного первоначального размещения; текущий stage-процесс их не активирует.
primary guard теперь сверяет PDF/favicon, а не заставляет возвращать Zoomzilla и реквизиты на преленд. Реквизиты не отображаются и больше автоматически не синхронизируются; хостовый config и его существующие значения не меняются этим поручением. Устаревшие requisites.html и patch-скрипт удалены из поставки. Статический manifest183, отдельный каталог брендов проверяется по собственным SHA. История #11 сохранена; её прежние инструкции о видимом бренде/реквизитах заменены этим датированным решением.
Перед выпуском: девять tests/check-*.php и lint, --check/--primary/--stage-sets, оба бренда шапки/подвала на desktop/mobile, перенос Host, отсутствие карт/реквизитов, холодная/медленная загрузка, реальные локальные Preland→Tour→Join/error/retry и геометрия. Production-преленды по #4 не включать; выпускать только staging→zoomstage.online. API продуктовый код не меняется.
Дополнение приёмки #12: tests/e2e/brand-footer.cjs проверяет именно видимый SVG по центру шапки, а не только headerbox. PUBLISHED=1 использует zoomstage.online (или PRELAND_URL); без него — изолированный pre301.localhost QA proxy. Запускать в имеющемся Docker Playwright с /candidate=репозиторий,/qa=артефакты; POST/PUT блокируются. Пропущенное при compact CSS правило Bootstrap navbar>.container восстановлено во всех3CSS: API уже имеет его из полного Bootstrap. Это устраняет переход logo y0→13.5px, который рамочный тест не замечал.
Runtime indpic и отдельная админка (25.10.2026, preland#22)
Это решение явно заменяет требование #11 о предварительном импорте изменённых
наборов /N/ в Git. Кодовая доставка сохраняет runtime config.json и /N/;
обновление контента админкой не требует commit/push. Исторические записи /N/
в release/assets.json остаются снимком, не источником истины runtime.
php bin/release-assets.php --check сохраняет строгую проверку состава и SHA
поставляемой статики, включая запрет старого бренда. --stage-sets URL и
--remote URL читают фактический config и проверяют default, номера/веса indpic,
затем декодируют все 90 обязательных изображений каждого используемого набора,
проверяют формат и размеры по контракту API IndpicSetStorage (591a67cc8302).
Проверяются также ссылки с нулевым весом: их разрешает явный UTM и legacy random.
Отсутствующий indpic/default использует штатный fallback /1/; явно неверный
номер/default блокируется. Конфиг перечитывается после проверки для обнаружения
его изменения. Одиночный HTTP200 не считается подтверждением валидного набора.
HTTP не предоставляет inventory каталога: лишние файлы удалённого набора этим
режимом не исключаются. Для строгой проверки ровно 90 файлов без симлинков,
вложенных каталогов и лишних элементов выполнить на фактическом webroot
php bin/check-runtime-sets.php /path/to/webroot либо проверку через транспорт
админки. Локальная проверка и HTTP требуют PHP Imagick с AVIF/WebP/JPEG.
releaseFiles() — положительный список публичных кодовых/статических ресурсов.
admin/, его состояние/ключи/резервы, bin/, тесты и планы не публикуются обычной
доставкой прелендинга. Админка имеет отдельный образ и процедуру выпуска.
Проверки перед выпуском: все tests/check-*.php, manifest --check, --primary,
--stage-sets; после — --remote и проверка бренда. Не ослаблять guard ради выпуска.
api#347: part — девятая UTM, пятый символ1/2, default1. Preland только передаёт её на сайт и никогда не показывает ссылку «Для бизнеса». Отсутствующая группа/веса сохраняют fallback1; случайный выбор использует существующий порядок и настроенные веса. Runtime config автоматически не дополняется. Старые сохранённые ссылки конструктора получают part1 без изменения шума остальных меток; старые заметки читаются с пустой заметкой part.