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

# تخصيص بوابات العملاء وضوابط الوصول ومعدلات الضريبة

> قم بتمييز صفحتي تسجيل الدخول والتسجيل للعملاء، وتحكم في ظهور الشريط الجانبي حسب الدور، وإعداد معدلات الضريبة للفواتير والدفع في AgencyHandy.

يمنحك AgencyHandy تحكماً عميقاً فيما يراه عملاؤك ويختبرونه — من أول صفحة يصلون إليها عند تسجيل الدخول، إلى الأقسام التي يمكنهم التنقل إليها بعد تسجيل الدخول. تغطي هذه الصفحة أربعة مجالات إعداد مترابطة: **بوابة تسجيل الدخول**، و**بوابة التسجيل**، و**ضوابط الشريط الجانبي والوصول**، و**معدلات الضريبة**. تتيح لك هذه الإعدادات مجتمعةً إنشاء تجربة متقنة ومناسبة لكل دور لكل مستخدم في مساحة عملك.

<Note>
  تتطلب جميع الإعدادات في هذه الصفحة صلاحية **المسؤول الرئيسي** أو **المسؤول**. انتقل إلى **إعداد مساحة العمل** في الشريط الجانبي الأيسر للوصول إلى كل قسم.
</Note>

***

<Tabs>
  <Tab title="Sign-in Portal">
    ## بوابة تسجيل الدخول

    بوابة تسجيل الدخول هي صفحة تسجيل الدخول التي يراها عملاؤك وأعضاء فريقك عند الوصول إلى مساحة عمل AgencyHandy الخاصة بك. يضمن تخصيصها أن الانطباع الأول الذي يحصل عليه العملاء يحمل علامتك التجارية الكاملة — مع صور وكالتك والعنوان الرئيسي والرسالة الترحيبية.

    ### ما يمكنك تخصيصه

    | العنصر            | الوصف                                             | الحد الأقصى                              |
    | ----------------- | ------------------------------------------------- | ---------------------------------------- |
    | **العنوان**       | العنوان الرئيسي المعروض في أعلى صفحة تسجيل الدخول | 120 حرفاً كحد أقصى                       |
    | **الصورة**        | صورة أو رسم توضيحي يحمل علامتك التجارية           | PNG أو JPG أو JPEG — 5 ميجابايت كحد أقصى |
    | **النص التوضيحي** | رسالة قصيرة أسفل حقول تسجيل الدخول                | 300 حرف كحد أقصى                         |

    ### خطوات تخصيص بوابة تسجيل الدخول

    <Steps>
      <Step title="افتح إعدادات بوابة تسجيل الدخول">
        انتقل إلى **إعداد مساحة العمل** في شريط التنقل الأيسر، ثم اختر **بوابة تسجيل الدخول** من القائمة الفرعية.
      </Step>

      <Step title="أدخل عنواناً مخصصاً">
        اكتب العنوان المطلوب في حقل **العنوان**. اجعله موجزاً وذا صلة — على سبيل المثال، *"مرحباً بعودتك إلى \[اسم الوكالة]"* أو *"بوابة عملائك."* الحد الأقصى للطول 120 حرفاً.
      </Step>

      <Step title="ارفع صورة تحمل علامتك التجارية">
        انقر فوق منطقة الرفع أو اسحب ملف الصورة وأفلته (PNG أو JPG أو JPEG، بحد أقصى 5 ميجابايت) لإضافة عنصر مرئي إلى صفحة تسجيل الدخول. تظهر هذه الصورة عادةً بجانب نموذج تسجيل الدخول.

        <Tip>
          استخدم صورة عالية الجودة تعبّر عن وكالتك — صورة لفريقك، أو رسم توضيحي نظيف للعلامة التجارية، أو خلفية احترافية. تأكد من أن حجم الملف أقل من 5 ميجابايت لتجنب أخطاء الرفع.
        </Tip>
      </Step>

      <Step title="أضف نصاً توضيحياً">
        في حقل **النص التوضيحي**، اكتب رسالة مختصرة لتظهر أسفل حقول تسجيل الدخول — مثل ملاحظة ترحيبية أو معلومات التواصل مع الدعم أو شعار قصير. اجعلها أقل من 300 حرف.
      </Step>

      <Step title="معاينة وحفظ">
        راجع تخطيط صفحة تسجيل الدخول باستخدام المعاينة. بمجرد رضاك، انقر فوق **حفظ** (أو **تحديث**) لتطبيق التغييرات. تسري التغييرات فوراً.
      </Step>
    </Steps>

    ### إعادة التعيين إلى الإعدادات الافتراضية

    انقر فوق **إعادة تعيين الإعدادات الافتراضية** في صفحة بوابة تسجيل الدخول لإزالة جميع التخصيصات واستعادة صفحة تسجيل الدخول الأصلية لـ AgencyHandy.

    <Warning>
      إعادة التعيين إلى الافتراضي لا يمكن التراجع عنها. ستُحذف جميع العناوين والصور والنصوص التوضيحية المخصصة بشكل دائم. انقر فوق **إلغاء** إذا لم تكن متأكداً — ستُتجاهل التغييرات غير المحفوظة وتبقى الإعدادات المحفوظة الحالية سليمة.
    </Warning>

    ### أفضل الممارسات

    * اجعل العنوان قصيراً وترحيبياً — العملاء يرونه قبل تسجيل الدخول، لذا اجعله مطمئناً.
    * استخدم صورة احترافية تعبّر عن وكالتك. تجنب صور المخزون العامة التي تبدو منفصلة عن علامتك التجارية.
    * قم بالمعاينة على أحجام شاشات مختلفة قبل الحفظ للتأكد من أن تخطيط الصورة والنص يبدو صحيحاً.
    * إذا فشل رفع الصورة، تأكد من أنها تستوفي متطلبات الصيغة (PNG أو JPG أو JPEG) والحجم (أقل من 5 ميجابايت).
  </Tab>

  <Tab title="Sign-up Portal">
    ## بوابة التسجيل

    بوابة التسجيل هي صفحة التسجيل التي يصل إليها العملاء الجدد عند إنشاء حساب في مساحة عملك. يخلق تخصيصها تجربة متسقة تحمل علامتك التجارية منذ أول تفاعل يجريه العميل المحتمل مع منصة وكالتك.

    ### ما يمكنك تخصيصه

    | العنصر            | الوصف                                        | الحد الأقصى                              |
    | ----------------- | -------------------------------------------- | ---------------------------------------- |
    | **العنوان**       | العنوان الرئيسي المعروض في أعلى صفحة التسجيل | 120 حرفاً كحد أقصى                       |
    | **الصورة**        | صورة أو رسم توضيحي يحمل علامتك التجارية      | PNG أو JPG أو JPEG — 5 ميجابايت كحد أقصى |
    | **النص التوضيحي** | رسالة قصيرة أسفل حقول التسجيل                | 300 حرف كحد أقصى                         |

    ### خطوات تخصيص بوابة التسجيل

    <Steps>
      <Step title="افتح إعدادات بوابة التسجيل">
        انتقل إلى **إعداد مساحة العمل** في شريط التنقل الأيسر، ثم اختر **بوابة التسجيل** من القائمة الفرعية.
      </Step>

      <Step title="أدخل عنواناً مخصصاً">
        اكتب عنواناً في حقل **العنوان** يرحّب بالعملاء الجدد. مثلاً، *"ابدأ مع \[اسم الوكالة]"* أو *"أنشئ حساب عميلك."* الحد الأقصى 120 حرفاً.
      </Step>

      <Step title="ارفع صورة تحمل علامتك التجارية">
        انقر فوق منطقة الرفع أو اسحب ملف الصورة وأفلته (PNG أو JPG أو JPEG، بحد أقصى 5 ميجابايت). تُعرض هذه الصورة في صفحة التسجيل بجانب نموذج التسجيل.

        <Tip>
          استخدم نفس الأسلوب البصري ولوحة الألوان في صور بوابتي تسجيل الدخول والتسجيل لخلق تجربة متناسقة بين الصفحتين.
        </Tip>
      </Step>

      <Step title="أضف نصاً توضيحياً">
        اكتب رسالة داعمة مختصرة في حقل **النص التوضيحي** — مثل تعليمات حول ما يمكن توقعه بعد التسجيل، أو عرض قيمة موجز. الحد الأقصى 300 حرف.
      </Step>

      <Step title="معاينة وحفظ">
        راجع صفحة التسجيل باستخدام خيار المعاينة. انقر فوق **حفظ** (أو **تحديث**) لتطبيق التغييرات فوراً.
      </Step>
    </Steps>

    ### إعادة التعيين إلى الإعدادات الافتراضية

    انقر فوق **إعادة تعيين الإعدادات الافتراضية** في صفحة بوابة التسجيل لإزالة جميع التخصيصات واستعادة صفحة التسجيل الأصلية لـ AgencyHandy.

    <Warning>
      لا يمكن التراجع عن هذا الإجراء. ستُمحى جميع إعدادات العنوان والصورة والنص التوضيحي المخصصة بشكل دائم.
    </Warning>

    ### أفضل الممارسات

    * طابق نبرة عنوان التسجيل مع أسلوب التواصل العام مع العملاء — احترافي أو ودود أو كلاهما.
    * اجعل النص التوضيحي مركّزاً: أخبر العملاء الجدد بما يحدث بعد التسجيل (مثلاً، *"بمجرد تسجيلك، سيرسل فريقنا إليك بريداً إلكترونياً ترحيبياً خلال 24 ساعة."*).
    * جرّب عملية التسجيل بنفسك بعد حفظ التغييرات للتأكد من أن الصفحة تبدو وتتصرف كما هو متوقع.
  </Tab>

  <Tab title="Sidebar & Access">
    ## ضوابط الشريط الجانبي والوصول

    تتيح لك إعدادات الشريط الجانبي والوصول التحكم الدقيق فيما يمكن لكل دور مستخدم رؤيته في قائمة التنقل اليسرى. يمكنك إعادة تسمية عناصر القائمة لتتناسب مع مصطلحات وكالتك، واستبدال الأيقونات الافتراضية بأيقونات مخصصة، وتبديل ظهور أي قسم من القائمة لكل دور. والنتيجة هي واجهة أنظف وأكثر ملاءمةً لكل شخص يسجل الدخول.

    ### الأدوار التي يمكنك إعدادها

    * العميل
    * المسؤول الرئيسي
    * المسؤول
    * المدير
    * المسؤول عن المهمة
    * مخصص (أي أدوار مخصصة أنشأتها ضمن الأدوار والصلاحيات)

    ### خطوات تخصيص عناصر قائمة الشريط الجانبي

    <Steps>
      <Step title="افتح إعدادات الشريط الجانبي والوصول">
        انتقل إلى **إعداد مساحة العمل**، ثم اختر **الشريط الجانبي والوصول** من قائمة الإعدادات.
      </Step>

      <Step title="انقر فوق تخصيص">
        انقر فوق زر **تخصيص** في أعلى اللوحة. تظهر القائمة الكاملة لعناصر الشريط الجانبي الحالية ضمن فئة **رئيسي**.
      </Step>

      <Step title="أعد تسمية عنصر قائمة">
        انقر فوق حقل نص أي عنصر في القائمة واكتب التسمية الجديدة. مثلاً، أعد تسمية "لوحة التحكم" إلى "نظرة عامة" أو "إدارة علاقات العملاء" إلى "جهات الاتصال". انقر فوق **حفظ** لتطبيق الاسم الجديد.
      </Step>

      <Step title="غيّر أيقونة عنصر القائمة">
        انقر فوق الأيقونة بجانب اسم عنصر القائمة. تفتح نافذة منبثقة تحتوي على مجموعة من خيارات الأيقونات — اختر واحدة من المكتبة، أو ارفع صورة مخصصة بحجم 32×32 بكسل لاستخدام أيقونتك المميزة. انقر فوق **حفظ** للتطبيق.
      </Step>
    </Steps>

    ### خطوات إعداد الظهور حسب الدور

    <Steps>
      <Step title="انقر فوق تعديل الوصول">
        انقر فوق زر **تعديل الوصول** (بجانب زر **تخصيص**). ستظهر علامات تبويب لكل دور متاح.
      </Step>

      <Step title="اختر دوراً">
        انقر فوق علامة تبويب الدور الذي تريد إعداده — مثلاً، **العميل**.
      </Step>

      <Step title="بدّل ظهور عناصر القائمة">
        لكل عنصر من عناصر القائمة المدرجة، استخدم مفتاح التبديل لإظهاره أو إخفائه للدور المحدد. مثلاً، قد تخفي **الفواتير** و**الاشتراكات** عن العملاء بينما تُبقيها ظاهرة للمسؤولين والمديرين.
      </Step>

      <Step title="احفظ تغييراتك">
        انقر فوق **حفظ**. تسري إعدادات الظهور المحدّثة فوراً — يرى المستخدمون التغييرات عند التنقل إلى صفحة أخرى أو بعد تسجيل الدخول مجدداً.
      </Step>

      <Step title="إعادة التعيين إلى الافتراضي عند الحاجة">
        انقر فوق **إعادة التعيين إلى الافتراضي** في علامة تبويب أي دور لاستعادة إعدادات الظهور الأصلية لذلك الدور.
      </Step>
    </Steps>

    <Tip>
      يُحسّن الشريط الجانبي النظيف المختصر تجربة العميل. عرض ما يحتاجه العملاء فقط — مثل **لوحة التحكم** و**الطلبات** و**الرسائل** — يقلل الإرباك ويمنعهم من الوصول إلى الأقسام الداخلية فحسب.
    </Tip>

    ### مثال على إعدادات الأدوار

    | الدور             | الأقسام الموصى بعرضها                                |
    | ----------------- | ---------------------------------------------------- |
    | العميل            | لوحة التحكم، الطلبات، الرسائل، الفواتير (عند الحاجة) |
    | المدير            | إدارة علاقات العملاء، المشاريع، ورقة الحضور، المهام  |
    | المسؤول عن المهمة | لوحة التحكم، المهام، المشاريع، الرسائل               |
    | المسؤول الرئيسي   | جميع الأقسام (بلا قيود)                              |

    ### ملاحظات مهمة

    * **التغييرات فورية:** تنعكس تحديثات ظهور الأدوار فوراً بعد تحديث الصفحة أو إعادة تسجيل الدخول.
    * **الدور الأوسع صلاحية يأخذ الأولوية:** إذا كان المستخدم يحمل أدواراً متعددة، يُقدَّم الدور ذو الوصول الأشمل.
    * **الأيقونات المخصصة:** ارفع صوراً بحجم 32×32 بكسل لتتناسب مع مرئيات علامتك التجارية في الشريط الجانبي.
    * **اتساق التسمية:** استخدم اصطلاحات تسمية واضحة ومتسقة يفهمها فريقك بأكمله — تجنب الاختصارات أو المصطلحات الداخلية التي لن يتعرف عليها الأعضاء الجدد.
  </Tab>

  <Tab title="Tax Rates">
    ## معدلات الضريبة

    تتيح لك ميزة معدلات الضريبة إنشاء وإدارة وتطبيق إعدادات الضريبة عبر خدماتك واشتراكاتك وفواتيرك. يمكنك إعداد أنواع ضريبية متعددة — ضريبة القيمة المضافة، وضريبة السلع والخدمات، وضريبة المبيعات وغيرها — بمعدلات خاصة بالبلد والولاية، ودعم لنموذجي التسعير الشامل والحصري، والتطبيق التلقائي عند الدفع بناءً على موقع العميل.

    <Note>
      يمكن لـ **المسؤولين الرئيسيين** و**المسؤولين** فقط إنشاء وتعديل وحذف إعدادات الضريبة.
    </Note>

    ### مفاهيم الضريبة في لمحة

    | المفهوم           | التعريف                                                                                       |
    | ----------------- | --------------------------------------------------------------------------------------------- |
    | **حصري**          | تُضاف الضريبة فوق السعر المدرج عند الدفع (مثلاً، 100 دولار + 10% ضريبة = 110 دولارات إجمالاً) |
    | **شامل**          | الضريبة مدرجة بالفعل في السعر المعروض للعميل (مثلاً، 110 دولارات إجمالاً تشمل الضريبة بالفعل) |
    | **الرقم الضريبي** | الرقم الضريبي التجاري لوكالتك، يظهر في الفواتير                                               |

    ### الخطوة 1: إنشاء معدل ضريبة

    <Steps>
      <Step title="افتح معدلات الضريبة">
        انتقل إلى **إعداد مساحة العمل**، ثم انقر فوق علامة تبويب **معدلات الضريبة**.
      </Step>

      <Step title="انقر فوق + ضريبة جديدة">
        انقر فوق زر **+ ضريبة جديدة**. تظهر نموذج.
      </Step>

      <Step title="أملأ تفاصيل الضريبة">
        أكمل الحقول التالية:

        * **العنوان / نوع الضريبة** *(مطلوب)*: أدخل اسماً وصفياً، مثلاً ضريبة القيمة المضافة القياسية، أو ضريبة السلع والخدمات المخفضة، أو ضريبة المبيعات الأمريكية. الحد الأقصى 255 حرفاً.
        * **الرقم الضريبي** *(اختياري)*: الرقم الضريبي التجاري لوكالتك. الحد الأقصى 20 حرفاً.
        * **البلد الرئيسي**: اختر البلد الأساسي الذي تسري عليه هذه الضريبة.
        * **معدل الضريبة العام للبلد الرئيسي %** *(اختياري)*: المعدل الافتراضي لبلدك الرئيسي.
        * **معدلات خاصة بالبلد** *(اختياري)*: أضف معدلات لكل بلد مع الولاية والرمز البريدي والنسبة المئوية اختيارياً. هذا مفيد للوكالات التي تخدم عملاء في ولايات ضريبية متعددة.
      </Step>

      <Step title="حدد الحالة">
        بدّل الضريبة إلى **نشط** لتجعلها متاحة فوراً للاستخدام في الخدمات والفواتير. اضبطها على **غير نشط** لحفظ الإعداد دون تطبيقه على المشتريات الجديدة بعد.
      </Step>

      <Step title="حفظ">
        انقر فوق **حفظ**. تظهر الضريبة في قائمة معدلات الضريبة وأصبح بإمكانك ربطها بالخدمات.
      </Step>
    </Steps>

    <Tip>
      يمكنك دعم ما يصل إلى 4 أرقام عشرية في نسب معدلات الضريبة. معدل ضريبة 0% صالح — استخدمه للعناصر المعفاة من الضريبة أو سيناريوهات الامتثال التي تتطلب إدراج الضريبة حتى لو كان مبلغها صفراً.
    </Tip>

    ### الخطوة 2: ربط الضرائب بالخدمات

    <Steps>
      <Step title="افتح الخدمة للتعديل">
        انتقل إلى **الخدمات** وأنشئ خدمة جديدة أو عدّل خدمة قائمة.
      </Step>

      <Step title="انتقل إلى قسم المعلومات الإضافية">
        تابع إلى الخطوة 3 (المعلومات الإضافية) من معالج إعداد الخدمة.
      </Step>

      <Step title="أضف الضرائب إلى الخدمة">
        انقر فوق **إضافة ضريبة** واختر نوعاً ضريبياً أو أكثر من قائمتك المُعدَّة. اختر ما إذا كانت الضرائب تُطبَّق بصورة **شاملة** أو **حصرية** لهذه الخدمة. ينطبق هذا الإعداد على جميع الضرائب المرتبطة بالخدمة، بما فيها رسوم الإعداد والإضافات.
      </Step>
    </Steps>

    ### الخطوة 3: كيفية تطبيق الضرائب

    يمكن تطبيق الضرائب **تلقائياً أثناء الدفع** أو **يدوياً على الفواتير**:

    **تلقائي (عند الدفع)**

    * تُحسب الضرائب المرتبطة بالخدمة تلقائياً بناءً على موقع الفوترة للعميل.
    * يجب على العميل تقديم بلده وولايته والرمز البريدي عند الدفع لتطبيق الضريبة المحددة بالموقع.
    * لحسابات Stripe الهندية، تُعد معلومات الموقع الكاملة (البلد والولاية والرمز البريدي) إلزامية.

    **يدوي (الفاتورة)**

    * عند إنشاء فاتورة يدوياً، انقر فوق **إضافة ضرائب** لاختيار الضرائب التي ستُطبَّق.
    * تُملأ حقول عنوان الفوترة تلقائياً.
    * **الضرائب الحصرية فقط** يمكن تطبيقها على الفواتير اليدوية — الضرائب الشاملة غير مدعومة في هذه العملية.

    ### عرض الضريبة في الفاتورة

    كل فاتورة تتضمن ضريبة تعرض التفاصيل التالية:

    * **اسم الضريبة** — التسمية التي أدخلتها (مثلاً ضريبة القيمة المضافة، ضريبة السلع والخدمات)
    * **نسبة الضريبة** — المعدل المطبّق (مثلاً 15%)
    * **مبلغ الضريبة** — المبلغ المحسوب المفروض

    ### إدارة معدلات الضريبة الحالية

    * **تعديل ضريبة:** انقر فوق إدخال الضريبة في القائمة لتحديث عنوانها أو معدلها أو قواعد البلد. تُطبَّق التحديثات على الفواتير والمشتريات المستقبلية فقط.
    * **حذف ضريبة:** الضرائب المحذوفة لا تُطبَّق على المشتريات أو الاشتراكات الجديدة، لكن الفواتير القائمة التي تضمنتها تبقى غير متأثرة.
    * **تعطيل ضريبة:** اضبط الضريبة على **غير نشط** لإيقاف تطبيقها على المشتريات الجديدة دون حذف الإعداد.

    ### ملاحظات مهمة

    * **تُطبَّق خصومات القسائم قبل الضريبة:** عندما يستخدم العميل قسيمة خصم، تُحسب الضريبة على السعر المخفَّض لا السعر الأصلي.
    * **ضرائب متعددة لخدمة واحدة:** يمكنك ربط أكثر من ضريبة واحدة بخدمة واحدة (مثلاً ضريبة القيمة المضافة + ضريبة السلع والخدمات في آنٍ واحد).
    * **تُطبَّق الضريبة على الإضافات ورسوم الإعداد:** إذا كانت خدمتك تتضمن رسوم إعداد أو إضافات، تُطبَّق الضريبة على تلك المبالغ أيضاً.
    * **موقع العميل مُملأ مسبقاً:** إذا كان للعميل بلد وولاية فوترة محفوظان في ملفه الشخصي، تُملأ تلك الحقول مسبقاً عند الدفع. غير أن تعديل الموقع أثناء الدفع **لا يُحدّث** ملف العميل.
    * **تحديد الولاية بالرمز البريدي:** للعملاء الأمريكيين، يمكن للنظام تحديد الولاية تلقائياً من الرمز البريدي وتطبيق الضريبة الإقليمية الصحيحة إذا كانت مُعدَّة.
  </Tab>
</Tabs>