انتقل إلى المحتوى
TAQNIX
وحدات Odooإضافات ووردبريسقوالب ووردبريسقوالب Shopifyقوالب التطبيقاتالسكربتات والأدواتالمدونةبِع على TAQNIX

توثيق تطبيق متجر أودو للجوال

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

يشرح الإصدار 1.0.0حُدّث في 24 أكتوبر 2026

عن تطبيق متجر أودو للجوالتنزيل ملف PDF(PDF، 4.6 MB)

ابدأ من هنا

ببساطة: تمنحك هذه الحزمة تطبيق تسوّق كاملًا للآيفون والأندرويد يبيع ما في متجر موقع أودو لديك. وهو من جزأين يعملان معًا: وحدة أودو (taqnix_ecommerce_app) تثبّتها على خادم أودو، والشيفرة المصدرية بـ Flutter للتطبيق الذي تبنيه وتنشره باسمك. تقرر الوحدة شكل التطبيق (الشعار والألوان والصفحة الرئيسية بلافتاتها ومنزلقاتها) وطرق الدفع وتسجيل الدخول التي يعرضها والإشعارات التي يرسلها؛ أما المنتجات والأسعار والمخزون والعملاء والطلبات والمدفوعات فهي من أودو الخاص بك.
التطبيق على الهاتف وإعداداته في أودو.
التطبيق على الهاتف وإعداداته في أودو.
نصيحة: تغيير تصميم الصفحة الرئيسية أو الألوان أو طرق الدفع في أودو يسري على كل تطبيق مثبّت عند فتحه في المرة التالية. لا تنشر إصدارًا جديدًا من التطبيق إلا لتغيير شيفرته أو اسمه أو أيقونته.

محتويات الحزمة

البندما هو
taqnix_ecommerce_app.zipوحدة أودو 19: واجهة التطبيق، والهوية، ومصمم الصفحة الرئيسية، والدفع، وتسجيل الدخول، والإشعارات، وترجمة عربية.
flutter-app-source.zipمشروع Flutter للتطبيق (أندرويد وiOS) مع سكربت الإعداد tools/setup.dart وملف README واختباراته.
documentation/هذا الدليل بالإنجليزية (index.html) والعربية (index-ar.html) مع ملفات PDF.
licensing/الرخصة (OPL-1: شراء واحد = متجر واحد وعلامة تطبيق واحدة مع التحديثات).
preview-images/لقطات من التطبيق ومن إعدادات أودو.
changelog.txtسجل الإصدارات.

كيف يعمل

الجزءأين يعملماذا يفعل
وحدة أودوخادم أودو لديكتجيب التطبيق على https://your-shop/mo-app/v1/...: الكتالوج والسلة والدفع والطلبات والحسابات وتخطيط الرئيسية والهوية.
تطبيق Flutterهواتف عملائكيعرض المتجر ويحتفظ بالسلة ويسجّل دخول العملاء ويفتح صفحة الدفع.
صفحة الدفع في موقع أودوداخل التطبيق (عرض ويب)تأخذ الدفع بمزوّد الدفع الذي أعددته في أودو (بطاقات ومحافظ وبوابات محلية) وتؤكد الطلب.
Firebase (اختياري)Googleيوصل الإشعارات الفورية إلى الهواتف.
نصيحة: لا يتصل التطبيق بقاعدة البيانات مباشرة ولا يحتوي أي سر: تبقى مفاتيح مزوّدي الدفع في أودو، ويبقى مفتاح إرسال الإشعارات على الخادم.

ما تحتاج إليه

البندالتفاصيل
أودوالإصدار 19.0 Community أو Enterprise مع تطبيقات الموقع والتجارة الإلكترونية والخصومات والولاء (تُثبَّت تلقائيًا مع الوحدة).
العنوانعنوان https عام لأودو (مثل https://shop.example.com): يجب أن تصل الهواتف إليه. الشهادة الموقّعة ذاتيًا لا تعمل على الهواتف.
متجركمنتجات منشورة بأسعار وطريقة توصيل واحدة على الأقل ومزوّد دفع واحد على الأقل (أو الدفع عند الاستلام).
حاسوب لبناء التطبيقجهاز Mac لبناء تطبيقي الآيفون والأندرويد (ويندوز أو لينكس يبنيان الأندرويد فقط) بمساحة حرة نحو 30 غيغابايت.
أدوات المطوّرFlutter 3.41 أو أحدث وAndroid Studio وXcode (الإصدار الحالي) مع CocoaPods لـ iOS.
حسابات المتاجرGoogle Play Console (رسم لمرة واحدة) وبرنامج Apple Developer (رسم سنوي) للنشر.
اختياريمشروع Firebase (مجاني) للإشعارات؛ وإعدادات Google وFacebook وApple لتسجيل الدخول الاجتماعي.

ثبّت وحدة أودو

  1. فُكّ ضغط الحزمة. بداخلها taqnix_ecommerce_app.zip؛ فُكّه لتحصل على المجلد taqnix_ecommerce_app.
  2. انسخ المجلد إلى أحد مجلدات addons_path في خادم أودو وأعد تشغيل أودو.
  3. سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
  4. أزل مرشح «التطبيقات» وابحث عن eCommerce Mobile App Connector واضغط تثبيت.
# or from the command line
./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_ecommerce_app --stop-after-init
نصيحة: تثبّت الوحدة تبعيات التجارة الإلكترونية في أودو التي تحتاج إليها. في Odoo.sh أو أودو المستضاف، ارفع المجلد عبر مستودع Git أو لوحة الاستضافة ثم حدّث قائمة التطبيقات.
ببساطة: بعد التثبيت يظهر تطبيق جديد باسم تطبيق الجوال في القائمة الرئيسية (للمسؤولين ولمستخدمي مجموعة تطبيق الجوال: مدير).

جهّز متجرك

ببساطة: يعرض التطبيق ما يعرضه موقع أودو، فجهّز المتجر أولًا كما تفعل للموقع.
ماذاأين في أودوملاحظات
المنتجاتالموقع ← التجارة الإلكترونية ← المنتجاتانشرها وأضف السعر والصور والأصناف والمتغيّرات (ألوان ومقاسات) والمخزون إن كنت تتابعه.
الأصنافالموقع ← التجارة الإلكترونية ← أصناف التجارة الإلكترونيةأصناف المتجر (مع صورها) هي أصناف منزلق الأصناف والمرشحات.
طرق التوصيلالموقع ← الإعدادات ← طرق الشحنانشر واحدة على الأقل. يعرض التطبيق ما ينطبق على العنوان وسعره.
الضرائب والعملةإعدادات المحاسبة والموقعتُعرض الأسعار بالضريبة أو بدونها كما في موقعك (الموقع ← الإعدادات ← الأسعار).
رموز الخصمالموقع ← التجارة الإلكترونية ← العروضتعمل رموز العروض والقسائم في سلة التطبيق.
اللغاتالموقع ← الإعدادات ← اللغاتأضف لغات عملائك (مثل العربية)؛ تتبع المنتجات والأصناف والرسائل لغة الهاتف.
نصيحة: افتح موقعك على الهاتف أولًا: ما ليس على الموقع ليس في التطبيق.

أعطِ التطبيق هويتك

ببساطة: افتح تطبيق الجوال ← الإعدادات. يحوي تبويب الهوية الاسم والشعار (يظهر في شاشة البداية وشاشات الدخول والقائمة) وأيقونة التطبيق الاختيارية والألوان ومظهر الأزرار والزوايا والقائمة الجانبية. يقرأ التطبيق كل ما تغيّره هنا عند بدء تشغيله.
تبويب الهوية: الاسم والشعار والألوان والنمط.
تبويب الهوية: الاسم والشعار والألوان والنمط.
النتيجة في التطبيق.
النتيجة في التطبيق.
الإعدادالأثر
الشعارالأفضل PNG مربعة 1024 × 1024. وتصنع الصورة نفسها أيقونة التطبيق ما لم تضف أيقونة تطبيق.
اللون الأساسي والثانوي والتمييزالأزرار والروابط والعناصر المحددة وإبراز الأسعار والشريط العلوي حين يكون نمطه اللون الأساسي.
خلفية شاشة البدايةاللون خلف الشعار أثناء تحميل التطبيق.
النمط والأزرارMaterial 3 ومدى نعومة الأسطح أو تباينها واستدارة الزوايا وأزرار ممتلئة أو محددة بإطار أو بارزة.
اتجاه التخطيطحسب اللغة (من اليمين إلى اليسار للعربية والعبرية) أو إجبار اليسار إلى اليمين أو اليمين إلى اليسار.
القائمة الجانبيةإظهارها أو إخفاؤها؛ وخلفية بلون أو تدرج أو صورة.

صمّم الصفحة الرئيسية

ببساطة: تسرد تطبيق الجوال ← تخطيطات الرئيسية التخطيطات. التخطيط هو رصّة من الكتل من الأعلى إلى الأسفل؛ ويُعرض التخطيط الموسوم في التطبيق. يمكنك الاحتفاظ بعدة تخطيطات (مثل واحد للتخفيضات) والتبديل بـ عرض في التطبيق.
تخطيط: كتله وشريطه العلوي وصفحته.
تخطيط: كتله وشريطه العلوي وصفحته.
الكتلةما تعرضهالخيارات الرئيسية
اللافتاتمنزلق أو تمرير جانبي أو شبكة أو بطاقات (كتل لافتات) من الصور.تفتح كل لافتة عند النقر لا شيء أو منتجًا أو صنفًا أو بحثًا أو صفحة ويب؛ تشغيل تلقائي ونقاط وعدّاد وملاءمة الصورة.
المنتجاتمنزلق أو شبكة أو قائمة أو تمرير جانبي للمنتجات.الأحدث أو من صنف أو الأكثر مبيعًا أو الأعلى تقييمًا أو المخفضة أو المحددة يدويًا؛ والعدد؛ وعدّاد لتخفيض خاطف.
الأصنافالأصناف أيقونات دائرية أو شبكة أو منزلقًا أو قائمة.كل الأصناف العليا أو الأصناف الفرعية لصنف؛ والأحجام.
كتلة لافتات: الصور وما تفتحه كل واحدة.
كتلة لافتات: الصور وما تفتحه كل واحدة.
كتلة منتجات: المصدر والتخطيط والعدّاد.
كتلة منتجات: المصدر والتخطيط والعدّاد.
اللافتات والأصناف والوصول الجديد وتخفيض خاطف في التطبيق.
اللافتات والأصناف والوصول الجديد وتخفيض خاطف في التطبيق.
ببساطة: يحدد تبويب الشريط العلوي العنوان أو الشعار ومربع البحث والألوان وسلوك الشريط عند التمرير؛ ويحدد تبويب الصفحة لون الصفحة والسحب للتحديث. يفتح معاينة البيانات التي يستقبلها التطبيق البيانات نفسها التي تصل الهواتف.
الشريط العلوي للصفحة الرئيسية.
الشريط العلوي للصفحة الرئيسية.
نصيحة: العناوين والأوصاف ونصوص اللافتات تُترجم لكل لغة كأي نص في أودو: بدّل لغة مستخدمك وعدّل.

استقبل المدفوعات

ببساطة: يعرض التطبيق الدفع عند الاستلام (يُؤكد الطلب فورًا) وكل مزوّد دفع إلكتروني مفعّل ومنشور في أودو. وفي الدفع الإلكتروني يرى العميل صفحة الدفع لموقعك داخل التطبيق ويدفع بالمزوّد ثم يعود إلى التأكيد.
إعدادات الدفع في التطبيق.
إعدادات الدفع في التطبيق.
  1. في أودو افتح الموقع ← الإعدادات ← مزوّدو الدفع (أو المحاسبة ← الإعدادات ← مزوّدو الدفع).
  2. اختر مزوّدًا (Stripe أو PayPal أو Adyen أو Razorpay أو Mollie أو Paymob أو Flutterwave أو Authorize.Net أو Worldline أو Mercado Pago أو Xendit وغيرها) وأدخل المفاتيح التي يعطيك إياها واجعل الحالة اختبار أولًا ثم مفعّل.
  3. فعّل منشور واختر طرق الدفع والدول والعملات التي يقبلها.
  4. في تطبيق الجوال ← الإعدادات ← المدفوعات اترك طرق الدفع عبر الإنترنت فارغة لعرضها كلها، أو اختر ما يعرضه التطبيق.
  5. قدّم طلبًا تجريبيًا من التطبيق وتحقق من الدفع في تطبيق الجوال ← طلبات التطبيق.
إتمام الشراء: العنوان وطريقة الشحن وطريقة الدفع والإجماليات.
إتمام الشراء: العنوان وطريقة الشحن وطريقة الدفع والإجماليات.
مهم: لكل مزوّد قواعده (العملات والدول المقبولة والتحقق الثلاثي ونقاط الاستدعاء). اتبع توثيق أودو للمزوّد واختبر في وضع الاختبار قبل التشغيل الفعلي. التحويل المصرفي يعمل أيضًا: يُؤكد الطلب مع تعليمات الدفع.

تسجيل الدخول وإنشاء الحساب

ببساطة: يستطيع العملاء إنشاء حساب وتسجيل الدخول بالبريد وكلمة المرور أو المتابعة كزائر (إن سمحت) أو استخدام Google وFacebook وApple. يتحقق الخادم من كل رمز تسجيل دخول اجتماعي لدى المزوّد ويقبل فقط الرموز الصادرة لمعرّفات تطبيقك. ولا يستطيع مستخدمو أودو الموظفون تسجيل الدخول إلى التطبيق أبدًا.
إعدادات تسجيل الدخول.
إعدادات تسجيل الدخول.
الطريقةما تُعدّهأين
Googleمشروع Google Cloud وشاشة موافقة OAuth ومعرّفات عميل OAuth: ويب (يستخدمه الأندرويد أيضًا) وأندرويد (اسم الحزمة وSHA-1) وiOS (معرّف الحزمة). الصق معرّفي الويب وiOS في معرّفات عميل Google.console.cloud.google.com ← APIs & Services ← Credentials
Facebookتطبيق Facebook مع Facebook Login؛ انسخ معرّف التطبيق إلى أودو، والمعرّف ورمز العميل إلى التطبيق (انظر README التطبيق).developers.facebook.com
Appleمعرّف تطبيق مع إمكانية Sign in with Apple؛ الصق معرّف الحزمة في معرّفات عميل Apple. تشترطه Apple حين يعرض التطبيق تسجيل دخول اجتماعيًا آخر.developer.apple.com ← Certificates, IDs & Profiles
نصيحة: إعدادات كل مزوّد في التطبيق (مخططات URL ومعرّفات العميل والاستحقاقات) مذكورة خطوة بخطوة في docs/native-setup.md داخل مجلد التطبيق.
ببساطة: يرسل نسيت كلمة المرور رسالة إعادة التعيين القياسية في أودو. وحذف حسابي داخل التطبيق (تشترطه Apple) يعطّل الحساب ويزيل البيانات الشخصية؛ وتبقى الطلبات لمحاسبتك.

الإشعارات الفورية (اختياري)

ببساطة: يستطيع التطبيق إخبار العملاء حين يُقدَّم طلب أو تتغيّر حالته (ملغى أو مُسلَّم جزئيًا أو كليًا)، ويمكنك إرسال رسالة إلى كل الأجهزة. يستخدم Firebase Cloud Messaging وهو مجاني.
إعدادات الإشعارات والرسائل.
إعدادات الإشعارات والرسائل.
  1. أنشئ مشروعًا في console.firebase.google.com وأضف تطبيق أندرويد (باسم حزمتك) وتطبيق iOS (بمعرّف حزمتك).
  2. في أودو، تطبيق الجوال ← الإعدادات ← الإشعارات، انسخ معرّف المشروع ومعرّفي تطبيقي أندرويد وiOS ومفتاح API ومعرّف المرسل (إعدادات المشروع ← عام).
  3. في Firebase افتح إعدادات المشروع ← حسابات الخدمة ← إنشاء مفتاح خاص جديد والصق كامل ملف JSON في ملف JSON لحساب الخدمة في أودو. يبقى على الخادم.
  4. للآيفون، ارفع مفتاح مصادقة APNs في Firebase (إعدادات المشروع ← Cloud Messaging) وفعّل Push Notifications لمعرّف التطبيق لدى Apple.
  5. يسمح العملاء بالإشعارات عند أول تسجيل دخول. استخدم تطبيق الجوال ← إرسال إشعار لرسالة إلى كل الأجهزة أو إلى عملاء محددين.
إرسال رسالة إلى الأجهزة.
إرسال رسالة إلى الأجهزة.
نصيحة: يمكن لنصوص إشعارات الطلبات استخدام {first_name} و{order_name} و{order_status} و{total}.

جهّز حاسوبك

  1. ثبّت Flutter من flutter.dev (الإصدار 3.41 أو أحدث) ونفّذ flutter doctor وأصلح ما يبلغ عنه.
  2. أندرويد: ثبّت Android Studio وافتحه مرة وثبّت Android SDK واقبل التراخيص بـ flutter doctor --android-licenses.
  3. آيفون (على Mac فقط): ثبّت Xcode من App Store وافتحه مرة لقبول الرخصة وثبّت أدوات سطر الأوامر (xcode-select --install) وCocoaPods (sudo gem install cocoapods أو brew install cocoapods).
  4. فُكّ ضغط flutter-app-source.zip في مجلد بلا مسافات ثم نفّذ flutter pub get داخله.
نصيحة: يجب ألا يُظهر flutter doctor علامة حمراء للمنصات التي تبني لها.

اربط التطبيق بمتجرك

ببساطة: يكتب سكربت الإعداد عنوان متجرك واسم حزمتك في المشروع ويأخذ اسم التطبيق وألوانه من أودو وينزّل شعارك وأيقونتك.
يعرض تبويب ربط التطبيق الأمر بعنوانك.
يعرض تبويب ربط التطبيق الأمر بعنوانك.
dart run tools/setup.dart --url https://shop.example.com --package com.yourcompany.shop

flutter pub get
dart run flutter_launcher_icons
dart run flutter_native_splash:create
الخيارالمعنى
--urlعنوان https لموقع أودو (بلا شرطة مائلة في النهاية).
--packageالمعرّف الفريد لتطبيقك مثل com.yourcompany.shop. لا يمكن تغييره بعد النشر.
--nameاختياري. الاسم تحت الأيقونة؛ وافتراضيًا الاسم المضبوط في أودو.
نصيحة: يمكنك أيضًا تمرير العنوان عند التشغيل أو البناء: flutter run --dart-define=SITE_URL=https://shop.example.com.

شغّل التطبيق واختبره

  1. شغّل محاكي أندرويد أو محاكي آيفون أو وصّل هاتفك.
  2. نفّذ flutter run (أضف --dart-define=SITE_URL=... إن لم تستخدم سكربت الإعداد).
  3. جرّب: الرئيسية وصنفًا والبحث والمرشحات ومنتجًا بخيارات والسلة وقسيمة وإتمام الشراء بالدفع عند الاستلام وبمزوّد إلكتروني في وضع الاختبار والطلبات وقائمة الرغبات وتسجيل الدخول وإنشاء الحساب.
  4. في أودو تحقق من تطبيق الجوال ← طلبات التطبيق والأجهزة.
صفحة منتج بخيارات ومخزون وتقييمات.
صفحة منتج بخيارات ومخزون وتقييمات.
السلة مع رمز عرض.
السلة مع رمز عرض.
نصيحة: لاختبار أودو على حاسوبك عبر http، شغّل نسخة التطوير (تسمح بـ http؛ أما نسخ الإصدار فتسمح بـ https فقط).

ابنِ تطبيق أندرويد وانشره

  1. أنشئ مفتاح التوقيع مرة واحدة واحتفظ به بأمان (بدونه لا يمكنك تحديث التطبيق أبدًا): keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload.
  2. أنشئ android/key.properties فيه storePassword وkeyPassword وkeyAlias=upload وstoreFile (مسار المفتاح). يعرض README التطبيق الأسطر بدقة.
  3. ابنِ: flutter build appbundle --release --dart-define=SITE_URL=https://shop.example.com. الملف هو build/app/outputs/bundle/release/app-release.aab.
  4. في Google Play Console أنشئ التطبيق واملأ صفحة المتجر (الاسم والوصف وأيقونة 512 × 512 وصورة الميزة 1024 × 500 ولقطات الهاتف) ونموذج أمان البيانات وتصنيف المحتوى ورابط سياسة الخصوصية.
  5. ارفع ملف .aab إلى مسار اختبار أولًا. على حسابات المطوّرين الشخصية الجديدة إجراء اختبار مغلق بـ 12 مختبرًا على الأقل لمدة 14 يومًا قبل طلب الإنتاج؛ وحسابات المؤسسات لا تحتاج ذلك.
  6. أرسل الإصدار للمراجعة ثم انشر.
مهم: استخدم اسم الحزمة نفسه ومفتاح التوقيع نفسه في كل تحديث.

ابنِ تطبيق الآيفون وانشره

  1. في developer.apple.com أنشئ App ID بمعرّف حزمتك والإمكانات التي تستخدمها: Sign in with Apple وPush Notifications.
  2. في App Store Connect أنشئ التطبيق بمعرّف الحزمة نفسه.
  3. افتح ios/Runner.xcworkspace في Xcode واختر هدف Runner ← Signing & Capabilities واختر فريقك وفعّل Automatically manage signing.
  4. ابنِ: flutter build ipa --release --dart-define=SITE_URL=https://shop.example.com ثم ارفع بـ Xcode (Window ← Organizer ← Distribute App) أو تطبيق Transporter.
  5. في TestFlight اختبر الإصدار، ثم في App Store Connect املأ الصفحة واللقطات وتفاصيل الخصوصية ومعلومات المراجعة وقدّم للمراجعة.
قائمة مراجعة Appleهل يفعلها التطبيق؟
حذف الحساب داخل التطبيقنعم (الحساب ← حذف حسابي)
Sign in with Apple بجانب تسجيلات الدخول الاجتماعية الأخرىنعم (فعّله في أودو)
روابط سياسة الخصوصية والشروطاضبطها في أودو ← الإعدادات ← روابط
حساب تجريبي للمراجعأنشئ عميلًا في أودو واكتبه في ملاحظات المراجعة
الدفع لسلع مادية ببوابتكمسموح: يبيع التطبيق سلعًا مادية لا محتوى رقميًا

العمل اليومي

ببساطة: اعمل كما تعمل للموقع. تسرد تطبيق الجوال ← طلبات التطبيق الطلبات المقدّمة من التطبيق مع طريقة الدفع وموقع التوصيل الذي شاركه العميل؛ أكّدها وسلّمها وفوتِرها كالعادة. تعرض الأجهزة الهواتف المسجّلة؛ وتسجيل خروج كل الأجهزة في تبويب الربط يجبر الجميع على تسجيل الدخول من جديد.
الطلبات المقدّمة من التطبيق.
الطلبات المقدّمة من التطبيق.
طلب بتفاصيل التطبيق.
طلب بتفاصيل التطبيق.
نصيحة: وضع الصيانة (الإعدادات ← روابط) يعرض رسالتك بدل المتجر؛ وأقل إصدار للتطبيق يطلب من التطبيقات القديمة أن تتحدّث.

اللغات والاتجاه من اليمين إلى اليسار

ببساطة: يتبع التطبيق لغة الهاتف (الإنجليزية والعربية مضمّنتان؛ ويصبح التخطيط من اليمين إلى اليسار للعربية). تأتي المنتجات والأصناف واللافتات وأسماء الدفع والشحن ورسائل الخادم من أودو باللغة نفسها. والإدارة مترجمة أيضًا.
الرئيسية بالعربية.
الرئيسية بالعربية.
إتمام الشراء بالعربية.
إتمام الشراء بالعربية.
الإعدادات في أودو بالعربية.
الإعدادات في أودو بالعربية.
نصيحة: لإضافة لغة أخرى للتطبيق انسخ lib/l10n/app_en.arb إلى app_xx.arb وترجمه؛ انظر README التطبيق.

التحديثات

استبدل مجلد الوحدة بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_ecommerce_app؛ تبقى إعداداتك وتخطيطاتك وأجهزتك. أما التطبيق فافتح المصدر الجديد بجوار مشروعك واحتفظ بـ android/key.properties ومفتاح التوقيع، ثم شغّل سكربت الإعداد من جديد (فهو يعيد كتابة عنوان المتجر واسم الحزمة والهوية) وابنِ. اجعل رقم البناء أعلى من المنشور (version: في pubspec.yaml).

الأمان والخصوصية

الموضوعكيف يُعالج
الأسرارتبقى مفاتيح المزوّدين ومفتاح الإشعارات في أودو. ولا يحتوي التطبيق إلا معرّفات عامة.
الجلساتيحمل الهاتف المسجّل رمزًا عشوائيًا ولا يخزّن أودو إلا بصمته. تُزال رموز الأجهزة غير المستخدمة لسنة. وتلغيها عمليتا الخروج وحذف الحساب.
تسجيل الدخول الاجتماعيتُتحقق الرموز لدى Google وFacebook وApple على الخادم، بما في ذلك معرّف التطبيق الذي صدرت له.
حسابات الموظفينلا يستطيع مستخدمو أودو ذوو الوصول الداخلي تسجيل الدخول إلى التطبيق.
المدفوعاتيتولاها مزوّدك في صفحة الدفع للموقع؛ ولا يرى التطبيق بيانات البطاقة. رابط الدفع موقّع وينتهي بعد ساعة.
الطلبات والعناوينيرى العميل طلباته وعناوينه فقط؛ ويرى الزائر الطلب الذي قدّمه من التطبيق نفسه فقط.
التقييماتلا يكتبها إلا العملاء المسجّلون.
الخصوصيةحذف الحساب يجعل العميل مجهول الهوية. اكتب سياسة الخصوصية (تطلبها المتاجر) واربطها في الإعدادات.
نصيحة: احمِ إنشاء الحسابات من الروبوتات بأدواتك المعتادة (حدود معدل في الجدار الناري أو الوسيط العكسي) كأي عنوان أودو عام.

أمور يجب معرفتها

الحدالتفصيل
متجر واحد لكل موقعلكل موقع في أودو إعداد تطبيق واحد؛ وفي أودو متعدد المواقع إعداد لكل موقع.
أسعار المرشحاتيستخدم مرشح السعر السعر العام للمنتج قبل خصومات قوائم الأسعار.
المتغيّراتالمنتجات ذات التوليفات الكثيرة: لا يُشترى في التطبيق إلا المتغيّرات الموجودة (أنشئ المتغيّرات عند ضبط المنتج).
الدخول بالهاتفتسجيل الدخول برمز SMS غير مشمول.
المحفظة ونقاط الولاءغير مشمولة؛ أما رموز العروض والقسائم فمشمولة.
Apple Pay وGoogle Payلا تظهر أزرارهما داخل عرض ويب الدفع؛ والبطاقات وطرق إعادة التوجيه الأخرى تعمل.
بلا اتصاليحتاج التطبيق إلى اتصال؛ ويعرض رسالة ودّية عند انقطاعه.

للمطورين

ببساطة: تخطَّ هذا الفصل إن كنت تستخدم المنتج فقط.
curl https://shop.example.com/mo-app/v1/ping
# {"ok": true, "api_version": 1}
curl https://shop.example.com/mo-app/v1/homepage
curl "https://shop.example.com/mo-app/v1/products?per_page=5&orderby=price&order=asc"
curl -X POST https://shop.example.com/mo-app/v1/auth/login -H 'Content-Type: application/json' -d '{"email": "sara@example.com", "password": "..."}'
المجالنقاط النهاية تحت /mo-app/v1
التطبيقGET /ping و/homepage و/app-config و/branding/logo.png و/branding/icon.png
الكتالوجGET /categories و/products و/products/<id> و/product-attributes و/products/<id>/reviews؛ POST /write-review
السلةPOST /cart و/cart/add و/cart/update و/cart/remove و/cart/apply-coupon و/cart/remove-coupon
إتمام الشراءGET /checkout/form؛ POST /checkout/update-review و/checkout؛ GET /pay/<order> (رابط موقّع) و/orders/<id>/payment-status
الحسابPOST /auth/login و/auth/register و/auth/social-login و/auth/logout و/auth/profile و/auth/forgot-password و/auth/delete-account و/auth/fcm-token
الطلبات وغيرهاPOST /orders و/orders/<id>؛ GET/POST /addresses؛ GET/POST /wishlist و/wishlist/toggle و/wishlist/details
ببساطة: ترسل الطلبات المسجّلة Authorization: Bearer <token>؛ وسلة الزائر هي ملف الارتباط mo_cart (أو الترويسة X-Cart-Token)؛ واللغة ترويسة Accept-Language أو ?lang=. والأخطاء {code, message, data: {status}}. تستخدم شيفرة Flutter ‏Riverpod وgo_router وDio؛ وخريطة المجلدات في README التطبيق. للوحدة أكثر من 70 اختبارًا آليًا (--test-tags /taqnix_ecommerce_app) وللتطبيق اختبارات وحدة (flutter test).

استكشاف الأخطاء

المشكلةما العمل
يعرض التطبيق خطأ اتصالافتح https://your-shop/mo-app/v1/ping على الهاتف. يجب أن يجيب {"ok": true}. افحص العنوان (https وبلا شرطة في النهاية) والشهادة وأن الوحدة مثبتة في قاعدة البيانات الصحيحة.
الصفحة الرئيسية فارغةافتح تطبيق الجوال ← الإعدادات ← الصفحة الرئيسية واختر تخطيطًا؛ وأضف إليه كتلًا.
منتج غير ظاهرانشره في الموقع وافحص صنفه والموقع الذي ينتمي إليه.
لا طريقة دفع في إتمام الشراءفعّل مزوّدًا وانشره، أو شغّل الدفع عند الاستلام في الإعدادات ← المدفوعات.
صفحة الدفع تبقى فارغة أو تعود إلى السلةيجب أن يناسب عنوان التوصيل وطريقة الشحن وعملة المزوّد السلة. افتح الطلب نفسه في الموقع لترى الرسالة.
تسجيل الدخول الاجتماعي يقول رمز غير صالحمعرّف العميل في أودو لا يطابق ما بُني به التطبيق (معرّف الويب لـ Google ومعرّف الحزمة لـ Apple).
لا إشعاراتافحص معرّفات Firebase وحساب الخدمة وأن العميل سمح بالإشعارات و(للآيفون) مفتاح APNs.
التطبيق القديم لا يرى تغييرييُقرأ التخطيط والألوان والدفع عند البدء؛ أغلق التطبيق وافتحه. أما الاسم والأيقونة فيحتاجان بناءً جديدًا.

الدعم

المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.