مساحة المتعلّمLearner hub

الحزمة التعليمية الكاملةComplete learner course pack

الأسبوع الرابع — Git والاختبار والمراجعةWeek 4 — Day 1 — repository baseline, branch, and diff

مواد تعلّم مفتوحة للدراسة المستقلة. يبقى التقدم غير الرسمي في هذا المتصفح فقط، وقد يُمحى عند مسح بيانات تخزين المتصفح. لا يُنشأ هنا حساب أو سجل حضور أو درجة أو نتيجة مساق رسمية.Open learning materials for independent study. Unofficial progress stays only in this browser and can be erased if browser storage is cleared. No account, attendance record, score, or official course result is created here.

تنزيلات المساقCourse downloads

إصدار الحلSolution release

يتوفر بعد التحقق ونافذة الاستدراك والإصدار المعتمد من المدرّبAvailable after the checkpoint, recovery window, and trainer-approved release

اليوم 1Day 1

اليوم 1 — خط أساس المستودع والفرع والفروقاتDay 1 — repository baseline, branch, and diff

ملخص الشرائحSlide summary

الأهدافObjectives

  • أنشئ مستودعاً اصطناعياً نظيفاً وأودع خط الأساس العامل واعزل فرعاً مركزاً واشرح كل سطر متغير في الفروقات.Create a clean synthetic repository, commit the working baseline, isolate a focused branch, and explain every changed line in the diff.
  • اربط التغيير والاختبار المركز والفروقات المراجعة وملاحظة استخدام الذكاء الاصطناعي دون كشف بيانات دخول أو بيانات مستودع شخصية.Connect the change, focused test, reviewed diff, and AI-use note without exposing credentials or personal repository data.

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

  • اجتز تحقق الأسبوع الثالث لأداة ملفات JSON أو استخدم مسار الدعم المرتب.Pass the Week 3 JSON file-tool checkpoint or use the arranged supported path.
  • افتح حزمة بداية الأسبوع الرابع كما هي واستخدم منصة الكود المعتمدة أو مستودعاً محلياً يقدمه المدرّب.Open the exact Week 4 starter and use the approved code host or a trainer-provided local repository.

الشروحاتExplanations

خط الأساس ← الفرع ← التغيير ← الفروقاتBaseline → branch → change → diff

أنشئ مستودعاً اصطناعياً نظيفاً وأودع خط الأساس العامل واعزل فرعاً مركزاً واشرح كل سطر متغير في الفروقات.Create a clean synthetic repository, commit the working baseline, isolate a focused branch, and explain every changed line in the diff.

يمكن تتبع التغيير المفيد من خط الأساس إلى الفرع والفروقات ونتيجة الاختبار والرد على المراجعة والإيداع النهائي. وكل عنصر دليل للعنصر التالي.A useful change is traceable from baseline to branch, diff, test result, review response, and final commit. Each item is evidence for the next.

أمثلةExamples
main: اختبار خط الأساس ناجح | test/catalogue-review-cases: تغيير اختبار مركز واحد | الفروقات: الأسطر المقصودة فقطmain: baseline test passes | test/catalogue-review-cases: one focused test change | diff: only intended lines

الشرائحSlides

نتيجة اليوم القابلة للملاحظةToday's observable result

  • أنشئ مستودعاً اصطناعياً نظيفاً وأودع خط الأساس العامل واعزل فرعاً مركزاً واشرح كل سطر متغير في الفروقات.Create a clean synthetic repository, commit the working baseline, isolate a focused branch, and explain every changed line in the diff.

اطلب من متعلم تسمية التغيير والدليل الدقيق قبل فتح الطرفية.Ask a learner to name the change and the exact evidence before opening the terminal.

تتبع كل حالة للمستودعTrace every repository state

  • main: اختبار خط الأساس ناجح | test/catalogue-review-cases: تغيير اختبار مركز واحد | الفروقات: الأسطر المقصودة فقطmain: baseline test passes | test/catalogue-review-cases: one focused test change | diff: only intended lines

أخفِ الحالة النهائية واجمع التوقعات ثم اكشف انتقالاً واحداً في المستودع كل مرة.Hide the final state, collect predictions, then reveal one repository transition at a time.

مستودعات آمنة وذكاء اصطناعي خاضع للمساءلةSafe repositories and accountable AI

  • افحص الحالة والملفات المجهزة وتغييرات الاعتماديات والفروقات الكاملة قبل الرفع. وسجّل ما اقترحه الذكاء الاصطناعي وكيف تحققت منه الاختبارات.Inspect status, staged files, dependency changes, and the complete diff before pushing. Record what AI suggested and how tests verified it.

نفّذ قائمة تحقق الخصوصية وبيانات الدخول قبل المختبر.Run the privacy and credential checklist before the lab.

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

  • توقع الحالة بعد التهيئة وإيداع خط الأساس وإنشاء الفرع والتعديل والتجهيز والإيداع، ثم طابق كل توقع مع المخرج المرئي.Predict status after initialization, baseline commit, branch creation, edit, staging, and commit; then match each prediction to the visible output.

ورقة العملWorksheet

  1. أكمل جدولاً من ست حالات للمستودع يتضمن الأمر والفرع والملفات المتغيرة وحالة التجهيز والمخرج المتوقع ومسار الدليل.Complete a six-state repository table with command, branch, changed files, staging state, expected output, and evidence path.مرجع الدليل: w4d1-repository-diff-evidenceEvidence reference: w4d1-repository-diff-evidence

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

  1. اكتب حالة المستودع والدليل المقصودين قبل تشغيل أي أمر.Write the intended repository state and evidence before running a command.
  2. أنشئ المستودع وإيداع خط الأساس والفرع المسمى، وأجر تغييراً واحداً في ملف الاختبار، وافحص الفروقات غير المجهزة والمجهزة واشرح كل جزء.Create the repository and baseline commit, create the named feature branch, make one test-file change, inspect unstaged and staged diffs, and annotate each hunk.
  3. شغّل الاختبارات المركزة وافحص الحالة والفروقات غير المجهزة والمجهزة وفروقات الاعتماديات بالترتيب المنشور.Run the focused tests and inspect status, unstaged diff, staged diff, and dependency diff in the published order.
  4. احفظ نص أوامر محجوباً وفروقات مشروحة ونتيجة اختبار ورد مراجعة وملاحظة عن استخدام الذكاء الاصطناعي أو عدم استخدامه.Save a redacted command transcript, annotated diff, test result, review response, and AI-use or non-use note.

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

الإدخال المقدمSupplied inputالنوع المتوقعExpected kind
classify_book_id("BK-101") -> "valid"accepted
classify_book_id(" ") -> "missing"correction
classify_book_id(101) -> "invalid-type"rejected
3 focused cases passed; diff checked; no credentials stagedsummary

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

  • مكان يحفظ الكود وتاريخهrepository
  • مسار عمل معزولbranch
  • لقطة مسماة من التغييراتcommit
  • عرض للأسطر المتغيرةdiff

الخصوصيةPrivacy

استخدم المستودع الاصطناعي المقدم فقط. لا تودع بيانات دخول أو رموز وصول أو هويات متعلمين أو مسارات منزلية أو روابط خاصة أو سجلات حقيقية.Use only the supplied synthetic repository. Never commit credentials, tokens, learner identities, home paths, private URLs, or real records.

ممارسة الذكاء الاصطناعيAI practice

يمكن للذكاء الاصطناعي اقتراح اختبار أو شرح للمراجعة بعد حجب تفاصيل المستودع فقط. وعلى المتعلم فحص الفروقات وتعديل الاقتراح وتشغيل الاختبارات والإفصاح عن النتيجة.AI may suggest a test or review explanation only after repository details are redacted. The learner must inspect the diff, adapt the suggestion, run the tests, and disclose the result.

الاستدراكRecovery

خلال أسبوع واحد، أعد إنشاء تغيير w4d1 من خط الأساس وشغّل الاختبار المركز الموثق وراجع الفروقات الكاملة ثم أعد تقديم خط الأساس والفرع ونص الحالة والفروقات المشروحة.Within one week, recreate the w4d1 change from the baseline, run the documented focused test, review the complete diff, and resubmit the baseline, branch, status transcript, and annotated diff.

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

  • يُودع العمل مباشرة في main فلا يمكن مراجعة التغيير كفرع معزول.Work is committed directly to main, so the change cannot be reviewed as an isolated branch.
  • يغطي الاختبار الناجح الحالة العادية فقط ويفوّت الحد المنشور.A passing test covers only the normal case and misses the published boundary.
  • يعلن طلب السحب النجاح دون أمر الاختبار أو مراجعة الفروقات أو المخاطر أو دليل استخدام الذكاء الاصطناعي.The pull request reports success without the command, diff review, risk, or AI-use evidence.
دليلي التعلّمي المُبلّغ عنه ذاتياًMy self-reported learning evidence

يُحفظ في هذا المتصفح فقط لدعم تعلّمك الشخصي. ليس حضوراً ولا درجة ولا نتيجة تحقق ولا سجلاً لشهادة.Saved only in this browser to support your own learning. It is not attendance, a score, a checkpoint result, or a certificate record.

جارٍ تحميل ملاحظاتك التعليمية المحلية…Loading your local learning notes…

اليوم 2Day 2

اليوم 2 — اختبارات الدالة المركزةDay 2 — focused function tests

ملخص الشرائحSlide summary

الأهدافObjectives

  • أضف اختبارات مركزة للمعرّف العادي والنوع غير الصالح وحد السلسلة الفارغة ثم أثبت نجاحها باستخدام الأمر الموثق.Add focused tests for the normal identifier, invalid type, and blank-string boundary, then prove they pass from the documented command.
  • اربط التغيير والاختبار المركز والفروقات المراجعة وملاحظة استخدام الذكاء الاصطناعي دون كشف بيانات دخول أو بيانات مستودع شخصية.Connect the change, focused test, reviewed diff, and AI-use note without exposing credentials or personal repository data.

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

  • اجتز تحقق الأسبوع الثالث لأداة ملفات JSON أو استخدم مسار الدعم المرتب.Pass the Week 3 JSON file-tool checkpoint or use the arranged supported path.
  • افتح حزمة بداية الأسبوع الرابع كما هي واستخدم منصة الكود المعتمدة أو مستودعاً محلياً يقدمه المدرّب.Open the exact Week 4 starter and use the approved code host or a trainer-provided local repository.

الشروحاتExplanations

سلوك واحد وسبب واحد لكل اختبارOne behaviour and one reason per test

أضف اختبارات مركزة للمعرّف العادي والنوع غير الصالح وحد السلسلة الفارغة ثم أثبت نجاحها باستخدام الأمر الموثق.Add focused tests for the normal identifier, invalid type, and blank-string boundary, then prove they pass from the documented command.

يمكن تتبع التغيير المفيد من خط الأساس إلى الفرع والفروقات ونتيجة الاختبار والرد على المراجعة والإيداع النهائي. وكل عنصر دليل للعنصر التالي.A useful change is traceable from baseline to branch, diff, test result, review response, and final commit. Each item is evidence for the next.

أمثلةExamples
"BK-101" ← valid | 101 ← invalid-type | "   " ← missing"BK-101" → valid | 101 → invalid-type | "   " → missing

الشرائحSlides

نتيجة اليوم القابلة للملاحظةToday's observable result

  • أضف اختبارات مركزة للمعرّف العادي والنوع غير الصالح وحد السلسلة الفارغة ثم أثبت نجاحها باستخدام الأمر الموثق.Add focused tests for the normal identifier, invalid type, and blank-string boundary, then prove they pass from the documented command.

اطلب من متعلم تسمية التغيير والدليل الدقيق قبل فتح الطرفية.Ask a learner to name the change and the exact evidence before opening the terminal.

تسمية السلوك والحدودName behaviour and boundaries

  • "BK-101" ← valid | 101 ← invalid-type | " " ← missing"BK-101" → valid | 101 → invalid-type | " " → missing

أخفِ الحالة النهائية واجمع التوقعات ثم اكشف انتقالاً واحداً في المستودع كل مرة.Hide the final state, collect predictions, then reveal one repository transition at a time.

مستودعات آمنة وذكاء اصطناعي خاضع للمساءلةSafe repositories and accountable AI

  • افحص الحالة والملفات المجهزة وتغييرات الاعتماديات والفروقات الكاملة قبل الرفع. وسجّل ما اقترحه الذكاء الاصطناعي وكيف تحققت منه الاختبارات.Inspect status, staged files, dependency changes, and the complete diff before pushing. Record what AI suggested and how tests verified it.

نفّذ قائمة تحقق الخصوصية وبيانات الدخول قبل المختبر.Run the privacy and credential checklist before the lab.

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

  • حوّل الحالات الثلاث المنشورة إلى أسماء اختبارات ومدخلات ومخرجات متوقعة ورسائل فشل قبل كتابة التأكيدات.Turn the three published cases into test names, inputs, expected outputs, and failure messages before writing assertions.

ورقة العملWorksheet

  1. قدّم جدول الاختبارات للحالات الثلاث والأمر الدقيق والمخرج الناجح وتفسير الفشل والفروقات الخاصة بالاختبارات فقط.Submit the three-case test table, the exact command, passing output, failure interpretation, and the test-only diff.مرجع الدليل: w4d2-focused-tests-evidenceEvidence reference: w4d2-focused-tests-evidence

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

  1. اكتب حالة المستودع والدليل المقصودين قبل تشغيل أي أمر.Write the intended repository state and evidence before running a command.
  2. أضف اختباري النوع غير الصالح والحد الفارغ في فرع الميزة، وشغّل الأمر المركز الدقيق، وتحقق من أن الفروقات تغير الاختبارات لا الدالة المقدمة.Add the invalid-type and blank-boundary tests on the feature branch, run the exact focused command, and review that the diff changes tests rather than the supplied function.
  3. شغّل الاختبارات المركزة وافحص الحالة والفروقات غير المجهزة والمجهزة وفروقات الاعتماديات بالترتيب المنشور.Run the focused tests and inspect status, unstaged diff, staged diff, and dependency diff in the published order.
  4. احفظ نص أوامر محجوباً وفروقات مشروحة ونتيجة اختبار ورد مراجعة وملاحظة عن استخدام الذكاء الاصطناعي أو عدم استخدامه.Save a redacted command transcript, annotated diff, test result, review response, and AI-use or non-use note.

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

الإدخال المقدمSupplied inputالنوع المتوقعExpected kind
classify_book_id("BK-101") -> "valid"accepted
classify_book_id(" ") -> "missing"correction
classify_book_id(101) -> "invalid-type"rejected
3 focused cases passed; diff checked; no credentials stagedsummary

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

  • فحص آلي لسلوك متوقعtest
  • شرط يثبت النتيجة المتوقعةassertion
  • قيمة عند حافة القاعدةboundary
  • نتيجة تخالف التوقعfailure

الخصوصيةPrivacy

استخدم المستودع الاصطناعي المقدم فقط. لا تودع بيانات دخول أو رموز وصول أو هويات متعلمين أو مسارات منزلية أو روابط خاصة أو سجلات حقيقية.Use only the supplied synthetic repository. Never commit credentials, tokens, learner identities, home paths, private URLs, or real records.

ممارسة الذكاء الاصطناعيAI practice

يمكن للذكاء الاصطناعي اقتراح اختبار أو شرح للمراجعة بعد حجب تفاصيل المستودع فقط. وعلى المتعلم فحص الفروقات وتعديل الاقتراح وتشغيل الاختبارات والإفصاح عن النتيجة.AI may suggest a test or review explanation only after repository details are redacted. The learner must inspect the diff, adapt the suggestion, run the tests, and disclose the result.

الاستدراكRecovery

خلال أسبوع واحد، أعد إنشاء تغيير w4d2 من خط الأساس وشغّل الاختبار المركز الموثق وراجع الفروقات الكاملة ثم أعد تقديم جدول الحالات الثلاث ومخرج الأمر الناجح والفروقات الخاصة بالاختبارات.Within one week, recreate the w4d2 change from the baseline, run the documented focused test, review the complete diff, and resubmit the three-case test table, passing command output, and test-only diff.

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

  • يُودع العمل مباشرة في main فلا يمكن مراجعة التغيير كفرع معزول.Work is committed directly to main, so the change cannot be reviewed as an isolated branch.
  • يغطي الاختبار الناجح الحالة العادية فقط ويفوّت الحد المنشور.A passing test covers only the normal case and misses the published boundary.
  • يعلن طلب السحب النجاح دون أمر الاختبار أو مراجعة الفروقات أو المخاطر أو دليل استخدام الذكاء الاصطناعي.The pull request reports success without the command, diff review, risk, or AI-use evidence.
دليلي التعلّمي المُبلّغ عنه ذاتياًMy self-reported learning evidence

يُحفظ في هذا المتصفح فقط لدعم تعلّمك الشخصي. ليس حضوراً ولا درجة ولا نتيجة تحقق ولا سجلاً لشهادة.Saved only in this browser to support your own learning. It is not attendance, a score, a checkpoint result, or a certificate record.

جارٍ تحميل ملاحظاتك التعليمية المحلية…Loading your local learning notes…

اليوم 3Day 3

اليوم 3 — الاعتماديات والبيئات النظيفةDay 3 — dependencies and clean environments

ملخص الشرائحSlide summary

الأهدافObjectives

  • أعد إنشاء بيئة الاختبار من سجل الاعتمادية الدقيق وافحص أي فروقات اعتماديات وأعد تشغيل الاختبارات المركزة.Recreate the test environment from the exact dependency record, inspect any dependency diff, and rerun the focused tests.
  • اربط التغيير والاختبار المركز والفروقات المراجعة وملاحظة استخدام الذكاء الاصطناعي دون كشف بيانات دخول أو بيانات مستودع شخصية.Connect the change, focused test, reviewed diff, and AI-use note without exposing credentials or personal repository data.

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

  • اجتز تحقق الأسبوع الثالث لأداة ملفات JSON أو استخدم مسار الدعم المرتب.Pass the Week 3 JSON file-tool checkpoint or use the arranged supported path.
  • افتح حزمة بداية الأسبوع الرابع كما هي واستخدم منصة الكود المعتمدة أو مستودعاً محلياً يقدمه المدرّب.Open the exact Week 4 starter and use the approved code host or a trainer-provided local repository.

الشروحاتExplanations

سجّل الاعتماديات لا البيئات المثبتةRecord dependencies, not installed environments

أعد إنشاء بيئة الاختبار من سجل الاعتمادية الدقيق وافحص أي فروقات اعتماديات وأعد تشغيل الاختبارات المركزة.Recreate the test environment from the exact dependency record, inspect any dependency diff, and rerun the focused tests.

يمكن تتبع التغيير المفيد من خط الأساس إلى الفرع والفروقات ونتيجة الاختبار والرد على المراجعة والإيداع النهائي. وكل عنصر دليل للعنصر التالي.A useful change is traceable from baseline to branch, diff, test result, review response, and final commit. Each item is evidence for the next.

أمثلةExamples
requirements-dev.txt: pytest==8.4.1 | بيئة .venv النظيفة متجاهلة | نجاح 3 حالات مركزةrequirements-dev.txt: pytest==8.4.1 | clean .venv ignored | 3 focused cases pass

الشرائحSlides

نتيجة اليوم القابلة للملاحظةToday's observable result

  • أعد إنشاء بيئة الاختبار من سجل الاعتمادية الدقيق وافحص أي فروقات اعتماديات وأعد تشغيل الاختبارات المركزة.Recreate the test environment from the exact dependency record, inspect any dependency diff, and rerun the focused tests.

اطلب من متعلم تسمية التغيير والدليل الدقيق قبل فتح الطرفية.Ask a learner to name the change and the exact evidence before opening the terminal.

إعادة الإنتاج قبل المراجعةReproduce before reviewing

  • requirements-dev.txt: pytest==8.4.1 | بيئة .venv النظيفة متجاهلة | نجاح 3 حالات مركزةrequirements-dev.txt: pytest==8.4.1 | clean .venv ignored | 3 focused cases pass

أخفِ الحالة النهائية واجمع التوقعات ثم اكشف انتقالاً واحداً في المستودع كل مرة.Hide the final state, collect predictions, then reveal one repository transition at a time.

مستودعات آمنة وذكاء اصطناعي خاضع للمساءلةSafe repositories and accountable AI

  • افحص الحالة والملفات المجهزة وتغييرات الاعتماديات والفروقات الكاملة قبل الرفع. وسجّل ما اقترحه الذكاء الاصطناعي وكيف تحققت منه الاختبارات.Inspect status, staged files, dependency changes, and the complete diff before pushing. Record what AI suggested and how tests verified it.

نفّذ قائمة تحقق الخصوصية وبيانات الدخول قبل المختبر.Run the privacy and credential checklist before the lab.

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

  • صنّف ملف الاعتمادية والبيئة المثبتة والذاكرة المؤقتة ومخرج الاختبار كملف متتبع أو متجاهل أو دليل فقط قبل فحص الحالة.Classify the dependency file, installed environment, cache, and test output as tracked, ignored, or evidence-only before checking status.

ورقة العملWorksheet

  1. أكمل سجل إعادة الإنتاج بإصدار Python والاعتمادية وإصدارها وأوامر الإعداد النظيف والمسارات المتجاهلة وقرار فروقات الاعتمادية ونتيجة الاختبار.Complete the reproducibility record with Python version, dependency and version, clean setup commands, ignored paths, dependency-diff decision, and test result.مرجع الدليل: w4d3-dependency-environment-evidenceEvidence reference: w4d3-dependency-environment-evidence

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

  1. اكتب حالة المستودع والدليل المقصودين قبل تشغيل أي أمر.Write the intended repository state and evidence before running a command.
  2. أنشئ بيئة نظيفة وثبّت من requirements-dev.txt فقط وتأكد من بقاء الملفات المتجاهلة خارج التجهيز وراجع فروقات الاعتمادية وأعد تشغيل كل الاختبارات المركزة.Create a clean environment, install only from requirements-dev.txt, confirm ignored files stay unstaged, review the dependency diff, and rerun all focused tests.
  3. شغّل الاختبارات المركزة وافحص الحالة والفروقات غير المجهزة والمجهزة وفروقات الاعتماديات بالترتيب المنشور.Run the focused tests and inspect status, unstaged diff, staged diff, and dependency diff in the published order.
  4. احفظ نص أوامر محجوباً وفروقات مشروحة ونتيجة اختبار ورد مراجعة وملاحظة عن استخدام الذكاء الاصطناعي أو عدم استخدامه.Save a redacted command transcript, annotated diff, test result, review response, and AI-use or non-use note.

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

الإدخال المقدمSupplied inputالنوع المتوقعExpected kind
classify_book_id("BK-101") -> "valid"accepted
classify_book_id(" ") -> "missing"correction
classify_book_id(101) -> "invalid-type"rejected
3 focused cases passed; diff checked; no credentials stagedsummary

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

  • حزمة يعتمد عليها المشروعdependency
  • مساحة معزولة لتثبيت الحزمenvironment
  • إصدار محدد من الحزمةversion
  • استبعاد ملف من تتبع Gitignore

الخصوصيةPrivacy

استخدم المستودع الاصطناعي المقدم فقط. لا تودع بيانات دخول أو رموز وصول أو هويات متعلمين أو مسارات منزلية أو روابط خاصة أو سجلات حقيقية.Use only the supplied synthetic repository. Never commit credentials, tokens, learner identities, home paths, private URLs, or real records.

ممارسة الذكاء الاصطناعيAI practice

يمكن للذكاء الاصطناعي اقتراح اختبار أو شرح للمراجعة بعد حجب تفاصيل المستودع فقط. وعلى المتعلم فحص الفروقات وتعديل الاقتراح وتشغيل الاختبارات والإفصاح عن النتيجة.AI may suggest a test or review explanation only after repository details are redacted. The learner must inspect the diff, adapt the suggestion, run the tests, and disclose the result.

الاستدراكRecovery

خلال أسبوع واحد، أعد إنشاء تغيير w4d3 من خط الأساس وشغّل الاختبار المركز الموثق وراجع الفروقات الكاملة ثم أعد تقديم سجل الاعتمادية الدقيق ونص الإعداد النظيف والفروقات المراجعة والاختبارات الناجحة.Within one week, recreate the w4d3 change from the baseline, run the documented focused test, review the complete diff, and resubmit the exact dependency record, clean setup transcript, reviewed diff, and passing tests.

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

  • يُودع العمل مباشرة في main فلا يمكن مراجعة التغيير كفرع معزول.Work is committed directly to main, so the change cannot be reviewed as an isolated branch.
  • يغطي الاختبار الناجح الحالة العادية فقط ويفوّت الحد المنشور.A passing test covers only the normal case and misses the published boundary.
  • يعلن طلب السحب النجاح دون أمر الاختبار أو مراجعة الفروقات أو المخاطر أو دليل استخدام الذكاء الاصطناعي.The pull request reports success without the command, diff review, risk, or AI-use evidence.
دليلي التعلّمي المُبلّغ عنه ذاتياًMy self-reported learning evidence

يُحفظ في هذا المتصفح فقط لدعم تعلّمك الشخصي. ليس حضوراً ولا درجة ولا نتيجة تحقق ولا سجلاً لشهادة.Saved only in this browser to support your own learning. It is not attendance, a score, a checkpoint result, or a certificate record.

جارٍ تحميل ملاحظاتك التعليمية المحلية…Loading your local learning notes…

اليوم 4Day 4

اليوم 4 — مراجعة طلب السحب والإفصاح عن الذكاء الاصطناعيDay 4 — pull-request review and AI disclosure

ملخص الشرائحSlide summary

الأهدافObjectives

  • اكتب وصفاً كاملاً لطلب السحب وراجع كل جزء من الفروقات وعالج تعليقاً واحداً مستنداً إلى دليل وأفصح عن مساعدة الذكاء الاصطناعي الدقيقة أو عدم استخدامها.Write a complete pull-request description, review every diff hunk, address one evidence-based comment, and disclose exact AI assistance or non-use.
  • اربط التغيير والاختبار المركز والفروقات المراجعة وملاحظة استخدام الذكاء الاصطناعي دون كشف بيانات دخول أو بيانات مستودع شخصية.Connect the change, focused test, reviewed diff, and AI-use note without exposing credentials or personal repository data.

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

  • اجتز تحقق الأسبوع الثالث لأداة ملفات JSON أو استخدم مسار الدعم المرتب.Pass the Week 3 JSON file-tool checkpoint or use the arranged supported path.
  • افتح حزمة بداية الأسبوع الرابع كما هي واستخدم منصة الكود المعتمدة أو مستودعاً محلياً يقدمه المدرّب.Open the exact Week 4 starter and use the approved code host or a trainer-provided local repository.

الشروحاتExplanations

طلب السحب حجة مبنية على الأدلةA pull request is an evidence argument

اكتب وصفاً كاملاً لطلب السحب وراجع كل جزء من الفروقات وعالج تعليقاً واحداً مستنداً إلى دليل وأفصح عن مساعدة الذكاء الاصطناعي الدقيقة أو عدم استخدامها.Write a complete pull-request description, review every diff hunk, address one evidence-based comment, and disclose exact AI assistance or non-use.

يمكن تتبع التغيير المفيد من خط الأساس إلى الفرع والفروقات ونتيجة الاختبار والرد على المراجعة والإيداع النهائي. وكل عنصر دليل للعنصر التالي.A useful change is traceable from baseline to branch, diff, test result, review response, and final commit. Each item is evidence for the next.

أمثلةExamples
السبب ← الاختبارات المتغيرة ← الأمر الدقيق ← النتيجة ← الخطر ← الرد على المراجعة ← التحقق من الذكاء الاصطناعيwhy → changed tests → exact command → result → risk → review response → AI verification

الشرائحSlides

نتيجة اليوم القابلة للملاحظةToday's observable result

  • اكتب وصفاً كاملاً لطلب السحب وراجع كل جزء من الفروقات وعالج تعليقاً واحداً مستنداً إلى دليل وأفصح عن مساعدة الذكاء الاصطناعي الدقيقة أو عدم استخدامها.Write a complete pull-request description, review every diff hunk, address one evidence-based comment, and disclose exact AI assistance or non-use.

اطلب من متعلم تسمية التغيير والدليل الدقيق قبل فتح الطرفية.Ask a learner to name the change and the exact evidence before opening the terminal.

ربط السبب والفروقات والاختبار والمراجعةConnect reason, diff, test, and review

  • السبب ← الاختبارات المتغيرة ← الأمر الدقيق ← النتيجة ← الخطر ← الرد على المراجعة ← التحقق من الذكاء الاصطناعيwhy → changed tests → exact command → result → risk → review response → AI verification

أخفِ الحالة النهائية واجمع التوقعات ثم اكشف انتقالاً واحداً في المستودع كل مرة.Hide the final state, collect predictions, then reveal one repository transition at a time.

مستودعات آمنة وذكاء اصطناعي خاضع للمساءلةSafe repositories and accountable AI

  • افحص الحالة والملفات المجهزة وتغييرات الاعتماديات والفروقات الكاملة قبل الرفع. وسجّل ما اقترحه الذكاء الاصطناعي وكيف تحققت منه الاختبارات.Inspect status, staged files, dependency changes, and the complete diff before pushing. Record what AI suggested and how tests verified it.

نفّذ قائمة تحقق الخصوصية وبيانات الدخول قبل المختبر.Run the privacy and credential checklist before the lab.

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

  • راجع فروقات نموذجية مقدمة واكتب تعليقاً واحداً يسمي السطر والخطر والدليل المطلوب وشرط القبول.Review a supplied sample diff and write one comment that names the line, risk, requested evidence, and acceptance condition.

ورقة العملWorksheet

  1. قدّم خريطة أدلة طلب السحب: السبب والملف وجزء الفروقات وأمر الاختبار ونتيجته والخطر وتعليق المراجعة والرد واقتراح الذكاء الاصطناعي وتعديله والتحقق منه أو بيان عدم الاستخدام.Submit the PR evidence map: reason, file and hunk, test command and result, risk, review comment and response, and AI suggestion/change/verification or no-use statement.مرجع الدليل: w4d4-pr-review-ai-evidenceEvidence reference: w4d4-pr-review-ai-evidence

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

  1. اكتب حالة المستودع والدليل المقصودين قبل تشغيل أي أمر.Write the intended repository state and evidence before running a command.
  2. أكمل قالب طلب السحب وراجع الفروقات الكاملة وسجل الاعتمادية ورد على تعليق واحد بتغيير أو دليل وأعد تشغيل الاختبارات وسجّل استخدام الذكاء الاصطناعي أو عدم استخدامه.Complete the pull-request template, review the full diff and dependency record, respond to one comment with a change or evidence, rerun tests, and record AI use or non-use.
  3. شغّل الاختبارات المركزة وافحص الحالة والفروقات غير المجهزة والمجهزة وفروقات الاعتماديات بالترتيب المنشور.Run the focused tests and inspect status, unstaged diff, staged diff, and dependency diff in the published order.
  4. احفظ نص أوامر محجوباً وفروقات مشروحة ونتيجة اختبار ورد مراجعة وملاحظة عن استخدام الذكاء الاصطناعي أو عدم استخدامه.Save a redacted command transcript, annotated diff, test result, review response, and AI-use or non-use note.

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

الإدخال المقدمSupplied inputالنوع المتوقعExpected kind
classify_book_id("BK-101") -> "valid"accepted
classify_book_id(" ") -> "missing"correction
classify_book_id(101) -> "invalid-type"rejected
3 focused cases passed; diff checked; no credentials stagedsummary

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

  • طلب لمراجعة تغيير ودمجهpull request
  • فحص التغيير وتقديم ملاحظاتreview
  • احتمال أثر غير مقصودrisk
  • إفصاح واضح عما استُخدمdisclosure

الخصوصيةPrivacy

استخدم المستودع الاصطناعي المقدم فقط. لا تودع بيانات دخول أو رموز وصول أو هويات متعلمين أو مسارات منزلية أو روابط خاصة أو سجلات حقيقية.Use only the supplied synthetic repository. Never commit credentials, tokens, learner identities, home paths, private URLs, or real records.

ممارسة الذكاء الاصطناعيAI practice

يمكن للذكاء الاصطناعي اقتراح اختبار أو شرح للمراجعة بعد حجب تفاصيل المستودع فقط. وعلى المتعلم فحص الفروقات وتعديل الاقتراح وتشغيل الاختبارات والإفصاح عن النتيجة.AI may suggest a test or review explanation only after repository details are redacted. The learner must inspect the diff, adapt the suggestion, run the tests, and disclose the result.

الاستدراكRecovery

خلال أسبوع واحد، أعد إنشاء تغيير w4d4 من خط الأساس وشغّل الاختبار المركز الموثق وراجع الفروقات الكاملة ثم أعد تقديم وصف طلب السحب الكامل والفروقات المشروحة والرد على المراجعة والاختبار الناجح وسجل الذكاء الاصطناعي.Within one week, recreate the w4d4 change from the baseline, run the documented focused test, review the complete diff, and resubmit the complete pr description, annotated diff, review response, passing test, and ai record.

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

  • يُودع العمل مباشرة في main فلا يمكن مراجعة التغيير كفرع معزول.Work is committed directly to main, so the change cannot be reviewed as an isolated branch.
  • يغطي الاختبار الناجح الحالة العادية فقط ويفوّت الحد المنشور.A passing test covers only the normal case and misses the published boundary.
  • يعلن طلب السحب النجاح دون أمر الاختبار أو مراجعة الفروقات أو المخاطر أو دليل استخدام الذكاء الاصطناعي.The pull request reports success without the command, diff review, risk, or AI-use evidence.
دليلي التعلّمي المُبلّغ عنه ذاتياًMy self-reported learning evidence

يُحفظ في هذا المتصفح فقط لدعم تعلّمك الشخصي. ليس حضوراً ولا درجة ولا نتيجة تحقق ولا سجلاً لشهادة.Saved only in this browser to support your own learning. It is not attendance, a score, a checkpoint result, or a certificate record.

جارٍ تحميل ملاحظاتك التعليمية المحلية…Loading your local learning notes…

اليوم 5Day 5

اليوم 5 — التحقق الفردي للمستودع المختبرDay 5 — individual tested-repository checkpoint

ملخص الشرائحSlide summary

الأهدافObjectives

  • أنشئ خط الأساس والفرع وأضف الاختبارات المركزة وأعد إنتاج البيئة وراجع طلب السحب واشرح كل تغيير ومساهمة للذكاء الاصطناعي بصورة فردية.Individually create the baseline and branch, add focused tests, reproduce the environment, review the pull request, and explain every change and AI contribution.
  • اربط التغيير والاختبار المركز والفروقات المراجعة وملاحظة استخدام الذكاء الاصطناعي دون كشف بيانات دخول أو بيانات مستودع شخصية.Connect the change, focused test, reviewed diff, and AI-use note without exposing credentials or personal repository data.

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

  • اجتز تحقق الأسبوع الثالث لأداة ملفات JSON أو استخدم مسار الدعم المرتب.Pass the Week 3 JSON file-tool checkpoint or use the arranged supported path.
  • افتح حزمة بداية الأسبوع الرابع كما هي واستخدم منصة الكود المعتمدة أو مستودعاً محلياً يقدمه المدرّب.Open the exact Week 4 starter and use the approved code host or a trainer-provided local repository.

الشروحاتExplanations

يثبت دليل التحقق انتقال التعلم بصورة مستقلةCheckpoint evidence proves independent transfer

أنشئ خط الأساس والفرع وأضف الاختبارات المركزة وأعد إنتاج البيئة وراجع طلب السحب واشرح كل تغيير ومساهمة للذكاء الاصطناعي بصورة فردية.Individually create the baseline and branch, add focused tests, reproduce the environment, review the pull request, and explain every change and AI contribution.

يمكن تتبع التغيير المفيد من خط الأساس إلى الفرع والفروقات ونتيجة الاختبار والرد على المراجعة والإيداع النهائي. وكل عنصر دليل للعنصر التالي.A useful change is traceable from baseline to branch, diff, test result, review response, and final commit. Each item is evidence for the next.

أمثلةExamples
خط أساس نظيف ← فرع ميزة ← نجاح 3 حالات ← مراجعة فروقات الاعتمادية ← اكتمال أدلة طلب السحبbaseline clean → feature branch → 3 cases pass → dependency diff reviewed → PR evidence complete

الشرائحSlides

نتيجة اليوم القابلة للملاحظةToday's observable result

  • أنشئ خط الأساس والفرع وأضف الاختبارات المركزة وأعد إنتاج البيئة وراجع طلب السحب واشرح كل تغيير ومساهمة للذكاء الاصطناعي بصورة فردية.Individually create the baseline and branch, add focused tests, reproduce the environment, review the pull request, and explain every change and AI contribution.

اطلب من متعلم تسمية التغيير والدليل الدقيق قبل فتح الطرفية.Ask a learner to name the change and the exact evidence before opening the terminal.

البناء والاختبار والمراجعة والشرح بصورة فرديةBuild, test, review, and explain independently

  • خط أساس نظيف ← فرع ميزة ← نجاح 3 حالات ← مراجعة فروقات الاعتمادية ← اكتمال أدلة طلب السحبbaseline clean → feature branch → 3 cases pass → dependency diff reviewed → PR evidence complete

أخفِ الحالة النهائية واجمع التوقعات ثم اكشف انتقالاً واحداً في المستودع كل مرة.Hide the final state, collect predictions, then reveal one repository transition at a time.

مستودعات آمنة وذكاء اصطناعي خاضع للمساءلةSafe repositories and accountable AI

  • افحص الحالة والملفات المجهزة وتغييرات الاعتماديات والفروقات الكاملة قبل الرفع. وسجّل ما اقترحه الذكاء الاصطناعي وكيف تحققت منه الاختبارات.Inspect status, staged files, dependency changes, and the complete diff before pushing. Record what AI suggested and how tests verified it.

نفّذ قائمة تحقق الخصوصية وبيانات الدخول قبل المختبر.Run the privacy and credential checklist before the lab.

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

  • اقرأ المعيار وتوقع كل حالة للمستودع وجهّز جدول الاختبارات وخريطة أدلة طلب السحب وحدد الملفات المحظورة قبل البناء المحدد بالوقت.Read the rubric, predict every repository state, prepare the test table and PR evidence map, and identify prohibited files before the timed build.

ورقة العملWorksheet

  1. أكمل سجل التحقق الفردي: رسم الإيداعات والفرع والحالة والاختبارات الثلاثة والإعداد النظيف ومراجعة الفروقات ووصف طلب السحب والرد على المراجعة وفحص الخصوصية وإفصاح الذكاء الاصطناعي وقائمة الشرح المباشر.Complete the individual checkpoint record: commit graph, branch and status, three tests, clean setup, diff review, PR description, review response, privacy scan, AI disclosure, and live explanation checklist.مرجع الدليل: w4d5-checkpoint-evidenceEvidence reference: w4d5-checkpoint-evidence

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

  1. اكتب حالة المستودع والدليل المقصودين قبل تشغيل أي أمر.Write the intended repository state and evidence before running a command.
  2. من حزمة البداية دون تغيير، أنشئ المستودع وخط الأساس والفرع وأضف الاختبارين المركزين الناقصين وأعد إنتاج البيئة وأودع التغيير وجهّز طلب السحب وراجعه وعالج تعليقاً واحداً واشرح مساراً عادياً وحداً واحداً مباشرة.From the unchanged starter, create the repository and baseline, branch, add the two missing focused tests, reproduce the environment, commit, prepare and review the PR, address one comment, and explain one normal and one boundary path live.
  3. شغّل الاختبارات المركزة وافحص الحالة والفروقات غير المجهزة والمجهزة وفروقات الاعتماديات بالترتيب المنشور.Run the focused tests and inspect status, unstaged diff, staged diff, and dependency diff in the published order.
  4. احفظ نص أوامر محجوباً وفروقات مشروحة ونتيجة اختبار ورد مراجعة وملاحظة عن استخدام الذكاء الاصطناعي أو عدم استخدامه.Save a redacted command transcript, annotated diff, test result, review response, and AI-use or non-use note.

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

الإدخال المقدمSupplied inputالنوع المتوقعExpected kind
classify_book_id("BK-101") -> "valid"accepted
classify_book_id(" ") -> "missing"correction
classify_book_id(101) -> "invalid-type"rejected
3 focused cases passed; diff checked; no credentials stagedsummary

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

  • مكان يحفظ الكود وتاريخهrepository
  • مسار عمل معزولbranch
  • فحص آلي لسلوك متوقعtest
  • طلب لمراجعة التغييرpull request
  • عرض للأسطر المتغيرةdiff

الخصوصيةPrivacy

استخدم المستودع الاصطناعي المقدم فقط. لا تودع بيانات دخول أو رموز وصول أو هويات متعلمين أو مسارات منزلية أو روابط خاصة أو سجلات حقيقية.Use only the supplied synthetic repository. Never commit credentials, tokens, learner identities, home paths, private URLs, or real records.

ممارسة الذكاء الاصطناعيAI practice

يمكن للذكاء الاصطناعي اقتراح اختبار أو شرح للمراجعة بعد حجب تفاصيل المستودع فقط. وعلى المتعلم فحص الفروقات وتعديل الاقتراح وتشغيل الاختبارات والإفصاح عن النتيجة.AI may suggest a test or review explanation only after repository details are redacted. The learner must inspect the diff, adapt the suggestion, run the tests, and disclose the result.

الاستدراكRecovery

خلال أسبوع واحد، أعد إنشاء تغيير w4d5 من خط الأساس وشغّل الاختبار المركز الموثق وراجع الفروقات الكاملة ثم أعد تقديم السجل الفردي والفرع والاختبارات الثلاثة والإعداد النظيف وطلب السحب المراجع وملاحظة الذكاء الاصطناعي والشرح المباشر.Within one week, recreate the w4d5 change from the baseline, run the documented focused test, review the complete diff, and resubmit the individual history, branch, three tests, clean setup, reviewed pr, ai note, and live explanation.

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

  • يُودع العمل مباشرة في main فلا يمكن مراجعة التغيير كفرع معزول.Work is committed directly to main, so the change cannot be reviewed as an isolated branch.
  • يغطي الاختبار الناجح الحالة العادية فقط ويفوّت الحد المنشور.A passing test covers only the normal case and misses the published boundary.
  • يعلن طلب السحب النجاح دون أمر الاختبار أو مراجعة الفروقات أو المخاطر أو دليل استخدام الذكاء الاصطناعي.The pull request reports success without the command, diff review, risk, or AI-use evidence.
دليلي التعلّمي المُبلّغ عنه ذاتياًMy self-reported learning evidence

يُحفظ في هذا المتصفح فقط لدعم تعلّمك الشخصي. ليس حضوراً ولا درجة ولا نتيجة تحقق ولا سجلاً لشهادة.Saved only in this browser to support your own learning. It is not attendance, a score, a checkpoint result, or a certificate record.

جارٍ تحميل ملاحظاتك التعليمية المحلية…Loading your local learning notes…