الأسبوع الثالث — ملفات JSON والوحدات والنتائجWeek 3 — Day 1 — file and JSON boundaries

الأهدافObjectives

• ميّز بين ملف غائب وصياغة JSON غير صالحة ومستند JSON صالح قبل معالجة السجلات.Distinguish a missing file, invalid JSON syntax, and a valid JSON document before record processing.
• صنّف الحد وشغّل العينة المقدمة واحفظ الدليل دون كشف مسارات أو بيانات خاصة.Classify the boundary, run the supplied fixture, and preserve evidence without exposing private paths or data.

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

• اجتز تحقق الأسبوع الثاني في الدوال والسجلات أو استخدم مسار الدعم المرتب.Pass the Week 2 functions-and-records checkpoint or use the arranged supported path.
• افتح ملفات بداية الأسبوع الثالث وعينات الفهرس الاصطناعية كما هي.Open the exact Week 3 starter and synthetic catalogue fixtures.

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

• صنّف عينات الملف الغائب والصياغة غير الصالحة والملف الصالح قبل تشغيلها، ثم أصلح نسخة عينة الصياغة فقط.Classify the supplied missing, invalid-syntax, and valid fixtures before running them, then repair only the syntax fixture copy.

ورقة العملWorksheet

1. أكمل جدول حدود لملفات missing_catalogue.json وinvalid_catalogue.json وpublic_catalogue.json مع الاستثناء المتوقع والرسالة الآمنة والخطوة التالية.Complete a boundary table for missing_catalogue.json, invalid_catalogue.json, and public_catalogue.json with expected exception, safe message, and next step.مرجع الدليل: w3d1-error-classification-evidenceEvidence reference: w3d1-error-classification-evidence

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

1. اكتب الحد والنتيجة المتوقعين قبل تعديل الكود أو تشغيله.Write the expected boundary and result before editing or running code.
2. نفّذ التحميل المضبوط وأنشئ رسالة عربية أولاً لمساري الملف الغائب والصياغة غير الصالحة دون كشف مسار مطلق.Implement controlled loading and produce an Arabic-first message for the missing and invalid-syntax paths without exposing an absolute path.
3. شغّل فحوص الملف والصياغة والسجل والمعالجة وإعادة الفتح بالترتيب المنشور.Run the file, syntax, record, processing, and reopen checks in the published order.
4. احفظ المصدر ونص الطرفية الآمن وورقة العمل وناتج JSON وملاحظة محجوبة عن استخدام الذكاء الاصطناعي أو عدم استخدامه.Save source, safe terminal transcript, worksheet, result JSON, and a redacted AI-use or non-use note.

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

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

• صيغة نصية منظمة لتبادل البياناتJSON
• تحويل النص إلى بنية بياناتparse
• حدث يوقف المسار المعتادexception

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

• يخفي التقاط كل الاستثناءات ما إذا كان الفشل في الملف أو JSON أو السجل.Catching every exception hides whether the file, JSON, or record failed.
• تُنسخ السجلات المعطوبة إلى الناتج الصالح.Malformed records are copied into the valid result.
• يكتب البرنامج الناتج لكنه لا يعيد فتحه للتحقق من البنية والأعداد.The program writes output but never reopens it to verify structure and counts.

الأهدافObjectives

• تحقق من حقول الفهرس المطلوبة وأنواعها مع حفظ أسباب آمنة دون تغيير السجل المقدم.Validate required catalogue fields and types, preserving safe reasons without changing the supplied record.
• صنّف الحد وشغّل العينة المقدمة واحفظ الدليل دون كشف مسارات أو بيانات خاصة.Classify the boundary, run the supplied fixture, and preserve evidence without exposing private paths or data.

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

• اجتز تحقق الأسبوع الثاني في الدوال والسجلات أو استخدم مسار الدعم المرتب.Pass the Week 2 functions-and-records checkpoint or use the arranged supported path.
• افتح ملفات بداية الأسبوع الثالث وعينات الفهرس الاصطناعية كما هي.Open the exact Week 3 starter and synthetic catalogue fixtures.

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

• افحص سجلاً صالحاً وسجلات العنوان الفارغ والسنة النصية والمعرّف الفارغ؛ وتوقع أول قاعدة فاشلة والسبب الآمن.Inspect one valid record and the blank-title, text-year, and blank-ID records; predict the first failing rule and safe reason.

ورقة العملWorksheet

1. أكمل جدول جودة السجلات بثمانية سطور مع الحقول المطلوبة والأنواع الفعلية وأول قاعدة فاشلة والنوع المتوقع والسبب الآمن.Complete the eight-row record-quality table with required fields, actual types, first failing rule, expected kind, and safe reason.مرجع الدليل: w3d2-record-validation-evidenceEvidence reference: w3d2-record-validation-evidence

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

1. اكتب الحد والنتيجة المتوقعين قبل تعديل الكود أو تشغيله.Write the expected boundary and result before editing or running code.
2. نفّذ validate_record في وحدة التحقق المستوردة وتحقق من خمسة سجلات مقبولة وثلاثة مرفوضة بالترتيب المنشور.Implement validate_record in the imported validation module and verify five accepted and three rejected records in published order.
3. شغّل فحوص الملف والصياغة والسجل والمعالجة وإعادة الفتح بالترتيب المنشور.Run the file, syntax, record, processing, and reopen checks in the published order.
4. احفظ المصدر ونص الطرفية الآمن وورقة العمل وناتج JSON وملاحظة محجوبة عن استخدام الذكاء الاصطناعي أو عدم استخدامه.Save source, safe terminal transcript, worksheet, result JSON, and a redacted AI-use or non-use note.

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

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

• معطوب أو مخالف للبنيةmalformed
• حقل يجب أن يكون موجوداًrequired field
• نوع القيمة البرمجيةtype

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

• يخفي التقاط كل الاستثناءات ما إذا كان الفشل في الملف أو JSON أو السجل.Catching every exception hides whether the file, JSON, or record failed.
• تُنسخ السجلات المعطوبة إلى الناتج الصالح.Malformed records are copied into the valid result.
• يكتب البرنامج الناتج لكنه لا يعيد فتحه للتحقق من البنية والأعداد.The program writes output but never reopens it to verify structure and counts.

الأهدافObjectives

• استورد وحدة تحقق محلية وحدد وحدة json من المكتبة القياسية وأعد إنتاج حزمة الاختبار المعتمدة من سجل اعتماديتها الدقيق.Import a local validation module, identify the standard-library json module, and reproduce the approved test package from its exact dependency record.
• صنّف الحد وشغّل العينة المقدمة واحفظ الدليل دون كشف مسارات أو بيانات خاصة.Classify the boundary, run the supplied fixture, and preserve evidence without exposing private paths or data.

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

• اجتز تحقق الأسبوع الثاني في الدوال والسجلات أو استخدم مسار الدعم المرتب.Pass the Week 2 functions-and-records checkpoint or use the arranged supported path.
• افتح ملفات بداية الأسبوع الثالث وعينات الفهرس الاصطناعية كما هي.Open the exact Week 3 starter and synthetic catalogue fixtures.

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

• تتبع كيفية حل كل استيراد، ثم أنشئ بيئة نظيفة وتوقع ما سيثبته requirements-dev.txt.Trace how each import is resolved, then create a clean environment and predict what requirements-dev.txt will install.

ورقة العملWorksheet

1. قدّم خريطة استيراد تسمي المصدر والمسؤولية ودليل إعادة الإنتاج لكل من catalogue_validation وjson وpytest.Submit an import map naming source, responsibility, and reproducibility evidence for catalogue_validation, json, and pytest.مرجع الدليل: w3d3-module-dependency-evidenceEvidence reference: w3d3-module-dependency-evidence

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

1. اكتب الحد والنتيجة المتوقعين قبل تعديل الكود أو تشغيله.Write the expected boundary and result before editing or running code.
2. شغّل الأداة عبر وحدتها المحلية وسجّل الاعتمادية الدقيقة ونفّذ اختبارات مركزة من بيئة مشروع نظيفة.Run the tool through its local module, record the exact dependency, and execute focused tests from a clean project environment.
3. شغّل فحوص الملف والصياغة والسجل والمعالجة وإعادة الفتح بالترتيب المنشور.Run the file, syntax, record, processing, and reopen checks in the published order.
4. احفظ المصدر ونص الطرفية الآمن وورقة العمل وناتج JSON وملاحظة محجوبة عن استخدام الذكاء الاصطناعي أو عدم استخدامه.Save source, safe terminal transcript, worksheet, result JSON, and a redacted AI-use or non-use note.

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

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

• ملف Python قابل للاستيرادmodule
• مجموعة وحدات قابلة للتثبيتpackage
• تعليمة لاستخدام كود من وحدةimport
• حزمة يعتمد عليها المشروعdependency

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

• يخفي التقاط كل الاستثناءات ما إذا كان الفشل في الملف أو JSON أو السجل.Catching every exception hides whether the file, JSON, or record failed.
• تُنسخ السجلات المعطوبة إلى الناتج الصالح.Malformed records are copied into the valid result.
• يكتب البرنامج الناتج لكنه لا يعيد فتحه للتحقق من البنية والأعداد.The program writes output but never reopens it to verify structure and counts.

الأهدافObjectives

• عالج السجلات الصالحة فقط واكتب JSON حتمياً وأعد فتحه وأثبت أن المدخلات تساوي الصالح زائد المرفوض.Process only valid records, write deterministic JSON, reopen it, and prove input equals valid plus rejected.
• صنّف الحد وشغّل العينة المقدمة واحفظ الدليل دون كشف مسارات أو بيانات خاصة.Classify the boundary, run the supplied fixture, and preserve evidence without exposing private paths or data.

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

• اجتز تحقق الأسبوع الثاني في الدوال والسجلات أو استخدم مسار الدعم المرتب.Pass the Week 2 functions-and-records checkpoint or use the arranged supported path.
• افتح ملفات بداية الأسبوع الثالث وعينات الفهرس الاصطناعية كما هي.Open the exact Week 3 starter and synthetic catalogue fixtures.

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

• تتبع العينة المختلطة وحدد أول موضع ينحرف فيه عدد متاح خاطئ مقصود قدره 4 واقترح تصحيحاً محلياً وفحصاً مجاوراً.Trace the mixed fixture, locate where a deliberately wrong available count of 4 first diverges, and propose one local correction and neighboring check.

ورقة العملWorksheet

1. قدّم مخطط الناتج وتتبع المطابقة وفحص JSON بعد إعادة فتحه وسجل قرار الذكاء الاصطناعي مع الطلب المحجوب والسبب والاختبار والنتيجة.Submit the result schema, reconciliation trace, reopened JSON check, and accountable-AI decision record with redacted prompt, reason, test, and result.مرجع الدليل: w3d4-result-verification-evidenceEvidence reference: w3d4-result-verification-evidence

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

1. اكتب الحد والنتيجة المتوقعين قبل تعديل الكود أو تشغيله.Write the expected boundary and result before editing or running code.
2. نفّذ بناء الناتج وكتابته؛ وتحقق من 8/5/3/3 وأعد فتح المخرج ووثّق اقتراح ذكاء اصطناعي محجوباً تم قبوله أو تغييره أو رفضه أو عدم استخدامه.Implement result building and writing; verify 8/5/3/3, reopen the output, and document one redacted AI suggestion accepted, changed, rejected, or not used.
3. شغّل فحوص الملف والصياغة والسجل والمعالجة وإعادة الفتح بالترتيب المنشور.Run the file, syntax, record, processing, and reopen checks in the published order.
4. احفظ المصدر ونص الطرفية الآمن وورقة العمل وناتج JSON وملاحظة محجوبة عن استخدام الذكاء الاصطناعي أو عدم استخدامه.Save source, safe terminal transcript, worksheet, result JSON, and a redacted AI-use or non-use note.

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

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

• ملف تكتب فيه نتائج المعالجةresult file
• تحويل البيانات إلى نص منظمserialize
• مطابقة الأعداد والعلاقاتreconcile

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

• يخفي التقاط كل الاستثناءات ما إذا كان الفشل في الملف أو JSON أو السجل.Catching every exception hides whether the file, JSON, or record failed.
• تُنسخ السجلات المعطوبة إلى الناتج الصالح.Malformed records are copied into the valid result.
• يكتب البرنامج الناتج لكنه لا يعيد فتحه للتحقق من البنية والأعداد.The program writes output but never reopens it to verify structure and counts.

الأهدافObjectives

• أكمل ملفات البداية دون تغيير بصورة فردية واجتز فحوص الملف والصياغة والسجل والمعالجة وإعادة الفتح واشرح كل مسؤولية.Individually complete the unchanged starter, pass file, syntax, record, processing, and reopen checks, and explain each responsibility.
• صنّف الحد وشغّل العينة المقدمة واحفظ الدليل دون كشف مسارات أو بيانات خاصة.Classify the boundary, run the supplied fixture, and preserve evidence without exposing private paths or data.

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

• اجتز تحقق الأسبوع الثاني في الدوال والسجلات أو استخدم مسار الدعم المرتب.Pass the Week 2 functions-and-records checkpoint or use the arranged supported path.
• افتح ملفات بداية الأسبوع الثالث وعينات الفهرس الاصطناعية كما هي.Open the exact Week 3 starter and synthetic catalogue fixtures.

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

• اقرأ المعيار وتوقع كل حالة منشورة وارسم مخطط الحدود والاستيراد وجهّز مخطط الناتج قبل البناء المحدد بالوقت.Read the rubric, predict every published case, draw the boundary and import diagram, and prepare the result schema before the timed build.

ورقة العملWorksheet

1. أكمل سجل التحقق الفردي: مخطط الحدود وخريطة الاستيراد والحالات المتوقعة والفعلية وناتج 8/5/3/3 ودليل إعادة الفتح ومسارات الأدلة وقرار الذكاء الاصطناعي وقائمة الشرح المباشر.Complete the individual checkpoint record: boundary diagram, import map, expected and actual cases, 8/5/3/3 result, reopen proof, evidence paths, AI decision, and live explanation checklist.مرجع الدليل: w3d5-checkpoint-evidenceEvidence reference: w3d5-checkpoint-evidence

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

1. اكتب الحد والنتيجة المتوقعين قبل تعديل الكود أو تشغيله.Write the expected boundary and result before editing or running code.
2. أكمل دوال TODO الأربع بصورة فردية؛ وشغّل كل الحالات المنشورة؛ واحفظ المصدر والنص الآمن وناتج JSON ودليل الاعتمادية وملاحظة الذكاء الاصطناعي والشرح المباشر لمسار صالح وآخر فاشل.Complete all four TODO functions independently; run every published case; save source, safe transcript, result JSON, dependency evidence, AI note, and live explanation of one valid and one failing path.
3. شغّل فحوص الملف والصياغة والسجل والمعالجة وإعادة الفتح بالترتيب المنشور.Run the file, syntax, record, processing, and reopen checks in the published order.
4. احفظ المصدر ونص الطرفية الآمن وورقة العمل وناتج JSON وملاحظة محجوبة عن استخدام الذكاء الاصطناعي أو عدم استخدامه.Save source, safe terminal transcript, worksheet, result JSON, and a redacted AI-use or non-use note.

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

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

• صيغة نصية منظمةJSON
• حدث يوقف المسار المعتادexception
• ملف كود قابل للاستيرادmodule
• كود قابل للتثبيتpackage
• ملف النتائج المكتوبresult file

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

• يخفي التقاط كل الاستثناءات ما إذا كان الفشل في الملف أو JSON أو السجل.Catching every exception hides whether the file, JSON, or record failed.
• تُنسخ السجلات المعطوبة إلى الناتج الصالح.Malformed records are copied into the valid result.
• يكتب البرنامج الناتج لكنه لا يعيد فتحه للتحقق من البنية والأعداد.The program writes output but never reopens it to verify structure and counts.