# فحص دليل الإدارة وإصلاح الرحلات

تاريخ الجولة: 13 أكتوبر 2026.

## ما تم تسليمه

- دليل عربي للإدارة غير التقنية يغطي 49 شاشة في 12 قسمًا، و6 رحلات رئيسية تضم 27 خطوة عرض.
- 228 مجموعة مزايا وإعدادات، و166 سيناريو موثق، و162 اختيارًا تجريبيًا متاحًا من الشاشات والغلاف.
- قوائم قراءة لعشرة أدوار، وبحث عربي، وتصفية حسب القسم، وروابط مباشرة، وعلامات قراءة محفوظة، وعرض مناسب للطباعة.
- مصدر Markdown نظيف وعارض HTML عربي مستقل. معاينة Markdown الأصلية في Codex لم تتغير.

## الإصلاحات المرتبطة بالرحلات والإعدادات

1. يبدأ إعداد الشركة من العقار بعداد صفر. مراجعة الخطوات السبع تنتهي بزر فتح الرئيسية. تأجيل خطوة لا يعلّمها مكتملة.
2. استبدلت التعليمات الناقصة في إعداد الملاك والفريق وواتساب بشرح عربي وروابط للأقسام المناسبة.
3. يحتفظ الحفظ في الإعدادات بمرجعه أثناء جلسة المتصفح، حتى بعد إعادة تحميل الشاشة. يعيد «تجاهل» آخر نسخة محفوظة.
4. إلغاء صلاحية العرض لعمود كامل يلغي الإجراءات التابعة. تفعيل التعديل يتطلب العرض. صلاحيات المدير المقفولة تبقى مقفولة.
5. يعرض الدفع في الوحدة حالة التفعيل الصحيحة. إجراءات القنوات تعرض نتيجة مزامنة تجريبية واضحة. العدد المعروض للفريق سبعة أعضاء.
6. يظهر زر «ارجع للرحلة» عند فتح قسم خارج الرحلة. تعود منه لنفس خطوة العرض. لا يحفظ هذا الزر مسار الرجوع بعد إعادة تحميل الصفحة كاملة.
7. أضيفت قائمة «حالات التجربة» لإظهار الفروع الموجودة أصلًا في منطق الشاشات. القفز إلى نتيجة لا يعني تنفيذ إجراءاتها.
8. استعيد عرض ما بعد المغادرة في بوابة الضيف، مع التأمين والاعتراض والمفقودات والتقييم. أصبح نص طلب المغادرة المتأخرة مختلفًا عن الليلة الإضافية، ويتغير نص رد التأمين عند الاعتراض.
9. أصلحت مطابقة تشكيل الأزرار العربية ومسارات مراجعة الدفع وتجديد الرخصة والبحث وإعادة المحاولة والخروج بالعربي والإنجليزي. مدفوعات بوابة الضيف تفتح رابط الضيف.
10. أصبح تسجيل الوصول معطلًا للحجز الملغي. عولج الانتقال إلى الشاشة المتكررة داخل الرحلة، وأعيدت كتابة تعليمات الرحلات الست وفق الأزرار الموجودة فعلًا.

## مساهمة Claude

شارك Claude Code فعليًا من خلال مهارة claude-delegate. كتب وراجع الشاشات العشرين من S7.1 حتى S12.1، وراجع الادعاءات الحساسة في بقية الدليل. ثم راجع Codex ملاحظاته وأصلح المطابقة والتسميات والرحلات، وحدّث المحتوى المرتبط بها. مراجعة Claude اعتمدت على المصادر، ولم تكن فحص متصفح. ملف مراجعته يحتفظ بالتاريخ والتصحيحات اللاحقة.

## التحقق المنفذ

| الفحص | النتيجة وحدودها |
| --- | --- |
| فتح الشاشات في Chrome | 49 من 49 وصلت إلى حالة الجاهزية وأظهرت محتوى. لا صور مكسورة مكتملة التحميل في القياس، ولا أخطاء JavaScript مسجلة في هذه الجولة. |
| تنقل غلاف الرحلات | الخطوات الـ27 عبر الرحلات الست فتحت دون شاشة خطأ تحميل. هذا اختبار تسلسل العرض، وليس تنفيذ كل عملية أعمال في كل فرع. |
| إعداد الشركة | بدأ من الخطوة الأولى، وأكمل مراجعة السبع خطوات، وأظهر زر الرئيسية. |
| إعدادات الصلاحيات | اختبر الإلغاء الجماعي، وتبعية التعديل للعرض، والحفظ وإعادة التحميل، ثم التراجع عن تعديل جديد. |
| التنقل الجانبي | فتح الإعدادات من رحلة الإعداد ثم عاد إلى الخطوة الثانية من الرحلة. |
| المغادرة | ظهرت شاشة الخصم بالأدلة. الاعتراض غيّر الحالة إلى نزاع. اختيار النجوم أظهر نموذج التقييم. |
| حالات النظام | إعادة المحاولة رجعت لأول حالة. البحث من صفحة غير موجودة فتح الحجوزات. |
| الحجز الملغي | ظهر زر Check-in معطلًا. |
| الدليل | بحث S11.2 أعاد شاشة واحدة. علامة القراءة بقيت بعد إعادة التحميل. رابط الشاشة فتح شرحها. |
| العرض العربي | فحص بصري عند العرض المكتبي وعرض 390 بكسل. الاتجاه RTL والمحاذاة يمين، دون تجاوز أفقي لجذر الصفحة في القياس. |
| اختبارات المصادر | 162 استدعاء لحالات العرض، وبصمات 49 شاشة أصلية، و76 رابطًا وصفيًا، وروابط الدليل وأصوله. |
| الصور | بصمات 35 مصدر صورة و90 نسخة WebP قابلة للقراءة، و1506 مراجع أصل محلي. |

## حدود الدقة

الدليل يوثق المسارات والبدائل الموجودة في هذه النسخة. لا يدّعي اختبار كل تركيب ممكن من قيم الحقول أو كل جهاز Android. أمثلة الشاشات مستقلة، ولا يوجد مخزن أعمال مشترك يربط كل حجز ودفع ومهمة بين الشاشات. الدفع والإرسال ورفع الهوية والمزامنة والاعتمادات الخارجية محاكاة.

توجد قيود أصلية موضحة بجوار كل ميزة في الدليل، مثل عدادات ثابتة وبعض الأزرار التي تعرض رسالة فقط. المدد والأرقام الخاصة بالضرائب والخصوصية والامتثال نصوص منتج تجريبية، وليست اعتمادًا قانونيًا. خيار الطباعة يفتح نافذة المتصفح للحفظ أو الطباعة؛ لم يُسلّم ملف PDF مستقل.

## تشغيل الفحص مجددًا

```sh
npm run build:prototype
npm run build:guide
npm run verify:guide
node scripts/verify-prototype.js
npm run build:docs
```

أدلة الفتح والتنقل محفوظة في مجلد `evidence/`. يحتفظ `coverage.json` بتغطية الشاشات وبصمات المصادر المبنية لتحديد أي دليل يحتاج إعادة توليد.

## النشر

نشر الدليل والإصلاحات على [martechhub.net](https://martechhub.net/) و[رابط الدليل](https://martechhub.net/guide/). حفظت نسخة رجوع خارج مجلد الموقع قبل استبدال ملفات التحديث. طابقت بصمات ملفات التحديث بين المحلي والسيرفر، وفتح الدليل وتقرير الفحص وشاشة المغادرة عبر HTTPS في Chrome. جرب الاعتراض على خصم التأمين على النسخة المنشورة وظهر نص حجز المبلغ للمراجعة.

لم يكتمل فحص HTTP الشامل من سطر الأوامر بسبب الثقة بالشهادة واتصال الوسيط في بيئة الأوامر. لذلك لا ينسب هذا التقرير اختبار HTTP لكل المسارات المنشورة. تحقق المسارات الـ76 محليًا، وتسلسل الـ27 خطوة في المتصفح، وبصمات النشر وفحص الصفحات المنشورة المذكورة أعلاه موثقة كل على حدة.

## إضافة الجولة المشروحة داخل البروتوتيب

بناءً على طلب المستخدم اللاحق، أضيفت جولة تفاعلية غير حاجبة للواجهة. تظهر بجوار الشاشة على الكمبيوتر وأسفلها على الموبايل. تغطي 49 شاشة بثلاثة مسارات شرح، وإجمالي 762 بطاقة: 368 للمقدمة والخطوات، و228 للمزايا والإعدادات، و166 للسيناريوهات.

- زر البداية في صفحة الرحلات يتيح اختيار إحدى الرحلات الست. الرابط الذي ينتهي بـ `?tour=1` يفتح الشرح تلقائيًا، مثل [بدء الإعداد بالشرح](https://martechhub.net/journey/setup/1/?tour=1).
- يبرز الإطار الأزرق الهدف المرئي المطابق للنص. إذا كان القسم أو العنصر غير ظاهر، تعرض الجولة إرشادًا بفتح الحالة المطلوبة، ولا تدّعي وجود عنصر محدد. بعض بطاقات الإعدادات توفر إجراء عرض القسم مباشرة.
- يوجد التالي والسابق، والانتقال لخطوة، وتبديل نوع المحتوى، وإعادة الشرح، والإغلاق والاستكمال، وتصغير اللوحة على الهاتف. تقدم الشرح محفوظ في جلسة المتصفح. تغيير بطاقة الشرح لا يحفظ إعدادًا ولا ينفذ إجراء أعمال.
- في Chrome، فتح الشرح في كل الشاشات الـ49، وبدلت الأنواع الثلاثة في كل واحدة. سجلت 147 فحصًا لوجود المحتوى وعناوينه وروابط مرجعه، دون محتوى فارغ أو أخطاء JavaScript مسجلة. هذا لا يعني النقر على كل بطاقة من الـ762 أو تنفيذ كل سيناريو.
- جرب إبراز زر إرسال التسجيل والانتقال لشرح شاشة الإعداد التالية. جرب فتح طرق الدفع من الجولة، والإغلاق والاستكمال وإعادة التحميل. على عرض 390 بكسل، لم يتجاوز جذر الصفحة عرض النافذة، وبقيت مساحة الواجهة قابلة للاستخدام. تصغير الشرح زاد ارتفاع الواجهة من نحو 365 إلى 660 بكسل في الحالة المقاسة.
- يعتمد المحتوى على الدليل الذي شارك Claude في كتابته ومراجعته. تنفيذ الجولة وفحصها من Codex. الأدلة الجديدة في `evidence/guided-tour-screen-checks.json` ولقطات الجولة المكتبية والهاتف.

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

## تحسين التركيز البصري في الجولة

- أضيف تعتيم حول الهدف المرئي بنسبة 68%، مع إطار أبيض وأزرق وعلامة باسم العنصر ورقم الشرح. لا تغطي العلامة الهدف، وتختفي عندما تضيق المساحة. لوحة الشرح تظل خارج التعتيم.
- التعتيم بصري ولا يمنع الضغط أو الكتابة. يتبع الإطار موضع العنصر عند التمرير وتغيير حجم الشاشة، ويختفي إذا خرج العنصر من الجزء المرئي، أو صغرت الجولة، أو أغلقت. زر عرض الشاشة كاملة يوقف التعتيم مع إبقاء إطار التحديد.
- حسنت مطابقة التسميات حتى لا يختلط حقل رقم السجل التجاري ببطاقة مستند السجل التجاري. صارت الخطوات الست في تسجيل الشركة تشير إلى تسميات مرئية محددة. قلصت ازدحام نهاية الشرح بدمج زر الشاشة التالية في صف التنقل.
- اختبرت في Chrome الحقول والاختيارات وبطاقة المستند وزر الإرسال، وتغيير اختيار منطقة داخل التركيز، والكتابة في الحقل، والتمرير بعيدًا ثم العودة إليه. اختبرت إيقاف التعتيم وإعادته والتصغير والإغلاق والاستكمال، عند عرض مكتبي وعرض هاتف 390 بكسل. لم يظهر تجاوز أفقي لجذر الصفحة في قياس الهاتف.
- اختبرت التركيز على زر حالات التجربة خارج الشاشة الداخلية وفتح نافذته، ثم عرض إعدادات الدفع من الجولة وإعادة تحديد الهدف بعد تحديث المحتوى. لم تسجل أخطاء JavaScript في هذه الجولة. هذه اختبارات موجهة للتحسين، وليست إعادة تنفيذ لكل البطاقات الـ762.
- صحح رابط المرجع الكامل وبدء الجولة عند تحويل رابط قديم يحتوي رمز الشاشة إلى رابط وصفي. تعتمد الجولة الآن عنوان الأساس الذي حفظه مشغل البروتوتيب قبل تغيير الرابط.

نشر تحسين التركيز على martechhub.net بعد حفظ نسخة رجوع مستقلة خارج مجلد الموقع. طابقت بصمات ملفات التحديث. فتح رابط الجولة المنشور عبر HTTPS، وتحقق الإطار والتعتيم وإيقافهما وإعادتهما. لقطتا [الكمبيوتر](evidence/guided-tour-spotlight-desktop.png) و[الموبايل](evidence/guided-tour-spotlight-mobile.png) من الموقع المنشور، وعرضتا بصريًا بعد الحفظ للتأكد من صحة الملف.

## جولة التحسين الثانية: القراءة ودقة التركيز

استخدمت إرشادات مهارة accessibility-review لفحص القراءة واللمس والكيبورد. هذا فحص موجه للجولة، وليس شهادة مطابقة شاملة لمعيار إتاحة.

| المشكلة المكتشفة | التحسين والتحقق |
| --- | --- |
| مساحة النص 74 بكسل على هاتف 360 × 640 | أصبحت 126 بكسل في العرض العادي، و470 بكسل عند الضغط على «تكبير». الأرقام قياس لقسم طرق الدفع في الحالة المختبرة. |
| المقدمة العامة قد تبرز عنصرًا مذكورًا عرضًا | ميزت مقدمات الشاشات صراحة كنظرة عامة، دون تركيز على عنصر. تحقق ذلك في الشاشات الـ49. |
| خطوة تشرح عدة عناصر وتبرز أول عنصر فقط | أضيف اختيار «ركّز على أي جزء؟» للأهداف المطابقة الظاهرة. اختبرت الانتقال إلى التأمين الافتراضي في إعدادات الدفع. |
| زر عرض القسم يأتي بعد شرح طويل | انتقل إلى بداية البطاقة قبل التفاصيل. يفتح المثال دون حفظ إعداد. |
| الوصول بالكيبورد يتطلب المرور بعناصر كثيرة | زر «انتقل للعنصر» ينقل التركيز فقط. تحقق وصوله إلى زر التأمين دون تغيير قيمة 3,000 ج.م. |
| أزرار مساعدة بارتفاع 26 أو 32 بكسل | أصبحت أزرار الجولة الظاهرة في حالة الهاتف المختبرة بارتفاع 44 بكسل على الأقل. |
| عرض موسع قد يسمح للكيبورد بالخروج خلف اللوحة | القراءة الموسعة تستخدم حالة حوار، وتعطل التنقل للخلفية مؤقتًا. اختبرت Tab وShift+Tab والرجوع بـ Escape، وإعادة إتاحة الشاشة. |
| حالة التصغير لا تتزامن عند الفتح من الشريط | توحدت حالة الأزرار والوصف. تحقق «صغّر الشرح» وaria-expanded بعد إعادة الفتح. |
| تضارب التعتيم مع نافذة حالات التجربة | يختفي تعتيم الجولة أثناء نافذة الغلاف. تحقق ذلك من DOM ولقطة مرئية. |
| كلمة مثل «متوقف» توجد في قسم غير المقصود | لا تبحث البطاقة ذات القسم الجاهز عن عناصر فرعية قبل ظهور عنوان ذلك القسم. اختبرت الانتقال من شرح الدفع إلى الضرائب قبل فتحه، ثم ظهور قائمة عناصر الضرائب بعد فتح القسم الصحيح. |

فتح الشرح في كل الشاشات الـ49، وفحصت المقدمة وأول بطاقة استخدام في كل شاشة، بإجمالي 98 حالة. لا محتوى فارغ، ولا تجاوز أفقي لجذر الغلاف في القياس المكتبي، ولا أخطاء JavaScript مسجلة في هذه الجولة. النتيجة في [سجل فحص الجولة](evidence/guided-tour-refinement-checks.json). هذا لا يعني تنفيذ كل البطاقات أو كل حالات الأعمال.

اختبرت الهاتف عند 360 × 640، والوضع الأفقي عند 740 × 360. في الوضع الأفقي يظهر الشرح بجوار الواجهة، وتوفر القراءة الموسعة 191 بكسل للنص في الحالة المختبرة دون تجاوز أفقي. أظهر فحص شجرة الإتاحة أسماء التحكم وحالة الحوار، ولم ينفذ اختبار يدوي ببرنامج NVDA أو VoiceOver.

تباين النصوص الأساسية على الأبيض: الحبر 17.21:1، النص الثانوي 6.08:1، الكوبالت 7.12:1، وعنوان العلامة القريب 11.33:1. هذه حسابات ألوان الجولة المحددة، وليست فحصًا لكل ألوان الشاشات الأصلية.

نشر التحسين الثاني مع نسخة رجوع مستقلة ومطابقة بصمات التحديث. تحقق اختيار التأمين داخل الدفع على الموقع، ومنع تحديد عنصر من الدفع أثناء شرح الضرائب، ثم ظهور عناصر الضرائب بعد فتحه. [لقطة الكمبيوتر النهائية](evidence/guided-tour-refined-desktop.png) و[لقطة القراءة الموسعة على الهاتف](evidence/guided-tour-refined-mobile.png) من النسخة المنشورة. تحقق عرض ملفي الصور بعد الحفظ.