لا تنجح قوائم التحقق. ولا يترسخ التدريب. وتكتشف عمليات التدقيق المشاكل بعد أشهر من حدوثها.
لا تنجح قوائم التحقق. ولا يترسخ التدريب. وتكتشف عمليات التدقيق المشاكل بعد أشهر من حدوثها.
ماذا لو جعلت هندستك البرمجية عدم الامتثال أمرًا مستحيلًا؟
الوحدة المدارية = كيان + سمات + صفحات
تعتمد كل صناعة خاضعة للتنظيم على قوائم التحقق:
المشكلة: تعتبر قوائم التحقق مجرد اقتراحات. تعتمد على تذكّر البشر واهتمامهم وتوفر الوقت لديهم. يتم تخطي الخطوات تحت الضغط. ويتم تجاوز البروتوكولات في حالات الطوارئ. وتصبح الاختصارات ممارسة معتادة أثناء ضغط العمل.
النتيجة: اكتشاف إخفاقات الامتثال بعد أشهر خلال عمليات التدقيق، مما يؤدي إلى غرامات ودعاوى قضائية وأضرار.
ماذا لو لم يستطع البرنامج تخطي الخطوات؟
ليس مربع حوار تحذيري. ليس شريطًا أحمر. الـ transition (الانتقال بين حالتين في state machine) نفسه غير موجود ما لم تتحقق الشروط.
هذه هي طريقة عمل كل سير عمل في Almadar. يوضح نظام تفتيش حكومي قمنا ببنائه هذا الـ pattern (نمط التصميم):
{
"name": "InspectionWorkflow",
"entity": {
"name": "Inspection",
"fields": [
{ "name": "phase", "type": "enum", "values": ["introduction", "content", "preparation", "record", "closing"] },
{ "name": "legalBasis", "type": "string" },
{ "name": "findings", "type": "string" },
{ "name": "measures", "type": "string" },
{ "name": "inspectorSignature", "type": "boolean", "default": false },
{ "name": "subjectSignature", "type": "boolean", "default": false },
{ "name": "caseNumber", "type": "string" }
]
}
}كل transition بين المراحل محمي بمتطلبات قانونية:
{
"from": "Introduction",
"to": "Content",
"event": "PROCEED",
"guard": ["and",
["not-empty", "@entity.legalBasis"],
["not-empty", "@entity.caseNumber"]
],
"effects": [
["set", "@entity.phase", "content"],
["log", "info", "Phase transition: Introduction → Content"]
]
}لا يستطيع المفتش الانتقال إلى مرحلة المحتوى دون إدخال الأساس القانوني ورقم القضية. لا يوجد زر "تخطي". لا يوجد تجاوز. الـ transition غير موجود حتى يُقيَّم الـ guard (شرط يجب تحققه قبل السماح بالانتقال) بالقيمة الصحيحة.
{
"from": "Record",
"to": "Closing",
"event": "CLOSE_INSPECTION",
"guard": ["and",
["not-empty", "@entity.legalBasis"],
["not-empty", "@entity.findings"],
["not-empty", "@entity.measures"],
["=", "@entity.inspectorSignature", true],
["=", "@entity.subjectSignature", true]
],
"effects": [
["set", "@entity.phase", "closing"],
["persist", "update", "Inspection", "{"menuOpen":false,"path":"","title":"الامتثال كشيفرة: عندما تفرض هندستك البرمجية القانون","lede":"لا تنجح قوائم التحقق. ولا يترسخ التدريب. وتكتشف عمليات التدقيق المشاكل بعد أشهر من حدوثها.","crumbs":[{"href":"/ar/blog","label":"المدونة"},{"label":"الامتثال كشيفرة: عندما تفرض هندستك البرمجية القانون"}],"toc":[{"id":"s1","label":"مقدمة","level":2},{"id":"s2","label":"فشل قوائم التحقق","level":2},{"id":"s3","label":"البديل المعماري أولًا","level":2},{"id":"s4","label":"لماذا يختلف هذا عن التحقق التقليدي","level":2},{"id":"s5","label":"مشكلة سجل التدقيق (مَحلولة)","level":2},{"id":"s6","label":"تطبيقات في العالم الحقيقي","level":2},{"id":"s7","label":"الـ schema كمواصفة","level":2},{"id":"s8","label":"الخلاصة","level":2}],"prev":{"href":"/ar/blog/context-compaction","label":"ضغط السياق: فن تلخيص جلسة برمجة من 3 ساعات لنموذجك اللغوي"},"next":{"href":"/ar/blog/agentic-search","label":"البحث الوكيلي: تعليم الذكاء الاصطناعي التذكر كالإنسان"},"direction":"rtl","navItems":[],"sidebarLabel":"","segments":[]}"],
["emit", "INSPECTION_COMPLETED"]
]
}لإغلاق تفتيش:
يبقي أي عنصر مفقود النظام في مرحلة السجل. ليس برسالة خطأ — زر الإغلاق ببساطة لا ينتقل. لا تملك الـ state machine (نظام الحالات والانتقالات الذي يدير سير العمل) مساراً إلى الإغلاق دون تحقق جميع الشروط.
التحقق التقليدي:
function closeInspection(inspection) {
if (!inspection.legalBasis) {
showError("Legal basis required");
return; // But what if someone removes this check?
}
if (!inspection.findings) {
showError("Findings required");
return; // And this one?
}
// ... maybe 20 more checks
// What if a new developer doesn't add the check for a new field?
inspection.phase = "closing";
save(inspection);
}المشاكل:
guards في Almadar:
تحتاج الصناعات الخاضعة للتنظيم سجلات تدقيق. النهج التقليدي: تعليمات تسجيل متناثرة في الشيفرة، على أمل أن تغطي كل إجراء.
في Almadar، كل transition في الـ state machine يُسجَّل بطبيعته:
[2025-05-30T10:15:32Z] Inspection INS-2025-0847
Transition: Introduction → Content
Event: PROCEED
User: inspector-042
Guard: passed (legalBasis=filled, caseNumber=INS-2025-0847)
Effects: [set phase, log]لا يعتبر سجل التدقيق ميزة تُضيفها. بل هو نتيجة للهندسة المعمارية. يحمل كل transition يُنفَّذ حالة from وحالة to وحدث ومستخدم وطابع زمني ونتيجة الـ guard.
{
"from": "Prepared",
"to": "Administered",
"event": "ADMINISTER",
"guard": ["and",
["=", "@entity.patientVerified", true],
["=", "@entity.medicationVerified", true],
["=", "@entity.dosageVerified", true],
["=", "@entity.allergyCheckPassed", true],
["not", "@entity.expired"]
]
}خمسة فحوصات. كلها إلزامية. لا يستطيع الممرض/ة إعطاء الدواء دون اجتياز كل واحد منها.
{
"from": "PendingApproval",
"to": "Approved",
"event": "APPROVE",
"guard": ["and",
["!=", "@payload.approverId", "@entity.requesterId"],
[">=", "@user.approvalLimit", "@entity.amount"],
["if",
[">", "@entity.amount", 50000],
[">=", "@entity.approvalCount", 2],
true
]
]
}{
"from": "Testing",
"to": "Released",
"event": "RELEASE",
"guard": ["and",
[">=", "@entity.testsPassed", "@entity.testsRequired"],
["=", "@entity.defectsFound", 0],
["not-empty", "@entity.qualitySignoff"]
]
}لا يُشحن أي منتج دون اجتياز جميع الاختبارات وعدم وجود عيوب وتوقيع الجودة.
هنا تكمن القوة الحقيقية: يعتبر الـ schema المواصفة التنظيمية.
عندما يسأل مدقق "كيف تضمنون أن عمليات التفتيش لا يمكن إغلاقها دون اكتمال جميع الحقول؟"، لا تُحيله إلى الشيفرة. بل تُريه الـ schema:
{
"from": "Record",
"to": "Closing",
"event": "CLOSE_INSPECTION",
"guard": ["and",
["not-empty", "@entity.legalBasis"],
["not-empty", "@entity.findings"],
["=", "@entity.inspectorSignature", true]
]
}يستطيع مدقق غير تقني قراءة هذا. لا يحتاج تفسيراً. إنه يقول: للانتقال من السجل إلى الإغلاق، يجب ألا يكون الأساس القانوني فارغًا، ويجب ألا تكون النتائج فارغة، ويجب أن يكون المفتش قد وقّع.
تعد المواصفة والتنفيذ نفس الأداة. لا يمكن أن ينحرفا عن بعضهما أبدًا.
لا يعتبر الامتثال ميزة تُلصقها. بل هو هندسة معمارية.
تجعل guards الـ state machine عدم الامتثال مستحيلًا — ليس مثبطًا، وليس محذَّرًا منه، بل مستحيلًا. لا تملك الـ state machine transition إلى المرحلة التالية دون تحقق الشروط المطلوبة.
بالنسبة للصناعات الخاضعة للتنظيم، هذا يعني:
لا يكمن السؤال في "كيف نجعل الناس يتبعون قائمة التحقق؟" بل "كيف نجعل قائمة التحقق غير ضرورية؟"
تعرف على المزيد حول عبارات الـ guard والـ closed circuit pattern.
وكلاء ذكاء اصطناعي خاصّون على أجهزتك.