دليل المدرّب · PDFTrainer guide · PDF
تنزيل PDFDownload PDFحزمة المدرّب العامة الكاملةComplete public trainer pack
الأسبوع العاشر — حزمة المدرّبWeek 10 — Trainer pack
حزمة المدرّب هذه عامة. تبقى مهام بوابة الأساس الحية وبنوك المهام وملاحظات المقيمين ونتائج المشاركين والإجابات المكتملة وملاحظات الحلول المشروحة غير عامة.This trainer pack is public. Live Foundation Gate tasks, task banks, assessor notes, participant results, completed answers, and worked solution notes remain non-public.
تنزيلات المدرّبTrainer downloads
عرض الشرائح · PDFSlide deck · PDF
تنزيل PDFDownload PDFحالة الحل الكاملComplete solution status
يتوفر بعد التحقق ونافذة الاستدراك والإصدار المعتمد من المدرّبAvailable after the checkpoint, recovery window, and trainer-approved release
اليوم 1Day 1
اليوم 1 — ميزة واحدة وحدود صريحةDay 1 — One feature, explicit boundaries
التحضيرPreparation
- استخدم حدود النموذج المتحقق منها من عملك في الأسبوع التاسع واختبارات أعطال API من الثامن. إذا بقي دليل الاتصال الفعلي معلقاً فواصل دون اتصال بالمسار المدعوم وأبقِ حالته المعلقة منفصلة.Use your own Week 9 validated model boundary and Week 8 API failure tests. If Week 9 live evidence is pending, continue offline on the agreed supported route and retain that separate pending status.
- استخدم Python 3.11 أو أحدث واعتماديات المحاكاة المثبتة. ابدأ بـMODEL_MODE=mock؛ لا تحتاج مفتاحاً أو حساباً مدفوعاً أو قاعدة للعمل دون اتصال.Use Python 3.11+ and the pinned mock dependencies. Start with MODEL_MODE=mock: no key, paid account or database is needed for offline work.
المواد المطلوبةRequired materials
- تسلسل الشرائح العام لهذه الجلسة (3 شرائح).Public slide sequence for this session (3 slides).
- ورقة عمل المتعلم القابلة للطباعة للمهام المنشورة وعددها 1.Printable learner worksheet for the 1 published tasks.
- نسخة دون اتصال من الجلسة وتسميات الأدلة والملفات العامة المعتمدة.An offline copy of the session, evidence labels, and approved public files.
- حالات الإدخال الاصطناعية المقدمة فقط وعددها 6؛ دون بيانات مشاركين حقيقية.Only the 6 supplied synthetic input cases; no real participant data.
الأهدافObjectives
- عرّف POST /notice-feature كميزة إعلان اصطناعي واحدة لا وسيط طلبات عامة؛ وافصل النتيجة الصالحة والطلب المرفوض وتعذر الخدمة.Define POST /notice-feature as one synthetic-notice feature, not a general prompt proxy; separate valid, invalid and unavailable outcomes.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| طلبات مسموحة ونتائج صادقةAllowed requests and honest outcomes | 120 | تدريسInstruction | اشرح بالعربية أولاً وتتبع الطلب وإعداد الخادم وحدود المزود والتحقق من النتيجة والاستجابة الآمنة واستخدم العينات المحلية للعروض.Explain in Arabic first; trace the request, server-only configuration, provider boundary, result validation and safe response. Use local fixtures for demonstrations. | عرّف POST /notice-feature كميزة إعلان اصطناعي واحدة لا وسيط طلبات عامة؛ وافصل النتيجة الصالحة والطلب المرفوض وتعذر الخدمة.Define POST /notice-feature as one synthetic-notice feature, not a general prompt proxy; separate valid, invalid and unavailable outcomes. |
| تدريب موجّه على عقد البديلGuided fallback-contract practice | 60 | ممارسة موجّهةGuided practice | اطلب توقع الرمز وحد التحقق وعدد المحاولات الخارجية قبل التنفيذ وقلل التلميحات قبل العمل الفردي.Ask learners to predict status, validation boundary and outbound attempt count before execution; reduce prompts before independent work. | ارسم المتصفح ثم تحقق الطلب وحدود النموذج وتحقق النتيجة ثم النجاح أو البديل. حدد أين يتوقف الطلب غير الصالح ولماذا لا يتحول إلى بديل.Draw browser → validation → model boundary → result validation → success/fallback. Mark where an invalid request stops and why it must not become fallback. |
| مختبر الميزة المضبوطة بإشرافSupervised controlled-feature lab | 120 | مختبر خاضع للإشرافSupervised lab | أبقِ الاختبار دون اتصال وافحص دليل كل متعلم وأوقف أي اتصال غير معتمد وناقش الوصول المدعوم إذا بقي دليل الاتصال الفعلي معلقاً.Keep testing offline, inspect each learner's evidence and stop any unapproved network call. Discuss how to obtain supported access if the real-call evidence is pending. | أعد البداية دون اتصال وشغّل فحوص الإعداد وأكمل endpoint-contract.md بأمثلة مسموحة ومرفوضة ورموز HTTP الدقيقة ونص البديل دون تغيير.Set up the offline starter, run setup checks, and fill endpoint-contract.md with allowed/refused examples, exact HTTP statuses and the unchanged fallback text. |
ملاحظات الشرحExplanation notes
البديل عقد وليس نموذجاً آخرFallback is a contract, not a second model
أعد استخدام حدود عملك في الأسبوع التاسع. يحتوي الطلب notice فقط كنص صارم بطول 1–800 بعد إزالة الفراغات مطابقاً لـpublic_notice.json. يعيد الطلب غير الصالح أو خارج النطاق 422 قبل طبقة الربط. النجاح 200 بحالة ok ونتيجة متحقق منها ورسالة null. فشل الخدمة بديل مميز 503 لا نجاح مختلق. لا تحتاج مفتاحاً للعمل دون اتصال.Reuse your own Week 9 boundary. The request contains only notice, a strict stripped string of 1–800 characters equal to public_notice.json. Invalid or out-of-scope requests return 422 before adapter access. Success is 200 with status ok, validated result and null message. A service failure is a distinct 503 fallback, never fabricated success. No key is needed for this week's offline work.
أمثلة العرضDemonstration examples
يمر الإعلان الخيالي المدعوم؛ ويتوقف الطلب العام أو الفراغ أو الحقل الزائد أو الإعلان الآخر برمز 422 وصفر استدعاءات للربط.A supported fictional notice can proceed; an arbitrary prompt, blank input, extra key or other notice stops with 422 and zero adapter calls.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- ارسم المتصفح ثم تحقق الطلب وحدود النموذج وتحقق النتيجة ثم النجاح أو البديل. حدد أين يتوقف الطلب غير الصالح ولماذا لا يتحول إلى بديل.Draw browser → validation → model boundary → result validation → success/fallback. Mark where an invalid request stops and why it must not become fallback.
تيسير المختبرLab facilitation
- افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
- أعد البداية دون اتصال وشغّل فحوص الإعداد وأكمل endpoint-contract.md بأمثلة مسموحة ومرفوضة ورموز HTTP الدقيقة ونص البديل دون تغيير.Set up the offline starter, run setup checks, and fill endpoint-contract.md with allowed/refused examples, exact HTTP statuses and the unchanged fallback text.
- حدد أول حد فاشل وأصلحه وأعد الاختبار مع حجب الشبكة. لا تستخدم إعادة مدفوعة كحلقة تصحيح.Find the first failing boundary, repair it and rerun with network access blocked. Never use a paid retry as a debugging loop.
- احفظ الدليل بعد الحجب وملاحظة استخدام الذكاء الاصطناعي أو عدمه وميّز دليل المحاكاة من الفعلي.Save redacted evidence and an AI-use or non-use note; label mock and live evidence separately.
الأدلة المتوقعةExpected evidence
- قدّم مخطط الحدود وجدول المسموح والمرفوض والتمييز بين النجاح وفشل التحقق وتعذر النموذج.Submit the boundary diagram, allowed/refused table and distinction between success, validation failure and model unavailability.
w10d1-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
أتِح نقطة نهاية AI مضبوطة واحدة مع التحقق من المخطط ومعالجة المهلة والأخطاء ورسالة بديلة حتمية.Expose one controlled AI endpoint with schema validation, timeout/error handling, and a deterministic fallback message.
- تحد مخططات الطلب والاستجابة الميزة وترفض الإدخال غير الصالح قبل الوصول إلى النموذج.Request and response schemas bound the feature and reject invalid input before model access.
- تُعالج المهلة وخطأ المزود والمخرجات غير الصالحة دون تسريب تفاصيل داخلية.Timeout, provider error and invalid output are handled without internal-detail leakage.
- تتحقق اختبارات الفشل من رسالة بديلة حتمية دقيقة واحدة تبدأ بالعربية.Failure tests assert one exact deterministic Arabic-first fallback message.
الأخطاء الشائعةCommon errors
- يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.A key is placed in browser code, a screenshot or raw exception output.
- يسمى البديل نجاحاً أو يتضمن نتيجة مختلقة أو يتغير نصه بين حالات الفشل.A fallback is marked successful, contains invented result fields, or changes its text between failures.
- يؤدي البديل إلى طلب نموذج آخر أو يخفي طلباً معطوباً أو يعيد العداد؛ أو تُسمّى المحاكاة اتصالاً فعلياً.A fallback triggers another model request, hides a malformed request, or resets the attempt guard; a mock result is labelled live.
تدخلات المدرّبTrainer interventions
- ارجع إلى العقد واعزل تحقق الطلب وتوحيد طبقة الربط والتحقق من النتيجة.Return to the contract and isolate request validation, adapter normalization and result validation.
- احجب الشبكة حتى تنجح اختبارات المحاكاة وراجع الموافقة والتكلفة الكاملة والحجب قبل المحاولة الفعلية.Block network access until mock tests pass; review approval, full cost and redaction before a real attempt.
الاستدراكRecovery
خلال أسبوع أصلح أول اختبار تحقق أو بديل فاشل وأعد تقديم دليل اليوم 1 مع تشغيلين متطابقين دون اتصال. احتفظ بأي نقص في دليل الأسبوع التاسع ورتّب استدراكه منفصلاً ولا تسمّ المخرج المحاكى حقيقياً.Within one week, repair the first failing validation/fallback test and resubmit the Day 1 evidence with two identical offline runs. Preserve any Week 9 live evidence gap and arrange supported recovery separately; never label simulated output as real.
البديل عند الانقطاعInterruption fallback
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
الخصوصية والذكاء الاصطناعيPrivacy and AI reminders
الخصوصيةPrivacy
استخدم الإعلان الخيالي المقدم فقط. أبقِ المفاتيح والترويسات وأخطاء المزود الخام والمدخلات والسجلات الحقيقية والرسائل الخاصة خارج السجلات واللقطات والأدلة المشتركة. لا ترسل محتويات القاعدة للنموذج وأبقِ المختبر محلياً.Use only the supplied fictional notice. Keep keys, headers, raw provider errors, prompts, real records and private messages out of logs, captures and shared evidence. The model must never receive database contents. Keep the lab on localhost.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي مراجعة عينة فاشلة بعد حجبها وإعادة إنتاجها. عليك تنفيذ الإصلاح واختباره وشرحه. لا تطلب كود التحقق الكامل ولا ترسل بيانات حقيقية. يحتاج أي اتصال بالمزود في هذا التمرين شرط الاتصال الفعلي المنفصل.AI may review a redacted failing fixture after you reproduce it. You must implement, test and explain the repair. Do not request complete checkpoint code or send real data. Any provider call in this exercise requires the separate live gate.
نص التسجيلRecording script
السردNarration
- اشرح طلبات مسموحة ونتائج صادقة بمثال خيالي مختلف لا بكود تحقق مكتمل.Explain Allowed requests and honest outcomes with an unrelated fictional example, not completed checkpoint code.
إجراءات الشاشةScreen actions
- اعرض الملفات النسبية وجداول العينات ونتائج الاختبار المحجوبة وأخفِ الإعدادات وشاشات الحساب والمزود الخام ولا تُجرِ اتصالاً مدفوعاً أثناء التسجيل.Show project-relative files, fixture tables and redacted test results. Hide settings, account screens and raw provider consoles; do not make paid calls while recording.
النصوص الظاهرةCaptions
- اكتب معنى المخطط والرفض والمهلة والمحاولة والتكلفة بالعربية أولاً ثم الإنجليزية.Caption schema, refusal, timeout, attempt and cost meanings in Arabic first, then English.
نقاط التوقفPause points
- توقف قبل كل عينة للتوقع وقبل الاتصال الفعلي لمراجعة الموافقة والميزانية.Pause before each fixture for a prediction and before the live gate for approval and budget review.
قائمة التحقق من التسجيلRecording checklist
- افحص الحالات الثلاث عشرة ومخططي النجاح والبديل الصارمين والرسالة الدقيقة بالعربية أولاً والرموز الآمنة ومنع الإعادة. تسجيل الأسبوع العاشر لا يكمل شرط الاتصال الفعلي المنفصل للأسبوع التاسع.Check thirteen fixtures, strict success/fallback schemas, the exact Arabic-first message, safe statuses and no-retry evidence. The Week 10 recording does not complete Week 9's separate real-call requirement.
اليوم 2Day 2
اليوم 2 — بنيتا النجاح والبديل الصارمتانDay 2 — Strict success and fallback shapes
التحضيرPreparation
- استخدم حدود النموذج المتحقق منها من عملك في الأسبوع التاسع واختبارات أعطال API من الثامن. إذا بقي دليل الاتصال الفعلي معلقاً فواصل دون اتصال بالمسار المدعوم وأبقِ حالته المعلقة منفصلة.Use your own Week 9 validated model boundary and Week 8 API failure tests. If Week 9 live evidence is pending, continue offline on the agreed supported route and retain that separate pending status.
- استخدم Python 3.11 أو أحدث واعتماديات المحاكاة المثبتة. ابدأ بـMODEL_MODE=mock؛ لا تحتاج مفتاحاً أو حساباً مدفوعاً أو قاعدة للعمل دون اتصال.Use Python 3.11+ and the pinned mock dependencies. Start with MODEL_MODE=mock: no key, paid account or database is needed for offline work.
المواد المطلوبةRequired materials
- تسلسل الشرائح العام لهذه الجلسة (3 شرائح).Public slide sequence for this session (3 slides).
- ورقة عمل المتعلم القابلة للطباعة للمهام المنشورة وعددها 1.Printable learner worksheet for the 1 published tasks.
- نسخة دون اتصال من الجلسة وتسميات الأدلة والملفات العامة المعتمدة.An offline copy of the session, evidence labels, and approved public files.
- حالات الإدخال الاصطناعية المقدمة فقط وعددها 6؛ دون بيانات مشاركين حقيقية.Only the 6 supplied synthetic input cases; no real participant data.
الأهدافObjectives
- عرّف مخططات الطلب ونتيجة الإعلان واستجابتي النجاح والبديل المميزتين؛ وارفض الزوائد والتحويل الضمني والتركيبات المستحيلة.Define request, notice result and discriminated success/fallback response schemas; reject extra fields, coercions and impossible combinations.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| لا حقول استجابة متناقضةNo contradictory response fields | 120 | تدريسInstruction | اشرح بالعربية أولاً وتتبع الطلب وإعداد الخادم وحدود المزود والتحقق من النتيجة والاستجابة الآمنة واستخدم العينات المحلية للعروض.Explain in Arabic first; trace the request, server-only configuration, provider boundary, result validation and safe response. Use local fixtures for demonstrations. | عرّف مخططات الطلب ونتيجة الإعلان واستجابتي النجاح والبديل المميزتين؛ وارفض الزوائد والتحويل الضمني والتركيبات المستحيلة.Define request, notice result and discriminated success/fallback response schemas; reject extra fields, coercions and impossible combinations. |
| تدريب موجّه على عقد البديلGuided fallback-contract practice | 60 | ممارسة موجّهةGuided practice | اطلب توقع الرمز وحد التحقق وعدد المحاولات الخارجية قبل التنفيذ وقلل التلميحات قبل العمل الفردي.Ask learners to predict status, validation boundary and outbound attempt count before execution; reduce prompts before independent work. | توقع نتائج عينات النموذج الثلاث عشرة ثم صمم اختبارات لخلط حقول النجاح والبديل وnull والأنواع الخاطئة وحدود الملخص.Predict thirteen model-fixture outcomes, then design extra tests for mixed success/fallback fields, nulls, wrong types and summary boundaries. |
| مختبر الميزة المضبوطة بإشرافSupervised controlled-feature lab | 120 | مختبر خاضع للإشرافSupervised lab | أبقِ الاختبار دون اتصال وافحص دليل كل متعلم وأوقف أي اتصال غير معتمد وناقش الوصول المدعوم إذا بقي دليل الاتصال الفعلي معلقاً.Keep testing offline, inspect each learner's evidence and stop any unapproved network call. Discuss how to obtain supported access if the real-call evidence is pending. | أكمل feature_models.py وأضف اختبارات الحدود. أثبت أن الطلبات المعطوبة لا تستدعي الربط ولا تعيد استجابة بديلة.Complete feature_models.py and add boundary tests. Prove malformed requests cause zero adapter calls, not a fallback response. |
ملاحظات الشرحExplanation notes
النتيجة غير المتاحة يجب أن تبقى فارغةAn unavailable result must remain empty
يحتوي النجاح status بقيمة ok وresult بتصنيف workshop أو meeting أو other وملخص بطول 1–160 بعد إزالة الفراغات وmessage بقيمة null فقط. يحتوي البديل status بقيمة fallback وresult بقيمة null والرسالة الثابتة بالعربية أولاً من endpoint-contract.md. لا يحمل البديل ملخصاً سابقاً أو مولداً. تُرفض الزوائد والتحقق البنيوي منفصل عن فحص الأمانة البشري.Success contains exactly status ok, result with category workshop/meeting/other and stripped summary 1–160 characters, and message null. Fallback contains exactly status fallback, result null and the fixed Arabic-first message from endpoint-contract.md. A fallback cannot carry a previous/generated summary. All extra fields are forbidden; schema validation is separate from human source-faithfulness checking.
أمثلة العرضDemonstration examples
حالة fallback مع نتيجة غير null غير صالحة، وحالة ok مع رسالة بديلة غير صالحة. الملخص ذو البنية الصحيحة ما زال يحتاج مقارنة بالمصدر.status=fallback plus a non-null result is invalid. status=ok plus a fallback message is invalid. A valid-shaped summary still needs source comparison.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- توقع نتائج عينات النموذج الثلاث عشرة ثم صمم اختبارات لخلط حقول النجاح والبديل وnull والأنواع الخاطئة وحدود الملخص.Predict thirteen model-fixture outcomes, then design extra tests for mixed success/fallback fields, nulls, wrong types and summary boundaries.
تيسير المختبرLab facilitation
- افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
- أكمل feature_models.py وأضف اختبارات الحدود. أثبت أن الطلبات المعطوبة لا تستدعي الربط ولا تعيد استجابة بديلة.Complete feature_models.py and add boundary tests. Prove malformed requests cause zero adapter calls, not a fallback response.
- حدد أول حد فاشل وأصلحه وأعد الاختبار مع حجب الشبكة. لا تستخدم إعادة مدفوعة كحلقة تصحيح.Find the first failing boundary, repair it and rerun with network access blocked. Never use a paid retry as a debugging loop.
- احفظ الدليل بعد الحجب وملاحظة استخدام الذكاء الاصطناعي أو عدمه وميّز دليل المحاكاة من الفعلي.Save redacted evidence and an AI-use or non-use note; label mock and live evidence separately.
الأدلة المتوقعةExpected evidence
- قدّم جداول المخطط واختبارات كائنات النجاح والبديل الصالحة ورفض الكائنات المتناقضة وملاحظة أمانة منفصلة للمصدر.Submit schema tables and tests for valid success/fallback objects and rejected contradictory objects, plus a separate source-faithfulness note.
w10d2-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
أتِح نقطة نهاية AI مضبوطة واحدة مع التحقق من المخطط ومعالجة المهلة والأخطاء ورسالة بديلة حتمية.Expose one controlled AI endpoint with schema validation, timeout/error handling, and a deterministic fallback message.
- تحد مخططات الطلب والاستجابة الميزة وترفض الإدخال غير الصالح قبل الوصول إلى النموذج.Request and response schemas bound the feature and reject invalid input before model access.
- تُعالج المهلة وخطأ المزود والمخرجات غير الصالحة دون تسريب تفاصيل داخلية.Timeout, provider error and invalid output are handled without internal-detail leakage.
- تتحقق اختبارات الفشل من رسالة بديلة حتمية دقيقة واحدة تبدأ بالعربية.Failure tests assert one exact deterministic Arabic-first fallback message.
الأخطاء الشائعةCommon errors
- يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.A key is placed in browser code, a screenshot or raw exception output.
- يسمى البديل نجاحاً أو يتضمن نتيجة مختلقة أو يتغير نصه بين حالات الفشل.A fallback is marked successful, contains invented result fields, or changes its text between failures.
- يؤدي البديل إلى طلب نموذج آخر أو يخفي طلباً معطوباً أو يعيد العداد؛ أو تُسمّى المحاكاة اتصالاً فعلياً.A fallback triggers another model request, hides a malformed request, or resets the attempt guard; a mock result is labelled live.
تدخلات المدرّبTrainer interventions
- ارجع إلى العقد واعزل تحقق الطلب وتوحيد طبقة الربط والتحقق من النتيجة.Return to the contract and isolate request validation, adapter normalization and result validation.
- احجب الشبكة حتى تنجح اختبارات المحاكاة وراجع الموافقة والتكلفة الكاملة والحجب قبل المحاولة الفعلية.Block network access until mock tests pass; review approval, full cost and redaction before a real attempt.
الاستدراكRecovery
خلال أسبوع أصلح أول اختبار تحقق أو بديل فاشل وأعد تقديم دليل اليوم 2 مع تشغيلين متطابقين دون اتصال. احتفظ بأي نقص في دليل الأسبوع التاسع ورتّب استدراكه منفصلاً ولا تسمّ المخرج المحاكى حقيقياً.Within one week, repair the first failing validation/fallback test and resubmit the Day 2 evidence with two identical offline runs. Preserve any Week 9 live evidence gap and arrange supported recovery separately; never label simulated output as real.
البديل عند الانقطاعInterruption fallback
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
الخصوصية والذكاء الاصطناعيPrivacy and AI reminders
الخصوصيةPrivacy
استخدم الإعلان الخيالي المقدم فقط. أبقِ المفاتيح والترويسات وأخطاء المزود الخام والمدخلات والسجلات الحقيقية والرسائل الخاصة خارج السجلات واللقطات والأدلة المشتركة. لا ترسل محتويات القاعدة للنموذج وأبقِ المختبر محلياً.Use only the supplied fictional notice. Keep keys, headers, raw provider errors, prompts, real records and private messages out of logs, captures and shared evidence. The model must never receive database contents. Keep the lab on localhost.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي مراجعة عينة فاشلة بعد حجبها وإعادة إنتاجها. عليك تنفيذ الإصلاح واختباره وشرحه. لا تطلب كود التحقق الكامل ولا ترسل بيانات حقيقية. يحتاج أي اتصال بالمزود في هذا التمرين شرط الاتصال الفعلي المنفصل.AI may review a redacted failing fixture after you reproduce it. You must implement, test and explain the repair. Do not request complete checkpoint code or send real data. Any provider call in this exercise requires the separate live gate.
نص التسجيلRecording script
السردNarration
- اشرح لا حقول استجابة متناقضة بمثال خيالي مختلف لا بكود تحقق مكتمل.Explain No contradictory response fields with an unrelated fictional example, not completed checkpoint code.
إجراءات الشاشةScreen actions
- اعرض الملفات النسبية وجداول العينات ونتائج الاختبار المحجوبة وأخفِ الإعدادات وشاشات الحساب والمزود الخام ولا تُجرِ اتصالاً مدفوعاً أثناء التسجيل.Show project-relative files, fixture tables and redacted test results. Hide settings, account screens and raw provider consoles; do not make paid calls while recording.
النصوص الظاهرةCaptions
- اكتب معنى المخطط والرفض والمهلة والمحاولة والتكلفة بالعربية أولاً ثم الإنجليزية.Caption schema, refusal, timeout, attempt and cost meanings in Arabic first, then English.
نقاط التوقفPause points
- توقف قبل كل عينة للتوقع وقبل الاتصال الفعلي لمراجعة الموافقة والميزانية.Pause before each fixture for a prediction and before the live gate for approval and budget review.
قائمة التحقق من التسجيلRecording checklist
- افحص الحالات الثلاث عشرة ومخططي النجاح والبديل الصارمين والرسالة الدقيقة بالعربية أولاً والرموز الآمنة ومنع الإعادة. تسجيل الأسبوع العاشر لا يكمل شرط الاتصال الفعلي المنفصل للأسبوع التاسع.Check thirteen fixtures, strict success/fallback schemas, the exact Arabic-first message, safe statuses and no-retry evidence. The Week 10 recording does not complete Week 9's separate real-call requirement.
اليوم 3Day 3
اليوم 3 — بديل دقيق واحد بالعربية أولاًDay 3 — One exact Arabic-first fallback
التحضيرPreparation
- استخدم حدود النموذج المتحقق منها من عملك في الأسبوع التاسع واختبارات أعطال API من الثامن. إذا بقي دليل الاتصال الفعلي معلقاً فواصل دون اتصال بالمسار المدعوم وأبقِ حالته المعلقة منفصلة.Use your own Week 9 validated model boundary and Week 8 API failure tests. If Week 9 live evidence is pending, continue offline on the agreed supported route and retain that separate pending status.
- استخدم Python 3.11 أو أحدث واعتماديات المحاكاة المثبتة. ابدأ بـMODEL_MODE=mock؛ لا تحتاج مفتاحاً أو حساباً مدفوعاً أو قاعدة للعمل دون اتصال.Use Python 3.11+ and the pinned mock dependencies. Start with MODEL_MODE=mock: no key, paid account or database is needed for offline work.
المواد المطلوبةRequired materials
- تسلسل الشرائح العام لهذه الجلسة (3 شرائح).Public slide sequence for this session (3 slides).
- ورقة عمل المتعلم القابلة للطباعة للمهام المنشورة وعددها 1.Printable learner worksheet for the 1 published tasks.
- نسخة دون اتصال من الجلسة وتسميات الأدلة والملفات العامة المعتمدة.An offline copy of the session, evidence labels, and approved public files.
- حالات الإدخال الاصطناعية المقدمة فقط وعددها 6؛ دون بيانات مشاركين حقيقية.Only the 6 supplied synthetic input cases; no real participant data.
الأهدافObjectives
- حوّل المهلة وأخطاء المزود والمخرجات المرفوضة أو الناقصة والنتائج غير الصالحة إلى بديل 503 دقيق واحد دون تسريب أو اختلاق.Map timeout, provider errors, refused/incomplete output and invalid results to one exact 503 fallback without leaking or inventing content.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| سلوك ثابت عبر أعطال النموذجStable behavior across model failures | 120 | تدريسInstruction | اشرح بالعربية أولاً وتتبع الطلب وإعداد الخادم وحدود المزود والتحقق من النتيجة والاستجابة الآمنة واستخدم العينات المحلية للعروض.Explain in Arabic first; trace the request, server-only configuration, provider boundary, result validation and safe response. Use local fixtures for demonstrations. | حوّل المهلة وأخطاء المزود والمخرجات المرفوضة أو الناقصة والنتائج غير الصالحة إلى بديل 503 دقيق واحد دون تسريب أو اختلاق.Map timeout, provider errors, refused/incomplete output and invalid results to one exact 503 fallback without leaking or inventing content. |
| تدريب موجّه على عقد البديلGuided fallback-contract practice | 60 | ممارسة موجّهةGuided practice | اطلب توقع الرمز وحد التحقق وعدد المحاولات الخارجية قبل التنفيذ وقلل التلميحات قبل العمل الفردي.Ask learners to predict status, validation boundary and outbound attempt count before execution; reduce prompts before independent work. | قارن معنى العطل بسلوك المستخدم. اشرح رمز تعذر الخدمة وثبات الرسالة ولماذا لا يُبتلع 422.Compare failure meaning with user-visible behavior. Explain why the HTTP code is unavailable, why the message is fixed, and why a 422 is not swallowed. |
| مختبر الميزة المضبوطة بإشرافSupervised controlled-feature lab | 120 | مختبر خاضع للإشرافSupervised lab | أبقِ الاختبار دون اتصال وافحص دليل كل متعلم وأوقف أي اتصال غير معتمد وناقش الوصول المدعوم إذا بقي دليل الاتصال الفعلي معلقاً.Keep testing offline, inspect each learner's evidence and stop any unapproved network call. Discuss how to obtain supported access if the real-call evidence is pending. | أكمل توحيد المحاكاة ونقطة النهاية. شغّل العينات الثلاث عشرة داخلياً وتحقق من التطابق الكامل لكل فشل خدمة؛ وأبقِ اختيار العينة خارج الطلب العام.Complete mock normalization and the endpoint. Run all thirteen fixtures internally and assert exact full response equality for every service failure; keep fixture selection out of the public request. |
ملاحظات الشرحExplanation notes
الفشل المفيد ليس نجاحاً مزيفاًUseful failure is not fake success
يوجه البديل المستخدم لقراءة الإعلان الأصلي ولا يستنتج تصنيفاً ولا يعيد نتيجة قديمة ولا يستدعي نموذجاً آخر. حافظ على السطر العربي والسطر الجديد والسطر الإنجليزي كما في البداية. تقييد المزود فشل خدمة ويستخدم جسم 503 نفسه. يبقى المدخل غير الصالح 422 والمحاولة الفعلية المحلية المستهلكة 429 قبل المزود.The fallback tells the user to read the original notice; it does not infer a classification, reuse stale output or call another model. Preserve exactly the Arabic line, newline and English line documented in the starter. Provider throttling is a service failure and uses this same 503 body. Invalid user input remains 422; an already-consumed local live attempt remains 429 before provider access.
أمثلة العرضDemonstration examples
المهلة وتقييد المزود والنتيجة المعطوبة تعطي جسم بديل 503 متطابقاً؛ لا يحتوي أي منها نتيجة أو رسالة مزود خام أو مفتاحاً.timeout, provider rate-limit and malformed result → identical 503 fallback body; none includes a result, raw provider message or credential.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- قارن معنى العطل بسلوك المستخدم. اشرح رمز تعذر الخدمة وثبات الرسالة ولماذا لا يُبتلع 422.Compare failure meaning with user-visible behavior. Explain why the HTTP code is unavailable, why the message is fixed, and why a 422 is not swallowed.
تيسير المختبرLab facilitation
- افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
- أكمل توحيد المحاكاة ونقطة النهاية. شغّل العينات الثلاث عشرة داخلياً وتحقق من التطابق الكامل لكل فشل خدمة؛ وأبقِ اختيار العينة خارج الطلب العام.Complete mock normalization and the endpoint. Run all thirteen fixtures internally and assert exact full response equality for every service failure; keep fixture selection out of the public request.
- حدد أول حد فاشل وأصلحه وأعد الاختبار مع حجب الشبكة. لا تستخدم إعادة مدفوعة كحلقة تصحيح.Find the first failing boundary, repair it and rerun with network access blocked. Never use a paid retry as a debugging loop.
- احفظ الدليل بعد الحجب وملاحظة استخدام الذكاء الاصطناعي أو عدمه وميّز دليل المحاكاة من الفعلي.Save redacted evidence and an AI-use or non-use note; label mock and live evidence separately.
الأدلة المتوقعةExpected evidence
- قدّم مصفوفة الاستجابة المتوقعة والفعلية وفحوص الحجب وحالتي فشل مختلفتين تنتجان بيانات JSON متطابقة.Submit the full expected/actual response matrix, redaction checks and two different failure cases producing byte-equivalent JSON data.
w10d3-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
أتِح نقطة نهاية AI مضبوطة واحدة مع التحقق من المخطط ومعالجة المهلة والأخطاء ورسالة بديلة حتمية.Expose one controlled AI endpoint with schema validation, timeout/error handling, and a deterministic fallback message.
- تحد مخططات الطلب والاستجابة الميزة وترفض الإدخال غير الصالح قبل الوصول إلى النموذج.Request and response schemas bound the feature and reject invalid input before model access.
- تُعالج المهلة وخطأ المزود والمخرجات غير الصالحة دون تسريب تفاصيل داخلية.Timeout, provider error and invalid output are handled without internal-detail leakage.
- تتحقق اختبارات الفشل من رسالة بديلة حتمية دقيقة واحدة تبدأ بالعربية.Failure tests assert one exact deterministic Arabic-first fallback message.
الأخطاء الشائعةCommon errors
- يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.A key is placed in browser code, a screenshot or raw exception output.
- يسمى البديل نجاحاً أو يتضمن نتيجة مختلقة أو يتغير نصه بين حالات الفشل.A fallback is marked successful, contains invented result fields, or changes its text between failures.
- يؤدي البديل إلى طلب نموذج آخر أو يخفي طلباً معطوباً أو يعيد العداد؛ أو تُسمّى المحاكاة اتصالاً فعلياً.A fallback triggers another model request, hides a malformed request, or resets the attempt guard; a mock result is labelled live.
تدخلات المدرّبTrainer interventions
- ارجع إلى العقد واعزل تحقق الطلب وتوحيد طبقة الربط والتحقق من النتيجة.Return to the contract and isolate request validation, adapter normalization and result validation.
- احجب الشبكة حتى تنجح اختبارات المحاكاة وراجع الموافقة والتكلفة الكاملة والحجب قبل المحاولة الفعلية.Block network access until mock tests pass; review approval, full cost and redaction before a real attempt.
الاستدراكRecovery
خلال أسبوع أصلح أول اختبار تحقق أو بديل فاشل وأعد تقديم دليل اليوم 3 مع تشغيلين متطابقين دون اتصال. احتفظ بأي نقص في دليل الأسبوع التاسع ورتّب استدراكه منفصلاً ولا تسمّ المخرج المحاكى حقيقياً.Within one week, repair the first failing validation/fallback test and resubmit the Day 3 evidence with two identical offline runs. Preserve any Week 9 live evidence gap and arrange supported recovery separately; never label simulated output as real.
البديل عند الانقطاعInterruption fallback
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
الخصوصية والذكاء الاصطناعيPrivacy and AI reminders
الخصوصيةPrivacy
استخدم الإعلان الخيالي المقدم فقط. أبقِ المفاتيح والترويسات وأخطاء المزود الخام والمدخلات والسجلات الحقيقية والرسائل الخاصة خارج السجلات واللقطات والأدلة المشتركة. لا ترسل محتويات القاعدة للنموذج وأبقِ المختبر محلياً.Use only the supplied fictional notice. Keep keys, headers, raw provider errors, prompts, real records and private messages out of logs, captures and shared evidence. The model must never receive database contents. Keep the lab on localhost.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي مراجعة عينة فاشلة بعد حجبها وإعادة إنتاجها. عليك تنفيذ الإصلاح واختباره وشرحه. لا تطلب كود التحقق الكامل ولا ترسل بيانات حقيقية. يحتاج أي اتصال بالمزود في هذا التمرين شرط الاتصال الفعلي المنفصل.AI may review a redacted failing fixture after you reproduce it. You must implement, test and explain the repair. Do not request complete checkpoint code or send real data. Any provider call in this exercise requires the separate live gate.
نص التسجيلRecording script
السردNarration
- اشرح سلوك ثابت عبر أعطال النموذج بمثال خيالي مختلف لا بكود تحقق مكتمل.Explain Stable behavior across model failures with an unrelated fictional example, not completed checkpoint code.
إجراءات الشاشةScreen actions
- اعرض الملفات النسبية وجداول العينات ونتائج الاختبار المحجوبة وأخفِ الإعدادات وشاشات الحساب والمزود الخام ولا تُجرِ اتصالاً مدفوعاً أثناء التسجيل.Show project-relative files, fixture tables and redacted test results. Hide settings, account screens and raw provider consoles; do not make paid calls while recording.
النصوص الظاهرةCaptions
- اكتب معنى المخطط والرفض والمهلة والمحاولة والتكلفة بالعربية أولاً ثم الإنجليزية.Caption schema, refusal, timeout, attempt and cost meanings in Arabic first, then English.
نقاط التوقفPause points
- توقف قبل كل عينة للتوقع وقبل الاتصال الفعلي لمراجعة الموافقة والميزانية.Pause before each fixture for a prediction and before the live gate for approval and budget review.
قائمة التحقق من التسجيلRecording checklist
- افحص الحالات الثلاث عشرة ومخططي النجاح والبديل الصارمين والرسالة الدقيقة بالعربية أولاً والرموز الآمنة ومنع الإعادة. تسجيل الأسبوع العاشر لا يكمل شرط الاتصال الفعلي المنفصل للأسبوع التاسع.Check thirteen fixtures, strict success/fallback schemas, the exact Arabic-first message, safe statuses and no-retry evidence. The Week 10 recording does not complete Week 9's separate real-call requirement.
اليوم 4Day 4
اليوم 4 — مهلات دون إعادة طلبDay 4 — Timeouts without retries
التحضيرPreparation
- استخدم حدود النموذج المتحقق منها من عملك في الأسبوع التاسع واختبارات أعطال API من الثامن. إذا بقي دليل الاتصال الفعلي معلقاً فواصل دون اتصال بالمسار المدعوم وأبقِ حالته المعلقة منفصلة.Use your own Week 9 validated model boundary and Week 8 API failure tests. If Week 9 live evidence is pending, continue offline on the agreed supported route and retain that separate pending status.
- استخدم Python 3.11 أو أحدث واعتماديات المحاكاة المثبتة. ابدأ بـMODEL_MODE=mock؛ لا تحتاج مفتاحاً أو حساباً مدفوعاً أو قاعدة للعمل دون اتصال.Use Python 3.11+ and the pinned mock dependencies. Start with MODEL_MODE=mock: no key, paid account or database is needed for offline work.
المواد المطلوبةRequired materials
- تسلسل الشرائح العام لهذه الجلسة (3 شرائح).Public slide sequence for this session (3 slides).
- ورقة عمل المتعلم القابلة للطباعة للمهام المنشورة وعددها 1.Printable learner worksheet for the 1 published tasks.
- نسخة دون اتصال من الجلسة وتسميات الأدلة والملفات العامة المعتمدة.An offline copy of the session, evidence labels, and approved public files.
- حالات الإدخال الاصطناعية المقدمة فقط وعددها 6؛ دون بيانات مشاركين حقيقية.Only the 6 supplied synthetic input cases; no real participant data.
الأهدافObjectives
- أثبت انتظاراً محدوداً ومنع الإعادة وصفر استدعاءات للمدخل المرفوض وحماية مشتركة لمحاولة واحدة بناقل وهمي وطلبات متزامنة.Prove bounded waiting, no retries, invalid-input zero calls and shared one-attempt protection using a fake transport and concurrent requests.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| البديل لا يستهلك محاولة أخرىFallback must not spend another attempt | 120 | تدريسInstruction | اشرح بالعربية أولاً وتتبع الطلب وإعداد الخادم وحدود المزود والتحقق من النتيجة والاستجابة الآمنة واستخدم العينات المحلية للعروض.Explain in Arabic first; trace the request, server-only configuration, provider boundary, result validation and safe response. Use local fixtures for demonstrations. | أثبت انتظاراً محدوداً ومنع الإعادة وصفر استدعاءات للمدخل المرفوض وحماية مشتركة لمحاولة واحدة بناقل وهمي وطلبات متزامنة.Prove bounded waiting, no retries, invalid-input zero calls and shared one-attempt protection using a fake transport and concurrent requests. |
| تدريب موجّه على عقد البديلGuided fallback-contract practice | 60 | ممارسة موجّهةGuided practice | اطلب توقع الرمز وحد التحقق وعدد المحاولات الخارجية قبل التنفيذ وقلل التلميحات قبل العمل الفردي.Ask learners to predict status, validation boundary and outbound attempt count before execution; reduce prompts before independent work. | راقب الناقل الوهمي فقط: عد الاستدعاءات وحاكِ طلباً عالقاً وإلغاءً وطلبات متداخلة. ميّز المهلة الكلية من مهلة عملية الشبكة في SDK.Instrument only the fake transport: count calls and simulate a stalled request, cancellation and overlapping requests. Distinguish a deadline from an SDK per-I/O timeout. |
| مختبر الميزة المضبوطة بإشرافSupervised controlled-feature lab | 120 | مختبر خاضع للإشرافSupervised lab | أبقِ الاختبار دون اتصال وافحص دليل كل متعلم وأوقف أي اتصال غير معتمد وناقش الوصول المدعوم إذا بقي دليل الاتصال الفعلي معلقاً.Keep testing offline, inspect each learner's evidence and stop any unapproved network call. Discuss how to obtain supported access if the real-call evidence is pending. | أكمل اختبارات العطل والمهلة والعدد وشغّل المجموعة مرتين مع حجب الشبكة. افحص الأخطاء والسجلات بعلامات أسرار وهمية وتأكد من عدم إعادة الجسم الخام.Complete the failure/deadline/count tests and run the suite twice with networking blocked. Scan errors and logs for fictional secret markers and ensure no raw body is echoed. |
ملاحظات الشرحExplanation notes
أوقف الانتظار ولا تُعد الطلب خفيةStop waiting; do not silently try again
احتفظ بمهلة الأسبوع التاسع 10 ثوان وحد المخرجات 256 رمزاً وصفر إعادة تلقائية وحجز محاولة فعلية واحدة قبل الشبكة. يُبنى البديل محلياً ولا يعيد المحاولة. طلبان فعليان صالحان متزامنان يعنيان محاولة مزود واحدة و429 محلياً للثاني؛ وفشل الأول يعطي بديل 503. تعاد عدادات الذاكرة عند التشغيل وليست ميزانية دائمة. يمكن تكرار المحاكاة بلا إنفاق.Retain Week 9's 10-second deadline, 256-output-token limit, zero automatic retries and one reserved live attempt before I/O. A fallback is built locally and never refunds that attempt. Two concurrent valid live requests mean one provider attempt and one local 429; a failure in the first yields 503 fallback. In-memory counters reset at startup and are not durable budgets. Mock fixture practice may repeat without live spending.
أمثلة العرضDemonstration examples
تنتهي مهلة المحاولة الأولى فيظهر البديل الثابت. الطلب الفعلي الصالح التالي يعطي 429 محلياً دون مزود. لا إعادة تلقائية أو نموذج ثان أو تجاوز بإعادة التشغيل.First provider attempt times out → fixed fallback. Next valid live request → local 429, with no provider call. No automatic retry, second model or restart bypass.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- راقب الناقل الوهمي فقط: عد الاستدعاءات وحاكِ طلباً عالقاً وإلغاءً وطلبات متداخلة. ميّز المهلة الكلية من مهلة عملية الشبكة في SDK.Instrument only the fake transport: count calls and simulate a stalled request, cancellation and overlapping requests. Distinguish a deadline from an SDK per-I/O timeout.
تيسير المختبرLab facilitation
- افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
- أكمل اختبارات العطل والمهلة والعدد وشغّل المجموعة مرتين مع حجب الشبكة. افحص الأخطاء والسجلات بعلامات أسرار وهمية وتأكد من عدم إعادة الجسم الخام.Complete the failure/deadline/count tests and run the suite twice with networking blocked. Scan errors and logs for fictional secret markers and ensure no raw body is echoed.
- حدد أول حد فاشل وأصلحه وأعد الاختبار مع حجب الشبكة. لا تستخدم إعادة مدفوعة كحلقة تصحيح.Find the first failing boundary, repair it and rerun with network access blocked. Never use a paid retry as a debugging loop.
- احفظ الدليل بعد الحجب وملاحظة استخدام الذكاء الاصطناعي أو عدمه وميّز دليل المحاكاة من الفعلي.Save redacted evidence and an AI-use or non-use note; label mock and live evidence separately.
الأدلة المتوقعةExpected evidence
- قدّم تشغيلين دون اتصال ودليل المهلة والإلغاء والتزامن وشرح حدود الميزانية وشرط الموافقة الفعلية المنفصل.Submit two offline runs, timeout/cancellation and concurrency proof, and an explanation of budget limitations and the separate live approval requirement.
w10d4-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
أتِح نقطة نهاية AI مضبوطة واحدة مع التحقق من المخطط ومعالجة المهلة والأخطاء ورسالة بديلة حتمية.Expose one controlled AI endpoint with schema validation, timeout/error handling, and a deterministic fallback message.
- تحد مخططات الطلب والاستجابة الميزة وترفض الإدخال غير الصالح قبل الوصول إلى النموذج.Request and response schemas bound the feature and reject invalid input before model access.
- تُعالج المهلة وخطأ المزود والمخرجات غير الصالحة دون تسريب تفاصيل داخلية.Timeout, provider error and invalid output are handled without internal-detail leakage.
- تتحقق اختبارات الفشل من رسالة بديلة حتمية دقيقة واحدة تبدأ بالعربية.Failure tests assert one exact deterministic Arabic-first fallback message.
الأخطاء الشائعةCommon errors
- يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.A key is placed in browser code, a screenshot or raw exception output.
- يسمى البديل نجاحاً أو يتضمن نتيجة مختلقة أو يتغير نصه بين حالات الفشل.A fallback is marked successful, contains invented result fields, or changes its text between failures.
- يؤدي البديل إلى طلب نموذج آخر أو يخفي طلباً معطوباً أو يعيد العداد؛ أو تُسمّى المحاكاة اتصالاً فعلياً.A fallback triggers another model request, hides a malformed request, or resets the attempt guard; a mock result is labelled live.
تدخلات المدرّبTrainer interventions
- ارجع إلى العقد واعزل تحقق الطلب وتوحيد طبقة الربط والتحقق من النتيجة.Return to the contract and isolate request validation, adapter normalization and result validation.
- احجب الشبكة حتى تنجح اختبارات المحاكاة وراجع الموافقة والتكلفة الكاملة والحجب قبل المحاولة الفعلية.Block network access until mock tests pass; review approval, full cost and redaction before a real attempt.
الاستدراكRecovery
خلال أسبوع أصلح أول اختبار تحقق أو بديل فاشل وأعد تقديم دليل اليوم 4 مع تشغيلين متطابقين دون اتصال. احتفظ بأي نقص في دليل الأسبوع التاسع ورتّب استدراكه منفصلاً ولا تسمّ المخرج المحاكى حقيقياً.Within one week, repair the first failing validation/fallback test and resubmit the Day 4 evidence with two identical offline runs. Preserve any Week 9 live evidence gap and arrange supported recovery separately; never label simulated output as real.
البديل عند الانقطاعInterruption fallback
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
الخصوصية والذكاء الاصطناعيPrivacy and AI reminders
الخصوصيةPrivacy
استخدم الإعلان الخيالي المقدم فقط. أبقِ المفاتيح والترويسات وأخطاء المزود الخام والمدخلات والسجلات الحقيقية والرسائل الخاصة خارج السجلات واللقطات والأدلة المشتركة. لا ترسل محتويات القاعدة للنموذج وأبقِ المختبر محلياً.Use only the supplied fictional notice. Keep keys, headers, raw provider errors, prompts, real records and private messages out of logs, captures and shared evidence. The model must never receive database contents. Keep the lab on localhost.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي مراجعة عينة فاشلة بعد حجبها وإعادة إنتاجها. عليك تنفيذ الإصلاح واختباره وشرحه. لا تطلب كود التحقق الكامل ولا ترسل بيانات حقيقية. يحتاج أي اتصال بالمزود في هذا التمرين شرط الاتصال الفعلي المنفصل.AI may review a redacted failing fixture after you reproduce it. You must implement, test and explain the repair. Do not request complete checkpoint code or send real data. Any provider call in this exercise requires the separate live gate.
نص التسجيلRecording script
السردNarration
- اشرح البديل لا يستهلك محاولة أخرى بمثال خيالي مختلف لا بكود تحقق مكتمل.Explain Fallback must not spend another attempt with an unrelated fictional example, not completed checkpoint code.
إجراءات الشاشةScreen actions
- اعرض الملفات النسبية وجداول العينات ونتائج الاختبار المحجوبة وأخفِ الإعدادات وشاشات الحساب والمزود الخام ولا تُجرِ اتصالاً مدفوعاً أثناء التسجيل.Show project-relative files, fixture tables and redacted test results. Hide settings, account screens and raw provider consoles; do not make paid calls while recording.
النصوص الظاهرةCaptions
- اكتب معنى المخطط والرفض والمهلة والمحاولة والتكلفة بالعربية أولاً ثم الإنجليزية.Caption schema, refusal, timeout, attempt and cost meanings in Arabic first, then English.
نقاط التوقفPause points
- توقف قبل كل عينة للتوقع وقبل الاتصال الفعلي لمراجعة الموافقة والميزانية.Pause before each fixture for a prediction and before the live gate for approval and budget review.
قائمة التحقق من التسجيلRecording checklist
- افحص الحالات الثلاث عشرة ومخططي النجاح والبديل الصارمين والرسالة الدقيقة بالعربية أولاً والرموز الآمنة ومنع الإعادة. تسجيل الأسبوع العاشر لا يكمل شرط الاتصال الفعلي المنفصل للأسبوع التاسع.Check thirteen fixtures, strict success/fallback schemas, the exact Arabic-first message, safe statuses and no-retry evidence. The Week 10 recording does not complete Week 9's separate real-call requirement.
اليوم 5Day 5
اليوم 5 — عرض الميزة الفرديDay 5 — Individual feature demonstration
التحضيرPreparation
- استخدم حدود النموذج المتحقق منها من عملك في الأسبوع التاسع واختبارات أعطال API من الثامن. إذا بقي دليل الاتصال الفعلي معلقاً فواصل دون اتصال بالمسار المدعوم وأبقِ حالته المعلقة منفصلة.Use your own Week 9 validated model boundary and Week 8 API failure tests. If Week 9 live evidence is pending, continue offline on the agreed supported route and retain that separate pending status.
- استخدم Python 3.11 أو أحدث واعتماديات المحاكاة المثبتة. ابدأ بـMODEL_MODE=mock؛ لا تحتاج مفتاحاً أو حساباً مدفوعاً أو قاعدة للعمل دون اتصال.Use Python 3.11+ and the pinned mock dependencies. Start with MODEL_MODE=mock: no key, paid account or database is needed for offline work.
المواد المطلوبةRequired materials
- تسلسل الشرائح العام لهذه الجلسة (3 شرائح).Public slide sequence for this session (3 slides).
- ورقة عمل المتعلم القابلة للطباعة للمهام المنشورة وعددها 1.Printable learner worksheet for the 1 published tasks.
- نسخة دون اتصال من الجلسة وتسميات الأدلة والملفات العامة المعتمدة.An offline copy of the session, evidence labels, and approved public files.
- حالات الإدخال الاصطناعية المقدمة فقط وعددها 6؛ دون بيانات مشاركين حقيقية.Only the 6 supplied synthetic input cases; no real participant data.
الأهدافObjectives
- اعرض نقطة النهاية المضبوطة فردياً بنجاح متحقق منه وبديل دقيق بالعربية أولاً ورفض آمن للطلبات ودليل قابل للتكرار دون اتصال.Demonstrate the controlled endpoint independently, with validated success, exact Arabic-first fallback, safe validation failures and repeatable offline evidence.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| تحقق فردي من الميزة المضبوطةIndividual controlled-feature checkpoint | 300 | مختبر خاضع للإشرافSupervised lab | افحص كود نقطة النهاية الفردي والبديل الدقيق والتحقق والمهلة ومنع الإعادة. قيّم سلوك ميزة هذا الأسبوع دون اتصال منفصلاً عن شرط الاتصال الفعلي المعلق للأسبوع التاسع.Inspect independent endpoint code, exact fallback, validation, timeout and no-retry evidence. Assess this week's offline feature behavior separately from Week 9's pending real-call requirement. | اعرض نقطة النهاية ونتائج العينات الثلاث عشرة فردياً. قدّم الاستجابات الدقيقة وتشغيلين ناجحين دون اتصال وملاحظة استخدام الذكاء الاصطناعي أو عدمه؛ وحدد استدراكاً مدعوماً لأي نقص.Independently demonstrate the endpoint and thirteen fixture outcomes. Submit exact responses, two passing offline runs and an AI-use or non-use note; schedule supported recovery for any remaining evidence gap. |
ملاحظات الشرحExplanation notes
الميزة الموثوقة تشمل فشلاً صادقاًA robust feature includes honest failure
اشرح كل حد وأثبت البديل نفسه للمهلة وخطأ المزود والمخرج غير الصالح. اعرض نتيجة اصطناعية مقبولة ورفض المدخل قبل النموذج وحماية المحاولة المحلية المستهلكة. يثبت دليل المحاكاة سلوك ميزة الأسبوع العاشر فقط. إذا غاب دليل الاتصال الفعلي المعتمد للأسبوع التاسع فأبقه معلقاً ورتب الدعم؛ هذا التحقق لا يلغيه.Explain each boundary and prove the same fallback for timeout, provider error and invalid output. Show one accepted synthetic result, invalid input rejected before model access and exhausted local attempt protection. Mock evidence demonstrates Week 10 feature behavior only. If Week 9's approved real-call evidence is missing, keep that prerequisite pending and arrange support; this checkpoint does not erase it.
أمثلة العرضDemonstration examples
يفصل الدليل نجاح الميزة دون اتصال عن الاتصال الفعلي غير المحاول أو المتعذر أو الفاشل أو المتحقق. لا يُسمّى البديل نتيجة نموذج صالحة.Evidence separates offline feature passed from live not attempted/blocked/attempted-failed/validated. A fallback is never labelled a valid model result.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- تدرّب على شرح موجز للمدخل المسموح والتحقق والمهلة والبديل الدقيق وعدد الاستدعاءات والدليل الفعلي المتبقي.Rehearse a concise explanation: permitted input, validation, timeout, exact fallback, call count and remaining live evidence.
تيسير المختبرLab facilitation
- افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
- اعرض نقطة النهاية ونتائج العينات الثلاث عشرة فردياً. قدّم الاستجابات الدقيقة وتشغيلين ناجحين دون اتصال وملاحظة استخدام الذكاء الاصطناعي أو عدمه؛ وحدد استدراكاً مدعوماً لأي نقص.Independently demonstrate the endpoint and thirteen fixture outcomes. Submit exact responses, two passing offline runs and an AI-use or non-use note; schedule supported recovery for any remaining evidence gap.
- حدد أول حد فاشل وأصلحه وأعد الاختبار مع حجب الشبكة. لا تستخدم إعادة مدفوعة كحلقة تصحيح.Find the first failing boundary, repair it and rerun with network access blocked. Never use a paid retry as a debugging loop.
- احفظ الدليل بعد الحجب وملاحظة استخدام الذكاء الاصطناعي أو عدمه وميّز دليل المحاكاة من الفعلي.Save redacted evidence and an AI-use or non-use note; label mock and live evidence separately.
الأدلة المتوقعةExpected evidence
- قدّم نقطة النهاية والمخططات والبديل الدقيق واختبارات التحقق والعطل فردياً؛ واشرح اختلاف التعذر الآمن عن النجاح وسجّل أي متطلب سابق معلق منفصلاً.Submit the individual endpoint, schemas, exact fallback and validation/failure tests; explain why safe degradation is different from success and record any separate pending prerequisite.
w10d5-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
أتِح نقطة نهاية AI مضبوطة واحدة مع التحقق من المخطط ومعالجة المهلة والأخطاء ورسالة بديلة حتمية.Expose one controlled AI endpoint with schema validation, timeout/error handling, and a deterministic fallback message.
- تحد مخططات الطلب والاستجابة الميزة وترفض الإدخال غير الصالح قبل الوصول إلى النموذج.Request and response schemas bound the feature and reject invalid input before model access.
- تُعالج المهلة وخطأ المزود والمخرجات غير الصالحة دون تسريب تفاصيل داخلية.Timeout, provider error and invalid output are handled without internal-detail leakage.
- تتحقق اختبارات الفشل من رسالة بديلة حتمية دقيقة واحدة تبدأ بالعربية.Failure tests assert one exact deterministic Arabic-first fallback message.
الأخطاء الشائعةCommon errors
- يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.A key is placed in browser code, a screenshot or raw exception output.
- يسمى البديل نجاحاً أو يتضمن نتيجة مختلقة أو يتغير نصه بين حالات الفشل.A fallback is marked successful, contains invented result fields, or changes its text between failures.
- يؤدي البديل إلى طلب نموذج آخر أو يخفي طلباً معطوباً أو يعيد العداد؛ أو تُسمّى المحاكاة اتصالاً فعلياً.A fallback triggers another model request, hides a malformed request, or resets the attempt guard; a mock result is labelled live.
تدخلات المدرّبTrainer interventions
- ارجع إلى العقد واعزل تحقق الطلب وتوحيد طبقة الربط والتحقق من النتيجة.Return to the contract and isolate request validation, adapter normalization and result validation.
- احجب الشبكة حتى تنجح اختبارات المحاكاة وراجع الموافقة والتكلفة الكاملة والحجب قبل المحاولة الفعلية.Block network access until mock tests pass; review approval, full cost and redaction before a real attempt.
الاستدراكRecovery
خلال أسبوع أصلح أول اختبار تحقق أو بديل فاشل وأعد تقديم دليل اليوم 5 مع تشغيلين متطابقين دون اتصال. احتفظ بأي نقص في دليل الأسبوع التاسع ورتّب استدراكه منفصلاً ولا تسمّ المخرج المحاكى حقيقياً.Within one week, repair the first failing validation/fallback test and resubmit the Day 5 evidence with two identical offline runs. Preserve any Week 9 live evidence gap and arrange supported recovery separately; never label simulated output as real.
البديل عند الانقطاعInterruption fallback
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
الخصوصية والذكاء الاصطناعيPrivacy and AI reminders
الخصوصيةPrivacy
استخدم الإعلان الخيالي المقدم فقط. أبقِ المفاتيح والترويسات وأخطاء المزود الخام والمدخلات والسجلات الحقيقية والرسائل الخاصة خارج السجلات واللقطات والأدلة المشتركة. لا ترسل محتويات القاعدة للنموذج وأبقِ المختبر محلياً.Use only the supplied fictional notice. Keep keys, headers, raw provider errors, prompts, real records and private messages out of logs, captures and shared evidence. The model must never receive database contents. Keep the lab on localhost.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي مراجعة عينة فاشلة بعد حجبها وإعادة إنتاجها. عليك تنفيذ الإصلاح واختباره وشرحه. لا تطلب كود التحقق الكامل ولا ترسل بيانات حقيقية. يحتاج أي اتصال بالمزود في هذا التمرين شرط الاتصال الفعلي المنفصل.AI may review a redacted failing fixture after you reproduce it. You must implement, test and explain the repair. Do not request complete checkpoint code or send real data. Any provider call in this exercise requires the separate live gate.
نص التسجيلRecording script
السردNarration
- اشرح اشرح وأثبت مساري الاستجابة بمثال خيالي مختلف لا بكود تحقق مكتمل.Explain Explain and prove both response paths with an unrelated fictional example, not completed checkpoint code.
إجراءات الشاشةScreen actions
- اعرض الملفات النسبية وجداول العينات ونتائج الاختبار المحجوبة وأخفِ الإعدادات وشاشات الحساب والمزود الخام ولا تُجرِ اتصالاً مدفوعاً أثناء التسجيل.Show project-relative files, fixture tables and redacted test results. Hide settings, account screens and raw provider consoles; do not make paid calls while recording.
النصوص الظاهرةCaptions
- اكتب معنى المخطط والرفض والمهلة والمحاولة والتكلفة بالعربية أولاً ثم الإنجليزية.Caption schema, refusal, timeout, attempt and cost meanings in Arabic first, then English.
نقاط التوقفPause points
- توقف قبل كل عينة للتوقع وقبل الاتصال الفعلي لمراجعة الموافقة والميزانية.Pause before each fixture for a prediction and before the live gate for approval and budget review.
قائمة التحقق من التسجيلRecording checklist
- افحص الحالات الثلاث عشرة ومخططي النجاح والبديل الصارمين والرسالة الدقيقة بالعربية أولاً والرموز الآمنة ومنع الإعادة. تسجيل الأسبوع العاشر لا يكمل شرط الاتصال الفعلي المنفصل للأسبوع التاسع.Check thirteen fixtures, strict success/fallback schemas, the exact Arabic-first message, safe statuses and no-retry evidence. The Week 10 recording does not complete Week 9's separate real-call requirement.