n8n-nodes-monday-parser/INSTALL.md

Custom n8n node for parsing and structuring Monday.com data with advanced column type handling

# Инструкции по установке

## Подготовка окружения

1. Убедитесь, что у вас установлены:
   - Node.js 18+ 
   - npm или yarn
   - n8n (версия 1.0+)

## Установка зависимостей

```bash
# Установите зависимости
npm install

# Установите дополнительный пакет для gulp
npm install -g gulp-cli
```

## Сборка проекта

```bash
# Соберите TypeScript код
npm run build

# Или запустите в режиме разработки
npm run dev
```

## Установка в n8n

### Способ 1: Community Package (рекомендуется)

1. Опубликуйте пакет в npm registry
2. В n8n перейдите в Settings → Community Nodes
3. Установите пакет `n8n-nodes-monday-parser`

### Способ 2: Локальная установка

1. Скопируйте папку `dist` в директорию с кастомными нодами n8n
2. Перезапустите n8n

### Способ 3: Переменная окружения

```bash
# Установите переменную окружения
export N8N_CUSTOM_EXTENSIONS_DIR="/path/to/your/custom/nodes"

# Скопируйте собранные файлы
cp -r dist/* $N8N_CUSTOM_EXTENSIONS_DIR/
```

## Тестирование

1. Запустите n8n: `npx n8n start`
2. Создайте новый workflow
3. Найдите ноду "Monday Parser" в категории Transform
4. Добавьте тестовые данные Monday.com
5. Настройте параметры ноды
6. Запустите workflow

## Примеры данных для тестирования

```json
{
  "id": "123456789",
  "name": "Тестовый элемент",
  "created_at": "2023-01-01T00:00:00Z",
  "state": "active",
  "column_values": [
    {
      "id": "status",
      "type": "status",
      "value": "{\"index\": 1, \"label\": \"В работе\"}",
      "text": "В работе",
      "column": {"title": "Статус"}
    }
  ]
}
```

## Устранение неполадок

### Ошибка "Module not found"
- Убедитесь, что все зависимости установлены
- Проверьте правильность путей в package.json

### Нода не отображается в n8n
- Проверьте правильность сборки: `npm run build`
- Убедитесь, что файлы скопированы в правильную директорию
- Перезапустите n8n

### Ошибки TypeScript
- Проверьте версию TypeScript: `npx tsc --version`
- Убедитесь, что все типы установлены: `npm install @types/node`