لنفرض أنك في شركة ناشئة تبيع القهوة المختصة وأدواتها عبر متجر إلكتروني، وفريق التسويق فيها لا يتوقف: هذا الأسبوع خصم 10% للعميل الجديد إذا تجاوزت سلته 200 ريال، والأسبوع القادم شحن مجاني فوق 150 ريالاً، ويوم الجمعة خصم على الأدوات، وفي آخر الشهر عرض على من يشتري ثلاثة أكياس قهوة. وكل عرض من هذه العروض يصل إلى فريق التطوير كتذكرة Ticket، فيكتب مبرمج شرطاً جديداً في كود صفحة الدفع، ويراجعه زميل، ثم ينتظر النشر، وفي أحيان كثيرة يبدأ العرض متأخراً يوماً أو يومين عن الإعلان. وبعد شهرين من هذا يأتي الطلب الذي يأتي في كل شركة: «أعطونا مكاناً نكتب فيه العروض بأنفسنا».
وفي مقال ابن مفسراً صغيراً بيدك بنينا لغة صيغ حسابية من الصفر، ورأينا كيف يعمل المحلل اللغوي والمحلل النحوي والمنفذ. أما هنا فالسؤال مختلف: ليس كيف تبني مفسراً، وإنما ماذا تبني أصلاً. هل يحتاج فريق التسويق لغة؟ أم يكفيه ملف JSON أو YAML؟ أم مكتبة في كود Python؟ وإذا قررت أن تبني لغة، فكيف تصممها حتى يفهمها من ليس مبرمجاً، وتمنعه من الخطأ، وتخبره بالعربية ماذا أخطأ، ولا تسمح لقاعدة واحدة أن تبيع المتجر بنصف سعره؟ وهذه الأسئلة هي موضوع لغات المجال Domain-Specific Languages، واختصاراً DSL.
وسوف نناقش في هذا المقال ما يلي:
- ما هي لغة المجال، وأنواعها الثلاثة: الخارجية External والداخلية Internal واللغة التي تنمو داخل ملفات الإعداد، مع أمثلة تستخدمها كل يوم: SQL وRegex وCSS وHCL وGradle Kotlin DSL وتعبيرات GitHub Actions.
- أربع محاولات لكتابة نفس العروض في المتجر: داخل الكود، ثم في JSON، ثم كلغة داخلية بلغة Python، ثم كلغة خارجية خاصة بالمتجر، وما حدث في كل محاولة مع خطأ إملائي واحد.
- متى تستحق اللغة تكلفتها، ومتى يكفي YAML أو مكتبة أو لغة جاهزة.
- تصميم لغة العروض: الجمل قبل القواعد Grammar، والكلمات المفتاحية، والأنواع Types والوحدات Units، وما حذفناه منها عمداً.
- التنفيذ الآمن Safe Evaluation: المال بالنوع
Decimal، وسياسة جمع الخصومات، والسقف، وحد المتجر الذي لا تستطيع أي قاعدة تجاوزه. - رسائل الخطأ بالعربية، ومشكلتان حقيقيتان ظهرتا في المختبر: خطأ أخفى خطأين، ورسالة انقلب ترتيبها بسبب النص ثنائي الاتجاه Bidi.
- الاختبارات بالأمثلة الذهبية Golden Tests وبالخصائص Property Tests، وماذا يحدث عندما يكتب فريق التسويق قاعدة لا تعرفها اللغة.
ما هي لغة المجال Domain-Specific Language؟
لغة المجال لغة صغيرة مصممة لنوع واحد من المشكلات، على عكس اللغة العامة General-purpose Language مثل Python وJava التي تكتب بها أي برنامج. ويعرفها Martin Fowler في صفحته عن لغات المجال بأنها لغة حاسب موجهة لنوع معين من المشكلات، ويذكر أن أمثلتها منتشرة منذ بدايات الحوسبة: CSS والتعبيرات النمطية وmake وSQL. والفكرة أن المستخدم يكتب بكلمات مجاله لا بكلمات البرمجة، فمن يكتب SELECT title FROM courses يقول «ماذا أريد» ولا يقول «كيف أبحث في الملفات»، ومن يكتب color: red لا يعرف شيئاً عن طريقة رسم المتصفح للصفحة.
والتقسيم المفيد الذي يقترحه Fowler في نفس الصفحة هو بين اللغة الخارجية واللغة الداخلية، ونضيف إليهما نوعاً ثالثاً يصادفه كل من يعمل في DevOps: اللغة التي تنمو داخل ملف إعداد.

اللغة الخارجية External DSL: قواعدها ومحللها خاصة بها
اللغة الخارجية لها نص مستقل وقواعد Grammar مستقلة ومحلل Parser يقرؤها، ولا تحتاج أن تعرف أي لغة أخرى لتكتبها. فلغة SQL التي شرحناها في سلسلة تعلم SQL لغة خارجية، وكذلك التعبيرات النمطية Regex، ولغة CSS، ولغة HCL التي تكتب بها ملفات Terraform وOpenTofu كما رأينا في مقال Terraform أم OpenTofu؟. والميزة الكبرى للغة الخارجية أنك تتحكم في كل شيء: الكلمات المتاحة، وما يعنيه كل تركيب، والرسالة التي تظهر عند الخطأ، وما لا يمكن كتابته أصلاً. والثمن أنك تبني كل شيء: المحلل، والفاحص، ورسائل الخطأ، والتوثيق، وفي النهاية أدوات التحرير التي يتوقعها المستخدم مثل الخط الأحمر تحت الخطأ، وقد رأينا في مقال كيف يفهم المحرر كودك؟ كم يكلف ذلك.
اللغة الداخلية Internal DSL: لغة داخل لغة
اللغة الداخلية لا تملك محللاً خاصاً بها، وإنما تستعمل قواعد لغة مضيفة Host Language بطريقة تجعلها تبدو كلغة جديدة. والمثال الأشهر Gradle Kotlin DSL، فملف build.gradle.kts يبدو كوصف للمشروع بكتل plugins { } وdependencies { }، ولكن توثيق Gradle يقول صراحة إن كل ما في هذا الملف كود Kotlin يترجمه Gradle وينفذه، والكتل نفسها تقنية في Kotlin اسمها البناة الآمنة النوع Type-safe Builders. والميزة أنك لا تكتب محللاً، وتحصل مجاناً على كل أدوات اللغة المضيفة: الإكمال في المحرر، والتصحيح، والمتغيرات والدوال إذا احتجتها. والمشكلة هي نفس الميزة: المستخدم يكتب كوداً حقيقياً، فيحتاج أن يعرف اللغة المضيفة، ويستطيع أن يفعل كل ما تسمح به، وسوف نرى ذلك عملياً بعد قليل.
حين يصبح ملف YAML لغة: تعبيرات Expressions في GitHub Actions
النوع الثالث لا يقرر أحد أن يبنيه، وإنما يحدث. يبدأ النظام بملف إعداد بسيط، ثم يحتاج شرطاً، ثم مقارنة، ثم دالة، فتظهر لغة صغيرة داخل النصوص. والمثال الواضح ملفات GitHub Actions، فهي YAML في ظاهرها، ولكن الحقل if يقبل لغة تعبيرات بين ${{ }} لها قيم حرفية Literals وعوامل مقارنة ومنطق ودوال مثل contains وstartsWith وقواعد لتحويل الأنواع عند المقارنة. أي أن من يكتب ملف الـ Workflow يكتب بلغتين في نفس الوقت، ولا يوجد محلل واحد يفهم الاثنتين معاً، فالخطأ في التعبير لا يظهر إلا عند تشغيل الـ Pipeline.
وهناك سبب آخر يجعل YAML أساساً هشاً للغة، وهو أن قارئ YAML يحاول تخمين نوع كل قيمة. والملف yaml_traps.py يقرأ أربعة أسطر عادية بمكتبة PyYAML الشهيرة:
"""Why "just use YAML" is not a language: what a YAML 1.1 loader does to plain-looking values."""
import yaml
doc = """
on: push # the first line of every GitHub Actions workflow
country: NO # Norway
version: 3.10 # a Python version
start: 08:30 # a time
"""
for k, v in yaml.safe_load(doc).items():
print(f"{k!r:12} -> {v!r:8} ({type(v).__name__})")وكل التجارب في هذا المقال تعمل داخل Container من الـ Image الرسمية python:3.13.17-slim بالأمر docker run --rm --name scc3-dsl -v "$PWD/lab":/lab -w /lab python:3.13.17-slim sh run.sh A، والملف run.sh يشغل كل تجربة ويحفظ مخرجها. والمخرج سوف يكون كما يلي:
True -> 'push' (str)
'country' -> False (bool)
'version' -> 3.1 (float)
'start' -> '08:30' (str)في المخرج أعلاه لاحظ التالي:
- المفتاح
onالذي يبدأ به كل ملف GitHub Actions صار القيمة المنطقيةTrue، لأن YAML 1.1 يعتبرonوoffوyesوnoقيماً منطقية كما في تعريف النوع المنطقي في YAML 1.1. فأي أداة تقرأ ملف الـ Workflow بهذه المكتبة وتبحث عن المفتاح"on"لن تجده. - رمز النرويج
NOصارFalseللسبب نفسه. - إصدار Python
3.10صار العدد العشري3.1، فلو قرأت أداة هذا الحقل لتختار إصدار Python لاختارت إصداراً آخر. - الإصدار 1.2 من المواصفة في YAML 1.2.2 قلل هذه التخمينات، ولكن المكتبات القديمة والمنتشرة ما زالت تتبع قواعد 1.1 كما يبين المخرج.
وهذا لا يعني أن YAML سيئ، فهو ممتاز لما صمم له: قيم وقوائم وخرائط. ولكن عندما يبدأ فريقك بكتابة شروط ومنطق داخل نصوص YAML، فأنت تبني لغة دون أن تقرر ذلك، ودون محلل ودون رسائل خطأ.
أربع محاولات لنفس العروض Promotions: من الكود إلى لغة المتجر
نعود إلى متجر القهوة. العروض التي يريد فريق التسويق إدارتها أربعة: خصم 10% للعميل الجديد إذا تجاوزت سلته 200 ريال بحد أقصى 50 ريالاً، وشحن مجاني فوق 150 ريالاً أو للعميل الذهبي، وخصم 15% على الأدوات يومي الجمعة والسبت، وخصم 30 ريالاً لمن يشتري ثلاثة أكياس قهوة على ألا يجمع مع غيره. وسوف نكتب هذه العروض الأربعة بأربع طرق، وكل الملفات في مجلد before في المختبر.
المحاولة الأولى: القواعد داخل الكود Hard-coded
"""Version 1: the campaign rules live in the checkout code. Every new campaign is a code change and a deploy."""
from decimal import Decimal
def discounts(cart, subtotal, today):
applied = []
if cart["customer"]["new"] and subtotal >= 200:
applied.append(("خصم العميل الجديد", min(subtotal * Decimal("0.10"), Decimal(50))))
tools = sum(l["price"] * l["qty"] for l in cart["lines"] if l["category"] == "tools")
if today in ("fri", "sat") and tools > 0:
applied.append(("أدوات نهاية الأسبوع", tools * Decimal("0.15")))
beans = sum(l["qty"] for l in cart["lines"] if l["category"] == "beans")
if beans >= 3 and Decimal(30) > sum(a for _, a in applied):
applied = [("ثلاثة أكياس قهوة", Decimal(30))]
return applied
def shipping(cart, subtotal):
if subtotal >= 150 or cart["customer"].get("tier") == "gold":
return Decimal(0)
return Decimal(25)هذا الكود صحيح ومختبر، و21 سطراً فقط، ولكن لاحظ أين يسكن المنطق: «ثلاثة أكياس لا تجمع مع غيرها» صارت شرطاً يقارن 30 بمجموع ما قبله، وترتيب الأسطر صار جزءاً من المعنى، فلو نقلت شرط الأكياس إلى الأعلى لتغيرت النتيجة. وكل عرض جديد يعني تعديل هذه الدالة ومراجعة ونشر إصدار، وهذه هي المشكلة التي بدأنا بها. ومع ذلك فهذا الحل هو الأنسب إذا كانت العروض تتغير مرة كل ستة أشهر، فلا تبن لغة لمشكلة لا تتكرر.
المحاولة الثانية: ملف JSON وخطأ لا يراه أحد
الخطوة التالية الطبيعية أن تنقل العروض إلى ملف بيانات يقرؤه النظام، ويعدله فريق التسويق من لوحة الإدارة أو مباشرة:
[
{ "name": "خصم العميل الجديد",
"when": { "all": [ { "field": "customer.new", "op": "eq", "value": true },
{ "field": "cart.subtotal", "op": "gte", "value": 200 } ] },
"then": { "discount": { "percent": 10, "on": "cart", "cap": 50 } } },
{ "name": "شحن مجاني",
"when": { "any": [ { "field": "cart.subtotal", "op": "gte", "value": 150 },
{ "field": "customer.tier", "op": "eq", "value": "gold" } ] },
"then": { "free_shipping": true } },
{ "name": "أدوات نهاية الأسبوع",
"when": { "all": [ { "field": "today", "op": "in", "value": ["fri", "sat"] },
{ "count": { "category": "tools" }, "op": "gte", "value": 1 } ] },
"then": { "discount": { "percent": 15, "on": { "category": "tools" } } } },
{ "name": "ثلاثة أكياس قهوة",
"when": { "all": [ { "count": { "category": "beans" }, "op": "gte", "value": 3 } ] },
"then": { "discount": { "amount": 30, "on": "cart" }, "stack": false } }
]والمنفذ json_rules.py في 29 سطراً يمشي على الشروط المتداخلة ويقرر أي قاعدة تنطبق. ولاحظ أننا اضطررنا إلى اختراع تركيب للمنطق all وany، وأسماء للعمليات gte وeq وin، وشكل خاص للعد count، أي أننا بدأنا نصمم لغة دون أن نسميها كذلك. والسؤال الحقيقي: ماذا يحدث عندما يخطئ أحد في كتابة اسم حقل؟ الملف rules-typo.json مطابق للأول إلا في حرف واحد، فقد صار cart.subtotal هو cart.subtotl. وهذا مخرج الملفين على نفس سلة العميل الجديد:
applies خصم العميل الجديد
applies شحن مجاني
applies أدوات نهاية الأسبوع
applies ثلاثة أكياس قهوة
no خصم العميل الجديد
applies شحن مجاني
applies أدوات نهاية الأسبوع
applies ثلاثة أكياس قهوةخصم العميل الجديد اختفى، ولم تظهر أي رسالة خطأ. والسبب في سطرين من المنفذ: fields.get(cond["field"]) أعاد None للحقل المجهول، والمقارنة None >= 200 رفعت TypeError فالتقطها المنفذ واعتبر الشرط غير متحقق. وكان يمكن أن نجعل المنفذ أكثر صرامة، ولكن لاحظ أن الصرامة تعني مخططاً Schema للحقول وأنواعها وفحصاً عند الحفظ ورسالة واضحة، أي كل ما تحتاجه اللغة. وفي نظام أسعار، الخطأ الصامت أسوأ نتيجة ممكنة، فالعميل الجديد لم يحصل على الخصم المعلن، ولن يعرف أحد إلا عندما تصل الشكاوى.
المحاولة الثالثة: لغة داخلية Internal DSL بلغة Python
المحاولة الثالثة يقترحها عادة مبرمج يحب الكود الأنيق: لماذا لا نكتب العروض بلغة Python نفسها، ولكن بواجهة تقرأ كجمل؟ والملف internal_dsl.py يبني هذه الواجهة في نحو 60 سطراً باستخدام إعادة تعريف العوامل Operator Overloading، فيصبح & هو «و» و| هو «أو»، ثم تكتب العروض هكذا:
# ---- the rules, as the marketing team would have to write them ----
rule("خصم العميل الجديد").when(customer_new & (subtotal >= sar(200))).discount(percent=10).capped(sar(50))
rule("شحن مجاني").when((subtotal >= sar(150)) | (tier == "gold")).free_shipping()
rule("أدوات نهاية الأسبوع").when(today.isin("fri", "sat") & (count("tools") >= 1)).discount(percent=15, on="tools")
rule("ثلاثة أكياس قهوة").when(count("beans") >= 3).discount(amount=sar(30)).exclusive()وعند التشغيل يطبع كل قاعدة بشرطها، ثم يجرب شيئاً أخيراً:
خصم العميل الجديد: when (customer.new and cart.subtotal >= 200)
شحن مجاني: when (cart.subtotal >= 150 or customer.tier == 'gold')
أدوات نهاية الأسبوع: when (today in ('fri', 'sat') and count(tools) >= 1)
ثلاثة أكياس قهوة: when count(beans) >= 3
rule with arbitrary code accepted: Trueالقواعد الأربع مقروءة لمبرمج، والإكمال يعمل في المحرر، والخطأ في اسم دالة يظهر كخطأ Python. ولكن السطر الأخير هو المشكلة: قاعدة شرطها يستورد الوحدة os ويقرأ مجلد العمل قبلت دون أي اعتراض، لأن «اللغة» هنا هي Python، وكل ما تستطيعه Python تستطيعه القاعدة. وهذا نفس الدرس الذي رأيناه مع eval في مقال المفسر، فلا تعط لغة داخلية لمن لا تثق في كوده، ولاحظ أيضاً أن فريق التسويق لن يكتب & بين قوسين وهو مرتاح، ولا يعرف لماذا تحتاج subtotal >= sar(200) قوسين حولها حتى تعمل مع &. لذلك اللغة الداخلية ممتازة عندما يكون المستخدمون مبرمجين، مثل ملفات البناء في Gradle، وغير مناسبة عندما يكون المستخدمون فريقاً آخر.
المحاولة الرابعة: لغة خارجية External DSL خاصة بالمتجر
والمحاولة الأخيرة هي لغة العروض التي بنيناها في الملف promo.py، وهذه نفس العروض الأربعة كما يكتبها فريق التسويق في الملف rules.promo:
# عروض متجر القهوة لشهر نوفمبر، يكتبها فريق التسويق
rule "خصم العميل الجديد"
when customer.new and cart.subtotal >= 200 SAR
then discount 10% on cart
cap 50 SAR
rule "شحن مجاني"
when cart.subtotal >= 150 SAR or customer.tier = "gold"
then free shipping
rule "أدوات نهاية الأسبوع"
when today in [fri, sat] and count(category "tools") >= 1
then discount 15% on category "tools"
rule "ثلاثة أكياس قهوة"
when count(category "beans") >= 3
then discount 30 SAR on cart
stack noالملف 14 سطراً بدون التعليقات، وكل قاعدة تقرأ كجملة: اسم، ثم متى، ثم ماذا، ثم الخيارات. والأهم من الشكل ما يحدث عند الخطأ، فنفس الخطأ الإملائي cart.subtotl يعطي هنا رسالة بالسطر والعمود ومعها «هل تقصد cart.subtotal؟» لحظة الحفظ، قبل أن يصل إلى أي عميل، كما سوف نرى في قسم رسائل الخطأ. والصورة التالية تجمع المحاولات الأربع بالأرقام.

متى تستحق اللغة تكلفتها؟ معايير القرار Criteria
الملف promo.py فيه 587 سطراً مع التعليقات، والاختبارات 72 سطراً، وهذا قبل التوثيق ودعم المحرر وتدريب الفريق، وكل ميزة تضيفها للغة تبقى معك ما دام هناك ملف قديم يستخدمها. لذلك قبل أن تبني لغة، مر على هذه الأسئلة:
- من يكتب؟ إذا كان الكاتب مبرمجاً في نفس الفريق، فالكود العادي أو مكتبة جيدة أو لغة داخلية تكفي غالباً، ولا تحتاج محللاً. اللغة الخارجية تبدأ تستحق تكلفتها عندما يكتب فريق آخر لا يعرف لغة النظام.
- كم مرة يتغير؟ إذا كانت القواعد تتغير كل أسبوع وكل تغيير ينتظر نشراً، فالتكلفة تتراكم على الطرفين. وإذا كانت تتغير مرتين في السنة، فلا تبن شيئاً.
- هل المجال مغلق؟ العروض تتكلم عن سلة وعميل وفئات ومبالغ، وهذه مجموعة صغيرة ومعروفة. أما إذا كان كل طلب جديد يحتاج مفهوماً جديداً، فسوف تعيد بناء لغة عامة سيئة.
- ما ثمن الخطأ؟ في الأسعار والصلاحيات والمال، الخطأ الصامت مكلف جداً، وهذا يبرر مخططاً وفحصاً ورسائل واضحة، أي يبرر لغة.
- هل توجد لغة جاهزة؟ للسياسات والصلاحيات توجد لغة Rego في OPA، وللتعبيرات توجد CEL التي ذكرناها في مقال المفسر، وللاستعلام توجد SQL. واستعمال لغة جاهزة لها توثيق ومجتمع أفضل من بناء لغة خاصة إذا كانت تغطي مجالك.
- هل تحتاج أن تشرح النتيجة؟ في العروض يسأل فريق الدعم كل يوم «لماذا لم يحصل العميل على الخصم؟»، واللغة التي تعرف معنى كل قاعدة تستطيع أن تطبع سجلاً بما طبق وما لم يطبق ولماذا، وهذا صعب جداً مع كود عادي.
وفي حالة متجر القهوة كانت الإجابات واضحة: يكتب فريق غير تقني، والعروض تتغير أسبوعياً، والمجال مغلق، والخطأ يكلف مالاً وسمعة، ولا توجد لغة جاهزة تفهم «الشحن المجاني» و«الفئات» دون طبقة فوقها. لذلك بنينا اللغة، وما تبقى من المقال عن كيف صممناها.
تصميم اللغة Language Design: ابدأ من جمل المستخدمين
اكتب البرامج قبل القواعد Grammar
أكثر خطأ شائع في تصميم لغة أن تبدأ من القواعد أو من المحلل، فتخرج لغة تناسب المحلل لا المستخدم. والطريقة الأفضل أن تجلس مع فريق التسويق وتجمع العروض الحقيقية التي نفذوها في آخر ستة أشهر كما قالوها بكلماتهم، ثم تكتب كل واحد منها بالشكل الذي تتمنى أن تكون عليه اللغة، دون أي اعتبار للتنفيذ، ثم تقرأها معهم. فإذا قرأ أحدهم when customer.new and cart.subtotal >= 200 SAR وفهمها دون شرح، فالشكل صحيح. وإذا سأل «ماذا تعني stack no؟» فهذه كلمة تحتاج تغييراً أو توثيقاً. وبعد أن تستقر الجمل، تستخرج منها القواعد، ولا العكس.
ومن هذه الجلسات خرجت قرارات اللغة: كل قاعدة تبدأ بالكلمة rule واسم بين علامتي تنصيص، لأن الاسم يظهر في الفاتورة وفي سجل الخصومات. ثم when للشرط وthen للإجراء، لأن الفريق يفكر بالعروض كجملة شرطية. ثم الخيارات cap وpriority وstack، ولكل واحدة سطر مستقل حتى تقرأ كبند في عقد.
الكلمات المفتاحية Keywords: عربية أم إنجليزية؟
السؤال الذي يطرح نفسه في أي لغة لفريق عربي: لماذا لا تكون الكلمات إذا وخصم وعلى؟ والفكرة جذابة، ولكن جربها في المحرر وسوف ترى المشكلة: سطر فيه كلمات عربية وأرقام وعلامات مقارنة وأسماء حقول إنجليزية مثل cart.subtotal يمر على خوارزمية النص ثنائي الاتجاه Bidi في كل محرر وكل متصفح، فيتغير ترتيب عرض الأجزاء حسب ما حولها، ويصبح >= يبدو كأنه <= في بعض المواضع. وأسماء الحقول تأتي من قاعدة البيانات ومن واجهة النظام بالإنجليزية، فاللغة ستبقى خليطاً في كل الأحوال. لذلك قررنا أن تكون الكلمات المفتاحية وأسماء الحقول بالإنجليزية والسطر كله من اليسار إلى اليمين، وأن يكون العربي في ثلاثة أماكن: أسماء القواعد، والتعليقات، ورسائل الخطأ. وهذا القرار ليس الوحيد الصحيح، فإذا كان كل ما في السطر عربياً يمكن أن تكون اللغة عربية بالكامل، ولكن اتخذه بوعي بعد أن تجرب الشكل في المحرر الحقيقي الذي سوف يستخدمه الفريق.
الأنواع Types والوحدات Units: لماذا «200» وحدها خطأ؟
في أول نسخة من الجمل كتب أحد أعضاء الفريق discount 10 on cart، وكان يقصد 10%، وكتب آخر نفس الجملة يقصد 10 ريالات. وهذا الالتباس هو الذي قررت اللغة أن تمنعه: الرقم وحده عدد، مثل عدد الأكياس، و10% نسبة، و200 SAR مبلغ، والثلاثة أنواع مختلفة لا تختلط. فلا يمكن مقارنة السلة cart.subtotal وهي مبلغ بالعدد 200، ولا يمكن أن يكون سقف الخصم cap نسبة، ولا يمكن أن يكون الخصم رقماً بلا وحدة. وكل حقل في المخطط Schema له نوع معروف:
# ---------- the store's world: what a rule may talk about (the language's schema) ----------
FIELDS = { # name -> type
"customer.new": "bool",
"customer.tier": "text",
"customer.orders_this_month": "number", # added for the "third order" campaign: data, not syntax
"cart.subtotal": "money",
"cart.items": "number",
"channel": "text",
"today": "day",
}
CATEGORIES = {"beans", "tools", "cups"}وهذا المخطط هو قلب اللغة الحقيقي، فهو الذي يحدد عن أي شيء تستطيع القاعدة أن تتكلم: سبعة حقول، وثلاث فئات، وأيام الأسبوع، وقيم محددة لنوع العميل وقناة الشراء. ولاحظ السطر المكتوب عليه «added for the third order campaign»، فقد أضفناه أثناء تجربة «ماذا يحدث إذا…» في آخر المقال، وسوف نرى لماذا كان إضافة سطر واحد هنا أفضل من أي تغيير في القواعد.
ما الذي حذفناه عمداً: لا حلقات Loops ولا متغيرات Variables
أهم قرارات التصميم هي ما لا تضيفه. فلغة العروض لا تحتوي حلقات، ولا متغيرات، ولا دوال يعرفها المستخدم، ولا قراءة ملفات أو اتصال بالشبكة، ولا أي طريقة لاستدعاء كود Python. والسبب ليس الكسل، وإنما ثلاث فوائد مباشرة. الأولى أن كل قاعدة تنتهي دائماً، لأنه لا توجد حلقة يمكن أن تدور للأبد، ولا تعاود يمكن أن يتعمق، وبالتالي لا تحتاج حداً زمنياً للتنفيذ Timeout ولا حداً للخطوات كما احتجنا في لغة الصيغ. والثانية أن الأمان يأتي من البناء نفسه، فلا توجد طريقة لكتابة القاعدة التي قبلتها اللغة الداخلية، لأن القواعد لا تعرف شيئاً اسمه استيراد. والثالثة أن الفاحص يستطيع أن يفهم كل قاعدة بالكامل قبل تنفيذها، وهذا ما يجعل الرسائل دقيقة. وهذا النوع من اللغات التي تنتهي دائماً يسمى لغة كاملة Total Language، وهو ما تحتاجه في الأسعار والصلاحيات.
القواعد Grammar وشجرة القاعدة AST
بعد أن استقرت الجمل صارت القواعد بضعة أسطر بصيغة EBNF، وكل سطر فيها دالة في المحلل بطريقة النزول التعاودي Recursive Descent التي شرحناها في مقال المفسر، لذلك لن نعيد شرح المحلل هنا. والصورة التالية تعرض القواعد كاملة والشجرة التي يخرجها المحلل للقاعدة الأولى، ولاحظ أن كل عقدة في الشجرة تحمل نوعها.

وقرار الأولويات Precedence هنا مأخوذ من SQL: and أقوى من or، فالشرط a or b and c يعني a or (b and c). وقد ناقشنا اختيار هذا الترتيب مع الفريق لأنه مصدر خطأ معروف، ففي جملة «العميل الذهبي أو الجديد إذا تجاوزت سلته 200» لا يعرف أحد أين يقع «إذا»، لذلك نصيحتنا في التوثيق أن يستخدم الفريق الأقواس دائماً عند خلط and وor، وفي التدريب العملي في آخر المقال اقتراح بأن تجعل اللغة ترفض الخلط دون أقواس.
التنفيذ الآمن Safe Evaluation: من النص إلى السعر

الفاحص Checker: كل الأخطاء قبل أول عميل
المحلل يتأكد أن النص مكتوب حسب القواعد، أما الفاحص فيتأكد أن له معنى في هذا المتجر: هل الحقل موجود؟ وهل الفئة "beans" موجودة في المتجر؟ وهل القيمة "gold" من القيم المسموحة لنوع العميل؟ وهل الطرفان في المقارنة من نفس النوع؟ وهل اسم القاعدة مكرر؟ وهل النسبة بين 1% و100%؟ والفحص يحدث مرة واحدة لحظة حفظ الملف بالأمر check:
python3 promo.py check rules.promoالقواعد السليمة: 4، الأخطاء: 0، التحذيرات: 0
exit 0والقاعدة الصارمة في المنفذ: ملف فيه خطأ واحد لا يطبق منه أي قاعدة. وقد يبدو هذا قاسياً، فلماذا لا نطبق القواعد السليمة ونتجاهل التي فيها أخطاء؟ والإجابة أن القواعد مرتبطة ببعضها، فالقاعدة الحصرية تلغي غيرها، والسقف يحدد الحد، وتطبيق نصف الملف ينتج أسعاراً لم يقصدها أحد. لذلك الملف إما سليم كله فيطبق، وإما يرفض كله ويبقى الملف السابق يعمل.
سياسة الجمع Stacking والسقف Cap وحد المتجر
أصعب سؤال في أي نظام خصومات ليس كيف تحسب الخصم، وإنما ماذا تفعل عندما تنطبق ثلاث قواعد على نفس السلة. والقرارات التي اتخذناها، وكل واحد منها سطر أو سطران في الدالة apply:
def apply(rules, cart):
ctx = context(cart)
subtotal, trace = ctx["subtotal"], []
stackable, exclusive, free_ship = [], [], False
for r in sorted(rules, key=lambda r: -r.priority):
if not holds(r.when, ctx):
continue
if r.action == "free_shipping":
free_ship = True
trace.append((r.name, SHIPPING_FEE, "طبق على الشحن"))
continue
base = subtotal if r.target[0] == "cart" else money(sum(
l["price"] * l["qty"] for l in ctx["lines"] if l["category"] == r.target[1].text))
amount = money(base * r.amount.value / 100) if r.amount.type == "percent" else money(r.amount.value)
amount = min(amount, base) # a rule never takes more than its own base
if r.cap is not None and r.cap.type == "money" and amount > r.cap.value:
amount = money(r.cap.value)
(stackable if r.stack else exclusive).append((r.name, amount))
best = ("stack", sum((a for _, a in stackable), Decimal(0)), stackable)
for name, a in exclusive: # an exclusive rule wins only if it beats everything else
if a > best[1]:
best = ("exclusive", a, [(name, a)])
chosen = best[2]
for name, a in stackable + exclusive:
if (name, a) in chosen:
trace.append((name, a, "طبق"))
else:
trace.append((name, a, "لم يطبق: خصم آخر أفضل للعميل"))
discount = sum((a for _, a in chosen), Decimal(0))
limit = money(subtotal * MAX_DISCOUNT_RATE)
if discount > limit:
trace.append(("حد المتجر", limit, f"الخصم {discount} أكبر من {int(MAX_DISCOUNT_RATE * 100)}% من السلة"))
discount = limit
shipping = money(0) if free_ship else SHIPPING_FEE
total = money(subtotal - discount + shipping)
return {"subtotal": subtotal, "discount": money(discount), "shipping": shipping, "total": total, "trace": trace}في الكود أعلاه لاحظ التالي:
- كل خصم يحسب على السعر الأصلي
base، لا على السعر بعد الخصم السابق. وهذا يجعل الناتج لا يتغير إذا غير أحد ترتيب القواعد في الملف، وهي خاصية مهمة لأن فريق التسويق يرتب الملف حسب الحملات لا حسب الحساب. ولو حسبنا بالتتابع لكان 10% ثم 20 ريالاً يختلف عن 20 ريالاً ثم 10%. - الخصم لا يتجاوز قاعدته، فخصم 30 ريالاً على فئة مجموعها 20 ريالاً يصبح 20، ثم يأتي السقف
capإن وجد. - القواعد القابلة للجمع
stack yes، وهي الافتراضية، تجمع مع بعضها. والقاعدة الحصريةstack noتفوز فقط إذا كانت أفضل للعميل من مجموع غيرها، وإلا لم تطبق، والسجل يقول ذلك صراحة. - حد المتجر
MAX_DISCOUNT_RATEخارج اللغة تماماً: الخصم الكلي لا يتجاوز نصف السلة مهما كتب في الملف. وهذا حاجز يضعه المبرمج ويراجعه المدير المالي، ولا يستطيع فريق التسويق تغييره من ملف القواعد، وهذا مقصود. - كل المبالغ من النوع Decimal مقربة إلى الهللة بطريقة
ROUND_HALF_UP، لا من النوعfloatالذي يجعل0.1 + 0.2لا تساوي 0.3.
تشغيل القواعد على سلة حقيقية Cart
السلة الأولى لعميل جديد يوم الجمعة، فيها ثلاثة أكياس قهوة سعر الكيس 68 ريالاً وقمع تقطير V60 بسعر 95 ريالاً:
{ "customer": { "new": true, "tier": "none" }, "today": "fri", "channel": "web",
"lines": [ { "sku": "BEAN-ETH", "category": "beans", "price": 68, "qty": 3 },
{ "sku": "V60-02", "category": "tools", "price": 95, "qty": 1 } ] }python3 promo.py apply rules.promo carts/new-customer.json 25.00 شحن مجاني: طبق على الشحن
29.90 خصم العميل الجديد: طبق
14.25 أدوات نهاية الأسبوع: طبق
30.00 ثلاثة أكياس قهوة: لم يطبق: خصم آخر أفضل للعميل
المجموع 299.00 الخصم 44.15 الشحن 0.00 الإجمالي 254.85والمخرج سجل كامل بما حدث، وهذا السجل هو ما يقرؤه فريق الدعم عندما يتصل عميل:
- السلة 299 ريالاً، فتحقق شرط الشحن المجاني (150 فأكثر) ووفر العميل 25 ريالاً قيمة الشحن.
- العميل جديد والسلة فوق 200، فالخصم 10% أي 29.90، وهو أقل من السقف 50 فطبق كاملاً.
- اليوم جمعة وفي السلة أداة، فالخصم 15% من سعر الأدوات فقط أي 15% من 95 وهو 14.25، لا من السلة كلها.
- في السلة ثلاثة أكياس فتحققت قاعدة الأكياس، ولكنها حصرية وقيمتها 30، ومجموع القاعدتين السابقتين 44.15، فاختار المنفذ الأفضل للعميل ولم يطبقها، والسجل يقول السبب.
- الإجمالي 299 ناقص 44.15 بشحن مجاني يساوي 254.85.
والسلة الثانية لعميل ذهبي سلته صغيرة بمبلغ 79 ريالاً، فلم يتحقق أي شرط للخصم، ولكن الشحن المجاني تحقق من الشق الثاني من الشرط customer.tier = "gold":
25.00 شحن مجاني: طبق على الشحن
المجموع 79.00 الخصم 0.00 الشحن 0.00 الإجمالي 79.00رسائل الخطأ Error Messages بالعربية
المستخدم لا يقرأ القواعد ولا التوثيق في الغالب، وإنما يقرأ رسالة الخطأ، لذلك رسالة الخطأ هي الواجهة الحقيقية للغة. وكل رسالة في promo.py تجيب أربعة أسئلة: أين؟ (الملف والسطر والعمود بصيغة file:line:col التي تفهمها المحررات وتنقلك إليها بضغطة)، وماذا؟ (جملة عربية بكلمات المجال: «مبلغ بالريال» لا «type mismatch»)، وأين بالضبط في السطر؟ (السطر نفسه وتحته علامات ^ بطول الكلمة الخطأ)، وماذا أكتب بدلاً منه؟ (اقتراح جاهز). والملف bad.promo فيه سبعة أخطاء متعمدة من النوع الذي يكتبه الناس فعلاً:
rule "خصم العميل الجديد"
when customer.new and cart.subtotl >= 200
then discount 10 on cart
rule "خصم الذهبي"
when customer.tier = "glod"
then discount 12% on category "bean"
cap 15%
rule "خصم العميل الجديد"
when cart.subtotal >= 100
then discount 20 SAR on cartpython3 promo.py check bad.promobad.promo:2:25: خطأ: الحقل cart.subtotl غير معروف
when customer.new and cart.subtotl >= 200
^^^^^^^^^^^^
هل تقصد cart.subtotal؟
bad.promo:3:17: خطأ: الرقم 10 بدون وحدة، ولا أعرف هل هو نسبة أم مبلغ
then discount 10 on cart
^^
اكتب 10% للنسبة أو 10 SAR للمبلغ
bad.promo:6:24: خطأ: القيمة «glod» غير متاحة للحقل customer.tier
when customer.tier = "glod"
^^^^^^
هل تقصد gold؟
bad.promo:7:33: خطأ: الفئة «bean» غير موجودة في المتجر
then discount 12% on category "bean"
^^^^^^
هل تقصد beans؟
bad.promo:8:7: خطأ: سقف الخصم cap مبلغ بالريال
cap 15%
^^^
cap 15 SAR
bad.promo:10:1: خطأ: الاسم «خصم العميل الجديد» مستخدم في السطر 1
rule "خصم العميل الجديد"
^^^^
كل قاعدة تحتاج اسماً مختلفاً، لأن الاسم يظهر في الفاتورة وفي سجل الخصومات
bad.promo:11:25: خطأ: لا يمكن مقارنة مبلغ بالريال مع عدد
when cart.subtotal >= 100
^^^
اكتب: 100 SAR
القواعد السليمة: 2، الأخطاء: 7، التحذيرات: 0في المخرج أعلاه لاحظ التالي:
- الاقتراحات «هل تقصد cart.subtotal؟» و«هل تقصد gold؟» و«هل تقصد beans؟» تأتي من الدالة
difflib.get_close_matchesالتي تقارن الاسم المجهول بالأسماء المعروفة من المخطط، ولا تقترح شيئاً إذا لم تجد اسماً قريباً بما يكفي، فتعرض بدلاً منه القائمة الكاملة. - الخطأ
cap 15%يعطي التصحيح جاهزاًcap 15 SAR، لأن الفاحص يعرف أن السقف مبلغ. - الاسم المكرر يشرح السبب لا القاعدة فقط: «لأن الاسم يظهر في الفاتورة وفي سجل الخصومات»، وهذا أسلوب مقصود في كل الرسائل، لأن من يفهم السبب لا يكرر الخطأ.
- السطر الأخير يلخص: قاعدتان سليمتان من أربع، وسبعة أخطاء، والملف مرفوض كله.
مشكلة حقيقية Real Problem: خطأ واحد أخفى خطأين
المخرج أعلاه هو النسخة الثانية. أما النسخة الأولى من المحلل فأعطت على نفس الملف خمسة أخطاء فقط (الملف bad-before.out)، وكان سطرها الأخير:
2 قواعد، 5 أخطاء، 0 تحذيراتواختفى من القائمة خطآن: الحقل cart.subtotl في القاعدة الأولى، والاسم المكرر «خصم العميل الجديد». والسبب أن المحلل عندما وصل إلى discount 10 في السطر الثالث رفع خطأ «الرقم بدون وحدة» وانتقل إلى القاعدة التالية، وهذه هي استعادة الأخطاء Error Recovery التي تمنع خطأً واحداً من إيقاف الملف كله. ولكن القاعدة الأولى لم تصل إلى الفاحص أصلاً، لأن المحلل لم يكمل بناءها، فلم يفحص أحد شرطها، ولم يسجل أحد اسمها، فمرت القاعدة الثالثة التي تحمل نفس الاسم دون اعتراض. والنتيجة العملية سيئة: يصلح المستخدم خطأ الوحدة ويحفظ، فيظهر له خطآن جديدان لم يرهما من قبل، ويظن أن اللغة تعانده.
والإصلاح أن يحتفظ المحلل بالقاعدة الناقصة بمجرد أن يكمل شرطها، فإذا فشل الباقي وضعها في قائمة broken يفحصها الفاحص كأي قاعدة، ولكنها لا تصل إلى المنفذ أبداً:
def rules(self):
out = []
while self.peek().kind != "EOF":
if not self.word("rule"):
t = self.peek()
self.errors.append(PromoError(t.line, t.col, max(1, len(t.text)),
f"كل قاعدة تبدأ بالكلمة rule، ووجدت {describe(t)}"))
self.skip_to_rule()
continue
self.partial = None
try:
out.append(self.rule())
except Stop:
if self.partial is not None:
self.broken.append(self.partial) # still check its name and condition
self.skip_to_rule() # error recovery: resume at the next "rule"
return outوأضفنا اختباراً يمنع عودة المشكلة: قاعدة فيها خطآن، واحد في الشرط وواحد في الإجراء، ويجب أن يظهر الاثنان. وهذه القاعدة العامة في أي لغة: كل خطأ لا يظهر في نفس المرة يكلف المستخدم دورة كاملة من التعديل والحفظ.
النص ثنائي الاتجاه Bidi: لماذا انقلبت «اكتب: 100 SAR»؟
المشكلة الثانية ظهرت عندما وضعنا المخرج في صورة المقال: سطر الاقتراح «اكتب: 100 SAR» ظهر في الصورة «SAR 100 :اكتب». والسبب خوارزمية Unicode للنص ثنائي الاتجاه، فالطرفية Terminal وصندوق الكود في المتصفح من اليسار إلى اليمين، والسطر فيه كلمة عربية ثم نقطتان ثم رقم ثم كلمة إنجليزية، والخوارزمية تقرر موضع كل جزء حسب ما حوله، فتنقل النقطتين والرقم إلى مكان لم يقصده أحد. وهذه المشكلة تظهر في أي رسالة عربية فيها كود، وهي بالضبط نوع الرسائل التي تحتاجها لغة مجال لفريق عربي.
والحل في Unicode نفسه: علامات العزل Isolates. فالدالة rtl تحيط الرسالة العربية كلها بالعلامة RLI (U+2067) التي تقول «هذا جزء من اليمين إلى اليسار»، وتحيط كل جزء لاتيني داخلها بالعلامة LRI (U+2066) التي تقول «وهذا من اليسار إلى اليمين»، وتغلق كل واحدة بالعلامة PDI (U+2069):
# An Arabic message with code inside it ("اكتب: 100 SAR") is reordered by the Unicode bidi algorithm in a
# left-to-right terminal or code block. Isolate the whole message as right-to-left (RLI ... PDI) and every
# Latin run inside it as left-to-right (LRI ... PDI), so editors and browsers show it in the right order.
LATIN = re.compile(r"[\x21-\x7e](?:[\x20-\x7e]*[\x21-\x7e])?")
def rtl(text):
return "\u2067" + LATIN.sub(lambda m: "\u2066" + m.group(0) + "\u2069", text) + "\u2069"والعلامات غير مرئية، ولكن المتصفحات والمحررات الحديثة تحترمها، فيظهر السطر بالترتيب الصحيح، وهذا ما تراه في كل مخرجات المقال، وما تراه في الصورة التالية. أما الطرفيات فتختلف، فبعضها لا يطبق خوارزمية الاتجاه أصلاً ويعرض الحروف بترتيب تخزينها، لذلك إذا كانت لوحة الإدارة هي مكان عرض الأخطاء فاعرضها في عنصر HTML بالاتجاه dir="rtl" بدل صندوق كود، واجعل الأداة تخرج الأخطاء أيضاً بصيغة JSON لمن يريد أن يعرضها بطريقته.

الاختبارات Tests: أمثلة ذهبية Golden وخصائص Properties
اللغة برنامج، وملف القواعد برنامج آخر فوقه، لذلك تحتاج نوعين من الاختبارات. الأول للغة نفسها: هل تحسب صحيحاً؟ وهل تعطي الرسائل الصحيحة؟ والثاني للقواعد التي يكتبها الفريق: هل هذا العرض يعطي ما قصده التسويق؟ والملف test_promo.py يستخدم unittest من المكتبة القياسية، وفيه ثلاثة أنواع:
class Golden(unittest.TestCase):
"""each case: the cart, the expected total, the rules that must be applied"""
CASES = [
("new customer on friday", cart([("beans", 68, 3), ("tools", 95, 1)], new=True, today="fri"),
"254.85", {"شحن مجاني", "خصم العميل الجديد", "أدوات نهاية الأسبوع"}),
("gold customer, small cart", cart([("cups", 39.5, 2)], tier="gold"), "79.00", {"شحن مجاني"}),
("cap at 50 SAR", cart([("tools", 400, 2)], new=True), "750.00", {"شحن مجاني", "خصم العميل الجديد"}),
("exclusive rule wins", cart([("beans", 20, 3)]), "55.00", {"ثلاثة أكياس قهوة"}),
("store limit: half the cart", cart([("beans", 16, 3)]), "49.00", {"ثلاثة أكياس قهوة"}),
("tools on a weekday", cart([("tools", 95, 1)], today="tue"), "120.00", set()),
]- الأمثلة الذهبية Golden Tests: ست سلال حسبنا إجماليها بأيدينا قبل التشغيل، ولكل واحدة الإجمالي المتوقع والقواعد التي يجب أن تطبق. فسلة الأدوات بمبلغ 800 لعميل جديد تختبر السقف (الخصم 50 لا 80)، وسلة الأكياس الثلاثة بسعر 16 ريالاً تختبر حد المتجر، لأن الخصم الحصري 30 ريالاً أكبر من نصف السلة 48، فيصبح 24.
- اختبارات الرسائل: نص فيه خطأ معروف، والرسالة يجب أن تحتوي الاقتراح الصحيح، ومنها الاختبار الذي يمنع عودة مشكلة الخطأ المخفي.
- اختبار الخصائص Property Test: خمسة آلاف سلة عشوائية بمولد ثابت البذرة Seed حتى تتكرر النتيجة، ولكل سلة ثلاث خصائص يجب أن تتحقق مهما كانت القواعد: الإجمالي لا يكون سالباً، والخصم لا يتجاوز نصف السلة، والخصم يساوي مجموع ما يقول السجل إنه طبق.
python3 test_promo.pytest_file_has_no_errors (__main__.Golden.test_file_has_no_errors) ... ok
test_golden (__main__.Golden.test_golden) ... ok
test_number_without_unit (__main__.Messages.test_number_without_unit) ... ok
test_two_errors_in_one_rule (__main__.Messages.test_two_errors_in_one_rule) ... ok
test_unknown_field_suggestion (__main__.Messages.test_unknown_field_suggestion) ... ok
test_random_carts (__main__.Properties.test_random_carts) ... ok
----------------------------------------------------------------------
Ran 6 tests in 0.980s
OKوالخاصية الثالثة أهم مما تبدو، فهي تضمن أن السجل الذي يقرؤه فريق الدعم يقول الحقيقة، فلو أضاف أحدهم مستقبلاً خطوة تغير الخصم دون أن تكتب في السجل، فسوف تفشل هذه الخاصية في سلة ما من الخمسة آلاف. وفي متجر حقيقي أضف إلى الأمثلة الذهبية سلة لكل عرض جديد قبل أن يبدأ، يكتب فريق التسويق مبلغها المتوقع بنفسه، فإذا اختلف الحساب عن توقعهم فالخطأ في القاعدة أو في فهم اللغة، وفي الحالتين اكتشفته قبل العميل.
ماذا يحدث إذا كتب المستخدم قاعدة Rule لا تعرفها اللغة؟
بعد أسبوعين من استخدام اللغة جاء فريق التسويق بطلبين جديدين، وكتبهما في الملف wont_fit.promo كما تخيلوا أن اللغة تقبلهما:
# طلبان جديدان من فريق التسويق
rule "الطلب الثالث هذا الشهر"
when customer.orders_this_month >= 2
then discount 15% on cart
rule "اشتر اثنين والثالث مجاناً"
when count(category "beans") >= 3
then cheapest free on category "beans"wont_fit.promo:4:8: خطأ: الحقل customer.orders_this_month غير معروف
when customer.orders_this_month >= 2
^^^^^^^^^^^^^^^^^^^^^^^^^^
الحقول المتاحة: customer.new، customer.tier، cart.subtotal، cart.items، channel، today
wont_fit.promo:9:8: خطأ: الإجراء غير معروف: «cheapest»
then cheapest free on category "beans"
^^^^^^^^
الإجراءات المتاحة: discount 10% on cart، discount 20 SAR on cart، free shipping
القواعد السليمة: 1، الأخطاء: 2، التحذيرات: 0اللغة رفضت الاثنين برسالة واضحة، وهذا أول نجاح: لم تخمن، ولم تطبق شيئاً قريباً، ولم تتجاهل القاعدة بصمت كما فعل محرك JSON. ولكن لاحظ أن الطلبين مختلفان تماماً في طبيعتهما، والفرق بينهما هو أهم درس في صيانة أي لغة مجال.
الطلب الأول «خصم في الطلب الثالث هذا الشهر» مكتوب بشكل تفهمه اللغة تماماً: حقل، ومقارنة، وعدد. والناقص بيانات فقط، فالمتجر لا يعرف عدد طلبات العميل في هذا الشهر. والحل لا يمس القواعد Grammar ولا المحلل ولا المنفذ: سطر في المخطط يعرف الحقل customer.orders_this_month ونوعه عدد، وسطر في الدالة context يأخذ قيمته من نظام الطلبات. وبعد التعديل:
wont_fit.promo:9:8: خطأ: الإجراء غير معروف: «cheapest»
then cheapest free on category "beans"
^^^^^^^^
الإجراءات المتاحة: discount 10% on cart، discount 20 SAR on cart، free shipping
القواعد السليمة: 1، الأخطاء: 1، التحذيرات: 0 18.60 الطلب الثالث هذا الشهر: طبق
المجموع 124.00 الخصم 18.60 الشحن 25.00 الإجمالي 130.40الطلب الأول صار مقبولاً، وسلة عميل في طلبه الثالث بمبلغ 124 ريالاً حصلت على خصم 15% أي 18.60. أما الطلب الثاني «اشتر اثنين والثالث مجاناً» فما زال مرفوضاً، لأنه لا يحتاج بيانات وإنما معنى جديداً: إجراء لا يحسب نسبة ولا مبلغاً، وإنما يختار عنصراً من السلة. وقبل أن تضيفه للغة، لاحظ كم قراراً يحتاج: الأرخص بأي سعر، قبل الخصومات الأخرى أم بعدها؟ وإذا اشترى ستة أكياس، هل يأخذ اثنين مجاناً؟ وإذا كانت الأكياس بأسعار مختلفة، أيها؟ وهل يجمع مع خصم الأكياس الثلاثة؟ وكل إجابة تصبح جزءاً من اللغة للأبد، وكل ملف قديم يجب أن يبقى يعمل بعدها.

والخيارات أمامك أربعة. أن تضيف التركيب الجديد للغة، وهذا مناسب إذا تكرر الطلب في أكثر من حملة وصار جزءاً من طريقة عمل المتجر. أو أن تضيف إجراء مسمى يكتبه مبرمج في Python ويستدعيه الملف باسمه فقط، مثل then effect "bogo_beans"، فتبقى اللغة صغيرة ويبقى الكود الخاص تحت المراجعة، وهذا مناسب لحالة نادرة. أو أن ترفض وتقترح تقريباً، فتقول لفريق التسويق إن «خصم 33% على الأكياس عند شراء ثلاثة» قريب من العرض ولكنه ليس هو، لأن الأكياس بأسعار مختلفة. أو أن تتعلم من الطلب أن المجال أوسع مما ظننت، وأنك تعيد بناء لغة عامة، فتبحث عن لغة جاهزة. والقاعدة التي نتبعها: لا تضف للغة تركيباً بسبب طلب واحد، وانتظر حتى يتكرر، فالإضافة سهلة اليوم، والحذف بعد أن تكتب به مئة قاعدة شبه مستحيل.
أخطاء شائعة Common Mistakes في تصميم لغة مجال DSL
- البدء من المحلل والقواعد قبل جمل المستخدمين: تخرج لغة تناسب المبرمج لا الفريق الذي يكتب بها.
- بناء لغة لمشكلة لا تتكرر: إذا كانت القواعد تتغير مرتين في السنة فالكود العادي أرخص بكثير.
- ترك ملف YAML أو JSON يتحول إلى لغة دون قرار: شروط متداخلة بلا مخطط، وأخطاء صامتة مثل
cart.subtotl، وقيم تتغير أنواعها مثلonوNOو3.10. - إعطاء لغة داخلية لمن لا تثق في كوده: القاعدة التي استوردت
osقبلت دون اعتراض. - أرقام بلا وحدات: «10» نسبة عند شخص ومبلغ عند آخر، والحل أن تكون الوحدة جزءاً من القيمة.
- رسائل خطأ بلغة المبرمج: «type mismatch» أو Traceback بدل «لا يمكن مقارنة مبلغ بالريال مع عدد، اكتب: 100 SAR».
- التوقف عند أول خطأ، أو استعادة تسقط القاعدة كلها فتخفي أخطاءها الأخرى، كما حدث مع النسخة الأولى.
- تطبيق نصف الملف عندما يكون فيه خطأ: القواعد مترابطة، والنتيجة أسعار لم يقصدها أحد.
- جعل النتيجة تعتمد على ترتيب القواعد في الملف دون أن يعرف الكاتب ذلك.
- وضع حدود المتجر داخل اللغة حيث يستطيع الملف تغييرها، بدل حاجز خارجي مثل
MAX_DISCOUNT_RATE. - إضافة تركيب جديد مع كل طلب: كل تركيب يبقى للأبد، والطلب الذي ينقصه بيانات يحل بحقل لا بتركيب.
- نسيان النص ثنائي الاتجاه في الرسائل العربية: الرسالة الصحيحة قد تظهر مقلوبة الأجزاء.
جدول قرار Decision Table: لغة أم YAML أم مكتبة؟
| الحالة | الأنسب | والسبب |
|---|---|---|
| قيم وإعدادات بلا شروط | YAML أو JSON مع مخطط Schema | لا يوجد منطق يحتاج لغة، والمخطط يكشف الأخطاء |
| قواعد يكتبها مبرمجون في نفس الفريق | كود عادي أو مكتبة أو لغة داخلية | أدوات اللغة المضيفة مجاناً، ولا محلل تصونه |
| تعبيرات وشروط عامة على بيانات | لغة جاهزة مثل CEL | مواصفة وتطبيقات مختبرة وحدود للتكلفة |
| سياسات وصلاحيات | لغة جاهزة مثل Rego | مصممة للمجال وفيها أدوات اختبار |
| فريق غير تقني، مجال مغلق، تغيير أسبوعي، خطأ مكلف | لغة خارجية صغيرة مثل لغة العروض | مخطط ورسائل بكلمات المجال وأمان من البناء نفسه |
| طلب جديد ينقصه بيانات | حقل جديد في المخطط | سطران، والقواعد لم تتغير |
| طلب جديد ينقصه معنى | انتظر التكرار، ثم تركيب جديد أو إجراء مسمى | كل تركيب يبقى للأبد |
قائمة تحقق Checklist قبل أن تعطي اللغة لفريق آخر
- جمعت العروض أو القواعد الحقيقية من الفريق، وكتبتها بالشكل المقترح، وقرؤوها وفهموها دون شرح.
- المخطط مكتوب: الحقول وأنواعها، والقيم المسموحة، والوحدات.
- القواعد Grammar في رأس الملف أو التوثيق، ومعها قرار الأولويات.
- لا توجد حلقات ولا متغيرات ولا استدعاء لكود خارجي، أو لديك سبب مكتوب لوجود كل واحد منها.
- كل خطأ بالسطر والعمود ورسالة عربية واقتراح، وكل أخطاء الملف تظهر في مرة واحدة.
- الرسائل العربية معزولة الاتجاه، ومجربة في المكان الذي سوف تعرض فيه فعلاً.
- الملف إما يطبق كله أو يرفض كله، والملف السابق يبقى يعمل عند الرفض.
- سياسة الجمع والسقف والترتيب موثقة، والناتج لا يعتمد على ترتيب القواعد في الملف.
- الحدود الكبرى خارج اللغة، مثل حد الخصم الكلي.
- المال بالنوع
Decimalوطريقة تقريب محددة. - أمثلة ذهبية لكل عرض، واختبار خصائص بسلال عشوائية، ويعمل الاثنان في الـ Pipeline قبل نشر أي ملف قواعد.
- سجل يشرح لكل سلة ما طبق وما لم يطبق ولماذا.
تدريب عملي Practice
- اجعل الفاحص يرفض خلط
andوorفي نفس المستوى دون أقواس، برسالة تقترح مكان القوس. - أضف الأمر
check --jsonالذي يخرج الأخطاء بصيغة JSON فيها السطر والعمود والرسالة والاقتراح، واعرضها في صفحة HTML بالاتجاهdir="rtl". - صمم الإجراء
then effect "bogo_beans"الذي يستدعي دالة Python مسجلة باسمها في قائمة بيضاء، واكتب له مثالين ذهبيين.
حذف المختبر Cleanup
كل التجارب استخدمت الـ Image الرسمية python:3.13.17-slim مع --rm، فلا يبقى أي Container بعد التشغيل، ومكتبة PyYAML ثبتت داخل الـ Container الذي حذف معه. وإذا لم تعد تحتاج الـ Image فاحذفها:
docker rmi python:3.13.17-slim
rm -rf lab/__pycache__ lab/before/__pycache__الخلاصة
وصلنا لنهاية الموضوع، وأهم ما فيه:
- لغة المجال لغة صغيرة لمشكلة واحدة، وتستخدمها كل يوم: SQL وRegex وCSS وHCL لغات خارجية، وGradle Kotlin DSL لغة داخلية، وتعبيرات GitHub Actions لغة نمت داخل YAML.
- نفس العروض الأربعة كتبت بأربعة أشكال: الكود يحتاج نشراً مع كل حملة، وJSON أخفى خطأ
cart.subtotlبصمت، واللغة الداخلية قبلت قاعدة تستوردos، ولغة المتجر أعطت السطر والعمود والاقتراح. - اللغة تستحق تكلفتها عندما يكتب فريق غير تقني في مجال مغلق يتغير كثيراً ويكلف الخطأ فيه مالاً، وإلا فالكود أو المكتبة أو لغة جاهزة مثل CEL وRego أنسب.
- التصميم يبدأ من جمل المستخدمين، والوحدة جزء من القيمة، والكلمات المفتاحية الإنجليزية مع رسائل عربية قرار واع بسبب النص ثنائي الاتجاه.
- ما تحذفه أهم مما تضيفه: بلا حلقات ولا متغيرات ولا كود خارجي، فكل قاعدة تنتهي، والأمان يأتي من البناء نفسه.
- التنفيذ الآمن يعني خصماً على السعر الأصلي لا يعتمد على الترتيب، وقاعدة حصرية تفوز فقط إذا كانت أفضل، وحداً خارج اللغة لنصف السلة، و
Decimalللمال، وملفاً يطبق كله أو يرفض كله. - خطأ في إجراء قاعدة أخفى خطأين في النسخة الأولى، والإصلاح أن يفحص الفاحص القاعدة الناقصة، ورسالة «اكتب: 100 SAR» انقلبت حتى عزلنا الاتجاه بعلامات Unicode.
- الطلب الذي ينقصه بيانات يحل بحقل في المخطط، والطلب الذي ينقصه معنى ينتظر حتى يتكرر، لأن كل تركيب يبقى في اللغة للأبد.
وإذا أردت أن تعرف لماذا كان حذف الحلقات قراراً بهذه الأهمية، فقد شرحنا في مقال مشكلة التوقف Halting Problem أن أي لغة فيها حلقات غير محدودة لا يستطيع أي برنامج أن يحكم مسبقاً هل ستنتهي كل برامجها.
دليلابن مفسراً صغيراً Interpreter بيدك: من النص إلى ASTنبني بلغة Python لغة صيغ صغيرة لحقل في نظام فواتير، من المحلل اللغوي إلى شجرة AST والتنفيذ ورسائل الخطأ، ونرى لماذا لا تصلح eval لهذا العمل.
دليلكيف يفهم المحرر كودك؟ بروتوكول LSP وأداة Tree-sitterنلتقط الرسائل الحقيقية بين المحرر وخوادم TypeScript 7 وPyright، ونقيس Tree-sitter على ملف حقيقي، ثم نبني خادم لغة صغيراً يضع الخط الأحمر في VS Code بنفسه.
دليلالتعبيرات النمطية Regex للمبتدئين، مع النص العربيكيف تقرأ وتكتب تعبيراً نمطياً جزءاً بجزء، ولماذا يختلف سلوكه مع النص العربي بين اللغات، وكيف يوقف نمط واحد سيرفرك.
دليلتعلم SQL (1): ما هو SQL وكيف تكتب أول استعلامتتعلم SQL من الصفر: ما هي قاعدة البيانات العلائقية، وكيف تنشئ الجداول وتضيف البيانات وتكتب أول استعلام بأمان.
دليلTerraform أم OpenTofu؟ قصة تغيير الترخيص وما يعنيه لكلماذا غير Terraform رخصته في 2023 فولد منه OpenTofu، وأين يختلف المشروعان اليوم، وكيف تختار بينهما.
دليلTypeScript للمطورين: أي الأخطاء تكشفها الأنواع Types؟زرعنا تسعة أخطاء في كود سلة مشتريات وفحصناها بالمترجم tsc بثلاثة إعدادات، لنرى ما يكشفه الوضع الصارم وما يمر رغم كل الأنواع ولماذا تحتاج التحقق وقت التشغيل.سجل التحديثات
- أكتوبر 2026: كتابة المقال، وتنفيذ كل الأمثلة داخل Container من الـ Image الرسمية
python:3.13.17-slim(Python 3.13.17 على Debian 13.7) مع PyYAML 6.0.3، على Docker Engine 29.8.0.