السياق
الاسم
HOLDEM.TRAINING
الحقيقة
مشروع تدريبي. النموذج موجود — 5-Card Draw. المهمة: بناء Texas Hold'em بنفس البنية، بإضافة ورق المجتمع وجولات المراهنة.
الهدف
مطوّر يقرأ النموذج، يفهم النمط، ينفّذ اللعبة الثانية بشكل مستقل.
النموذج — 5-Card Draw
| العنصر | في Draw | في Hold'em |
|---|---|---|
| evaluateHand() | نفس الدالة ✅ | تُستخدم على 5 من 7 أوراق |
| renderCard() | نفس المكوّن ✅ | يُعيد استخدامه كما هو |
| نظام الرقائق | 100 لكل لاعب، رهان 10 ✅ | نفس المنطق + جولات |
| ورق المجتمع | غير موجود | الإضافة الجديدة — Flop / Turn / River |
| جولات المراهنة | غير موجودة | الإضافة الجديدة — Check / Call / Raise / Fold |
| الفائز | مقارنة مباشرة | أفضل يد من 5 بين 7 أوراق |
الجمل الرسمية
reuse(evaluateHand, renderCard, chipSystem)
ما بُني في Draw يُعاد استخدامه — لا تُعيد الكتابة
add(communityCards[5], dealPhase[Flop, Turn, River])
الـ Flop: 3 أوراق — الـ Turn: 1 — الـ River: 1
implement(bettingRound[Check, Call, Raise, Fold])
جولة واحدة على الأقل بعد كل مرحلة
evaluate(bestHand(playerCards[2] + communityCards[5]))
أفضل 5 من 7 — نفس evaluateHand()
render(showdown → winner → chipUpdate)
الفائز يأخذ الـ pot — نفس منطق Draw
مراحل التنفيذ
١
COMMUNITY.CARDS
أضف صف ورق المجتمع. اكشف 3 (Flop)، ثم 1 (Turn)، ثم 1 (River). استخدم renderCard() كما هو.
→ clip point A: dealCommunity(phase)
٢
BETTING.ROUND
أضف أزرار Check / Call / Raise / Fold بعد كل مرحلة. حدّث الـ pot والرقائق في كل خطوة.
→ clip point B: playerAction(type, amount)
٣
BEST.HAND
أنشئ دالة bestOf7(hand, community) تجرب كل تركيبات الـ 5 من 7 وتعيد أعلى تقييم.
→ reuse: evaluateHand() — لا تعديل مطلوب
٤
SHOWDOWN
في نهاية الـ River: اكشف الأوراق، أظهر أفضل يد لكل لاعب، حدد الفائز، حوّل الـ pot.
→ reuse: chipUpdate() من Draw
٥
OPAL.RENDER
نفس الألوان. نفس حجم الخط. نفس المنطق البصري. OPAL ليس جماليًا فقط — هو لغة.
→ --opal-teal / --opal-amber / --opal-violet / --opal-gold
قاموس المطوّر
الاسم
HOLDEM.DICTIONARY
الحقيقة
8 تعبيرات. كل تعبير = اسم / حقيقة / هدف. القاموس هو الـ Context. بدونه — الجملة معلّقة.
| الاسم | الحقيقة |
|---|---|
| community | ورق مشترك — يبني عليها الجميع |
| flop | أول 3 أوراق مجتمع — تُكشف دفعة واحدة |
| turn | الورقة الرابعة — الضغط يرتفع |
| river | الورقة الخامسة — آخر فرصة |
| check | مرور بدون رهان — إذا لم يُرهن أحد |
| call | مجاراة الرهان الحالي |
| raise | رفع الرهان — يُلزم الآخرين بالرد |
| fold | الانسحاب — خسارة الرقائق المدفوعة |
القاعدة
execute(Expression, HOLDEM.DICTIONARY) → Artifact
القاموس هو السياق. بدون سياق — لا تنفيذ.