الأسبوع الثاني — القوائم والقواميس والدوالWeek 2 — Day 1 — lists, loops, and several stock records

الأهدافObjectives

• أنشئ قائمة من سجلات مخزون خيالية متسقة، واستخدم الفهرسة والحلقة دون تغيير ترتيبها.Create, index, and loop through a list of consistent fictional stock records without changing their order.
• توقّع النتيجة وشغّلها واشرحها باستخدام السجلات الخيالية الثمانية المنشورة فقط.Predict, run, and explain the result using only the eight published fictional records.

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

• اجتز تحقق الأسبوع الأول في التحقق والتفرع أو استخدم مسار الدعم المرتب.Pass the Week 1 validation-and-branching checkpoint or use the arranged supported path.
• افتح ملف بداية الأسبوع الثاني؛ ولا تستبدل بياناته الخيالية بجدول أو سجل حقيقي.Open the Week 2 starter; do not replace its fictional data with a real spreadsheet or record.

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

• أنشئ قائمة من ثلاثة سجلات وفق دليل الحقول، وتوقع الفهرسين 0 و2، ثم نفّذ حلقة وتتبع تسلسل item_id.Build a three-record list from the field guide, predict indexes 0 and 2, then loop and trace the item_id sequence.

ورقة العملWorksheet

1. أكمل تتبع الفهرسة والحلقة للسجلات 0 و3 و7؛ وسجّل item_id الذي تمت زيارته واشرح سبب ثبات ترتيب القائمة.Complete an index-and-loop trace for records 0, 3, and 7; record the exact item_id visited and explain why the list order is stable.مرجع الدليل: w2d1-list-trace-evidenceEvidence reference: w2d1-list-trace-evidence

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

1. اكتب النتيجة المتوقعة قبل تعديل الكود أو تشغيله.Write the expected result before editing or running code.
2. حمّل public_records.json، وأثبت أنه يحتوي ثمانية سجلات مرتبة، واطبع item_id الخيالي لكل سجل فقط دون كشف حقل آخر.Load public_records.json, prove that it contains eight ordered records, and print only each fictional item_id without exposing another field.
3. شغّل السجلات الثمانية كلها وقارن مخرجات المقبول والمرفوض والملخص بالتوقعات المنشورة.Run all eight records and compare accepted, rejected, and summary outputs with the published expectations.
4. احفظ المصدر ونص الطرفية وورقة العمل وملاحظة محجوبة عن استخدام الذكاء الاصطناعي أو عدم استخدامه في مجلد الأدلة.Save source, terminal transcript, worksheet, and a redacted AI-use or non-use note in the evidence folder.

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

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

• مجموعة مرتبة من القيمlist
• موضع قيمة داخل القائمةindex
• تكرار تعليمات على عدة قيمloop

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

• يتغير اسم الحقل بين السجلات، فيفشل الوصول إلى المفتاح.A field name changes between records, causing a key lookup failure.
• تُضاف كميات السجلات المرفوضة إلى مجموع المقبول.Rejected quantities are added to the accepted total.
• تطبع الدالة قيمة بدلاً من إعادتها إلى الدالة المستدعية.A function prints a value instead of returning it to its caller.

الأهدافObjectives

• اقرأ حقول القاموس المطلوبة بصورة متسقة وحدد القيم المفقودة أو الفارغة أو ذات النوع الخطأ قبل المعالجة.Read required dictionary fields consistently and identify missing, blank, or wrongly typed values before processing.
• توقّع النتيجة وشغّلها واشرحها باستخدام السجلات الخيالية الثمانية المنشورة فقط.Predict, run, and explain the result using only the eight published fictional records.

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

• اجتز تحقق الأسبوع الأول في التحقق والتفرع أو استخدم مسار الدعم المرتب.Pass the Week 1 validation-and-branching checkpoint or use the arranged supported path.
• افتح ملف بداية الأسبوع الثاني؛ ولا تستبدل بياناته الخيالية بجدول أو سجل حقيقي.Open the Week 2 starter; do not replace its fictional data with a real spreadsheet or record.

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

• استخدم دليل الحقول الأربعة لفحص السجلات STK-103 وSTK-105 وSTK-107؛ وحدد الحاضر والفارغ والنوع الخطأ دون إصلاح البيانات.Use the four-field guide to inspect records STK-103, STK-105, and STK-107; mark present, blank, or wrong type without fixing the data.

ورقة العملWorksheet

1. أكمل جدول جودة الحقول للسجلات الثمانية بأعمدة item_id وitem_name وquantity وunit ومشكلة الحقل ونتيجة القبول أو الرفض المتوقعة.Complete a field-quality table for all eight records with columns item_id, item_name, quantity, unit, field issue, and expected accepted/rejected result.مرجع الدليل: w2d2-field-table-evidenceEvidence reference: w2d2-field-table-evidence

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

1. اكتب النتيجة المتوقعة قبل تعديل الكود أو تشغيله.Write the expected result before editing or running code.
2. أنشئ تتبعاً للوصول إلى الحقول في السجلات الثمانية، واكتب سبب تحقق لكل معرّف فارغ أو اسم صنف فارغ أو كمية غير صحيحة النوع أو سالبة.Create a field-access trace for all eight records and write a validation reason for every blank identifier, blank item name, non-integer quantity, or negative quantity.
3. شغّل السجلات الثمانية كلها وقارن مخرجات المقبول والمرفوض والملخص بالتوقعات المنشورة.Run all eight records and compare accepted, rejected, and summary outputs with the published expectations.
4. احفظ المصدر ونص الطرفية وورقة العمل وملاحظة محجوبة عن استخدام الذكاء الاصطناعي أو عدم استخدامه في مجلد الأدلة.Save source, terminal transcript, worksheet, and a redacted AI-use or non-use note in the evidence folder.

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

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

• سجل من مفاتيح وقيمdictionary
• اسم ثابت لحقلkey
• جزء مسمى من السجلfield
• نوع القيمة البرمجيةtype

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

• يتغير اسم الحقل بين السجلات، فيفشل الوصول إلى المفتاح.A field name changes between records, causing a key lookup failure.
• تُضاف كميات السجلات المرفوضة إلى مجموع المقبول.Rejected quantities are added to the accepted total.
• تطبع الدالة قيمة بدلاً من إعادتها إلى الدالة المستدعية.A function prints a value instead of returning it to its caller.

الأهدافObjectives

• افصل التحقق والتقسيم والتلخيص والعرض في دوال ذات معاملات واضحة وقيم معادة قابلة لإعادة الاستخدام.Separate validation, partitioning, summary, and display into functions with explicit parameters and reusable return values.
• توقّع النتيجة وشغّلها واشرحها باستخدام السجلات الخيالية الثمانية المنشورة فقط.Predict, run, and explain the result using only the eight published fictional records.

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

• اجتز تحقق الأسبوع الأول في التحقق والتفرع أو استخدم مسار الدعم المرتب.Pass the Week 1 validation-and-branching checkpoint or use the arranged supported path.
• افتح ملف بداية الأسبوع الثاني؛ ولا تستبدل بياناته الخيالية بجدول أو سجل حقيقي.Open the Week 2 starter; do not replace its fictional data with a real spreadsheet or record.

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

• ارسم أربعة صناديق للدوال وسمِّ مدخل كل منها وقيمتها المعادة، ثم تتبع STK-101 وSTK-104 خلال validate_record دون كتابة جسم الدالة.Draw four function boxes, label each input and return, then trace STK-101 and STK-104 through validate_record without writing the function body.

ورقة العملWorksheet

1. قدّم مخطط مسؤوليات الدوال الأربع وتتبع استدعاء لسجلين يوضح الوسيط والمعامل والزوج المعاد وقرار الدالة المستدعية.Submit the four-function responsibility diagram and a two-record call trace showing argument, parameter, returned tuple, and caller decision.مرجع الدليل: w2d3-function-trace-evidenceEvidence reference: w2d3-function-trace-evidence

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

1. اكتب النتيجة المتوقعة قبل تعديل الكود أو تشغيله.Write the expected result before editing or running code.
2. نفّذ validate_record بحيث تعيد قيمة منطقية وسبباً، ثم تحقق من نتيجة القبول أو الرفض الدقيقة لكل سجل من السجلات الثمانية.Implement validate_record so it returns a boolean and reason, then verify the exact accepted/rejected result for each of the eight records.
3. شغّل السجلات الثمانية كلها وقارن مخرجات المقبول والمرفوض والملخص بالتوقعات المنشورة.Run all eight records and compare accepted, rejected, and summary outputs with the published expectations.
4. احفظ المصدر ونص الطرفية وورقة العمل وملاحظة محجوبة عن استخدام الذكاء الاصطناعي أو عدم استخدامه في مجلد الأدلة.Save source, terminal transcript, worksheet, and a redacted AI-use or non-use note in the evidence folder.

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

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

• وحدة كود ذات مهمة محددةfunction
• اسم يستقبل قيمة داخل الدالةparameter
• القيمة المرسلة عند الاستدعاءargument
• إرسال نتيجة إلى المستدعيreturn

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

• يتغير اسم الحقل بين السجلات، فيفشل الوصول إلى المفتاح.A field name changes between records, causing a key lookup failure.
• تُضاف كميات السجلات المرفوضة إلى مجموع المقبول.Rejected quantities are added to the accepted total.
• تطبع الدالة قيمة بدلاً من إعادتها إلى الدالة المستدعية.A function prints a value instead of returning it to its caller.

الأهدافObjectives

• قسّم السجلات الصالحة وغير الصالحة، واستبعد كميات المرفوض من الملخص، ونسّق المخرجات بالعربية أولاً، وصحح مساراً فاشلاً.Partition valid and invalid records, exclude rejected quantities from the summary, format Arabic-first output, and debug one failing path.
• توقّع النتيجة وشغّلها واشرحها باستخدام السجلات الخيالية الثمانية المنشورة فقط.Predict, run, and explain the result using only the eight published fictional records.

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

• اجتز تحقق الأسبوع الأول في التحقق والتفرع أو استخدم مسار الدعم المرتب.Pass the Week 1 validation-and-branching checkpoint or use the arranged supported path.
• افتح ملف بداية الأسبوع الثاني؛ ولا تستبدل بياناته الخيالية بجدول أو سجل حقيقي.Open the Week 2 starter; do not replace its fictional data with a real spreadsheet or record.

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

• تتبع السجلات الثمانية خلال مسار المعالجة، وحدد أول موضع ينحرف فيه مجموع خاطئ مقصود قدره 22، واقترح تصحيحاً محلياً وفحصاً مجاوراً لمنع التراجع.Trace the eight records through the pipeline, find where an intentionally wrong total of 22 first diverges, and propose one local correction plus a neighboring regression check.

ورقة العملWorksheet

1. قدّم سجل تصحيح لمسار فاشل وسجل قرار للذكاء الاصطناعي يتضمن الطلب المحجوب والاقتراح وقرار المتعلم والسبب والاختبار والنتيجة والشرح.Submit a failing-path debug record plus an AI decision record containing redacted prompt, suggestion, learner decision, reason, test, result, and explanation.مرجع الدليل: w2d4-pipeline-review-evidenceEvidence reference: w2d4-pipeline-review-evidence

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

1. اكتب النتيجة المتوقعة قبل تعديل الكود أو تشغيله.Write the expected result before editing or running code.
2. نفّذ partition_records وcalculate_summary وformat_summary؛ وتحقق من 4 مقبولة و4 مرفوضة ومجموع 24، ثم وثق اقتراح ذكاء اصطناعي تم قبوله أو تغييره أو رفضه أو عدم استخدامه.Implement partition_records, calculate_summary, and format_summary; verify 4 accepted, 4 rejected, total 24, then document one AI suggestion accepted, changed, rejected, or not used.
3. شغّل السجلات الثمانية كلها وقارن مخرجات المقبول والمرفوض والملخص بالتوقعات المنشورة.Run all eight records and compare accepted, rejected, and summary outputs with the published expectations.
4. احفظ المصدر ونص الطرفية وورقة العمل وملاحظة محجوبة عن استخدام الذكاء الاصطناعي أو عدم استخدامه في مجلد الأدلة.Save source, terminal transcript, worksheet, and a redacted AI-use or non-use note in the evidence folder.

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

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

• سلسلة مراحل لمعالجة البياناتpipeline
• سجل اجتاز التحققaccepted
• سجل لم يجتز التحققrejected
• نتائج مجمعة مختصرةsummary

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

• يتغير اسم الحقل بين السجلات، فيفشل الوصول إلى المفتاح.A field name changes between records, causing a key lookup failure.
• تُضاف كميات السجلات المرفوضة إلى مجموع المقبول.Rejected quantities are added to the accepted total.
• تطبع الدالة قيمة بدلاً من إعادتها إلى الدالة المستدعية.A function prints a value instead of returning it to its caller.

الأهدافObjectives

• أكمل ملف البداية دون تغيير بصورة فردية، واجتز السجلات الثمانية المنشورة، واشرح مسؤولية كل دالة وقيمتها المعادة.Individually complete the unchanged starter, pass all eight published records, and explain each function's responsibility and return value.
• توقّع النتيجة وشغّلها واشرحها باستخدام السجلات الخيالية الثمانية المنشورة فقط.Predict, run, and explain the result using only the eight published fictional records.

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

• اجتز تحقق الأسبوع الأول في التحقق والتفرع أو استخدم مسار الدعم المرتب.Pass the Week 1 validation-and-branching checkpoint or use the arranged supported path.
• افتح ملف بداية الأسبوع الثاني؛ ولا تستبدل بياناته الخيالية بجدول أو سجل حقيقي.Open the Week 2 starter; do not replace its fictional data with a real spreadsheet or record.

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

• اقرأ معيار التحقق، وتوقع نتائج السجلات الثمانية، وجهّز مخطط الدوال قبل بدء البناء الفردي المحدد بالوقت.Read the checkpoint rubric, predict all eight outcomes, and prepare a function diagram before the timed individual build begins.

ورقة العملWorksheet

1. أكمل سجل التحقق الفردي: مخطط الدوال، والنتائج المتوقعة والفعلية للسجلات الثمانية، وملخص 4/4/24، ومسارات الأدلة، وقرار الذكاء الاصطناعي، وقائمة الشرح المباشر.Complete the individual checkpoint record: function diagram, eight expected and actual outcomes, summary 4/4/24, evidence paths, AI decision, and live explanation checklist.مرجع الدليل: w2d5-checkpoint-evidenceEvidence reference: w2d5-checkpoint-evidence

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

1. اكتب النتيجة المتوقعة قبل تعديل الكود أو تشغيله.Write the expected result before editing or running code.
2. أكمل دوال TODO الأربع بصورة فردية؛ وشغّل مجموعة السجلات الثمانية؛ واحفظ المصدر والملخص الدقيق وأسباب القبول والرفض وسجل الذكاء الاصطناعي أو بيان عدم استخدامه؛ ثم اشرح مساراً صالحاً وآخر غير صالح مباشرة.Complete all four TODO functions independently; run the eight-record suite; save source, exact summary, accepted/rejected reasons, AI log or non-use statement; then explain one valid and one invalid path live.
3. شغّل السجلات الثمانية كلها وقارن مخرجات المقبول والمرفوض والملخص بالتوقعات المنشورة.Run all eight records and compare accepted, rejected, and summary outputs with the published expectations.
4. احفظ المصدر ونص الطرفية وورقة العمل وملاحظة محجوبة عن استخدام الذكاء الاصطناعي أو عدم استخدامه في مجلد الأدلة.Save source, terminal transcript, worksheet, and a redacted AI-use or non-use note in the evidence folder.

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

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

• مجموعة مرتبة من القيمlist
• سجل من مفاتيح وقيمdictionary
• وحدة كود ذات مهمة محددةfunction
• اسم يستقبل قيمة داخل الدالةparameter
• قيمة تعاد إلى المستدعيreturn

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

• يتغير اسم الحقل بين السجلات، فيفشل الوصول إلى المفتاح.A field name changes between records, causing a key lookup failure.
• تُضاف كميات السجلات المرفوضة إلى مجموع المقبول.Rejected quantities are added to the accepted total.
• تطبع الدالة قيمة بدلاً من إعادتها إلى الدالة المستدعية.A function prints a value instead of returning it to its caller.