preland/CLAUDE.md

Инструкции агентов для preland

Область действия — репозиторий preland/. Общие правила рабочей области находятся в AGENTS.md и CLAUDE.md; канонический процесс и каталог ролей — в общей политике. Этот файл и AGENTS.md содержат одинаковые локальные правила; обновлять их вместе.

Перед работой

• Прочитать README.md, заметку проекта, а для выката — .gitea/workflows/deploy.yml и единственный config.json.
• Проверить состояние ветки и чужие изменения в preland/; изменения API сайта согласовать с его контрактом и инструкциями api/.

Локальные ограничения

• Преленд — PHP без фреймворка и сборки; Yii::t реализован локальной заглушкой i18n.php. Сохранять существующие компоненты и передачу меток трафика на сайт.
• Загрузка идёт на POST /api/images/public/create с file и случайным client_key, переход — через /api/images/public/claim?key=…. Ключ одноразовый, срок 30 минут; переход напрямую на /public/upscale не заменяет передачу владельца через claim.
• host задаёт сайт назначения; HTTPS необходим для crypto.randomUUID(). Не обходить серверные правила доступа к загрузке и результату обработки.
• Рабочий config.json единственный для всех прилендов: это точная проверенная конфигурация zoomstage.online, и каждый FTP/SFTP-deploy обязан доставлять её на stage и production. requisites.html по-прежнему живёт только на хостинге и не перезаписывается. Не создавать target-specific конфиги или config.json.example.
• Коммит в main запускает FTP-автодеплой на все цели workflow; откат через git revert также запускает выкат. Коммит, push и изменения хостинга — только по прямому поручению.
• Проверки кода и браузера проводить в Docker без установки ПО на хост. Проверка загрузки по боевому адресу вызывает реальную обработку; выполнять её только в согласованном окружении, не публиковать ключи загрузок и FTP-секреты.

План, журнал и база знаний ведутся в корне рабочей области по общим правилам. Ссылки на политику и документацию не подключают MCP и не дают разрешения на публикацию или выкат.