تبدیل داده‌های سازمانی ایستا به موتورهای تصمیم: پیوند جریان‌های کاری ERP با کوپایلوت‌های هوش مصنوعی زمینه‌آگاه

┌─────────────────────────────────────────────────────────────────────────────┐
│                         لایه رابط کاربری                                    │
│              (ویجت چت، ورودی زبان طبیعی)                                    │
├─────────────────────────────────────────────────────────────────────────────┤
│                         لایه Intent و مسیریابی                              │
│         (طبقه‌بندی پرس‌وجو: فقط-خواندن در برابر اقدام، ساده در برابر پیچیده)│
├─────────────────────────────────────────────────────────────────────────────┤
│                         لایه زمینه اسکیما                                   │
│         (بازیابی جدول/ستون‌های مرتبط — نه اسکیمای کامل)                     │
├─────────────────────────────────────────────────────────────────────────────┤
│                         لایه تولید LLM                                      │
│              (تولید SQL/API از زمینه + سؤال)                                │
├─────────────────────────────────────────────────────────────────────────────┤
│                         لایه اعتبارسنجی ایمنی                               │
│    (SQL Guard: فقط-SELECT، بررسی اسکیما، تزریق LIMIT، Timeout)             │
├─────────────────────────────────────────────────────────────────────────────┤
│                         لایه اجرای مجوز                                     │
│              (نقش کاربر → جدول‌ها، سطرها، فیلدهای مجاز)                     │
├─────────────────────────────────────────────────────────────────────────────┤
│                         Sandbox اجرا                                        │
│              (اتصال فقط-خواندن، محدودیت سطر، Timeout پرس‌وجو)               │
├─────────────────────────────────────────────────────────────────────────────┤
│                         حسابرسی و رصدپذیری                                  │
│         (هر پرس‌وجو، هر نتیجه، هر کاربر — ثبت‌شده، قابل ردیابی)             │
└─────────────────────────────────────────────────────────────────────────────┘

مجاز:      SELECT ... FROM ...
مسدود:     INSERT، UPDATE، DELETE، DROP، ALTER، CREATE، TRUNCATE
مسدود:     GRANT، REVOKE، EXEC، CALL
مسدود:     دستورات چندگانه (تقسیم‌شده با Semikolon)

import sqlglot

def validate_query(sql: str) -> tuple[bool, str]:
    """اعتبارسنجی SQL به عنوان یک دستور SELECT واحد."""
    try:
        parsed = sqlglot.parse_one(sql)
    except Exception as e:
        return False, f"خطای پارس SQL: {e}"
    
    # بررسی نوع دستور
    if not isinstance(parsed, sqlglot.exp.Select):
        return False, f"فقط دستورات SELECT مجاز هستند. دریافت‌شده: {type(parsed).__name__}"
    
    # بررسی کلیدواژه‌های ممنوع در SQL خام
    forbidden = ['INSERT', 'UPDATE', 'DELETE', 'DROP', 'ALTER', 
                 'CREATE', 'TRUNCATE', 'GRANT', 'REVOKE']
    upper_sql = sql.upper()
    for kw in forbidden:
        if kw in upper_sql:
            return False, f"کلیدواژه ممنوع تشخیص داده شد: {kw}"
    
    # اطمینان از وجود LIMIT (تزریق در صورت عدم وجود)
    if not parsed.args.get('limit'):
        parsed = parsed.limit(1000)  # محدودیت ایمنی پیش‌فرض
    
    return True, parsed.sql()

-- کاربر می‌پرسد: "همه فاکتورها را نشانم بده"
-- LLM تولید می‌کند: SELECT * FROM invoices
-- Guard تبدیل می‌کند: SELECT * FROM invoices LIMIT 1000

سؤال کاربر: "سطح موجودی فعلی برای SKU ZX-447 چقدر است؟"

گام ۱: بازیابی اسکیمای مرتبط
  → جدول‌ها: inventory، products، warehouses
  → ستون‌ها: sku، quantity، warehouse_id، reorder_level

گام ۲: ساخت زمینه برای LLM
  → "جدول‌های موجود: inventory(sku, quantity, warehouse_id)، 
     products(sku, name, category)، ..."

گام ۳: LLM SQL با نام‌های صحیح جدول/ستون تولید می‌کند

# knowledge.yaml
synonyms:
  "سطح موجودی": "inventory.quantity"
  "نقطه سفارش مجدد": "inventory.reorder_level"
  "SKU": "products.sku"

example_queries:
  - question: "موجودی SKU X چقدر است؟"
    sql: "SELECT quantity FROM inventory WHERE sku = 'X'"

کاربر A (مدیر فروش): می‌تواند همه داده‌های مشتری را ببیند
کاربر B (نماینده فروش): فقط می‌تواند مشتریان اختصاص‌یافته خود را ببیند
کاربر C (مالی): می‌تواند همه داده‌های مالی را ببیند، بدون PII مشتری

کوپایلوت ساده: همان پرس‌وجو را برای همه کاربران اجرا می‌کند
→ نشت داده

-- کاربر می‌پرسد: "همه سفارش‌ها را نشانم بده"
-- LLM تولید می‌کند: SELECT * FROM orders
-- لایه مجوز بر اساس نقش کاربر بازنویسی می‌کند:

-- نماینده فروش (user_id=42):
SELECT * FROM orders WHERE sales_rep_id = 42

-- مدیر منطقه‌ای (region='EMEA'):
SELECT * FROM orders WHERE region = 'EMEA'

-- ادمین:
SELECT * FROM orders

ستون‌های مسدود (به ازای پیکربندی):
  - password، api_key، token
  - ssn، tax_id، bank_account
  - salary (مگر اینکه نقش HR باشد)

import hmac
import hashlib

def sign_audit_record(record: dict, secret: bytes) -> str:
    """تولید امضای HMAC برای مقاومت حسابرسی به دستکاری."""
    canonical = json.dumps(record, sort_keys=True)
    return hmac.new(secret, canonical.encode(), hashlib.sha256).hexdigest()

کاربر: "پیشنهادات RFQ 000012 را ارزیابی کن و یک تأمین‌کننده توصیه کن."

این نیازمند:
  ۱. خواندن داده RFQ (بازیابی)
  ۲. خواندن داده پیشنهاد تأمین‌کننده (بازیابی)
  ۳. خواندن معیارهای ارزیابی (بازیابی)
  ۴. امتیازدهی هر پیشنهاد (استدلال)
  ۵. تولید توصیه (استدلال)
  ۶. ارائه برای تأیید انسانی (دروازه HITL)
  ۷. ایجاد سفارش خرید (اقدام — نیازمند تأیید)

┌─────────────┐
│   Router    │ ← طبقه‌بندی نوع پرس‌وجو
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  Retriever  │ ← واکشی زمینه مرتبط
│  (اسکیما +  │
│   داده)     │
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  Reasoner   │ ← تولید SQL / پلن
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  Validator  │ ← SQL Guard + بررسی مجوز
└──────┬──────┘
       │
       ├── مسدود → بازگشت خطا به کاربر
       │
       ▼ (معتبر)
┌─────────────┐
│  Executor   │ ← اجرای پرس‌وجو در Sandbox
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  Formatter  │ ← ارائه نتایج
└─────────────┘

عامل اقدام پیشنهاد می‌کند: "ایجاد سفارش خرید ۵۰۰ واحد از تأمین‌کننده X"
       │
       ▼
┌─────────────────┐
│  بررسی انسانی   │ ← کاربر باید صریحاً تأیید کند
│  (UI تأیید)     │
└────────┬────────┘
         │
    تأیید → اجرا از طریق API ERP
    رد → ثبت رد، بدون اقدام

┌─────────────────────────────────────────────────────────────────────────────┐
│                              سیستم ERP                                      │
│  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────────────────┐ │
│  │  DB مالی        │  │  DB موجودی      │  │  منطق کسب‌وکار (APIها)      │ │
│  └────────┬────────┘  └────────┬────────┘  └──────────────┬──────────────┘ │
└───────────┼────────────────────┼──────────────────────────┼────────────────┘
            │                    │                          │
            ▼                    ▼                          ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                         MIDDLEWARE یکپارچگی                                 │
│  ┌───────────────────────────────────────────────────────────────────────┐ │
│  │  لایه ایمنی: SQL Guard (فقط-SELECT) │ تزریق‌کننده مجوز │ حسابرسی      │ │
│  └───────────────────────────────────────────────────────────────────────┘ │
│  ┌───────────────────────────────────────────────────────────────────────┐ │
│  │  لایه هوشمندی: Schema Retriever │ LLM Orchestrator │ Validator       │ │
│  └───────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                         رابط کوپایلوت هوش مصنوعی                            │
│              UI چت │ دروازه‌های تأیید │ ارائه نتایج                         │
└─────────────────────────────────────────────────────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                              کاربران                                        │
│         مالی │ عملیات │ مدیریت │ تأمین                                     │
└─────────────────────────────────────────────────────────────────────────────┘