Update: 2026-05-04 17:29:56

This commit is contained in:
Hamza-Ayed
2026-05-04 17:29:56 +03:00
parent 47652b4d95
commit 98c4b922be
12 changed files with 480 additions and 104 deletions

View File

@@ -2,6 +2,8 @@
namespace App\Core;
use App\Services\InvoiceExtractionService;
/**
* Gemini AI Integration for Invoice Extraction
* Optimized for Jordan UBL 2.1 Compliance
@@ -21,55 +23,8 @@ class AI
return null;
}
$prompt = "أنت نظام خبير في استخراج البيانات الضريبية للفواتير في الأردن.
يجب أن تلتزم بالقواعد التالية بصرامة حسابية مطلقة.
### 1. القواعد الحسابية الصارمة (إلزامي):
يجب أن توازن الفاتورة حسابياً قبل إرجاع النتيجة. المعادلة الأساسية هي:
`Grand Total = Subtotal - Discount Total + Tax Amount`
**مثال للتوضيح:**
إذا كانت البنود هي:
1. صنف أ: 12.000 (1 × 12.000)
2. صنف ب: 175.000 (35 × 5.000)
فإن المجموع الفرعي (Subtotal) هو 187.000.
إذا كانت الضريبة 16% على صنف أ فقط، فإن Tax Amount = 1.920.
إذاً الإجمالي (Grand Total) يجب أن يكون 188.920.
**تنبيه:** إذا وجدت في الفاتورة رقماً مكتوباً كإجمالي (Grand Total) ولكنه لا يطابق مجموع البنود والضريبة، قم بتصحيح البيانات المستخرجة للبنود لتتوافق مع المجموع الصحيح أو اتبع المجموع الرياضي الأدق. لا تخرج إجمالياً (مثلاً 15.000) بينما مجموع البنود (311.000).
### 2. قواعد استخراج البيانات:
- **اللغة:** لا تترجم. إذا كان الوصف 'صنف أول' أبقه 'صنف أول'.
- **الأرقام:** استخدم الأرقام اللاتينية (0-9).
- **الدقة:** استخدم 3 أرقام عشرية للمبالغ (مثال: 0.500).
- **الضريبة:** في الأردن، الضريبة العامة هي 16% (0.160). حدد لكل بند النسبة الفعلية.
### 3. هيكل البيانات (JSON فقط):
{
\"invoice_number\": \"string\",
\"invoice_date\": \"YYYY-MM-DD\",
\"invoice_type\": \"cash | credit\",
\"invoice_category\": \"simplified | standard\",
\"supplier\": { \"name\": \"string\", \"tin\": \"string\", \"address\": \"string\" },
\"buyer\": { \"name\": \"string\", \"tin\": \"string\", \"national_id\": \"string\" },
\"lines\": [
{
\"line_number\": 1,
\"description\": \"string\",
\"quantity\": 0.000,
\"unit_price\": 0.000,
\"tax_rate\": 0.160,
\"line_total\": 0.000
}
],
\"subtotal\": 0.000,
\"discount_total\": 0.000,
\"tax_amount\": 0.000,
\"grand_total\": 0.000,
\"currency_code\": \"JOD\"
}
أعد كود JSON فقط بدون أي علامات Markdown أو نصوص إضافية.";
$service = new InvoiceExtractionService();
$prompt = $service->buildExtractionPrompt();
$payload = [
"contents" => [

View File

@@ -43,4 +43,9 @@ final class Database
return self::$instance;
}
public static function generateUuid(): string
{
return vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex(random_bytes(16)), 4));
}
}