> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# معالج الإعداد الأولي

> المعالج المكون من 4 خطوات الذي يُعرض على مالكي الحسابات الجدد تمامًا في /onboarding.

في المرة الأولى التي يسجّل فيها مالك حساب جديد الدخول، يعيد Scanova توجيهه إلى معالج من 4 خطوات في `/onboarding` قبل أن يرى لوحة التحكم الرئيسية إطلاقًا — والغرض الكامل منه هو إنشاء رمز QR واحد قبل أن يُترك لاستكشاف التطبيق بنفسه.

<Note>
  مُحفّز إعادة التوجيه في هذه الصفحة (‏`first_login`) هو لكل حساب ولا يكون صحيحًا إلا مرة واحدة، لذا لم يكن بالإمكان إعادة تفعيله مباشرة على حساب الاختبار المشترك المستخدم للتحقق من بقية مشروع التوثيق هذا — فقد أكمل ذلك الحساب تسجيل دخوله الأول منذ فترة طويلة قبل كتابة هذه الصفحة. **تم التحقق من كل خطوة أدناه مباشرة** بالانتقال مباشرة إلى `/onboarding` (لا يوجد على المسار نفسه أي قيد إضافي بخلاف كونك مسجَّل الدخول) وإكمال المسار من البداية إلى النهاية؛ فقط سلوك إعادة التوجيه التلقائي عند تسجيل الدخول الأول نفسه موثّق من الكود المصدري وليس من الملاحظة المباشرة.
</Note>

## من يرى هذا، ولماذا

بحسب منطق التوجيه الخاص بالتطبيق نفسه (‏`lib/next-path.ts`)، ينطبق المعالج فقط على **مالك حساب** جديد فعليًا — زميل يقبل دعوة مستخدم مشترك يُشغّل نفس علم `first_login` الأساسي في تسجيل دخوله الأول أيضًا، لكنه مُستثنى عمدًا، إذ يفترض المعالج صلاحيات (مثل إنشاء رمز QR) قد لا يملكها دور Viewer أو دور مقيّد آخر. الزميل المدعو حديثًا ينتقل مباشرة إلى لوحة التحكم بدلًا من ذلك.

إذا كان إكمال الملف الشخصي لا يزال معلّقًا، فذلك القيد له الأولوية — يظهر المعالج فقط بعد اكتمال ملفك الشخصي.

## الخطوة 1 — Choose

يفتح المعالج على ترحيب شخصي ("Welcome, \{name}! Let's create your first QR Code.") مع ثلاث نقاط بداية، تطابق نفس الخيارات الثلاثة المتاحة في أي مكان آخر من التطبيق (راجع [Quick Code مقابل صفحة كاملة](/ar/qr-codes/create/quick-code-vs-page)):

<Frame caption="الخطوة 1 من معالج الإعداد الأولي — اختيار نقطة بداية">
  <img src="https://mintcdn.com/scanova-api/2FTGGTqcp1qRUtvm/images/v2/onboarding/first-run-wizard/step1-choose.png?fit=max&auto=format&n=2FTGGTqcp1qRUtvm&q=85&s=fd0d71b0f36b990978ca94341d8e51e8" alt="الخطوة 1 من معالج الإعداد، Choose، تعرض العنوان 'Welcome, Docs! Let's create your first QR Code.' وثلاث بطاقات: Quick Code (‏Website URL)، وChoose a Template (موسومة Popular)، وBuild with AI (موسومة AI-Powered)" width="1440" height="900" data-path="images/v2/onboarding/first-run-wizard/step1-choose.png" />
</Frame>

* **Quick Code** — رمز QR بإجراء مباشر، مثل **Website URL**.
* **Choose a Template** (موسومة **Popular**) — تخطيط صفحة مُصمّم مسبقًا (‏Business Card، وCustom Page، والمزيد).
* **Build with AI** (موسومة **AI-Powered**) — صف ما تحتاجه ودع الذكاء الاصطناعي يولّد محتوى الصفحة.

يتتبع مؤشر تقدم أعلى الشاشة (‏**1 Choose → 2 Create → 3 Configure → 4 Design & Finish**) موقعك طوال العملية، ورابط **Visit Dashboard** أعلى اليمين يتيح لك تخطي المعالج تمامًا في أي وقت.

## الخطوة 2 — Create

اختيار نقطة بداية يفتح نموذج الإنشاء الخاص بنوعها. بالنسبة لـ **Website URL** (المسار الذي تم التحقق منه هنا)، هذا حقل واحد يطلب رابط الوجهة، مع معاينة رمز QR حية تُعرض على اليمين أثناء الكتابة:

<Frame caption="الخطوة 2 — إدخال رابط موقع ويب، مع معاينة رمز QR حية">
  <img src="https://mintcdn.com/scanova-api/2FTGGTqcp1qRUtvm/images/v2/onboarding/first-run-wizard/step2-create.png?fit=max&auto=format&n=2FTGGTqcp1qRUtvm&q=85&s=39d08acb3a164935a70f07de6bafadbe" alt="الخطوة 2 من المعالج، Create، تعرض نموذج 'Enter your website URL' بحقل إدخال بادئته https:// ولوحة معاينة رمز QR حية" width="1440" height="900" data-path="images/v2/onboarding/first-run-wizard/step2-create.png" />
</Frame>

## الخطوة 3 — Configure

بعد ذلك، سمِّ رمز QR واختر رابطه المختصر:

<Frame caption="الخطوة 3 — تسمية رمز QR وتهيئة رابطه المختصر">
  <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/onboarding/first-run-wizard/step3-configure.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=83f996279c5c85babc274f2ed9f0fd0f" alt="الخطوة 3 من المعالج، Configure، تعرض حقل QR Code name بقيمة افتراضية 'My QR Code'، ومحدد نطاق Short URL مضبوطًا على scnv.io مع مُعرّف مُولَّد تلقائيًا وخيار Customize، ومفتاح تبديل GPS location tracking، وزر Create QR Code" width="1440" height="900" data-path="images/v2/onboarding/first-run-wizard/step3-configure.png" />
</Frame>

* **QR Code name** — يُضبط افتراضيًا على "My QR Code" إذا تُرك فارغًا.
* **Short URL** — يُضبط افتراضيًا على `scnv.io` مع مُعرّف مُولَّد تلقائيًا؛ اختر **Customize** لاختيار مُعرّفك الخاص.
* **GPS location tracking** — مفتاح تبديل اختياري لجمع موقع المسح الدقيق (يتطلب إذن الزائر وقت المسح).

اختيار **Create QR Code** يعرض حالة موجزة "Generating your QR Code…"، ثم ينتقل إلى الخطوة الأخيرة.

## الخطوة 4 — Design & Finish

تؤكد الخطوة الأخيرة النجاح برسوم متحركة احتفالية من القصاصات الورقية ورمز QR النهائي القابل للمسح:

<Frame caption="الخطوة 4 — رمز QR النهائي، جاهز للاختبار أو التنزيل أو التخصيص">
  <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/onboarding/first-run-wizard/step4-design-finish.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=71d528ac836ea23c06ab8558e9447cd6" alt="الخطوة 4 من المعالج، Design and Finish، تعرض رسومًا متحركة من القصاصات الورقية، والعنوان 'Congratulations, [name]! Your QR Code is ready.'، ومحدد تصميم اختياري، وصورة رمز QR حقيقية، وزرَّي Test your QR وDownload QR، وزر Continue to plans" width="1440" height="900" data-path="images/v2/onboarding/first-run-wizard/step4-design-finish.png" />
</Frame>

من هنا:

* **Choose a design (optional)** — طبّق نمطًا بصريًا قبل التنزيل.
* **Test your QR** — يفتح الوجهة في تبويب جديد، بنفس طريقة ما يفعله المسح.
* **Download QR** — يُنزّل صورة رمز QR.
* **Continue to plans** — الإجراء الأخير، الذي ينقلك إلى التطبيق الرئيسي (ملاحظة على الشاشة تذكّرك بأن التصميم يمكن تغييره لاحقًا من لوحة التحكم أيضًا).

## ذات صلة

* [Quick Code مقابل صفحة كاملة](/ar/qr-codes/create/quick-code-vs-page) — نفس نقاط البداية الثلاث، متاحة في أي وقت من `/qr/create`، وليس فقط أثناء الإعداد الأولي.
* [Classic إلى New UI](/ar/onboarding/classic-to-new-ui) — قرار منفصل، على مستوى الحساب ولمرة واحدة، لا علاقة له بهذا المعالج.