ваше сообщение коммита

backend/docs/MODULE_IDS.md

@@ -0,0 +1,173 @@
+# ID Модулей DLE
+
+## Обзор
+
+В системе DLE каждый модуль имеет уникальный идентификатор (ID), который используется для:
+- Идентификации модуля в смарт-контракте
+- Создания governance предложений
+- Проверки статуса модуля
+
+## Формат ID
+
+ID модулей представляют собой 32-байтные хеши в формате:
+```
+0x[32 байта в hex формате]
+```
+
+### Стандартные модули
+
+Стандартные модули используют ASCII-коды названий, дополненные нулями до 32 байт:
+
+| Модуль | ID | Описание |
+|--------|----|---------| 
+| **Treasury** | `0x7472656173757279000000000000000000000000000000000000000000000000` | Модуль управления казной |
+| **Timelock** | `0x74696d656c6f636b000000000000000000000000000000000000000000000000` | Модуль задержки выполнения |
+| **Reader** | `0x7265616465720000000000000000000000000000000000000000000000000000` | Модуль чтения данных |
+
+### Дополнительные модули
+
+Дополнительные модули могут использовать другие форматы ID:
+
+| Модуль | ID | Описание |
+|--------|----|---------|
+| **Multisig** | `0x6d756c7469736967000000000000000000000000000000000000000000000000` | Мультиподписный модуль |
+| **Deactivation** | `0x646561637469766174696f6e0000000000000000000000000000000000000000` | Модуль деактивации |
+| **Analytics** | `0x616e616c79746963730000000000000000000000000000000000000000000000` | Модуль аналитики |
+| **Notifications** | `0x6e6f74696669636174696f6e7300000000000000000000000000000000000000` | Модуль уведомлений |
+
+## Использование в коде
+
+### Константы
+
+Все ID модулей определены в файле `backend/constants/moduleIds.js`:
+
+```javascript
+const { MODULE_IDS, MODULE_TYPE_TO_ID, MODULE_ID_TO_TYPE } = require('../constants/moduleIds');
+
+// Использование
+const treasuryId = MODULE_IDS.TREASURY;
+const moduleType = MODULE_ID_TO_TYPE[moduleId];
+const moduleId = MODULE_TYPE_TO_ID['treasury'];
+```
+
+### API Endpoints
+
+ID модулей используются в следующих API endpoints:
+
+- `POST /api/dle-modules/initialize-modules` - инициализация модулей
+- `POST /api/dle-modules/deploy-module` - деплой модуля
+- `GET /api/dle-modules/check-module-status` - проверка статуса модуля
+- `POST /api/dle-history/get-extended-history` - получение истории
+
+### Смарт-контракт
+
+В смарт-контракте DLE ID модулей используются в:
+
+```solidity
+// Добавление модуля
+function createAddModuleProposal(
+    string memory _description,
+    uint256 _duration,
+    bytes32 _moduleId,  // <-- ID модуля
+    address _moduleAddress,
+    uint256 _chainId
+) external returns (uint256);
+
+// Проверка модуля
+function isModuleActive(bytes32 _moduleId) external view returns (bool);
+function getModuleAddress(bytes32 _moduleId) external view returns (address);
+```
+
+## Добавление новых модулей
+
+### 1. Определить ID модуля
+
+```javascript
+// В backend/constants/moduleIds.js
+const MODULE_IDS = {
+  // ... существующие модули
+  NEW_MODULE: '0x6e65776d6f64756c650000000000000000000000000000000000000000000000'
+};
+```
+
+### 2. Обновить маппинги
+
+```javascript
+const MODULE_TYPE_TO_ID = {
+  // ... существующие модули
+  newModule: MODULE_IDS.NEW_MODULE
+};
+
+const MODULE_ID_TO_TYPE = {
+  // ... существующие модули
+  [MODULE_IDS.NEW_MODULE]: 'newModule'
+};
+
+const MODULE_NAMES = {
+  // ... существующие модули
+  newModule: 'New Module'
+};
+```
+
+### 3. Обновить функцию getModuleName
+
+```javascript
+// В backend/routes/dleHistory.js
+function getModuleName(moduleId) {
+  if (MODULE_ID_TO_TYPE[moduleId]) {
+    const moduleType = MODULE_ID_TO_TYPE[moduleId];
+    return MODULE_NAMES[moduleType] || moduleType;
+  }
+  
+  const additionalModuleNames = {
+    // ... существующие модули
+    '0x6e65776d6f64756c650000000000000000000000000000000000000000000000': 'New Module'
+  };
+  
+  return additionalModuleNames[moduleId] || `Module ${moduleId}`;
+}
+```
+
+## Безопасность
+
+- ID модулей должны быть уникальными
+- Не используйте предсказуемые ID для критических модулей
+- Все изменения ID должны проходить через governance
+
+## Миграция
+
+При изменении ID модуля:
+
+1. Создать governance предложение для удаления старого модуля
+2. Создать governance предложение для добавления нового модуля с новым ID
+3. Обновить константы в коде
+4. Обновить базу данных (если необходимо)
+
+## Примеры
+
+### Создание предложения для добавления модуля
+
+```javascript
+const moduleId = MODULE_TYPE_TO_ID['treasury'];
+const moduleAddress = '0x1234567890123456789012345678901234567890';
+
+// Создание предложения через governance
+const proposalId = await dleContract.createAddModuleProposal(
+  'Добавить Treasury модуль',
+  86400, // 1 день
+  moduleId,
+  moduleAddress,
+  1 // Ethereum mainnet
+);
+```
+
+### Проверка статуса модуля
+
+```javascript
+const moduleId = MODULE_TYPE_TO_ID['treasury'];
+const isActive = await dleContract.isModuleActive(moduleId);
+const moduleAddress = await dleContract.getModuleAddress(moduleId);
+
+console.log(`Treasury модуль: ${isActive ? 'активен' : 'неактивен'}`);
+console.log(`Адрес: ${moduleAddress}`);
+```