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

كيف يشتغل uMarker

uMarker تطبيق Laravel واحد له وجهان (لوحة وAPI) ومعهما سنيبت الموقع وإضافة المتصفّح اللي يغذّونه. والملاحظة تمشي في نفس المسار مهما كان السطح اللي التقطها.

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

  2. الاستقبال: على الخادم. التقرير يُرسَل POST للـAPI. وuMarker يعيد التحقّق من الصلاحية على الخادم ويرفض افتراضياً: رأي العميل في «هل أنا مسموح لي هنا» استئناسي بس. طلب السنيبت لازم يحلّ مفتاحاً عاماً حيّاً لمشروع منشور، ويجي من نطاق من نطاقات ذلك المشروع المسموحة؛ وطلب الإضافة لازم يحمل توكناً صالحاً، ويكون المختبِر لسه مصرّحاً له على ذلك المشروع. والمُدخَلات تمرّ على قائمة سماح عند حدّ الثقة هذا — أي حقل ما له قاعدة يُرمى ولا يُخزَّن — والحمولة مسقوفة: 5000 محرف للتعليق، و50 دبوساً بالكثير، و12 ميغابايت للقطة الواحدة، وقوائم الكونسول (200 مُدخَل) وبيانات المتصفّح (16 كيلوبايت) وقوائم الإثراء كلها تُسقَف من جديد على الخادم بدل ما ناخذ كلام السنيبت عن حدوده. ولمشروع على الالتقاط العادي، أي بيانات تقنية توصل على أي حال تُرمى. وبيانات الهوية اللي تربطها صفحتك بالسنيبت مسقوفة بـ16 كيلوبايت.

  3. الفرز: في اللوحة. التقرير ينزل في الوارد بحالة new. اللي يفرز يفتحه، يقرأ السياق المرفق، ويتصرّف: يحطّ أولوية وتسميات ومُسنَداً إليه، أو يكتب تعليقاً بمنشن، أو يعلّم دبابيس بعينها «تمّ»، أو يدفع التقرير لمتتبّع مهام.

  4. الحلّ: الحالة تتحرّك new ← in_progress ← waiting ← resolved مع تقدّم الشغل (ومعها archived لللي ما بتسوّونه). وكل تغيير منسوب لصاحبه ووقته في سجلّ التدقيق. ولو كان التقرير مربوطاً بتذكرة، إغلاق التذكرة يحرّك التقرير عنك.

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

السنيبت والإضافة يلتقطون في المتصفّح، وتطبيق Laravel يصرّح ويستقبل ويخزّن، واللوحة تفرز. MySQL يحمل البيانات، وقرص تخزين كائني يحمل الوسائط.

BROWSER (the reporter's) LARAVEL APP
┌───────────────────────┐ ┌──────────────────────────────────┐
│ Website widget │ │ ┌────────────────────────────┐ │
│ • <script> loader │──── HTTPS ───▶│ │ API │ │
│ • public key │ JSON │ │ resolve key → check │ │
│ • shared capture UI │ │ │ domain → gate → ingest │ │
└───────────────────────┘ │ │ (re-validated, fail-closed)│ │
┌───────────────────────┐ │ └──────────────┬─────────────┘ │
│ Browser extension │──── HTTPS ───▶│ │ │
│ • connection token │ JSON │ ┌──────────────▼─────────────┐ │
│ • shared capture UI │ │ │ Dashboard │ │
│ • real tab capture │ │ │ inbox · triage · engage │ │
└───────────────────────┘ │ └────────────────────────────┘ │
│ │ │
│ MySQL ◀──┴──▶ object │
│ storage │
└─────────────┬────────────────────┘
│ queued jobs (dispatched after the write)
▼
email · Slack / Teams / Telegram ·
signed webhooks · trackers (by plan)
[in-app bell: written on the request]

مساران: تفاعلي واستباقي

Section titled “مساران: تفاعلي واستباقي”

نفس المنصّة تشغّل الملاحظات بالاتجاهين.

تفاعلي: التقاط ← فرز ← حلّ

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

استباقي: تسأل، ثم تخبر

أنت اللي تبدأ. الاستبيانات (NPS و CSAT و CES واستبيانات حرّة) تجمع إجابات مُهيكلة، والإعلانات تدفع «ما الجديد» داخل الودجت. والاثنان يتشاركان تسميات الحساب، فالإجابات تنزل بنفس مفردات الفرز.

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

وين تقع الأجزاء المتحرّكة

Section titled “وين تقع الأجزاء المتحرّكة”
  1. التخزين: كل لقطة تُكتب عبر قرص ملفّات، مو عبر مسار خام، وما تنكشف أبداً كـرابط دلو عام. وفتح التقرير يمرّر الصورة من خلال التطبيق، مفحوصة مقابل الحساب والمشروع ودورك. وفيه مساران يستخدمان رابطاً موقّعاً بدل ذلك، لأن قارئهما ما يقدر يحمل توكن: مصغّرات اللوحة ومعرض الوسائط، موقّعة لستّ ساعات؛ واللقطة اللي يحطّها uMarker في تذكرة متتبّع المهام، اللي يفتحونها ناس برّا حسابك — هذي موقّعة طول ما اللقطة محفوظة، وفي باقة ما تحطّ حدّ احتفاظ للوسائط (المؤسسات) ما ينتهي الرابط أبداً. وللقطات نافذة احتفاظ خاصة بها، منفصلة عن نافذة التقرير: تقدر الصورة تُمسَح ويبقى التقرير ونقاشه.

  2. الطابور: الاستقبال ما ينتظر الآثار الجانبية البطيئة. البريد ورسائل القنوات ونداءات المتتبّعات كلها مهامّ في طابور، تُرسَل بعد ما يُعتمَد صفّ التقرير. والشي الوحيد اللي مو في الطابور هو جرس الإشعارات: صفّه يُكتب على نفس الطلب، عشان الجرس يتحدّث بلا ما يكون فيه عامل شغّال — إلا في الفرز الجماعي، فما فيه أحد يراقب الجرس وقتها، فينضمّ للطابور مع الباقي. وكل مستقبِل وكل قناة معزولة عن الثانية، فمزوّد بريد وصل حدّه ما يقدر يبلع رسالة سلاك لنفس التقرير بصمت. والوجهات اللي تقدر تستخدمها تتبع الباقة: الويبهوكس الموقّعة في كل الباقات ومنها المجاني؛ والبريد وسلاك وتيليجرام وتذاكر GitHub تبدأ من البداية؛ وMicrosoft Teams وJira وLinear من احترافي.

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