المطورون — واجهة البرمجة
واجهةُ برمجةٍ تقول الحقيقة: مسودة v0.
هذه الصفحة مسودة معلنة لا وثيقة نهائية: أشكال الأحداث كما نبنيها اليوم، منشورةٌ ليراجعها فريقكم التقني مبكرًا — وما سيتغير قبل الإتاحة العامة سنقوله لا سندفنه.
واجهة سيملس v0 مسودةٌ منشورة: أحداث تُدفع لا تُستطلع، بمفردات حقولٍ واحدة — event وactor وgates وlane وapproval وts — وكل نداءٍ على الواجهة يُكتب قيدًا في السجل نفسه الذي يراقب كل شيءٍ آخر.
{
"event": "request.completed",
"actor": { "role": "analyst", "dept": "finance" },
"gates": { "identity": "ok", "permission": "ok",
"balance": "-1", "record": "written" },
"lane": "accuracy",
"approval": null,
"ts": "2026-06-12T12:47:09+03:00"
}مسودة v0 — قيد توضيحي بالشكل المنشور في صفحة التقنية؛ النهائي مع الوثيقة التقنية.
مبادئ التصميم — مسودة v0
أربعة مبادئ تقرأ منها الواجهة كلها.
الواجهة امتدادٌ للبوابة لا بابًا خلفيًا عليها: ما يحكم المحادثات يحكم النداءات — هوية، وصلاحية، ورصيد، وقيد.
- أحداثٌ لا استطلاع. السجل يدفع ما حدث إلى وجهاتكم — لا حلقات سحبٍ تخمّن متى تسأل.
- أقل صلاحية للرموز. رمزٌ لكل غرضٍ بنطاقه الأضيق، يُلغى وحده دون أن يسقط غيره — ولا رمز «يفتح كل شيء».
- ترقيم إصدارات صريح. v0 تعني مسودة، والنسخة في كل حمولة — والكسر يُعلن قبل أن يقع لا بعد أن يكسر.
- كل نداءٍ قيد. نداءات الواجهة نفسها أحداثٌ في السجل — من قرأ، وماذا صدَّر، وبأي رمز.
{
"event": "approval.granted",
"actor": { "role": "finance.manager", "dept": "finance" },
"gates": { "identity": "ok", "permission": "ok",
"balance": "0", "record": "written" },
"lane": "accuracy",
"approval": { "request": "REQ-0042",
"clause": "usage-policy/export",
"scope": "single-request" },
"ts": "2026-06-12T12:46:30+03:00"
}مسودة v0 — الموافقة تحمل دورًا مسمى ورقم طلبٍ وبند السياسة الذي استندت إليه.
{
"event": "export.requested",
"actor": { "role": "audit.lead", "dept": "internal-audit" },
"gates": { "identity": "ok", "permission": "ok",
"balance": "0", "record": "written" },
"lane": null,
"export": { "range": "2026-05-01..2026-05-31",
"format": "json", "destination": "siem" },
"approval": null,
"ts": "2026-06-12T12:49:18+03:00"
}مسودة v0 — حتى طلبُ التصدير حدثٌ يُدفع: المدى والصيغة والفاعل، قيد توضيحي.
الويبهوكس — مسودة
التسليم تصميمٌ معلن، لا تفصيلة متروكة للحظ.
تشتركون في عائلات الأحداث التي تعنيكم — approval.* وexport.* مثلًا — فتصل الحمولة إلى نقطتكم لحظة كتابة القيد. وما يلي هو موقف التصميم في المسودة، قبل أرقامه النهائية.
- إعادة المحاولة بتراجعٍ معلن. الفشل يعاد بمحاولاتٍ متباعدة ثم يُقيَّد تعذّر التسليم — لا حدث يضيع بصمت. الإيقاع الدقيق مع الوثيقة.
- توقيعٌ لكل تسليم. كل حمولة موقّعة لتتحقق نقطتكم من مصدرها — تصميمًا، قبل أن يكون إعدادًا.
- بياناتٌ وصفية لا محتوى. الحمولة تحمل وقائع الحدث لا نص المحادثة — وسياسة المحتوى قرار جهتكم في مكانه الصحيح.
الاستقرار والإصدار
من مسودةٍ صادقة إلى عقدٍ مستقر.
مسار النسخة معلنٌ مثل كل شيءٍ هنا — أربع محطات لا خامسة خفية.
الأشكال التي تقرؤها في هذه الصفحة — قابلة للتغيير، ومعلنة كذلك.
الوثيقة التقنية الكاملة تحت اتفاقية سرية — وملاحظات فريقكم تدخل المسودة.
الوثيقة تصير علنية، والبيئة التجريبية تفتح، وسجل التغييرات يبدأ من سطره الأول.
تغييرٌ كاسر بلا إعلانٍ مسبق يخالف قوانيننا — والسجل يشمل قراراتنا نحن أيضًا.
لا تواريخ معلنة قبل أن تصير التزامًا — «قريبًا» عندنا تعني قريبًا.
لمهندسي المنصات: اقرؤوا المسودة كما تقرؤون طلب دمج.
أرسلوا اعتراضاتكم على الأشكال قبل أن تستقر — جلسة تقنية واحدة تدخل ملاحظاتُها المسودةَ فعلًا.
أسئلة المهندسين
تُسأل عند كل مراجعةٍ للمسودة.
متى تستقر الواجهة؟
مع الإتاحة العامة: v0 الحالية مسودة معلنة تُراجع مع الدفعة الأولى، وvNext تستقر عند الإطلاق — وكل تغييرٍ كاسر قبلها وبعدها يُعلن صراحةً، لا يُكتشف في سجل أخطائكم.
أين التوثيق التفاعلي الكامل؟
الوثيقة التقنية الكاملة تُشارك تحت اتفاقية سرية أثناء التقييم، وتصير علنيةً مع الإتاحة العامة. هذه الصفحة تنشر عمدًا ما هو صادق اليوم: الأشكال والمبادئ — لا واجهة استعراضٍ فارغة.
كيف تتم المصادقة على النداءات؟
رموز بأقل صلاحية تُنشأ من لوحة التحكم بنطاقٍ وغرضٍ مسميين، وتُلغى منفردة — وإنشاء الرمز وإلغاؤه واستخدامه ثلاثتها قيود في السجل. تفاصيل التدوير والمدد مع الوثيقة التقنية.
أكمل المسار
من الأشكال إلى التكاملات.
ساهموا في المسودة قبل أن تصير عقدًا.
جلسة تقنية واحدة: الأشكال الثلاثة على شاشةٍ حيّة، واعتراضات فريقكم تُكتب أمامكم — هكذا تُبنى واجهةٌ تخدم معماريتكم لا معماريتنا.
مسودة v0 — الأشكال تتغير قبل الإتاحة العامة وكل كسرٍ يُعلن.