Справочник: ИИ-инструменты v200.4.1

Ты разрабатываешь модуль для DLE на базе DevCraft Admin.

Режим работы (выбери один): создание | перенос (legacy/MH Admin → DevCraft) | обновление существующего

Название плагина ({Name}):
Тег / code конфигурации ({code}):
Именование mod ({mod}): обычно = {code}; camelCase вместо пробелов, без лишних - и \_
Версия плагина ({version}): 200.1.0

Дерево модуля (devcraft/src/modules/{Name}/):

- manifest.php, settings.schema.php (если есть настройки), changelog.data.php
- Pages/, Ajax/, Services/ (по необходимости), Controller/ (публичный слой), templates/\*.twig, Public/
- при фильтрах таблиц: Filter/\*.filter.schema.php
- точка входа DLE: engine/inc/{mod}.php
  require_once DLEPlugins::Check(ROOT_DIR . '/devcraft/init.php');
  DevCraft\Core\Application::instance()->runAdmin(moduleDir: '{Name}');
- публичный include: Controller/show_*.php от корня сайта — НЕ engine/modules/devcraft/
  {include file="devcraft/src/modules/{Name}/Controller/show_{slug}.php?…"}
- в engine/ только необходимое (admin glue + патчи); не спамить дерево DLE

Обязательные правила:

- PSR-4: DevCraft\Modules\{Name}\ → devcraft/src/modules/{Name}/
- Все require/include проектных файлов через DLEPlugins::Check()
- Комментарии, PHPDoc и UI-строки на русском; вывод пользователю через функцию перевода \_\_()
- HTML админки только в Twig (Metro UI); публичный HTML — templates/{skin}/devcraft/{module}/
- AJAX только через devcraft/ajax.php — НЕ создавать engine/ajax/{mod}.php
- Обработчики реализуют AjaxHandlerInterface, возвращают JsonResponse или FileResponse
- Загрузка файлов: DevCraft.Ajax.postMultipart + DevCraft\Core\Http\UploadedFile
- Настройки: settings.schema.php (FormSchemaBuilder); конфиг в devcraft/config/{code}.json
- manifest.php: mod, code, meta, menu, ajax, changelog; пункт dashboard/index для AdminLinkResolver
- install.xml: needplugin=DevCraft Admin; файлы DLE/DevCraft не патчить без нужды (секция <file> обычно пустая)
- DevCraft Admin ≥ 200.4.0; AdminLink::page(name, action, pageClass, icon, mod) — 5-й аргумент mod обязателен для сателлитов
- assets.js подключать после devcraft.js; ajax.controller = 'admin'; URL: devcraft/ajax.php?mod={mod}&controller=admin&method=...
- Слои Service / Repository / Controller / Entity / DTO; persistence через Cycle ORM; без devcraft/bin
- После новых PHP-файлов: composer dump-autoload в devcraft/
- Локали: devcraft/locales/{locale}/{code}.xliff

Перенос: не копировать legacy engine/ajax и паттерны MH Admin; reuse API DevCraft; mhadmin — только как эталон поведения.
Обновление: минимальный diff; не ломать mod/code; дописать changelog.data.php.

Стек: PHP ≥ 8.3 | DevCraft Admin ≥ 200.4.0 | DLE ≥ 20.0

Документация:
| Предназначение | Ссылка |
|---|---|
| DevCraft Admin | https://github.com/DevCraftClub/mhdocs/tree/main/docs/dev/dle/devcraft_admin |
| Конституция PHP | https://github.com/DevCraftClub/mhdocs/tree/main/docs/instructions/constitution.md |
| PHP DevCraft Standards | https://readme.devcraft.club/dev/dle/devcraft_admin/guides/php_devcraft_standards |
| DevCraft Docs | https://github.com/DevCraftClub/mhdocs/tree/main/docs |
| Readme | https://readme.devcraft.club/dev/dle/devcraft_admin/ |
| DLE | https://dle-news.ru/extras/online/ |
| Metro UI | https://github.com/olton/metroui-docs/tree/master/src/content/docs |
| Cycle ORM | https://github.com/cycle/docs/tree/2.x/docs/en |

Чеклист:

- [ ] manifest.php
- [ ] settings.schema.php (если нужны настройки)
- [ ] changelog.data.php
- [ ] Pages/\*.php
- [ ] Ajax/\*Handler.php
- [ ] Controller/\* (+ show_*.php при публичном include)
- [ ] templates/\*.twig
- [ ] Public/ (icon и т.п.)
- [ ] Filter/\*.filter.schema.php (если нужны фильтры)
- [ ] engine/inc/{mod}.php (только admin glue)
- [ ] install.xml + locales в devcraft/locales/
- [ ] composer dump-autoload

Детали: getting_started, constitution, php_devcraft_standards, crud_pages.