hesabix/arc

Watch

Fork 1

Babak Alizadeh 0764deeaa1 change file permissions

2026-04-14 19:34:55 +03:30

41 KiB

Executable file

Raw Permalink Blame History

پیشنهادات بهبود سیستم اتوماسیون و Workflow

این سند شامل پیشنهادات جامع برای بهبود عملکرد و افزایش تنظیمات هر نود در سیستم workflow است.

📋 فهرست محتوا

Triggers (محرک‌ها)
Actions (عمل‌ها)
Conditions (شرط‌ها)
Loops (حلقه‌ها)
بهبودهای کلی موتور Workflow

🔷 Triggers

1. DocumentCreatedTrigger (ایجاد سند)

پیشنهادات بهبود عملکرد:

Caching: کش کردن metadata نوع سند برای کاهش query به دیتابیس
Batch Processing: پردازش دسته‌ای برای چندین سند ایجاد شده همزمان
Validation: اعتبارسنجی داده‌های سند قبل از trigger
Retry Mechanism: مکانیزم retry برای triggerهای ناموفق

تنظیمات پیشنهادی جدید:

config_schema:
  document_type:
    type: "string"
    description: "نوع سند (اختیاری)"
    required: false
  min_amount:
    type: "number"
    description: "حداقل مبلغ سند"
    required: false
  max_amount:
    type: "number"
    description: "حداکثر مبلغ سند"
    required: false
  fiscal_year_filter:
    type: "integer"
    description: "فیلتر بر اساس سال مالی خاص"
    required: false
  user_id_filter:
    type: "integer"
    description: "فیلتر بر اساس کاربر ایجادکننده"
    required: false
  description_contains:
    type: "string"
    description: "فیلتر بر اساس کلمات کلیدی در شرح"
    required: false
  enabled:
    type: "boolean"
    description: "فعال/غیرفعال کردن trigger"
    default: true
  cooldown_seconds:
    type: "integer"
    description: "مدت زمان انتظار بین triggerهای متوالی (ثانیه)"
    default: 0
  timeout_seconds:
    type: "integer"
    description: "حداکثر زمان انتظار برای اجرای workflow (ثانیه)"
    default: 300

2. InvoiceCreatedTrigger (ایجاد فاکتور)

پیشنهادات بهبود عملکرد:

Async Processing: پردازش ناهمزمان برای فاکتورهای بزرگ
Invoice Status Filtering: فیلتر بر اساس وضعیت فاکتور (پیش‌نویس، تایید شده، لغو شده)
Payment Status Tracking: ردیابی وضعیت پرداخت
Tax Calculation: محاسبه خودکار مالیات و اضافه کردن به trigger data

تنظیمات پیشنهادی جدید:

config_schema:
  invoice_type:
    type: "string"
    description: "نوع فاکتور (sales/purchase)"
    required: false
  min_amount:
    type: "number"
    description: "حداقل مبلغ فاکتور"
    required: false
  max_amount:
    type: "number"
    description: "حداکثر مبلغ فاکتور"
    required: false
  status_filter:
    type: "array"
    description: "فیلتر بر اساس وضعیت فاکتور (draft/confirmed/cancelled)"
    items:
      type: "string"
    required: false
  person_type_filter:
    type: "string"
    description: "فیلتر بر اساس نوع شخص (customer/supplier)"
    required: false
  currency_id:
    type: "integer"
    description: "فیلتر بر اساس ارز"
    required: false
  include_tax_details:
    type: "boolean"
    description: "شامل جزئیات مالیات در trigger data"
    default: false
  include_payment_status:
    type: "boolean"
    description: "شامل وضعیت پرداخت در trigger data"
    default: false
  batch_mode:
    type: "boolean"
    description: "پردازش دسته‌ای برای فاکتورهای متعدد"
    default: false

3. ReceiptPaymentCreatedTrigger (ایجاد دریافت/پرداخت)

پیشنهادات بهبود عملکرد:

Payment Method Filtering: فیلتر بر اساس روش پرداخت
Account Filtering: فیلتر بر اساس حساب بانکی
Balance Tracking: ردیابی موجودی حساب بعد از تراکنش
Duplicate Detection: تشخیص تراکنش‌های تکراری

تنظیمات پیشنهادی جدید:

config_schema:
  type:
    type: "string"
    description: "نوع (receipt/payment)"
    required: false
  min_amount:
    type: "number"
    description: "حداقل مبلغ"
    required: false
  max_amount:
    type: "number"
    description: "حداکثر مبلغ"
    required: false
  payment_method_filter:
    type: "array"
    description: "فیلتر بر اساس روش پرداخت"
    items:
      type: "string"
    required: false
  account_id_filter:
    type: "integer"
    description: "فیلتر بر اساس حساب بانکی"
    required: false
  include_balance:
    type: "boolean"
    description: "شامل موجودی حساب در trigger data"
    default: false
  check_duplicate:
    type: "boolean"
    description: "بررسی تراکنش تکراری"
    default: false
  duplicate_window_hours:
    type: "integer"
    description: "بازه زمانی بررسی تکراری (ساعت)"
    default: 24

4. CheckDueDateTrigger (سررسید چک)

پیشنهادات بهبود عملکرد:

Time Zone Support: پشتیبانی از timezone برای تعیین دقیق سررسید
Multiple Reminders: ارسال چندین یادآوری در بازه‌های زمانی مختلف
Check Status Tracking: ردیابی وضعیت چک (وصول شده، برگشت خورده، و...)
Priority Levels: سطح‌بندی اولویت بر اساس مبلغ

تنظیمات پیشنهادی جدید:

config_schema:
  check_type:
    type: "string"
    description: "نوع چک (received/paid)"
    required: false
  days_before:
    type: "number"
    description: "تعداد روز قبل از سررسید"
    required: false
  days_after:
    type: "number"
    description: "تعداد روز بعد از سررسید"
    required: false
  reminder_schedule:
    type: "array"
    description: "زمان‌بندی یادآوری‌ها (روزهای قبل از سررسید)"
    items:
      type: "integer"
    required: false
  min_amount:
    type: "number"
    description: "حداقل مبلغ چک"
    required: false
  status_filter:
    type: "array"
    description: "فیلتر بر اساس وضعیت چک"
    items:
      type: "string"
    required: false
  timezone:
    type: "string"
    description: "Timezone برای محاسبه سررسید"
    default: "Asia/Tehran"
  include_grace_period:
    type: "boolean"
    description: "شامل دوره مهلت (grace period)"
    default: false
  grace_period_days:
    type: "integer"
    description: "تعداد روز مهلت"
    default: 0

5. InventoryLowTrigger (موجودی کم)

پیشنهادات بهبود عملکرد:

Multi-warehouse Support: پشتیبانی از چند انبار
Dynamic Thresholds: آستانه‌های پویا بر اساس تاریخچه فروش
Forecasting: پیش‌بینی زمان اتمام موجودی
Category-based Filtering: فیلتر بر اساس دسته‌بندی محصولات

تنظیمات پیشنهادی جدید:

config_schema:
  product_id:
    type: "integer"
    description: "شناسه محصول (اختیاری)"
    required: false
  warehouse_id:
    type: "integer"
    description: "شناسه انبار (اختیاری)"
    required: false
  threshold_type:
    type: "string"
    description: "نوع آستانه (fixed/percentage/dynamic)"
    enum: ["fixed", "percentage", "dynamic"]
    default: "fixed"
  threshold_value:
    type: "number"
    description: "مقدار آستانه"
    required: false
  threshold_percentage:
    type: "number"
    description: "درصد آستانه (برای threshold_type=percentage)"
    required: false
  category_id:
    type: "integer"
    description: "فیلتر بر اساس دسته‌بندی"
    required: false
  include_forecast:
    type: "boolean"
    description: "شامل پیش‌بینی زمان اتمام"
    default: false
  forecast_days:
    type: "integer"
    description: "تعداد روز برای پیش‌بینی"
    default: 30
  check_frequency:
    type: "string"
    description: "فرکانس بررسی (realtime/hourly/daily)"
    enum: ["realtime", "hourly", "daily"]
    default: "realtime"

6. PersonCreatedTrigger (ایجاد شخص)

پیشنهادات بهبود عملکرد:

Person Type Validation: اعتبارسنجی نوع شخص
Duplicate Person Detection: تشخیص شخص تکراری
Data Enrichment: غنی‌سازی داده‌ها با اطلاعات اضافی
Welcome Message: ارسال پیام خوش‌آمدگویی

تنظیمات پیشنهادی جدید:

config_schema:
  person_type:
    type: "string"
    description: "نوع شخص (customer/supplier/etc)"
    required: false
  person_types:
    type: "array"
    description: "چند نوع شخص"
    items:
      type: "string"
    required: false
  check_duplicate:
    type: "boolean"
    description: "بررسی شخص تکراری"
    default: false
  duplicate_fields:
    type: "array"
    description: "فیلدهای بررسی تکراری (mobile/email/national_id)"
    items:
      type: "string"
    required: false
  include_credit_limit:
    type: "boolean"
    description: "شامل اعتبار در trigger data"
    default: false
  auto_assign_group:
    type: "boolean"
    description: "اختصاص خودکار به گروه"
    default: false
  send_welcome_message:
    type: "boolean"
    description: "ارسال پیام خوش‌آمدگویی"
    default: false

7. ScheduledTrigger (زمان‌بندی شده)

پیشنهادات بهبود عملکرد:

Time Zone Support: پشتیبانی کامل از timezone
Holiday Calendar: تقویم تعطیلات
Business Hours Only: اجرا فقط در ساعات کاری
Retry on Failure: تلاش مجدد در صورت خطا

تنظیمات پیشنهادی جدید:

config_schema:
  schedule:
    type: "string"
    description: "زمان‌بندی cron"
    required: true
  timezone:
    type: "string"
    description: "Timezone"
    default: "Asia/Tehran"
  business_hours_only:
    type: "boolean"
    description: "اجرا فقط در ساعات کاری"
    default: false
  business_hours_start:
    type: "string"
    description: "شروع ساعت کاری (HH:mm)"
    default: "09:00"
  business_hours_end:
    type: "string"
    description: "پایان ساعت کاری (HH:mm)"
    default: "17:00"
  exclude_holidays:
    type: "boolean"
    description: "حذف تعطیلات"
    default: false
  holiday_calendar_id:
    type: "integer"
    description: "شناسه تقویم تعطیلات"
    required: false
  max_execution_time:
    type: "integer"
    description: "حداکثر زمان اجرا (ثانیه)"
    default: 300
  retry_on_failure:
    type: "boolean"
    description: "تلاش مجدد در صورت خطا"
    default: false
  retry_attempts:
    type: "integer"
    description: "تعداد تلاش‌های مجدد"
    default: 3
  retry_delay_seconds:
    type: "integer"
    description: "تاخیر بین تلاش‌ها (ثانیه)"
    default: 60

8. WebhookTrigger (Webhook)

پیشنهادات بهبود عملکرد:

Authentication: مکانیزم‌های احراز هویت (API Key, OAuth, Signature)
Rate Limiting: محدود کردن تعداد درخواست
Payload Validation: اعتبارسنجی payload
Response Customization: سفارشی‌سازی پاسخ

تنظیمات پیشنهادی جدید:

config_schema:
  webhook_path:
    type: "string"
    description: "مسیر webhook"
    required: false
  method:
    type: "string"
    description: "روش HTTP"
    default: "POST"
    required: false
  authentication_type:
    type: "string"
    description: "نوع احراز هویت (none/api_key/bearer/signature)"
    enum: ["none", "api_key", "bearer", "signature"]
    default: "none"
  api_key:
    type: "string"
    description: "کلید API"
    required: false
  api_key_header:
    type: "string"
    description: "نام header برای API key"
    default: "X-API-Key"
  bearer_token:
    type: "string"
    description: "توکن Bearer"
    required: false
  signature_secret:
    type: "string"
    description: "رمز امضا"
    required: false
  signature_header:
    type: "string"
    description: "نام header برای امضا"
    default: "X-Signature"
  rate_limit:
    type: "integer"
    description: "حداکثر درخواست در دقیقه"
    required: false
  validate_payload:
    type: "boolean"
    description: "اعتبارسنجی payload"
    default: false
  payload_schema:
    type: "object"
    description: "Schema برای اعتبارسنجی (JSON Schema)"
    required: false
  custom_response:
    type: "boolean"
    description: "استفاده از پاسخ سفارشی"
    default: false
  response_status_code:
    type: "integer"
    description: "کد وضعیت پاسخ"
    default: 200
  response_body:
    type: "string"
    description: "بدنه پاسخ"
    required: false
  timeout_seconds:
    type: "integer"
    description: "Timeout برای پردازش (ثانیه)"
    default: 30

🔷 Actions

1. SendEmailAction (ارسال ایمیل)

پیشنهادات بهبود عملکرد:

Template Engine: موتور قالب برای ایمیل‌ها
Attachment Support: پشتیبانی از پیوست
Priority Levels: سطح اولویت ایمیل
Delivery Tracking: ردیابی تحویل
Retry Mechanism: تلاش مجدد در صورت خطا

تنظیمات پیشنهادی جدید:

config_schema:
  to:
    type: "string"
    description: "آدرس ایمیل گیرنده"
    required: true
  cc:
    type: "array"
    description: "CC"
    items:
      type: "string"
    required: false
  bcc:
    type: "array"
    description: "BCC"
    items:
      type: "string"
    required: false
  subject:
    type: "string"
    description: "موضوع"
    required: true
  body:
    type: "string"
    description: "متن ایمیل"
    required: true
  html_body:
    type: "string"
    description: "متن HTML"
    required: false
  template_id:
    type: "integer"
    description: "شناسه قالب ایمیل"
    required: false
  template_variables:
    type: "object"
    description: "متغیرهای قالب"
    required: false
  attachments:
    type: "array"
    description: "پیوست‌ها"
    items:
      type: "object"
      properties:
        filename:
          type: "string"
        content:
          type: "string"
        content_type:
          type: "string"
    required: false
  priority:
    type: "string"
    description: "اولویت (low/normal/high)"
    enum: ["low", "normal", "high"]
    default: "normal"
  send_at:
    type: "string"
    description: "ارسال در زمان مشخص (ISO format)"
    required: false
  track_opens:
    type: "boolean"
    description: "ردیابی باز شدن ایمیل"
    default: false
  track_clicks:
    type: "boolean"
    description: "ردیابی کلیک‌ها"
    default: false
  retry_on_failure:
    type: "boolean"
    description: "تلاش مجدد در صورت خطا"
    default: true
  retry_attempts:
    type: "integer"
    description: "تعداد تلاش‌های مجدد"
    default: 3
  retry_delay_seconds:
    type: "integer"
    description: "تاخیر بین تلاش‌ها"
    default: 60

2. SendTelegramAction (ارسال تلگرام)

پیشنهادات بهبود عملکرد:

Rich Media Support: پشتیبانی از تصویر، ویدیو، فایل
Keyboard Buttons: دکمه‌های کیبورد
Inline Buttons: دکمه‌های inline
Parse Mode: حالت‌های مختلف پارس (HTML, Markdown)
Message Scheduling: زمان‌بندی پیام

تنظیمات پیشنهادی جدید:

config_schema:
  user_id:
    type: "integer"
    description: "شناسه کاربر"
    required: false
  chat_id:
    type: "string"
    description: "شناسه چت (جایگزین user_id)"
    required: false
  message:
    type: "string"
    description: "متن پیام"
    required: true
  parse_mode:
    type: "string"
    description: "حالت پارس (HTML/Markdown/None)"
    enum: ["HTML", "Markdown", "None"]
    default: "None"
  disable_web_page_preview:
    type: "boolean"
    description: "غیرفعال کردن پیش‌نمایش لینک"
    default: false
  disable_notification:
    type: "boolean"
    description: "ارسال بی‌صدا"
    default: false
  photo:
    type: "string"
    description: "URL یا path تصویر"
    required: false
  document:
    type: "string"
    description: "URL یا path فایل"
    required: false
  keyboard:
    type: "array"
    description: "کیبورد (دکمه‌ها)"
    items:
      type: "object"
    required: false
  inline_keyboard:
    type: "array"
    description: "کیبورد inline"
    items:
      type: "object"
    required: false
  reply_to_message_id:
    type: "integer"
    description: "پاسخ به پیام خاص"
    required: false
  send_at:
    type: "string"
    description: "ارسال در زمان مشخص"
    required: false

3. CreateNotificationAction (ایجاد Notification)

پیشنهادات بهبود عملکرد:

Multiple Channels: ارسال به چند کانال (in-app, email, SMS, Push)
Priority Levels: سطح اولویت
Expiration: تاریخ انقضا
Action Buttons: دکمه‌های عملیاتی
Rich Content: محتوای غنی (HTML, images)

تنظیمات پیشنهادی جدید:

config_schema:
  user_id:
    type: "integer"
    description: "شناسه کاربر"
    required: false
  event_key:
    type: "string"
    description: "کلید رویداد"
    required: true
  title:
    type: "string"
    description: "عنوان"
    required: true
  message:
    type: "string"
    description: "پیام"
    required: true
  channels:
    type: "array"
    description: "کانال‌های ارسال"
    items:
      type: "string"
      enum: ["inapp", "email", "sms", "push"]
    default: ["inapp"]
  priority:
    type: "string"
    description: "اولویت (low/normal/high/urgent)"
    enum: ["low", "normal", "high", "urgent"]
    default: "normal"
  category:
    type: "string"
    description: "دسته‌بندی"
    required: false
  icon:
    type: "string"
    description: "آیکون"
    required: false
  image_url:
    type: "string"
    description: "URL تصویر"
    required: false
  action_buttons:
    type: "array"
    description: "دکمه‌های عملیاتی"
    items:
      type: "object"
      properties:
        label:
          type: "string"
        action:
          type: "string"
        url:
          type: "string"
    required: false
  expires_at:
    type: "string"
    description: "تاریخ انقضا (ISO format)"
    required: false
  read_after_action:
    type: "boolean"
    description: "خوانده شده تلقی کردن بعد از کلیک روی دکمه"
    default: true

4. CreateDocumentAction (ایجاد سند)

پیشنهادات بهبود عملکرد:

Template Support: پشتیبانی از قالب‌های سند
Auto Numbering: شماره‌گذاری خودکار
Validation: اعتبارسنجی قبل از ایجاد
Draft Mode: حالت پیش‌نویس
Approval Workflow: گردش کار تایید

تنظیمات پیشنهادی جدید:

config_schema:
  document_type:
    type: "string"
    description: "نوع سند"
    required: true
  date:
    type: "string"
    description: "تاریخ سند"
    required: true
  description:
    type: "string"
    description: "شرح"
    required: false
  lines:
    type: "array"
    description: "خطوط سند"
    required: true
  template_id:
    type: "integer"
    description: "شناسه قالب"
    required: false
  auto_numbering:
    type: "boolean"
    description: "شماره‌گذاری خودکار"
    default: true
  numbering_sequence:
    type: "string"
    description: "سری شماره‌گذاری"
    required: false
  fiscal_year_id:
    type: "integer"
    description: "سال مالی (در صورت عدم مشخص، سال جاری استفاده می‌شود)"
    required: false
  status:
    type: "string"
    description: "وضعیت (draft/confirmed)"
    enum: ["draft", "confirmed"]
    default: "draft"
  require_approval:
    type: "boolean"
    description: "نیاز به تایید"
    default: false
  approver_user_id:
    type: "integer"
    description: "شناسه کاربر تاییدکننده"
    required: false
  validate_before_create:
    type: "boolean"
    description: "اعتبارسنجی قبل از ایجاد"
    default: true
  on_error:
    type: "string"
    description: "رفتار در صورت خطا (fail/skip/log)"
    enum: ["fail", "skip", "log"]
    default: "fail"

5. CreateInvoiceAction (ایجاد فاکتور)

پیشنهادات بهبود عملکرد:

Discount Support: پشتیبانی از تخفیف
Tax Calculation: محاسبه خودکار مالیات
Payment Terms: شرایط پرداخت
Template System: سیستم قالب
Auto Posting: ثبت خودکار در دفاتر

تنظیمات پیشنهادی جدید:

config_schema:
  invoice_type:
    type: "string"
    description: "نوع فاکتور"
    required: true
  person_id:
    type: "integer"
    description: "شناسه شخص"
    required: true
  items:
    type: "array"
    description: "آیتم‌های فاکتور"
    required: true
  currency_id:
    type: "integer"
    description: "شناسه ارز"
    required: false
  date:
    type: "string"
    description: "تاریخ فاکتور (ISO format)"
    required: false
  due_date:
    type: "string"
    description: "تاریخ سررسید"
    required: false
  payment_terms:
    type: "string"
    description: "شرایط پرداخت"
    required: false
  discount_type:
    type: "string"
    description: "نوع تخفیف (percentage/amount)"
    enum: ["percentage", "amount"]
    required: false
  discount_value:
    type: "number"
    description: "مقدار تخفیف"
    required: false
  auto_calculate_tax:
    type: "boolean"
    description: "محاسبه خودکار مالیات"
    default: true
  tax_rate:
    type: "number"
    description: "نرخ مالیات (در صورت عدم خودکار)"
    required: false
  template_id:
    type: "integer"
    description: "شناسه قالب"
    required: false
  status:
    type: "string"
    description: "وضعیت (draft/confirmed)"
    enum: ["draft", "confirmed"]
    default: "draft"
  auto_post:
    type: "boolean"
    description: "ثبت خودکار در دفاتر"
    default: false
  reference_number:
    type: "string"
    description: "شماره مرجع"
    required: false
  notes:
    type: "string"
    description: "یادداشت‌ها"
    required: false

6. UpdateInventoryAction (به‌روزرسانی موجودی)

پیشنهادات بهبود عملکرد:

Batch Updates: به‌روزرسانی دسته‌ای
Transaction Logging: ثبت لاگ تراکنش
Cost Calculation: محاسبه هزینه
Lot/Serial Tracking: ردیابی سریال/لوت
Reservation Support: پشتیبانی از رزرو

تنظیمات پیشنهادی جدید:

config_schema:
  product_id:
    type: "integer"
    description: "شناسه محصول"
    required: true
  warehouse_id:
    type: "integer"
    description: "شناسه انبار"
    required: true
  quantity:
    type: "number"
    description: "تغییر مقدار"
    required: true
  adjustment_type:
    type: "string"
    description: "نوع تنظیم (increase/decrease/set)"
    enum: ["increase", "decrease", "set"]
    default: "increase"
  reason:
    type: "string"
    description: "دلیل تنظیم"
    required: false
  reference_document_id:
    type: "integer"
    description: "شناسه سند مرجع"
    required: false
  reference_document_type:
    type: "string"
    description: "نوع سند مرجع"
    required: false
  cost_per_unit:
    type: "number"
    description: "هزینه هر واحد"
    required: false
  lot_number:
    type: "string"
    description: "شماره لوت"
    required: false
  serial_numbers:
    type: "array"
    description: "شماره‌های سریال"
    items:
      type: "string"
    required: false
  reservation_id:
    type: "integer"
    description: "شناسه رزرو (برای آزاد کردن رزرو)"
    required: false
  validate_stock:
    type: "boolean"
    description: "اعتبارسنجی موجودی قبل از کاهش"
    default: true
  allow_negative:
    type: "boolean"
    description: "اجازه موجودی منفی"
    default: false
  auto_post:
    type: "boolean"
    description: "ثبت خودکار"
    default: true

7. SetVariableAction (تنظیم متغیر)

پیشنهادات بهبود عملکرد:

Type Casting: تبدیل نوع خودکار
Computed Values: مقادیر محاسبه‌شده
Scoping: محدوده متغیر (workflow/global)
Encryption: رمزنگاری برای داده‌های حساس

تنظیمات پیشنهادی جدید:

config_schema:
  variable_name:
    type: "string"
    description: "نام متغیر"
    required: true
  value:
    type: "any"
    description: "مقدار متغیر"
    required: true
  value_type:
    type: "string"
    description: "نوع مقدار (auto/string/number/boolean/object/array)"
    enum: ["auto", "string", "number", "boolean", "object", "array"]
    default: "auto"
  scope:
    type: "string"
    description: "محدوده (workflow/global)"
    enum: ["workflow", "global"]
    default: "workflow"
  encrypt:
    type: "boolean"
    description: "رمزنگاری مقدار"
    default: false
  expiration_seconds:
    type: "integer"
    description: "زمان انقضا (ثانیه)"
    required: false
  computed:
    type: "boolean"
    description: "مقدار محاسبه‌شده"
    default: false
  expression:
    type: "string"
    description: "عبارت محاسبه (برای computed=true)"
    required: false
  default_value:
    type: "any"
    description: "مقدار پیش‌فرض در صورت خطا"
    required: false

8. LogAction (ثبت لاگ)

پیشنهادات بهبود عملکرد:

Structured Logging: لاگ ساختاریافته (JSON)
Log Aggregation: تجمیع لاگ‌ها
Log Rotation: چرخش لاگ‌ها
Alert Integration: یکپارچه‌سازی با سیستم هشدار

تنظیمات پیشنهادی جدید:

config_schema:
  level:
    type: "string"
    description: "سطح لاگ"
    enum: ["debug", "info", "warning", "error", "critical"]
    default: "info"
  message:
    type: "string"
    description: "پیام لاگ"
    required: true
  data:
    type: "object"
    description: "داده‌های اضافی"
    required: false
  structured:
    type: "boolean"
    description: "لاگ ساختاریافته (JSON)"
    default: false
  include_context:
    type: "boolean"
    description: "شامل context workflow"
    default: true
  include_node_results:
    type: "boolean"
    description: "شامل نتایج nodeها"
    default: false
  tags:
    type: "array"
    description: "برچسب‌ها"
    items:
      type: "string"
    required: false
  send_alert:
    type: "boolean"
    description: "ارسال هشدار برای سطح error/critical"
    default: false
  alert_channels:
    type: "array"
    description: "کانال‌های هشدار"
    items:
      type: "string"
    required: false
  retention_days:
    type: "integer"
    description: "مدت نگهداری لاگ (روز)"
    default: 30

9. HttpRequestAction (ارسال HTTP Request)

پیشنهادات بهبود عملکرد:

Advanced Auth: احراز هویت پیشرفته (OAuth, JWT)
Request/Response Transformation: تبدیل درخواست/پاسخ
Circuit Breaker: قطع کننده مدار برای جلوگیری از overload
Retry with Exponential Backoff: تلاش مجدد با تاخیر نمایی
Response Caching: کش کردن پاسخ‌ها

تنظیمات پیشنهادی جدید:

config_schema:
  url:
    type: "string"
    description: "URL مقصد"
    required: true
  method:
    type: "string"
    description: "روش HTTP"
    enum: ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]
    default: "POST"
  headers:
    type: "object"
    description: "هدرهای HTTP"
    required: false
  query_params:
    type: "object"
    description: "پارامترهای query string"
    required: false
  body:
    type: "any"
    description: "بدنه درخواست"
    required: false
  body_type:
    type: "string"
    description: "نوع بدنه (json/form/raw)"
    enum: ["json", "form", "raw"]
    default: "json"
  auth_type:
    type: "string"
    description: "نوع احراز هویت (none/basic/bearer/oauth/jwt)"
    enum: ["none", "basic", "bearer", "oauth", "jwt"]
    default: "none"
  auth_config:
    type: "object"
    description: "تنظیمات احراز هویت"
    required: false
  timeout_seconds:
    type: "integer"
    description: "Timeout (ثانیه)"
    default: 30
  retry_on_failure:
    type: "boolean"
    description: "تلاش مجدد در صورت خطا"
    default: true
  retry_attempts:
    type: "integer"
    description: "تعداد تلاش‌های مجدد"
    default: 3
  retry_delay_seconds:
    type: "integer"
    description: "تاخیر پایه (ثانیه)"
    default: 1
  exponential_backoff:
    type: "boolean"
    description: "استفاده از تاخیر نمایی"
    default: true
  retryable_status_codes:
    type: "array"
    description: "کدهای وضعیت قابل retry"
    items:
      type: "integer"
    default: [500, 502, 503, 504]
  circuit_breaker_enabled:
    type: "boolean"
    description: "فعال کردن circuit breaker"
    default: false
  circuit_breaker_threshold:
    type: "integer"
    description: "آستانه خطا برای باز کردن مدار"
    default: 5
  cache_response:
    type: "boolean"
    description: "کش کردن پاسخ"
    default: false
  cache_ttl_seconds:
    type: "integer"
    description: "زمان زندگی کش (ثانیه)"
    default: 300
  cache_key:
    type: "string"
    description: "کلید کش (در صورت عدم مشخص، از URL و params استفاده می‌شود)"
    required: false
  transform_request:
    type: "boolean"
    description: "تبدیل درخواست"
    default: false
  request_script:
    type: "string"
    description: "اسکریپت تبدیل درخواست (JavaScript/Python)"
    required: false
  transform_response:
    type: "boolean"
    description: "تبدیل پاسخ"
    default: false
  response_script:
    type: "string"
    description: "اسکریپت تبدیل پاسخ"
    required: false
  validate_response:
    type: "boolean"
    description: "اعتبارسنجی پاسخ"
    default: false
  response_schema:
    type: "object"
    description: "Schema برای اعتبارسنجی (JSON Schema)"
    required: false

🔷 Conditions

پیشنهادات بهبود Condition Node

پیشنهادات بهبود عملکرد:

Complex Conditions: پشتیبانی از شرط‌های پیچیده (AND, OR, NOT)
Multiple Comparisons: چندین مقایسه همزمان
Array Operations: عملیات روی آرایه (contains, in, not in)
String Operations: عملیات رشته (starts with, ends with, contains, regex)
Date/Time Comparisons: مقایسه تاریخ/زمان
Nested Conditions: شرط‌های تو در تو

تنظیمات پیشنهادی جدید:

config_schema:
  condition_type:
    type: "string"
    description: "نوع شرط (simple/complex/expression)"
    enum: ["simple", "complex", "expression"]
    default: "simple"
  # برای condition_type=simple
  left_value:
    type: "any"
    description: "مقدار چپ"
    required: false
  operator:
    type: "string"
    description: "عملگر"
    enum: ["==", "!=", ">", "<", ">=", "<=", "contains", "not_contains", "starts_with", "ends_with", "in", "not_in", "regex", "is_null", "is_not_null"]
    default: "=="
  right_value:
    type: "any"
    description: "مقدار راست"
    required: false
  # برای condition_type=complex
  logical_operator:
    type: "string"
    description: "عملگر منطقی (AND/OR)"
    enum: ["AND", "OR"]
    default: "AND"
  conditions:
    type: "array"
    description: "لیست شرط‌ها"
    items:
      type: "object"
    required: false
  # برای condition_type=expression
  expression:
    type: "string"
    description: "عبارت شرط (JavaScript/Python)"
    required: false
  case_sensitive:
    type: "boolean"
    description: "حساس به حروف بزرگ/کوچک"
    default: true
  date_format:
    type: "string"
    description: "فرمت تاریخ برای مقایسه"
    default: "ISO"
  timezone:
    type: "string"
    description: "Timezone برای مقایسه تاریخ/زمان"
    default: "Asia/Tehran"
  on_error:
    type: "string"
    description: "رفتار در صورت خطا (fail/false/true)"
    enum: ["fail", "false", "true"]
    default: "fail"

🔷 Loops

پیشنهادات بهبود Loop Node

توجه: حلقه‌ها در حال حاضر پیاده‌سازی نشده‌اند. پیشنهادات برای پیاده‌سازی:

پیشنهادات بهبود عملکرد:

For Each Loop: حلقه روی آرایه/لیست
For Range Loop: حلقه روی بازه عددی
While Loop: حلقه شرطی
Break/Continue: کنترل جریان
Parallel Execution: اجرای موازی
Batch Processing: پردازش دسته‌ای

تنظیمات پیشنهادی جدید:

config_schema:
  loop_type:
    type: "string"
    description: "نوع حلقه (for_each/for_range/while)"
    enum: ["for_each", "for_range", "while"]
    required: true
  # برای loop_type=for_each
  items_source:
    type: "string"
    description: "منبع آیتم‌ها (reference به node یا variable)"
    required: false
  item_variable:
    type: "string"
    description: "نام متغیر برای هر آیتم"
    default: "item"
  index_variable:
    type: "string"
    description: "نام متغیر برای ایندکس"
    default: "index"
  # برای loop_type=for_range
  start:
    type: "integer"
    description: "شروع"
    required: false
  end:
    type: "integer"
    description: "پایان"
    required: false
  step:
    type: "integer"
    description: "گام"
    default: 1
  # برای loop_type=while
  condition:
    type: "object"
    description: "شرط تداوم حلقه"
    required: false
  max_iterations:
    type: "integer"
    description: "حداکثر تعداد تکرار (برای جلوگیری از infinite loop)"
    default: 1000
  parallel_execution:
    type: "boolean"
    description: "اجرای موازی"
    default: false
  max_parallel:
    type: "integer"
    description: "حداکثر تعداد اجرای موازی"
    default: 5
  batch_size:
    type: "integer"
    description: "اندازه دسته برای پردازش دسته‌ای"
    required: false
  break_on_error:
    type: "boolean"
    description: "توقف در صورت خطا"
    default: false
  continue_on_error:
    type: "boolean"
    description: "ادامه در صورت خطا"
    default: false

🔷 بهبودهای کلی موتور Workflow

1. Performance Optimizations

پیشنهادات:

Connection Pooling: Pool اتصالات دیتابیس
Async Execution: اجرای ناهمزمان برای actionهای مستقل
Caching: کش کردن نتایج nodeها برای استفاده مجدد
Lazy Loading: بارگذاری تنبل برای nodeهای بزرگ
Batch Processing: پردازش دسته‌ای workflowهای متعدد

پیاده‌سازی:

# مثال: Caching برای node results
class WorkflowEngine:
    def __init__(self, ...):
        self.result_cache = {}
        self.cache_ttl = 300  # 5 minutes
    
    def _execute_node(self, node, context, node_results):
        cache_key = self._get_cache_key(node, context)
        if cache_key in self.result_cache:
            cached_result, timestamp = self.result_cache[cache_key]
            if time.time() - timestamp < self.cache_ttl:
                return cached_result
        # ... execute node ...
        self.result_cache[cache_key] = (result, time.time())
        return result

2. Error Handling & Resilience

پیشنهادات:

Retry Policies: سیاست‌های retry قابل تنظیم
Circuit Breaker: قطع کننده مدار برای جلوگیری از overload
Fallback Actions: actionهای جایگزین در صورت خطا
Error Recovery: بازیابی از خطا
Dead Letter Queue: صف برای workflowهای ناموفق

تنظیمات پیشنهادی:

workflow_config:
  error_handling:
    strategy: "fail_fast"  # fail_fast, continue, retry
    retry_policy:
      max_attempts: 3
      initial_delay: 1
      max_delay: 60
      exponential_backoff: true
    circuit_breaker:
      enabled: true
      failure_threshold: 5
      timeout_seconds: 60
    fallback_action:
      enabled: false
      action_type: "log"
      action_config: {}
    dead_letter_queue:
      enabled: true
      max_retries: 3

3. Monitoring & Observability

پیشنهادات:

Metrics Collection: جمع‌آوری معیارها
Performance Tracking: ردیابی عملکرد
Slow Query Detection: تشخیص queryهای کند
Resource Usage Monitoring: نظارت بر استفاده از منابع
Alerting: سیستم هشدار

معیارهای پیشنهادی:

زمان اجرای هر node
تعداد اجراهای موفق/ناموفق
میزان خطا (error rate)
استفاده از حافظه
استفاده از CPU
تعداد workflowهای در حال اجرا

4. Security Enhancements

پیشنهادات:

Input Validation: اعتبارسنجی ورودی‌ها
Output Sanitization: پاکسازی خروجی‌ها
Access Control: کنترل دسترسی بر اساس نقش
Audit Logging: ثبت لاگ audit
Encryption: رمزنگاری داده‌های حساس
Rate Limiting: محدود کردن نرخ

5. Developer Experience

پیشنهادات:

Template Library: کتابخانه قالب‌های workflow
Workflow Testing: تست workflow قبل از اجرا
Dry Run Mode: حالت اجرای آزمایشی
Visual Debugging: دیباگ بصری
Step-by-step Execution: اجرای گام به گام
Variable Inspector: بازرسی متغیرها

6. Scalability

پیشنهادات:

Horizontal Scaling: مقیاس‌پذیری افقی
Queue System: سیستم صف برای workflowهای زیاد
Distributed Execution: اجرای توزیع‌شده
Load Balancing: توزیع بار
Resource Isolation: جداسازی منابع

📊 خلاصه اولویت‌ها

اولویت بالا (Quick Wins):

اضافه کردن retry mechanism به همه actionها
اضافه کردن timeout به همه operationها
بهبود error handling
اضافه کردن logging بهتر

اولویت متوسط:

اضافه کردن فیلترهای بیشتر به triggerها
اضافه کردن template system
بهبود condition node با شرط‌های پیچیده
اضافه کردن monitoring

اولویت پایین (Long-term):

پیاده‌سازی loop node
Distributed execution
Advanced caching
Circuit breaker

📝 یادداشت‌های پیاده‌سازی

نکات مهم:

همه تنظیمات جدید باید backward compatible باشند
باید default values مناسب برای همه تنظیمات تعریف شود
باید validation برای همه تنظیمات اضافه شود
باید documentation کامل برای هر تنظیمات نوشته شود
باید unit tests برای همه بهبودها نوشته شود

مراحل پیاده‌سازی:

فاز 1: بهبود triggerها (2-3 هفته)
فاز 2: بهبود actionها (3-4 هفته)
فاز 3: بهبود condition و loop (2-3 هفته)
فاز 4: بهبودهای کلی موتور (2-3 هفته)

این سند به صورت مداوم به‌روزرسانی خواهد شد.

41 KiB Executable file Raw Permalink Blame History Unescape Escape

پیشنهادات بهبود سیستم اتوماسیون و Workflow

📋 فهرست محتوا

🔷 Triggers

1. DocumentCreatedTrigger (ایجاد سند)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

2. InvoiceCreatedTrigger (ایجاد فاکتور)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

3. ReceiptPaymentCreatedTrigger (ایجاد دریافت/پرداخت)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

4. CheckDueDateTrigger (سررسید چک)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

5. InventoryLowTrigger (موجودی کم)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

6. PersonCreatedTrigger (ایجاد شخص)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

7. ScheduledTrigger (زمان‌بندی شده)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

8. WebhookTrigger (Webhook)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

🔷 Actions

1. SendEmailAction (ارسال ایمیل)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

2. SendTelegramAction (ارسال تلگرام)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

3. CreateNotificationAction (ایجاد Notification)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

4. CreateDocumentAction (ایجاد سند)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

5. CreateInvoiceAction (ایجاد فاکتور)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

6. UpdateInventoryAction (به‌روزرسانی موجودی)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

7. SetVariableAction (تنظیم متغیر)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

8. LogAction (ثبت لاگ)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

9. HttpRequestAction (ارسال HTTP Request)

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

🔷 Conditions

پیشنهادات بهبود Condition Node

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

🔷 Loops

پیشنهادات بهبود Loop Node

پیشنهادات بهبود عملکرد:

تنظیمات پیشنهادی جدید:

🔷 بهبودهای کلی موتور Workflow

1. Performance Optimizations

پیشنهادات:

پیاده‌سازی:

2. Error Handling & Resilience

پیشنهادات:

تنظیمات پیشنهادی:

3. Monitoring & Observability

پیشنهادات:

معیارهای پیشنهادی:

4. Security Enhancements

پیشنهادات:

5. Developer Experience

پیشنهادات:

6. Scalability

پیشنهادات:

41 KiB

Executable file

Raw Permalink Blame History