User Manual – Invoices Reader

مقدمة

مرحباً بك في قارئ الفواتير – تطبيق حديث وذكي مصمم لمعالجة واستخراج البيانات من صور الفواتير باستخدام تقنيات الذكاء الاصطناعي المتقدمة.

المميزات الرئيسية:

• دعم تنسيقات متعددة: معالجة أنواع مختلفة من الفواتير بما في ذلك الفواتير الإلكترونية السعودية والمصرية
• معالجة بالذكاء الاصطناعي: استخدام نماذج الذكاء الاصطناعي المتقدمة (Gemini، Ollama، OpenRouter، LM Studio) لاستخراج البيانات بدقة
• قراءة رموز QR: دعم متخصص لرموز QR للفواتير السعودية والمصرية
• المعالجة المجمعة: معالجة عدة فواتير في نفس الوقت
• إدارة قاعدة البيانات: تخزين وإدارة بيانات الفواتير المعالجة مع تصفية متقدمة
• خيارات التصدير: تصدير البيانات إلى Excel و CSV و PDF مع اختيار الحقول
• واجهة ثنائية اللغة: دعم كامل للغة العربية والإنجليزية
• تصفية متقدمة: إمكانيات بحث وتصفية قوية مع وضع التطبيق التلقائي واليدوي
• نظام مزامنة محسّن: نافذة نتائج مفصلة مع رسائل خطأ واضحة بالعربية والإنجليزية
• أنظمة محاسبية متعددة: التكامل مع Wafeq و Odoo مع بنية قابلة للتوسع
• تتبع التقدم: مراقبة المزامنة في الوقت الفعلي مع إمكانية الإلغاء
• تصدير نتائج المزامنة: حفظ تقارير المزامنة المفصلة
• دقة عشرية محسّنة: تقريب جميع القيم النقدية إلى خانتين عشريتين
• تصدير PDF مع دعم العربية: تصدير PDF احترافي مع عرض صحيح للنص العربي

متطلبات النظام

• نظام تشغيل: Windows 10 أو أحدث
• ذاكرة RAM: 4GB على الأقل
• مساحة القرص: 500MB على الأقل
• دقة الشاشة: 1280×720 بكسل كحد أدنى
• اتصال بالإنترنت لأوضاع الذكاء الاصطناعي السحابية مثل Gemini و OpenRouter (أوضاع Ollama و LM Studio تعمل محلياً)

تثبيت البرنامج

1. قم بتحميل ملف التثبيت Invoices Reader.exe
2. انقر نقراً مزدوجاً على ملف التثبيت
3. اتبع خطوات المعالج للتثبيت:
   • اختر لغة التثبيت (العربية متوفرة)
   • اختر مجلد التثبيت
   • حدد ما إذا كنت تريد إنشاء اختصار على سطح المكتب
4. انتظر حتى اكتمال عملية التثبيت
5. انقر على ‘إنهاء’ لإكمال التثبيت

ملاحظات هامة

• تأكد من تشغيل البرنامج كمسؤول في المرة الأولى
• إذا ظهرت رسالة من Windows Defender، انقر على ‘مزيد من المعلومات’ ثم ‘تشغيل على أي حال’
• يمكنك إلغاء تثبيت البرنامج في أي وقت من خلال لوحة التحكم > البرامج والميزات

بدء الاستخدام

1. شغّل البرنامج من خلال:
   • النقر المزدوج على أيقونة البرنامج على سطح المكتب
   • أو من قائمة ابدأ > Invoices Reader
2. عند أول تشغيل:
   • سيطلب البرنامج تحديد اللغة المفضلة
   • يمكنك اختيار المظهر الفاتح أو الداكن
   • يمكنك تحديد المجلد الافتراضي لحفظ البيانات

الإعداد الأولي

1. عند أول استخدام، يُنصح بتهيئة الإعدادات الأساسية:
   • افتح قائمة ‘أدوات’ > ‘الإعدادات’
   • انتقل إلى تبويب ‘عام’
   • حدد نوع الفواتير التي ستقوم بمعالجتها (سعودية/مصرية)
   • اختر مجلد الحفظ الافتراضي
   • حدد تنسيق تصدير البيانات المفضل (Excel/CSV/PDF)
2. يمكنك تغيير هذه الإعدادات لاحقاً في أي وقت

Processing Modes

يوفر البرنامج عدة أوضاع لمعالجة الفواتير حسب نوعها ومصدرها. يمكنك تغيير وضع المعالجة من شريط الأدوات أو من قائمة “أدوات”.

وضع الفواتير السعودية

• Saudi einvoice qr code – fast: معالجة سريعة للفواتير السعودية
• Saudi einvoice qr code – detailed: معالجة مفصلة مع استخراج تفاصيل إضافية

هذا الوضع مخصص للفواتير الإلكترونية السعودية التي تحتوي على رمز QR وفقاً لمعايير هيئة الزكاة والضريبة والجمارك.

وضع الفواتير المصرية

• Egyptian einvoice qr code – fast: معالجة سريعة للفواتير المصرية
• Egyptian einvoice qr code – detailed: معالجة مفصلة مع بيانات إضافية

مخصص للفواتير الإلكترونية المصرية وفقاً لمعايير مصلحة الضرائب المصرية.

أوضاع الذكاء الاصطناعي

تستخدم هذه الأوضاع تقنيات الذكاء الاصطناعي المتقدمة لاستخراج البيانات من أي نوع من الفواتير:

Google Gemini

• GEMINI – fast: معالجة سريعة باستخدام Gemini Flash
• GEMINI – detailed: معالجة مفصلة باستخدام Gemini Pro

يتطلب مفتاح API من Google AI Studio. مجاني للاستخدام العادي.

Ollama (محلي)

• OLLAMA – fast: معالجة محلية سريعة
• OLLAMA – detailed: معالجة محلية مفصلة

يعمل بدون إنترنت ويحافظ على خصوصية البيانات. يتطلب تثبيت Ollama محلياً.

OpenRouter

• OPENROUTER – fast: وصول إلى 400+ نموذج AI

يوفر وصولاً إلى نماذج متعددة مجانية ومدفوعة من مختلف الشركات.+ +

LM Studio (محلي)

+

• LM STUDIO – local: تشغيل النماذج عبر خادم LM Studio المتوافق مع OpenAI

+

يوفر معالجة محلية بالكامل مع تحكم كامل بالبيانات. يتطلب تشغيل تطبيق LM Studio وتفعيل خادم OpenAI داخل التطبيق.

تغيير أوضاع المعالجة

1. انقر على أيقونة “تغيير وضع المعالجة” في شريط الأدوات
2. أو اذهب إلى قائمة “أدوات” > “الإعدادات” > تبويب “وضع المعالجة”
3. اختر الوضع المناسب من القائمة
4. انقر “موافق” لحفظ التغيير

ملاحظة: البرنامج يحفظ اختيارك تلقائياً ويستعيده عند إعادة التشغيل.

إعدادات الذكاء الاصطناعي

لاستخدام أوضاع الذكاء الاصطناعي، تحتاج إلى إعداد الخدمات المطلوبة. اذهب إلى قائمة “أدوات” > “الإعدادات” > تبويب “نماذج الذكاء الاصطناعي”.

إعداد Google Gemini

1. اذهب إلى Google AI Studio
2. سجل الدخول بحساب Google
3. انقر “Create API Key”
4. انسخ المفتاح
5. في البرنامج، افتح الإعدادات > تبويب نماذج الذكاء الاصطناعي > قسم Gemini
6. الصق المفتاح في حقل “API Key”
7. اختر النموذج المفضل
8. انقر “اختبار الاتصال” للتأكد
9. احفظ الإعدادات

إعداد Ollama

1. حمّل Ollama من الموقع الرسمي
2. ثبّت البرنامج واتبع التعليمات
3. افتح Terminal/Command Prompt
4. نفّذ: ollama pull llava:7b (للمبتدئين)
5. أو: ollama pull llava:13b (للمتقدمين)
6. في البرنامج، افتح الإعدادات > تبويب نماذج الذكاء الاصطناعي > قسم Ollama
7. انقر “تحديث قائمة النماذج”
8. اختر النموذج المثبت
9. انقر “اختبار الاتصال”

إعداد OpenRouter

1. اذهب إلى OpenRouter
2. أنشئ حساب جديد
3. اذهب إلى صفحة المفاتيح
4. أنشئ مفتاح API جديد
5. في البرنامج، افتح الإعدادات > تبويب نماذج الذكاء الاصطناعي > قسم OpenRouter
6. الصق المفتاح في حقل “API Key”
7. انقر “جلب النماذج المجانية” لرؤية النماذج المتاحة مجاناً
8. اختر نموذج أو أدخل اسم نموذج مخصص
9. انقر “اختبار الاتصال”
10. احفظ الإعدادات

نصيحة: يوفر OpenRouter العديد من النماذج المجانية. استخدم زر “النماذج المجانية” للحصول على أحدث القائمة.

إعداد LM Studio

1. قم بتحميل أحدث إصدار من LM Studio وتثبيته على جهازك
2. شغّل LM Studio وفعّل خادم OpenAI المتوافق (العنوان الافتراضي: http://localhost:1234)
3. قم بتنزيل أو استيراد نموذج يدعم الرؤية داخل LM Studio (مثل lmstudio-community/phi-3.1-vision-instruct)
4. افتح نافذة الإعدادات في التطبيق واختر تبويب نماذج الذكاء الاصطناعي ثم قسم LM Studio
5. تحقق من عنوان الخادم، أدخل مفتاح API إذا قمت بتفعيله في LM Studio، ثم أدخل معرف النموذج بالضبط كما يظهر في التطبيق
6. عدّل قيمة المهلة إذا لزم الأمر ثم اضغط على اختبار الاتصال بـ LM Studio للتأكد من نجاح الاتصال
7. اضغط على حفظ إعدادات LM Studio لتخزين الإعدادات

ملاحظة: يعمل LM Studio محلياً بالكامل. تأكد من بقاء التطبيق قيد التشغيل في الخلفية أثناء استخدامك لقارئ الفواتير للحصول على الاستجابات.

الواجهة الرئيسية

الشكل 1: الواجهة الرئيسية لبرنامج قارئ الفواتير

تتكون الواجهة الرئيسية من:

• شريط الأدوات العلوي (يحتوي على الوظائف الأساسية)
• منطقة عرض الصور (مع أزرار تنقل أصغر لتوفير مساحة أكبر للعرض)
• لوحة معلومات الفاتورة
• شريط الحالة السفلي (يعرض وضع المعالجة الحالي)

شريط الأدوات

الشكل 2: شريط الأدوات الرئيسي مع الوظائف المتاحة

يحتوي شريط الأدوات على الوظائف الرئيسية التالية:

• عملية جديدة: إنشاء دفعة جديدة من الفواتير
• فتح مجلد: اختيار مجلد يحتوي على الفواتير
• السجل: عرض سجل الفواتير السابقة
• وضع المعالجة: اختيار طريقة معالجة الفواتير (من نافذة الإعدادات الموحدة)
• الإعدادات: نافذة الإعدادات الشاملة (AI، التكاملات، المظهر، إلخ)
• إعدادات Odoo: إعداد اتصال نظام Odoo (عبر نافذة الإعدادات)
• دليل المستخدم: عرض دليل المستخدم الشامل

اختصارات لوحة المفاتيح

لتسهيل استخدام البرنامج، تتوفر الاختصارات التالية:

الاختصار	الوظيفة
←	الفاتورة التالية
→	الفاتورة السابقة
الرئيسية	الفاتورة الأولى
End	الفاتورة الأخيرة
Ctrl + O	فتح مجلد
Ctrl + S	حفظ بيانات الفاتورة
Ctrl + N	إنشاء دفعة جديدة
F5	معالجة الفاتورة الحالية

أفضل الممارسات

1. تنظيم الملفات:
   • ضع الفواتير في مجلدات منظمة حسب الشهر/السنة
   • استخدم أسماء وصفية للملفات
2. النسخ الاحتياطي:
   • قم بتصدير البيانات بشكل دوري
   • احتفظ بنسخة احتياطية من قاعدة البيانات
3. جودة المستندات:
   • تأكد من وضوح الفواتير الممسوحة ضوئياً
   • استخدم دقة عالية عند المسح (300 DPI على الأقل)

فتح مجلد الفواتير

1. انقر على زر “فتح مجلد” في شريط الأدوات
2. حدد المجلد الذي يحتوي على الفواتير
3. سيقوم البرنامج بتحميل جميع الملفات المدعومة
4. سيظهر مسار المجلد في عنوان النافذة للرجوع إليه بسهولة

وضع المعالجة

يوفر البرنامج عدة أوضاع لمعالجة الفواتير:

أوضاع قراءة رمز QR

• Saudi einvoice qr code – fast: لقراءة رموز QR للفواتير السعودية
• Egyptian einvoice qr code – fast: لقراءة رموز QR للفواتير المصرية

أوضاع الذكاء الاصطناعي

• GEMINI – fast: يستخدم نموذج Google Gemini للذكاء الاصطناعي (يتطلب مفتاح API)
• OLLAMA – slowيستخدم نماذج Ollama المحلية (يعمل بدون اتصال بالإنترنت)

لتغيير وضع المعالجة:

1. انقر على زر “وضع المعالجة” في شريط الأدوات
2. اختر الوضع المناسب لنوع الفواتير التي تعمل عليها
3. انقر على “تطبيق” لتفعيل الوضع الجديد

معالجة الفواتير

• يدعم البرنامج ملفات PDF والصور
• يتم عرض شريط تقدم أثناء المعالجة
• يمكنك التنقل بين الفواتير باستخدام الأسهم

قراءة رموز QR

• يقوم البرنامج تلقائياً بقراءة رموز QR
• يدعم الفواتير الإلكترونية السعودية والمصرية
• يستخرج البيانات الأساسية من الرمز

استخراج البيانات

• يستخدم البرنامج الذكاء الاصطناعي لتحليل الفواتير
• يدعم Google Gemini و Ollama
• يستخرج التفاصيل مثل:
  • رقم الفاتورة
  • التاريخ
  • المبلغ الإجمالي
  • تفاصيل الضريبة
  • معلومات البائع والمشتري

Invoices History

توفر نافذة سجل الفواتير واجهة متقدمة للبحث والتصفية وإدارة الفواتير المقروءة مسبقاً. يمكن الوصول إليها من خلال:

• النقر على زر “السجل” في الواجهة الرئيسية
• اختيار قائمة ملف > قاعدة البيانات

توفر نافذة سجل الفواتير واجهة متقدمة للبحث والتصفية وإدارة الفواتير المقروءة مسبقاً. يمكن الوصول إليها من خلال:

• النقر على زر “السجل” في الواجهة الرئيسية
• اختيار قائمة ملف > قاعدة البيانات

عرض الدفعات

تحتوي النافذة على تبويبين رئيسيين. التبويب الأول “عرض الدفعات” يعرض قائمة بجميع دفعات الفواتير التي تمت معالجتها:

• يمكنك تصفية الدفعات حسب نطاق تاريخي محدد
• يمكنك تحميل دفعة كاملة لعرضها في الواجهة الرئيسية
• يمكنك تصدير دفعة كاملة إلى ملف Excel
• يمكنك حذف دفعة كاملة من قاعدة البيانات

العرض المتقدم

التبويب الثاني “العرض المتقدم” يوفر واجهة متقدمة لعرض وتصفية جميع الفواتير الفردية:

• البحث: يمكنك البحث عن فواتير باستخدام اسم المورد، رقم الفاتورة، أو الرقم الضريبي
• تصفية حسب المورد: يمكنك اختيار مورد محدد من القائمة المنسدلة
• تصفية حسب التاريخ: يمكنك تحديد نطاق تاريخي للفواتير
• تصفية حسب المبلغ: يمكنك تحديد نطاق لمبالغ الفواتير

يمكنك أيضاً:

• تحميل فاتورة محددة في الواجهة الرئيسية
• تصدير نتائج البحث والتصفية إلى ملف Excel
• حذف فاتورة محددة من قاعدة البيانات

مركز ثقة الموردين 🛡️

يعمل مركز ثقة الموردين كمركز موحد لضمان بقاء قاعدة بيانات الموردين نظيفة، دقيقة، وخالية من التكرارات.

المميزات الرئيسية:

• اكتشاف التكرار الذكي: يحدد تلقائياً الموردين المحتمل أن يكونوا نفس الكيان بناءً على تشابه الأسماء أو تطابق الأرقام الضريبية.
• اقتراحات الدمج: بدلاً من الدمج العشوائي، يقوم النظام بإنشاء “اقتراحات دمج” لتراجعها بنفسك.
• مقارنة شاملة: مقارنة جنباً إلى جنب لتفاصيل الاتصال (العنوان، الهاتف، إلخ) قبل الدمج.

كيفية إزالة تكرار الموردين:

1. اذهب إلى أدوات ← مركز ثقة الموردين.
2. انقر على تشغيل إزالة التكرار المجمع.
3. راجع قائمة “الاقتراحات المعلقة”.
4. لكل اقتراح، انقر على مراجعة لرؤية التفاصيل.
5. انقر موافق على الدمج لدمجهم (تحديث جميع الفواتير التاريخية) أو رفض لإبقائهم منفصلين.

ملاحظة: دمج الموردين هو إجراء قوي يقوم بتحديث جميع الفواتير السابقة للإشارة إلى المورد الرئيسي. هذا الإجراء مدعوم بنظام تراجع للأمان.

نظام الإضافات (Plugins)

يتميز التطبيق الآن بنظام إضافات (Plugins) قوي يسمح بتوسيع وظائف البرنامج دون الحاجة لتثبيت إصدارات جديدة.

إدارة الإضافات

يتم اكتشاف الإضافات تلقائياً من مجلد plugins. يمكنك رؤية الإضافات المحملة في سجل بدء التشغيل أو قائمة “إضافات” الجديدة.

الإضافات المضمنة

تكامل تيليجرام (Telegram Integration) 📱

أرسل الفواتير مباشرة من تطبيق تيليجرام إلى برنامج الكمبيوتر.

• ربط البوت: اتصل ببوت تيليجرام لاستقبال الملفات.
• نظام الانتظار: يتم وضع الملفات في طابور للمعالجة عندما تكون مستعداً.

المميزات المتقدمة

مميزات التبويب المتقدم

يوفر التبويب المتقدم في نافذة قاعدة البيانات إمكانيات تصفية وتصدير قوية:

أوضاع التصفية

• وضع التطبيق التلقائي: يتم تطبيق المرشحات تلقائياً أثناء الكتابة أو تغيير قيم المرشحات. هذا هو الوضع الافتراضي للتصفية السريعة.
• وضع التطبيق اليدوي: يتم تطبيق المرشحات فقط عند النقر على زر “تطبيق المرشحات”. استخدم هذا الوضع عندما تريد تعيين عدة مرشحات قبل تطبيقها.

للتبديل بين الأوضاع:

1. انقر على زر “التطبيق التلقائي” في التبويب المتقدم
2. عند التعطيل، سيظهر زر “تطبيق المرشحات”
3. انقر على “تطبيق المرشحات” لتطبيق إعدادات المرشحات يدوياً

مؤشرات التحميل

عند تطبيق المرشحات، يظهر مؤشر تحميل لإظهار أن النظام يعالج طلبك. يتم تعطيل عناصر التحكم في المرشحات مؤقتاً خلال هذا الوقت لمنع التعارضات.

التصفية المتقدمة

يوفر التبويب المتقدم خيارات تصفية شاملة:

البحث النصي

• البحث عبر عدة حقول: اسم المورد، رقم الفاتورة، الرقم الضريبي
• نتائج البحث في الوقت الفعلي (في وضع التطبيق التلقائي)
• مطابقة غير حساسة لحالة الأحرف

مرشح المورد

• اختر مورداً واحداً أو أكثر من القائمة المنسدلة
• تصفية الفواتير حسب موردين محددين
• دعم الاختيار المتعدد

مرشح نطاق التاريخ

• تصفية الفواتير حسب نطاق تاريخي
• اختر تاريخ البداية والنهاية
• مسح مرشحات التاريخ بسهولة

مرشح نطاق المبلغ

• التصفية حسب الحد الأدنى والأقصى لمبالغ الفواتير
• تعيين الحد الأدنى أو الأقصى، أو كليهما
• مفيد للعثور على فواتير ضمن نطاقات أسعار محددة

رموز المرشحات

يتم عرض المرشحات النشطة كرموز أعلى الجدول. يمكنك:

• رؤية جميع المرشحات النشطة في لمحة
• إزالة المرشحات الفردية بالنقر على X في كل رمز
• فهم المرشحات المطبقة حالياً بسرعة

اختصارات لوحة المفاتيح للتصفية

الإجراء	الاختصار
التركيز على حقل البحث	Ctrl+F
مسح جميع المرشحات	Esc
إعادة تعيين المرشحات	Ctrl+R
تطبيق المرشحات (الوضع اليدوي)	Enter

Export Options

يوفر التطبيق خيارات تصدير مرنة مع اختيار الحقول:

تنسيقات التصدير

• Excel (.xlsx): تنسيق جدول بيانات احترافي مع تنسيق
• CSV (.csv): قيم مفصولة بفواصل للتوافق
• PDF: تنسيق مستند احترافي مع صور الفواتير

أنواع التصدير

• تصدير بسيط: ملخص الفاتورة فقط (معلومات الرأس)
• تصدير مفصل: يتضمن بنود الفاتورة لكل فاتورة

اختيار الحقول

عند التصدير، يمكنك اختيار الحقول المراد تضمينها:

• رقم المعرف
• رقم الدفعة
• اسم المورد
• رقم الفاتورة
• تاريخ الفاتورة
• الرقم الضريبي
• المبلغ الإجمالي
• مبلغ الضريبة
• المجموع الفرعي
• العملة
• تاريخ الاستحقاق
• الخصم
• المبلغ المستحق
• اسم العميل
• معرف العميل
• الرقم الضريبي للعميل
• أمر الشراء
• شروط الدفع
• عنوان المورد
• عنوان العميل
• فئة الفاتورة

مصادر التصدير

• الفواتير المحددة: تصدير الفواتير التي قمت بتحديدها في الجدول فقط
• النتائج المصفاة: تصدير جميع الفواتير المطابقة لمرشحاتك الحالية
• الدفعة الكاملة: تصدير جميع الفواتير في دفعة محددة
• دفعات متعددة: تصدير الفواتير من عدة دفعات في ملف واحد

كيفية التصدير

1. طبق مرشحاتك أو حدد الفواتير (إذا كنت تصدر العناصر المحددة)
2. انقر على زر “تصدير” (Excel أو PDF)
3. في نافذة خيارات التصدير:
   • اختر نوع التصدير (بسيط أو مفصل)
   • حدد تنسيق الملف (Excel أو CSV أو PDF)
   • حدد الحقول المراد تضمينها
4. انقر على “تصدير” لحفظ الملف
5. اختر موقع الحفظ واسم الملف

تصدير PDF

ينشئ تصدير PDF مستندات احترافية مع صور الفواتير وبيانات التعريف:

Features

• صور الفواتير: يتم تضمين كل صورة فاتورة في PDF
• نص تراكبي: معلومات الفاتورة الأساسية معروضة في أسفل كل صفحة:
  • التاريخ
  • رقم الفاتورة
  • اسم المورد
  • المبلغ الإجمالي
• دعم النص العربي: عرض صحيح للنص العربي مع محاذاة من اليمين إلى اليسار
• تنسيق سطر واحد: نص تراكبي مضغوط لا يغطي صورة الفاتورة
• صفحات متعددة: تظهر كل فاتورة في صفحتها الخاصة

Export Options

• تصدير الفواتير المحددة
• تصدير النتائج المصفاة
• تصدير الدفعة الكاملة
• تصدير دفعات متعددة

ملاحظة: يستخدم تصدير PDF تشكيل النص العربي الصحيح ومعالجة النص ثنائي الاتجاه لعرض دقيق للمحتوى العربي.

المعالجة المجمعة

• معالجة عدة فواتير في نفس الوقت
• تتبع التقدم التلقائي
• معالجة الأخطاء والتعافي
• ملخص نتائج الدفعة

التكامل مع الأنظمة المحاسبية 🔗

يدعم البرنامج التكامل مع أنظمة محاسبية متعددة لمزامنة الفواتير تلقائياً. يمكن الوصول إلى إعدادات التكامل من خلال:

• النقر على زر “التكامل” في الواجهة الرئيسية
• اختيار قائمة أدوات > التكامل مع الأنظمة المحاسبية

الأنظمة المدعومة

1. نظام Wafeq 💰

نظام محاسبي سحابي متطور يدعم الفواتير الإلكترونية السعودية.خطوات الإعداد:

1. انتقل إلى تبويب “Wafeq” في نافذة التكامل
2. أدخل مفتاح API الخاص بحسابك في Wafeq
3. انقر على “اختبار الاتصال” للتأكد من صحة الإعدادات
4. احفظ الإعدادات

المميزات:

• إنشاء فواتير الموردين تلقائياً
• رفع مرفقات الفواتير (صور PDF)
• دعم بنود الفواتير المتعددة
• حساب الضرائب والخصومات تلقائياً
• إنشاء جهات الاتصال (الموردين) تلقائياً

2. نظام Odoo 🏢

نظام إدارة موارد المؤسسات (ERP) مفتوح المصدر.خطوات الإعداد:

1. انتقل إلى تبويب “Odoo” في نافذة التكامل
2. أدخل رابط خادم Odoo
3. أدخل اسم قاعدة البيانات
4. أدخل اسم المستخدم ومفتاح API
5. انقر على “اختبار الاتصال” للتأكد من صحة الإعدادات
6. احفظ الإعدادات

المميزات:

• إنشاء فواتير الموردين
• إنشاء المنتجات والخدمات تلقائياً
• ربط الفواتير بالحسابات المحاسبية
• دعم الضرائب والخصومات
• رفع مرفقات الفواتير

مزامنة الفواتير 🔄

بعد إعداد التكامل مع النظام المحاسبي، يمكنك مزامنة الفواتير:

خطوات المزامنة:

1. افتح نافذة سجل الفواتير
2. اختر الدفعة التي تريد مزامنتها
3. انقر على زر “مزامنة”
4. اختر النظام المحاسبي المطلوب (Wafeq أو Odoo)
5. راقب تقدم المزامنة في النافذة المنبثقة

نافذة النتائج المحسّنة 📊

توفر النافذة الجديدة معلومات مفصلة عن كل فاتورة:الميزات الجديدة:

• ملخص إحصائي: عدد الفواتير الناجحة والفاشلة
• جدول تفصيلي: معلومات كل فاتورة (الحالة، رقم الفاتورة، المورد، المبلغ)
• رسائل خطأ واضحة: رسائل باللغة العربية سهلة الفهم
• تفاصيل تقنية قابلة للتوسيع: معلومات تقنية مفصلة للمطورين
• تصدير النتائج: حفظ نتائج المزامنة في ملف CSV

أنواع رسائل الأخطاء:

• ✅ نجحت المزامنة: تمت مزامنة الفاتورة بنجاح
• ❌ خطأ في دقة الأرقام: يجب أن تكون الأرقام بحد أقصى 2 خانة عشرية
• ⚠️ فشل رفع المرفقات: مشكلة في رفع ملف الفاتورة
• 🔐 خطأ في التصريح: تحقق من مفتاح API
• 🌐 خطأ في الاتصال: تحقق من الاتصال بالإنترنت
• ⏰ انتهت مهلة الاتصال: الخادم لا يستجيب

إلغاء المزامنة:

يمكنك إلغاء عملية المزامنة في أي وقت بالنقر على زر “إلغاء” في نافذة التقدم.

نصائح للمزامنة الناجحة:

1. تأكد من الاتصال: اختبر الاتصال قبل بدء المزامنة
2. راجع البيانات: تأكد من صحة بيانات الفواتير قبل المزامنة
3. ابدأ بدفعة صغيرة: جرب مزامنة فواتير قليلة أولاً
4. احفظ النتائج: استخدم ميزة التصدير لحفظ تقرير المزامنة
5. راجع الأخطاء: اقرأ رسائل الأخطاء وصحح البيانات إذا لزم الأمر

إضافة أنظمة محاسبية جديدة 🔧

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

• ملف التوثيق: docs/ADDING_NEW_ACCOUNTING_SYSTEMS.md
• الكود المرجعي في database/base_sync_worker.py

التكامل مع تيليجرام 📱

أرسل الفواتير مباشرة من هاتفك المحمول إلى جهاز الكمبيوتر للمعالجة باستخدام بوت تيليجرام المخصص.

المميزات:

• التقاط فوري: صور الفاتورة أو أعد توجيه ملف PDF مباشرة من تيليجرام.
• نظام الطابور: يتم وضع الفواتير في طابور على جهاز الكمبيوتر حتى تكون جاهزاً لمعالجتها.
• الأمان: يمكن لمستخدمي تيليجرام المصرح لهم فقط إرسال الملفات إلى البوت الخاص بك.

دليل الإعداد:

1. اذهب إلى أدوات ← إعدادات التكامل في التطبيق.
2. انتقل إلى تبويب Telegram.
3. أدخل كود البوت (Bot Token) (الذي حصلت عليه من @BotFather).
4. انقر تشغيل البوت.
5. أرسل رسالة إلى البوت الخاص بك من تيليجرام.
6. سيكتشف التطبيق معرف المستخدم الخاص بك. انقر تفويض لإضافتك للقائمة البيضاء.

نصيحة: يمكنك تفويض عدة أعضاء من الفريق لإرسال الفواتير إلى نفس الطابور!

استكشاف الأخطاء وإصلاحها

المشاكل العامة

البرنامج لا يبدأ التشغيل

• تأكد من تثبيت Python 3.8+
• تحقق من توفر جميع التبعيات
• شغّل من سطر الأوامر لرؤية رسائل الخطأ
• تحقق من صلاحيات الملفات

لا يمكن فتح الملفات

• تحقق من توافق تنسيق الملف (JPG, PNG, PDF, TIFF)
• تأكد من أن الملف غير تالف
• التأكد من وجود مساحة كافية على القرص
• تحقق من صلاحيات الملفات

مشاكل الحفظ

• تحقق من صلاحيات الكتابة في المجلد الهدف
• تحقق من مساحة القرص المتاحة
• تأكد من أن الملف الهدف غير مفتوح في تطبيق آخر

مشاكل المعالجة

وضع المعالجة لا يحفظ

• تأكد من النقر على “تطبيق” بعد اختيار الوضع
• تحقق من أن التطبيق لديه صلاحيات الكتابة في مجلد الإعدادات
• أعد تشغيل التطبيق للتحقق من استمرارية الوضع

فشل قراءة رمز QR

• تأكد من جودة الصورة الكافية
• تحقق من أن رمز QR غير تالف أو محجوب
• جرب استخدام أوضاع معالجة AI لدقة أفضل
• تحقق من أن تنسيق رمز QR يطابق الوضع المحدد

مشاكل الذكاء الاصطناعي

أخطاء Gemini API

• مفتاح API غير صالح: تحقق من أن المفتاح صحيح ونشط
• تجاوز الحصة: تحقق من حدود الاستخدام
• تحديد المعدل: قلل سرعة المعالجة أو قم بترقية الخطة
• مشاكل الشبكة: تحقق من اتصال الإنترنت

مشاكل اتصال Ollama

• تحقق من تشغيل خدمة Ollama
• تحقق من عنوان الخادم والمنفذ
• تأكد من تثبيت نموذج يدعم الرؤية
• تحقق من موارد النظام الكافية (RAM, GPU)

مشاكل OpenRouter

• رصيد غير كافٍ: أضف رصيداً أو استخدم نماذج مجانية
• النموذج غير متاح: جرب نموذجاً مختلفاً أو احصل على قائمة محدّثة
• أخطاء API: تحقق من مفتاح API وحالة الحساب

مشاكل الأداء

المعالجة بطيئة

• استخدم أوضاع معالجة أسرع (أوضاع QR مقابل أوضاع AI)
• قم بترقية ذاكرة RAM واستخدم تخزين SSD
• لـ Ollama: تأكد من عمل تسريع GPU
• عالج دفعات أصغر

استهلاك عالي للذاكرة

• عالج دفعات أصغر من الفواتير
• أغلق التطبيقات الأخرى
• أعد تشغيل التطبيق بشكل دوري
• قم بترقية ذاكرة RAM إذا أمكن

الشبكة والاتصال

اتصال الإنترنت مطلوب

• Gemini و OpenRouter يتطلبان اتصال إنترنت مستقر
• استخدم Ollama أو أوضاع QR للمعالجة بدون إنترنت
• تحقق من إعدادات الجدار الناري والبروكسي

انتهاء مهلة اتصال API

• تحقق من استقرار الإنترنت
• تحقق من حالة خدمة API
• جرب اتصال شبكة مختلف
• اتصل بمزود API إذا استمرت المشاكل

العرض والواجهة

اللغة لا تتغير

• أعد تشغيل التطبيق بعد تغيير اللغة
• تحقق من وجود ملفات الترجمة
• تحقق من أن التطبيق لديه صلاحيات القراءة لملفات الترجمة

عناصر الواجهة لا تظهر بشكل صحيح

• تحقق من إعدادات تحجيم العرض في النظام
• تحقق من توافق دقة الشاشة
• جرب خيارات المظهر المختلفة
• أعد تشغيل التطبيق

مشاكل تصدير PDF

• النص العربي لا يظهر: تأكد من تثبيت مكتبات arabic-reshaper و python-bidi
• النص التراكبي مفقود: تحقق من توفر بيانات الفاتورة
• الصور لا تظهر: تحقق من وجود ملفات صور الفواتير وإمكانية الوصول إليها

التحديثات المستقبلية

الميزات المكتملة ✅

• ✅ دعم متعدد اللغات (العربية/الإنجليزية)
• ✅ التكامل مع OpenRouter مع 400+ نموذج AI
• ✅ جلب النماذج المجانية المباشر
• ✅ إمكانية إدخال نموذج مخصص
• ✅ استمرارية وضع المعالجة
• ✅ معالجة محسّنة للأخطاء وملاحظات المستخدم
• ✅ دليل مستخدم شامل
• ✅ تصفية متقدمة مع أوضاع التطبيق التلقائي واليدوي
• ✅ اختيار الحقول في التصدير
• ✅ تصدير PDF مع دعم النص العربي
• ✅ اختصارات لوحة المفاتيح للتصفية
• ✅ مؤشرات التحميل لعمليات التصفية

الميزات قيد التطوير 🚧

• 🚧 تحسينات OCR المتقدمة
• 🚧 تنسيقات تصدير إضافية
• 🚧 خيارات تكامل محسّنة
• 🚧 تحسينات الأداء

الميزات المطلوبة من المستخدمين 📝

• 📝 التكامل مع التخزين السحابي
• 📝 تطبيق محمول مساعد
• 📝 ميزات تقارير متقدمة
• 📝 دعم متعدد المستخدمين

كيفية طلب ميزة جديدة

1. تحقق من طلبات الميزات الموجودة في مستودع المشروع
2. أنشئ طلب ميزة مفصل مع حالات الاستخدام
3. شارك في مناقشات المجتمع
4. فكر في المساهمة في التطوير

الدعم

الحصول على المساعدة

• التوثيق: يغطي دليل المستخدم هذا معظم السيناريوهات الشائعة
• المجتمع: انضم إلى المناقشات في مستودع المشروع
• المشاكل: أبلغ عن الأخطاء والمشاكل التقنية على GitHub
• طلبات الميزات: اقترح تحسينات وميزات جديدة

قبل طلب المساعدة

1. تحقق من قسم استكشاف الأخطاء هذا
2. تحقق من أن نظامك يلبي المتطلبات
3. جرب الحلول المقترحة
4. اجمع رسائل الخطأ ومعلومات النظام

الإبلاغ عن المشاكل

عند الإبلاغ عن المشاكل، يرجى تضمين:

• نظام التشغيل والإصدار
• إصدار التطبيق
• خطوات إعادة إنتاج المشكلة
• رسائل الخطأ (إن وجدت)
• لقطات الشاشة (إن كانت ذات صلة)

ملاحظة: يتم صيانة هذا التطبيق وتحديثه بنشاط. تحقق من أحدث إصدار بانتظام للاستفادة من التحسينات وإصلاحات الأخطاء.

نظام التسجيل والاشتراكات 🔐

يوفر برنامج قارئ الفواتير نظام تسجيل مرن يناسب جميع احتياجاتك، من الاستخدام التجريبي المجاني إلى النسخة المميزة الكاملة.

الفترة التجريبية 🎁

عند تشغيل البرنامج لأول مرة، تحصل تلقائياً على فترة تجريبية مجانية لتجربة جميع ميزات البرنامج.

مميزات الفترة التجريبية:

• ✅ 100 فاتورة كحد أقصى: يمكنك معالجة حتى 100 فاتورة خلال الفترة التجريبية
• ✅ 5 دفعات: يمكنك معالجة حتى 5 دفعات من أي حجم
• ✅ جميع المميزات متاحة: الوصول الكامل لجميع ميزات البرنامج
• ✅ بدون قيود على حجم الدفعة: معالجة أي عدد من الفواتير في الدفعة الواحدة
• ✅ التكامل مع الأنظمة المحاسبية: مزامنة مع Odoo و Wafeq
• ✅ جميع نماذج الذكاء الاصطناعي: استخدام Gemini، Ollama، OpenRouter

كيفية استخدام الفترة التجريبية:

1. قم بتشغيل البرنامج لأول مرة
2. لن تحتاج إلى تسجيل أو إدخال بيانات
3. ابدأ مباشرة في معالجة الفواتير
4. سيتم احتساب كل دفعة معالجة من حد الـ 5 دفعات
5. يمكنك مراقبة الاستخدامات المتبقية من شريط العنوان

ملاحظات هامة:

• ⚠️ العد التنازلي: يتم احتساب الاستخدام فقط عند معالجة دفعة بنجاح
• ⚠️ لا يتم الاحتساب: فتح المجلدات، عرض الفواتير، أو التنقل بين الصور
• ⚠️ حد الدفعات: أي دفعة تتم معالجتها تُحتسب من حد الـ 5 دفعات
• ⚠️ الحد الإجمالي: لا يمكن تجاوز 100 فاتورة إجمالاً خلال الفترة التجريبية

النسخة المجانية 🆓

بعد انتهاء الفترة التجريبية، يمكنك الاستمرار في استخدام البرنامج مجاناً مع بعض القيود المعقولة.

مميزات النسخة المجانية:

• ✅ 10 فواتير يومياً: معالجة حتى 10 فواتير كل يوم
• ✅ 5 فواتير لكل دفعة: حد أقصى 5 فواتير في الدفعة الواحدة
• ✅ سجل 90 يوم: الوصول إلى سجل الفواتير لآخر 90 يوماً
• ✅ تصدير Excel: تصدير البيانات بصيغة Excel
• ✅ مصدر واحد: معالجة الفواتير من المجلدات المحلية
• ✅ الإدخال اليدوي: إدخال بيانات الفواتير يدوياً بدون حدود
• ✅ قراءة رموز QR: قراءة رموز QR للفواتير السعودية والمصرية

القيود في النسخة المجانية:

• ❌ التكامل مع Telegram: غير متاح
• ❌ التكامل مع البريد الإلكتروني: غير متاح
• ❌ مزامنة Odoo: غير متاح
• ❌ مزامنة Wafeq: غير متاح
• ❌ نماذج الذكاء الاصطناعي المحلية: Ollama غير متاح
• ❌ تصدير PDF/CSV: غير متاح
• ❌ معالجة دفعات كبيرة: حد أقصى 5 فواتير لكل دفعة

إعادة تعيين الحد اليومي:

• 🔄 يتم إعادة تعيين حد الـ 10 فواتير يومياً في منتصف الليل
• 📊 يمكنك مراقبة استخدامك اليومي من شريط العنوان
• ⏰ سيظهر لك تنبيه عند الاقتراب من الحد اليومي

النسخة المميزة 💎

احصل على تجربة كاملة بدون أي قيود مع النسخة المميزة.

مميزات النسخة المميزة:

• ✅ فواتير غير محدودة: معالجة عدد غير محدود من الفواتير
• ✅ دفعات غير محدودة: بدون حد على حجم الدفعة
• ✅ سجل كامل: الوصول إلى جميع الفواتير بدون حد زمني
• ✅ All export formats: PDF، Excel، CSV، JSON
• ✅ تكامل Telegram: استقبال الفواتير عبر Telegram
• ✅ تكامل البريد الإلكتروني: استقبال الفواتير عبر البريد
• ✅ مزامنة Odoo: مزامنة تلقائية مع نظام Odoo
• ✅ مزامنة Wafeq: مزامنة تلقائية مع نظام Wafeq
• ✅ نماذج AI محلية: استخدام Ollama للخصوصية الكاملة
• ✅ دعم فني مميز: أولوية في الدعم الفني
• ✅ تحديثات مبكرة: الوصول المبكر للميزات الجديدة

مقارنة الخطط:

الميزة	تجريبي	مجاني	مميز
عدد الفواتير	100 إجمالي	10/يوم	غير محدود
حجم الدفعة	غير محدود	5 فواتير	غير محدود
Invoices History	كامل	90 يوم	كامل
تصدير PDF	✅	❌	✅
تصدير Excel/CSV	✅	Excel فقط	✅
تكامل Telegram	✅	❌	✅
تكامل البريد	✅	❌	✅
مزامنة Odoo	✅	❌	✅
مزامنة Wafeq	✅	❌	✅
Ollama (AI محلي)	✅	❌	✅
الإدخال اليدوي	✅	✅	✅
قراءة QR	✅	✅	✅
الدعم الفني	عادي	عادي	مميز

كيفية الترقية 📈

الترقية من التجريبي/المجاني إلى المميز:

1. عند الوصول للحد:
   • سيظهر لك تنبيه عند الوصول لحد الاستخدام
   • انقر على “الترقية الآن” في التنبيه
2. من القائمة الرئيسية:
   • افتح قائمة “مساعدة” > “التسجيل والترخيص”
   • انقر على “الترقية إلى النسخة المميزة”
3. إدخال مفتاح الترخيص:
   • أدخل مفتاح الترخيص الذي حصلت عليه
   • انقر على “تفعيل”
   • سيتم التحقق من المفتاح وتفعيل النسخة المميزة
4. التأكيد:
   • ستظهر رسالة تأكيد التفعيل
   • سيتم تحديث شريط العنوان ليعرض “مسجل”
   • جميع المميزات المميزة متاحة الآن

الحصول على مفتاح الترخيص:

للحصول على مفتاح ترخيص النسخة المميزة، يرجى التواصل معنا:

• 📧 البريد الإلكتروني: mohammednabarawy@gmail.com
• � البريد الإلكتروني: info@invoicesreader.com
• 📱 واتساب: +20 1211418606
• 🌐 الموقع: invoicesreader.com

التحقق من حالة الترخيص:

يمكنك التحقق من حالة ترخيصك في أي وقت:

• شريط العنوان: يعرض حالة الترخيص الحالية
  • “تجريبي – X استخدامات متبقية”
  • “مجاني – X/10 فواتير اليوم”
  • “مسجل” (نسخة مميزة)
• قائمة المساعدة: افتح “مساعدة” > “حول” لرؤية تفاصيل الترخيص

نصائح للاستفادة القصوى:

للمستخدمين التجريبيين:

• 💡 استخدم الفترة التجريبية لاختبار جميع الميزات
• 💡 جرب التكامل مع الأنظمة المحاسبية
• 💡 اختبر نماذج الذكاء الاصطناعي المختلفة

للمستخدمين المجانيين:

• 💡 خطط لمعالجة الفواتير يومياً (10 فواتير/يوم)
• 💡 استخدم الإدخال اليدوي للفواتير البسيطة
• 💡 استفد من قراءة رموز QR المجانية

للمستخدمين المميزين:

💡 استخدم Ollama للخصوصية الكاملة

💡 استخدم التكامل التلقائي مع Telegram والبريد

💡 قم بإعداد المزامنة التلقائية مع نظامك المحاسبي