التصويت والقرارات

يحدد نظام التصويت في OpenPR نتيجة مقترحات الحوكمة. يدعم التصويت الموزون ومتطلبات نصاب قابلة للإعداد وعتبات موافقة. كل تصويت وقرار يُسجَّل مع سجل تدقيق غير قابل للتغيير.

عملية التصويت

1. يدخل مقترح حالة Voting.
2. يُدلي أعضاء مساحة العمل المؤهلون بأصواتهم (موافقة، رفض، أو امتناع).
3. عند انتهاء فترة التصويت أو بلوغ النصاب، تُحصى الأصوات.
4. تُحدَّد النتيجة بعتبة الموافقة المُعيَّنة.
5. يُنشأ سجل قرار بالنتيجة.

إعداد التصويت

تُهيَّأ إعدادات الحوكمة لكل مساحة عمل:

الإعداد	الوصف	مثال
النصاب	الحد الأدنى من نسبة المصوتين المؤهلين الذين يجب أن يشاركوا	50%
عتبة الموافقة	نسبة أصوات نعم المطلوبة للموافقة	66%
فترة التصويت	مدة نافذة التصويت المفتوحة	7 أيام
التصويت الموزون	ما إذا كانت درجات الثقة تؤثر على وزن التصويت	تشغيل/إيقاف

هيِّئ هذه في Workspace Settings > Governance > Config، أو عبر API:

curl -X PUT http://localhost:8080/api/governance/config \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "quorum_percentage": 50,
    "approval_threshold": 66,
    "voting_period_days": 7,
    "weighted_voting": true
  }'

التصويت الموزون

عند تفعيل التصويت الموزون، يُضرَب صوت كل عضو في درجة ثقته. الأعضاء ذوو درجات الثقة الأعلى لهم تأثير أكبر على النتيجة. راجع درجات الثقة للتفاصيل.

سجلات القرارات

كل تصويت مكتمل ينشئ سجل قرار -- إدخال سجل غير قابل للتغيير يحتوي على:

• المقترح الذي جرى التصويت عليه
• إحصاءات الأصوات (موافقة، رفض، امتناع)
• النتيجة النهائية (موافق عليه أو مرفوض)
• الطابع الزمني والمصوتون المشاركون
• نطاق القرار (إن صُنِّف)

لا يمكن تعديل سجلات القرارات أو حذفها. تعمل كسجل موثوق لقرارات الفريق.

عرض القرارات

# List decisions
curl -H "Authorization: Bearer <token>" \
  http://localhost:8080/api/decisions

# Get a specific decision
curl -H "Authorization: Bearer <token>" \
  http://localhost:8080/api/decisions/<decision_id>

آلية النقض

يمكن للناقضين المُعيَّنين (مُعيَّنون لكل مساحة عمل) نقض المقترحات الموافق عليها:

1. النقض -- يحجب الناقض مقترحاً موافقاً عليه مع ذكر السبب.
2. التصعيد -- يمكن لمقدم المقترح تصعيد النقض إلى تصويت أوسع.
3. الاستئناف -- يمكن لأي عضو تقديم استئناف ضد النقض.

حق النقض مصمم كآلية أمان للقرارات عالية التأثير. هيِّئ الناقضين في Workspace Settings > Governance > Vetoers.

سجلات التدقيق

جميع إجراءات الحوكمة مُسجَّلة في سجل التدقيق:

• إنشاء المقترحات وتقديمها وأرشفتها
• الأصوات المُدلى بها (من، متى، ماذا)
• سجلات القرارات
• أحداث النقض والتصعيدات
• تغييرات الإعداد

# View governance audit logs
curl -H "Authorization: Bearer <token>" \
  http://localhost:8080/api/governance/audit-logs

نطاقات القرار

يمكن تصنيف القرارات في نطاقات (مثل "Architecture" أو "Process" أو "Tooling") لتنظيم أفضل وتصفية. النطاقات مُعيَّنة لكل مساحة عمل.

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

• درجات الثقة -- كيف تؤثر درجات الثقة على أوزان التصويت
• المقترحات -- إنشاء مقترحات تخضع للتصويت
• نظرة عامة على الحوكمة -- مرجع وحدة الحوكمة الكامل