مساحة المدرّبينTrainer hub

حزمة المدرّب العامة الكاملةComplete public trainer pack

الأسبوع السادس — حزمة المدرّبWeek 6 — Trainer pack

480 / 240 / 780دقائق التدريس / الممارسة الموجّهة / المختبر الخاضع للإشرافinstruction / guided practice / supervised lab minutes

حزمة المدرّب هذه عامة. تبقى مهام بوابة الأساس الحية وبنوك المهام وملاحظات المقيمين ونتائج المشاركين والإجابات المكتملة وملاحظات الحلول المشروحة غير عامة.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

حالة الحل الكاملComplete solution status

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

اليوم 1Day 1

اليوم 1 — دورة الاتصال والإعدادات المحليةDay 1 — connection lifecycle and local settings

التحضيرPreparation

  • اجتز تحقق الأسبوع الخامس للمخطط المُطبّع أو استخدم مسار الدعم المرتب.Pass the Week 5 normalised-schema checkpoint or use the arranged supported path.
  • افتح حزمة بداية الأسبوع السادس كما هي وحمّل عينة PostgreSQL النظيفة وأبقِ DATABASE_DSN في البيئة المحلية المستبعدة فقط.Open the exact Week 6 starter, load its clean PostgreSQL fixture, and keep DATABASE_DSN only in the ignored local environment.

المواد المطلوبة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.
  • حالات الإدخال الاصطناعية المقدمة فقط وعددها 4؛ دون بيانات مشاركين حقيقية.Only the 4 supplied synthetic input cases; no real participant data.

الأهدافObjectives

  • حمّل إعداد قاعدة بيانات محلياً مستبعداً وافتح اتصال Psycopg وأغلقه بأمان وأثبت الاتصال باستعلام قراءة واحد.Load an ignored local database setting, open and close a Psycopg connection safely, and prove the connection with one read query.
  • اشرح الأمر والتحقق والاستعلام ومعاملة قاعدة البيانات والنتيجة المخزنة باستخدام معرفات اصطناعية وإعدادات محلية محجوبة فقط.Explain the command, validation, query, transaction, and stored result using only synthetic identifiers and redacted local settings.

جدول التنفيذ الدقيقExact run sheet

اليوم 1: اليوم 1 — دورة الاتصال والإعدادات المحليةDay 1: Day 1 — connection lifecycle and local settings
الفقرةBlockالدقائقMinutesالنمطModeإجراء المدرّبTrainer actionإجراء المتعلّمLearner action
الاتصال دون كشف بيانات الدخولConnect without exposing credentials120تدريسInstructionتتبع الأمر والتحقق والاستعلام ذي المعاملات ومعاملة قاعدة البيانات والنتيجة باستخدام المعرفات الاصطناعية المقدمة، وقدّم المصطلحات الإنجليزية بعد الشرح العربي.Trace command, validation, parameterised query, transaction, and result with the supplied synthetic identifiers, introducing English terms after the Arabic explanation.توقع حالة قاعدة البيانات والنتيجة الظاهرة قبل تشغيل كل أمر Python.Predict the database state and visible result before running each Python command.
تدريب Python/PostgreSQL موجّهGuided Python/PostgreSQL practice60ممارسة موجّهةGuided practiceاعرض الحد الأول واجمع التوقعات ثم قلّل التلميحات بينما تستخدم الأزواج العينة المنشورة فقط.Model the first boundary, collect predictions, then fade prompts while pairs use only the published fixture.صنّف أدلة الاتصال الآمنة وغير الآمنة ثم تتبع صفاً معروفاً واحداً دون عرض قيمة الإعداد.Classify safe and unsafe connection evidence, then trace one known row without displaying the setting value.
مختبر واجهة قاعدة البيانات بإشرافSupervised database CLI lab120مختبر خاضع للإشرافSupervised labراقب الكود الفردي والنتائج المخزنة، واطلب بقاء القيم منفصلة عن SQL، وأوقف دخول بيانات الدخول أو روابط الاتصال أو السجلات الحقيقية إلى السجلات أو Git.Observe individual code and stored results, require values to stay separate from SQL, and stop credentials, connection URLs, or real records from entering logs or Git.نفّذ open_connection واستعلم عن عدد الحجوزات المقدمة وأغلق الاتصال بنظافة واحفظ دليل التشخيص المحجوب فقط.Implement open_connection, query the count of supplied bookings, close cleanly, and save only redacted diagnostic evidence.

ملاحظات الشرحExplanation notes

الإعداد خارج الكود المصدريConfiguration outside source code

حمّل إعداد قاعدة بيانات محلياً مستبعداً وافتح اتصال Psycopg وأغلقه بأمان وأثبت الاتصال باستعلام قراءة واحد.Load an ignored local database setting, open and close a Psycopg connection safely, and prove the connection with one read query.

يتحقق كود قاعدة البيانات الموثوق من القيم قبل الوصول، ويمرر القيم كمعاملات للاستعلام، ويضبط التثبيت والتراجع، ويفحص الحالة المخزنة بدلاً من الثقة برسالة نجاح.Reliable database code validates values before access, passes values as query parameters, controls commit and rollback, and checks the stored state rather than trusting a success message.

أمثلة العرضDemonstration examples
DATABASE_DSN مستبعد ← فتح الاتصال ← SELECT لصف عينة معروف ← إغلاق نظيفignored DATABASE_DSN → open connection → SELECT known fixture row → clean close

تسلسل الشرائح والعرضSlide and demonstration sequence

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

    • حمّل إعداد قاعدة بيانات محلياً مستبعداً وافتح اتصال Psycopg وأغلقه بأمان وأثبت الاتصال باستعلام قراءة واحد.Load an ignored local database setting, open and close a Psycopg connection safely, and prove the connection with one read query.

    إشارة التقديمSpeaker cueاطلب من متعلم توقع قيمة الإرجاع والصف المخزن قبل التنفيذ.Ask a learner to predict both the return value and stored row before execution.

  2. الاتصال دون كشف بيانات الدخولConnect without exposing credentials

    • DATABASE_DSN مستبعد ← فتح الاتصال ← SELECT لصف عينة معروف ← إغلاق نظيفignored DATABASE_DSN → open connection → SELECT known fixture row → clean close

    إشارة التقديمSpeaker cueتتبع قيمة P-/S-/B- واحدة عبر التحقق والمعاملات ومعاملة قاعدة البيانات والنتيجة.Trace one P-/S-/B- value through validation, parameters, transaction, and result.

  3. الإعدادات المحلية والصفوف الاصطناعيةLocal settings and synthetic rows

    • أبقِ DATABASE_DSN في إعدادات محلية مستبعدة. اعرض الكود بمسارات نسبية للمشروع والمعرفات الاصطناعية والمخرجات المحجوبة فقط.Keep DATABASE_DSN in ignored local settings. Show only project-relative code, synthetic identifiers, and redacted output.

    إشارة التقديمSpeaker cueنفّذ فحص بيانات دخول القاعدة والبيانات الحقيقية قبل المختبر.Run the database credential and real-data scan before the lab.

تيسير الممارسة الموجّهةGuided-practice facilitation

  1. صنّف أدلة الاتصال الآمنة وغير الآمنة ثم تتبع صفاً معروفاً واحداً دون عرض قيمة الإعداد.Classify safe and unsafe connection evidence, then trace one known row without displaying the setting value.

تيسير المختبرLab facilitation

  1. أعد العينة المقدمة واكتب قيمة الإرجاع والصفوف المخزنة المتوقعة قبل التنفيذ.Reset the supplied fixture and write the expected return value and stored rows before execution.
  2. نفّذ open_connection واستعلم عن عدد الحجوزات المقدمة وأغلق الاتصال بنظافة واحفظ دليل التشخيص المحجوب فقط.Implement open_connection, query the count of supplied bookings, close cleanly, and save only redacted diagnostic evidence.
  3. شغّل الأمر أو الاختبار المركز مرتين وافحص الحالة المخزنة وأصلح أول حد منحرف في التحقق أو الاستعلام أو معاملة قاعدة البيانات فقط.Run the focused command or test twice, inspect stored state, and repair only the first divergent validation, query, or transaction boundary.
  4. احفظ الأوامر المحجوبة والمخرجات الاصطناعية ودليل الاختبار والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط.Save only redacted commands, synthetic output, test evidence, reasoning, and the AI-use or non-use note.

الأدلة المتوقعةExpected evidence

  • يثبت التشخيص المحجوب الإعدادات المحلية المستبعدة ونتيجة قراءة معروفة واحدة واتصالاً مغلقاً بنظافة.The redacted diagnostic proves ignored local settings, one known read result, and a cleanly closed connection.w6d1-connection-evidence

معايير التحقق المنشورةPublished checkpoint criteria

مهمة التحقق المنشورةPublished checkpoint prompt

نفّذ واجهة سطر أوامر بلغة Python تنشئ سجلات PostgreSQL وتقرأها وتحدثها وتتحقق منها مع اختبارات.Implement a Python CLI that creates, reads, updates, and validates PostgreSQL records with tests.

  • تستخدم أوامر الإنشاء والقراءة والتحديث SQL ذا معاملات ومعاملات قاعدة بيانات مضبوطة.Create, read and update commands use parameterised SQL and controlled transactions.
  • تنتج القيم غير الصالحة والسجلات المفقودة نتائج واضحة دون إفساد البيانات.Invalid values and missing records produce clear results without corrupting data.
  • تنجح الاختبارات الآلية بصورة متكررة انطلاقاً من خطوات إعداد موثقة.Automated tests pass repeatedly from documented setup steps.

الأخطاء الشائعةCommon errors

  • تُدمج القيم في نص SQL بدلاً من تمريرها منفصلة كمعاملات.Values are joined into SQL text instead of passed separately as parameters.
  • يعلن البرنامج النجاح دون فحص الصف المرجع أو المخزن.The program reports success without checking the returned or stored row.
  • تعتمد الاختبارات على صفوف تركها تشغيل سابق وتفشل عند التكرار.Tests depend on rows left by an earlier run and fail when repeated.

تدخلات المدرّبTrainer interventions

  • ارجع إلى أربعة صناديق—الأمر والتحقق والاستعلام والنتيجة—وتتبع قيمة واحدة عبرها.Return to four boxes—command, validation, query, result—and trace one value across them.
  • أعد العينة وشغّل اختباراً ضيقاً واحداً وقارن حالة قاعدة البيانات قبل تغيير الكود.Reset the fixture, run one narrow test, and compare database state before changing code.

الاستدراكRecovery

خلال أسبوع واحد، أعد العينة المقدمة وصحح أول حد معطوب في التحقق أو المعامل أو معاملة قاعدة البيانات وأعد تشغيل مسار الإنشاء والقراءة والتحديث نفسه مرتين ثم أعد تقديم دليل الاتصال المحجوب.Within one week, reset the supplied fixture, correct the first broken validation, parameter, or transaction boundary, rerun the same create/read/update path twice, and resubmit the redacted connection 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

استخدم صفوف الورشة المولدة المقدمة فقط. أبقِ بيانات الدخول وDATABASE_DSN ومخرجات الاتصال وأسماء المستخدمين وبيانات التسجيل الحقيقية خارج Git والأدلة.Use only the supplied generated workshop rows. Keep credentials, DATABASE_DSN, connection output, usernames, and real registration data outside Git and evidence.

الذكاء الاصطناعي المسؤولResponsible AI

يمكن للذكاء الاصطناعي مراجعة دالة قاعدة بيانات محجوبة واحدة بعد أن يتوقع المتعلم سلوكها. ولا يجوز أن ينشئ التحقق الكامل؛ وكل اقتراح مقبول يحتاج دليلاً محلياً من PostgreSQL والاختبارات.AI may review one redacted database function after the learner predicts its behaviour. It must not generate the complete checkpoint; every accepted suggestion requires local PostgreSQL and test evidence.

نص التسجيلRecording script

مدة التسجيل المخططة: 12 دقيقة · w6d1-recordingPlanned recording length: 12 minutes · w6d1-recording

السردNarration

  1. قدّم الاتصال دون كشف بيانات الدخول وسمِّ الدليل المخزن المتوقع واشرح التعليل دون كشف دوال التحقق المكتملة.Introduce connect without exposing credentials, name the expected stored evidence, and explain the reasoning without revealing completed checkpoint functions.

إجراءات الشاشةScreen actions

  1. اعرض Python وSQL بمسارات نسبية للمشروع وصفوف P-/S-/B- الاصطناعية ومخرج الواجهة المحجوب والاختبارات المركزة فقط؛ وأخفِ قيم البيئة وتفاصيل الاتصال.Show only project-relative Python and SQL, synthetic P-/S-/B- rows, redacted CLI output, and focused tests; hide environment values and connection details.

النصوص الظاهرةCaptions

  1. اكتب في الترجمة كل أمر وحد تحقق واستعلام ذي معاملات وقرار معاملة قاعدة بيانات ونتيجة مخزنة بالعربية أولاً ثم الإنجليزية.Caption each command, validation boundary, parameterised query, transaction decision, and stored result in Arabic first and English second.

نقاط التوقفPause points

  1. توقف قبل التنفيذ للتوقع وقبل حفظ الدليل لفحص بيانات الدخول والبيانات الحقيقية.Pause before execution for a prediction and before saving evidence for a credential and real-data scan.

قائمة التحقق من التسجيلRecording checklist

  1. تحقق من حزمة بداية الأسبوع السادس كما هي والعينة النظيفة وDATABASE_DSN المستبعد وأوامر الإنشاء والقراءة والتحديث فقط والمعاملات ومعاملات قاعدة البيانات المضبوطة ومساري الحالة غير الصالحة والمعرف المفقود والاختبارات القابلة للتكرار وعدم وجود بيانات دخول أو حل عام مكتمل ووضوح مسار الاستدراك.Confirm the exact Week 6 starter, clean fixture, ignored DATABASE_DSN, CRU-only commands, parameters, controlled transactions, invalid and missing paths, repeatable tests, no credentials, no completed public solution, and visible recovery route.

اليوم 2Day 2

اليوم 2 — الإنشاء والقراءة بمعاملاتDay 2 — parameterised create and read

التحضيرPreparation

  • اجتز تحقق الأسبوع الخامس للمخطط المُطبّع أو استخدم مسار الدعم المرتب.Pass the Week 5 normalised-schema checkpoint or use the arranged supported path.
  • افتح حزمة بداية الأسبوع السادس كما هي وحمّل عينة PostgreSQL النظيفة وأبقِ DATABASE_DSN في البيئة المحلية المستبعدة فقط.Open the exact Week 6 starter, load its clean PostgreSQL fixture, and keep DATABASE_DSN only in the ignored local environment.

المواد المطلوبة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.
  • حالات الإدخال الاصطناعية المقدمة فقط وعددها 4؛ دون بيانات مشاركين حقيقية.Only the 4 supplied synthetic input cases; no real participant data.

الأهدافObjectives

  • أنشئ حجزاً اصطناعياً واحداً واعرض الحجوزات المخزنة باستخدام SQL ذي معاملات وترتيب ثابت وصفوف مرجعة متحقق منها.Create one synthetic booking and list stored bookings with parameterised SQL, stable ordering, and checked returned rows.
  • اشرح الأمر والتحقق والاستعلام ومعاملة قاعدة البيانات والنتيجة المخزنة باستخدام معرفات اصطناعية وإعدادات محلية محجوبة فقط.Explain the command, validation, query, transaction, and stored result using only synthetic identifiers and redacted local settings.

جدول التنفيذ الدقيقExact run sheet

اليوم 2: اليوم 2 — الإنشاء والقراءة بمعاملاتDay 2: Day 2 — parameterised create and read
الفقرةBlockالدقائقMinutesالنمطModeإجراء المدرّبTrainer actionإجراء المتعلّمLearner action
فصل القيم عن SQLKeep values separate from SQL120تدريسInstructionتتبع الأمر والتحقق والاستعلام ذي المعاملات ومعاملة قاعدة البيانات والنتيجة باستخدام المعرفات الاصطناعية المقدمة، وقدّم المصطلحات الإنجليزية بعد الشرح العربي.Trace command, validation, parameterised query, transaction, and result with the supplied synthetic identifiers, introducing English terms after the Arabic explanation.توقع حالة قاعدة البيانات والنتيجة الظاهرة قبل تشغيل كل أمر Python.Predict the database state and visible result before running each Python command.
تدريب Python/PostgreSQL موجّهGuided Python/PostgreSQL practice60ممارسة موجّهةGuided practiceاعرض الحد الأول واجمع التوقعات ثم قلّل التلميحات بينما تستخدم الأزواج العينة المنشورة فقط.Model the first boundary, collect predictions, then fade prompts while pairs use only the published fixture.استبدل إدخالاً مبنياً بدمج النص بعلامات موضعية وتوقع الصف المرجع وقارنه بالحالة المخزنة.Replace one string-built insert with placeholders, predict the returned row, and compare it with stored state.
مختبر واجهة قاعدة البيانات بإشرافSupervised database CLI lab120مختبر خاضع للإشرافSupervised labراقب الكود الفردي والنتائج المخزنة، واطلب بقاء القيم منفصلة عن SQL، وأوقف دخول بيانات الدخول أو روابط الاتصال أو السجلات الحقيقية إلى السجلات أو Git.Observe individual code and stored results, require values to stay separate from SQL, and stop credentials, connection URLs, or real records from entering logs or Git.نفّذ create_booking وlist_bookings وأنشئ B-401 واعرض بترتيب ثابت وأثبت مطابقة الصف المرجع لـPostgreSQL.Implement create_booking and list_bookings, create B-401, list in stable order, and prove the returned row matches PostgreSQL.

ملاحظات الشرحExplanation notes

بنية SQL مع قيم منفصلةSQL structure plus separate values

أنشئ حجزاً اصطناعياً واحداً واعرض الحجوزات المخزنة باستخدام SQL ذي معاملات وترتيب ثابت وصفوف مرجعة متحقق منها.Create one synthetic booking and list stored bookings with parameterised SQL, stable ordering, and checked returned rows.

يتحقق كود قاعدة البيانات الموثوق من القيم قبل الوصول، ويمرر القيم كمعاملات للاستعلام، ويضبط التثبيت والتراجع، ويفحص الحالة المخزنة بدلاً من الثقة برسالة نجاح.Reliable database code validates values before access, passes values as query parameters, controls commit and rollback, and checks the stored state rather than trusting a success message.

أمثلة العرضDemonstration examples
INSERT ... VALUES (%s, %s, %s, %s) مع B-401/P-104/S-203/confirmed كمعاملاتINSERT ... VALUES (%s, %s, %s, %s) with B-401/P-104/S-203/confirmed as parameters

تسلسل الشرائح والعرضSlide and demonstration sequence

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

    • أنشئ حجزاً اصطناعياً واحداً واعرض الحجوزات المخزنة باستخدام SQL ذي معاملات وترتيب ثابت وصفوف مرجعة متحقق منها.Create one synthetic booking and list stored bookings with parameterised SQL, stable ordering, and checked returned rows.

    إشارة التقديمSpeaker cueاطلب من متعلم توقع قيمة الإرجاع والصف المخزن قبل التنفيذ.Ask a learner to predict both the return value and stored row before execution.

  2. فصل القيم عن SQLKeep values separate from SQL

    • INSERT ... VALUES (%s, %s, %s, %s) مع B-401/P-104/S-203/confirmed كمعاملاتINSERT ... VALUES (%s, %s, %s, %s) with B-401/P-104/S-203/confirmed as parameters

    إشارة التقديمSpeaker cueتتبع قيمة P-/S-/B- واحدة عبر التحقق والمعاملات ومعاملة قاعدة البيانات والنتيجة.Trace one P-/S-/B- value through validation, parameters, transaction, and result.

  3. الإعدادات المحلية والصفوف الاصطناعيةLocal settings and synthetic rows

    • أبقِ DATABASE_DSN في إعدادات محلية مستبعدة. اعرض الكود بمسارات نسبية للمشروع والمعرفات الاصطناعية والمخرجات المحجوبة فقط.Keep DATABASE_DSN in ignored local settings. Show only project-relative code, synthetic identifiers, and redacted output.

    إشارة التقديمSpeaker cueنفّذ فحص بيانات دخول القاعدة والبيانات الحقيقية قبل المختبر.Run the database credential and real-data scan before the lab.

تيسير الممارسة الموجّهةGuided-practice facilitation

  1. استبدل إدخالاً مبنياً بدمج النص بعلامات موضعية وتوقع الصف المرجع وقارنه بالحالة المخزنة.Replace one string-built insert with placeholders, predict the returned row, and compare it with stored state.

تيسير المختبرLab facilitation

  1. أعد العينة المقدمة واكتب قيمة الإرجاع والصفوف المخزنة المتوقعة قبل التنفيذ.Reset the supplied fixture and write the expected return value and stored rows before execution.
  2. نفّذ create_booking وlist_bookings وأنشئ B-401 واعرض بترتيب ثابت وأثبت مطابقة الصف المرجع لـPostgreSQL.Implement create_booking and list_bookings, create B-401, list in stable order, and prove the returned row matches PostgreSQL.
  3. شغّل الأمر أو الاختبار المركز مرتين وافحص الحالة المخزنة وأصلح أول حد منحرف في التحقق أو الاستعلام أو معاملة قاعدة البيانات فقط.Run the focused command or test twice, inspect stored state, and repair only the first divergent validation, query, or transaction boundary.
  4. احفظ الأوامر المحجوبة والمخرجات الاصطناعية ودليل الاختبار والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط.Save only redacted commands, synthetic output, test evidence, reasoning, and the AI-use or non-use note.

الأدلة المتوقعةExpected evidence

  • يثبت جدول المعاملات وصف B-401 المرجع والقائمة الثابتة ومقارنة الحالة المخزنة سلوك الإنشاء والقراءة الآمن.The parameter table, returned B-401 row, stable list, and stored-state comparison prove safe create and read behaviour.w6d2-create-read-evidence

معايير التحقق المنشورةPublished checkpoint criteria

مهمة التحقق المنشورةPublished checkpoint prompt

نفّذ واجهة سطر أوامر بلغة Python تنشئ سجلات PostgreSQL وتقرأها وتحدثها وتتحقق منها مع اختبارات.Implement a Python CLI that creates, reads, updates, and validates PostgreSQL records with tests.

  • تستخدم أوامر الإنشاء والقراءة والتحديث SQL ذا معاملات ومعاملات قاعدة بيانات مضبوطة.Create, read and update commands use parameterised SQL and controlled transactions.
  • تنتج القيم غير الصالحة والسجلات المفقودة نتائج واضحة دون إفساد البيانات.Invalid values and missing records produce clear results without corrupting data.
  • تنجح الاختبارات الآلية بصورة متكررة انطلاقاً من خطوات إعداد موثقة.Automated tests pass repeatedly from documented setup steps.

الأخطاء الشائعةCommon errors

  • تُدمج القيم في نص SQL بدلاً من تمريرها منفصلة كمعاملات.Values are joined into SQL text instead of passed separately as parameters.
  • يعلن البرنامج النجاح دون فحص الصف المرجع أو المخزن.The program reports success without checking the returned or stored row.
  • تعتمد الاختبارات على صفوف تركها تشغيل سابق وتفشل عند التكرار.Tests depend on rows left by an earlier run and fail when repeated.

تدخلات المدرّبTrainer interventions

  • ارجع إلى أربعة صناديق—الأمر والتحقق والاستعلام والنتيجة—وتتبع قيمة واحدة عبرها.Return to four boxes—command, validation, query, result—and trace one value across them.
  • أعد العينة وشغّل اختباراً ضيقاً واحداً وقارن حالة قاعدة البيانات قبل تغيير الكود.Reset the fixture, run one narrow test, and compare database state before changing code.

الاستدراكRecovery

خلال أسبوع واحد، أعد العينة المقدمة وصحح أول حد معطوب في التحقق أو المعامل أو معاملة قاعدة البيانات وأعد تشغيل مسار الإنشاء والقراءة والتحديث نفسه مرتين ثم أعد تقديم دليل الإنشاء والقراءة.Within one week, reset the supplied fixture, correct the first broken validation, parameter, or transaction boundary, rerun the same create/read/update path twice, and resubmit the create and read 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

استخدم صفوف الورشة المولدة المقدمة فقط. أبقِ بيانات الدخول وDATABASE_DSN ومخرجات الاتصال وأسماء المستخدمين وبيانات التسجيل الحقيقية خارج Git والأدلة.Use only the supplied generated workshop rows. Keep credentials, DATABASE_DSN, connection output, usernames, and real registration data outside Git and evidence.

الذكاء الاصطناعي المسؤولResponsible AI

يمكن للذكاء الاصطناعي مراجعة دالة قاعدة بيانات محجوبة واحدة بعد أن يتوقع المتعلم سلوكها. ولا يجوز أن ينشئ التحقق الكامل؛ وكل اقتراح مقبول يحتاج دليلاً محلياً من PostgreSQL والاختبارات.AI may review one redacted database function after the learner predicts its behaviour. It must not generate the complete checkpoint; every accepted suggestion requires local PostgreSQL and test evidence.

نص التسجيلRecording script

مدة التسجيل المخططة: 12 دقيقة · w6d2-recordingPlanned recording length: 12 minutes · w6d2-recording

السردNarration

  1. قدّم فصل القيم عن SQL وسمِّ الدليل المخزن المتوقع واشرح التعليل دون كشف دوال التحقق المكتملة.Introduce keep values separate from sql, name the expected stored evidence, and explain the reasoning without revealing completed checkpoint functions.

إجراءات الشاشةScreen actions

  1. اعرض Python وSQL بمسارات نسبية للمشروع وصفوف P-/S-/B- الاصطناعية ومخرج الواجهة المحجوب والاختبارات المركزة فقط؛ وأخفِ قيم البيئة وتفاصيل الاتصال.Show only project-relative Python and SQL, synthetic P-/S-/B- rows, redacted CLI output, and focused tests; hide environment values and connection details.

النصوص الظاهرةCaptions

  1. اكتب في الترجمة كل أمر وحد تحقق واستعلام ذي معاملات وقرار معاملة قاعدة بيانات ونتيجة مخزنة بالعربية أولاً ثم الإنجليزية.Caption each command, validation boundary, parameterised query, transaction decision, and stored result in Arabic first and English second.

نقاط التوقفPause points

  1. توقف قبل التنفيذ للتوقع وقبل حفظ الدليل لفحص بيانات الدخول والبيانات الحقيقية.Pause before execution for a prediction and before saving evidence for a credential and real-data scan.

قائمة التحقق من التسجيلRecording checklist

  1. تحقق من حزمة بداية الأسبوع السادس كما هي والعينة النظيفة وDATABASE_DSN المستبعد وأوامر الإنشاء والقراءة والتحديث فقط والمعاملات ومعاملات قاعدة البيانات المضبوطة ومساري الحالة غير الصالحة والمعرف المفقود والاختبارات القابلة للتكرار وعدم وجود بيانات دخول أو حل عام مكتمل ووضوح مسار الاستدراك.Confirm the exact Week 6 starter, clean fixture, ignored DATABASE_DSN, CRU-only commands, parameters, controlled transactions, invalid and missing paths, repeatable tests, no credentials, no completed public solution, and visible recovery route.

اليوم 3Day 3

اليوم 3 — التحديث والتحقق والسجلات المفقودةDay 3 — update, validation, and missing records

التحضيرPreparation

  • اجتز تحقق الأسبوع الخامس للمخطط المُطبّع أو استخدم مسار الدعم المرتب.Pass the Week 5 normalised-schema checkpoint or use the arranged supported path.
  • افتح حزمة بداية الأسبوع السادس كما هي وحمّل عينة PostgreSQL النظيفة وأبقِ DATABASE_DSN في البيئة المحلية المستبعدة فقط.Open the exact Week 6 starter, load its clean PostgreSQL fixture, and keep DATABASE_DSN only in the ignored local environment.

المواد المطلوبة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.
  • حالات الإدخال الاصطناعية المقدمة فقط وعددها 4؛ دون بيانات مشاركين حقيقية.Only the 4 supplied synthetic input cases; no real participant data.

الأهدافObjectives

  • تحقق من الحالة قبل الوصول وحدّث حجزاً واحداً في معاملة قاعدة بيانات مضبوطة وأعد نتيجة واضحة لعدم التطابق مع معرف مفقود.Validate status before access, update one booking in a controlled transaction, and return a clear no-match result for a missing identifier.
  • اشرح الأمر والتحقق والاستعلام ومعاملة قاعدة البيانات والنتيجة المخزنة باستخدام معرفات اصطناعية وإعدادات محلية محجوبة فقط.Explain the command, validation, query, transaction, and stored result using only synthetic identifiers and redacted local settings.

جدول التنفيذ الدقيقExact run sheet

اليوم 3: اليوم 3 — التحديث والتحقق والسجلات المفقودةDay 3: Day 3 — update, validation, and missing records
الفقرةBlockالدقائقMinutesالنمطModeإجراء المدرّبTrainer actionإجراء المتعلّمLearner action
الفشل بوضوح دون إفساد البياناتFail clearly without corrupting data120تدريسInstructionتتبع الأمر والتحقق والاستعلام ذي المعاملات ومعاملة قاعدة البيانات والنتيجة باستخدام المعرفات الاصطناعية المقدمة، وقدّم المصطلحات الإنجليزية بعد الشرح العربي.Trace command, validation, parameterised query, transaction, and result with the supplied synthetic identifiers, introducing English terms after the Arabic explanation.توقع حالة قاعدة البيانات والنتيجة الظاهرة قبل تشغيل كل أمر Python.Predict the database state and visible result before running each Python command.
تدريب Python/PostgreSQL موجّهGuided Python/PostgreSQL practice60ممارسة موجّهةGuided practiceاعرض الحد الأول واجمع التوقعات ثم قلّل التلميحات بينما تستخدم الأزواج العينة المنشورة فقط.Model the first boundary, collect predictions, then fade prompts while pairs use only the published fixture.رتب التحقق والاستعلام وفحص عدد الصفوف والتثبيت أو التراجع والنتيجة المرجعة للمسارات الثلاثة المنشورة.Order validation, query, row-count check, commit or rollback, and returned result for the three published paths.
مختبر واجهة قاعدة البيانات بإشرافSupervised database CLI lab120مختبر خاضع للإشرافSupervised labراقب الكود الفردي والنتائج المخزنة، واطلب بقاء القيم منفصلة عن SQL، وأوقف دخول بيانات الدخول أو روابط الاتصال أو السجلات الحقيقية إلى السجلات أو Git.Observe individual code and stored results, require values to stay separate from SQL, and stop credentials, connection URLs, or real records from entering logs or Git.نفّذ update_booking_status وأثبت تحديث B-302 ونتيجة عدم تطابق B-999 ورفض الحالة unknown دون تغيير الصفوف الأخرى.Implement update_booking_status, prove the B-302 update, the B-999 no-match result, and the unknown-status rejection without changing other rows.

ملاحظات الشرحExplanation notes

تحقق ثم حدّث ثم أثبتValidate, update, verify

تحقق من الحالة قبل الوصول وحدّث حجزاً واحداً في معاملة قاعدة بيانات مضبوطة وأعد نتيجة واضحة لعدم التطابق مع معرف مفقود.Validate status before access, update one booking in a controlled transaction, and return a clear no-match result for a missing identifier.

يتحقق كود قاعدة البيانات الموثوق من القيم قبل الوصول، ويمرر القيم كمعاملات للاستعلام، ويضبط التثبيت والتراجع، ويفحص الحالة المخزنة بدلاً من الثقة برسالة نجاح.Reliable database code validates values before access, passes values as query parameters, controls commit and rollback, and checks the stored state rather than trusting a success message.

أمثلة العرضDemonstration examples
B-302 من waitlisted إلى confirmed؛ B-999 بلا تطابق؛ unknown مرفوضة قبل SQLB-302 waitlisted → confirmed; B-999 → no match; unknown → rejected before SQL

تسلسل الشرائح والعرضSlide and demonstration sequence

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

    • تحقق من الحالة قبل الوصول وحدّث حجزاً واحداً في معاملة قاعدة بيانات مضبوطة وأعد نتيجة واضحة لعدم التطابق مع معرف مفقود.Validate status before access, update one booking in a controlled transaction, and return a clear no-match result for a missing identifier.

    إشارة التقديمSpeaker cueاطلب من متعلم توقع قيمة الإرجاع والصف المخزن قبل التنفيذ.Ask a learner to predict both the return value and stored row before execution.

  2. الفشل بوضوح دون إفساد البياناتFail clearly without corrupting data

    • B-302 من waitlisted إلى confirmed؛ B-999 بلا تطابق؛ unknown مرفوضة قبل SQLB-302 waitlisted → confirmed; B-999 → no match; unknown → rejected before SQL

    إشارة التقديمSpeaker cueتتبع قيمة P-/S-/B- واحدة عبر التحقق والمعاملات ومعاملة قاعدة البيانات والنتيجة.Trace one P-/S-/B- value through validation, parameters, transaction, and result.

  3. الإعدادات المحلية والصفوف الاصطناعيةLocal settings and synthetic rows

    • أبقِ DATABASE_DSN في إعدادات محلية مستبعدة. اعرض الكود بمسارات نسبية للمشروع والمعرفات الاصطناعية والمخرجات المحجوبة فقط.Keep DATABASE_DSN in ignored local settings. Show only project-relative code, synthetic identifiers, and redacted output.

    إشارة التقديمSpeaker cueنفّذ فحص بيانات دخول القاعدة والبيانات الحقيقية قبل المختبر.Run the database credential and real-data scan before the lab.

تيسير الممارسة الموجّهةGuided-practice facilitation

  1. رتب التحقق والاستعلام وفحص عدد الصفوف والتثبيت أو التراجع والنتيجة المرجعة للمسارات الثلاثة المنشورة.Order validation, query, row-count check, commit or rollback, and returned result for the three published paths.

تيسير المختبرLab facilitation

  1. أعد العينة المقدمة واكتب قيمة الإرجاع والصفوف المخزنة المتوقعة قبل التنفيذ.Reset the supplied fixture and write the expected return value and stored rows before execution.
  2. نفّذ update_booking_status وأثبت تحديث B-302 ونتيجة عدم تطابق B-999 ورفض الحالة unknown دون تغيير الصفوف الأخرى.Implement update_booking_status, prove the B-302 update, the B-999 no-match result, and the unknown-status rejection without changing other rows.
  3. شغّل الأمر أو الاختبار المركز مرتين وافحص الحالة المخزنة وأصلح أول حد منحرف في التحقق أو الاستعلام أو معاملة قاعدة البيانات فقط.Run the focused command or test twice, inspect stored state, and repair only the first divergent validation, query, or transaction boundary.
  4. احفظ الأوامر المحجوبة والمخرجات الاصطناعية ودليل الاختبار والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط.Save only redacted commands, synthetic output, test evidence, reasoning, and the AI-use or non-use note.

الأدلة المتوقعةExpected evidence

  • يثبت الصف قبل وبعد ونتيجتا الحالة unknown وB-999 المضبوطتان أن مسارات التحديث والفشل تحافظ على البيانات.The before/after row and controlled unknown-status and B-999 results prove update and failure paths preserve data.w6d3-update-failure-evidence

معايير التحقق المنشورةPublished checkpoint criteria

مهمة التحقق المنشورةPublished checkpoint prompt

نفّذ واجهة سطر أوامر بلغة Python تنشئ سجلات PostgreSQL وتقرأها وتحدثها وتتحقق منها مع اختبارات.Implement a Python CLI that creates, reads, updates, and validates PostgreSQL records with tests.

  • تستخدم أوامر الإنشاء والقراءة والتحديث SQL ذا معاملات ومعاملات قاعدة بيانات مضبوطة.Create, read and update commands use parameterised SQL and controlled transactions.
  • تنتج القيم غير الصالحة والسجلات المفقودة نتائج واضحة دون إفساد البيانات.Invalid values and missing records produce clear results without corrupting data.
  • تنجح الاختبارات الآلية بصورة متكررة انطلاقاً من خطوات إعداد موثقة.Automated tests pass repeatedly from documented setup steps.

الأخطاء الشائعةCommon errors

  • تُدمج القيم في نص SQL بدلاً من تمريرها منفصلة كمعاملات.Values are joined into SQL text instead of passed separately as parameters.
  • يعلن البرنامج النجاح دون فحص الصف المرجع أو المخزن.The program reports success without checking the returned or stored row.
  • تعتمد الاختبارات على صفوف تركها تشغيل سابق وتفشل عند التكرار.Tests depend on rows left by an earlier run and fail when repeated.

تدخلات المدرّبTrainer interventions

  • ارجع إلى أربعة صناديق—الأمر والتحقق والاستعلام والنتيجة—وتتبع قيمة واحدة عبرها.Return to four boxes—command, validation, query, result—and trace one value across them.
  • أعد العينة وشغّل اختباراً ضيقاً واحداً وقارن حالة قاعدة البيانات قبل تغيير الكود.Reset the fixture, run one narrow test, and compare database state before changing code.

الاستدراكRecovery

خلال أسبوع واحد، أعد العينة المقدمة وصحح أول حد معطوب في التحقق أو المعامل أو معاملة قاعدة البيانات وأعد تشغيل مسار الإنشاء والقراءة والتحديث نفسه مرتين ثم أعد تقديم دليل التحديث ومسارات الفشل.Within one week, reset the supplied fixture, correct the first broken validation, parameter, or transaction boundary, rerun the same create/read/update path twice, and resubmit the update and failure-path 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

استخدم صفوف الورشة المولدة المقدمة فقط. أبقِ بيانات الدخول وDATABASE_DSN ومخرجات الاتصال وأسماء المستخدمين وبيانات التسجيل الحقيقية خارج Git والأدلة.Use only the supplied generated workshop rows. Keep credentials, DATABASE_DSN, connection output, usernames, and real registration data outside Git and evidence.

الذكاء الاصطناعي المسؤولResponsible AI

يمكن للذكاء الاصطناعي مراجعة دالة قاعدة بيانات محجوبة واحدة بعد أن يتوقع المتعلم سلوكها. ولا يجوز أن ينشئ التحقق الكامل؛ وكل اقتراح مقبول يحتاج دليلاً محلياً من PostgreSQL والاختبارات.AI may review one redacted database function after the learner predicts its behaviour. It must not generate the complete checkpoint; every accepted suggestion requires local PostgreSQL and test evidence.

نص التسجيلRecording script

مدة التسجيل المخططة: 12 دقيقة · w6d3-recordingPlanned recording length: 12 minutes · w6d3-recording

السردNarration

  1. قدّم الفشل بوضوح دون إفساد البيانات وسمِّ الدليل المخزن المتوقع واشرح التعليل دون كشف دوال التحقق المكتملة.Introduce fail clearly without corrupting data, name the expected stored evidence, and explain the reasoning without revealing completed checkpoint functions.

إجراءات الشاشةScreen actions

  1. اعرض Python وSQL بمسارات نسبية للمشروع وصفوف P-/S-/B- الاصطناعية ومخرج الواجهة المحجوب والاختبارات المركزة فقط؛ وأخفِ قيم البيئة وتفاصيل الاتصال.Show only project-relative Python and SQL, synthetic P-/S-/B- rows, redacted CLI output, and focused tests; hide environment values and connection details.

النصوص الظاهرةCaptions

  1. اكتب في الترجمة كل أمر وحد تحقق واستعلام ذي معاملات وقرار معاملة قاعدة بيانات ونتيجة مخزنة بالعربية أولاً ثم الإنجليزية.Caption each command, validation boundary, parameterised query, transaction decision, and stored result in Arabic first and English second.

نقاط التوقفPause points

  1. توقف قبل التنفيذ للتوقع وقبل حفظ الدليل لفحص بيانات الدخول والبيانات الحقيقية.Pause before execution for a prediction and before saving evidence for a credential and real-data scan.

قائمة التحقق من التسجيلRecording checklist

  1. تحقق من حزمة بداية الأسبوع السادس كما هي والعينة النظيفة وDATABASE_DSN المستبعد وأوامر الإنشاء والقراءة والتحديث فقط والمعاملات ومعاملات قاعدة البيانات المضبوطة ومساري الحالة غير الصالحة والمعرف المفقود والاختبارات القابلة للتكرار وعدم وجود بيانات دخول أو حل عام مكتمل ووضوح مسار الاستدراك.Confirm the exact Week 6 starter, clean fixture, ignored DATABASE_DSN, CRU-only commands, parameters, controlled transactions, invalid and missing paths, repeatable tests, no credentials, no completed public solution, and visible recovery route.

اليوم 4Day 4

اليوم 4 — أوامر الواجهة والاختبارات القابلة للتكرارDay 4 — CLI commands and repeatable tests

التحضيرPreparation

  • اجتز تحقق الأسبوع الخامس للمخطط المُطبّع أو استخدم مسار الدعم المرتب.Pass the Week 5 normalised-schema checkpoint or use the arranged supported path.
  • افتح حزمة بداية الأسبوع السادس كما هي وحمّل عينة PostgreSQL النظيفة وأبقِ DATABASE_DSN في البيئة المحلية المستبعدة فقط.Open the exact Week 6 starter, load its clean PostgreSQL fixture, and keep DATABASE_DSN only in the ignored local environment.

المواد المطلوبة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.
  • حالات الإدخال الاصطناعية المقدمة فقط وعددها 4؛ دون بيانات مشاركين حقيقية.Only the 4 supplied synthetic input cases; no real participant data.

الأهدافObjectives

  • اربط أوامر create وlist وupdate بدوال صغيرة واختبر المسارات الصالحة وغير الصالحة والمفقودة والمتكررة على عينة نظيفة.Map create, list, and update commands to small functions and test valid, invalid, missing, and repeated clean-fixture paths.
  • اشرح الأمر والتحقق والاستعلام ومعاملة قاعدة البيانات والنتيجة المخزنة باستخدام معرفات اصطناعية وإعدادات محلية محجوبة فقط.Explain the command, validation, query, transaction, and stored result using only synthetic identifiers and redacted local settings.

جدول التنفيذ الدقيقExact run sheet

اليوم 4: اليوم 4 — أوامر الواجهة والاختبارات القابلة للتكرارDay 4: Day 4 — CLI commands and repeatable tests
الفقرةBlockالدقائقMinutesالنمطModeإجراء المدرّبTrainer actionإجراء المتعلّمLearner action
أمر واحد ودالة واحدة وعينة معروفةOne command, one function, known fixture120تدريسInstructionتتبع الأمر والتحقق والاستعلام ذي المعاملات ومعاملة قاعدة البيانات والنتيجة باستخدام المعرفات الاصطناعية المقدمة، وقدّم المصطلحات الإنجليزية بعد الشرح العربي.Trace command, validation, parameterised query, transaction, and result with the supplied synthetic identifiers, introducing English terms after the Arabic explanation.توقع حالة قاعدة البيانات والنتيجة الظاهرة قبل تشغيل كل أمر Python.Predict the database state and visible result before running each Python command.
تدريب Python/PostgreSQL موجّهGuided Python/PostgreSQL practice60ممارسة موجّهةGuided practiceاعرض الحد الأول واجمع التوقعات ثم قلّل التلميحات بينما تستخدم الأزواج العينة المنشورة فقط.Model the first boundary, collect predictions, then fade prompts while pairs use only the published fixture.اربط كل وسيط للواجهة بمدخل دالة متحقق منه وصمّم إعداد العينة وتنظيفها قبل كتابة التأكيدات.Map each CLI argument to one validated function input and design fixture setup and cleanup before writing assertions.
مختبر واجهة قاعدة البيانات بإشرافSupervised database CLI lab120مختبر خاضع للإشرافSupervised labراقب الكود الفردي والنتائج المخزنة، واطلب بقاء القيم منفصلة عن SQL، وأوقف دخول بيانات الدخول أو روابط الاتصال أو السجلات الحقيقية إلى السجلات أو Git.Observe individual code and stored results, require values to stay separate from SQL, and stop credentials, connection URLs, or real records from entering logs or Git.أكمل اختبارات قاعدة البيانات الثلاثة الناقصة وشغّلها مرتين من العينة الموثقة وقارن الصفوف الدقيقة بدلاً من نص النجاح.Complete the three missing database tests, run them twice from the documented fixture, and compare exact rows rather than success text.

ملاحظات الشرحExplanation notes

قابلية التكرار دليلRepeatability is evidence

اربط أوامر create وlist وupdate بدوال صغيرة واختبر المسارات الصالحة وغير الصالحة والمفقودة والمتكررة على عينة نظيفة.Map create, list, and update commands to small functions and test valid, invalid, missing, and repeated clean-fixture paths.

يتحقق كود قاعدة البيانات الموثوق من القيم قبل الوصول، ويمرر القيم كمعاملات للاستعلام، ويضبط التثبيت والتراجع، ويفحص الحالة المخزنة بدلاً من الثقة برسالة نجاح.Reliable database code validates values before access, passes values as query parameters, controls commit and rollback, and checks the stored state rather than trusting a success message.

أمثلة العرضDemonstration examples
إعادة ← 4 صفوف ← إنشاء B-401 ← 5 صفوف ← تحديث ← إعادة ← 4 صفوف أصليةreset → 4 rows → create B-401 → 5 rows → update → reset → original 4 rows

تسلسل الشرائح والعرضSlide and demonstration sequence

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

    • اربط أوامر create وlist وupdate بدوال صغيرة واختبر المسارات الصالحة وغير الصالحة والمفقودة والمتكررة على عينة نظيفة.Map create, list, and update commands to small functions and test valid, invalid, missing, and repeated clean-fixture paths.

    إشارة التقديمSpeaker cueاطلب من متعلم توقع قيمة الإرجاع والصف المخزن قبل التنفيذ.Ask a learner to predict both the return value and stored row before execution.

  2. أمر واحد ودالة واحدة وعينة معروفةOne command, one function, known fixture

    • إعادة ← 4 صفوف ← إنشاء B-401 ← 5 صفوف ← تحديث ← إعادة ← 4 صفوف أصليةreset → 4 rows → create B-401 → 5 rows → update → reset → original 4 rows

    إشارة التقديمSpeaker cueتتبع قيمة P-/S-/B- واحدة عبر التحقق والمعاملات ومعاملة قاعدة البيانات والنتيجة.Trace one P-/S-/B- value through validation, parameters, transaction, and result.

  3. الإعدادات المحلية والصفوف الاصطناعيةLocal settings and synthetic rows

    • أبقِ DATABASE_DSN في إعدادات محلية مستبعدة. اعرض الكود بمسارات نسبية للمشروع والمعرفات الاصطناعية والمخرجات المحجوبة فقط.Keep DATABASE_DSN in ignored local settings. Show only project-relative code, synthetic identifiers, and redacted output.

    إشارة التقديمSpeaker cueنفّذ فحص بيانات دخول القاعدة والبيانات الحقيقية قبل المختبر.Run the database credential and real-data scan before the lab.

تيسير الممارسة الموجّهةGuided-practice facilitation

  1. اربط كل وسيط للواجهة بمدخل دالة متحقق منه وصمّم إعداد العينة وتنظيفها قبل كتابة التأكيدات.Map each CLI argument to one validated function input and design fixture setup and cleanup before writing assertions.

تيسير المختبرLab facilitation

  1. أعد العينة المقدمة واكتب قيمة الإرجاع والصفوف المخزنة المتوقعة قبل التنفيذ.Reset the supplied fixture and write the expected return value and stored rows before execution.
  2. أكمل اختبارات قاعدة البيانات الثلاثة الناقصة وشغّلها مرتين من العينة الموثقة وقارن الصفوف الدقيقة بدلاً من نص النجاح.Complete the three missing database tests, run them twice from the documented fixture, and compare exact rows rather than success text.
  3. شغّل الأمر أو الاختبار المركز مرتين وافحص الحالة المخزنة وأصلح أول حد منحرف في التحقق أو الاستعلام أو معاملة قاعدة البيانات فقط.Run the focused command or test twice, inspect stored state, and repair only the first divergent validation, query, or transaction boundary.
  4. احفظ الأوامر المحجوبة والمخرجات الاصطناعية ودليل الاختبار والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط.Save only redacted commands, synthetic output, test evidence, reasoning, and the AI-use or non-use note.

الأدلة المتوقعةExpected evidence

  • تثبت خريطة الأوامر ودورة العينة النظيفة والتأكيدات الدقيقة وتشغيلا الاختبار المتطابقان قابلية التكرار.The command map, clean fixture lifecycle, exact assertions, and two identical test runs prove repeatability.w6d4-cli-tests-evidence

معايير التحقق المنشورةPublished checkpoint criteria

مهمة التحقق المنشورةPublished checkpoint prompt

نفّذ واجهة سطر أوامر بلغة Python تنشئ سجلات PostgreSQL وتقرأها وتحدثها وتتحقق منها مع اختبارات.Implement a Python CLI that creates, reads, updates, and validates PostgreSQL records with tests.

  • تستخدم أوامر الإنشاء والقراءة والتحديث SQL ذا معاملات ومعاملات قاعدة بيانات مضبوطة.Create, read and update commands use parameterised SQL and controlled transactions.
  • تنتج القيم غير الصالحة والسجلات المفقودة نتائج واضحة دون إفساد البيانات.Invalid values and missing records produce clear results without corrupting data.
  • تنجح الاختبارات الآلية بصورة متكررة انطلاقاً من خطوات إعداد موثقة.Automated tests pass repeatedly from documented setup steps.

الأخطاء الشائعةCommon errors

  • تُدمج القيم في نص SQL بدلاً من تمريرها منفصلة كمعاملات.Values are joined into SQL text instead of passed separately as parameters.
  • يعلن البرنامج النجاح دون فحص الصف المرجع أو المخزن.The program reports success without checking the returned or stored row.
  • تعتمد الاختبارات على صفوف تركها تشغيل سابق وتفشل عند التكرار.Tests depend on rows left by an earlier run and fail when repeated.

تدخلات المدرّبTrainer interventions

  • ارجع إلى أربعة صناديق—الأمر والتحقق والاستعلام والنتيجة—وتتبع قيمة واحدة عبرها.Return to four boxes—command, validation, query, result—and trace one value across them.
  • أعد العينة وشغّل اختباراً ضيقاً واحداً وقارن حالة قاعدة البيانات قبل تغيير الكود.Reset the fixture, run one narrow test, and compare database state before changing code.

الاستدراكRecovery

خلال أسبوع واحد، أعد العينة المقدمة وصحح أول حد معطوب في التحقق أو المعامل أو معاملة قاعدة البيانات وأعد تشغيل مسار الإنشاء والقراءة والتحديث نفسه مرتين ثم أعد تقديم دليل اختبارات الواجهة القابلة للتكرار.Within one week, reset the supplied fixture, correct the first broken validation, parameter, or transaction boundary, rerun the same create/read/update path twice, and resubmit the repeatable cli test 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

استخدم صفوف الورشة المولدة المقدمة فقط. أبقِ بيانات الدخول وDATABASE_DSN ومخرجات الاتصال وأسماء المستخدمين وبيانات التسجيل الحقيقية خارج Git والأدلة.Use only the supplied generated workshop rows. Keep credentials, DATABASE_DSN, connection output, usernames, and real registration data outside Git and evidence.

الذكاء الاصطناعي المسؤولResponsible AI

يمكن للذكاء الاصطناعي مراجعة دالة قاعدة بيانات محجوبة واحدة بعد أن يتوقع المتعلم سلوكها. ولا يجوز أن ينشئ التحقق الكامل؛ وكل اقتراح مقبول يحتاج دليلاً محلياً من PostgreSQL والاختبارات.AI may review one redacted database function after the learner predicts its behaviour. It must not generate the complete checkpoint; every accepted suggestion requires local PostgreSQL and test evidence.

نص التسجيلRecording script

مدة التسجيل المخططة: 12 دقيقة · w6d4-recordingPlanned recording length: 12 minutes · w6d4-recording

السردNarration

  1. قدّم أمر واحد ودالة واحدة وعينة معروفة وسمِّ الدليل المخزن المتوقع واشرح التعليل دون كشف دوال التحقق المكتملة.Introduce one command, one function, known fixture, name the expected stored evidence, and explain the reasoning without revealing completed checkpoint functions.

إجراءات الشاشةScreen actions

  1. اعرض Python وSQL بمسارات نسبية للمشروع وصفوف P-/S-/B- الاصطناعية ومخرج الواجهة المحجوب والاختبارات المركزة فقط؛ وأخفِ قيم البيئة وتفاصيل الاتصال.Show only project-relative Python and SQL, synthetic P-/S-/B- rows, redacted CLI output, and focused tests; hide environment values and connection details.

النصوص الظاهرةCaptions

  1. اكتب في الترجمة كل أمر وحد تحقق واستعلام ذي معاملات وقرار معاملة قاعدة بيانات ونتيجة مخزنة بالعربية أولاً ثم الإنجليزية.Caption each command, validation boundary, parameterised query, transaction decision, and stored result in Arabic first and English second.

نقاط التوقفPause points

  1. توقف قبل التنفيذ للتوقع وقبل حفظ الدليل لفحص بيانات الدخول والبيانات الحقيقية.Pause before execution for a prediction and before saving evidence for a credential and real-data scan.

قائمة التحقق من التسجيلRecording checklist

  1. تحقق من حزمة بداية الأسبوع السادس كما هي والعينة النظيفة وDATABASE_DSN المستبعد وأوامر الإنشاء والقراءة والتحديث فقط والمعاملات ومعاملات قاعدة البيانات المضبوطة ومساري الحالة غير الصالحة والمعرف المفقود والاختبارات القابلة للتكرار وعدم وجود بيانات دخول أو حل عام مكتمل ووضوح مسار الاستدراك.Confirm the exact Week 6 starter, clean fixture, ignored DATABASE_DSN, CRU-only commands, parameters, controlled transactions, invalid and missing paths, repeatable tests, no credentials, no completed public solution, and visible recovery route.

اليوم 5Day 5

اليوم 5 — التحقق الفردي لواجهة قاعدة البيانات المختبرةDay 5 — individual tested database CLI checkpoint

التحضيرPreparation

  • اجتز تحقق الأسبوع الخامس للمخطط المُطبّع أو استخدم مسار الدعم المرتب.Pass the Week 5 normalised-schema checkpoint or use the arranged supported path.
  • افتح حزمة بداية الأسبوع السادس كما هي وحمّل عينة PostgreSQL النظيفة وأبقِ DATABASE_DSN في البيئة المحلية المستبعدة فقط.Open the exact Week 6 starter, load its clean PostgreSQL fixture, and keep DATABASE_DSN only in the ignored local environment.

المواد المطلوبة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.
  • حالات الإدخال الاصطناعية المقدمة فقط وعددها 4؛ دون بيانات مشاركين حقيقية.Only the 4 supplied synthetic input cases; no real participant data.

الأهدافObjectives

  • نفّذ دوال قاعدة البيانات الأربع بصورة فردية واعرض الإنشاء والقراءة والتحديث فقط وتعامل مع المسارين غير الصالح والمفقود وأنجح اختبارات قابلة للتكرار واشرح اختيارات معاملة قاعدة البيانات.Individually implement the four database functions, demonstrate create/read/update only, handle invalid and missing paths, pass repeatable tests, and explain transaction choices.
  • اشرح الأمر والتحقق والاستعلام ومعاملة قاعدة البيانات والنتيجة المخزنة باستخدام معرفات اصطناعية وإعدادات محلية محجوبة فقط.Explain the command, validation, query, transaction, and stored result using only synthetic identifiers and redacted local settings.

جدول التنفيذ الدقيقExact run sheet

اليوم 5: اليوم 5 — التحقق الفردي لواجهة قاعدة البيانات المختبرةDay 5: Day 5 — individual tested database CLI checkpoint
الفقرةBlockالدقائقMinutesالنمطModeإجراء المدرّبTrainer actionإجراء المتعلّمLearner action
التحقق الفردي لواجهة قاعدة البيانات المختبرةIndividual tested database CLI checkpoint300مختبر خاضع للإشرافSupervised labوزّع حزمة البداية دون تغيير والعينة النظيفة، وراقب التنفيذ دون تزويد المتعلم بكود قاعدة البيانات، وتحقق من الإنشاء والقراءة والتحديث ومساري الفشل، ثم رتّب استدراكاً مركزاً عند الحاجة.Issue the unchanged starter and clean fixture, observe implementation without supplying database code, verify create/read/update and both failure paths, then arrange focused recovery when required.من حزمة البداية دون تغيير، أكمل دوال قاعدة البيانات واختباراتها وشغّل create/list/update مع المسارين غير الصالح والمفقود وأعد التشغيل من عينة نظيفة واشرح معاملاً ومعاملة قاعدة بيانات واحدة مباشرة.From the unchanged starter, complete the database functions and tests, run create/list/update plus invalid and missing paths, rerun from a clean fixture, and explain one parameter and transaction live.

ملاحظات الشرحExplanation notes

تثبت الحالة المخزنة انتقال التعلم الفرديStored state proves independent transfer

نفّذ دوال قاعدة البيانات الأربع بصورة فردية واعرض الإنشاء والقراءة والتحديث فقط وتعامل مع المسارين غير الصالح والمفقود وأنجح اختبارات قابلة للتكرار واشرح اختيارات معاملة قاعدة البيانات.Individually implement the four database functions, demonstrate create/read/update only, handle invalid and missing paths, pass repeatable tests, and explain transaction choices.

يتحقق كود قاعدة البيانات الموثوق من القيم قبل الوصول، ويمرر القيم كمعاملات للاستعلام، ويضبط التثبيت والتراجع، ويفحص الحالة المخزنة بدلاً من الثقة برسالة نجاح.Reliable database code validates values before access, passes values as query parameters, controls commit and rollback, and checks the stored state rather than trusting a success message.

أمثلة العرضDemonstration examples
إعداد مستبعد + 4 دوال مكتملة + سجل إنشاء/قراءة/تحديث + دليل غير صالح/مفقود + تشغيلان نظيفان للاختباراتignored setting + 4 completed functions + CRU transcript + invalid/missing evidence + two clean test runs

تسلسل الشرائح والعرضSlide and demonstration sequence

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

    • نفّذ دوال قاعدة البيانات الأربع بصورة فردية واعرض الإنشاء والقراءة والتحديث فقط وتعامل مع المسارين غير الصالح والمفقود وأنجح اختبارات قابلة للتكرار واشرح اختيارات معاملة قاعدة البيانات.Individually implement the four database functions, demonstrate create/read/update only, handle invalid and missing paths, pass repeatable tests, and explain transaction choices.

    إشارة التقديمSpeaker cueاطلب من متعلم توقع قيمة الإرجاع والصف المخزن قبل التنفيذ.Ask a learner to predict both the return value and stored row before execution.

  2. التنفيذ والتخزين والتحقق والشرح بصورة فرديةImplement, store, verify, and explain independently

    • إعداد مستبعد + 4 دوال مكتملة + سجل إنشاء/قراءة/تحديث + دليل غير صالح/مفقود + تشغيلان نظيفان للاختباراتignored setting + 4 completed functions + CRU transcript + invalid/missing evidence + two clean test runs

    إشارة التقديمSpeaker cueتتبع قيمة P-/S-/B- واحدة عبر التحقق والمعاملات ومعاملة قاعدة البيانات والنتيجة.Trace one P-/S-/B- value through validation, parameters, transaction, and result.

  3. الإعدادات المحلية والصفوف الاصطناعيةLocal settings and synthetic rows

    • أبقِ DATABASE_DSN في إعدادات محلية مستبعدة. اعرض الكود بمسارات نسبية للمشروع والمعرفات الاصطناعية والمخرجات المحجوبة فقط.Keep DATABASE_DSN in ignored local settings. Show only project-relative code, synthetic identifiers, and redacted output.

    إشارة التقديمSpeaker cueنفّذ فحص بيانات دخول القاعدة والبيانات الحقيقية قبل المختبر.Run the database credential and real-data scan before the lab.

تيسير الممارسة الموجّهةGuided-practice facilitation

  1. اقرأ المعيار وتوقع الحالات الأربع المنشورة وحدد الحذف ودليل بيانات الدخول المحظورين وخطط لإعادة العينة قبل البناء المحدد بالوقت.Read the rubric, predict all four published cases, identify forbidden delete and credential evidence, and plan fixture reset before the timed build.

تيسير المختبرLab facilitation

  1. أعد العينة المقدمة واكتب قيمة الإرجاع والصفوف المخزنة المتوقعة قبل التنفيذ.Reset the supplied fixture and write the expected return value and stored rows before execution.
  2. من حزمة البداية دون تغيير، أكمل دوال قاعدة البيانات واختباراتها وشغّل create/list/update مع المسارين غير الصالح والمفقود وأعد التشغيل من عينة نظيفة واشرح معاملاً ومعاملة قاعدة بيانات واحدة مباشرة.From the unchanged starter, complete the database functions and tests, run create/list/update plus invalid and missing paths, rerun from a clean fixture, and explain one parameter and transaction live.
  3. شغّل الأمر أو الاختبار المركز مرتين وافحص الحالة المخزنة وأصلح أول حد منحرف في التحقق أو الاستعلام أو معاملة قاعدة البيانات فقط.Run the focused command or test twice, inspect stored state, and repair only the first divergent validation, query, or transaction boundary.
  4. احفظ الأوامر المحجوبة والمخرجات الاصطناعية ودليل الاختبار والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط.Save only redacted commands, synthetic output, test evidence, reasoning, and the AI-use or non-use note.

الأدلة المتوقعةExpected evidence

  • يستوفي تنفيذ الدوال الأربع الفردي وسجل الإنشاء والقراءة والتحديث فقط والمعاملات ومعاملات قاعدة البيانات ومسارات الفشل والاختبارات المتكررة وفحص الخصوصية والشرح المباشر تحقق الأسبوع السادس.The individual four-function implementation, CRU-only transcript, parameters, transactions, failure paths, repeated tests, privacy scan, and live explanation satisfy the Week 6 checkpoint.w6d5-checkpoint-evidence

معايير التحقق المنشورةPublished checkpoint criteria

مهمة التحقق المنشورةPublished checkpoint prompt

نفّذ واجهة سطر أوامر بلغة Python تنشئ سجلات PostgreSQL وتقرأها وتحدثها وتتحقق منها مع اختبارات.Implement a Python CLI that creates, reads, updates, and validates PostgreSQL records with tests.

  • تستخدم أوامر الإنشاء والقراءة والتحديث SQL ذا معاملات ومعاملات قاعدة بيانات مضبوطة.Create, read and update commands use parameterised SQL and controlled transactions.
  • تنتج القيم غير الصالحة والسجلات المفقودة نتائج واضحة دون إفساد البيانات.Invalid values and missing records produce clear results without corrupting data.
  • تنجح الاختبارات الآلية بصورة متكررة انطلاقاً من خطوات إعداد موثقة.Automated tests pass repeatedly from documented setup steps.

الأخطاء الشائعةCommon errors

  • تُدمج القيم في نص SQL بدلاً من تمريرها منفصلة كمعاملات.Values are joined into SQL text instead of passed separately as parameters.
  • يعلن البرنامج النجاح دون فحص الصف المرجع أو المخزن.The program reports success without checking the returned or stored row.
  • تعتمد الاختبارات على صفوف تركها تشغيل سابق وتفشل عند التكرار.Tests depend on rows left by an earlier run and fail when repeated.

تدخلات المدرّبTrainer interventions

  • ارجع إلى أربعة صناديق—الأمر والتحقق والاستعلام والنتيجة—وتتبع قيمة واحدة عبرها.Return to four boxes—command, validation, query, result—and trace one value across them.
  • أعد العينة وشغّل اختباراً ضيقاً واحداً وقارن حالة قاعدة البيانات قبل تغيير الكود.Reset the fixture, run one narrow test, and compare database state before changing code.

الاستدراكRecovery

خلال أسبوع واحد، أعد العينة المقدمة وصحح أول حد معطوب في التحقق أو المعامل أو معاملة قاعدة البيانات وأعد تشغيل مسار الإنشاء والقراءة والتحديث نفسه مرتين ثم أعد تقديم دليل تحقق الأسبوع السادس الفردي.Within one week, reset the supplied fixture, correct the first broken validation, parameter, or transaction boundary, rerun the same create/read/update path twice, and resubmit the individual week 6 checkpoint 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

استخدم صفوف الورشة المولدة المقدمة فقط. أبقِ بيانات الدخول وDATABASE_DSN ومخرجات الاتصال وأسماء المستخدمين وبيانات التسجيل الحقيقية خارج Git والأدلة.Use only the supplied generated workshop rows. Keep credentials, DATABASE_DSN, connection output, usernames, and real registration data outside Git and evidence.

الذكاء الاصطناعي المسؤولResponsible AI

يمكن للذكاء الاصطناعي مراجعة دالة قاعدة بيانات محجوبة واحدة بعد أن يتوقع المتعلم سلوكها. ولا يجوز أن ينشئ التحقق الكامل؛ وكل اقتراح مقبول يحتاج دليلاً محلياً من PostgreSQL والاختبارات.AI may review one redacted database function after the learner predicts its behaviour. It must not generate the complete checkpoint; every accepted suggestion requires local PostgreSQL and test evidence.

نص التسجيلRecording script

مدة التسجيل المخططة: 18 دقيقة · w6d5-recordingPlanned recording length: 18 minutes · w6d5-recording

السردNarration

  1. قدّم التنفيذ والتخزين والتحقق والشرح بصورة فردية وسمِّ الدليل المخزن المتوقع واشرح التعليل دون كشف دوال التحقق المكتملة.Introduce implement, store, verify, and explain independently, name the expected stored evidence, and explain the reasoning without revealing completed checkpoint functions.

إجراءات الشاشةScreen actions

  1. اعرض Python وSQL بمسارات نسبية للمشروع وصفوف P-/S-/B- الاصطناعية ومخرج الواجهة المحجوب والاختبارات المركزة فقط؛ وأخفِ قيم البيئة وتفاصيل الاتصال.Show only project-relative Python and SQL, synthetic P-/S-/B- rows, redacted CLI output, and focused tests; hide environment values and connection details.

النصوص الظاهرةCaptions

  1. اكتب في الترجمة كل أمر وحد تحقق واستعلام ذي معاملات وقرار معاملة قاعدة بيانات ونتيجة مخزنة بالعربية أولاً ثم الإنجليزية.Caption each command, validation boundary, parameterised query, transaction decision, and stored result in Arabic first and English second.

نقاط التوقفPause points

  1. توقف قبل التنفيذ للتوقع وقبل حفظ الدليل لفحص بيانات الدخول والبيانات الحقيقية.Pause before execution for a prediction and before saving evidence for a credential and real-data scan.

قائمة التحقق من التسجيلRecording checklist

  1. تحقق من حزمة بداية الأسبوع السادس كما هي والعينة النظيفة وDATABASE_DSN المستبعد وأوامر الإنشاء والقراءة والتحديث فقط والمعاملات ومعاملات قاعدة البيانات المضبوطة ومساري الحالة غير الصالحة والمعرف المفقود والاختبارات القابلة للتكرار وعدم وجود بيانات دخول أو حل عام مكتمل ووضوح مسار الاستدراك.Confirm the exact Week 6 starter, clean fixture, ignored DATABASE_DSN, CRU-only commands, parameters, controlled transactions, invalid and missing paths, repeatable tests, no credentials, no completed public solution, and visible recovery route.