وثائق مطور التطبيق

عقد HTTP لتطبيق العميل والملتقط والسائق.

1. الواجهة العامة — تطبيق العميل (http://localhost:5000، البادئة /v1)
2. واجهة الملتقط — واجهة الإدارة (http://localhost:5001، /v1/fulfillment/picker/*)
3. واجهة السائق — واجهة الإدارة (/v1/fulfillment/driver/*)

إدارة الكتالوج في لوحة التحكم خارج النطاق. واجهات OpenAPI الحية (جرّب الطلبات بـ Bearer):

• العامة: http://localhost:5000/docs
• الإدارة: http://localhost:5001/docs

أي واجهة تستدعي

التطبيق	عنوان الأساس (تطوير)	المصادقة
العميل	http://localhost:5000	Authorization: Bearer <accessToken>
الملتقط	http://localhost:5001	JWT موظف Bearer + orders:read / orders:update
السائق	http://localhost:5001	نفس JWT الموظف؛ وجّه الواجهة عندما roleKey هو driver

لا ترسل حركة الملتقط أو السائق إلى الواجهة العامة. مسارات التجهيز غير مركّبة هناك.

اقرأ بهذا الترتيب

1. البدء
2. الاتفاقيات
3. مصادقة العميل أو دخول الموظف في الملتقط / السائق
4. صفحات المجالات: الكتالوج، السلة، الطلبات، الحساب، الإشعارات، الدعم، المساعد

قيود صادقة

• احفظ accessToken وrefreshToken (SecureStore). أرسل Bearer مع كل طلب مصادق. عند 401 حدّث مرة ثم أرسل المستخدم للدخول.
• طرق الدفع عند إنشاء الطلب: cod | wallet فقط.
• إرسال OTP عبر SMS تجريبي في التطوير.
• لا WebSocket للتجهيز — استطلع HTTP.