# Збудувати систему робочого потоку за допомогою HTMX та ASP.NET Core - Część 1: Вprowadzenie

<!--category-- ASP.NET, HTMX, Alpine.js, Workflow -->
<datetime class="hidden">2025-01-15T12:00</datetime>

## Введение

Системи робочого потоку є всюди у сучасних застосуваннях. - від простих процесів до складних мультиплікових систем -штовхової автоматізації МSK2 В той час, як існують чудові коммерційні рішення, такі як Temporal | , | Airflow | МSK4 | n | 8 | N | мSK6 | інколи вам потрібно щось, що підходить до ваших конкретних потреб |МSK7 | В цій серії |, | I |' | я покажу вам, як побудувати повну систему робочого процесу з нуля, використовуючи ASP

До кінця цієї серії ви матимете повністю функціональну систему робочого потоку з

- Базований редактор візуального узла- для створення операційних потоків
- JSON-визначені ланцюги робочого потоку з вхідамиM SK1 виходами , та умовами
- Мотор налаштування процесу виконання
- Обробка робочих місць за допомогою Hangfire для віддалених API
- Управлення державою та наполегливість
- Dashboard для моніторингу виконання робочого потоку

[TOC]

## Чому треба будувати власну систему робочого потоку?

Перед тим, як зануритися в воду, дайте мені сказати слону в кімнаті: Чому б не використати існуюче рішення?

**Коли будувати власну**

- Потрібна глибока інтеграція з існуючою програмою
- У вас є певна логіка бізнесу, яка не вписується в інструменти типового процесу роботи
- Ви хочете повністю контролювати модель виконання і масштабування
- Потрібно мінімізувати зовнішні віддалежності
- Ви хочете дізнатися, як працюють системи робочого потоку під капюшоном

**Коли використовувати наявні інструменти:**

- Вам потрібно безпосереднє, перевірене рішення
- Ви потребуєте таких властивостей, як розподіляє виконання на багатьох машинах
- Ви не маєте часу будувати та підтримувати на замовлення інфраструктуру

Для цієї серії ми вирішили створити власну машину, тому що вона дає нам повну гнучкість і є чудовою можливістю навчання.

## Що ми будуємо

Наша система робочого потоку підтримає кілька ключових концепцій:

### 1. Зв 'язки

Ноди - це будівельні блоки робочого потоку. Кожний вузол - це дискретна дія або точка прийняття рішеньM SK1 До прикладів:

- **HTTP-нод прохання**: Змушує API викликати зовнішні послуги
- **Рівень умов**: Оцінює вираження та виконання гілок
- **Перетворити вузол**: Дані обробки ( маніпуляція JSON МSK2 фильтрація M SK3 і т.д.
- **Нод затримки**: чекає певного часу
- **Нод триггера**: Розпочинає робочий процес на основі подій або календарів

### 2. робочі потоки

Рабочий потік - це орієнтований графік з 'єднаних вузлів. Дані переносяться від одного вузла до іншого через зв' язкиM SK1 кожен вузл обробляє та трансформує дані, як потрібно.

### 3. Випускний двигун

Машина, яка інтерпретує визначення робочого потоку і виконує вузли в правильному порядку

- Последовательне виконання
- Паралельне виконання ( коли вузли не залежать один від одного ' не залежні одна від одної МSK2
- Суворі відтінки
- Виліковування і повторення помилок
- Суворість держави

### 4. Визуальний редактор

Веб-интерфейс на основі-, де користувачі можуть

- Перетащите вузли на полотно
- Об 'єднати вузли, малюючи краї між ними
- Konfigurувати властивості вузлів
- Випробувати робочі потоки
- Подивіться на історію виконання

### 5. Обробка фону

Використовуючи систему Hangfire, ми

- Запланований процес виконання
- API опитування для зовнішніх даних
- Знову спробувати логіку
- Панель для моніторингу робіт

## Набір технологій

Ось що ми будемо використовувати

### Взагалі

- **ASP.NET Core 9.0**: Наша веб-стратегія
- **Кора сутності**: Для тривалості даних
- **ПостгрSQL**: База даних для збереження визначення потоку роботи та стану виконання
- **Постріл**: Обробка базових завдань
- **Система.TextM SK1Json**: Для серіалізації потоку роботи JSON

### Frontend

- **HTMX 2.0**: Для динамічногоM SK1 сервера-вживання інтерфейсу без написання JavaScript
- **Alpine.js**: легка Java-магистратура для інтерактивних компонентів
- **TailwindCSS + DaisyUI**: Дизайн та інтерфейс
- **Лінія лідера**: Для малювання зв 'язків між вузлами МSK1 ми МSK2 ми дослідимо альтернативи )

### Інфраструктура

- **Докер**: Для контейнеризації
- **Скв**: Для структурного журналування
- **Прометеус + Графана**: Для моніторингу

## Уявлення про архітектуру

Наша система буде організована на кілька проектів:

```
Mostlylucid.Workflow/
├── Mostlylucid.Workflow.Engine/      # Core workflow execution engine
│   ├── Models/                        # Node, Workflow, Connection models
│   ├── Execution/                     # Workflow executor and runtime
│   └── Nodes/                         # Built-in node implementations
├── Mostlylucid.Workflow.Shared/       # Shared models and DTOs
├── Mostlylucid.Workflow.DbContext/    # Entity Framework context
└── Mostlylucid/                       # Main web app (existing)
    ├── Controllers/WorkflowController.cs
    ├── Services/WorkflowService.cs
    └── Views/Workflow/                # Workflow UI views
```

### Головні рішення щодо дизайну

**1. JSONM SK1Definiції базових вузлів**
Ноди будуть визначені в JSON,, що зробить їх легкими для серійизації

```json
{
  "id": "node-1",
  "type": "HttpRequest",
  "name": "Fetch User Data",
  "inputs": {
    "url": "https://api.example.com/users/{{userId}}",
    "method": "GET",
    "headers": {
      "Authorization": "Bearer {{apiToken}}"
    }
  },
  "outputs": {
    "response": "{{result.body}}",
    "statusCode": "{{result.statusCode}}"
  },
  "conditions": {
    "onSuccess": "next-node-id",
    "onError": "error-handler-node-id"
  }
}
```

**2. Граф МSK1Основне виконання**
Рабочі потоки скеровані ациклічними графами.

- Виконуйте топологічне сортування, щоб визначити порядок виконання
- Виконувати вузли паралельно, якщо це можливо
- Рухати умовним відтінком на основі виходів вузлів

**3. Статус тривалості**
Кожне виконання робочого потоку відслідковується:

- Статус інстанції робочого потоку (Running , CompletedM SK2 Failed)
- Результати виконання вузлів
- Статуї триггера для запланованих потоків роботи
- Історія виконання і журнали

**4. Розширюваність**
Система узла буде за допомогою плагину-based:

- Вбудовані - в вузли для об 'єднаних операцій
- Можна зареєструвати типи вузлів на замовлення
- Веріалізація вузлів та введення схем

## Що з 'являється в цій серії

### Зразок 2: Архітектура і ядро робочого потоку

- Установлення структури проекту
- Збудовування базових моделей робочого потоку (Node, WorkflowM SK2 Connection )
- Втілення графічного інтерфейсу
- Топологічне сортування і розпізнавання залежності

### Частина 3: Збудування візуального редактора

- Створити канву робочого потоку за допомогою HTMX та Alpine.js
- Перетягніть - і МSK1
- Візуальний малюнок підключення
- Панель конфігурації вузлів
- Серіалізація робочого процесу

### Частина 4: Інтеграція та управління державою Hangfire

- Установлення Hangfire для обробки фону
- Втілення API для голосування
- Менеджмент триггерів
- Знову спробувати логіку та подолання помилок
- Інтеграція на панелі

### Частка 5: Заawansовані характеристики та застосування

- Втілення індивідуальних вузлів
- Версію робочого потоку
- Тестування стратегій
- Оптимізація ефективності
- Розгортання дротів

## Потрібні умови

Для того, щоб слідувати за цією серії, треба мати

- .NET 9.0 SDK zainstalowanий
- Базові знання ASP.NET Core MVC
- Знайомість з ядром сутності
- Усвідомлення HTML, CSS, та базового JavaScript
- Докер (опціональний, для запуску залежностейM SK2

## Початок

На наступному листі – МСК0, ми – МSK1 – зануримося прямо у будівлю ядра робочого потоку, МСК2 – ми – ' – створимо моделі, МSK4 – запровадимо виконання, , – і напишемо наш перший робочий процес, який може бути запрограмований.

Це буде веселою подорожі. МСК0 Ми збудуємо щось дійсно корисние, вивчаючи алгоритми графів, МСК2, обробку фону, МSK3 та сучасні моделі розвитку вебу

## Завершення

Побудувати систему робочого потоку з нуля - це амбітний проект. МСК0, але це також неймовірно винагороджує. МSK2 Ви, МСК3, отримаєте глибокі знання про те, як працюють сучасні автоматизовані платформи.

У частині "2," ми МSK1 розпочнемо програмування "!" Ми МSK3 зробимо структуру проекту і збудуємо ядро робочого потоку, що зможе виконувати наші спільні Node , - базові робочі потоки .

Залишайся на зв 'язку!