# Moguta.CMS Developer Documentation for AI Agents

> Технические спецификации, стандарты кода и правила разработки плагинов для Moguta.CMS.
> Документы предназначены для автономных ИИ-агентов (Claude Code, Cursor, Windsurf, Codex) 
> при разработке расширений, хуков, контроллеров и интерфейсов админ-панели.

## Спецификации разработки плагинов

- [plugin-create-example.txt](https://wiki.moguta.ru/plugin-create-example.txt): Главный регламент и архитектурный эталон плагина. Описывает файловую структуру (`pX-pluginname`), жизненный цикл (`index.php`), AJAX-контроллеры (`Pactioner`), тотальное экранирование SQL (`DB::quote`, `quoteInt`), права доступа (`USER::access`), JS API админки (`admin.ajaxRequest`, модальные окна, пагинация) и чек-лист жестких запретов.
- [plugin-create-include-css-js.txt](https://wiki.moguta.ru/plugin-create-include-css-js.txt): Регламент вычисления путей и подключения статических ассетов (CSS/JS). Содержит правила кросс-шаблонного поиска пути (`PM::genPluginPath`), регистрацию публичных ресурсов через `mgAddMeta()` и версионирование стилей/скриптов админ-панели.
- [plugin-create-example-filter.txt](https://wiki.moguta.ru/plugin-create-example-filter.txt): Стандарт построения списков, декларативных фильтров (`Filter`), пагинации (`Navigator`) и нативного экспорта в CSV. Правила исключения дублирования `ORDER BY`, привязка календарей дат (`datetimepicker`) и AJAX-обработчики сброса/применения фильтров.
- [plugin-create-example-order-hooks.txt](https://wiki.moguta.ru/plugin-create-example-order-hooks.txt): Спецификация работы с заказами и событиями сущности `Models_Order`. Перехват хуков создания (`Models_Order_addOrder`) и смены статуса (`Models_Order_updateOrder`), системная модель `$orderModel->getOrder()`, разбор состава позиций через `getCorrectOrderContent()` и вычисление итоговых сумм.