الأسبوع التاسع — استدعاء نموذج بأمان من الخادمWeek 9 — Day 1 — Server trust boundary and mock setup

الأهدافObjectives

• اشرح مسؤوليات المتصفح والخادم والمزود وأثبت أن المحاكاة تبدأ بلا مفتاح وأن الإعداد الفعلي الناقص يمنع التشغيل.Explain browser/server/provider responsibilities and prove mock startup needs no key while incomplete live configuration fails closed.

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

• أكمل API المختبرة من الأسبوع الثامن وإعداد البيئة المحلية المستبعدة أو مسار الدعم المتفق عليه.Complete the Week 8 tested API and ignored local environment setup, or the agreed supported route.
• استخدم 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 the three trust boundaries; identify where input validation, secrets and operational logs belong. Predict every missing-configuration case before running setup tests.

ورقة العملWorksheet

1. قدّم مخطط الحدود وجدول الإعداد وفحص الاستبعاد وشرح لماذا لا تعني اختبارات البداية الناجحة اكتمال التكامل.Submit the boundary diagram, configuration matrix, ignored-file check and explanation of why a green starter suite is not a completed model integration.مرجع الدليل: w9d1-evidenceEvidence reference: w9d1-evidence

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

1. افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
2. أنشئ بيئة Python 3.11 أو أحدث وثبّت اعتماديات المحاكاة وشغّل فحوص الإعداد التسعة. افحص model_settings.py و.env.example دون مفتاح حقيقي والتقط الوضع وحقائق النجاح والفشل الآمنة فقط.Create a Python 3.11+ environment, install pinned mock dependencies and run the nine setup checks. Inspect model_settings.py and .env.example without adding a real key. Capture only safe mode and pass/fail facts.
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

• يعمل داخل الخادم لا المتصفحserver-side
• قيمة إعداد خارج الكودenvironment variable
• المنع عند غياب شرط الأمانfail closed

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

• يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.A key is placed in browser code, a screenshot or raw exception output.
• يُحلل JSON لكن تُقبل الزوائد والتحويلات الضمنية والرفض أو التوليد الناقص.JSON parses but extra fields, coercions, refusal or incomplete generation are accepted.
• تتجاوز الإعادة التلقائية أو الطلبات المتزامنة محاولة واحدة أو تُسمّى المحاكاة اتصالاً فعلياً.Automatic retries or concurrent calls exceed one attempt; a mock result is labelled live.

الأهدافObjectives

• عرّف نماذج طلب ونتيجة صارمة وارفض حالات البنية التالفة والحقول الزائدة والناقصة والنوع والتصنيف والطول.Define strict request/result models and reject every malformed, extra-field, missing-field, type, enum and length fixture.

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

• أكمل API المختبرة من الأسبوع الثامن وإعداد البيئة المحلية المستبعدة أو مسار الدعم المتفق عليه.Complete the Week 8 tested API and ignored local environment setup, or the agreed supported route.
• استخدم 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

• توقع الحالات الثلاث عشرة بجدول الحقل والقاعدة والنتيجة وميّز فشل التحليل والمخطط والرفض والتوليد الناقص.Predict all thirteen adapter fixtures using a field/rule/outcome table. Contrast parsing failure, schema failure, refusal and incomplete generation.

ورقة العملWorksheet

1. قدّم جدولي المخطط ونتائج الحالات الثلاث عشرة المتوقعة والفعلية وفحص أمانة منفصلاً مقابل المصدر الخيالي.Submit both schema tables, thirteen expected/actual fixture outcomes and a separate faithfulness check against the fictional source.مرجع الدليل: w9d2-evidenceEvidence reference: w9d2-evidence

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

1. افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
2. أكمل NoticeRequest وNoticeResult واختبر الفراغات والتحويل الضمني والحقول الناقصة والزائدة والتصنيفات المجهولة وحدود الطول. أثبت رفض المدخل غير المعتمد قبل الوصول للنموذج.Complete NoticeRequest and NoticeResult. Test whitespace, coercion, missing and extra fields, unknown categories and exact boundary lengths. Prove unapproved input is rejected before model access.
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

• نتيجة تتبع مخطط حقول محدداًstructured output
• قواعد الحقول والأنواع والقيودschema
• امتناع النموذج عن تقديم النتيجةrefusal

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

• يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.A key is placed in browser code, a screenshot or raw exception output.
• يُحلل JSON لكن تُقبل الزوائد والتحويلات الضمنية والرفض أو التوليد الناقص.JSON parses but extra fields, coercions, refusal or incomplete generation are accepted.
• تتجاوز الإعادة التلقائية أو الطلبات المتزامنة محاولة واحدة أو تُسمّى المحاكاة اتصالاً فعلياً.Automatic retries or concurrent calls exceed one attempt; a mock result is labelled live.

الأهدافObjectives

• نفّذ حدود النموذج وPOST /analyse بنجاح متحقق منه وأعطال آمنة 422 و502 و429 و504 و503 دون اتصال بالشبكة.Implement the model boundary and POST /analyse with validated success and safe 422/502/429/504/503 failures, without network access.

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

• أكمل API المختبرة من الأسبوع الثامن وإعداد البيئة المحلية المستبعدة أو مسار الدعم المتفق عليه.Complete the Week 8 tested API and ignored local environment setup, or the agreed supported route.
• استخدم 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

• تتبع الطلب وقائمة السماح وطبقة الربط والتحقق والرد وحدد أول نقطة توقف للمدخل غير الصالح والرفض والمهلة.Trace request → allowlist → adapter → result validation → HTTP response. Mark the earliest stop point for invalid input, refusal and timeout.

ورقة العملWorksheet

1. قدّم توثيق المسار والنجاح الاصطناعي المتحقق منه وكل رموز الفشل واختبار حجب يثبت غياب المفاتيح والمدخل من الأخطاء والسجلات.Submit endpoint documentation, validated synthetic success, all failure statuses and a redaction test proving secrets and input are absent from errors and logs.مرجع الدليل: w9d3-evidenceEvidence reference: w9d3-evidence

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

1. افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
2. أكمل analyse_with_model وسجّل المسار. اختبر الحالات الثلاث عشرة وافحص الرسائل العامة وأثبت عدم استدعاء المزود مع 422. سجّل النتيجة والوضع والعدد والمدة الآمنة فقط.Complete analyse_with_model and register the route. Exercise all thirteen fixtures through tests, check generic details and assert zero provider access on 422. Use safe outcome/mode/count/duration logs only.
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

• طبقة تترجم بين عقد التطبيق والمزودadapter
• انتهاء مهلة انتظار الطلبtimeout
• رسالة خطأ خالية من التفاصيل الحساسةsanitized error

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

• يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.A key is placed in browser code, a screenshot or raw exception output.
• يُحلل JSON لكن تُقبل الزوائد والتحويلات الضمنية والرفض أو التوليد الناقص.JSON parses but extra fields, coercions, refusal or incomplete generation are accepted.
• تتجاوز الإعادة التلقائية أو الطلبات المتزامنة محاولة واحدة أو تُسمّى المحاكاة اتصالاً فعلياً.Automatic retries or concurrent calls exceed one attempt; a mock result is labelled live.

الأهدافObjectives

• أثبت محاولة خارجية واحدة وصفر إعادة وحدوداً ثابتة بناقل وهمي وجهّز ميزانية مراجعة لاتصال فعلي دون طلب غير معتمد.Prove one outbound attempt, zero retries and fixed limits with a fake transport; prepare a reviewed real-call budget without making an unapproved request.

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

• أكمل API المختبرة من الأسبوع الثامن وإعداد البيئة المحلية المستبعدة أو مسار الدعم المتفق عليه.Complete the Week 8 tested API and ignored local environment setup, or the agreed supported route.
• استخدم 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

• افحص مراجع Responses والنتائج المنظّمة الرسمية في البداية وميّز تحليل اكتمال المزود ورفضه عن غلاف المحاكاة المبسط وقدّر تكلفة الطلب كاملة بأسعار حالية يقدمها المدرب.Inspect the official Responses and Structured Outputs references in the starter. Distinguish provider completion/refusal parsing from the simplified mock envelope; estimate full request cost with trainer-supplied current prices.

ورقة العملWorksheet

1. قدّم تشغيلين دون اتصال ودليل منع الإعادة والتزامن وتقدير التكلفة الكاملة مع النموذج ومصدر الأسعار وتاريخها وحالة الاتصال المعلقة أو المعتمدة بوضوح.Submit two offline test runs, no-retry/concurrency evidence, full cost estimate with model/pricing source/date and explicit pending or approved live status.مرجع الدليل: w9d4-evidenceEvidence reference: w9d4-evidence

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

1. افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
2. أكمل مجموعات الاختبار الأربع وشغّلها مرتين مع حجب الشبكة. افحص الحدود والتزامن بناقل فعلي وهمي وأكمل cost-and-failure-checklist.md واترك الاستخدام الفعلي فارغاً حتى الطلب المعتمد. أبقِ المختبر محلياً بعامل واحد.Complete four test groups and run twice with networking blocked. Use a fake live transport to inspect limits and concurrency. Fill cost-and-failure-checklist.md; leave actual usage blank until an approved live request. Keep the lab local with one worker.
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

• حد رموز المدخل والمخرجات المخططtoken budget
• محاولة إرسال أخرى بعد الفشلretry
• حجز لا تستطيع الطلبات المتزامنة تجاوزهatomic reservation

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

• يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.A key is placed in browser code, a screenshot or raw exception output.
• يُحلل JSON لكن تُقبل الزوائد والتحويلات الضمنية والرفض أو التوليد الناقص.JSON parses but extra fields, coercions, refusal or incomplete generation are accepted.
• تتجاوز الإعادة التلقائية أو الطلبات المتزامنة محاولة واحدة أو تُسمّى المحاكاة اتصالاً فعلياً.Automatic retries or concurrent calls exceed one attempt; a mock result is labelled live.

الأهدافObjectives

• اعرض مجموعة المحاكاة المتحقق منها واتصالاً فعلياً محدوداً يوافق عليه المدرب واشرح الأمان والتكلفة أو سجّل بوضوح الدليل الفعلي المتبقي وموعد الاستدراك.Demonstrate the validated mock suite and one trainer-approved bounded real call, explain safety and cost, or explicitly record the remaining live evidence and recovery appointment.

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

• أكمل API المختبرة من الأسبوع الثامن وإعداد البيئة المحلية المستبعدة أو مسار الدعم المتفق عليه.Complete the Week 8 tested API and ignored local environment setup, or the agreed supported route.
• استخدم 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

• راجع معيار التحقق وافصل أدلة المصدر والاختبارات والإعداد والتكلفة والاتصال الفعلي واشرح نتيجة غير صالحة دون إجابات مكتملة.Review the checkpoint rubric and separate source/test/configuration/cost/real-call evidence. Explain one invalid result without looking at completed answers.

ورقة العملWorksheet

1. قدّم المصدر الفردي ونتائج الحالات الثلاث عشرة والاختبارات المكررة والإعداد المحجوب ودليل الاتصال وحدود المدخل والمخرج والطلبات وملاحظة التكلفة والفشل ومراجعة الأمانة والشرح المباشر وحدد أي دليل فعلي غير مكتمل.Submit individual source, thirteen fixture outcomes, repeated tests, redacted setup and real-call evidence, input/output/request limits, cost/failure note, faithfulness review and live explanation. Clearly identify unfinished live evidence.مرجع الدليل: w9d5-evidenceEvidence reference: w9d5-evidence

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

1. افحص الإعلان المقدم وعقد العينة وتوقع النتيجة والرمز وعدد المحاولات.Inspect the supplied notice and fixture contract; predict result, status and attempt count.
2. أكمل واشرح مسارك ومخططاتك وطبقة الربط بنفسك. شغّل كل الاختبارات دون اتصال وخذ موافقة المدرب قبل المحاولة الفعلية الوحيدة والتقط نتيجة متحققاً منها بعد الحجب وعرض فشل آمن وقدّم ملاحظة التكلفة وسجل استخدام الذكاء الاصطناعي. توقف بعد المحاولة الفاشلة.Complete and explain your own route, schemas and adapter. Run all offline tests, obtain trainer approval before the single bounded live attempt, capture a redacted validated result and a safe failure demonstration, and submit the cost note and AI-use record. Stop after a failed attempt.
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

• دليل اتصال فعلي لا محاكاةlive evidence
• التزام الملخص بما يقوله المصدرfaithfulness
• مسار لإكمال الدليل الناقص بإشرافrecovery

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

• يوضع مفتاح في كود المتصفح أو لقطة أو مخرجات استثناء خام.A key is placed in browser code, a screenshot or raw exception output.
• يُحلل JSON لكن تُقبل الزوائد والتحويلات الضمنية والرفض أو التوليد الناقص.JSON parses but extra fields, coercions, refusal or incomplete generation are accepted.
• تتجاوز الإعادة التلقائية أو الطلبات المتزامنة محاولة واحدة أو تُسمّى المحاكاة اتصالاً فعلياً.Automatic retries or concurrent calls exceed one attempt; a mock result is labelled live.