Inventory Intelligence

بايبلاين ذكاء اصطناعي لتحويل اللغة الطبيعية إلى استعلامات SQL

قمت ببناء نظام متكامل يتيح للمستخدم طرح أسئلة بلغة طبيعية عن بيانات قاعدة بيانات، ويقوم النظام تلقائيًا بترجمتها إلى استعلامات SQL دقيقة وتنفيذها واسترجاع النتائج بصيغة مفهومة.

نبذة عن المشروع:

تطبيق عملي لنظام Text-to-SQL يعمل على قاعدة بيانات Postgres لإدارة المخزون والموردين (Inventory/Warehouse Management)

يعتمد على LLM (OpenAI) لتوليد استعلامات SQL بصيغة Structured Output بدلًا من الاعتماد فقط على Prompt Engineering

تم بناء API متكامل باستخدام FastAPI مع نقطتي وصول (endpoints) للسؤال والتنفيذ (/ask و /execute)

الأمان أولًا:

طبقة حماية متعددة المستويات (Defense-in-Depth) تمنع تنفيذ أي أوامر DDL خطيرة (مثل DROP أو ALTER أو TRUNCATE)

تنفيذ تلقائي لاستعلامات القراءة (SELECT)، مع طلب تأكيد بشري قبل تنفيذ أي استعلام تعديل أو كتابة (DML)

اختبارات وحدة (Unit Tests) للتحقق من فعالية طبقة الحماية

الأدوات المستخدمة:

Python 3.13، FastAPI، PostgreSQL (عبر Docker Compose)، OpenAI API، psycopg2، Git/GitHub