blockmine 1.21.0 → 1.23.0

package/CHANGELOG.md

@@ -1,57 +1,117 @@
 # История версий
 
 
-## [1.21.0](https://github.com/blockmineJS/blockmine/compare/v1.20.0...v1.21.0) (2025-10-26)
-
-
-### 🛠 Рефакторинг
-
-* [graph-system] все ноды отрефакторены и перенесены. [@claude](https://github.com/claude) author ([55db1b8](https://github.com/blockmineJS/blockmine/commit/55db1b89dbe470691db129a72c7efe55030acfa6))
-
-
-### ✨ Новые возможности
-
-* [graph-system]  пкм. по названию переменной можно найти - Получить/Установить переменную ([83b822f](https://github.com/blockmineJS/blockmine/commit/83b822ff1d278dfb9e280909c81ab32fd0e58bc3))
-* [graph-system] конвертация нод при подключения не к тем типам ([03deac8](https://github.com/blockmineJS/blockmine/commit/03deac83c9468199a8f6ae2b2480248c52a39e57))
-* добавление виртуализации для списков плагинов и ботов ([ea7746f](https://github.com/blockmineJS/blockmine/commit/ea7746f5c7f05ed74e6893bb27774d8541e0c57f))
-* новая нода для http запросов ([3565d06](https://github.com/blockmineJS/blockmine/commit/3565d06bff419c2d2665eba719a4c94696db00ae))
-
-## [1.20.0](https://github.com/blockmineJS/blockmine/compare/v1.19.1...v1.20.0) (2025-10-23)
-
-
-### ✨ Новые возможности
-
-* если бот падает 5 раз с критической ошибкой, то перезапуск отменяется ([2ba022f](https://github.com/blockmineJS/blockmine/commit/2ba022fff038cc83bb1edfa04d3edf97fc76c255))
-* action:send_message to support dynamic variables. example. Сообщение: привет, {username} ([457639d](https://github.com/blockmineJS/blockmine/commit/457639d70e7a8933f0508d93196a2be6951f1a0a))
-
-### [1.19.1](https://github.com/blockmineJS/blockmine/compare/v1.19.0...v1.19.1) (2025-10-01)
-
-
-### 🐛 Исправления
-
-* изменение порядка ботов теперь корректное ([9663737](https://github.com/blockmineJS/blockmine/commit/9663737505201468dd2233bf5658be5b2442f583))
-* фиксим новой вкладки прокси ([7ebdb7d](https://github.com/blockmineJS/blockmine/commit/7ebdb7d0df6c4e5cd6a9b15576cc1907ab7fcd74))
-
-## [1.19.0](https://github.com/blockmineJS/blockmine/compare/v1.18.5...v1.19.0) (2025-08-23)
+## [1.23.0](https://github.com/blockmineJS/blockmine/compare/v1.22.0...v1.23.0) (2025-11-25)
 
 
 ### 🐛 Исправления
 
-* баз команда dev исправлена. теперь не считает алиасы как отдельные кмд ([782c01e](https://github.com/blockmineJS/blockmine/commit/782c01e12f273a04cf78a5772b7be628d22f5791))
-* добавлена автоматическая установка недостающих модулей для плагинов при их загрузке ([27154f1](https://github.com/blockmineJS/blockmine/commit/27154f1d2c588f8d8371493f1d28646ff9d764f7))
-* зависимости плагин устанавливаются ([a7314c4](https://github.com/blockmineJS/blockmine/commit/a7314c4d1c66ef7021d6c265ebbb270c50a3ab62))
-* изменять версия у созданного сервера теперь можно ([a55e3c9](https://github.com/blockmineJS/blockmine/commit/a55e3c9d6a06b9ebd95722aa6487e2b79bda07ff))
-* исправление проблем с импортом ([ef9fde2](https://github.com/blockmineJS/blockmine/commit/ef9fde2aa8b1390910600bfd930c444cbff2d01e))
-* починили установку локальную ([1b28e07](https://github.com/blockmineJS/blockmine/commit/1b28e071d4846b62dd6360f4709a0e263841960b))
-* права юзеров теперь может менять только владелец панели (первый юзер) ([94312d7](https://github.com/blockmineJS/blockmine/commit/94312d7b9c09aabb704f163f8e3205abf7c2acdc))
+* нода установить переменную. селект Хранить в бд ничего не отображал ([adf4a85](https://github.com/blockmineJS/blockmine/commit/adf4a85929b47d3cb0d0771d7ae205ac5650809f))
+* теперь для изменения владельца в боте, не надо перезапускать бэкенд ([0c0d675](https://github.com/blockmineJS/blockmine/commit/0c0d675cfa67db6af752726c5fc23d3e26cffcb5))
+* cmd. Первая проверка тип чата, а потом аргументы ([2acdff1](https://github.com/blockmineJS/blockmine/commit/2acdff1db27ad1675cb9168748ff0d8a65271fe9))
+* exec пины теперь коннектятся только к exec ([a57f643](https://github.com/blockmineJS/blockmine/commit/a57f643e104bd94c23046493444709bb8de6ed13))
 
 
 ### ✨ Новые возможности
 
-* когда другой юзер заходит в панель, другие клиенты увидят уведомление что он зашел ([a689b4e](https://github.com/blockmineJS/blockmine/commit/a689b4ee91e0dc187b3eeddc75600e880730b885))
-* новая кнопочка - прокси. позволяет установить прокси сразу множеству ботов ([ac75d65](https://github.com/blockmineJS/blockmine/commit/ac75d655289a4b4b4560555ac1fecbcdb199b822))
-* теперь можно для других юзеров назначать определенных ботов которыми они могут управлять ([484685b](https://github.com/blockmineJS/blockmine/commit/484685b1821fa3ad8907f4ab320762cf1c6a3959))
+* дебаг режим для графов ([ffc910b](https://github.com/blockmineJS/blockmine/commit/ffc910b772bccf9b64ca828eb55debddb11715d7))
+* добавлен ai помощник в blockmine ide ([d7c5f7e](https://github.com/blockmineJS/blockmine/commit/d7c5f7e555beacf614b6cdc94706339880aac55c))
+* добавлен diff для просмотра изменений кода от ии ([d0159f0](https://github.com/blockmineJS/blockmine/commit/d0159f0884863ec10136f4bf32ea7daf0702d476))
+* новая вкладка - прокси ([3094b8b](https://github.com/blockmineJS/blockmine/commit/3094b8b5f1b9a59dd6494ff54c721f1e720b28f6))
+* новая ивент нода - При запуске бота ([5189a02](https://github.com/blockmineJS/blockmine/commit/5189a024c5e57fe8cb28f557b946247644367491))
+* новые ноды ([610b501](https://github.com/blockmineJS/blockmine/commit/610b501d89cb744ca9ea7a9e35adc7ae1ec3766b))
+* новый ide редактор ([2d7b302](https://github.com/blockmineJS/blockmine/commit/2d7b3026882b56a226760ba38c52cba0815a0720))
+* подсветки при соединении нод ([dd06cdd](https://github.com/blockmineJS/blockmine/commit/dd06cdd4fca871713688382c9b73d0eaa4d1b8bd))
+* теперь за бота можно ходить прямо в браузере! ([42f9257](https://github.com/blockmineJS/blockmine/commit/42f9257ee3ce166fda648e9a2ca6947c630a21e2))
+* фиксы и для нод копирование вставка графов ([aa1308d](https://github.com/blockmineJS/blockmine/commit/aa1308d19122ebc762ec1ebd3f523e12c2fb5aa2))
 
+## [1.22.0](https://github.com/blockmineJS/blockmine/compare/v1.21.0...v1.22.0) (2025-11-16)
+
+
+### ✨ Новые возможности
+
+* апи для дашборд страницы для отображения ресурсов системы ([c903d64](https://github.com/blockmineJS/blockmine/commit/c903d64c2576d22943971226caec1bd610f0f41e))
+* для дашборда добавлен функционал для просмотров ресурсов системы ([b7fa209](https://github.com/blockmineJS/blockmine/commit/b7fa2097274882ea13c01068eac78824560cc22b))
+* добавлены ноды для получения существ и игроков рядом с ботом ([17fad59](https://github.com/blockmineJS/blockmine/commit/17fad592c64833e25a2bd9e259379d4d649e3cb4))
+* много новых нод и обнов для граф системы ([8881aa5](https://github.com/blockmineJS/blockmine/commit/8881aa554b1b8c6cca4d87cb5900bb8cfe535d33))
+* новая большая механика. Вебсокеты ([acda500](https://github.com/blockmineJS/blockmine/commit/acda5005d01cfcb8ee7c85474af966c646c63fcd))
+* новая нода - задержка ([cde63db](https://github.com/blockmineJS/blockmine/commit/cde63db612062f3eb7782e8c1f6af35a22dc03e2))
+* отключение градиента в консоли. Автор - @artemscine ([ba11548](https://github.com/blockmineJS/blockmine/commit/ba1154827c2e5016c668b79f7b80386819cc7ab9))
+* разработчики плагинов теперь могут указать secret: true для маскировки чувствительных значений ([f6c67fb](https://github.com/blockmineJS/blockmine/commit/f6c67fbb0a9cc24eea2175e275593a1b0421d199))
+* сообщение в чате text\ntext разделяется на два. \n разделитель ([560ae7b](https://github.com/blockmineJS/blockmine/commit/560ae7b6c8ddbe0412d7f27d145c447bb5d750d2))
+* теперь при обновлении плагинов настройки тоже мигрируются ([48434e8](https://github.com/blockmineJS/blockmine/commit/48434e853c9f926168873f61ecd49cbb6c10971c))
+* Add date and time manipulation nodes ([80c8dbd](https://github.com/blockmineJS/blockmine/commit/80c8dbd9103a38a03b4ae4ea297322ae699d9c21))
+* websocket. Большая фича ([a321023](https://github.com/blockmineJS/blockmine/commit/a3210230d6e78d46928924d244a6b24acee45443))
+
+
+### 🛠 Рефакторинг
+
+* большой рефакторинг бэкенд части x2 ([49a543a](https://github.com/blockmineJS/blockmine/commit/49a543a122aced41b3725564c66a01269608dd2d))
+* большой рефакторинг нод системы ([85ac50f](https://github.com/blockmineJS/blockmine/commit/85ac50f1f0ea79832bd398f7345029f52f6910e1))
+* обновление компонентов UI и удаление зависимости от MUI ([86a4a5e](https://github.com/blockmineJS/blockmine/commit/86a4a5edfc91f024cd085cbe4282a5c9efb48b84))
+* полный рефакторинг бэкенда ([5e68fd8](https://github.com/blockmineJS/blockmine/commit/5e68fd8fa00a162ae68772bb24ef984d433e9ca5))
+
+
+### 🐛 Исправления
+
+* важный фикс команд ([16f7da2](https://github.com/blockmineJS/blockmine/commit/16f7da23167ece0877cb196c6ba01bbd6fbcc3a3))
+* корректная очистка ANSI ([a9ba9c7](https://github.com/blockmineJS/blockmine/commit/a9ba9c74ab31dbce7ce881a098c204f48aa4e82e))
+* рестарт после падения socks. Автор - @artemscine ([bf98505](https://github.com/blockmineJS/blockmine/commit/bf985052c40d30add6a717748efe37eeb15d5d74))
+* уменьшение отступов в дашборде Автор - @artemscine ([af52a07](https://github.com/blockmineJS/blockmine/commit/af52a07a0615d29c97c6848ea758c83544236cad))
+* remove problematic lcov-reporter-action and update to Node.js 22.x ([ac83208](https://github.com/blockmineJS/blockmine/commit/ac83208eefff2e71075d02fb46c603e8e22a6b9b))
+* resolve CodeRabbit review issues ([a45ee47](https://github.com/blockmineJS/blockmine/commit/a45ee47a02409c67284e165248ac19e6adbd369f))
+
+## [1.21.0](https://github.com/blockmineJS/blockmine/compare/v1.20.0...v1.21.0) (2025-10-26)
+
+
+### 🛠 Рефакторинг
+
+* [graph-system] все ноды отрефакторены и перенесены. [@claude](https://github.com/claude) author ([55db1b8](https://github.com/blockmineJS/blockmine/commit/55db1b89dbe470691db129a72c7efe55030acfa6))
+
+
+### ✨ Новые возможности
+
+* [graph-system]  пкм. по названию переменной можно найти - Получить/Установить переменную ([83b822f](https://github.com/blockmineJS/blockmine/commit/83b822ff1d278dfb9e280909c81ab32fd0e58bc3))
+* [graph-system] конвертация нод при подключения не к тем типам ([03deac8](https://github.com/blockmineJS/blockmine/commit/03deac83c9468199a8f6ae2b2480248c52a39e57))
+* добавление виртуализации для списков плагинов и ботов ([ea7746f](https://github.com/blockmineJS/blockmine/commit/ea7746f5c7f05ed74e6893bb27774d8541e0c57f))
+* новая нода для http запросов ([3565d06](https://github.com/blockmineJS/blockmine/commit/3565d06bff419c2d2665eba719a4c94696db00ae))
+
+## [1.20.0](https://github.com/blockmineJS/blockmine/compare/v1.19.1...v1.20.0) (2025-10-23)
+
+
+### ✨ Новые возможности
+
+* если бот падает 5 раз с критической ошибкой, то перезапуск отменяется ([2ba022f](https://github.com/blockmineJS/blockmine/commit/2ba022fff038cc83bb1edfa04d3edf97fc76c255))
+* action:send_message to support dynamic variables. example. Сообщение: привет, {username} ([457639d](https://github.com/blockmineJS/blockmine/commit/457639d70e7a8933f0508d93196a2be6951f1a0a))
+
+### [1.19.1](https://github.com/blockmineJS/blockmine/compare/v1.19.0...v1.19.1) (2025-10-01)
+
+
+### 🐛 Исправления
+
+* изменение порядка ботов теперь корректное ([9663737](https://github.com/blockmineJS/blockmine/commit/9663737505201468dd2233bf5658be5b2442f583))
+* фиксим новой вкладки прокси ([7ebdb7d](https://github.com/blockmineJS/blockmine/commit/7ebdb7d0df6c4e5cd6a9b15576cc1907ab7fcd74))
+
+## [1.19.0](https://github.com/blockmineJS/blockmine/compare/v1.18.5...v1.19.0) (2025-08-23)
+
+
+### 🐛 Исправления
+
+* баз команда dev исправлена. теперь не считает алиасы как отдельные кмд ([782c01e](https://github.com/blockmineJS/blockmine/commit/782c01e12f273a04cf78a5772b7be628d22f5791))
+* добавлена автоматическая установка недостающих модулей для плагинов при их загрузке ([27154f1](https://github.com/blockmineJS/blockmine/commit/27154f1d2c588f8d8371493f1d28646ff9d764f7))
+* зависимости плагин устанавливаются ([a7314c4](https://github.com/blockmineJS/blockmine/commit/a7314c4d1c66ef7021d6c265ebbb270c50a3ab62))
+* изменять версия у созданного сервера теперь можно ([a55e3c9](https://github.com/blockmineJS/blockmine/commit/a55e3c9d6a06b9ebd95722aa6487e2b79bda07ff))
+* исправление проблем с импортом ([ef9fde2](https://github.com/blockmineJS/blockmine/commit/ef9fde2aa8b1390910600bfd930c444cbff2d01e))
+* починили установку локальную ([1b28e07](https://github.com/blockmineJS/blockmine/commit/1b28e071d4846b62dd6360f4709a0e263841960b))
+* права юзеров теперь может менять только владелец панели (первый юзер) ([94312d7](https://github.com/blockmineJS/blockmine/commit/94312d7b9c09aabb704f163f8e3205abf7c2acdc))
+
+
+### ✨ Новые возможности
+
+* когда другой юзер заходит в панель, другие клиенты увидят уведомление что он зашел ([a689b4e](https://github.com/blockmineJS/blockmine/commit/a689b4ee91e0dc187b3eeddc75600e880730b885))
+* новая кнопочка - прокси. позволяет установить прокси сразу множеству ботов ([ac75d65](https://github.com/blockmineJS/blockmine/commit/ac75d655289a4b4b4560555ac1fecbcdb199b822))
+* теперь можно для других юзеров назначать определенных ботов которыми они могут управлять ([484685b](https://github.com/blockmineJS/blockmine/commit/484685b1821fa3ad8907f4ab320762cf1c6a3959))
+
 ### [1.18.5](https://github.com/blockmineJS/blockmine/compare/v1.18.4...v1.18.5) (2025-08-15)
 
 

package/CLAUDE.md

@@ -0,0 +1,284 @@
+# Документация для разработки BlockMine
+
+
+НИКОГДА НЕ ДОБАВЛЯЙ КОММЕНТАРИИ К ПОНЯТНОМУ КОДУ. router.use понятно что роутер подключает
+Старайся дополнять CLAUDE.md чем то новым и новыми функциями которые могут понадобится агентам
+
+Этот документ содержит инструкции для AI-ассистентов и разработчиков по работе с кодовой базой BlockMine.
+
+## Содержание
+
+- [Добавление новых нод в визуальный редактор](#добавление-новых-нод-в-визуальный-редактор)
+
+---
+
+## Добавление новых нод в визуальный редактор
+
+Ноды в BlockMine состоят из двух частей: frontend (React/TypeScript) и backend (Node.js). Для добавления новой ноды необходимо внести изменения в оба места.
+
+### 1. Frontend: Создание определения ноды
+
+Ноды организованы по категориям в директории `frontend/src/components/visual-editor/nodes/`.
+
+#### Пример: Нода события "При запуске бота"
+
+**Шаг 1: Создайте файл определения ноды**
+
+Создайте файл в соответствующей категории, например:
+```
+frontend/src/components/visual-editor/nodes/event/eventBotStartup.js
+```
+
+```javascript
+import { NodeDefinition } from '../../core/registry';
+
+/**
+ * Определение ноды event:botStartup
+ * Срабатывает один раз при запуске бота
+ */
+export const eventBotStartupDefinition = new NodeDefinition({
+  type: 'event:botStartup',           // Уникальный тип ноды (формат: category:name)
+  category: 'event',                  // Категория для группировки в UI
+  label: '🚀 При запуске бота',       // Отображаемое название
+  description: 'Срабатывает один раз при запуске бота',
+
+  computeInputs: (data) => [],        // Входные пины (можно вычислять динамически)
+
+  computeOutputs: (data) => [         // Выходные пины
+    { id: 'exec', name: 'Выполнить', type: 'Exec' },
+  ],
+
+  theme: {                            // Цветовая схема ноды
+    headerColor: '#8b5cf6',
+    accentColor: '#a78bfa',
+  },
+});
+
+export default eventBotStartupDefinition;
+```
+
+**Шаг 2: Экспортируйте из index.js категории**
+
+В файле `frontend/src/components/visual-editor/nodes/event/index.js`:
+
+```javascript
+export { eventBotStartupDefinition } from './eventBotStartup';
+```
+
+**Шаг 3: Зарегистрируйте ноду в главном реестре**
+
+В файле `frontend/src/components/visual-editor/nodes/index.js`:
+
+1. Добавьте импорт:
+```javascript
+import {
+  eventCommandDefinition,
+  eventBotStartupDefinition,  // Добавить
+  // ...
+} from './event';
+```
+
+2. Зарегистрируйте в функции `registerAllNodes()`:
+```javascript
+export function registerAllNodes() {
+  // ...
+  // Event category
+  NodeRegistry.register(eventCommandDefinition);
+  NodeRegistry.register(eventBotStartupDefinition);  // Добавить
+  // ...
+}
+```
+
+### 2. Backend: Регистрация типа ноды
+
+**Шаг 1: Зарегистрируйте ноду в соответствующем registry файле**
+
+Найдите или создайте файл реестра для категории в `backend/src/core/node-registries/`.
+
+Для событий это файл `backend/src/core/node-registries/events.js`:
+
+```javascript
+function registerNodes(registry) {
+  // ... существующие ноды
+
+  registry.registerNodeType({
+    type: 'event:botStartup',
+    label: '🚀 При запуске бота',
+    category: 'События',
+    description: 'Срабатывает один раз при запуске бота.',
+    graphType: GRAPH_TYPES.EVENT,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      ]
+    }
+  });
+}
+```
+
+### 3. Backend: Добавление логики выполнения (для нод действий)
+
+Если нода выполняет какое-то действие (не события), необходимо создать обработчик в `backend/src/core/node-handlers/`.
+
+**Пример структуры обработчика:**
+
+```javascript
+module.exports = async (nodeId, inputData, context) => {
+  const { botManager, botId, state } = context;
+
+  // Ваша логика здесь
+
+  return {
+    outputs: {
+      result: 'значение',
+      // ...
+    }
+  };
+};
+```
+
+### 4. Backend: Триггеры событий (для event нод)
+
+Если вы создаете event ноду, нужно добавить вызов события в соответствующем месте кода.
+
+**Пример: Событие запуска бота**
+
+В файле `backend/src/core/services/BotLifecycleService.js`, метод `_handleBotReady()`:
+
+```javascript
+_handleBotReady(botId) {
+  this.emitStatusUpdate(botId, 'running', 'Бот успешно подключился к серверу.');
+  this.crashCounters.delete(botId);
+
+  // ... Socket.IO код
+
+  // Триггерим событие запуска бота
+  if (this.eventGraphManager) {
+    this.eventGraphManager.handleEvent(botId, 'botStartup', {});
+  }
+}
+```
+
+### 5. Структура типов нод
+
+#### Типы пинов
+
+- **Exec** - пин выполнения (flow control)
+- **String** - строка
+- **Number** - число
+- **Boolean** - булево значение
+- **Object** - объект
+- **Array** - массив
+- **User** - объект пользователя
+- **Wildcard** - любой тип (динамический)
+
+#### Категории нод
+
+- **event** - События (триггеры графов)
+- **action** - Действия (отправка сообщений, HTTP запросы)
+- **flow** - Управление потоком (ветвления, циклы)
+- **data** - Данные (литералы, переменные)
+- **logic** - Логические операции
+- **math** - Математические операции
+- **string** - Операции со строками
+- **array** - Операции с массивами
+- **object** - Операции с объектами
+- **time** - Работа с датой/временем
+- **user** - Работа с пользователями
+- **bot** - Информация о боте
+- **debug** - Отладка
+
+### 6. Ноды с настройками (Settings Component)
+
+Если нода требует UI для настроек, создайте компонент настроек:
+
+**Пример: StringLiteralSettings.jsx**
+
+```javascript
+import React from 'react';
+import { AutosizeInput } from '@/components/ui/AutosizeInput';
+
+const StringLiteralSettings = ({ nodeId, data, updateNodeData }) => {
+  return (
+    <div className="p-2 w-full">
+      <AutosizeInput
+        className="nodrag bg-slate-900 border-slate-500 rounded-md py-1 px-2 text-sm resize-none overflow-hidden w-full"
+        value={data.value ?? ''}
+        onChange={(e) => updateNodeData(nodeId, { value: e.target.value })}
+        placeholder="Привет, {username}!"
+      />
+    </div>
+  );
+};
+
+export default StringLiteralSettings;
+```
+
+Затем подключите его в определении ноды:
+
+```javascript
+import StringLiteralSettings from './StringLiteralSettings';
+
+export const stringLiteralDefinition = new NodeDefinition({
+  // ...
+  SettingsComponent: StringLiteralSettings,
+  // ...
+});
+```
+
+### 7. Динамические пины (computeInputs/computeOutputs)
+
+Ноды могут иметь динамическое количество пинов в зависимости от данных:
+
+```javascript
+computeInputs: (data) => {
+  const inputs = [
+    { id: 'value', name: 'Текст', type: 'String', required: false, inlineField: true }
+  ];
+
+  // Динамически добавляем пины для переменных
+  const text = data.value || '';
+  const variablePattern = /\{([a-zA-Z_][a-zA-Z0-9_]*)\}/g;
+  const matches = [...text.matchAll(variablePattern)];
+  const uniqueVars = [...new Set(matches.map(m => m[1]))];
+
+  uniqueVars.forEach(varName => {
+    inputs.push({
+      id: `var_${varName}`,
+      name: varName,
+      type: 'Wildcard',
+    });
+  });
+
+  return inputs;
+},
+```
+
+### 8. Проверка работоспособности
+
+После добавления ноды:
+
+1. Перезапустите frontend (если используете HMR, изменения применятся автоматически)
+2. Перезапустите backend
+3. Откройте визуальный редактор
+4. Проверьте, что нода появилась в списке доступных нод
+5. Создайте граф с новой нодой и протестируйте её работу
+
+### 9. Автоматическое распознавание событий
+
+Система автоматически распознаёт event ноды при сохранении графа:
+
+- В файле `backend/src/api/routes/eventGraphs.js` код автоматически извлекает все ноды типа `event:*` из графа
+- Создаются соответствующие триггеры в таблице `EventGraphTrigger`
+- При загрузке графов для бота (`EventGraphManager.loadGraphsForBot`), графы группируются по типам событий
+
+Это означает, что для новых event нод не требуется дополнительная регистрация триггеров - достаточно правильно назвать тип ноды (формат: `event:название_события`).
+
+---
+
+## Дополнительные ресурсы
+
+- Примеры нод: `frontend/src/components/visual-editor/nodes/`
+- Обработчики нод: `backend/src/core/node-handlers/`
+- Регистрация нод: `backend/src/core/node-registries/`