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

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

الأسبوع الثامن — حزمة المدرّبWeek 8 — 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 — Persistent contracts and safe setup

التحضيرPreparation

  • أكمل API الأسبوع السابع الموثقة والوصول المختبر للقاعدة من الأسبوع السادس أو مسار الدعم المتفق عليه.Complete the Week 7 documented API and Week 6 tested database access, or the agreed supported route.
  • استخدم Python 3.11 أو أحدث والاعتماديات المثبتة وPostgreSQL 16 أو أحدث وقاعدة foundation_week8_test المخصصة. تؤثر الإعادة المقدمة في foundation_week8.notices فقط وتتطلب تأكيداً صريحاً.Use Python 3.11+, pinned dependencies, PostgreSQL 16+ and the dedicated foundation_week8_test database. The provided reset affects only foundation_week8.notices and requires explicit confirmation.

المواد المطلوبةRequired materials

  • تسلسل الشرائح العام لهذه الجلسة (3 شرائح).Public slide sequence for this session (3 slides).
  • ورقة عمل المتعلم القابلة للطباعة للمهام المنشورة وعددها 1.Printable learner worksheet for the 1 published tasks.
  • نسخة دون اتصال من الجلسة وتسميات الأدلة والملفات العامة المعتمدة.An offline copy of the session, evidence labels, and approved public files.
  • حالات الإدخال الاصطناعية المقدمة فقط وعددها 5؛ دون بيانات مشاركين حقيقية.Only the 5 supplied synthetic input cases; no real participant data.

الأهدافObjectives

  • اربط خمس عمليات HTTP بـPostgreSQL مع الحفاظ على مخططات الأسبوع السابع وإعداد العينة الاصطناعية المخصصة.Map five HTTP operations to PostgreSQL while preserving Week 7 schemas and preparing the dedicated synthetic fixture.

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

اليوم 1: اليوم 1 — العقود الدائمة والإعداد الآمنDay 1: Day 1 — Persistent contracts and safe setup
الفقرةBlockالدقائقMinutesالنمطModeإجراء المدرّبTrainer actionإجراء المتعلّمLearner action
الربط من الطلب إلى الصفRequest-to-row mapping120تدريسInstructionاشرح بالعربية أولاً وتتبع التحقق والمسار وSQL ذات المعاملات والمعاملة والاستجابة بمثال خيالي مختلف.Explain in Arabic first; trace validation, route, parameterised SQL, transaction and response using a different fictional example.اربط خمس عمليات HTTP بـPostgreSQL مع الحفاظ على مخططات الأسبوع السابع وإعداد العينة الاصطناعية المخصصة.Map five HTTP operations to PostgreSQL while preserving Week 7 schemas and preparing the dedicated synthetic fixture.
تدريب موجّه من الطلب إلى الصفGuided request-to-row practice60ممارسة موجّهةGuided practiceاطلب توقع الرمز وحالة الصف ونتيجة المعاملة قبل التنفيذ وقلل التلميحات قبل العمل المستقل.Ask for predicted status, row state and transaction outcome before execution; reduce prompts before independent work.اشرح جدول نقاط النهاية بالحقول والرموز الثابتة وسلوك الحذف المضاف وفسر كل أثر للإعادة قبل تشغيلها.Annotate an endpoint table with the unchanged fields/statuses and the added delete behavior; explain every reset side effect before running it.
مختبر API الدائمة بإشرافSupervised persistent API lab120مختبر خاضع للإشرافSupervised labافحص الدليل الفردي ونطاق الإعادة الآمن واطلب PostgreSQL فعلية لإثبات التكامل واحجب الإعدادات ومخرجات القاعدة الخام.Inspect individual evidence and safe reset scope. Require real PostgreSQL for integration proof and redact settings and raw database output.اضبط البيئة المحلية المستبعدة وافحص المخطط والعينة المقدمين وشغّل الإعادة المؤكدة لقاعدة التدريب وأكمل endpoint-table.md. أبقِ بيانات الدخول وتفريغ القاعدة الخام خارج اللقطات.Configure the ignored local environment, inspect the supplied schema/seed, run the confirmed training reset, and complete endpoint-table.md. Keep credentials and raw database dumps out of captures.

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

تغيير التخزين مع الحفاظ على الحدودChange storage, preserve the boundary

يبقى عقد الإنشاء والعرض والجلب وتحديث النشر ثابتاً ويضاف الحذف بنجاح 204 فارغ. افصل نماذج الطلب وقرارات المسارات والوصول إلى البيانات. استخدم foundation_week8_test وجدول foundation_week8.notices فقط. يستبدل برنامج الإعادة المقدم صفوف هذا الجدول ويعيد تسلسله ولذلك يتطلب تأكيداً صريحاً.The create/list/get/publication-update contract is unchanged; deletion is added with empty 204 success. Separate request models, route decisions and data access. Use only foundation_week8_test and the foundation_week8.notices table. The provided reset replaces this table's rows and restarts its sequence, so it requires explicit confirmation.

أمثلة العرضDemonstration examples
خمس عمليات عبر ثلاث طبقات: مخطط الطلب ثم المسار ثم دالة القاعدة. الإعادة إعداد محلي وليست نقطة HTTP.Five operations → three layers: request schema → route → database function. Reset is local setup, never an HTTP endpoint.

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

  1. الربط من الطلب إلى الصفRequest-to-row mapping

    • اربط خمس عمليات HTTP بـPostgreSQL مع الحفاظ على مخططات الأسبوع السابع وإعداد العينة الاصطناعية المخصصة.Map five HTTP operations to PostgreSQL while preserving Week 7 schemas and preparing the dedicated synthetic fixture.

    إشارة التقديمSpeaker cueاسأل عن الطلب وحالة الصف القابلين للملاحظة اللذين يثبتان الهدف.Ask which observable request and row state prove the objective.

  2. تغيير التخزين مع الحفاظ على الحدودChange storage, preserve the boundary

    • خمس عمليات عبر ثلاث طبقات: مخطط الطلب ثم المسار ثم دالة القاعدة. الإعادة إعداد محلي وليست نقطة HTTP.Five operations → three layers: request schema → route → database function. Reset is local setup, never an HTTP endpoint.

    إشارة التقديمSpeaker cueتوقف للتوقع قبل تنفيذ أي شيء أو إعادته.Pause for a prediction before executing or resetting anything.

  3. عينة مضبوطة وإعدادات خاصةControlled fixture and private settings

    • خزّن الإعلانات الخيالية المقدمة فقط. أبقِ إعداد الاتصال وتفاصيل المشغل وتفريغ القاعدة الخام والهويات الحقيقية والرسائل الخاصة خارج اللقطات والسجلات والأدلة المشتركة واعرض حقول الاستجابة الاصطناعية المعتمدة فقط.Persist only the supplied fictional notice records. Keep connection settings, driver details, raw database dumps, real identities and private messages out of screenshots, logs and shared evidence; show only the approved synthetic response fields.

    إشارة التقديمSpeaker cueلا تعد العينة بين لقطات الدوام ولا تعرض إعداد الاتصال.Never reset between persistence captures; never show connection settings.

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

  1. اشرح جدول نقاط النهاية بالحقول والرموز الثابتة وسلوك الحذف المضاف وفسر كل أثر للإعادة قبل تشغيلها.Annotate an endpoint table with the unchanged fields/statuses and the added delete behavior; explain every reset side effect before running it.

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

  1. افحص العينة القابلة للإعادة وتوقع الرمز والاستجابة والحالة المخزنة قبل تشغيل العملية.Inspect the disposable fixture and predict status, response and stored state before running an operation.
  2. اضبط البيئة المحلية المستبعدة وافحص المخطط والعينة المقدمين وشغّل الإعادة المؤكدة لقاعدة التدريب وأكمل endpoint-table.md. أبقِ بيانات الدخول وتفريغ القاعدة الخام خارج اللقطات.Configure the ignored local environment, inspect the supplied schema/seed, run the confirmed training reset, and complete endpoint-table.md. Keep credentials and raw database dumps out of captures.
  3. تتبع أول حد مختلف وأصلحه وكرر من إعداد نظيف موثق. لا تعد العينة أثناء إثبات إعادة API.Trace the first differing boundary, repair it, and repeat from documented clean setup. Do not reset during the API restart proof.
  4. التقط الاستجابات الخيالية المعتمدة والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط وافحص حالة القاعدة الخام محلياً دون مشاركة تفريغها.Capture only approved fictional responses, reasoning and the AI-use or non-use note; inspect raw database state locally without sharing a dump.

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

  • قدّم عقد الصفوف الخمسة وربط المخطط والمسار وطبقة الوصول وقائمة إعداد آمن تشرح حارس اسم القاعدة والتأكيد.Submit the five-row contract, schema/route/repository mapping, and a safe setup checklist explaining the database-name and confirmation guards.w8d1-contract-evidence

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

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

اربط نقاط نهاية CRUD بـPostgreSQL وأثبت التخزين الدائم ومعالجة الإدخال غير الصالح وسلوك السجل المفقود والاختبارات الآلية.Connect CRUD endpoints to PostgreSQL and prove persistence, invalid-input handling, missing-record behaviour, and automated tests.

  • تقرأ نقاط CRUD من PostgreSQL وتكتب إليها ويبقى السجل المنشأ بعد إعادة التشغيل.CRUD endpoints read and write PostgreSQL and a created record survives restart.
  • يُرفض الإدخال غير الصالح قبل التخزين وتعيد المعرفات المفقودة استجابات مضبوطة.Invalid input is rejected before persistence and missing identifiers return controlled responses.
  • تغطي الاختبارات الآلية سلوكيات النجاح والفشل انطلاقاً من إعداد نظيف.Automated tests cover the success and failure behaviours from clean setup.

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

  • تعلن الاستجابة النجاح قبل التثبيت أو تعمل الإعادة بين لقطتي إثبات الدوام.A response says success before commit, or reset runs between the two persistence captures.
  • تتضمن SQL قيماً مدمجة أو تنفذ مسارات async عمليات حاجبة أو تتشارك الطلبات معاملة طويلة العمر.SQL includes interpolated values, async routes perform blocking calls, or requests share a long-lived transaction.
  • تحتوي استجابة 204 على JSON أو يتحول الصف المفقود إلى 503 أو يكشف استثناء القاعدة تفاصيل الاتصال.A 204 response contains JSON, a missing row becomes 503, or a database exception exposes connection details.

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

  • ارجع إلى جدول نقاط النهاية وافحص المخطط والمسار ودالة القاعدة منفصلة.Return to the endpoint table and inspect schema, route and database function separately.
  • افحص التثبيت والتراجع ونطاق العينة ثم اطلب عرض إعادة فعلية للسجل نفسه.Check commit/rollback and fixture scope, then require a real same-record restart demonstration.

الاستدراكRecovery

خلال أسبوع واحد اعزل حداً فاشلاً واحداً وكرر فحوص CRUD والإعادة والأعطال نفسها وأعد تقديم دليل عقد التخزين الدائم. إذا تعذرت PostgreSQL فرتب وصولاً مدعوماً للمختبر بدلاً من قبول دليل المحاكاة وحده.Within one week, isolate one failing boundary, repeat the same CRUD, restart and failure checks, and resubmit the persistence contract evidence. If PostgreSQL is unavailable, schedule supported lab access rather than accepting mock-only proof.

البديل عند الانقطاع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

خزّن الإعلانات الخيالية المقدمة فقط. أبقِ إعداد الاتصال وتفاصيل المشغل وتفريغ القاعدة الخام والهويات الحقيقية والرسائل الخاصة خارج اللقطات والسجلات والأدلة المشتركة واعرض حقول الاستجابة الاصطناعية المعتمدة فقط.Persist only the supplied fictional notice records. Keep connection settings, driver details, raw database dumps, real identities and private messages out of screenshots, logs and shared evidence; show only the approved synthetic response fields.

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

يمكن للذكاء الاصطناعي مراجعة اختبار فاشل بعد حجبه وإعادة إنتاجه. عليك فحص الحالة وتنفيذ الإصلاح وشرح كل اقتراح وتشغيل المجموعة كاملة ولا تطلب حل التحقق الكامل.AI may review a redacted failing test after you reproduce it. You must inspect state, implement the repair, explain each suggestion and run the complete suite; do not request the complete checkpoint solution.

نص التسجيلRecording script

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

السردNarration

  1. اشرح الربط من الطلب إلى الصف بمثال خيالي مختلف دون كود التحقق المكتمل.Explain Request-to-row mapping with a different fictional example, without completed checkpoint code.

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

  1. اعرض جدول نقاط النهاية والملفات النسبية والاستجابات الاصطناعية المعتمدة ونتائج الاختبار المحجوبة. أوقف وشغّل API فقط لإثبات الدوام وأبقِ الإعدادات وشاشات القاعدة الخام مخفية.Show the endpoint table, project-relative files, approved synthetic responses and redacted test results. Stop/start only the API for persistence; keep settings and raw database consoles hidden.

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

  1. اكتب معنى الطريقة والرمز والمعامل والتثبيت والتراجع والحالة المخزنة بالعربية أولاً ثم الإنجليزية.Caption method, status, parameter, commit/rollback and stored-state meaning in Arabic first, then English.

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

  1. توقف قبل كل طلب للتوقع وقبل كل إعادة للتحقق من النطاق والتأكيد.Pause before each request for a prediction and before any reset for scope and confirmation.

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

  1. تحقق من خمس عمليات وثلاثة نماذج ووصول ذي معاملات ودليل دوام للمعرف نفسه ومسارات غير الصالح والمفقود والفشل واختبارات مكررة وغياب بيانات الدخول ووضوح الاستدراك. يحتاج البديل دون اتصال PostgreSQL محلية مثبتة ولا تكمل المحاكاة وحدها دليل الدوام.Verify five operations, three models, parameterised access, durable same-id proof, invalid/missing/failure paths, repeated tests, no credentials and visible recovery. Offline fallback needs an installed local PostgreSQL instance; mocks alone do not complete persistence evidence.

اليوم 2Day 2

اليوم 2 — العمليات ذات المعاملات والمعاملات المضبوطةDay 2 — Parameterised operations and transactions

التحضيرPreparation

  • أكمل API الأسبوع السابع الموثقة والوصول المختبر للقاعدة من الأسبوع السادس أو مسار الدعم المتفق عليه.Complete the Week 7 documented API and Week 6 tested database access, or the agreed supported route.
  • استخدم Python 3.11 أو أحدث والاعتماديات المثبتة وPostgreSQL 16 أو أحدث وقاعدة foundation_week8_test المخصصة. تؤثر الإعادة المقدمة في foundation_week8.notices فقط وتتطلب تأكيداً صريحاً.Use Python 3.11+, pinned dependencies, PostgreSQL 16+ and the dedicated foundation_week8_test database. The provided reset affects only foundation_week8.notices and requires explicit confirmation.

المواد المطلوبةRequired materials

  • تسلسل الشرائح العام لهذه الجلسة (3 شرائح).Public slide sequence for this session (3 slides).
  • ورقة عمل المتعلم القابلة للطباعة للمهام المنشورة وعددها 1.Printable learner worksheet for the 1 published tasks.
  • نسخة دون اتصال من الجلسة وتسميات الأدلة والملفات العامة المعتمدة.An offline copy of the session, evidence labels, and approved public files.
  • حالات الإدخال الاصطناعية المقدمة فقط وعددها 5؛ دون بيانات مشاركين حقيقية.Only the 5 supplied synthetic input cases; no real participant data.

الأهدافObjectives

  • نفّذ الإنشاء والعرض والجلب وتحديث النشر والحذف بمعاملات منفصلة ومعرفات تولدها PostgreSQL وحدود معاملة مضبوطة.Implement parameterised create, list, get, publication-update and delete operations with PostgreSQL-generated ids and controlled transaction boundaries.

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

اليوم 2: اليوم 2 — العمليات ذات المعاملات والمعاملات المضبوطةDay 2: Day 2 — Parameterised operations and transactions
الفقرةBlockالدقائقMinutesالنمطModeإجراء المدرّبTrainer actionإجراء المتعلّمLearner action
خمس دوال للوصول إلى البياناتFive repository functions120تدريسInstructionاشرح بالعربية أولاً وتتبع التحقق والمسار وSQL ذات المعاملات والمعاملة والاستجابة بمثال خيالي مختلف.Explain in Arabic first; trace validation, route, parameterised SQL, transaction and response using a different fictional example.نفّذ الإنشاء والعرض والجلب وتحديث النشر والحذف بمعاملات منفصلة ومعرفات تولدها PostgreSQL وحدود معاملة مضبوطة.Implement parameterised create, list, get, publication-update and delete operations with PostgreSQL-generated ids and controlled transaction boundaries.
تدريب موجّه من الطلب إلى الصفGuided request-to-row practice60ممارسة موجّهةGuided practiceاطلب توقع الرمز وحالة الصف ونتيجة المعاملة قبل التنفيذ وقلل التلميحات قبل العمل المستقل.Ask for predicted status, row state and transaction outcome before execution; reduce prompts before independent work.تتبع قيمة خيالية عبر موضع معامل وقيمته وتوقع الصفوف المرئية قبل التثبيت وبعده وبعد التراجع.Trace one fictional value through a placeholder and parameter tuple; predict visible rows before commit, after commit and after rollback.
مختبر API الدائمة بإشرافSupervised persistent API lab120مختبر خاضع للإشرافSupervised labافحص الدليل الفردي ونطاق الإعادة الآمن واطلب PostgreSQL فعلية لإثبات التكامل واحجب الإعدادات ومخرجات القاعدة الخام.Inspect individual evidence and safe reset scope. Require real PostgreSQL for integration proof and redact settings and raw database output.أكمل دوال notice_repository.py الخمس. اختبر القراءة المرتبة والمعرفات المولدة وتحديث النشر فقط وحذف سجل واحد والنتائج المفقودة. أبقِ SQL خارج مخططات الطلب.Complete the five notice_repository.py functions. Test ordered reads, generated ids, publication-only updates, one-record deletion and missing results. Keep SQL out of request schemas.

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

لا تصبح الكتابة دائمة قبل التثبيتA write is not durable until committed

اربط القيم منفصلة عن SQL. تولد هوية PostgreSQL المعرفات ولا تعتمد max(id)+1. أعد id وtitle وbody وpublished فقط ورتب القائمة بالمعرف وتعامل مع غياب الصف كـNone أو false. استخدم سياق اتصال لتثبيت النجاح والتراجع عن الاستثناءات ثم أغلقه. قد يترك تخصيص تسلسل متراجع فجوة.Bind values separately from SQL. PostgreSQL identity generates identifiers; max(id)+1 is not the allocator. Return only id/title/body/published, order lists by id, and treat no matching row as None or false. Use a connection context to commit successful work and roll back exceptions, then close it. A rolled-back sequence allocation can leave a gap.

أمثلة العرضDemonstration examples
عينة أولية [1,2] ثم إنشاء مثبت بالمعرف 3 ثم يقرأ اتصال منفصل 3. يجب ألا تترك المعاملة الفاشلة صفاً جزئياً.Fresh fixture ids [1,2] → committed create id 3 → a separate connection can read 3. A failed transaction must not leave a partial row.

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

  1. خمس دوال للوصول إلى البياناتFive repository functions

    • نفّذ الإنشاء والعرض والجلب وتحديث النشر والحذف بمعاملات منفصلة ومعرفات تولدها PostgreSQL وحدود معاملة مضبوطة.Implement parameterised create, list, get, publication-update and delete operations with PostgreSQL-generated ids and controlled transaction boundaries.

    إشارة التقديمSpeaker cueاسأل عن الطلب وحالة الصف القابلين للملاحظة اللذين يثبتان الهدف.Ask which observable request and row state prove the objective.

  2. لا تصبح الكتابة دائمة قبل التثبيتA write is not durable until committed

    • عينة أولية [1,2] ثم إنشاء مثبت بالمعرف 3 ثم يقرأ اتصال منفصل 3. يجب ألا تترك المعاملة الفاشلة صفاً جزئياً.Fresh fixture ids [1,2] → committed create id 3 → a separate connection can read 3. A failed transaction must not leave a partial row.

    إشارة التقديمSpeaker cueتوقف للتوقع قبل تنفيذ أي شيء أو إعادته.Pause for a prediction before executing or resetting anything.

  3. عينة مضبوطة وإعدادات خاصةControlled fixture and private settings

    • خزّن الإعلانات الخيالية المقدمة فقط. أبقِ إعداد الاتصال وتفاصيل المشغل وتفريغ القاعدة الخام والهويات الحقيقية والرسائل الخاصة خارج اللقطات والسجلات والأدلة المشتركة واعرض حقول الاستجابة الاصطناعية المعتمدة فقط.Persist only the supplied fictional notice records. Keep connection settings, driver details, raw database dumps, real identities and private messages out of screenshots, logs and shared evidence; show only the approved synthetic response fields.

    إشارة التقديمSpeaker cueلا تعد العينة بين لقطات الدوام ولا تعرض إعداد الاتصال.Never reset between persistence captures; never show connection settings.

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

  1. تتبع قيمة خيالية عبر موضع معامل وقيمته وتوقع الصفوف المرئية قبل التثبيت وبعده وبعد التراجع.Trace one fictional value through a placeholder and parameter tuple; predict visible rows before commit, after commit and after rollback.

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

  1. افحص العينة القابلة للإعادة وتوقع الرمز والاستجابة والحالة المخزنة قبل تشغيل العملية.Inspect the disposable fixture and predict status, response and stored state before running an operation.
  2. أكمل دوال notice_repository.py الخمس. اختبر القراءة المرتبة والمعرفات المولدة وتحديث النشر فقط وحذف سجل واحد والنتائج المفقودة. أبقِ SQL خارج مخططات الطلب.Complete the five notice_repository.py functions. Test ordered reads, generated ids, publication-only updates, one-record deletion and missing results. Keep SQL out of request schemas.
  3. تتبع أول حد مختلف وأصلحه وكرر من إعداد نظيف موثق. لا تعد العينة أثناء إثبات إعادة API.Trace the first differing boundary, repair it, and repeat from documented clean setup. Do not reset during the API restart proof.
  4. التقط الاستجابات الخيالية المعتمدة والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط وافحص حالة القاعدة الخام محلياً دون مشاركة تفريغها.Capture only approved fictional responses, reasoning and the AI-use or non-use note; inspect raw database state locally without sharing a dump.

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

  • قدّم خريطة الدوال ومعاملات SQL وتعليل الحالة قبل المعاملة وبعدها ودليلاً على أن اتصالاً جديداً يرى الكتابات المثبتة لا الفاشلة.Submit a function/SQL-parameter map, before/after transaction reasoning and evidence that a fresh connection sees committed changes but no failed write.w8d2-repository-evidence

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

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

اربط نقاط نهاية CRUD بـPostgreSQL وأثبت التخزين الدائم ومعالجة الإدخال غير الصالح وسلوك السجل المفقود والاختبارات الآلية.Connect CRUD endpoints to PostgreSQL and prove persistence, invalid-input handling, missing-record behaviour, and automated tests.

  • تقرأ نقاط CRUD من PostgreSQL وتكتب إليها ويبقى السجل المنشأ بعد إعادة التشغيل.CRUD endpoints read and write PostgreSQL and a created record survives restart.
  • يُرفض الإدخال غير الصالح قبل التخزين وتعيد المعرفات المفقودة استجابات مضبوطة.Invalid input is rejected before persistence and missing identifiers return controlled responses.
  • تغطي الاختبارات الآلية سلوكيات النجاح والفشل انطلاقاً من إعداد نظيف.Automated tests cover the success and failure behaviours from clean setup.

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

  • تعلن الاستجابة النجاح قبل التثبيت أو تعمل الإعادة بين لقطتي إثبات الدوام.A response says success before commit, or reset runs between the two persistence captures.
  • تتضمن SQL قيماً مدمجة أو تنفذ مسارات async عمليات حاجبة أو تتشارك الطلبات معاملة طويلة العمر.SQL includes interpolated values, async routes perform blocking calls, or requests share a long-lived transaction.
  • تحتوي استجابة 204 على JSON أو يتحول الصف المفقود إلى 503 أو يكشف استثناء القاعدة تفاصيل الاتصال.A 204 response contains JSON, a missing row becomes 503, or a database exception exposes connection details.

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

  • ارجع إلى جدول نقاط النهاية وافحص المخطط والمسار ودالة القاعدة منفصلة.Return to the endpoint table and inspect schema, route and database function separately.
  • افحص التثبيت والتراجع ونطاق العينة ثم اطلب عرض إعادة فعلية للسجل نفسه.Check commit/rollback and fixture scope, then require a real same-record restart demonstration.

الاستدراكRecovery

خلال أسبوع واحد اعزل حداً فاشلاً واحداً وكرر فحوص CRUD والإعادة والأعطال نفسها وأعد تقديم دليل طبقة الوصول والمعاملات. إذا تعذرت PostgreSQL فرتب وصولاً مدعوماً للمختبر بدلاً من قبول دليل المحاكاة وحده.Within one week, isolate one failing boundary, repeat the same CRUD, restart and failure checks, and resubmit the repository and transaction evidence. If PostgreSQL is unavailable, schedule supported lab access rather than accepting mock-only proof.

البديل عند الانقطاع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

خزّن الإعلانات الخيالية المقدمة فقط. أبقِ إعداد الاتصال وتفاصيل المشغل وتفريغ القاعدة الخام والهويات الحقيقية والرسائل الخاصة خارج اللقطات والسجلات والأدلة المشتركة واعرض حقول الاستجابة الاصطناعية المعتمدة فقط.Persist only the supplied fictional notice records. Keep connection settings, driver details, raw database dumps, real identities and private messages out of screenshots, logs and shared evidence; show only the approved synthetic response fields.

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

يمكن للذكاء الاصطناعي مراجعة اختبار فاشل بعد حجبه وإعادة إنتاجه. عليك فحص الحالة وتنفيذ الإصلاح وشرح كل اقتراح وتشغيل المجموعة كاملة ولا تطلب حل التحقق الكامل.AI may review a redacted failing test after you reproduce it. You must inspect state, implement the repair, explain each suggestion and run the complete suite; do not request the complete checkpoint solution.

نص التسجيلRecording script

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

السردNarration

  1. اشرح خمس دوال للوصول إلى البيانات بمثال خيالي مختلف دون كود التحقق المكتمل.Explain Five repository functions with a different fictional example, without completed checkpoint code.

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

  1. اعرض جدول نقاط النهاية والملفات النسبية والاستجابات الاصطناعية المعتمدة ونتائج الاختبار المحجوبة. أوقف وشغّل API فقط لإثبات الدوام وأبقِ الإعدادات وشاشات القاعدة الخام مخفية.Show the endpoint table, project-relative files, approved synthetic responses and redacted test results. Stop/start only the API for persistence; keep settings and raw database consoles hidden.

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

  1. اكتب معنى الطريقة والرمز والمعامل والتثبيت والتراجع والحالة المخزنة بالعربية أولاً ثم الإنجليزية.Caption method, status, parameter, commit/rollback and stored-state meaning in Arabic first, then English.

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

  1. توقف قبل كل طلب للتوقع وقبل كل إعادة للتحقق من النطاق والتأكيد.Pause before each request for a prediction and before any reset for scope and confirmation.

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

  1. تحقق من خمس عمليات وثلاثة نماذج ووصول ذي معاملات ودليل دوام للمعرف نفسه ومسارات غير الصالح والمفقود والفشل واختبارات مكررة وغياب بيانات الدخول ووضوح الاستدراك. يحتاج البديل دون اتصال PostgreSQL محلية مثبتة ولا تكمل المحاكاة وحدها دليل الدوام.Verify five operations, three models, parameterised access, durable same-id proof, invalid/missing/failure paths, repeated tests, no credentials and visible recovery. Offline fallback needs an installed local PostgreSQL instance; mocks alone do not complete persistence evidence.

اليوم 3Day 3

اليوم 3 — مسارات CRUD والأعطال الآمنةDay 3 — CRUD routes and safe failures

التحضيرPreparation

  • أكمل API الأسبوع السابع الموثقة والوصول المختبر للقاعدة من الأسبوع السادس أو مسار الدعم المتفق عليه.Complete the Week 7 documented API and Week 6 tested database access, or the agreed supported route.
  • استخدم Python 3.11 أو أحدث والاعتماديات المثبتة وPostgreSQL 16 أو أحدث وقاعدة foundation_week8_test المخصصة. تؤثر الإعادة المقدمة في foundation_week8.notices فقط وتتطلب تأكيداً صريحاً.Use Python 3.11+, pinned dependencies, PostgreSQL 16+ and the dedicated foundation_week8_test database. The provided reset affects only foundation_week8.notices and requires explicit confirmation.

المواد المطلوبةRequired materials

  • تسلسل الشرائح العام لهذه الجلسة (3 شرائح).Public slide sequence for this session (3 slides).
  • ورقة عمل المتعلم القابلة للطباعة للمهام المنشورة وعددها 1.Printable learner worksheet for the 1 published tasks.
  • نسخة دون اتصال من الجلسة وتسميات الأدلة والملفات العامة المعتمدة.An offline copy of the session, evidence labels, and approved public files.
  • حالات الإدخال الاصطناعية المقدمة فقط وعددها 5؛ دون بيانات مشاركين حقيقية.Only the 5 supplied synthetic input cases; no real participant data.

الأهدافObjectives

  • اربط العمليات الخمس بطبقة الوصول واحفظ نماذج التحقق والاستجابة للأسبوع السابع وميّز المدخل غير الصالح والسجل المفقود وتعذر القاعدة.Wire five operations to the repository, preserve Week 7 validation/response models, and distinguish invalid, missing and unavailable-database outcomes.

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

اليوم 3: اليوم 3 — مسارات CRUD والأعطال الآمنةDay 3: Day 3 — CRUD routes and safe failures
الفقرةBlockالدقائقMinutesالنمطModeإجراء المدرّبTrainer actionإجراء المتعلّمLearner action
HTTP ثابت فوق PostgreSQLStable HTTP over PostgreSQL120تدريسInstructionاشرح بالعربية أولاً وتتبع التحقق والمسار وSQL ذات المعاملات والمعاملة والاستجابة بمثال خيالي مختلف.Explain in Arabic first; trace validation, route, parameterised SQL, transaction and response using a different fictional example.اربط العمليات الخمس بطبقة الوصول واحفظ نماذج التحقق والاستجابة للأسبوع السابع وميّز المدخل غير الصالح والسجل المفقود وتعذر القاعدة.Wire five operations to the repository, preserve Week 7 validation/response models, and distinguish invalid, missing and unavailable-database outcomes.
تدريب موجّه من الطلب إلى الصفGuided request-to-row practice60ممارسة موجّهةGuided practiceاطلب توقع الرمز وحالة الصف ونتيجة المعاملة قبل التنفيذ وقلل التلميحات قبل العمل المستقل.Ask for predicted status, row state and transaction outcome before execution; reduce prompts before independent work.تتبع الطلب عبر التحقق والمسار والمعاملة والاستجابة. قارن نص published غير الصالح بالمعرف 999 المفقود وبمحاكاة قاعدة غير متاحة.Trace a request through validation, route, transaction and response. Contrast invalid published text, missing id 999, and a simulated unavailable database.
مختبر API الدائمة بإشرافSupervised persistent API lab120مختبر خاضع للإشرافSupervised labافحص الدليل الفردي ونطاق الإعادة الآمن واطلب PostgreSQL فعلية لإثبات التكامل واحجب الإعدادات ومخرجات القاعدة الخام.Inspect individual evidence and safe reset scope. Require real PostgreSQL for integration proof and redact settings and raw database output.سجل المسارات الخمسة ونفذها. احفظ قيود الطول بعد إزالة الفراغات والنشر المنطقي الصارم ورفض الحقول الزائدة. وثق 201 و200 و204 و422 و404 و503 وأثبت أن الاستثناءات لا تكشف تفاصيل التخزين.Register and implement all five routes. Preserve stripped length limits, strict boolean publication and extra-field rejection. Document 201/200/204/422/404/503 and show that exceptions do not leak storage details.

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

ترجمة الأعطال عند الحد الصحيحTranslate failures at the correct boundary

تحقق قبل الكتابة: الجسم غير الصالح أو المعرف غير الموجب أو غير الصحيح يعطي 422. المعرف الصحيح الغائب يعطي 404 للجلب والتحديث والحذف. نجاح الحذف 204 بلا جسم. ترجم أعطال الاتصال والاستعلام إلى 503 عام دون نص المشغل أو إعداد الاتصال. مع Psycopg المتزامن استخدم مسارات def عادية وسياق اتصال منفصلاً لكل طلب.Validate before writes: invalid body or non-positive/non-integer id is 422. A valid absent id is 404 for get, update and delete. Successful delete is 204 with no body. Translate connection/query failures to a generic 503 without driver text or connection settings. With synchronous Psycopg, use normal def endpoints and a separate connection context per request.

أمثلة العرضDemonstration examples
PATCH 1 published=true يعطي 200 مع حفظ العنوان والجسم؛ DELETE 1 يعطي 204 فارغاً؛ GET 1 أو تكرار DELETE 1 يعطي 404.PATCH 1 published=true → 200 preserving title/body; DELETE 1 → empty 204; GET 1 or repeat DELETE 1 → 404.

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

  1. HTTP ثابت فوق PostgreSQLStable HTTP over PostgreSQL

    • اربط العمليات الخمس بطبقة الوصول واحفظ نماذج التحقق والاستجابة للأسبوع السابع وميّز المدخل غير الصالح والسجل المفقود وتعذر القاعدة.Wire five operations to the repository, preserve Week 7 validation/response models, and distinguish invalid, missing and unavailable-database outcomes.

    إشارة التقديمSpeaker cueاسأل عن الطلب وحالة الصف القابلين للملاحظة اللذين يثبتان الهدف.Ask which observable request and row state prove the objective.

  2. ترجمة الأعطال عند الحد الصحيحTranslate failures at the correct boundary

    • PATCH 1 published=true يعطي 200 مع حفظ العنوان والجسم؛ DELETE 1 يعطي 204 فارغاً؛ GET 1 أو تكرار DELETE 1 يعطي 404.PATCH 1 published=true → 200 preserving title/body; DELETE 1 → empty 204; GET 1 or repeat DELETE 1 → 404.

    إشارة التقديمSpeaker cueتوقف للتوقع قبل تنفيذ أي شيء أو إعادته.Pause for a prediction before executing or resetting anything.

  3. عينة مضبوطة وإعدادات خاصةControlled fixture and private settings

    • خزّن الإعلانات الخيالية المقدمة فقط. أبقِ إعداد الاتصال وتفاصيل المشغل وتفريغ القاعدة الخام والهويات الحقيقية والرسائل الخاصة خارج اللقطات والسجلات والأدلة المشتركة واعرض حقول الاستجابة الاصطناعية المعتمدة فقط.Persist only the supplied fictional notice records. Keep connection settings, driver details, raw database dumps, real identities and private messages out of screenshots, logs and shared evidence; show only the approved synthetic response fields.

    إشارة التقديمSpeaker cueلا تعد العينة بين لقطات الدوام ولا تعرض إعداد الاتصال.Never reset between persistence captures; never show connection settings.

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

  1. تتبع الطلب عبر التحقق والمسار والمعاملة والاستجابة. قارن نص published غير الصالح بالمعرف 999 المفقود وبمحاكاة قاعدة غير متاحة.Trace a request through validation, route, transaction and response. Contrast invalid published text, missing id 999, and a simulated unavailable database.

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

  1. افحص العينة القابلة للإعادة وتوقع الرمز والاستجابة والحالة المخزنة قبل تشغيل العملية.Inspect the disposable fixture and predict status, response and stored state before running an operation.
  2. سجل المسارات الخمسة ونفذها. احفظ قيود الطول بعد إزالة الفراغات والنشر المنطقي الصارم ورفض الحقول الزائدة. وثق 201 و200 و204 و422 و404 و503 وأثبت أن الاستثناءات لا تكشف تفاصيل التخزين.Register and implement all five routes. Preserve stripped length limits, strict boolean publication and extra-field rejection. Document 201/200/204/422/404/503 and show that exceptions do not leak storage details.
  3. تتبع أول حد مختلف وأصلحه وكرر من إعداد نظيف موثق. لا تعد العينة أثناء إثبات إعادة API.Trace the first differing boundary, repair it, and repeat from documented clean setup. Do not reset during the API restart proof.
  4. التقط الاستجابات الخيالية المعتمدة والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط وافحص حالة القاعدة الخام محلياً دون مشاركة تفريغها.Capture only approved fictional responses, reasoning and the AI-use or non-use note; inspect raw database state locally without sharing a dump.

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

  • قدّم خمس عمليات موثقة ولقطات CRUD الصالحة والجلب والتحديث والحذف المفقودة واستجابة آمنة لفشل القاعدة.Submit five documented operations, valid CRUD captures, missing GET/PATCH/DELETE captures and a sanitized database-failure response.w8d3-http-evidence

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

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

اربط نقاط نهاية CRUD بـPostgreSQL وأثبت التخزين الدائم ومعالجة الإدخال غير الصالح وسلوك السجل المفقود والاختبارات الآلية.Connect CRUD endpoints to PostgreSQL and prove persistence, invalid-input handling, missing-record behaviour, and automated tests.

  • تقرأ نقاط CRUD من PostgreSQL وتكتب إليها ويبقى السجل المنشأ بعد إعادة التشغيل.CRUD endpoints read and write PostgreSQL and a created record survives restart.
  • يُرفض الإدخال غير الصالح قبل التخزين وتعيد المعرفات المفقودة استجابات مضبوطة.Invalid input is rejected before persistence and missing identifiers return controlled responses.
  • تغطي الاختبارات الآلية سلوكيات النجاح والفشل انطلاقاً من إعداد نظيف.Automated tests cover the success and failure behaviours from clean setup.

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

  • تعلن الاستجابة النجاح قبل التثبيت أو تعمل الإعادة بين لقطتي إثبات الدوام.A response says success before commit, or reset runs between the two persistence captures.
  • تتضمن SQL قيماً مدمجة أو تنفذ مسارات async عمليات حاجبة أو تتشارك الطلبات معاملة طويلة العمر.SQL includes interpolated values, async routes perform blocking calls, or requests share a long-lived transaction.
  • تحتوي استجابة 204 على JSON أو يتحول الصف المفقود إلى 503 أو يكشف استثناء القاعدة تفاصيل الاتصال.A 204 response contains JSON, a missing row becomes 503, or a database exception exposes connection details.

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

  • ارجع إلى جدول نقاط النهاية وافحص المخطط والمسار ودالة القاعدة منفصلة.Return to the endpoint table and inspect schema, route and database function separately.
  • افحص التثبيت والتراجع ونطاق العينة ثم اطلب عرض إعادة فعلية للسجل نفسه.Check commit/rollback and fixture scope, then require a real same-record restart demonstration.

الاستدراكRecovery

خلال أسبوع واحد اعزل حداً فاشلاً واحداً وكرر فحوص CRUD والإعادة والأعطال نفسها وأعد تقديم دليل CRUD والأعطال. إذا تعذرت PostgreSQL فرتب وصولاً مدعوماً للمختبر بدلاً من قبول دليل المحاكاة وحده.Within one week, isolate one failing boundary, repeat the same CRUD, restart and failure checks, and resubmit the CRUD and failure evidence. If PostgreSQL is unavailable, schedule supported lab access rather than accepting mock-only proof.

البديل عند الانقطاع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

خزّن الإعلانات الخيالية المقدمة فقط. أبقِ إعداد الاتصال وتفاصيل المشغل وتفريغ القاعدة الخام والهويات الحقيقية والرسائل الخاصة خارج اللقطات والسجلات والأدلة المشتركة واعرض حقول الاستجابة الاصطناعية المعتمدة فقط.Persist only the supplied fictional notice records. Keep connection settings, driver details, raw database dumps, real identities and private messages out of screenshots, logs and shared evidence; show only the approved synthetic response fields.

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

يمكن للذكاء الاصطناعي مراجعة اختبار فاشل بعد حجبه وإعادة إنتاجه. عليك فحص الحالة وتنفيذ الإصلاح وشرح كل اقتراح وتشغيل المجموعة كاملة ولا تطلب حل التحقق الكامل.AI may review a redacted failing test after you reproduce it. You must inspect state, implement the repair, explain each suggestion and run the complete suite; do not request the complete checkpoint solution.

نص التسجيلRecording script

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

السردNarration

  1. اشرح HTTP ثابت فوق PostgreSQL بمثال خيالي مختلف دون كود التحقق المكتمل.Explain Stable HTTP over PostgreSQL with a different fictional example, without completed checkpoint code.

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

  1. اعرض جدول نقاط النهاية والملفات النسبية والاستجابات الاصطناعية المعتمدة ونتائج الاختبار المحجوبة. أوقف وشغّل API فقط لإثبات الدوام وأبقِ الإعدادات وشاشات القاعدة الخام مخفية.Show the endpoint table, project-relative files, approved synthetic responses and redacted test results. Stop/start only the API for persistence; keep settings and raw database consoles hidden.

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

  1. اكتب معنى الطريقة والرمز والمعامل والتثبيت والتراجع والحالة المخزنة بالعربية أولاً ثم الإنجليزية.Caption method, status, parameter, commit/rollback and stored-state meaning in Arabic first, then English.

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

  1. توقف قبل كل طلب للتوقع وقبل كل إعادة للتحقق من النطاق والتأكيد.Pause before each request for a prediction and before any reset for scope and confirmation.

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

  1. تحقق من خمس عمليات وثلاثة نماذج ووصول ذي معاملات ودليل دوام للمعرف نفسه ومسارات غير الصالح والمفقود والفشل واختبارات مكررة وغياب بيانات الدخول ووضوح الاستدراك. يحتاج البديل دون اتصال PostgreSQL محلية مثبتة ولا تكمل المحاكاة وحدها دليل الدوام.Verify five operations, three models, parameterised access, durable same-id proof, invalid/missing/failure paths, repeated tests, no credentials and visible recovery. Offline fallback needs an installed local PostgreSQL instance; mocks alone do not complete persistence evidence.

اليوم 4Day 4

اليوم 4 — اختبارات التكامل وإثبات إعادة التشغيلDay 4 — Integration tests and restart proof

التحضيرPreparation

  • أكمل API الأسبوع السابع الموثقة والوصول المختبر للقاعدة من الأسبوع السادس أو مسار الدعم المتفق عليه.Complete the Week 7 documented API and Week 6 tested database access, or the agreed supported route.
  • استخدم Python 3.11 أو أحدث والاعتماديات المثبتة وPostgreSQL 16 أو أحدث وقاعدة foundation_week8_test المخصصة. تؤثر الإعادة المقدمة في foundation_week8.notices فقط وتتطلب تأكيداً صريحاً.Use Python 3.11+, pinned dependencies, PostgreSQL 16+ and the dedicated foundation_week8_test database. The provided reset affects only foundation_week8.notices and requires explicit confirmation.

المواد المطلوبةRequired materials

  • تسلسل الشرائح العام لهذه الجلسة (3 شرائح).Public slide sequence for this session (3 slides).
  • ورقة عمل المتعلم القابلة للطباعة للمهام المنشورة وعددها 1.Printable learner worksheet for the 1 published tasks.
  • نسخة دون اتصال من الجلسة وتسميات الأدلة والملفات العامة المعتمدة.An offline copy of the session, evidence labels, and approved public files.
  • حالات الإدخال الاصطناعية المقدمة فقط وعددها 5؛ دون بيانات مشاركين حقيقية.Only the 5 supplied synthetic input cases; no real participant data.

الأهدافObjectives

  • شغّل اختبارات قابلة للتكرار تعتمد PostgreSQL وأثبت بقاء السجل المنشأ نفسه بعد إعادة API فقط دون إعادة العينة بين اللقطات.Run repeatable PostgreSQL-backed tests and prove the same created record survives restarting only the API, without reseeding between captures.

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

اليوم 4: اليوم 4 — اختبارات التكامل وإثبات إعادة التشغيلDay 4: Day 4 — Integration tests and restart proof
الفقرةBlockالدقائقMinutesالنمطModeإجراء المدرّبTrainer actionإجراء المتعلّمLearner action
إثبات التخزين الدائم الفعليProve real persistence120تدريسInstructionاشرح بالعربية أولاً وتتبع التحقق والمسار وSQL ذات المعاملات والمعاملة والاستجابة بمثال خيالي مختلف.Explain in Arabic first; trace validation, route, parameterised SQL, transaction and response using a different fictional example.شغّل اختبارات قابلة للتكرار تعتمد PostgreSQL وأثبت بقاء السجل المنشأ نفسه بعد إعادة API فقط دون إعادة العينة بين اللقطات.Run repeatable PostgreSQL-backed tests and prove the same created record survives restarting only the API, without reseeding between captures.
تدريب موجّه من الطلب إلى الصفGuided request-to-row practice60ممارسة موجّهةGuided practiceاطلب توقع الرمز وحالة الصف ونتيجة المعاملة قبل التنفيذ وقلل التلميحات قبل العمل المستقل.Ask for predicted status, row state and transaction outcome before execution; reduce prompts before independent work.صمم اختبارات مستقلة لـCRUD والعنوان الفارغ ونوع النشر الخاطئ والصفوف المفقودة والتراجع وحدد الدليل الذي يحتاج اتصال PostgreSQL فعلياً.Design independent tests for valid CRUD, blank title, wrong published type, missing rows and rollback. Identify which evidence needs a real PostgreSQL connection.
مختبر API الدائمة بإشرافSupervised persistent API lab120مختبر خاضع للإشرافSupervised labافحص الدليل الفردي ونطاق الإعادة الآمن واطلب PostgreSQL فعلية لإثبات التكامل واحجب الإعدادات ومخرجات القاعدة الخام.Inspect individual evidence and safe reset scope. Require real PostgreSQL for integration proof and redact settings and raw database output.أكمل مطالب الاختبار الأربعة. قارن حالة الصفوف محلياً قبل المدخل المرفوض وبعده وأثبت الدوام بعد الإعادة وحاكِ خطأ التخزين بأمان وشغّل مرتين من إعداد نظيف دون نشر تفريغ القاعدة الخام.Complete all four test prompts. Compare row state locally before and after rejected input, prove restart persistence, simulate a storage error safely, and run twice from clean setup without publishing raw database dumps.

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

الإعادة بين الاختبارات لا داخل إثبات الدوامReset between tests, not inside the persistence proof

أعد العينة المعروفة للاختبارات المستقلة ثم أنشئ سجلاً وثبته. أعد عملية API فقط مع إبقاء PostgreSQL وصفوفها دون تغيير واسترجع المعرف والحقول نفسها. لا يثبت TestClient جديد فوق العملية نفسها إعادة الخادم. استخدم عملية منفصلة أو إيقافاً وتشغيلاً فعليين. تكمل محاكاة الأعطال التكامل الحقيقي ولا تستبدله.Restore the known fixture for independent tests, then create and commit a new record. Restart only the API process while leaving PostgreSQL and its rows untouched; retrieve the same id and fields. A new TestClient over an unchanged process is not a server-restart proof. Use a separate process or an actual stop/start. Mock failures supplement, but never replace, real database integration.

أمثلة العرضDemonstration examples
إعادة العينة ثم إنشاء 3 ثم التقاط الاستجابة ثم إيقاف وتشغيل API فقط ثم تطابق GET 3. إعادة العينة في الوسط تبطل الدليل.Reset → create id 3 → capture response → stop/start API only → GET 3 matches. Resetting the fixture in the middle invalidates that proof.

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

  1. إثبات التخزين الدائم الفعليProve real persistence

    • شغّل اختبارات قابلة للتكرار تعتمد PostgreSQL وأثبت بقاء السجل المنشأ نفسه بعد إعادة API فقط دون إعادة العينة بين اللقطات.Run repeatable PostgreSQL-backed tests and prove the same created record survives restarting only the API, without reseeding between captures.

    إشارة التقديمSpeaker cueاسأل عن الطلب وحالة الصف القابلين للملاحظة اللذين يثبتان الهدف.Ask which observable request and row state prove the objective.

  2. الإعادة بين الاختبارات لا داخل إثبات الدوامReset between tests, not inside the persistence proof

    • إعادة العينة ثم إنشاء 3 ثم التقاط الاستجابة ثم إيقاف وتشغيل API فقط ثم تطابق GET 3. إعادة العينة في الوسط تبطل الدليل.Reset → create id 3 → capture response → stop/start API only → GET 3 matches. Resetting the fixture in the middle invalidates that proof.

    إشارة التقديمSpeaker cueتوقف للتوقع قبل تنفيذ أي شيء أو إعادته.Pause for a prediction before executing or resetting anything.

  3. عينة مضبوطة وإعدادات خاصةControlled fixture and private settings

    • خزّن الإعلانات الخيالية المقدمة فقط. أبقِ إعداد الاتصال وتفاصيل المشغل وتفريغ القاعدة الخام والهويات الحقيقية والرسائل الخاصة خارج اللقطات والسجلات والأدلة المشتركة واعرض حقول الاستجابة الاصطناعية المعتمدة فقط.Persist only the supplied fictional notice records. Keep connection settings, driver details, raw database dumps, real identities and private messages out of screenshots, logs and shared evidence; show only the approved synthetic response fields.

    إشارة التقديمSpeaker cueلا تعد العينة بين لقطات الدوام ولا تعرض إعداد الاتصال.Never reset between persistence captures; never show connection settings.

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

  1. صمم اختبارات مستقلة لـCRUD والعنوان الفارغ ونوع النشر الخاطئ والصفوف المفقودة والتراجع وحدد الدليل الذي يحتاج اتصال PostgreSQL فعلياً.Design independent tests for valid CRUD, blank title, wrong published type, missing rows and rollback. Identify which evidence needs a real PostgreSQL connection.

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

  1. افحص العينة القابلة للإعادة وتوقع الرمز والاستجابة والحالة المخزنة قبل تشغيل العملية.Inspect the disposable fixture and predict status, response and stored state before running an operation.
  2. أكمل مطالب الاختبار الأربعة. قارن حالة الصفوف محلياً قبل المدخل المرفوض وبعده وأثبت الدوام بعد الإعادة وحاكِ خطأ التخزين بأمان وشغّل مرتين من إعداد نظيف دون نشر تفريغ القاعدة الخام.Complete all four test prompts. Compare row state locally before and after rejected input, prove restart persistence, simulate a storage error safely, and run twice from clean setup without publishing raw database dumps.
  3. تتبع أول حد مختلف وأصلحه وكرر من إعداد نظيف موثق. لا تعد العينة أثناء إثبات إعادة API.Trace the first differing boundary, repair it, and repeat from documented clean setup. Do not reset during the API restart proof.
  4. التقط الاستجابات الخيالية المعتمدة والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط وافحص حالة القاعدة الخام محلياً دون مشاركة تفريغها.Capture only approved fictional responses, reasoning and the AI-use or non-use note; inspect raw database state locally without sharing a dump.

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

  • قدّم تشغيلين ناجحين لاختبارات التكامل وسجل إعادة التشغيل للسجل نفسه وفحوص ثبات الحالة للمدخل المرفوض وشرح الفشل والتراجع بعد الحجب.Submit two passing integration-test runs, a same-record restart transcript, unchanged-state checks for rejected input, and a redacted failure/rollback explanation.w8d4-persistence-evidence

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

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

اربط نقاط نهاية CRUD بـPostgreSQL وأثبت التخزين الدائم ومعالجة الإدخال غير الصالح وسلوك السجل المفقود والاختبارات الآلية.Connect CRUD endpoints to PostgreSQL and prove persistence, invalid-input handling, missing-record behaviour, and automated tests.

  • تقرأ نقاط CRUD من PostgreSQL وتكتب إليها ويبقى السجل المنشأ بعد إعادة التشغيل.CRUD endpoints read and write PostgreSQL and a created record survives restart.
  • يُرفض الإدخال غير الصالح قبل التخزين وتعيد المعرفات المفقودة استجابات مضبوطة.Invalid input is rejected before persistence and missing identifiers return controlled responses.
  • تغطي الاختبارات الآلية سلوكيات النجاح والفشل انطلاقاً من إعداد نظيف.Automated tests cover the success and failure behaviours from clean setup.

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

  • تعلن الاستجابة النجاح قبل التثبيت أو تعمل الإعادة بين لقطتي إثبات الدوام.A response says success before commit, or reset runs between the two persistence captures.
  • تتضمن SQL قيماً مدمجة أو تنفذ مسارات async عمليات حاجبة أو تتشارك الطلبات معاملة طويلة العمر.SQL includes interpolated values, async routes perform blocking calls, or requests share a long-lived transaction.
  • تحتوي استجابة 204 على JSON أو يتحول الصف المفقود إلى 503 أو يكشف استثناء القاعدة تفاصيل الاتصال.A 204 response contains JSON, a missing row becomes 503, or a database exception exposes connection details.

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

  • ارجع إلى جدول نقاط النهاية وافحص المخطط والمسار ودالة القاعدة منفصلة.Return to the endpoint table and inspect schema, route and database function separately.
  • افحص التثبيت والتراجع ونطاق العينة ثم اطلب عرض إعادة فعلية للسجل نفسه.Check commit/rollback and fixture scope, then require a real same-record restart demonstration.

الاستدراكRecovery

خلال أسبوع واحد اعزل حداً فاشلاً واحداً وكرر فحوص CRUD والإعادة والأعطال نفسها وأعد تقديم دليل الدوام واختبار التكامل. إذا تعذرت PostgreSQL فرتب وصولاً مدعوماً للمختبر بدلاً من قبول دليل المحاكاة وحده.Within one week, isolate one failing boundary, repeat the same CRUD, restart and failure checks, and resubmit the persistence and integration-test evidence. If PostgreSQL is unavailable, schedule supported lab access rather than accepting mock-only proof.

البديل عند الانقطاع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

خزّن الإعلانات الخيالية المقدمة فقط. أبقِ إعداد الاتصال وتفاصيل المشغل وتفريغ القاعدة الخام والهويات الحقيقية والرسائل الخاصة خارج اللقطات والسجلات والأدلة المشتركة واعرض حقول الاستجابة الاصطناعية المعتمدة فقط.Persist only the supplied fictional notice records. Keep connection settings, driver details, raw database dumps, real identities and private messages out of screenshots, logs and shared evidence; show only the approved synthetic response fields.

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

يمكن للذكاء الاصطناعي مراجعة اختبار فاشل بعد حجبه وإعادة إنتاجه. عليك فحص الحالة وتنفيذ الإصلاح وشرح كل اقتراح وتشغيل المجموعة كاملة ولا تطلب حل التحقق الكامل.AI may review a redacted failing test after you reproduce it. You must inspect state, implement the repair, explain each suggestion and run the complete suite; do not request the complete checkpoint solution.

نص التسجيلRecording script

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

السردNarration

  1. اشرح إثبات التخزين الدائم الفعلي بمثال خيالي مختلف دون كود التحقق المكتمل.Explain Prove real persistence with a different fictional example, without completed checkpoint code.

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

  1. اعرض جدول نقاط النهاية والملفات النسبية والاستجابات الاصطناعية المعتمدة ونتائج الاختبار المحجوبة. أوقف وشغّل API فقط لإثبات الدوام وأبقِ الإعدادات وشاشات القاعدة الخام مخفية.Show the endpoint table, project-relative files, approved synthetic responses and redacted test results. Stop/start only the API for persistence; keep settings and raw database consoles hidden.

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

  1. اكتب معنى الطريقة والرمز والمعامل والتثبيت والتراجع والحالة المخزنة بالعربية أولاً ثم الإنجليزية.Caption method, status, parameter, commit/rollback and stored-state meaning in Arabic first, then English.

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

  1. توقف قبل كل طلب للتوقع وقبل كل إعادة للتحقق من النطاق والتأكيد.Pause before each request for a prediction and before any reset for scope and confirmation.

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

  1. تحقق من خمس عمليات وثلاثة نماذج ووصول ذي معاملات ودليل دوام للمعرف نفسه ومسارات غير الصالح والمفقود والفشل واختبارات مكررة وغياب بيانات الدخول ووضوح الاستدراك. يحتاج البديل دون اتصال PostgreSQL محلية مثبتة ولا تكمل المحاكاة وحدها دليل الدوام.Verify five operations, three models, parameterised access, durable same-id proof, invalid/missing/failure paths, repeated tests, no credentials and visible recovery. Offline fallback needs an installed local PostgreSQL instance; mocks alone do not complete persistence evidence.

اليوم 5Day 5

اليوم 5 — التحقق الفردي لـAPI دائمةDay 5 — Individual persistent API checkpoint

التحضيرPreparation

  • أكمل API الأسبوع السابع الموثقة والوصول المختبر للقاعدة من الأسبوع السادس أو مسار الدعم المتفق عليه.Complete the Week 7 documented API and Week 6 tested database access, or the agreed supported route.
  • استخدم Python 3.11 أو أحدث والاعتماديات المثبتة وPostgreSQL 16 أو أحدث وقاعدة foundation_week8_test المخصصة. تؤثر الإعادة المقدمة في foundation_week8.notices فقط وتتطلب تأكيداً صريحاً.Use Python 3.11+, pinned dependencies, PostgreSQL 16+ and the dedicated foundation_week8_test database. The provided reset affects only foundation_week8.notices and requires explicit confirmation.

المواد المطلوبةRequired materials

  • تسلسل الشرائح العام لهذه الجلسة (3 شرائح).Public slide sequence for this session (3 slides).
  • ورقة عمل المتعلم القابلة للطباعة للمهام المنشورة وعددها 1.Printable learner worksheet for the 1 published tasks.
  • نسخة دون اتصال من الجلسة وتسميات الأدلة والملفات العامة المعتمدة.An offline copy of the session, evidence labels, and approved public files.
  • حالات الإدخال الاصطناعية المقدمة فقط وعددها 5؛ دون بيانات مشاركين حقيقية.Only the 5 supplied synthetic input cases; no real participant data.

الأهدافObjectives

  • اعرض فردياً CRUD المعتمدة على PostgreSQL والكتابات الدائمة وسلوك غير الصالح والمفقود والفشل والاختبارات الآلية بأدلة اصطناعية آمنة.Independently demonstrate PostgreSQL-backed CRUD, durable writes, invalid/missing/failure behavior and automated tests with safe synthetic evidence.

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

اليوم 5: اليوم 5 — التحقق الفردي لـAPI دائمةDay 5: Day 5 — Individual persistent API checkpoint
الفقرةBlockالدقائقMinutesالنمطModeإجراء المدرّبTrainer actionإجراء المتعلّمLearner action
التحقق الفردي لـAPI دائمةIndividual persistent API checkpoint300مختبر خاضع للإشرافSupervised labراقب عمل CRUD الفردي وافحص حدود القاعدة الفعلية واطلب دليل إعادة التشغيل للسجل نفسه واختبارات الحالة النظيفة ورتب الاستدراك دون تقديم الإجابات.Observe independent CRUD work, inspect the real database boundary, require same-record restart evidence and clean-state tests, and arrange recovery without supplying answers.انطلاقاً من البداية وعملك السابق نفذ API الدائمة واعرض كل حالة منشورة وأعد مجموعة الاختبارات كاملة واشرح تراجع الكتابات الفاشلة دون كشف تفاصيل خاصة.From the starter and your own prior work, implement the persistent API, demonstrate every published case, rerun the full test suite, and explain how failed writes roll back without exposing private details.

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

تخزين دائم عامل وحدود قابلة للشرحWorking persistence plus an explainable boundary

يجمع التحقق الكامل المخططات الثابتة والعمليات الأربع السابقة والحذف المضاف والكتابات المثبتة التي تبقى بعد إعادة API واختبارات نجاح وفشل قابلة للتكرار. اشرح المعاملات وملكية المعاملة وكل رمز. لا تثبت فحوص البيئة أو المحاكاة وحدها أو اللقطات المحفوظة السلوك الكامل.A complete checkpoint combines the stable schemas and four existing operations, the added delete operation, committed writes surviving an API restart, and repeatable success/failure tests. Explain parameters, transaction ownership and each status. Environment-only checks, mocks alone or saved screenshots cannot establish the full behavior.

أمثلة العرضDemonstration examples
خمس عمليات وثلاثة مخططات وعينة PostgreSQL فعلية ودليل إعادة للمعرف نفسه وتشغيلان للاختبار من حالة نظيفة.Five operations, three schemas, one real PostgreSQL fixture, a same-id restart proof, and two clean-state test runs.

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

  1. شرح العقد من الطلب إلى الصفExplain the request-to-row contract

    • اعرض فردياً CRUD المعتمدة على PostgreSQL والكتابات الدائمة وسلوك غير الصالح والمفقود والفشل والاختبارات الآلية بأدلة اصطناعية آمنة.Independently demonstrate PostgreSQL-backed CRUD, durable writes, invalid/missing/failure behavior and automated tests with safe synthetic evidence.

    إشارة التقديمSpeaker cueاسأل عن الطلب وحالة الصف القابلين للملاحظة اللذين يثبتان الهدف.Ask which observable request and row state prove the objective.

  2. تخزين دائم عامل وحدود قابلة للشرحWorking persistence plus an explainable boundary

    • خمس عمليات وثلاثة مخططات وعينة PostgreSQL فعلية ودليل إعادة للمعرف نفسه وتشغيلان للاختبار من حالة نظيفة.Five operations, three schemas, one real PostgreSQL fixture, a same-id restart proof, and two clean-state test runs.

    إشارة التقديمSpeaker cueتوقف للتوقع قبل تنفيذ أي شيء أو إعادته.Pause for a prediction before executing or resetting anything.

  3. عينة مضبوطة وإعدادات خاصةControlled fixture and private settings

    • خزّن الإعلانات الخيالية المقدمة فقط. أبقِ إعداد الاتصال وتفاصيل المشغل وتفريغ القاعدة الخام والهويات الحقيقية والرسائل الخاصة خارج اللقطات والسجلات والأدلة المشتركة واعرض حقول الاستجابة الاصطناعية المعتمدة فقط.Persist only the supplied fictional notice records. Keep connection settings, driver details, raw database dumps, real identities and private messages out of screenshots, logs and shared evidence; show only the approved synthetic response fields.

    إشارة التقديمSpeaker cueلا تعد العينة بين لقطات الدوام ولا تعرض إعداد الاتصال.Never reset between persistence captures; never show connection settings.

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

  1. اقرأ المعايير المنشورة وخطط لعرض مباشر دون تلقي كود نقاط النهاية أو طبقة الوصول المكتمل.Read the published criteria and plan a live demonstration without receiving completed endpoint or repository code.

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

  1. افحص العينة القابلة للإعادة وتوقع الرمز والاستجابة والحالة المخزنة قبل تشغيل العملية.Inspect the disposable fixture and predict status, response and stored state before running an operation.
  2. انطلاقاً من البداية وعملك السابق نفذ API الدائمة واعرض كل حالة منشورة وأعد مجموعة الاختبارات كاملة واشرح تراجع الكتابات الفاشلة دون كشف تفاصيل خاصة.From the starter and your own prior work, implement the persistent API, demonstrate every published case, rerun the full test suite, and explain how failed writes roll back without exposing private details.
  3. تتبع أول حد مختلف وأصلحه وكرر من إعداد نظيف موثق. لا تعد العينة أثناء إثبات إعادة API.Trace the first differing boundary, repair it, and repeat from documented clean setup. Do not reset during the API restart proof.
  4. التقط الاستجابات الخيالية المعتمدة والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط وافحص حالة القاعدة الخام محلياً دون مشاركة تفريغها.Capture only approved fictional responses, reasoning and the AI-use or non-use note; inspect raw database state locally without sharing a dump.

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

  • قدّم تنفيذ CRUD الفردي والاستجابات الموثقة وسجل الدوام ونتائج آلية من حالة نظيفة وفحص الخصوصية وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه.Submit the individual CRUD implementation, documented responses, persistence transcript, clean-state automated results, privacy check and AI-use or non-use note.w8d5-checkpoint-evidence

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

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

اربط نقاط نهاية CRUD بـPostgreSQL وأثبت التخزين الدائم ومعالجة الإدخال غير الصالح وسلوك السجل المفقود والاختبارات الآلية.Connect CRUD endpoints to PostgreSQL and prove persistence, invalid-input handling, missing-record behaviour, and automated tests.

  • تقرأ نقاط CRUD من PostgreSQL وتكتب إليها ويبقى السجل المنشأ بعد إعادة التشغيل.CRUD endpoints read and write PostgreSQL and a created record survives restart.
  • يُرفض الإدخال غير الصالح قبل التخزين وتعيد المعرفات المفقودة استجابات مضبوطة.Invalid input is rejected before persistence and missing identifiers return controlled responses.
  • تغطي الاختبارات الآلية سلوكيات النجاح والفشل انطلاقاً من إعداد نظيف.Automated tests cover the success and failure behaviours from clean setup.

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

  • تعلن الاستجابة النجاح قبل التثبيت أو تعمل الإعادة بين لقطتي إثبات الدوام.A response says success before commit, or reset runs between the two persistence captures.
  • تتضمن SQL قيماً مدمجة أو تنفذ مسارات async عمليات حاجبة أو تتشارك الطلبات معاملة طويلة العمر.SQL includes interpolated values, async routes perform blocking calls, or requests share a long-lived transaction.
  • تحتوي استجابة 204 على JSON أو يتحول الصف المفقود إلى 503 أو يكشف استثناء القاعدة تفاصيل الاتصال.A 204 response contains JSON, a missing row becomes 503, or a database exception exposes connection details.

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

  • ارجع إلى جدول نقاط النهاية وافحص المخطط والمسار ودالة القاعدة منفصلة.Return to the endpoint table and inspect schema, route and database function separately.
  • افحص التثبيت والتراجع ونطاق العينة ثم اطلب عرض إعادة فعلية للسجل نفسه.Check commit/rollback and fixture scope, then require a real same-record restart demonstration.

الاستدراكRecovery

خلال أسبوع واحد اعزل حداً فاشلاً واحداً وكرر فحوص CRUD والإعادة والأعطال نفسها وأعد تقديم دليل التحقق الفردي لـAPI الدائمة. إذا تعذرت PostgreSQL فرتب وصولاً مدعوماً للمختبر بدلاً من قبول دليل المحاكاة وحده.Within one week, isolate one failing boundary, repeat the same CRUD, restart and failure checks, and resubmit the individual persistent API checkpoint evidence. If PostgreSQL is unavailable, schedule supported lab access rather than accepting mock-only proof.

البديل عند الانقطاع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

خزّن الإعلانات الخيالية المقدمة فقط. أبقِ إعداد الاتصال وتفاصيل المشغل وتفريغ القاعدة الخام والهويات الحقيقية والرسائل الخاصة خارج اللقطات والسجلات والأدلة المشتركة واعرض حقول الاستجابة الاصطناعية المعتمدة فقط.Persist only the supplied fictional notice records. Keep connection settings, driver details, raw database dumps, real identities and private messages out of screenshots, logs and shared evidence; show only the approved synthetic response fields.

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

يمكن للذكاء الاصطناعي مراجعة اختبار فاشل بعد حجبه وإعادة إنتاجه. عليك فحص الحالة وتنفيذ الإصلاح وشرح كل اقتراح وتشغيل المجموعة كاملة ولا تطلب حل التحقق الكامل.AI may review a redacted failing test after you reproduce it. You must inspect state, implement the repair, explain each suggestion and run the complete suite; do not request the complete checkpoint solution.

نص التسجيلRecording script

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

السردNarration

  1. اشرح شرح العقد من الطلب إلى الصف بمثال خيالي مختلف دون كود التحقق المكتمل.Explain Explain the request-to-row contract with a different fictional example, without completed checkpoint code.

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

  1. اعرض جدول نقاط النهاية والملفات النسبية والاستجابات الاصطناعية المعتمدة ونتائج الاختبار المحجوبة. أوقف وشغّل API فقط لإثبات الدوام وأبقِ الإعدادات وشاشات القاعدة الخام مخفية.Show the endpoint table, project-relative files, approved synthetic responses and redacted test results. Stop/start only the API for persistence; keep settings and raw database consoles hidden.

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

  1. اكتب معنى الطريقة والرمز والمعامل والتثبيت والتراجع والحالة المخزنة بالعربية أولاً ثم الإنجليزية.Caption method, status, parameter, commit/rollback and stored-state meaning in Arabic first, then English.

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

  1. توقف قبل كل طلب للتوقع وقبل كل إعادة للتحقق من النطاق والتأكيد.Pause before each request for a prediction and before any reset for scope and confirmation.

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

  1. تحقق من خمس عمليات وثلاثة نماذج ووصول ذي معاملات ودليل دوام للمعرف نفسه ومسارات غير الصالح والمفقود والفشل واختبارات مكررة وغياب بيانات الدخول ووضوح الاستدراك. يحتاج البديل دون اتصال PostgreSQL محلية مثبتة ولا تكمل المحاكاة وحدها دليل الدوام.Verify five operations, three models, parameterised access, durable same-id proof, invalid/missing/failure paths, repeated tests, no credentials and visible recovery. Offline fallback needs an installed local PostgreSQL instance; mocks alone do not complete persistence evidence.