الأسبوع العاشر — ميزة ذكاء اصطناعي مضبوطةWeek 10 — Day 1 — One feature, explicit boundaries

الأهدافObjectives

• عرّف POST /notice-feature كميزة إعلان اصطناعي واحدة لا وسيط طلبات عامة؛ وافصل النتيجة الصالحة والطلب المرفوض وتعذر الخدمة.Define POST /notice-feature as one synthetic-notice feature, not a general prompt proxy; separate valid, invalid and unavailable outcomes.

المتطلبات المسبقةPrerequisites

• استخدم حدود النموذج المتحقق منها من عملك في الأسبوع التاسع واختبارات أعطال 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.

التدريب الموجّهGuided practice

• ارسم المتصفح ثم تحقق الطلب وحدود النموذج وتحقق النتيجة ثم النجاح أو البديل. حدد أين يتوقف الطلب غير الصالح ولماذا لا يتحول إلى بديل.Draw browser → validation → model boundary → result validation → success/fallback. Mark where an invalid request stops and why it must not become fallback.

ورقة العملWorksheet

1. قدّم مخطط الحدود وجدول المسموح والمرفوض والتمييز بين النجاح وفشل التحقق وتعذر النموذج.Submit the boundary diagram, allowed/refused table and distinction between success, validation failure and model unavailability.مرجع الدليل: w10d1-evidenceEvidence reference: w10d1-evidence

خطوات المختبرLab steps

1. افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
2. أعد البداية دون اتصال وشغّل فحوص الإعداد وأكمل 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.
3. حدد أول حد فاشل وأصلحه وأعد الاختبار مع حجب الشبكة. لا تستخدم إعادة مدفوعة كحلقة تصحيح.Find the first failing boundary, repair it and rerun with network access blocked. Never use a paid retry as a debugging loop.
4. احفظ الدليل بعد الحجب وملاحظة استخدام الذكاء الاصطناعي أو عدمه وميّز دليل المحاكاة من الفعلي.Save redacted evidence and an AI-use or non-use note; label mock and live evidence separately.

البيانات الاصطناعيةSynthetic data

مسرد الإنجليزية التقنيةTechnical English glossary

• قواعد غرض الميزة ومدخلاتها ونتائجهاfeature contract
• خارج المدخلات المسموح بهاout of scope

أخطاء شائعة ينبغي ملاحظتهاCommon errors to notice

• يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.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.

الأهدافObjectives

• عرّف مخططات الطلب ونتيجة الإعلان واستجابتي النجاح والبديل المميزتين؛ وارفض الزوائد والتحويل الضمني والتركيبات المستحيلة.Define request, notice result and discriminated success/fallback response schemas; reject extra fields, coercions and impossible combinations.

المتطلبات المسبقةPrerequisites

• استخدم حدود النموذج المتحقق منها من عملك في الأسبوع التاسع واختبارات أعطال 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.

التدريب الموجّهGuided practice

• توقع نتائج عينات النموذج الثلاث عشرة ثم صمم اختبارات لخلط حقول النجاح والبديل وnull والأنواع الخاطئة وحدود الملخص.Predict thirteen model-fixture outcomes, then design extra tests for mixed success/fallback fields, nulls, wrong types and summary boundaries.

ورقة العملWorksheet

1. قدّم جداول المخطط واختبارات كائنات النجاح والبديل الصالحة ورفض الكائنات المتناقضة وملاحظة أمانة منفصلة للمصدر.Submit schema tables and tests for valid success/fallback objects and rejected contradictory objects, plus a separate source-faithfulness note.مرجع الدليل: w10d2-evidenceEvidence reference: w10d2-evidence

خطوات المختبرLab steps

1. افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
2. أكمل feature_models.py وأضف اختبارات الحدود. أثبت أن الطلبات المعطوبة لا تستدعي الربط ولا تعيد استجابة بديلة.Complete feature_models.py and add boundary tests. Prove malformed requests cause zero adapter calls, not a fallback response.
3. حدد أول حد فاشل وأصلحه وأعد الاختبار مع حجب الشبكة. لا تستخدم إعادة مدفوعة كحلقة تصحيح.Find the first failing boundary, repair it and rerun with network access blocked. Never use a paid retry as a debugging loop.
4. احفظ الدليل بعد الحجب وملاحظة استخدام الذكاء الاصطناعي أو عدمه وميّز دليل المحاكاة من الفعلي.Save redacted evidence and an AI-use or non-use note; label mock and live evidence separately.

البيانات الاصطناعيةSynthetic data

مسرد الإنجليزية التقنيةTechnical English glossary

• بدائل بنيوية يميزها حقل ثابتdiscriminated union
• غياب مقصود للقيمةnull

أخطاء شائعة ينبغي ملاحظتهاCommon errors to notice

• يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.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.

الأهدافObjectives

• حوّل المهلة وأخطاء المزود والمخرجات المرفوضة أو الناقصة والنتائج غير الصالحة إلى بديل 503 دقيق واحد دون تسريب أو اختلاق.Map timeout, provider errors, refused/incomplete output and invalid results to one exact 503 fallback without leaking or inventing content.

المتطلبات المسبقةPrerequisites

• استخدم حدود النموذج المتحقق منها من عملك في الأسبوع التاسع واختبارات أعطال 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.

التدريب الموجّهGuided practice

• قارن معنى العطل بسلوك المستخدم. اشرح رمز تعذر الخدمة وثبات الرسالة ولماذا لا يُبتلع 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.

ورقة العملWorksheet

1. قدّم مصفوفة الاستجابة المتوقعة والفعلية وفحوص الحجب وحالتي فشل مختلفتين تنتجان بيانات JSON متطابقة.Submit the full expected/actual response matrix, redaction checks and two different failure cases producing byte-equivalent JSON data.مرجع الدليل: w10d3-evidenceEvidence reference: w10d3-evidence

خطوات المختبرLab steps

1. افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
2. أكمل توحيد المحاكاة ونقطة النهاية. شغّل العينات الثلاث عشرة داخلياً وتحقق من التطابق الكامل لكل فشل خدمة؛ وأبقِ اختيار العينة خارج الطلب العام.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.
3. حدد أول حد فاشل وأصلحه وأعد الاختبار مع حجب الشبكة. لا تستخدم إعادة مدفوعة كحلقة تصحيح.Find the first failing boundary, repair it and rerun with network access blocked. Never use a paid retry as a debugging loop.
4. احفظ الدليل بعد الحجب وملاحظة استخدام الذكاء الاصطناعي أو عدمه وميّز دليل المحاكاة من الفعلي.Save redacted evidence and an AI-use or non-use note; label mock and live evidence separately.

البيانات الاصطناعيةSynthetic data

مسرد الإنجليزية التقنيةTechnical English glossary

• بديل ثابت عند تعذر المسار الأساسيfallback
• يعطي النتيجة نفسها للحالة نفسهاdeterministic

أخطاء شائعة ينبغي ملاحظتهاCommon errors to notice

• يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.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.

الأهدافObjectives

• أثبت انتظاراً محدوداً ومنع الإعادة وصفر استدعاءات للمدخل المرفوض وحماية مشتركة لمحاولة واحدة بناقل وهمي وطلبات متزامنة.Prove bounded waiting, no retries, invalid-input zero calls and shared one-attempt protection using a fake transport and concurrent requests.

المتطلبات المسبقةPrerequisites

• استخدم حدود النموذج المتحقق منها من عملك في الأسبوع التاسع واختبارات أعطال 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.

التدريب الموجّهGuided practice

• راقب الناقل الوهمي فقط: عد الاستدعاءات وحاكِ طلباً عالقاً وإلغاءً وطلبات متداخلة. ميّز المهلة الكلية من مهلة عملية الشبكة في 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.

ورقة العملWorksheet

1. قدّم تشغيلين دون اتصال ودليل المهلة والإلغاء والتزامن وشرح حدود الميزانية وشرط الموافقة الفعلية المنفصل.Submit two offline runs, timeout/cancellation and concurrency proof, and an explanation of budget limitations and the separate live approval requirement.مرجع الدليل: w10d4-evidenceEvidence reference: w10d4-evidence

خطوات المختبرLab steps

1. افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
2. أكمل اختبارات العطل والمهلة والعدد وشغّل المجموعة مرتين مع حجب الشبكة. افحص الأخطاء والسجلات بعلامات أسرار وهمية وتأكد من عدم إعادة الجسم الخام.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.
3. حدد أول حد فاشل وأصلحه وأعد الاختبار مع حجب الشبكة. لا تستخدم إعادة مدفوعة كحلقة تصحيح.Find the first failing boundary, repair it and rerun with network access blocked. Never use a paid retry as a debugging loop.
4. احفظ الدليل بعد الحجب وملاحظة استخدام الذكاء الاصطناعي أو عدمه وميّز دليل المحاكاة من الفعلي.Save redacted evidence and an AI-use or non-use note; label mock and live evidence separately.

البيانات الاصطناعيةSynthetic data

مسرد الإنجليزية التقنيةTechnical English glossary

• حد كلي لوقت الانتظارdeadline
• إرسال محاولة جديدة بعد الفشلretry
• عدد المحاولات المسموح بهاattempt budget

أخطاء شائعة ينبغي ملاحظتهاCommon errors to notice

• يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.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.

الأهدافObjectives

• اعرض نقطة النهاية المضبوطة فردياً بنجاح متحقق منه وبديل دقيق بالعربية أولاً ورفض آمن للطلبات ودليل قابل للتكرار دون اتصال.Demonstrate the controlled endpoint independently, with validated success, exact Arabic-first fallback, safe validation failures and repeatable offline evidence.

المتطلبات المسبقةPrerequisites

• استخدم حدود النموذج المتحقق منها من عملك في الأسبوع التاسع واختبارات أعطال 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.

التدريب الموجّهGuided practice

• تدرّب على شرح موجز للمدخل المسموح والتحقق والمهلة والبديل الدقيق وعدد الاستدعاءات والدليل الفعلي المتبقي.Rehearse a concise explanation: permitted input, validation, timeout, exact fallback, call count and remaining live evidence.

ورقة العملWorksheet

1. قدّم نقطة النهاية والمخططات والبديل الدقيق واختبارات التحقق والعطل فردياً؛ واشرح اختلاف التعذر الآمن عن النجاح وسجّل أي متطلب سابق معلق منفصلاً.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-evidenceEvidence reference: w10d5-evidence

خطوات المختبرLab steps

1. افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
2. اعرض نقطة النهاية ونتائج العينات الثلاث عشرة فردياً. قدّم الاستجابات الدقيقة وتشغيلين ناجحين دون اتصال وملاحظة استخدام الذكاء الاصطناعي أو عدمه؛ وحدد استدراكاً مدعوماً لأي نقص.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.
3. حدد أول حد فاشل وأصلحه وأعد الاختبار مع حجب الشبكة. لا تستخدم إعادة مدفوعة كحلقة تصحيح.Find the first failing boundary, repair it and rerun with network access blocked. Never use a paid retry as a debugging loop.
4. احفظ الدليل بعد الحجب وملاحظة استخدام الذكاء الاصطناعي أو عدمه وميّز دليل المحاكاة من الفعلي.Save redacted evidence and an AI-use or non-use note; label mock and live evidence separately.

البيانات الاصطناعيةSynthetic data

مسرد الإنجليزية التقنيةTechnical English glossary

• تعذر مضبوط يحافظ على سلوك آمن ومفيدgraceful degradation
• برهان قابل للمراجعة على السلوكevidence

أخطاء شائعة ينبغي ملاحظتهاCommon errors to notice

• يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.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.