تخطَّ إلى المحتوى
تسجيل الدخولاطلب حساب

المفاهيم والمصطلحات

مفردات uMarker قليلة. افهم هذي العشرة أو اثني عشر مصطلحاً وباقي التوثيق يمشي معك بسهولة. وهي أربع مجموعات: البنية (مين يملك وش)، والأشخاص (مين يسوّي وش)، والتقرير (وش يُلتقَط)، والفرز (كيف يتحرّك).

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

المساحة: تجميعة مشاريع، وهي الوحدة اللي تتنقّل بها. مو اختيارية ولا ميزة للخبراء: بعد ما تسجّل دخولك تنزل على شبكة المساحات، وكل مشروع يخصّ مساحة وحدة بالضبط. وفيه مساحة اسمها General تُنشأ مع حسابك، تقدر تعيد تسميتها وتعطيها لوناً مميّزاً، وتحذفها مثل أي مساحة ثانية.

إنشاء مساحات إضافية صلاحية مدفوعة، من باقة احترافي وفوق: كل حساب عنده General أصلاً، فالصلاحية معناها «أكثر من وحدة». وعلى المجاني والبداية تشتغل في مساحة وحدة، وهذا الشكل الطبيعي لفريق منتج واحد.

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

النطاق: ربط موقع بمشروع (example.com). وللنطاقات شغلتان. أول شي، يحلّون الصفحة الواردة إلى مشروع واحد على الأكثر، بشكل حتمي، عشان يعرف uMarker وين ينزل التقرير. وثاني شي، هم قائمة النطاقات المسموحة اللي تقرّر وين يُسمَح لودجتك يشتغل أصلاً. قائمة فاضية تعني إنه ما يشتغل بأي مكان، ومشروع بلا نطاق حيّ ما ينقدر ينشر. وتداخل النطاقات بين مشاريع نفس الحساب ممنوع.

منشور مقابل مسودّة: المشروع منشور لمّا يكون ودجته مباشراً. والنشر يسكّ مفتاحاً عاماً لو ما عنده واحد، ويرفض لو ما فيه نطاق حيّ، فما تقدر «منشور» تعني «مباشر بس ميت». وإرجاعه مسودّة يوقّف الودجت ويحتفظ بالمفتاح، فالسنيبت اللي ملصوق عندك بالموقع ما ينكسر.

عضو الفريق: واحد عنده دخول للوحة، مدعوّ بالبريد. وفيه مقعدان مدمجان: مدير اللي يحلّ لكل الصلاحيات، وعضو اللي يفرز ولا يدير. ومن باقة احترافي وفوق تقدر تعرّف أدواراً مخصّصة بمصفوفة صلاحيات، وتعطي واحداً دوراً مخصّصاً على مشروع واحد يتجاوز الدور اللي يحمله على الحساب، فمراجِع من عند عميلك يشوف مشروعاً واحداً وما يشوف غيره. وكل باب يمنح صلاحية عليه سقف منع تصعيد: ما تقدر تعطي صلاحية ما تملكها أنت.

مختبِر الإضافة: هوية لـالالتقاط، مو للفرز. هؤلاء المختبِرون والعملاء وأصحاب المصلحة اللي يتصلون عبر إضافة المتصفّح. والمختبِر ما ياخذ كلمة مرور للوحة: تضيف بريده على مشروع وتعطيه رمز اتصال (mdc_…) يُعرَض مرّة وحدة بس. ويكون مُسنَداً للمشاريع اللي تربطه فيها، وفي أي وقت تقدر تصدر له رمزاً جديداً (وهذا يوقّف جلساته الشغّالة)، أو تشيله من المشروع، أو تحذف المختبِر كاملاً.

الملاحظة (التقرير): الكائن الأساسي. إرسالة وحدة من السنيبت أو الإضافة: لقطة للصفحة كاملة — كل المستند مو بس اللي كان ظاهر على الشاشة، أو كل محتوى اللوح اللي يتمرّر على صفحة بأسلوب التطبيقات — ودبوس مرقّم أو أكثر، كل واحد يحمل تعليقه، والسياق التلقائي. واللي يحمله هذا السياق يتبع وضع الالتقاط للمشروع (الودجت ← الإعداد): العادي — اللي تبدأ عليه المشاريع الجديدة — يحمل الصفحة والجهاز بس؛ والتقني يضيف رسائل الكونسول، وطلبات الشبكة، والأخطاء، والأداء، وخطوات الوصول، والبيئة. والتقرير يحتفظ بالوضع اللي انرسل فيه. وفيه قطعة زيادة موجودة لكل مشروع بس تجيك مطفيّة وما لها ولا تحكّم في أي شاشة لين الحين — لوحة العنصر المُحلَّل — فالتقرير اليوم ما يحملها إلا إذا ضبطت العلم عبر الـAPI.

العلامة (الدبوس): تعليق واحد على التقرير. أداة الالتقاط تنتج علامات من أنواع: عنصر (اللي أشّر عليه الفاحص، ومعه مُحدِّد CSS الخاص به)، ومسافة (نقرة على شريط الهامش البرتقالي، ومعها الجهة)، والأنواع الحرّة (دبوس تعليق، وتظليل، ورسم). والهندسة مُطبَّعة 0–1 على نفس المساحة اللي تغطّيها اللقطة، فالعلامات تُعاد فوق اللقطة النظيفة بالضبط. وفي اللوحة، لكل علامة خيط تعليقات خاص بها وحالة تمّ خاصة بها.

إخفاء البيانات: التمويه اللي يصير في متصفّح المُبلِّغ نفسه قبل ما تُؤخذ اللقطة. الإخفاء خاصيّة في الالتقاط، مو شي يُلحَق على الخادم بعدين. وفيه جزء شغّال دائماً: قيم معاملات الرابط اللي أسماؤها توحي بسرّ تُفرَّغ، على كل مشروع. أمّا تمويه قيم الحقول الظاهرة وأي منطقة تسمّيها بمُحدِّد CSS فهو مفتاح لكل مشروع، مطفي لين تشغّله.

مسار الالتقاط: الطريق اللي يمشيه التقرير، وهو التقاط (المتصفّح) ← استقبال (الخادم يعيد فحص الصلاحية ويرفض افتراضياً) ← فرز (اللوحة) ← حلّ ← واختيارياً إقفال الحلقة. ونفس المسار يشتغل أياً كان السطح اللي التقط.

الحالة: وين التقرير في حياته. المجموعة ثابتة: new وin_progress وwaiting وresolved وarchived. وكل تغيير منسوب لفاعل ووقت في سجلّ التدقيق.

الأولوية: كم هو مستعجل، none أو low أو medium أو high أو urgent، يحطّها اللي يفرز عشان يرتّب اللوحة.

الإسناد: عضو الفريق اللي يُسلَّم له التقرير. مالك واحد، مسؤول عن تحريكه للأمام.

التسمية: وسم من تسميات المساحة المشتركة. نفس المجموعة تنطبق على الملاحظات والإجابات معاً، فالإشارة تتكلّم مفردات وحدة. وحسابك يجي بمجموعة بادئة من أربع تسميات — علة وفكرة وسؤال وتحسين — كل وحدة لها اسم بالعربي واسم بالإنجليزي، فكل قارئ يشوف لغته.

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

المفتاح العام: المُعرِّف md_… اللي يحمله الودجت في خاصيّة data-umarker-key. وهو عامّ بالتصميم: يحلّ مشروعاً واحداً وما يمنح أي وصول لحسابك بنفسه. وكل تحكّم حقيقي مفروض على الخادم: فحص النطاقات المسموحة، والتحقّق، وحدود الطلبات، وسقف الحجم، ومفتاح النشر. تقدر تدوّره أو تسحبه من شاشة السنيبت في المشروع؛ والتدوير يصفّر حالة التثبيت لأن السنيبت القديم صار ميتاً.

مفتاح الـAPI: اعتماد سرّي للـREST API ولخادم MCP، مخزَّن مُجزَّأً، ونطاقه إمّا الحساب كله وإمّا مشروع واحد — والأضيق هو اللي يُفضَّل. بعكس المفتاح العام، هذا يصادق وصولاً برمجياً ولازم يبقى سرّياً.

شوية مصطلحات بتقابلك بعد أول التقاط:

  • الاستبيان: استبيان قصير استباقي (NPS أو CSAT أو CES أو حرّ) يُعرَض عبر نفس الودجت، بأسئلة تقييم ونجوم وإيموجي واختيار مفرد ونصّ. والإجابات تتشارك التسميات وتُصدَّر CSV.
  • الإعلان وسجل التغييرات: «ما الجديد» داخل المنتج لمستخدميك، ومعه صفحة سجل تغييرات عامة مستضافة تقدر تحطّ رابطها وين ما تبي.
  • الرؤى: تجميعة للقراءة بس فيها توزيع الحالات، ومنحنى 14 يوماً للتقارير، وأعلى التسميات عبر الملاحظات والإجابات، ونتائج الاستبيانات الرئيسية، بنطاق مساحة أو مشروع.
  • مسار التوزيع: كيف يوصل الاعتماد للمشروع. تربط المتتبّع أو القناة مرّة وحدة على مستوى الحساب، وبعدين توجّهها لكل مشروع بمفاتيح لكل حدث، فالوكالة ما تعيد لصق توكن Jira لكل عميل.