Zarvice

User guide

دليل عملي لـ Zarvice: الهدف، طريقة العمل لكل تطبيق، الميزات، والمحددات. النسخة النصية الكاملة أيضًا في المستودع: docs/USER_GUIDE_AR.md

1. الهدف من النظام

Zarvice منصة وساطة لصيانة العقارات في ولاية ميشيغان بالولايات المتحدة. تربط العميل الذي يحتاج صيانة مع مزوّد مناسب، بينما تدير لوحة الإدارة العمليات والطلبات والمقاولين.

  1. العميل يقدّم طلب صيانة.
  2. النظام يطابق الطلب مع مزوّدين حسب الخدمة والمنطقة.
  3. التواصل يتم داخل التطبيق (شات).
  4. تنفيذ العمل ثم التقييم بعد الإكمال.

2. التطبيقات الثلاثة

التطبيقالرابطلمن؟
العميل/clientطالبو خدمة الصيانة
المزوّد/contractorالمقاولون والموردون
الإدارة/dashboardمشغّل المنصة

من الصفحة الرئيسية اختر التطبيق المناسب. تتوفر أيضًا ملفات أندرويد (APK) وملفات iOS للشاشة الرئيسية لكل دور.

3. تطبيق العميل — كيف يعمل؟

الدخول

  • رقم هاتف أمريكي، أو رقم اختبار من 1 إلى 100.
  • لا توجد كلمة مرور — الهاتف هو اسم المستخدم.
  • يمكن الدخول عبر Google.

طلب خدمة

  • الاسم، الهاتف، موقع ميشيغان، العنوان، الخدمات، الوصف.
  • اختياري: ميزانية، صورة، بريد.
  • الحالة تبدأ بـ «قيد الانتظار» ثم معيّن / قيد التنفيذ / مكتمل أو ملغى.

المتابعة والشات

  • تبويبات: الرئيسية، الطلبات، الأعمال، المزوّدون، الملف.
  • التواصل مع المزوّد عبر الشات داخل التطبيق فقط.
  • هواتف المزوّدين مخفية؛ التقييم بعد اكتمال العمل.

4. تطبيق المزوّد — كيف يعمل؟

  • دخول برقم الهاتف أو Google (نفس أسلوب العميل).
  • أكمل الملف: فردي/شركة، التخصص، الخدمات، الرخصة/التأمين.
  • حدّد منطقة التغطية داخل مقاطعات ومدن ميشيغان.
  • استقبل الطلبات المطابقة، راسل العميل، ثم اقبل الطلب لتعيينك حصريًا.
  • إدارة الأعمال: معيّن، قيد التنفيذ، مكتمل، ملغى — مع إمكانية التحرير أو الإلغاء حسب الحالة.
  • هاتف العميل والعنوان الكامل غير ظاهرين للتواصل الخارجي.

5. تطبيق الإدارة — كيف يعمل؟

  • الدخول من /manage بالبريد المسموح وكلمة المرور فقط (بدون Google — الحقول فارغة، أدخلها يدوياً).
  • أقسام اللوحة: Pipeline، تطبيق العميل، العملاء، المقاولون، الطلبات، الأعمال، الملاحظات، البلاغات، استيراد العملاء المحتملين.
  • حساب مشغّل واحد — ليست أدوار متعددة لفريق كبير.
  • SMS عبر Twilio عند الإعداد؛ وإلا وضع تجريبي بدون إرسال حقيقي.

6. الميزات

  • ثلاث تطبيقات معزولة: عميل / مزوّد / إدارة.
  • لغات متعددة بما فيها العربية (واجهة من اليمين لليسار).
  • تسجيل دخول Google لبوابتي العميل والمزوّد فقط (الإدارة بكلمة المرور).
  • أرقام اختبار 1–100 للتطوير.
  • تحديث أندرويد داخل التطبيق بدون حذف.
  • إشعارات داخل التطبيق وعلى نظام أندرويد في الـ APK.
  • خصوصية التواصل: إخفاء الهواتف ومنع تسريبها في الشات.
  • صفحات قانونية: الخصوصية، الشروط، التحكيم، الدعم، التوظيف.

7. المحددات والقيود

  1. الجغرافيا: التركيز على ميشيغان؛ الاستيراد يرفض الرموز البريدية خارج الولاية.
  2. التوزيع: التثبيت الأساسي عبر APK من الموقع (وليس متجر Play كقناة رئيسية). على iPhone ملف إعداد للشاشة الرئيسية.
  3. أندرويد: يلزم إذن «تثبيت من هذا المصدر» لتحديثات Zarvice.
  4. دخول العميل/المزوّد: بدون OTP حاليًا — يعتمد على رقم الهاتف.
  5. الإدارة: مشغّل واحد.
  6. SMS: الإرسال الحقيقي يحتاج Twilio.
  7. أجهزة قديمة: قد تحتاج تحديث WebView/Chrome لتجنب الشاشة البيضاء.
  8. لا تواصل خارجي بين الطرفين: الهاتف والبريد مخفيان عن قصد.