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

دورة حياة الحالة

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

القيم المخزّنة حرفية: الوارد والفلاتر وأعمدة اللوحة والـAPI كلها تستخدم هذي السلاسل.

new (جديد)

وصل للتوّ وما فتحه أحد. كل تقرير يبدأ هنا أول ما يُحفَظ.

in_progress (قيد التنفيذ)

أحدهم أمسكه: يفحص، أو يعيد إنتاج المشكلة، أو يصلّح.

waiting (بانتظار ردّ)

معطّل على غيرك. سألت المُبلِّغ سؤالاً، أو تنتظر طرفاً ثالثاً. مو متروكاً، ومو شغّالاً عليه كذلك.

resolved (تم الحل)

خلص: انحلّ، أو أُجيب عليه، أو تُصرِّف فيه بشكل ما.

archived (مؤرشف)

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

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

أي حالة تنتقل لأي حالة ثانية مباشرة: new طوالي إلى resolved، وresolved رجعة إلى in_progress، وarchived رجعة إلى new. وفي كل طريق يمشيه إنسان — صفحة التقرير، والسحب على اللوحة، والإجراء الجماعي، والـREST API — الخادم يتحقّق إن الهدف واحد من الخمس وبس، وما يفحص شي ثاني في النقلة.

وفيه مسار واحد بالخادم يشوف التقرير جاي من وين، وهو مو إنسان: webhook المتتبّع ما يطلّع التقرير من archived أبداً. شوف تبويب المتتبّع تحت.

الطرق الأربع لتغيير الحالة

Section titled “الطرق الأربع لتغيير الحالة”
  1. افتح التقرير. شوف صفحة التقرير.
  2. اختر الحالة الجديدة في بطاقة الفرز.
  3. تُحفظ أول ما تختار، ويجيك تأكيد.

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

النسبة: مَن غيّر وش ومتى

Section titled “النسبة: مَن غيّر وش ومتى”

تغيير الحالة على تقرير واحد يُكتب في سجل التدقيق كـfeedback.status_changed، ويحمل التقرير والوقت والنقلة نفسها بـfrom وto. وكل الطرق الأربع اللي تمسّ تقريراً واحداً تكتبه: القائمة المنسدلة، والسحب على اللوحة، والـREST API، وwebhook المتتبّع.

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

أمّا الإجراء الجماعي فيُسجَّل بشكل ثاني: صفّ واحد feedback.bulk يقول وش الإجراء وكم تقرير طُبِّق وكم واحد تُخطّي — ما يقول أي تقارير تحرّكت ولا من وين تحرّكت. يعني الإقفال الجماعي يخلّي أثراً للدفعة، وما يخلّي أثراً لكل تقرير.

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

الإشعارات عند تغيير حقيقي

Section titled “الإشعارات عند تغيير حقيقي”

تغيير الحالة ما يُشعِر إلا لمّا تتغيّر القيمة فعلاً. وضع التقرير على الحالة اللي هو فيها أصلاً لا يسوّي شيئاً ولا يُبلِّغ أحداً.

والانتقال إلى resolved يُعامَل كحدث خاص به، مختلف عن أي نقلة ثانية. وكل طريق يوصله يظهر كـresolved: القائمة المنسدلة، والسحب على اللوحة، والإجراء الجماعي، والـREST API، وwebhook المتتبّع. فمن اشترك فيه من قناة أو عضو يسمع بالإقفال مهما كان اللي سوّاه. وكل نقلة ثانية status_change عادية.

ومَن يسمع، وعبر أي قناة، يتبع تفضيلات كل عضو في إشعاراته وقنوات المشروع في القنوات.

  • شخصان في نفس اللحظة. آخر كتابة تفوز: ما فيه قفل ولا تحذير تعارض، فالكتابة المتأخّرة هي اللي تثبت وبس. وسجل التدقيق يسجّل النقلتين بالترتيب، مو الفائزة وحدها — وهذا اللي يخلّيك تعرف بعدين إنه صار فيه اثنتان.
  • أقدم من نافذة تاريخ باقتك. التقرير خارج النافذة، فتغيير حالته مرفوض عليه: من صفحة التقرير، ومن الإجراء الجماعي، ومن الـAPI سواء بسواء. هو مخفيّ، ما انحذف.