مراجعة الفريق

تتيح مراجعة الفريق للمتعاونين التعليق على مقاطع مختارة من مستند Markdown، والنقاش عبر جولات متعدّدة، ورؤية ملاحظات بعضهم البعض — كل ذلك مزامَن عبر مستودع Git الخاص بقاعدة المعرفة. تقيم بيانات المراجعة خارج مستندك، فيبقى نص Markdown نفسه نظيفاً.

كيف تُخزَّن المراجعات

تُحفظ المراجعات في ملفات JSON مرافقة (sidecar) ضمن دليل .moraya/ الخاص بقاعدة المعرفة، بحيث تعكس مسارات مستندك:

knowledge-base/
├── article.md
├── subdir/
│   └── note.md
└── .moraya/
    ├── reviews/
    │   ├── article.md.reviews.json
    │   └── subdir/
    │       └── note.md.reviews.json
    └── locks.json

لأن الملف المرافق منفصل عن المستند، فإن نص Markdown الخاص بك لا يتلوّث أبداً ببيانات المراجعة الوصفية. وتُودَع بيانات .moraya/reviews/ وتُزامَن مع الفريق، فيرى الجميع السلاسل ذاتها.

مراجعة مستند

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

• مفتوحة — مطروحة وبانتظار الإجراء.
• محلولة — عُولجت؛ ويسجّل الحلّ الإيداع الذي حدث فيه عندما تكون قاعدة المعرفة مرتبطة بـ Git.
• لن تُصلَح — مُقرّ بها لكن لم تُغيَّر عمداً.

لأن المراجعات تُزامَن عبر Git، تظهر تعليقات زميلك بعد أن تسحب (pull)، وتظهر تعليقاتك لهم بعد أن تدفع (push).

الأقفال المرنة

لتجنّب تحرير شخصين للملف نفسه في وقت واحد، تستخدم مراجعة الفريق أقفالاً مرنة يجري تتبّعها في .moraya/locks.json. عندما تبدأ العمل على مستند، يمكن قفله ليُحذَّر المتعاونون قبل إجراء تعديلات متعارضة. الأقفال إرشادية ومشتركة عبر مزامنة Git ذاتها، فتنسّق عمل الفريق دون حجب سير عمل أحد بشكل قسري.

الخطوة التالية

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