N8N MNU

ДОКУМЕНТАЦИЯ ПРОЕКТА N8N MNU

1. НАЗНАЧЕНИЕ СИСТЕМЫ

n8n MNU — внутренняя платформа визуальной автоматизации процессов и AI-сценариев Maqsut Narikbayev University. Система развёрнута на доменах ai.mnu.kz и ai2.mnu.kz и используется сотрудниками и студентами университета.

Основные возможности

визуальное создание воркфлоу без написания программного кода;
автоматическая обработка событий из внутренних и внешних систем;
интеграция с Microsoft 365 и Google Workspace;
работа с языковыми моделями через OpenRouter, OpenAI и LiteLLM Proxy;
обработка заявок и сообщений из Admission CRM и Advisor CRM;
создание Telegram-ботов и сценариев обработки сообщений;
отправка электронных писем и автоматических уведомлений;
запуск процессов вручную, по расписанию или при поступлении события;
разделение доступа между пользователями, проектами и подразделениями;
ведение журнала запусков, результатов и ошибок;
использование платформы для практических занятий, курсовых проектов и хакатонов;
экспорт, импорт и резервное копирование воркфлоу через REST API.

2. ИСТОЧНИКИ ДАННЫХ

Основными источниками данных являются:

пользователи платформы — ручной ввод данных, настройка и запуск воркфлоу;
Microsoft 365 — Outlook, Calendar, Teams и OneDrive;
Google Workspace — Google Sheets, Drive, Gmail, Calendar и Docs;
Admission CRM — события о новых заявках, сообщениях и изменениях статусов;
Advisor CRM — события, связанные с обращениями и внутренними рабочими процессами;
Telegram — сообщения, команды, фотографии и файлы пользователей;
WhatsApp-сервис — входящие и исходящие сообщения;
OpenRouter и OpenAI — ответы языковых моделей, генерация материалов и транскрипция;
LiteLLM Proxy — централизованный доступ к локальным и облачным AI-моделям;
внутренние API MNU — данные подключённых университетских систем;
HTTP webhook — события от внешних сервисов;
планировщик задач — автоматический запуск процессов по установленному расписанию.

3. КАКИЕ ДАННЫЕ ОБРАБАТЫВАЮТСЯ

В системе обрабатываются:

e-mail, роль, статус и хэш пароля пользователя;
принадлежность пользователя к проекту или рабочей группе;
структура воркфлоу: ноды, связи, параметры и условия выполнения;
тексты системных инструкций и AI-промптов;
Client ID, Client Secret, API-ключи и OAuth-токены интеграций;
входные и выходные данные каждой ноды;
содержимое электронных писем и вложений;
данные календарей и мероприятий;
файлы из OneDrive и Google Drive;
содержимое сообщений Telegram и WhatsApp;
заявки и события из Admission CRM и Advisor CRM;
запросы к языковым моделям и передаваемый контекст;
ответы AI-моделей, транскрипции и результаты генерации;
журналы запусков, ошибок и системных событий;
время запуска, продолжительность и статус выполнения сценария.

Параметры подключений и credentials сохраняются в базе данных в зашифрованном виде. В учебных сценариях используются тестовые и синтетические данные. Рабочие данные обрабатываются в проектах соответствующих подразделений.

4. КАК ПЕРЕДАЮТСЯ ДАННЫЕ

Пользователи работают с платформой через веб-интерфейс по HTTPS. Обмен между n8n MNU и подключёнными сервисами выполняется через REST API, webhook, OAuth 2.0, SMTP и специализированные API провайдеров.

Основные направления обмена

Пользователь ↔ n8n MNU
Microsoft 365 ↔ n8n MNU
Google Workspace ↔ n8n MNU
Admission CRM → webhook → n8n MNU
Advisor CRM → webhook → n8n MNU
Telegram Bot API ↔ n8n MNU
WhatsApp-сервис ↔ n8n MNU
n8n MNU ↔ OpenRouter
n8n MNU ↔ OpenAI
n8n MNU ↔ LiteLLM Proxy
n8n MNU → SMTP → Пользователь
n8n MNU ↔ Внутренние API MNU
Внешний сервис → webhook → n8n MNU
Администратор ↔ n8n REST API

Microsoft 365

Пользователь → n8n MNU — пользователь выбирает подключение Microsoft 365.
n8n MNU → Microsoft Entra ID — пользователь направляется на корпоративную авторизацию.
Microsoft Entra ID → n8n MNU — возвращается OAuth-токен конкретной учётной записи.
n8n MNU ↔ Microsoft Graph API — выполняется работа с Outlook, Calendar, Teams и OneDrive.

Каждый пользователь проходит отдельную OAuth-авторизацию. Полученный токен связывается с его корпоративной учётной записью.

Google Workspace

Пользователь → n8n MNU — пользователь выбирает подключение Google Workspace.
n8n MNU → Google OAuth — выполняется авторизация пользователя.
Google OAuth → n8n MNU — возвращается персональный OAuth-токен.
n8n MNU ↔ Google API — выполняется работа с Sheets, Drive, Gmail, Calendar и Docs.

Входящие webhook

Внешний сервис → webhook n8n MNU — передаётся HTTP-запрос с данными в формате JSON.
Webhook → Workflow — входящее событие запускает необходимый воркфлоу.
Workflow → Подключённые сервисы — выполняются предусмотренные сценарием действия.
Workflow → Внешний сервис — возвращается результат обработки.

Публичные webhook размещаются по адресам вида:

https://ai.mnu.kz/webhook/<path>

AI-провайдеры

n8n MNU → OpenRouter/OpenAI — передаются промпт, контекст и параметры модели.
OpenRouter/OpenAI → n8n MNU — возвращаются текст, транскрипция, изображение или другой результат.
n8n MNU → Следующая нода — полученный результат используется в дальнейшем сценарии.

Запросы выполняются через REST API с авторизацией по API-ключу.

LiteLLM Proxy

n8n MNU → LiteLLM Proxy — передаётся запрос к языковой модели.
LiteLLM Proxy → Локальная или облачная AI-модель — выбирается нужный провайдер.
AI-модель → LiteLLM Proxy → n8n MNU — результат возвращается в воркфлоу.

LiteLLM Proxy выступает единой точкой маршрутизации запросов к различным AI-моделям инфраструктуры MNU.

Пользователь → Telegram Bot API — отправляется сообщение, команда, изображение или файл.
Telegram Bot API → n8n MNU — входящее событие запускает воркфлоу.
n8n MNU → Подключённые сервисы — выполняется обработка сообщения.
n8n MNU → Telegram Bot API → Пользователь — отправляется подготовленный ответ.

SMTP

Событие в Workflow → n8n MNU — формируется электронное письмо.
n8n MNU → SMTP-сервер — передаются получатель, тема, текст и вложения.
SMTP-сервер → Пользователь — письмо доставляется на электронную почту.

Внутренние API MNU

n8n MNU → Внутренняя система MNU — отправляется REST-запрос с токенной авторизацией.
Внутренняя система MNU → n8n MNU — возвращается результат в формате JSON.
n8n MNU → Следующая нода — данные обрабатываются и используются в дальнейшем сценарии.

Резервное копирование

Администратор → n8n REST API — запрашивается список воркфлоу и метаданных credentials.
n8n REST API → Администратор — возвращаются воркфлоу, идентификаторы, названия и типы подключений.
Сервер n8n → Резервное хранилище — экспортируются зашифрованные credentials и системные данные.

Полный серверный экспорт credentials выполняется через CLI n8n с использованием ключа шифрования.

5. СТРУКТУРА СИСТЕМЫ

Инстансы платформы

Платформа работает на двух доменах:

ai.mnu.kz
ai2.mnu.kz

Оба инстанса имеют одинаковые функциональные возможности и используются сотрудниками и студентами.

Каждый инстанс имеет собственные:

базу данных PostgreSQL;
учётные записи пользователей;
проекты и роли;
воркфлоу;
credentials интеграций;
историю выполнений;
webhook-адреса;
системные настройки.

Workflows

Модуль предназначен для создания, редактирования, хранения и запуска сценариев автоматизации.

Воркфлоу состоит из связанных нод. Каждая нода отвечает за отдельное действие: получение данных, проверку условия, обращение к API, отправку сообщения или сохранение результата.

Credentials

Модуль хранит настройки подключений к внешним и внутренним сервисам:

OAuth-токены;
API-ключи;
Client ID;
Client Secret;
логины и пароли;
параметры подключения.

Credentials сохраняются в PostgreSQL в зашифрованном виде и могут быть привязаны к пользователю или проекту.

Executions

Модуль хранит журнал выполнений воркфлоу.

Для каждого запуска сохраняются:

время начала и завершения;
статус выполнения;
входные и выходные данные;
результат каждой ноды;
сообщения об ошибках;
продолжительность выполнения.

Projects

Projects разделяет воркфлоу и credentials между командами, подразделениями и учебными группами.

Пользователь получает доступ к ресурсам проекта в соответствии со своей ролью.

Users & Roles

Модуль отвечает за пользователей, приглашения и разграничение прав.

Основные роли:

Owner — владелец инстанса;
Admin — администратор платформы;
Member — пользователь с доступом к разрешённым проектам и воркфлоу.

Webhooks

Webhooks принимают события от внутренних и внешних систем.

Каждый webhook имеет собственный URL и связан с определённым воркфлоу. После получения запроса система автоматически запускает соответствующий сценарий.

Triggers

Triggers отвечают за запуск процессов.

Основные типы запуска:

ручной запуск пользователем;
запуск по расписанию;
запуск по входящему webhook;
запуск при получении письма;
запуск при поступлении сообщения;
запуск при изменении данных в подключённом сервисе.

Public REST API

Public REST API предоставляет программный доступ к функциям платформы.

API используется для:

получения списка воркфлоу;
экспорта и импорта сценариев;
получения статусов выполнений;
мониторинга платформы;
резервного копирования;
получения метаданных credentials.

6. ИНТЕГРАЦИИ

Microsoft 365 / Entra ID

Microsoft 365 ↔ n8n MNU
отвечает за работу с Outlook, Calendar, Teams и OneDrive;
авторизация выполняется через Microsoft Entra ID;
обмен данными выполняется через Microsoft Graph API;
каждый OAuth-токен привязан к конкретной корпоративной учётной записи.

Google Workspace

Google Workspace ↔ n8n MNU
отвечает за работу с Sheets, Drive, Gmail, Calendar и Docs;
подключение выполняется через OAuth 2.0;
каждый пользователь отдельно авторизует свою учётную запись Google.

Admission CRM

Admission CRM → webhook → n8n MNU
передаёт события о новых заявках, сообщениях и изменениях статусов;
n8n запускает соответствующий воркфлоу;
результат обработки может быть отправлен обратно в CRM через REST API.

Общая связь:

Admission CRM ↔ n8n MNU

Advisor CRM

Advisor CRM → webhook → n8n MNU
передаёт события, связанные с обращениями и внутренними процессами;
n8n обрабатывает JSON-данные и выполняет необходимые действия;
результат может быть возвращён в Advisor CRM.

Общая связь:

Advisor CRM ↔ n8n MNU

OpenRouter

n8n MNU → OpenRouter — передаётся AI-запрос.
OpenRouter → Выбранная AI-модель — запрос направляется подходящему провайдеру.
AI-модель → OpenRouter → n8n MNU — возвращается результат обработки.

Общая связь:

OpenRouter ↔ n8n MNU

OpenAI

n8n MNU → OpenAI — передаются промпт, контекст и параметры модели.
OpenAI → n8n MNU — возвращаются текст, транскрипция, изображение или другой результат.

Общая связь:

OpenAI ↔ n8n MNU

LiteLLM Proxy

n8n MNU → LiteLLM Proxy — передаётся запрос к AI-модели.
LiteLLM Proxy → Локальная или облачная модель — выполняется маршрутизация запроса.
AI-модель → LiteLLM Proxy → n8n MNU — возвращается результат.

Общая связь:

LiteLLM Proxy ↔ n8n MNU

Telegram Bot API

Telegram → n8n MNU — поступают сообщения, команды, изображения и файлы.
n8n MNU → Telegram — отправляются ответы и уведомления.

Общая связь:

Telegram Bot API ↔ n8n MNU

WhatsApp-сервис

WhatsApp-сервис → n8n MNU — передаются входящие сообщения.
n8n MNU → WhatsApp-сервис — направляются подготовленные ответы.

Общая связь:

WhatsApp-сервис ↔ n8n MNU

SMTP

n8n MNU → SMTP-сервер
SMTP-сервер → Пользователь

Общая цепочка:

n8n MNU → SMTP → Пользователь

Внутренние системы MNU

Внутренняя система MNU → webhook → n8n MNU
n8n MNU → REST API → Внутренняя система MNU

Общая связь:

Внутренние системы MNU ↔ n8n MNU

ТЕХНОЛОГИЧЕСКАЯ ОСНОВА

n8n / Node.js — платформа автоматизации;
PostgreSQL — хранение пользователей, воркфлоу, credentials и истории выполнений;
Redis — очереди и распределённое выполнение задач;
Docker Compose — развёртывание компонентов платформы;
Reverse Proxy — маршрутизация входящих запросов;
HTTPS — защищённое соединение для ai.mnu.kz и ai2.mnu.kz;
REST API и Webhook — интеграционный обмен;
JSON — основной формат передачи данных;
OAuth 2.0 — авторизация Microsoft 365 и Google Workspace;
API-ключи и токены — авторизация подключённых сервисов;
N8N_ENCRYPTION_KEY — шифрование credentials в базе данных.