المصطلحات
سطر واحد لكل مصطلح، وموصول بالصفحة اللي تشرحه صح. وبيانات الآلة (أسماء الحقول والمفاتيح وقيم الحالة) تجيك بخطّ monospace وهي حرفية.
الإجراء الجماعي: عملية وحدة تُطبَّق على تقارير كثيرة محدّدة دفعة وحدة، وتكون حالة أو تسميات أو إسناد. شوف العروض المحفوظة والإجراءات الجماعية.
إخفاء البيانات: تمويه يصير على جهاز المُبلِّغ نفسه، قبل ما تُلتقط الصورة. قيم باراميترات الرابط اللي أسماؤها تدلّ على سرّ تنمسح على كل مشروع؛ أمّا تمويه قيم الحقول المكتوبة وأي منطقة توسمها بمُحدِّد CSS فمفتاح لكل مشروع، مطفي لين تشغّله. شوف إخفاء البيانات الحسّاسة.
الإسناد: الزميل اللي يملك التقرير، عشان يكون له صاحب واحد طول الفرز. شوف التسميات والأولوية والإسناد.
الإضافة: إضافة كروم من uMarker، سطح التقاط لمختبِرين مسمّين يدخلون برمز اتصال. منشورة في متجر كروم؛ فايرفوكس وسفاري لسه. شوف تركيب الإضافة.
الإعلان: رسالة تنشرها على مشروع فتظهر لزوّار ذلك الموقع داخل الودجت. متاحة من باقة «البداية». شوف الإعلانات وسجل التغييرات.
الأولوية: درجة الإلحاح اللي تحطّها على التقرير وقت الفرز. وباللوحة ترتّب بعد الترتيب اليدوي بالسحب، فترتّب العمود اللي ما أحد سحب فيه وما تحرّك شي في عمود أُعيد ترتيبه باليد؛ وبالقائمة هي فرز اختياري مو الافتراضي. شوف التسميات والأولوية والإسناد.
الاستبيان: استبيان قصير يعرضه الودجت على المشروع، ويكون NPS أو CSAT أو CES أو نموذجاً فيه نجوم وإيموجي وأسئلة اختيار. متاح من باقة «البداية». شوف الاستبيانات.
الاستهداف: شرط لكل مشروع يقرّر هل يظهر الودجت، حسب الرابط أو الجهاز أو الجمهور أو التكرار. يطبّقه السنيبت على كل شيء، والإضافة على الاستبيانات والإعلانات و«ما الجديد» فقط؛ زرّ الملاحظات في الإضافة يظهر للمختبِر دائماً. متاح من باقة «احترافي». شوف قواعد الاستهداف.
التسمية: وسم يُطبَّق على التقارير وردود الاستبيانات من نفس التصنيف، ويُعرَّف لكل مساحة. وأربع تسميات بداية (علة، فكرة، سؤال، تحسين) تُبذَر بالعربي والإنجليزي معاً في أول مساحة بكل حساب جديد؛ والمساحة اللي تنشئها بعدين تبدأ فاضية. شوف التسميات والأولوية والإسناد.
التقرير (الملاحظة): السجلّ الأساسي، وفيه لقطة، وملاحظات المُبلِّغ عليها، والعنصر اللي تشير له كل ملاحظة، وسياق الصفحة والجهاز، و— في وضع الالتقاط التقني — سجلّ الكونسول، وطلبات الشبكة، والأخطاء، وفتات المسار، ويمشي في دورة حياة الحالة. شوف الوارد.
الحالة: موضع التقرير في دورة حياته، new أو in_progress أو waiting أو resolved أو archived. شوف دورة حياة الحالة.
الحساب: حدّ العزل، وهو منشأة عميل وحدة وكل اللي تحتها. كل سجلّ يخصّ المستأجر يحمل account_id. وأغلب النماذج تترشّح عليه تلقائياً بنطاق عام، والباقي — قائمة الفريق، ومختبِرو الإضافة، والمعاملات، وسجلّ التدقيق — كل نقطة نهاية ترشّحه بنفسها. شوف عزل الحسابات.
الحقل المخصّص: حقل إضافي تعرّفه للتقارير داخل مساحة، عشان الفرز يسجّل شيئاً ما يشحنه uMarker. ميزة مدفوعة، من باقة «احترافي». شوف التسميات والأولوية والإسناد.
حدّ التكرار: تحكّم في الاستهداف يحدّ كم مرّة يرجع الودجت يظهر لنفس الزائر، ويُتتبّع في متصفّح ذلك الزائر. شوف قواعد الاستهداف.
الدبوس: ملاحظة واحدة مرقّمة على اللقطة. كل دبوس يحمل تعليقه، وخيط نقاش خاصّ به في صفحة التقرير، وزرّ «تمّ» خاصّ به. شوف صفحة التقرير.
الدعوة: رابط بريدي يُستعمل مرّة وحدة وينتهي بعد 7 أيام، يحمل رمزاً عشوائياً من 48 محرفاً (وما يُخزَّن إلا hash له)، ويخلي الشخص ينضم لحسابك بدور ويختار كلمة مروره. وإعادة الإرسال تدوّر الرمز، والإلغاء يقتله. شوف الدعوات والانضمام.
الدور: وش يقدر الشخص يسوي. مقعدان مدمجان (مدير وعضو) وأي دور مخصّص تكتبه (من باقة «احترافي» وفوق). شوف الأدوار والصلاحيات.
الدور المخصّص: دور تكتبه بنفسك من كتالوج الصلاحيات، لمّا ما يقول أيّ من المقعدين وش تقصد. ميزة مدفوعة. شوف الأدوار والصلاحيات.
الذكاء الاصطناعي: مساعدة اختيارية وقت الفرز، فيها عنوان وملخّص مقترحان، وأولوية وتسميات مقترحة، ومكرّرات محتملة. وكل مخرَج استشاري لين يقبله إنسان. ويظلّ مطفي لين ثلاثة مفاتيح منفصلة تقول نعم: حسابك يشغّل الذكاء (مطفي افتراضياً)، وباقتك تشمله (من باقة «احترافي» وفوق)، ويكون فيه مزوّد نموذج مضبوط — إمّا سلسلة uMarker نفسها (Groq وGoogle Gemini اليوم) أو مفتاحك أنت. شوف مساعد الفرز الذكي.
رمز الاتصال: الاعتماد mdc_… اللي يبدّله مختبِر الإضافة بجلسة. uMarker يعرضه مرّة وحدة وقت ما تنشئه ويخزّن hash له فقط؛ ويظلّ شغّالاً لين تدوّره أو تسحبه، وهو الشي الوحيد اللي تطلبه الإضافة. عامله معاملة كلمة المرور — أي أحد يمسكه يقدر يتصل باسم ذاك المختبِر. شوف الدعوات والانضمام.
الرؤى: تجميع للقراءة فقط عبر التقارير والاستبيانات، لمساحة أو لمشروع. متاحة من باقة «احترافي». شوف لوحة الرؤى.
سجلّ التغييرات: الصفحة العامة المستضافة اللي تسرد وش شحنت؛ ونفس المدخلات تظهر داخل الودجت باسم «ما الجديد». متاح من باقة «البداية». شوف الإعلانات وسجل التغييرات.
سجلّ الكونسول: مخرجات كونسول المتصفّح الملتقطة مع تقرير الوضع التقني والمعروضة بخطّ ثابت في صفحة التقرير. شوف وش يُلتقط بالضبط.
السنيبت: وسم <script> تلصقه في موقعك. يحمّل v1.js من مضيف uMarker API، وما يحتاج الزائر يركّب شيئاً. شوف تركيب السنيبت.
شريط الهامش: الشريط البرتقالي المرسوم حول هامش العنصر المفحوص؛ وهو قابل للنقر، فيقدر المُبلِّغ يعلّق على الفراغ نفسه بدل أقرب شيء فيه. شوف السنيبت مقابل الإضافة.
عزل الحسابات: نموذج العزل، account_id ونطاق عام يُطبَّق على كل طلب مُصادَق؛ أمّا المسارات العامة (الودجت) فتُرشَّح صراحةً بمعرّف المشروع. وطلب سجلّ يخصّ حساباً ثانياً يرجع 404 لا 403. شوف عزل الحسابات.
العرض المحفوظ: مُرشِّح وارد باسم، مشترك مع المساحة. وحفظ واحد متاح من باقة «البداية». شوف العروض المحفوظة والإجراءات الجماعية.
فتات المسار: مدخلة في سلسلة مؤرّخة لآخر أفعال المُبلِّغ (نقرات، إدخالات، تغييرات مسار) تُلتقط بجانب الكونسول في تقارير الوضع التقني فقط. معرّفات الحقول فقط، أبداً مو اللي كُتب فيها. شوف السياق التقني.
فحص العناصر: وضع الالتقاط بأسلوب DevTools. المرور يُضيء أعمق عنصر مع نموذج صندوقه، والأسهم تصعد في الشجرة، والتعليق يُربط بذلك العنصر وبمُحدِّد CSS الخاص به. شوف السنيبت مقابل الإضافة.
القدرة (ميزة الباقة): ميزة إمّا تشملها الباقة أو لا، منها الاستبيانات، والأدوار المخصّصة، ووصول الـAPI، وتعدّد المساحات. محور مختلف عن الصلاحية: الصلاحية تقول وش يقدر الشخص يسوي، والقدرة تقول وش يملكه الحساب. شوف الأدوار والصلاحيات.
القناة: وجهة مشتركة يسلّم إليها uMarker الأحداث، وهي سلاك، أو تيليجرام، أو مايكروسوفت تيمز، أو webhook صادر موقّع. والبريد مو قناة: هو تفضيل شخصي لكل شخص. شوف القنوات.
الكتم: إسكات شخصي لكل مشروع، يوقف الإشعارات عنك أنت، وما يغيّر شيئاً مما يستقبله فريقك. شوف البريد والإشعارات.
متتبّع المهام: وجهة GitHub أو Linear أو Jira موصولة، يُدفَع إليها التقرير كتذكرة ويُحفظ رابطها على التقرير. شوف متتبّعات المهام.
مسار التوزيع: القاعدة اللي ترسل أحداثاً مختارة من تكامل موصول إلى وجهة، لكل مشروع. الاعتماد يُدخَل مرّة وحدة على مستوى الحساب، والمسار يقرّر أي مشروع يستعمله ولأي حدث. شوف متتبّعات المهام.
المساحة: الغلاف اللي تسكن فيه المشاريع (الحساب ← المساحة ← المشروع). كل حساب يبدأ بوحدة اسمها General؛ وأي مساحة تنحذف، حتى هذي، وحذفها يحذف المشاريع اللي داخلها — وuMarker يرجّع General أول ما تدخل وما عندك ولا وحدة. ونظرة المساحات أول شاشة بعد الدخول. شوف المساحات.
المشروع: اللي يتعلّق به الودجت ونطاقاته وتقاريره واستبياناته وإعداداته. يخصّ حساباً واحداً ومساحة وحدة. شوف المفاهيم والمصطلحات.
المصادقة الثنائية: خطوة دخول ثانية، بتطبيق مصادقة أو برمز على البريد، ومعها رموز استعادة. متاحة من باقة «البداية». شوف حسابك الشخصي وأمانه.
المُحدِّد الحسّاس: مُحدِّد CSS توسمه فيُموَّه عنصره قبل الالتقاط، مهما كان محتواه. وما يُقرأ إلا ومفتاح الإخفاء مشغّل على ذاك المشروع، فالقائمة لحالها ما تسوّي شي. شوف إخفاء البيانات الحسّاسة.
مختبِر الإضافة: شخص تأذن له يلتقط عبر الإضافة، مربوط بمشاريع محدّدة وينسحب في أي وقت. وما يدخل اللوحة إطلاقاً. شوف الدعوات والانضمام.
المفتاح العام: المفتاح غير السرّي في سنيبت المشروع، يقول لـv1.js أي مشروع يحمّل إعداداته. شوف تركيب السنيبت.
مفتاح API: اعتماد REST يُعرض مرّة وحدة بصيغة md_live_… ويُخزَّن hash فقط؛ يكون على مستوى الحساب أو مقصوراً على مشروع واحد. وسكّه ميزة مدفوعة. شوف مفاتيح الـAPI.
المقعد: شخص واحد يشتغل باللوحة ضمن باقتك. المقاعد مشمولة بالباقة لا مسعّرة بالرأس، والدعوة المعلّقة تشغل مقعداً. شوف الدعوات والانضمام.
المكرّر: تقرير مربوط بتقرير ثانٍ باعتباره نفس المشكلة، يُربط من صفحة التقرير، والرابط يظهر من الطرفين. شوف صفحة التقرير.
الملخّص اليومي: خيار بريدي يجمع إشعارات الشخص في رسالة وحدة بدل ما يرسل كل واحد فوراً. والساعة تخصّ uMarker مو أنت — 08:00، وتوصل بتوقيت كل شخص نفسه. وهو بريد، فيحتاج باقة «البداية» أو فوق. شوف البريد والإشعارات.
«ما الجديد»: قائمة آخر مدخلات سجل التغييرات، معروضة لزوّار المشروع داخل الودجت. متاحة من باقة «البداية». شوف الإعلانات وسجل التغييرات.
النطاق: مضيف موقع مربوط بمشروع، عشان يعرف uMarker أي مشروع ينطبق على الصفحة. والنطاق هو وحدة التسعير الرئيسية في الباقة؛ والمشاريع والمقاعد والمساحات والمختبِرون والتكاملات والتخزين تنعدّ كمان. شوف تركيب السنيبت.
الودجت: أداة الالتقاط داخل الصفحة، معزولة في shadow DOM، فما يقدر CSS موقعك يوصل لها وما تتسرّب أنماطها بره. والاستثناء الوحيد المقصود هو أداة الالتقاط: تخفي مؤشّر الصفحة وهي مفتوحة وترجّعه لمّا تخلص. يوصّلها السنيبت أو الإضافة. شوف السنيبت مقابل الإضافة.
وضع الالتقاط: إعداد لكل مشروع من الودجت ← الإعداد يقرّر وش يحمل التقرير، في السنيبت والإضافة سواء. عادي (الوضع اللي تبدأ عليه المشاريع الجديدة): اللقطة والعلامات والملاحظات والصفحة والجهاز. تقني: كل هذا وفوقه الكونسول وطلبات الشبكة والأخطاء والأداء وفتات المسار والبيئة. والتقرير يحتفظ بالوضع اللي انرسل فيه. شوف السياق التقني.
مصطلحات لاتينية
Section titled “مصطلحات لاتينية”NPS: Net Promoter Score، استبيان من 0 إلى 10، ودرجته = نسبة المروّجين (9–10) ناقص نسبة المنتقدين (0–6). شوف الاستبيانات.
CSAT: رضا العميل، سلّم رضا من 1 إلى 5، ونتائجه تعرض المتوسّط والتوزيع. أمّا النجوم والإيموجي فهي أنواع أسئلة داخل استبيان نموذج، مو نوع CSAT. شوف الاستبيانات.
CES: مقياس جهد العميل، استبيان على سلّم موافقة، ونتائجه تعرض المتوسّط والتوزيع. شوف الاستبيانات.
MCP: الواجهة اللي تخلي وكيل برمجة يقرأ واردك ويتصرّف في التقارير. تتصادق بمفتاح API، فتحتاج باقة مدفوعة. شوف خادم MCP.
Webhook: نداء HTTP صادر موقّع يرسله uMarker على الأحداث المشترَك فيها، ويحمل ترويسة X-uMarker-Signature يتحقّق منها المستقبِل. شوف Webhooks الصادرة.