# Преленд zoomzilla Одностраничный лендинг перед основным сайтом (`zoomzilla.ru`): посетитель с рекламы выбирает фото прямо на преленде, файл сразу уходит в API сайта, а сам посетитель переходит на сайт — на страницу обработки этого фото. Варианты страницы и сайта (A/B) задаются метками в адресе. Код — обычный PHP без фреймворка и сборки; переводы — маленькая заглушка `Yii::t` в `i18n.php`. Активные production: `https://zoompixel.ru`, `https://zoompixel.online`; текущая цель выката — только `https://zoomstage.online`. Пример ссылки входа: `https://zoomstage.online/?indpic=1&theme=dark°r=2®istration=after&bchoice=a&tp=1&utm_source=test&subid=CLICK1`. ## Как работает ### Метки `index.php` разбирает параметры адреса по разделу `utm` из `config.json`. Для каждой настроенной метки: - значение из адреса принимается, если оно есть в `weights`; - `rnd` — случайное значение по весам (`weights`), так делится трафик между вариантами; - неизвестное значение отбрасывается, отсутствующее — заменяется на `default`. Ненастроенные параметры (`utm_source`, `keyword`, `subid` и любые другие) проходят как есть. Перед переходом Preland всегда формирует полный resolved-набор своих восьми меток: явное допустимое значение остаётся, `rnd` разрешается по весам, отсутствующее получает `default`. Вместе с внешними рекламными параметрами этот набор уходит в `claim`, а затем сайт переносит его в `upscale`; ни один из восьми параметров не должен пропадать только потому, что был назначен default. | Метка | Что задаёт | Где | |---|---|---| | `indpic` | картинка-пример на преленде | корневой каталог сета `/1/`, `/2/` и т. д. | | `theme` | `light` / `dark` | преленд и сайт | | `degr` | пресет ухудшения превью «До» | сайт (#42) | | `registration` | `before` — PIN до оплаты, `after` — после | сайт, страница результата | | `bchoice` | попап выбора банка (`a` — показать) | сайт, оплата (#44) | | `chb` | галочки согласия на странице оплаты (`no` — не обязательны) | сайт, оплата | | `tp` | группа тарифов | сайт, cpanel «Группы тарифов (tp)» | | `focus` | первоначальная область лупы Join: `center`/`face` | сайт, cpanel после `tp` | ### Загрузка и переход на сайт 1. Браузер проверяет файл: изображение, не больше 6000 px по большей стороне. 2. XHR `POST https:///api/images/public/create` (`multipart/form-data`: `file` и `client_key` — случайный UUID загрузки, `crypto.randomUUID()`), `Accept: application/json`. Ответ — JSON с id обработки. 3. Браузер переходит на `https:///api/images/public/claim?key=&<метки>`. Сайт кладёт загрузку в сессию посетителя и отвечает 302 на `/public/upscale?id=<обработка>&<метки>` (уже без ключа); страница сама запускает обработку. Почему не сразу `/public/upscale`: XHR с преленда кросс-доменный, и сессия, в которой сайт запомнил загрузку, посетителю на сайте недоступна — браузеры изолируют или не принимают куки третьей стороны. Страница обработки пускает только владельца загрузки, поэтому без передачи по ключу посетитель видел 404. Ключ одноразовый и годен 30 минут после загрузки. `` — домен сайта из `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://`) | | `fontsUrl`, `faviconUrl`, `spritePath` | нет | адреса шрифтов, иконок и SVG-спрайта, если они не в `assetsUriPrefix` | | `logoAltExt` | устарело | После preland#11 обе темы используют проверенные SVG Zoomzilla; расширение не меняется runtime-конфигом. | | `title` | нет | заголовок страницы («Улучшение изображения») | | `default_language` | нет | сейчас не действует: язык всегда `ru` | ### Демо-наборы Preland хранит наборы ровно как Index, поэтому их можно переносить между проектами без переименования и перекладывания файлов: ```text 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=N` выбирает корневой каталог `/N/`. Набор копируется с Index в корень домена целиком: без переименования, вложения в `images/` и промежуточных каталогов. Устаревшие `images/demo*` не являются частью поставки. Для `zoomstage.online` обычный deploy ветки `staging` намеренно **не загружает** корневые числовые каталоги `/N/`: это редактируемый контент stage, а не артефакт кодовой доставки. Workflow продолжает проверять их доступность HTTP-smoke. Чтобы зафиксировать обновлённый набор, сначала синхронизируйте его со stage в Git по отдельной задаче; следующая заливка не перетрёт его старой ревизией. ## Деплой на произвольный домен **Требования.** PHP 8.0+ (боевой хостинг — 8.2), веб-сервер с `index.php` в роли индексного файла и **HTTPS**: `crypto.randomUUID()` работает только в защищённом контексте, а сайт отвечает по https. 1. **Домен.** Запись A (или CNAME) на хостинг, сертификат (Let's Encrypt или от хостинга); открыть `https://<домен>/`. 2. **Файлы.** Содержимое репозитория — в корень сайта, без `.git` и служебного (`README.md`, `.gitea/`): ```bash git clone http://git.dira89kv.beget.tech:3000/anton/preland.git && cd preland # дальше — загрузка на хостинг: rsync/scp по SSH или FTP-клиент ``` 3. **Конфиг и реквизиты.** Рабочий `config.json` на хостинге — источник истины. При первичном создании домена его настраивают отдельно; обычный deploy не заменяет его репозиторным снимком и не перезаписывает `requisites.html`. Менять можно только явно согласованные ключи после чтения текущего файла. 4. **nginx без Apache** (если хостинг не обрабатывает `.htaccess`): ```nginx 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"; } } ``` 5. **Сайт (по желанию).** Домен преленда сайт определяет сам — по `Referer` первого захода. Свои умолчания меток для этого домена: cpanel → «Метки (UTM)» → «Умолчания по домену прелендинга». 6. **Проверка.** ```bash curl -s 'https://<домен>/?nc=1' | grep -o 'const createApiUrl = [^;]*;\|const redirectUrlBase = [^;]*;' # оба адреса — https:///api/images/public/…, а не домен преленда curl -s -o /dev/null -w '%{http_code} %{redirect_url}\n' 'https:///api/images/public/claim?key=x' # 302 на https:/// — точка передачи на сайте есть ``` В браузере: открыть `https://<домен>/?indpic=1&theme=dark&subid=TEST`, выбрать фото — адрес сменится на `https:///public/upscale?id=…&indpic=1&theme=dark&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/ по-прежнему редактируется на stage и не перезаписывается обычной кодовой доставкой; все150файлов перед выкатом сверяются с Git. Drift блокирует выпуск до импорта актуального набора. При полном переносе репозитория набор уже должен быть правильным. - 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, который рамочный тест не замечал.