1. ملخص تنفيذي
تطبيق جوال لإدارة أعمال براند «جانا» (ميكب وإكسسوارات)، يعمل بدون إنترنت، بواجهة عربية RTL بالكامل. يغطي دورة الأعمال كاملة: إدارة المخزون، فواتير بيع مع خصم مخزون آلي، إحصائيات مبيعات، تصدير PDF/صورة، وتخصيصات شاملة للفواتير والهوية. مبني بـ Expo SDK 57، يدعم Android وiOS والويب.
2. البنية التقنية
TypeScript 6، React 19.2 + React Native 0.86، Expo SDK 57 (expo-router)، SQLite عبر expo-sqlite (native) / AsyncStorage (web)، Context API لإدارة الحالة، Reanimated 4 للحركات، expo-print/expo-sharing/view-shot للتصدير، خط Readex Pro، ESLint + TypeScript strict.
3. المعمارية
فصل واضح للطبقات: app (الشاشات)، components، stores، database، features، theme، storage، types، utils. نمط Repositories موحد بمؤشر native/web، بتنفيذين منفصلين (SQLite / AsyncStorage) يُختاران تلقائيًا.
4. نموذج البيانات
جداول: sections، products (FK→sections)، invoices، invoice_items (FK→invoices)، app_state. ترحيل بـ PRAGMA user_version، تفعيل foreign_keys وWAL، وترحيل تلقائي من AsyncStorage القديم عند أول تشغيل.
5. قواعد الأعمال الأساسية
توازن المخزون داخل transaction واحدة (إنشاء/حذف الفاتورة).
لقطات ثابتة لبيانات المنتج وقت الفاتورة (لا تتأثر بتعديلات لاحقة).
الحقل المخفي لا يكون إجباريًا؛ يُحفظ بقيمة افتراضية آمنة.
منع تكرار أسماء الأقسام، منع حذف قسم غير فارغ، رفض خصم سالب أو أكبر من الإجمالي.
تنسيق أرقام/عربي يدوي متوافق مع كل الأجهزة.
6. الميزات الوظيفية
مخزون (أقسام/منتجات/صور/بحث)، فواتير قابلة للتخصيص مع طرق دفع متعددة، تصدير PDF وصورة، إحصائيات KPI وأفضل 5 منتجات وآخر 3 فواتير، إعدادات (وضع ليلي، هوية الفاتورة، إجبارية الحقول)، دليل استخدام تفاعلي (Coach Marks) بحفظ تقدم.
7. معالجة الكيبورد على أندرويد
حل مشاكل اختفاء الحقول خلف الكيبورد عبر hook مخصص (useInputIntoView) يزامن التمرير مع إغلاق/فتح الكيبورد لكل الحقول.
8. الجودة والبناء
tsc وexpo lint نظيفان باستمرار، React Compiler مفعّل، حماية من الإرسال المزدوج. توزيع عبر EAS Build (profile preview، حساب morsi12)، الحزمة com.jana.app، الإصدار الحالي v5.
9. توصيات مستقبلية
نسخ احتياطي/استعادة لقاعدة البيانات والصور، اختبارات آلية (Jest + RNTL) وE2E، تكوين خصم/عملة أولي، إحصائيات زمنية (يوم/شهر)، دعم تعدد اللغات مستقبلًا.
