feat: единая админка runtime-конфигов и indpic (#22)
deploy-preland / deploy zoomstage.online (push) Successful in 1m1s

This commit is contained in:
Panfilov Konstantin committed 2026-10-25 11:33:56 +03:00
1 parent 5b6b2d2053
commit 9515c1c62b
52 files changed
+2459 -34

No files matched your search

+33 -4
View File
@@ -144,9 +144,9 @@ N/05_...
Для `zoomstage.online` обычный deploy ветки `staging` намеренно **не загружает**
корневые числовые каталоги `/N/`: это редактируемый контент stage, а не артефакт
кодовой доставки. Workflow продолжает проверять их доступность HTTP-smoke. Чтобы
зафиксировать обновлённый набор, сначала синхронизируйте его со stage в Git по
отдельной задаче; следующая заливка не перетрёт его старой ревизией.
кодовой доставки. По #22 workflow проверяет их полный контракт по фактическому
config через runtime guard. Импорт изменённого набора в Git не требуется;
следующая заливка не перетрёт его старой ревизией.
## Деплой на произвольный домен
@@ -219,7 +219,7 @@ Workflow `.gitea/workflows/deploy.yml` содержит единственную
- 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 блокирует выпуск до импорта актуального набора. При полном переносе репозитория набор уже должен быть правильным.
- /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.
@@ -238,3 +238,32 @@ primary guard теперь сверяет PDF/favicon, а не заставля
Перед выпуском: девять 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 ради выпуска.