شروع سریع

این صفحه کوتاه‌ترین مسیر برای آشنایی با TaskFlow است. اگر جزئیات بیشتری می‌خواهید، راهنمای کامل را ببینید.

---

پیش‌نیازها

• .NET SDK 10 یا نسخهٔ پروژه
• (اختیاری) Docker برای Postgres

---

اجرای سرور

git clone https://github.com/mortenaho/WorkFlowEngine.git
cd WorkFlowEngine
dotnet run --project src/TaskFlow.Server

سرور روی http://127.0.0.1:8081 بالا می‌آید. در محیط Development بدون WF_API_KEYS هم کار می‌کند.

مستندات تعاملی: Swagger

---

اولین فرایند (curl)

۱. شروع

curl -s -X POST http://127.0.0.1:8081/v1/processes/start \
  -H 'Content-Type: application/json' \
  -H 'X-Actor-Id: alice' \
  -d '{"processKey":"purchase","initiator":"alice","parameters":{"amount":100}}'

خروجی: definitionKey و instanceId — این‌ها را برای مراحل بعد نگه دارید.

۲. ارجاع به کاربر

curl -s -X POST http://127.0.0.1:8081/v1/assignments \
  -H 'Content-Type: application/json' \
  -H 'X-Actor-Id: alice' \
  -d '{
    "definitionKey": "purchase",
    "parentInstanceId": "INSTANCE_ID",
    "title": "بررسی",
    "to": { "kind": "user", "id": "mortenaho" }
  }'

۳. کارتابل و تکمیل

# کارتابل mortenaho
curl -s 'http://127.0.0.1:8081/v1/tasks?user=mortenaho' -H 'X-Actor-Id: mortenaho'

# تکمیل تسک
curl -s -X POST http://127.0.0.1:8081/v1/tasks/TASK_ID/complete \
  -H 'Content-Type: application/json' \
  -H 'X-Actor-Id: mortenaho' \
  -d '{"note":"تأیید شد"}'

اسکریپت کامل: examples/curl.sh

---

اتصال از C# (میکروسرویس)

یک بار سرور را بالا بیاورید؛ هر سرویس فقط SDK را اضافه می‌کند:

builder.Services.AddTaskFlowClient(o =>
{
    o.BaseAddress = new Uri("http://127.0.0.1:8081/");
});

// در هندلر:
var started = await tf.Start("purchase", "alice");

جزئیات: SDK و میکروسرویس

---

مرحلهٔ بعد

موضوع	لینک
اپ نمونه (Next.js BFF)	employee-termination-app
ارجاع موازی و onAllCompleted	usage → تخصیص موازی
معماری BFF و API Key	architecture
Postgres و مهاجرت	database
Docker Compose	usage → پیکربندی