docs: добавить инструкции агентов
deploy-preland / deploy barbariskatest (push) Failing after 4s

This commit is contained in:
Panfilov Konstantin committed 2026-10-08 13:41:52 +03:00
1 parent ff09b43996
commit 85e27ff2f2
3 files changed
+68 -2

No files matched your search

+33
View File
@@ -0,0 +1,33 @@
# Инструкции агентов для `preland`
Область действия — репозиторий `preland/`. Общие правила рабочей области находятся в
[AGENTS.md](../AGENTS.md) и [CLAUDE.md](../CLAUDE.md); канонический процесс и каталог ролей —
[в общей политике](../.known-base/Соглашения/Процесс%20командной%20разработки%20и%20каталог%20ролей.md).
Этот файл и [AGENTS.md](AGENTS.md) содержат одинаковые локальные правила; обновлять их вместе.
## Перед работой
- Прочитать [README.md](README.md), [заметку проекта](../.known-base/Проекты/Преленд%20—%20anton-preland.md),
а для выката — `.gitea/workflows/deploy.yml` и `config.json.example`.
- Проверить состояние ветки и чужие изменения в `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` каждой цели и `requisites.html` живут на хостинге: не добавлять
их в git, не перезаписывать и не удалять при деплое. В репозитории — только образец конфига.
- Коммит в `main` запускает FTP-автодеплой на все цели workflow; откат через `git revert`
также запускает выкат. Коммит, push и изменения хостинга — только по прямому поручению.
- Проверки кода и браузера проводить в Docker без установки ПО на хост.
Проверка загрузки по боевому адресу вызывает реальную обработку; выполнять её только
в согласованном окружении, не публиковать ключи загрузок и FTP-секреты.
План, журнал и база знаний ведутся в корне рабочей области по общим правилам. Ссылки на
политику и документацию не подключают MCP и не дают разрешения на публикацию или выкат.