دليل المدرّب · PDFTrainer guide · PDF
تنزيل PDFDownload PDFحزمة المدرّب العامة الكاملةComplete public trainer pack
الأسبوع الحادي عشر — حزمة المدرّبWeek 11 — 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
راجع المشاريع الفردية حسب المعايير المنشورة. تبقى إرشادات تقييم المدرّب خاصة ولا يُخطط لتنزيل إجابة كاملة للمشروع الختامي.Review individual projects against the published criteria. Trainer assessment guidance remains private; no complete capstone answer download is planned.
اليوم 1Day 1
اليوم 1 — تثبيت نطاق فرديDay 1 — Freeze an individual scope
التحضيرPreparation
- مستودعا الأسبوعين الثامن والعاشر العاملان مع نطاق مشروع فردي معتمد.Weeks 8 and 10 working repositories plus an approved individual capstone scope.
- استخدم تنفيذاتك المراجعة وقاعدة PostgreSQL تدريبية محلية محمية. أبقِ استدعاءات النموذج وهمية. تتضمن البداية قوالب التخطيط والأدلة ولا تنفذ مشروعك.Use your own reviewed implementations and a guarded local PostgreSQL training database. Keep model calls mocked. The starter contains planning and evidence templates; it does not implement your capstone.
المواد المطلوبة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.
- حالات الإدخال الاصطناعية المقدمة فقط وعددها 5؛ دون بيانات مشاركين حقيقية.Only the 5 supplied synthetic input cases; no real participant data.
الأهدافObjectives
- نطاق مراجع وقائمة مؤجلة ونسخ البداية ومخطط رحلة واحدة.Reviewed scope, deferred list, starting revisions and one journey diagram.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| رحلة واحدة بدليل قابل للملاحظةOne journey with observable evidence | 120 | تدريسInstruction | اختر سير إعلان خيالي واحداً: إنشاء إعلان مخزن وقراءته وتعديله وحذفه ثم طلب تحليل العينة الاصطناعية المعتمدة. سجّل الضروري والمؤجل وفحوص القبول في scope.md. أعد استخدام التخزين من عملك في الأسبوع الثامن والميزة من العاشر. يحدد النطاق القابل للمراجعة المدخلات والنتائج الظاهرة والحدود؛ قائمة الميزات وحدها لا تثبت الإنجاز.Choose one fictional notice workflow: create, read, update and delete a stored notice, then request analysis of the approved synthetic fixture. Record must-haves, deferred work and acceptance checks in scope.md. Reuse your own Week 8 persistence and Week 10 feature. A reviewable scope names the inputs, user-visible outcomes and boundaries; a feature list alone cannot prove completion. | نطاق مراجع وقائمة مؤجلة ونسخ البداية ومخطط رحلة واحدة.Reviewed scope, deferred list, starting revisions and one journey diagram. |
| تثبيت نطاق فرديFreeze an individual scope | 60 | ممارسة موجّهةGuided practice | اطلب توقعاً وتتبع الحد المناسب وقلل التلميحات قبل العمل المستقل.Ask for a prediction, trace the relevant boundary and reduce prompts before independent work. | قارن نطاقين واحذف العمل الذي لا يدعم الرحلة الأساسية. ارسم الطلب ثم التحقق والمستودع والاستجابة مع حد منفصل للذكاء الاصطناعي.Compare two scopes and remove work that does not support the core journey. Draw request → validation → repository → response, with a separate boundary for AI. |
| تثبيت نطاق فرديFreeze an individual scope | 120 | مختبر خاضع للإشرافSupervised lab | افحص فرق المتعلم ودليله وحدد أول خطوة فاشلة واتفق على إصلاح محدد.Inspect the learner's own diff and evidence; identify the first failing step and agree on a focused repair. | أكمل scope.md وarchitecture.md. اذكر نسخ البداية والاختبارات الناجحة وأول خطر تكامل. احصل على مراجعة المدرّب للنطاق قبل إضافة ميزات.Complete scope.md and architecture.md. List your starting revisions, existing passing tests and the first integration risk. Obtain trainer scope review before adding features. |
ملاحظات الشرحExplanation notes
رحلة واحدة بدليل قابل للملاحظةOne journey with observable evidence
اختر سير إعلان خيالي واحداً: إنشاء إعلان مخزن وقراءته وتعديله وحذفه ثم طلب تحليل العينة الاصطناعية المعتمدة. سجّل الضروري والمؤجل وفحوص القبول في scope.md. أعد استخدام التخزين من عملك في الأسبوع الثامن والميزة من العاشر. يحدد النطاق القابل للمراجعة المدخلات والنتائج الظاهرة والحدود؛ قائمة الميزات وحدها لا تثبت الإنجاز.Choose one fictional notice workflow: create, read, update and delete a stored notice, then request analysis of the approved synthetic fixture. Record must-haves, deferred work and acceptance checks in scope.md. Reuse your own Week 8 persistence and Week 10 feature. A reviewable scope names the inputs, user-visible outcomes and boundaries; a feature list alone cannot prove completion.
أمثلة العرضDemonstration examples
ضروري: يبقى الإعلان المحفوظ قابلاً للقراءة بعد إعادة التشغيل. مؤجل: تسجيل الدخول والاستضافة العامة وتعدد النماذج. الدليل: إنشاء ثم إعادة تشغيل ثم توكيد القراءة.Must-have: a saved notice is still readable after restart. Deferred: login, public hosting and multiple models. Evidence: create → restart → read assertion.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- قارن نطاقين واحذف العمل الذي لا يدعم الرحلة الأساسية. ارسم الطلب ثم التحقق والمستودع والاستجابة مع حد منفصل للذكاء الاصطناعي.Compare two scopes and remove work that does not support the core journey. Draw request → validation → repository → response, with a separate boundary for AI.
تيسير المختبرLab facilitation
- قارن نطاقين واحذف العمل الذي لا يدعم الرحلة الأساسية. ارسم الطلب ثم التحقق والمستودع والاستجابة مع حد منفصل للذكاء الاصطناعي.Compare two scopes and remove work that does not support the core journey. Draw request → validation → repository → response, with a separate boundary for AI.
- أكمل scope.md وarchitecture.md. اذكر نسخ البداية والاختبارات الناجحة وأول خطر تكامل. احصل على مراجعة المدرّب للنطاق قبل إضافة ميزات.Complete scope.md and architecture.md. List your starting revisions, existing passing tests and the first integration risk. Obtain trainer scope review before adding features.
- سجّل المتوقع والفعلي والنسخة وأي شرط معلق. أصلح أول فحص فاشل وأعده.Record expected and actual results, the revision and any pending requirement. Repair the first failed check and rerun it.
الأدلة المتوقعةExpected evidence
- نطاق مراجع وقائمة مؤجلة ونسخ البداية ومخطط رحلة واحدة.Reviewed scope, deferred list, starting revisions and one journey diagram.
w11d1-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
ادمج API قاعدة البيانات وميزة AI المحدودة في نسخة فردية مرشحة للإصدار مع اختبارات وتوثيق.Combine the database API and bounded AI feature into an individual release candidate with tests and documentation.
- يشغّل المستودع الفردي مسار CRUD بتخزين دائم وميزة AI واحدة محدودة ومتحققاً منها.The individual repository runs a persistent CRUD flow and one bounded, validated AI feature.
- تغطي الاختبارات الآلية النجاح الأساسي وسلوكيات فشل قاعدة البيانات وAI المطلوبة.Automated tests cover core success and required database and AI failure behaviours.
- يتبع زميل التوثيق من إعداد نظيف ويشرح سجل استخدام AI ملكية التغييرات.A peer follows the documentation from clean setup and the AI-use record explains ownership of changes.
الأخطاء الشائعةCommon errors
- يُقدَّم مستودع وهمي دليلاً على بقاء التخزين بعد إعادة التشغيل.A fake repository is presented as proof of persistence after restart.
- يمرر التكامل نصاً مخزناً عشوائياً أو بيانات وصفية للنموذج.Integration forwards arbitrary stored text or database metadata to the model.
- يعمل README بملفات محلية غير موثقة فقط أو يشير الدليل إلى نسخة أخرى.The README works only with undocumented local files, or evidence refers to another revision.
تدخلات المدرّبTrainer interventions
- نفّذ جلسات تقليص النطاق عندما تكون أدلة التكامل معرضة للخطر وسجّل الميزات المؤجلة.Hold scope cuts when integration evidence is at risk and record deferred features.
- راجع الأدلة عبر الأسئلة والتتبع مع الحفاظ على الملكية الفردية للكود.Review evidence through questions and traces while preserving individual ownership of code.
الاستدراكRecovery
إذا فشلت أدلة الإصدار، احذف الميزات المؤجلة واستعد آخر مسار أساسي ناجح وأصلح أول خطوة إعداد نظيف فاشلة ثم أعد إنشاء أدلة الاختبارات والتوثيق نفسها.If the release evidence fails, cut deferred features, restore the last passing core flow, repair the first failed clean-setup step, and regenerate the same tests and documentation evidence.
البديل عند الانقطاع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
يجب أن يستخدم المشروع بيانات اصطناعية أو عامة بوضوح؛ ولا يجوز أن يحتوي تاريخ المستودع أو العينات أو السجلات أو العروض على سجلات شخصية أو محتوى خاص أو بيانات دخول.The capstone must use synthetic or clearly public data; repository history, fixtures, logs and demos must contain no personal records, private content or credentials.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي المساعدة فقط في تغييرات معلنة ومراجعة؛ ويملك المتعلّم النطاق ويستطيع شرح كل تغيير مقدم ويتحقق منه بالاختبارات ومراجعة الفروقات.AI may assist only with disclosed, reviewed changes; the learner owns the scope, can explain every submitted change, and verifies it with tests and diff review.
نص التسجيلRecording script
السردNarration
- اختر سير إعلان خيالي واحداً: إنشاء إعلان مخزن وقراءته وتعديله وحذفه ثم طلب تحليل العينة الاصطناعية المعتمدة. سجّل الضروري والمؤجل وفحوص القبول في scope.md. أعد استخدام التخزين من عملك في الأسبوع الثامن والميزة من العاشر. يحدد النطاق القابل للمراجعة المدخلات والنتائج الظاهرة والحدود؛ قائمة الميزات وحدها لا تثبت الإنجاز.Choose one fictional notice workflow: create, read, update and delete a stored notice, then request analysis of the approved synthetic fixture. Record must-haves, deferred work and acceptance checks in scope.md. Reuse your own Week 8 persistence and Week 10 feature. A reviewable scope names the inputs, user-visible outcomes and boundaries; a feature list alone cannot prove completion.
- ضروري: يبقى الإعلان المحفوظ قابلاً للقراءة بعد إعادة التشغيل. مؤجل: تسجيل الدخول والاستضافة العامة وتعدد النماذج. الدليل: إنشاء ثم إعادة تشغيل ثم توكيد القراءة.Must-have: a saved notice is still readable after restart. Deferred: login, public hosting and multiple models. Evidence: create → restart → read assertion.
إجراءات الشاشةScreen actions
- اعرض القالب العام المناسب والتتبع الاصطناعي ونتائج الاختبار المحجوبة. أشر إلى النسخة وأول فشل قابل للملاحظة.Show the relevant public template, synthetic trace and redacted test results. Point to the revision and the first observable failure.
النصوص الظاهرةCaptions
- اكتب معنى scope بالعربية ثم الإنجليزية.Caption scope in Arabic, then English.
نقاط التوقفPause points
- قارن نطاقين واحذف العمل الذي لا يدعم الرحلة الأساسية. ارسم الطلب ثم التحقق والمستودع والاستجابة مع حد منفصل للذكاء الاصطناعي.Compare two scopes and remove work that does not support the core journey. Draw request → validation → repository → response, with a separate boundary for AI.
قائمة التحقق من التسجيلRecording checklist
- تحقق من وضوح الترجمة العربية والبيانات الاصطناعية والنسخة الدقيقة وحالة الاختبار الصادقة وغياب محتوى التقييم السري.Confirm readable Arabic captions, synthetic data, exact revision, honest test status and no confidential assessment content.
اليوم 2Day 2
اليوم 2 — دمج التخزين والتحليل المضبوطDay 2 — Integrate persistence and controlled analysis
التحضيرPreparation
- مستودعا الأسبوعين الثامن والعاشر العاملان مع نطاق مشروع فردي معتمد.Weeks 8 and 10 working repositories plus an approved individual capstone scope.
- استخدم تنفيذاتك المراجعة وقاعدة PostgreSQL تدريبية محلية محمية. أبقِ استدعاءات النموذج وهمية. تتضمن البداية قوالب التخطيط والأدلة ولا تنفذ مشروعك.Use your own reviewed implementations and a guarded local PostgreSQL training database. Keep model calls mocked. The starter contains planning and evidence templates; it does not implement your capstone.
المواد المطلوبة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.
- حالات الإدخال الاصطناعية المقدمة فقط وعددها 5؛ دون بيانات مشاركين حقيقية.Only the 5 supplied synthetic input cases; no real participant data.
الأهدافObjectives
- جدول نقاط النهاية وتتبع ناجح للعينة المخزنة وأدلة المفقود وغير المعتمد وفشل القاعدة دون استدعاء نموذج.Endpoint table, successful stored-fixture trace and missing/unapproved/database-failure proofs with zero model calls.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| قراءة المخزن دون توسيع مدخل النموذجRead stored data without widening model input | 120 | تدريسInstruction | عرّف مسار تحليل بالسجل في جدول نقاط النهاية. تحقق أولاً من معرّف سجل موجب؛ يعيد السجل المفقود 404 وصفر استدعاءات للنموذج والمعرّف المعطوب 422. قارن نص الإعلان المخزن بعينة الأسبوع العاشر المعتمدة تماماً. يصل النص المسموح فقط لحدود النموذج القائمة. تبقى السجلات الأخرى صالحة لعمليات CRUD لكن تحليلها يعيد 422 قبل طبقة الربط. مرر نص الإعلان فقط ولا ترسل المعرفات أو البيانات الوصفية أو تفريغ القاعدة. يعيد فشل القاعدة 503 آمناً دون نموذج؛ واحتفظ باستجابة بديل النموذج المميزة للأسبوع العاشر.Define an analysis-by-record route in your endpoint table. Resolve a positive record ID first; a missing record returns 404 with zero model calls, and malformed IDs return 422. Compare the stored notice text against the exact Week 10 approved fixture. Only an exact allowed text reaches the existing model boundary. Other stored records remain usable for CRUD but analysis returns 422 before the adapter. Project only the notice text: never send IDs, metadata or a database dump. A database failure returns a safe 503 with zero model calls; preserve the distinct Week 10 model-fallback response. | جدول نقاط النهاية وتتبع ناجح للعينة المخزنة وأدلة المفقود وغير المعتمد وفشل القاعدة دون استدعاء نموذج.Endpoint table, successful stored-fixture trace and missing/unapproved/database-failure proofs with zero model calls. |
| دمج التخزين والتحليل المضبوطIntegrate persistence and controlled analysis | 60 | ممارسة موجّهةGuided practice | اطلب توقعاً وتتبع الحد المناسب وقلل التلميحات قبل العمل المستقل.Ask for a prediction, trace the relevant boundary and reduce prompts before independent work. | تتبّع الطبقة المسؤولة عن كل فشل. توقع الوصول للقاعدة وعدد استدعاءات الربط قبل تشغيل كل حالة.Trace which layer owns each failure. Predict both database access and adapter call count before running each case. |
| دمج التخزين والتحليل المضبوطIntegrate persistence and controlled analysis | 120 | مختبر خاضع للإشرافSupervised lab | افحص فرق المتعلم ودليله وحدد أول خطوة فاشلة واتفق على إصلاح محدد.Inspect the learner's own diff and evidence; identify the first failing step and agree on a focused repair. | نفّذ مسار التكامل بنفسك. استخدم وصولاً معلّماً للقاعدة ونماذج استجابة صارمة واختيار عينات داخلياً. حافظ على حارس قاعدة التدريب وإعادة الضبط المحدودة من الأسبوع الثامن.Implement your own integration route. Use parameterized database access, strict response models and internal fixture selection. Keep the training database guard and scoped reset from Week 8. |
ملاحظات الشرحExplanation notes
قراءة المخزن دون توسيع مدخل النموذجRead stored data without widening model input
عرّف مسار تحليل بالسجل في جدول نقاط النهاية. تحقق أولاً من معرّف سجل موجب؛ يعيد السجل المفقود 404 وصفر استدعاءات للنموذج والمعرّف المعطوب 422. قارن نص الإعلان المخزن بعينة الأسبوع العاشر المعتمدة تماماً. يصل النص المسموح فقط لحدود النموذج القائمة. تبقى السجلات الأخرى صالحة لعمليات CRUD لكن تحليلها يعيد 422 قبل طبقة الربط. مرر نص الإعلان فقط ولا ترسل المعرفات أو البيانات الوصفية أو تفريغ القاعدة. يعيد فشل القاعدة 503 آمناً دون نموذج؛ واحتفظ باستجابة بديل النموذج المميزة للأسبوع العاشر.Define an analysis-by-record route in your endpoint table. Resolve a positive record ID first; a missing record returns 404 with zero model calls, and malformed IDs return 422. Compare the stored notice text against the exact Week 10 approved fixture. Only an exact allowed text reaches the existing model boundary. Other stored records remain usable for CRUD but analysis returns 422 before the adapter. Project only the notice text: never send IDs, metadata or a database dump. A database failure returns a safe 503 with zero model calls; preserve the distinct Week 10 model-fallback response.
أمثلة العرضDemonstration examples
العينة المعتمدة الموجودة تعطي التحليل. المعرف المحذوف يعطي 404 وصفر استدعاءات. النص المختلف الموجود يعطي 422 وصفر استدعاءات. مهلة النموذج بعد قراءة مسموحة تعطي بديل الأسبوع العاشر الدقيق.Existing approved fixture → analysis. Deleted ID → 404, zero calls. Existing different text → 422, zero calls. Model timeout after an allowed read → exact Week 10 fallback.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- تتبّع الطبقة المسؤولة عن كل فشل. توقع الوصول للقاعدة وعدد استدعاءات الربط قبل تشغيل كل حالة.Trace which layer owns each failure. Predict both database access and adapter call count before running each case.
تيسير المختبرLab facilitation
- تتبّع الطبقة المسؤولة عن كل فشل. توقع الوصول للقاعدة وعدد استدعاءات الربط قبل تشغيل كل حالة.Trace which layer owns each failure. Predict both database access and adapter call count before running each case.
- نفّذ مسار التكامل بنفسك. استخدم وصولاً معلّماً للقاعدة ونماذج استجابة صارمة واختيار عينات داخلياً. حافظ على حارس قاعدة التدريب وإعادة الضبط المحدودة من الأسبوع الثامن.Implement your own integration route. Use parameterized database access, strict response models and internal fixture selection. Keep the training database guard and scoped reset from Week 8.
- سجّل المتوقع والفعلي والنسخة وأي شرط معلق. أصلح أول فحص فاشل وأعده.Record expected and actual results, the revision and any pending requirement. Repair the first failed check and rerun it.
الأدلة المتوقعةExpected evidence
- جدول نقاط النهاية وتتبع ناجح للعينة المخزنة وأدلة المفقود وغير المعتمد وفشل القاعدة دون استدعاء نموذج.Endpoint table, successful stored-fixture trace and missing/unapproved/database-failure proofs with zero model calls.
w11d2-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
ادمج API قاعدة البيانات وميزة AI المحدودة في نسخة فردية مرشحة للإصدار مع اختبارات وتوثيق.Combine the database API and bounded AI feature into an individual release candidate with tests and documentation.
- يشغّل المستودع الفردي مسار CRUD بتخزين دائم وميزة AI واحدة محدودة ومتحققاً منها.The individual repository runs a persistent CRUD flow and one bounded, validated AI feature.
- تغطي الاختبارات الآلية النجاح الأساسي وسلوكيات فشل قاعدة البيانات وAI المطلوبة.Automated tests cover core success and required database and AI failure behaviours.
- يتبع زميل التوثيق من إعداد نظيف ويشرح سجل استخدام AI ملكية التغييرات.A peer follows the documentation from clean setup and the AI-use record explains ownership of changes.
الأخطاء الشائعةCommon errors
- يُقدَّم مستودع وهمي دليلاً على بقاء التخزين بعد إعادة التشغيل.A fake repository is presented as proof of persistence after restart.
- يمرر التكامل نصاً مخزناً عشوائياً أو بيانات وصفية للنموذج.Integration forwards arbitrary stored text or database metadata to the model.
- يعمل README بملفات محلية غير موثقة فقط أو يشير الدليل إلى نسخة أخرى.The README works only with undocumented local files, or evidence refers to another revision.
تدخلات المدرّبTrainer interventions
- نفّذ جلسات تقليص النطاق عندما تكون أدلة التكامل معرضة للخطر وسجّل الميزات المؤجلة.Hold scope cuts when integration evidence is at risk and record deferred features.
- راجع الأدلة عبر الأسئلة والتتبع مع الحفاظ على الملكية الفردية للكود.Review evidence through questions and traces while preserving individual ownership of code.
الاستدراكRecovery
إذا فشلت أدلة الإصدار، احذف الميزات المؤجلة واستعد آخر مسار أساسي ناجح وأصلح أول خطوة إعداد نظيف فاشلة ثم أعد إنشاء أدلة الاختبارات والتوثيق نفسها.If the release evidence fails, cut deferred features, restore the last passing core flow, repair the first failed clean-setup step, and regenerate the same tests and documentation evidence.
البديل عند الانقطاع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
يجب أن يستخدم المشروع بيانات اصطناعية أو عامة بوضوح؛ ولا يجوز أن يحتوي تاريخ المستودع أو العينات أو السجلات أو العروض على سجلات شخصية أو محتوى خاص أو بيانات دخول.The capstone must use synthetic or clearly public data; repository history, fixtures, logs and demos must contain no personal records, private content or credentials.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي المساعدة فقط في تغييرات معلنة ومراجعة؛ ويملك المتعلّم النطاق ويستطيع شرح كل تغيير مقدم ويتحقق منه بالاختبارات ومراجعة الفروقات.AI may assist only with disclosed, reviewed changes; the learner owns the scope, can explain every submitted change, and verifies it with tests and diff review.
نص التسجيلRecording script
السردNarration
- عرّف مسار تحليل بالسجل في جدول نقاط النهاية. تحقق أولاً من معرّف سجل موجب؛ يعيد السجل المفقود 404 وصفر استدعاءات للنموذج والمعرّف المعطوب 422. قارن نص الإعلان المخزن بعينة الأسبوع العاشر المعتمدة تماماً. يصل النص المسموح فقط لحدود النموذج القائمة. تبقى السجلات الأخرى صالحة لعمليات CRUD لكن تحليلها يعيد 422 قبل طبقة الربط. مرر نص الإعلان فقط ولا ترسل المعرفات أو البيانات الوصفية أو تفريغ القاعدة. يعيد فشل القاعدة 503 آمناً دون نموذج؛ واحتفظ باستجابة بديل النموذج المميزة للأسبوع العاشر.Define an analysis-by-record route in your endpoint table. Resolve a positive record ID first; a missing record returns 404 with zero model calls, and malformed IDs return 422. Compare the stored notice text against the exact Week 10 approved fixture. Only an exact allowed text reaches the existing model boundary. Other stored records remain usable for CRUD but analysis returns 422 before the adapter. Project only the notice text: never send IDs, metadata or a database dump. A database failure returns a safe 503 with zero model calls; preserve the distinct Week 10 model-fallback response.
- العينة المعتمدة الموجودة تعطي التحليل. المعرف المحذوف يعطي 404 وصفر استدعاءات. النص المختلف الموجود يعطي 422 وصفر استدعاءات. مهلة النموذج بعد قراءة مسموحة تعطي بديل الأسبوع العاشر الدقيق.Existing approved fixture → analysis. Deleted ID → 404, zero calls. Existing different text → 422, zero calls. Model timeout after an allowed read → exact Week 10 fallback.
إجراءات الشاشةScreen actions
- اعرض القالب العام المناسب والتتبع الاصطناعي ونتائج الاختبار المحجوبة. أشر إلى النسخة وأول فشل قابل للملاحظة.Show the relevant public template, synthetic trace and redacted test results. Point to the revision and the first observable failure.
النصوص الظاهرةCaptions
- اكتب معنى projection بالعربية ثم الإنجليزية.Caption projection in Arabic, then English.
نقاط التوقفPause points
- تتبّع الطبقة المسؤولة عن كل فشل. توقع الوصول للقاعدة وعدد استدعاءات الربط قبل تشغيل كل حالة.Trace which layer owns each failure. Predict both database access and adapter call count before running each case.
قائمة التحقق من التسجيلRecording checklist
- تحقق من وضوح الترجمة العربية والبيانات الاصطناعية والنسخة الدقيقة وحالة الاختبار الصادقة وغياب محتوى التقييم السري.Confirm readable Arabic captions, synthetic data, exact revision, honest test status and no confidential assessment content.
اليوم 3Day 3
اليوم 3 — إثبات المسار الكامل والأعطالDay 3 — Prove the complete flow and failures
التحضيرPreparation
- مستودعا الأسبوعين الثامن والعاشر العاملان مع نطاق مشروع فردي معتمد.Weeks 8 and 10 working repositories plus an approved individual capstone scope.
- استخدم تنفيذاتك المراجعة وقاعدة PostgreSQL تدريبية محلية محمية. أبقِ استدعاءات النموذج وهمية. تتضمن البداية قوالب التخطيط والأدلة ولا تنفذ مشروعك.Use your own reviewed implementations and a guarded local PostgreSQL training database. Keep model calls mocked. The starter contains planning and evidence templates; it does not implement your capstone.
المواد المطلوبة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.
- حالات الإدخال الاصطناعية المقدمة فقط وعددها 5؛ دون بيانات مشاركين حقيقية.Only the 5 supplied synthetic input cases; no real participant data.
الأهدافObjectives
- تشغيلان قابلان للتكرار ودليل بقاء التخزين بعد إعادة التشغيل ودليل التراجع ومصفوفة أعطال باستجابات دقيقة.Two reproducible runs, persistence-after-restart proof, rollback proof and failure matrix with exact responses.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| التخزين الدائم يحتاج فحص تخزين فعلياًPersistence needs a real persistence check | 120 | تدريسInstruction | نظّم الاختبارات في طبقات المخطط والوحدة والمستودع المعزول وتكامل API الكامل. استخدم قاعدة PostgreSQL التدريبية المحلية المحمية لإثبات بقاء الكتابة المعتمدة بعد اتصال جديد وإعادة تشغيل التطبيق. لا يثبت المستودع الوهمي التخزين. استبدل ناقل النموذج الخارجي بعينات واحجب الوصول الخارجي للنموذج مع السماح بقاعدة الاختبار المحلية المراجعة فقط. غطّ المدخل غير الصالح والسجل المفقود والتراجع بعد الفشل وبديل AI الدقيق. افحص الاستجابات وعدد الاستدعاءات ولا تكتفِ بإثبات تشغيل الدوال.Organize tests into schema/unit, isolated repository and full API integration layers. Use the guarded local PostgreSQL training database to prove committed writes survive a new connection and application restart. A fake repository cannot prove persistence. Replace the external model transport with fixtures and block outbound model access while allowing only the reviewed local test database. Cover invalid input, missing records, rollback after failure and exact AI fallback. Tests must verify responses and call counts, not merely that helpers were invoked. | تشغيلان قابلان للتكرار ودليل بقاء التخزين بعد إعادة التشغيل ودليل التراجع ومصفوفة أعطال باستجابات دقيقة.Two reproducible runs, persistence-after-restart proof, rollback proof and failure matrix with exact responses. |
| إثبات المسار الكامل والأعطالProve the complete flow and failures | 60 | ممارسة موجّهةGuided practice | اطلب توقعاً وتتبع الحد المناسب وقلل التلميحات قبل العمل المستقل.Ask for a prediction, trace the relevant boundary and reduce prompts before independent work. | صنّف كل صف في مصفوفة القبول حسب طبقة الاختبار. اشرح ما يحتاج PostgreSQL وما يجب أن يعمل دونها.Classify each acceptance-matrix row by test layer. Explain which checks need PostgreSQL and which must run without it. |
| إثبات المسار الكامل والأعطالProve the complete flow and failures | 120 | مختبر خاضع للإشرافSupervised lab | افحص فرق المتعلم ودليله وحدد أول خطوة فاشلة واتفق على إصلاح محدد.Inspect the learner's own diff and evidence; identify the first failing step and agree on a focused repair. | أكمل test-matrix.md بأسماء الاختبارات ونتائجها الفعلية. شغّل المجموعة الموثقة مرتين على بيانات اصطناعية معاد ضبطها. إذا تعذرت PostgreSQL محلياً فأبقِ دليل التخزين معلقاً وأكمل اختبارات الوحدة وAI منفصلة.Fill test-matrix.md with test names and actual results. Run the documented suite twice against reset synthetic data. If local PostgreSQL is unavailable, mark persistence evidence pending and complete unit/AI tests separately. |
ملاحظات الشرحExplanation notes
التخزين الدائم يحتاج فحص تخزين فعلياًPersistence needs a real persistence check
نظّم الاختبارات في طبقات المخطط والوحدة والمستودع المعزول وتكامل API الكامل. استخدم قاعدة PostgreSQL التدريبية المحلية المحمية لإثبات بقاء الكتابة المعتمدة بعد اتصال جديد وإعادة تشغيل التطبيق. لا يثبت المستودع الوهمي التخزين. استبدل ناقل النموذج الخارجي بعينات واحجب الوصول الخارجي للنموذج مع السماح بقاعدة الاختبار المحلية المراجعة فقط. غطّ المدخل غير الصالح والسجل المفقود والتراجع بعد الفشل وبديل AI الدقيق. افحص الاستجابات وعدد الاستدعاءات ولا تكتفِ بإثبات تشغيل الدوال.Organize tests into schema/unit, isolated repository and full API integration layers. Use the guarded local PostgreSQL training database to prove committed writes survive a new connection and application restart. A fake repository cannot prove persistence. Replace the external model transport with fixtures and block outbound model access while allowing only the reviewed local test database. Cover invalid input, missing records, rollback after failure and exact AI fallback. Tests must verify responses and call counts, not merely that helpers were invoked.
أمثلة العرضDemonstration examples
أنشئ ثم أغلق الاتصال وافتح اتصالاً جديداً واقرأ المعرف نفسه. افتعل كتابة فاشلة ثم تراجع وتحقق من ثبات الصف. عينة المهلة تعطي 503 ونتيجة null والرسالة الثابتة بالعربية أولاً.Create → close connection → new connection → read same ID. Force a failed write → rollback → unchanged stored row. Timeout fixture → 503 with null result and fixed Arabic-first message.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- صنّف كل صف في مصفوفة القبول حسب طبقة الاختبار. اشرح ما يحتاج PostgreSQL وما يجب أن يعمل دونها.Classify each acceptance-matrix row by test layer. Explain which checks need PostgreSQL and which must run without it.
تيسير المختبرLab facilitation
- صنّف كل صف في مصفوفة القبول حسب طبقة الاختبار. اشرح ما يحتاج PostgreSQL وما يجب أن يعمل دونها.Classify each acceptance-matrix row by test layer. Explain which checks need PostgreSQL and which must run without it.
- أكمل test-matrix.md بأسماء الاختبارات ونتائجها الفعلية. شغّل المجموعة الموثقة مرتين على بيانات اصطناعية معاد ضبطها. إذا تعذرت PostgreSQL محلياً فأبقِ دليل التخزين معلقاً وأكمل اختبارات الوحدة وAI منفصلة.Fill test-matrix.md with test names and actual results. Run the documented suite twice against reset synthetic data. If local PostgreSQL is unavailable, mark persistence evidence pending and complete unit/AI tests separately.
- سجّل المتوقع والفعلي والنسخة وأي شرط معلق. أصلح أول فحص فاشل وأعده.Record expected and actual results, the revision and any pending requirement. Repair the first failed check and rerun it.
الأدلة المتوقعةExpected evidence
- تشغيلان قابلان للتكرار ودليل بقاء التخزين بعد إعادة التشغيل ودليل التراجع ومصفوفة أعطال باستجابات دقيقة.Two reproducible runs, persistence-after-restart proof, rollback proof and failure matrix with exact responses.
w11d3-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
ادمج API قاعدة البيانات وميزة AI المحدودة في نسخة فردية مرشحة للإصدار مع اختبارات وتوثيق.Combine the database API and bounded AI feature into an individual release candidate with tests and documentation.
- يشغّل المستودع الفردي مسار CRUD بتخزين دائم وميزة AI واحدة محدودة ومتحققاً منها.The individual repository runs a persistent CRUD flow and one bounded, validated AI feature.
- تغطي الاختبارات الآلية النجاح الأساسي وسلوكيات فشل قاعدة البيانات وAI المطلوبة.Automated tests cover core success and required database and AI failure behaviours.
- يتبع زميل التوثيق من إعداد نظيف ويشرح سجل استخدام AI ملكية التغييرات.A peer follows the documentation from clean setup and the AI-use record explains ownership of changes.
الأخطاء الشائعةCommon errors
- يُقدَّم مستودع وهمي دليلاً على بقاء التخزين بعد إعادة التشغيل.A fake repository is presented as proof of persistence after restart.
- يمرر التكامل نصاً مخزناً عشوائياً أو بيانات وصفية للنموذج.Integration forwards arbitrary stored text or database metadata to the model.
- يعمل README بملفات محلية غير موثقة فقط أو يشير الدليل إلى نسخة أخرى.The README works only with undocumented local files, or evidence refers to another revision.
تدخلات المدرّبTrainer interventions
- نفّذ جلسات تقليص النطاق عندما تكون أدلة التكامل معرضة للخطر وسجّل الميزات المؤجلة.Hold scope cuts when integration evidence is at risk and record deferred features.
- راجع الأدلة عبر الأسئلة والتتبع مع الحفاظ على الملكية الفردية للكود.Review evidence through questions and traces while preserving individual ownership of code.
الاستدراكRecovery
إذا فشلت أدلة الإصدار، احذف الميزات المؤجلة واستعد آخر مسار أساسي ناجح وأصلح أول خطوة إعداد نظيف فاشلة ثم أعد إنشاء أدلة الاختبارات والتوثيق نفسها.If the release evidence fails, cut deferred features, restore the last passing core flow, repair the first failed clean-setup step, and regenerate the same tests and documentation evidence.
البديل عند الانقطاع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
يجب أن يستخدم المشروع بيانات اصطناعية أو عامة بوضوح؛ ولا يجوز أن يحتوي تاريخ المستودع أو العينات أو السجلات أو العروض على سجلات شخصية أو محتوى خاص أو بيانات دخول.The capstone must use synthetic or clearly public data; repository history, fixtures, logs and demos must contain no personal records, private content or credentials.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي المساعدة فقط في تغييرات معلنة ومراجعة؛ ويملك المتعلّم النطاق ويستطيع شرح كل تغيير مقدم ويتحقق منه بالاختبارات ومراجعة الفروقات.AI may assist only with disclosed, reviewed changes; the learner owns the scope, can explain every submitted change, and verifies it with tests and diff review.
نص التسجيلRecording script
السردNarration
- نظّم الاختبارات في طبقات المخطط والوحدة والمستودع المعزول وتكامل API الكامل. استخدم قاعدة PostgreSQL التدريبية المحلية المحمية لإثبات بقاء الكتابة المعتمدة بعد اتصال جديد وإعادة تشغيل التطبيق. لا يثبت المستودع الوهمي التخزين. استبدل ناقل النموذج الخارجي بعينات واحجب الوصول الخارجي للنموذج مع السماح بقاعدة الاختبار المحلية المراجعة فقط. غطّ المدخل غير الصالح والسجل المفقود والتراجع بعد الفشل وبديل AI الدقيق. افحص الاستجابات وعدد الاستدعاءات ولا تكتفِ بإثبات تشغيل الدوال.Organize tests into schema/unit, isolated repository and full API integration layers. Use the guarded local PostgreSQL training database to prove committed writes survive a new connection and application restart. A fake repository cannot prove persistence. Replace the external model transport with fixtures and block outbound model access while allowing only the reviewed local test database. Cover invalid input, missing records, rollback after failure and exact AI fallback. Tests must verify responses and call counts, not merely that helpers were invoked.
- أنشئ ثم أغلق الاتصال وافتح اتصالاً جديداً واقرأ المعرف نفسه. افتعل كتابة فاشلة ثم تراجع وتحقق من ثبات الصف. عينة المهلة تعطي 503 ونتيجة null والرسالة الثابتة بالعربية أولاً.Create → close connection → new connection → read same ID. Force a failed write → rollback → unchanged stored row. Timeout fixture → 503 with null result and fixed Arabic-first message.
إجراءات الشاشةScreen actions
- اعرض القالب العام المناسب والتتبع الاصطناعي ونتائج الاختبار المحجوبة. أشر إلى النسخة وأول فشل قابل للملاحظة.Show the relevant public template, synthetic trace and redacted test results. Point to the revision and the first observable failure.
النصوص الظاهرةCaptions
- اكتب معنى integration test بالعربية ثم الإنجليزية.Caption integration test in Arabic, then English.
نقاط التوقفPause points
- صنّف كل صف في مصفوفة القبول حسب طبقة الاختبار. اشرح ما يحتاج PostgreSQL وما يجب أن يعمل دونها.Classify each acceptance-matrix row by test layer. Explain which checks need PostgreSQL and which must run without it.
قائمة التحقق من التسجيلRecording checklist
- تحقق من وضوح الترجمة العربية والبيانات الاصطناعية والنسخة الدقيقة وحالة الاختبار الصادقة وغياب محتوى التقييم السري.Confirm readable Arabic captions, synthetic data, exact revision, honest test status and no confidential assessment content.
اليوم 4Day 4
اليوم 4 — التحقق من إعداد نظيف لشخص آخرDay 4 — Verify another person's clean setup
التحضيرPreparation
- مستودعا الأسبوعين الثامن والعاشر العاملان مع نطاق مشروع فردي معتمد.Weeks 8 and 10 working repositories plus an approved individual capstone scope.
- استخدم تنفيذاتك المراجعة وقاعدة PostgreSQL تدريبية محلية محمية. أبقِ استدعاءات النموذج وهمية. تتضمن البداية قوالب التخطيط والأدلة ولا تنفذ مشروعك.Use your own reviewed implementations and a guarded local PostgreSQL training database. Keep model calls mocked. The starter contains planning and evidence templates; it does not implement your capstone.
المواد المطلوبة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.
- حالات الإدخال الاصطناعية المقدمة فقط وعددها 5؛ دون بيانات مشاركين حقيقية.Only the 5 supplied synthetic input cases; no real participant data.
الأهدافObjectives
- سجل إعداد نظيف من زميل مرتبط بالنسخة وتعليمات مصححة وقيود وتاريخ استخدام AI.Peer clean-setup record linked to the revision, corrected instructions, limitations and AI-use history.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| التوثيق تسليم قابل للتنفيذDocumentation is an executable handoff | 120 | تدريسInstruction | يبدأ زميل من نسخة نظيفة لنسخة محددة ويتبع README فقط. وثّق إصدارات Python وPostgreSQL والاعتماديات وقالب البيئة الفارغ وإعداد المخطط والبيانات المحمي وأمر البدء المحلي والاختبارات والتنظيف. سجّل أول خطوة فاشلة بدقة وأصلح التوثيق أو الكود وكررها من حالة نظيفة. سجّل اقتراحات AI وقرارك وتعديلاتك والتحقق لكل تغيير جوهري مساعد. لا تدرج المفاتيح أو المسارات المطلقة الخاصة بالجهاز في الدليل المشترك.A peer starts from a fresh checkout of a named revision and follows README instructions only. Document Python and PostgreSQL versions, dependencies, blank environment template, guarded schema/seed setup, localhost start command, tests and cleanup. Record the first failing step exactly, repair the documentation or code and repeat that step from a clean state. Record AI suggestions, your decision, modifications and verification for each material assisted change. Never include credentials or machine-specific absolute paths in shared evidence. | سجل إعداد نظيف من زميل مرتبط بالنسخة وتعليمات مصححة وقيود وتاريخ استخدام AI.Peer clean-setup record linked to the revision, corrected instructions, limitations and AI-use history. |
| التحقق من إعداد نظيف لشخص آخرVerify another person's clean setup | 60 | ممارسة موجّهةGuided practice | اطلب توقعاً وتتبع الحد المناسب وقلل التلميحات قبل العمل المستقل.Ask for a prediction, trace the relevant boundary and reduce prompts before independent work. | تبادل تعليمات الإعداد. يراقب صاحب المشروع دون إكمال الخطوات غير الموثقة ويسجل الزميل الدليل بدلاً من علامة موافقة فقط.Exchange setup instructions. The owner observes without filling in undocumented steps; the peer records evidence rather than a simple approval tick. |
| التحقق من إعداد نظيف لشخص آخرVerify another person's clean setup | 120 | مختبر خاضع للإشرافSupervised lab | افحص فرق المتعلم ودليله وحدد أول خطوة فاشلة واتفق على إصلاح محدد.Inspect the learner's own diff and evidence; identify the first failing step and agree on a focused repair. | أكمل clean-setup.md وlimitations.md وai-use.md. أصلح فجوة ملحوظة وأعد الفحوص المناسبة وراجع الفرق النهائي للملفات المولدة أو الأسرار.Complete clean-setup.md, limitations.md and ai-use.md. Repair one observed gap, rerun the relevant checks and review the final diff for generated files or secrets. |
ملاحظات الشرحExplanation notes
التوثيق تسليم قابل للتنفيذDocumentation is an executable handoff
يبدأ زميل من نسخة نظيفة لنسخة محددة ويتبع README فقط. وثّق إصدارات Python وPostgreSQL والاعتماديات وقالب البيئة الفارغ وإعداد المخطط والبيانات المحمي وأمر البدء المحلي والاختبارات والتنظيف. سجّل أول خطوة فاشلة بدقة وأصلح التوثيق أو الكود وكررها من حالة نظيفة. سجّل اقتراحات AI وقرارك وتعديلاتك والتحقق لكل تغيير جوهري مساعد. لا تدرج المفاتيح أو المسارات المطلقة الخاصة بالجهاز في الدليل المشترك.A peer starts from a fresh checkout of a named revision and follows README instructions only. Document Python and PostgreSQL versions, dependencies, blank environment template, guarded schema/seed setup, localhost start command, tests and cleanup. Record the first failing step exactly, repair the documentation or code and repeat that step from a clean state. Record AI suggestions, your decision, modifications and verification for each material assisted change. Never include credentials or machine-specific absolute paths in shared evidence.
أمثلة العرضDemonstration examples
يفشل README الذي يهمل إعداد المخطط في فحص الزميل حتى لو عمل جهاز صاحبه. يذكر السجل الخطوة الناقصة والتصحيح والنسخة ونتيجة الإعادة.A README that omits schema setup fails the peer check even if the owner's machine works. The record names the missing step, correction, revision and rerun result.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- تبادل تعليمات الإعداد. يراقب صاحب المشروع دون إكمال الخطوات غير الموثقة ويسجل الزميل الدليل بدلاً من علامة موافقة فقط.Exchange setup instructions. The owner observes without filling in undocumented steps; the peer records evidence rather than a simple approval tick.
تيسير المختبرLab facilitation
- تبادل تعليمات الإعداد. يراقب صاحب المشروع دون إكمال الخطوات غير الموثقة ويسجل الزميل الدليل بدلاً من علامة موافقة فقط.Exchange setup instructions. The owner observes without filling in undocumented steps; the peer records evidence rather than a simple approval tick.
- أكمل clean-setup.md وlimitations.md وai-use.md. أصلح فجوة ملحوظة وأعد الفحوص المناسبة وراجع الفرق النهائي للملفات المولدة أو الأسرار.Complete clean-setup.md, limitations.md and ai-use.md. Repair one observed gap, rerun the relevant checks and review the final diff for generated files or secrets.
- سجّل المتوقع والفعلي والنسخة وأي شرط معلق. أصلح أول فحص فاشل وأعده.Record expected and actual results, the revision and any pending requirement. Repair the first failed check and rerun it.
الأدلة المتوقعةExpected evidence
- سجل إعداد نظيف من زميل مرتبط بالنسخة وتعليمات مصححة وقيود وتاريخ استخدام AI.Peer clean-setup record linked to the revision, corrected instructions, limitations and AI-use history.
w11d4-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
ادمج API قاعدة البيانات وميزة AI المحدودة في نسخة فردية مرشحة للإصدار مع اختبارات وتوثيق.Combine the database API and bounded AI feature into an individual release candidate with tests and documentation.
- يشغّل المستودع الفردي مسار CRUD بتخزين دائم وميزة AI واحدة محدودة ومتحققاً منها.The individual repository runs a persistent CRUD flow and one bounded, validated AI feature.
- تغطي الاختبارات الآلية النجاح الأساسي وسلوكيات فشل قاعدة البيانات وAI المطلوبة.Automated tests cover core success and required database and AI failure behaviours.
- يتبع زميل التوثيق من إعداد نظيف ويشرح سجل استخدام AI ملكية التغييرات.A peer follows the documentation from clean setup and the AI-use record explains ownership of changes.
الأخطاء الشائعةCommon errors
- يُقدَّم مستودع وهمي دليلاً على بقاء التخزين بعد إعادة التشغيل.A fake repository is presented as proof of persistence after restart.
- يمرر التكامل نصاً مخزناً عشوائياً أو بيانات وصفية للنموذج.Integration forwards arbitrary stored text or database metadata to the model.
- يعمل README بملفات محلية غير موثقة فقط أو يشير الدليل إلى نسخة أخرى.The README works only with undocumented local files, or evidence refers to another revision.
تدخلات المدرّبTrainer interventions
- نفّذ جلسات تقليص النطاق عندما تكون أدلة التكامل معرضة للخطر وسجّل الميزات المؤجلة.Hold scope cuts when integration evidence is at risk and record deferred features.
- راجع الأدلة عبر الأسئلة والتتبع مع الحفاظ على الملكية الفردية للكود.Review evidence through questions and traces while preserving individual ownership of code.
الاستدراكRecovery
إذا فشلت أدلة الإصدار، احذف الميزات المؤجلة واستعد آخر مسار أساسي ناجح وأصلح أول خطوة إعداد نظيف فاشلة ثم أعد إنشاء أدلة الاختبارات والتوثيق نفسها.If the release evidence fails, cut deferred features, restore the last passing core flow, repair the first failed clean-setup step, and regenerate the same tests and documentation evidence.
البديل عند الانقطاع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
يجب أن يستخدم المشروع بيانات اصطناعية أو عامة بوضوح؛ ولا يجوز أن يحتوي تاريخ المستودع أو العينات أو السجلات أو العروض على سجلات شخصية أو محتوى خاص أو بيانات دخول.The capstone must use synthetic or clearly public data; repository history, fixtures, logs and demos must contain no personal records, private content or credentials.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي المساعدة فقط في تغييرات معلنة ومراجعة؛ ويملك المتعلّم النطاق ويستطيع شرح كل تغيير مقدم ويتحقق منه بالاختبارات ومراجعة الفروقات.AI may assist only with disclosed, reviewed changes; the learner owns the scope, can explain every submitted change, and verifies it with tests and diff review.
نص التسجيلRecording script
السردNarration
- يبدأ زميل من نسخة نظيفة لنسخة محددة ويتبع README فقط. وثّق إصدارات Python وPostgreSQL والاعتماديات وقالب البيئة الفارغ وإعداد المخطط والبيانات المحمي وأمر البدء المحلي والاختبارات والتنظيف. سجّل أول خطوة فاشلة بدقة وأصلح التوثيق أو الكود وكررها من حالة نظيفة. سجّل اقتراحات AI وقرارك وتعديلاتك والتحقق لكل تغيير جوهري مساعد. لا تدرج المفاتيح أو المسارات المطلقة الخاصة بالجهاز في الدليل المشترك.A peer starts from a fresh checkout of a named revision and follows README instructions only. Document Python and PostgreSQL versions, dependencies, blank environment template, guarded schema/seed setup, localhost start command, tests and cleanup. Record the first failing step exactly, repair the documentation or code and repeat that step from a clean state. Record AI suggestions, your decision, modifications and verification for each material assisted change. Never include credentials or machine-specific absolute paths in shared evidence.
- يفشل README الذي يهمل إعداد المخطط في فحص الزميل حتى لو عمل جهاز صاحبه. يذكر السجل الخطوة الناقصة والتصحيح والنسخة ونتيجة الإعادة.A README that omits schema setup fails the peer check even if the owner's machine works. The record names the missing step, correction, revision and rerun result.
إجراءات الشاشةScreen actions
- اعرض القالب العام المناسب والتتبع الاصطناعي ونتائج الاختبار المحجوبة. أشر إلى النسخة وأول فشل قابل للملاحظة.Show the relevant public template, synthetic trace and redacted test results. Point to the revision and the first observable failure.
النصوص الظاهرةCaptions
- اكتب معنى reproducible بالعربية ثم الإنجليزية.Caption reproducible in Arabic, then English.
نقاط التوقفPause points
- تبادل تعليمات الإعداد. يراقب صاحب المشروع دون إكمال الخطوات غير الموثقة ويسجل الزميل الدليل بدلاً من علامة موافقة فقط.Exchange setup instructions. The owner observes without filling in undocumented steps; the peer records evidence rather than a simple approval tick.
قائمة التحقق من التسجيلRecording checklist
- تحقق من وضوح الترجمة العربية والبيانات الاصطناعية والنسخة الدقيقة وحالة الاختبار الصادقة وغياب محتوى التقييم السري.Confirm readable Arabic captions, synthetic data, exact revision, honest test status and no confidential assessment content.
اليوم 5Day 5
اليوم 5 — عرض النسخة الفردية المرشحة للإصدارDay 5 — Demonstrate the individual release candidate
التحضيرPreparation
- مستودعا الأسبوعين الثامن والعاشر العاملان مع نطاق مشروع فردي معتمد.Weeks 8 and 10 working repositories plus an approved individual capstone scope.
- استخدم تنفيذاتك المراجعة وقاعدة PostgreSQL تدريبية محلية محمية. أبقِ استدعاءات النموذج وهمية. تتضمن البداية قوالب التخطيط والأدلة ولا تنفذ مشروعك.Use your own reviewed implementations and a guarded local PostgreSQL training database. Keep model calls mocked. The starter contains planning and evidence templates; it does not implement your capstone.
المواد المطلوبة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.
- حالات الإدخال الاصطناعية المقدمة فقط وعددها 5؛ دون بيانات مشاركين حقيقية.Only the 5 supplied synthetic input cases; no real participant data.
الأهدافObjectives
- نسخة فردية موسومة وقائمة إصدار كاملة وتتبع العرض ودليل معلق موثق.Tagged individual revision, complete release checklist, demonstration trace and documented pending evidence.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| عرض النسخة الفردية المرشحة للإصدارDemonstrate the individual release candidate | 300 | مختبر خاضع للإشرافSupervised lab | راجع النسخة المقدمة والدليل والشرح الفردي حسب المعايير المنشورة وسجّل الدليل الناقص والاستدراك.Review the submitted revision, evidence and individual explanation against the published criteria. Record any missing evidence and recovery action. | اعرض نسختك المرشحة فردياً وأكمل release-checklist.md وجهّز الأدلة بمسارات نسبية. يراجع المدرّب الدليل والملكية وتبقى مواد التقييم السرية منفصلة.Independently demonstrate your release candidate, complete release-checklist.md and package project-relative evidence. The trainer reviews evidence and ownership, while confidential assessment materials remain separate. |
ملاحظات الشرحExplanation notes
النسخة تربط الكود بالدليلA revision ties code to evidence
قدّم نسخة محددة ووسم نسخة مرشحة بعد توافق النطاق والاختبارات والإعداد النظيف. اعرض تخزين CRUD ومسار التحليل المحدود ثم سجلاً مفقوداً وفشل نموذج. اشرح كل حد وتغييراً نفذته باستقلال. اربط كل ادعاء باختبار أو تتبع ملحوظ. سجّل الدليل الناقص صراحة بما فيه أي شرط فعلي منفصل للأسبوع التاسع؛ لا تثبت اختبارات AI الوهمية اتصالاً حقيقياً. سيقيّم الأسبوع الثاني عشر قابلية الإعادة والمناقشة والتصحيح المستقل.Submit a named commit and release-candidate tag after scope, tests and clean setup agree. Demonstrate CRUD persistence and the bounded analysis path, then show a missing record and a model failure. Explain each boundary and one change you made independently. Link every claim to a test or observed trace. Record incomplete evidence explicitly, including any separate Week 9 live requirement; passing mocked AI tests does not prove a real call. Week 12 will assess reproducibility, defence and independent debugging.
أمثلة العرضDemonstration examples
يتضمن التسليم النسخة الدقيقة والنطاق المقبول ومخرجات الاختبار وسجل إعداد الزميل والقيود الصادقة. لقطة بلا نسختها ليست دليلاً كافياً للإصدار.The handoff contains the exact revision, accepted scope, test output, peer setup record and honest limitations. A screenshot without its revision is insufficient release evidence.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- تدرّب على شرح موجز للرحلة وحد القاعدة وحد النموذج ومسارات الفشل والقيود المتبقية.Rehearse a short explanation of the journey, database boundary, model boundary, failure paths and remaining limitations.
تيسير المختبرLab facilitation
- تدرّب على شرح موجز للرحلة وحد القاعدة وحد النموذج ومسارات الفشل والقيود المتبقية.Rehearse a short explanation of the journey, database boundary, model boundary, failure paths and remaining limitations.
- اعرض نسختك المرشحة فردياً وأكمل release-checklist.md وجهّز الأدلة بمسارات نسبية. يراجع المدرّب الدليل والملكية وتبقى مواد التقييم السرية منفصلة.Independently demonstrate your release candidate, complete release-checklist.md and package project-relative evidence. The trainer reviews evidence and ownership, while confidential assessment materials remain separate.
- سجّل المتوقع والفعلي والنسخة وأي شرط معلق. أصلح أول فحص فاشل وأعده.Record expected and actual results, the revision and any pending requirement. Repair the first failed check and rerun it.
الأدلة المتوقعةExpected evidence
- نسخة فردية موسومة وقائمة إصدار كاملة وتتبع العرض ودليل معلق موثق.Tagged individual revision, complete release checklist, demonstration trace and documented pending evidence.
w11d5-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
ادمج API قاعدة البيانات وميزة AI المحدودة في نسخة فردية مرشحة للإصدار مع اختبارات وتوثيق.Combine the database API and bounded AI feature into an individual release candidate with tests and documentation.
- يشغّل المستودع الفردي مسار CRUD بتخزين دائم وميزة AI واحدة محدودة ومتحققاً منها.The individual repository runs a persistent CRUD flow and one bounded, validated AI feature.
- تغطي الاختبارات الآلية النجاح الأساسي وسلوكيات فشل قاعدة البيانات وAI المطلوبة.Automated tests cover core success and required database and AI failure behaviours.
- يتبع زميل التوثيق من إعداد نظيف ويشرح سجل استخدام AI ملكية التغييرات.A peer follows the documentation from clean setup and the AI-use record explains ownership of changes.
الأخطاء الشائعةCommon errors
- يُقدَّم مستودع وهمي دليلاً على بقاء التخزين بعد إعادة التشغيل.A fake repository is presented as proof of persistence after restart.
- يمرر التكامل نصاً مخزناً عشوائياً أو بيانات وصفية للنموذج.Integration forwards arbitrary stored text or database metadata to the model.
- يعمل README بملفات محلية غير موثقة فقط أو يشير الدليل إلى نسخة أخرى.The README works only with undocumented local files, or evidence refers to another revision.
تدخلات المدرّبTrainer interventions
- نفّذ جلسات تقليص النطاق عندما تكون أدلة التكامل معرضة للخطر وسجّل الميزات المؤجلة.Hold scope cuts when integration evidence is at risk and record deferred features.
- راجع الأدلة عبر الأسئلة والتتبع مع الحفاظ على الملكية الفردية للكود.Review evidence through questions and traces while preserving individual ownership of code.
الاستدراكRecovery
إذا فشلت أدلة الإصدار، احذف الميزات المؤجلة واستعد آخر مسار أساسي ناجح وأصلح أول خطوة إعداد نظيف فاشلة ثم أعد إنشاء أدلة الاختبارات والتوثيق نفسها.If the release evidence fails, cut deferred features, restore the last passing core flow, repair the first failed clean-setup step, and regenerate the same tests and documentation evidence.
البديل عند الانقطاع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
يجب أن يستخدم المشروع بيانات اصطناعية أو عامة بوضوح؛ ولا يجوز أن يحتوي تاريخ المستودع أو العينات أو السجلات أو العروض على سجلات شخصية أو محتوى خاص أو بيانات دخول.The capstone must use synthetic or clearly public data; repository history, fixtures, logs and demos must contain no personal records, private content or credentials.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي المساعدة فقط في تغييرات معلنة ومراجعة؛ ويملك المتعلّم النطاق ويستطيع شرح كل تغيير مقدم ويتحقق منه بالاختبارات ومراجعة الفروقات.AI may assist only with disclosed, reviewed changes; the learner owns the scope, can explain every submitted change, and verifies it with tests and diff review.
نص التسجيلRecording script
السردNarration
- قدّم نسخة محددة ووسم نسخة مرشحة بعد توافق النطاق والاختبارات والإعداد النظيف. اعرض تخزين CRUD ومسار التحليل المحدود ثم سجلاً مفقوداً وفشل نموذج. اشرح كل حد وتغييراً نفذته باستقلال. اربط كل ادعاء باختبار أو تتبع ملحوظ. سجّل الدليل الناقص صراحة بما فيه أي شرط فعلي منفصل للأسبوع التاسع؛ لا تثبت اختبارات AI الوهمية اتصالاً حقيقياً. سيقيّم الأسبوع الثاني عشر قابلية الإعادة والمناقشة والتصحيح المستقل.Submit a named commit and release-candidate tag after scope, tests and clean setup agree. Demonstrate CRUD persistence and the bounded analysis path, then show a missing record and a model failure. Explain each boundary and one change you made independently. Link every claim to a test or observed trace. Record incomplete evidence explicitly, including any separate Week 9 live requirement; passing mocked AI tests does not prove a real call. Week 12 will assess reproducibility, defence and independent debugging.
- يتضمن التسليم النسخة الدقيقة والنطاق المقبول ومخرجات الاختبار وسجل إعداد الزميل والقيود الصادقة. لقطة بلا نسختها ليست دليلاً كافياً للإصدار.The handoff contains the exact revision, accepted scope, test output, peer setup record and honest limitations. A screenshot without its revision is insufficient release evidence.
إجراءات الشاشةScreen actions
- اعرض القالب العام المناسب والتتبع الاصطناعي ونتائج الاختبار المحجوبة. أشر إلى النسخة وأول فشل قابل للملاحظة.Show the relevant public template, synthetic trace and redacted test results. Point to the revision and the first observable failure.
النصوص الظاهرةCaptions
- اكتب معنى release candidate بالعربية ثم الإنجليزية.Caption release candidate in Arabic, then English.
نقاط التوقفPause points
- تدرّب على شرح موجز للرحلة وحد القاعدة وحد النموذج ومسارات الفشل والقيود المتبقية.Rehearse a short explanation of the journey, database boundary, model boundary, failure paths and remaining limitations.
قائمة التحقق من التسجيلRecording checklist
- تحقق من وضوح الترجمة العربية والبيانات الاصطناعية والنسخة الدقيقة وحالة الاختبار الصادقة وغياب محتوى التقييم السري.Confirm readable Arabic captions, synthetic data, exact revision, honest test status and no confidential assessment content.