دليل المدرّب · PDFTrainer guide · PDF
تنزيل PDFDownload PDFحزمة المدرّب العامة الكاملةComplete public trainer pack
الأسبوع السابع — حزمة المدرّبWeek 7 — 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
عرض الشرائح · PDFSlide deck · PDF
تنزيل PDFDownload PDFحالة الحل الكاملComplete solution status
يتوفر بعد التحقق ونافذة الاستدراك والإصدار المعتمد من المدرّبAvailable after the checkpoint, recovery window, and trainer-approved release
اليوم 1Day 1
اليوم 1 — عقود HTTP قبل الكودDay 1 — HTTP contracts before code
التحضيرPreparation
- أكمل عمل عمليات السجلات المتحقق منها للأسبوع السادس أو مسار الدعم المتفق عليه.Complete the Week 6 validated record-operation work or the agreed supported route.
- افتح حزمة بداية الأسبوع السابع دون تغيير باستخدام Python 3.11 أو أحدث والاعتماديات المثبتة. استخدم عملية محلية واحدة والإعلانين الخياليين؛ ولا تحتاج قاعدة بيانات.Open the unchanged Week 7 starter with Python 3.11 or newer and the pinned dependencies. Use a single local process and the two fictional notices; no database is required.
المواد المطلوبة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
- اكتب عقود أربع نقاط نهاية لإعلانات خيالية وتوقع استجابات النجاح والإدخال غير الصالح والسجل المفقود.Draft four endpoint contracts for fictional notices and predict success, invalid-input and missing-record responses.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| الطريقة والمسار والجسم ورمز الحالةMethod, path, body and status | 120 | تدريسInstruction | اشرح بالعربية أولاً. تتبع الطريقة والمسار والمخطط والذاكرة والاستجابة وقارن فشل التحقق بجلب مورد مفقود.Explain in Arabic first. Trace method, path, schema, memory and response; contrast a validation failure with a missing-resource lookup. | اكتب عقود أربع نقاط نهاية لإعلانات خيالية وتوقع استجابات النجاح والإدخال غير الصالح والسجل المفقود.Draft four endpoint contracts for fictional notices and predict success, invalid-input and missing-record responses. |
| تدريب موجّه للطلب والاستجابةGuided request/response practice | 60 | ممارسة موجّهةGuided practice | اعرض طلباً خيالياً مختلفاً واحداً واطلب توقعاً ثم قلل التلميحات قبل حالة المتعلم الخاصة.Model one different fictional request, ask for a prediction, then fade prompts before the learner's own case. | صنّف بطاقات الطلب إلى مسار مجموعة أو فرد ثم اشرح لماذا يحتاج العنوان الفارغ والمعرف 999 إلى استجابتين مختلفتين.Sort request cards by collection or individual path, then explain why a blank title and id 999 need different responses. |
| مختبر API في الذاكرة بإشرافSupervised in-memory API lab | 120 | مختبر خاضع للإشرافSupervised lab | افحص الدليل الفردي وفق جدول نقاط النهاية. أبقِ التخزين الدائم خارج النطاق وامنع دخول الرسائل الحقيقية أو بيانات الاتصال إلى اللقطات.Inspect individual evidence against the endpoint table. Keep persistence out of scope and prevent real messages or contact data entering captures. | أكمل endpoint-table.md للإنشاء والعرض والجلب وتحديث النشر. توقع JSON الطلب والاستجابة لكل حالة منشورة قبل فتح المحرر.Complete endpoint-table.md for create, list, get and publication update. Predict request and response JSON for all published cases before opening the editor. |
ملاحظات الشرحExplanation notes
مورد واحد وأربع عملياتOne resource, four operations
تصف طريقة HTTP العملية ويحدد المسار المجموعة أو مورداً واحداً. يمثل JSON البيانات بينما يميز رمز الحالة النتيجة. الطلب الصحيح شكلياً لمعرف غير موجود فشل في الجلب لا فشل في المخطط.HTTP method describes the operation; the path identifies the collection or one resource. JSON is the representation, while the status code distinguishes outcome. A valid-shaped request for an absent id is a lookup failure, not a schema failure.
أمثلة العرضDemonstration examples
إنشاء ← POST /notices ← 201؛ عرض وجلب وتحديث ← 200؛ جسم غير صالح ← 422؛ معرف مفقود ← 404.Create → POST /notices → 201; list/get/update → 200; invalid body → 422; missing id → 404.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- صنّف بطاقات الطلب إلى مسار مجموعة أو فرد ثم اشرح لماذا يحتاج العنوان الفارغ والمعرف 999 إلى استجابتين مختلفتين.Sort request cards by collection or individual path, then explain why a blank title and id 999 need different responses.
تيسير المختبرLab facilitation
- ابدأ من عينة الإعلانين وتوقع الرمز وJSON الاستجابة وتغييرات الذاكرة قبل التنفيذ.Start from the two-notice fixture and predict status, response JSON and memory changes before execution.
- أكمل endpoint-table.md للإنشاء والعرض والجلب وتحديث النشر. توقع JSON الطلب والاستجابة لكل حالة منشورة قبل فتح المحرر.Complete endpoint-table.md for create, list, get and publication update. Predict request and response JSON for all published cases before opening the editor.
- قارن الاستجابة الفعلية والمتوقعة وأصلح أول حد مختلف وكرر من ذاكرة نظيفة.Compare actual and expected responses, repair the first differing boundary, and repeat from clean memory.
- احفظ دليل الطلب والاستجابة الخيالي والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط.Save only fictional request/response evidence, reasoning and the AI-use or non-use note.
الأدلة المتوقعةExpected evidence
- قدّم جدول نقاط النهاية ذي الصفوف الأربعة وأمثلة طلب واستجابة مشروحة وتعليل الرموز 201 و200 و422 و404.Submit the four-row endpoint table, annotated request/response examples, and the reasoning for 201, 200, 422 and 404.
w7d1-contract-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
ابنِ نقاط نهاية موثقة في FastAPI باستخدام Pydantic وبيانات في الذاكرة قبل التخزين الدائم.Build documented FastAPI endpoints using Pydantic with in-memory data before persistence.
- تتحقق مخططات Pydantic من الطلبات وتصف الاستجابات.Pydantic schemas validate requests and describe responses.
- تستخدم نقاط النهاية في الذاكرة طرقاً ومسارات ورموز حالة مناسبة.In-memory endpoints use suitable methods, paths and status codes.
- يوضح التوثيق المولد طلباً صالحاً وإدخالاً غير صالح وسجلاً مفقوداً.Generated documentation demonstrates a valid request, invalid input and missing record.
الأخطاء الشائعةCommon errors
- إرجاع 200 مع نص خطأ بدلاً من 404 أو استجابة التحقق المحددة في العقد.Returning 200 with an error string instead of the contract's 404 or validation response.
- تجتاز المسافات فحص الطول لأن إزالتها متأخرة أو تتحول قيمة نصية بصمت إلى منطقية.Whitespace passes a length check because stripping happens too late, or a text value is silently converted to boolean.
- تعيد الاختبارات استخدام ذاكرة معدلة أو تدعي التخزين الدائم لأن العملية لم تعد تشغيلها.Tests reuse mutated memory or claim persistence because the process was never restarted.
تدخلات المدرّبTrainer interventions
- ارجع إلى جدول نقاط النهاية وحدد أول اختلاف بين المخطط والرمز وجسم الاستجابة.Return to the endpoint table and locate the first disagreement among schema, status and response body.
- أعد العينة وافحص طلباً واحداً عبر التحقق والجلب وتحويل الاستجابة.Reset the fixture and inspect one request through validation, lookup and serialization.
الاستدراكRecovery
خلال أسبوع واحد أصلح حد مخطط أو نقطة نهاية واحدة كل مرة وأعد التقاط النتائج الصالحة وغير الصالحة والمفقودة نفسها ثم أعد تقديم جدول عقد نقاط النهاية.Within one week, repair one schema or endpoint boundary at a time, recapture the same valid/invalid/missing outcomes, and resubmit the endpoint contract table.
البديل عند الانقطاع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
استخدم الإعلانات العامة الخيالية المقدمة فقط. أبقِ بيانات الاتصال الحقيقية والرسائل الخاصة والرموز السرية والسجلات التشغيلية خارج المصدر والسجلات والأمثلة والتوثيق المولد.Use only the supplied fictional public notices. Keep real contact data, private messages, tokens and operational records out of source, logs, examples and generated documentation.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي مقارنة مفاهيم HTTP بعد كتابة جدول نقاط النهاية. عليك تعريف المخططات وتنفيذ نقاط النهاية وتشغيل كل طلب موثق وشرح كل اقتراح مقبول؛ ولا تطلب حل التحقق الكامل.AI may compare HTTP concepts after you draft the endpoint table. You must define the schemas, implement the endpoints, run each documented request and explain every accepted suggestion; do not request the complete checkpoint solution.
نص التسجيلRecording script
السردNarration
- اشرح الطريقة والمسار والجسم ورمز الحالة عبر طلب خيالي مختلف دون تقديم كود التحقق المكتمل.Explain Method, path, body and status through a different fictional request without giving completed checkpoint code.
إجراءات الشاشةScreen actions
- اعرض جدول نقاط النهاية وملفات النماذج والمسارات النسبية والتوثيق المحلي وOpenAPI الخام والاستجابات الاصطناعية. أخفِ علامات المتصفح غير المرتبطة وتفاصيل الحساب.Show the endpoint table, project-relative model/route files, local docs, raw OpenAPI and synthetic responses. Hide unrelated browser tabs and account details.
النصوص الظاهرةCaptions
- اكتب الطريقة والمسار وقيد الحقل والرمز ومعنى الاستجابة بالعربية أولاً ثم الإنجليزية.Caption method, path, field constraint, status and response meaning in Arabic first, then English.
نقاط التوقفPause points
- توقف قبل كل طلب للتوقع وقبل الالتقاط لفحص الخصوصية.Pause before each request for a prediction and before capture for a privacy scan.
قائمة التحقق من التسجيلRecording checklist
- تحقق من أربع عمليات وثلاثة نماذج ودليل الصالح وغير الصالح والمفقود وإعادة الذاكرة وعدم وجود قاعدة بيانات أو بيانات حقيقية ووضوح مسار الاستدراك. إذا غابت موارد التوثيق دون اتصال فاعرض OpenAPI الخام وTestClient ورتب التقاط التوثيق التفاعلي.Verify four operations, three models, valid/invalid/missing evidence, in-memory reset, no database, no real data and a visible recovery route. If docs assets are unavailable offline, demonstrate raw OpenAPI and TestClient and schedule the interactive-docs capture.
اليوم 2Day 2
اليوم 2 — حدود الطلب والاستجابة في PydanticDay 2 — Pydantic request and response boundaries
التحضيرPreparation
- أكمل عمل عمليات السجلات المتحقق منها للأسبوع السادس أو مسار الدعم المتفق عليه.Complete the Week 6 validated record-operation work or the agreed supported route.
- افتح حزمة بداية الأسبوع السابع دون تغيير باستخدام Python 3.11 أو أحدث والاعتماديات المثبتة. استخدم عملية محلية واحدة والإعلانين الخياليين؛ ولا تحتاج قاعدة بيانات.Open the unchanged Week 7 starter with Python 3.11 or newer and the pinned dependencies. Use a single local process and the two fictional notices; no database is required.
المواد المطلوبة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
- عرّف نماذج الإنشاء وتحديث النشر والاستجابة بقيود حقول صريحة وميّز القيم الغائبة والفارغة والخاطئة النوع.Define the create, publication-update and response models with explicit field limits and distinguish omitted, blank and wrong-type values.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| التحقق قبل منطق نقطة النهايةValidate before endpoint logic | 120 | تدريسInstruction | اشرح بالعربية أولاً. تتبع الطريقة والمسار والمخطط والذاكرة والاستجابة وقارن فشل التحقق بجلب مورد مفقود.Explain in Arabic first. Trace method, path, schema, memory and response; contrast a validation failure with a missing-resource lookup. | عرّف نماذج الإنشاء وتحديث النشر والاستجابة بقيود حقول صريحة وميّز القيم الغائبة والفارغة والخاطئة النوع.Define the create, publication-update and response models with explicit field limits and distinguish omitted, blank and wrong-type values. |
| تدريب موجّه للطلب والاستجابةGuided request/response practice | 60 | ممارسة موجّهةGuided practice | اعرض طلباً خيالياً مختلفاً واحداً واطلب توقعاً ثم قلل التلميحات قبل حالة المتعلم الخاصة.Model one different fictional request, ask for a prediction, then fade prompts before the learner's own case. | ابنِ مصفوفة حقول تبين النوع والإلزام والطول؛ وقارن تحقق المخطط بجلب المورد دون كتابة المسارات بعد.Build a field matrix showing type, requiredness and length; compare schema validation with a resource lookup without writing routes yet. |
| مختبر API في الذاكرة بإشرافSupervised in-memory API lab | 120 | مختبر خاضع للإشرافSupervised lab | افحص الدليل الفردي وفق جدول نقاط النهاية. أبقِ التخزين الدائم خارج النطاق وامنع دخول الرسائل الحقيقية أو بيانات الاتصال إلى اللقطات.Inspect individual evidence against the endpoint table. Keep persistence out of scope and prevent real messages or contact data entering captures. | أكمل NoticeCreate وNoticeUpdate وNoticeRead. افحص قيمة عادية وعنواناً من مسافات وجسماً أطول من الحد وحقلاً زائداً وpublished غائباً أو غير منطقي.Complete NoticeCreate, NoticeUpdate and NoticeRead. Check a normal value, whitespace-only title, oversized body, extra field, omitted published and non-boolean published. |
ملاحظات الشرحExplanation notes
التحقق وتحويل البيانات مهمتان مختلفتانValidation and serialization are different jobs
يقدم طلب الإنشاء العنوان والجسم ويحدد الخادم المعرف وpublished=false. أزل الفراغات قبل فرض الحد الأدنى للطول كي لا تكون المسافات عنواناً. يقبل التحديث published فقط كقيمة منطقية صارمة مطلوبة وتصف الاستجابة الحقول الأربعة. امنع حقول الطلب الزائدة بدلاً من قبولها بصمت.A create request supplies title and body; the server assigns id and published=false. Trim text before enforcing minimum length, so spaces are not a title. The update accepts only a required strict boolean published; the response describes all four stored fields. Forbid extra request fields rather than silently accepting them.
أمثلة العرضDemonstration examples
title " " مرفوض؛ published "yes" مرفوض؛ published true مقبول.title " " → rejected; published "yes" → rejected; published true → accepted.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- ابنِ مصفوفة حقول تبين النوع والإلزام والطول؛ وقارن تحقق المخطط بجلب المورد دون كتابة المسارات بعد.Build a field matrix showing type, requiredness and length; compare schema validation with a resource lookup without writing routes yet.
تيسير المختبرLab facilitation
- ابدأ من عينة الإعلانين وتوقع الرمز وJSON الاستجابة وتغييرات الذاكرة قبل التنفيذ.Start from the two-notice fixture and predict status, response JSON and memory changes before execution.
- أكمل NoticeCreate وNoticeUpdate وNoticeRead. افحص قيمة عادية وعنواناً من مسافات وجسماً أطول من الحد وحقلاً زائداً وpublished غائباً أو غير منطقي.Complete NoticeCreate, NoticeUpdate and NoticeRead. Check a normal value, whitespace-only title, oversized body, extra field, omitted published and non-boolean published.
- قارن الاستجابة الفعلية والمتوقعة وأصلح أول حد مختلف وكرر من ذاكرة نظيفة.Compare actual and expected responses, repair the first differing boundary, and repeat from clean memory.
- احفظ دليل الطلب والاستجابة الخيالي والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط.Save only fictional request/response evidence, reasoning and the AI-use or non-use note.
الأدلة المتوقعةExpected evidence
- قدّم مصفوفة الحقول ومخرجات تحقق النماذج وشرح سبب عدم قدرة العميل على تعيين المعرف أو تعديل العنوان عبر تحديث النشر فقط.Submit the field matrix, model-validation outputs and explanation of why the client cannot assign id or alter title through the publication-only update.
w7d2-schema-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
ابنِ نقاط نهاية موثقة في FastAPI باستخدام Pydantic وبيانات في الذاكرة قبل التخزين الدائم.Build documented FastAPI endpoints using Pydantic with in-memory data before persistence.
- تتحقق مخططات Pydantic من الطلبات وتصف الاستجابات.Pydantic schemas validate requests and describe responses.
- تستخدم نقاط النهاية في الذاكرة طرقاً ومسارات ورموز حالة مناسبة.In-memory endpoints use suitable methods, paths and status codes.
- يوضح التوثيق المولد طلباً صالحاً وإدخالاً غير صالح وسجلاً مفقوداً.Generated documentation demonstrates a valid request, invalid input and missing record.
الأخطاء الشائعةCommon errors
- إرجاع 200 مع نص خطأ بدلاً من 404 أو استجابة التحقق المحددة في العقد.Returning 200 with an error string instead of the contract's 404 or validation response.
- تجتاز المسافات فحص الطول لأن إزالتها متأخرة أو تتحول قيمة نصية بصمت إلى منطقية.Whitespace passes a length check because stripping happens too late, or a text value is silently converted to boolean.
- تعيد الاختبارات استخدام ذاكرة معدلة أو تدعي التخزين الدائم لأن العملية لم تعد تشغيلها.Tests reuse mutated memory or claim persistence because the process was never restarted.
تدخلات المدرّبTrainer interventions
- ارجع إلى جدول نقاط النهاية وحدد أول اختلاف بين المخطط والرمز وجسم الاستجابة.Return to the endpoint table and locate the first disagreement among schema, status and response body.
- أعد العينة وافحص طلباً واحداً عبر التحقق والجلب وتحويل الاستجابة.Reset the fixture and inspect one request through validation, lookup and serialization.
الاستدراكRecovery
خلال أسبوع واحد أصلح حد مخطط أو نقطة نهاية واحدة كل مرة وأعد التقاط النتائج الصالحة وغير الصالحة والمفقودة نفسها ثم أعد تقديم دليل الحدود محددة النوع.Within one week, repair one schema or endpoint boundary at a time, recapture the same valid/invalid/missing outcomes, and resubmit the typed-boundary 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
استخدم الإعلانات العامة الخيالية المقدمة فقط. أبقِ بيانات الاتصال الحقيقية والرسائل الخاصة والرموز السرية والسجلات التشغيلية خارج المصدر والسجلات والأمثلة والتوثيق المولد.Use only the supplied fictional public notices. Keep real contact data, private messages, tokens and operational records out of source, logs, examples and generated documentation.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي مقارنة مفاهيم HTTP بعد كتابة جدول نقاط النهاية. عليك تعريف المخططات وتنفيذ نقاط النهاية وتشغيل كل طلب موثق وشرح كل اقتراح مقبول؛ ولا تطلب حل التحقق الكامل.AI may compare HTTP concepts after you draft the endpoint table. You must define the schemas, implement the endpoints, run each documented request and explain every accepted suggestion; do not request the complete checkpoint solution.
نص التسجيلRecording script
السردNarration
- اشرح التحقق قبل منطق نقطة النهاية عبر طلب خيالي مختلف دون تقديم كود التحقق المكتمل.Explain Validate before endpoint logic through a different fictional request without giving completed checkpoint code.
إجراءات الشاشةScreen actions
- اعرض جدول نقاط النهاية وملفات النماذج والمسارات النسبية والتوثيق المحلي وOpenAPI الخام والاستجابات الاصطناعية. أخفِ علامات المتصفح غير المرتبطة وتفاصيل الحساب.Show the endpoint table, project-relative model/route files, local docs, raw OpenAPI and synthetic responses. Hide unrelated browser tabs and account details.
النصوص الظاهرةCaptions
- اكتب الطريقة والمسار وقيد الحقل والرمز ومعنى الاستجابة بالعربية أولاً ثم الإنجليزية.Caption method, path, field constraint, status and response meaning in Arabic first, then English.
نقاط التوقفPause points
- توقف قبل كل طلب للتوقع وقبل الالتقاط لفحص الخصوصية.Pause before each request for a prediction and before capture for a privacy scan.
قائمة التحقق من التسجيلRecording checklist
- تحقق من أربع عمليات وثلاثة نماذج ودليل الصالح وغير الصالح والمفقود وإعادة الذاكرة وعدم وجود قاعدة بيانات أو بيانات حقيقية ووضوح مسار الاستدراك. إذا غابت موارد التوثيق دون اتصال فاعرض OpenAPI الخام وTestClient ورتب التقاط التوثيق التفاعلي.Verify four operations, three models, valid/invalid/missing evidence, in-memory reset, no database, no real data and a visible recovery route. If docs assets are unavailable offline, demonstrate raw OpenAPI and TestClient and schedule the interactive-docs capture.
اليوم 3Day 3
اليوم 3 — أربع نقاط نهاية فوق الذاكرةDay 3 — Four endpoints over memory
التحضيرPreparation
- أكمل عمل عمليات السجلات المتحقق منها للأسبوع السادس أو مسار الدعم المتفق عليه.Complete the Week 6 validated record-operation work or the agreed supported route.
- افتح حزمة بداية الأسبوع السابع دون تغيير باستخدام Python 3.11 أو أحدث والاعتماديات المثبتة. استخدم عملية محلية واحدة والإعلانين الخياليين؛ ولا تحتاج قاعدة بيانات.Open the unchanged Week 7 starter with Python 3.11 or newer and the pinned dependencies. Use a single local process and the two fictional notices; no database is required.
المواد المطلوبة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
- نفّذ نقاط نهاية الإنشاء والعرض والجلب وتحديث النشر بنماذج استجابة وترتيب ثابت ومعرفات مولدة ومعالجة صريحة للسجل المفقود.Implement create, list, get and publication-update endpoints with response models, stable ordering, generated ids and explicit missing-record handling.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| فصل سلوك HTTP عن التخزينKeep HTTP behavior separate from storage | 120 | تدريسInstruction | اشرح بالعربية أولاً. تتبع الطريقة والمسار والمخطط والذاكرة والاستجابة وقارن فشل التحقق بجلب مورد مفقود.Explain in Arabic first. Trace method, path, schema, memory and response; contrast a validation failure with a missing-resource lookup. | نفّذ نقاط نهاية الإنشاء والعرض والجلب وتحديث النشر بنماذج استجابة وترتيب ثابت ومعرفات مولدة ومعالجة صريحة للسجل المفقود.Implement create, list, get and publication-update endpoints with response models, stable ordering, generated ids and explicit missing-record handling. |
| تدريب موجّه للطلب والاستجابةGuided request/response practice | 60 | ممارسة موجّهةGuided practice | اعرض طلباً خيالياً مختلفاً واحداً واطلب توقعاً ثم قلل التلميحات قبل حالة المتعلم الخاصة.Model one different fictional request, ask for a prediction, then fade prompts before the learner's own case. | تتبع الطلب عبر تحقق النموذج والجلب أو الكتابة في الذاكرة وتحويل الاستجابة والرمز. افحص الحالة قبل تحديث نشر واحد وبعده.Trace a request through model validation, memory lookup or write, response serialization and status. Check the before/after state for one publication update. |
| مختبر API في الذاكرة بإشرافSupervised in-memory API lab | 120 | مختبر خاضع للإشرافSupervised lab | افحص الدليل الفردي وفق جدول نقاط النهاية. أبقِ التخزين الدائم خارج النطاق وامنع دخول الرسائل الحقيقية أو بيانات الاتصال إلى اللقطات.Inspect individual evidence against the endpoint table. Keep persistence out of scope and prevent real messages or contact data entering captures. | سجل الدوال الأربع في notice_api.py وأكملها. تحقق من ترتيب القائمة ومعرفات مميزة للإنشاء المتكرر وثبات العنوان والجسم في PATCH و404 للجلب والتحديث المفقودين.Register and complete the four functions in notice_api.py. Verify ascending list order, distinct ids on consecutive creates, unchanged title/body on PATCH, and 404 for missing GET and PATCH. |
ملاحظات الشرحExplanation notes
ذاكرة العملية مؤقتةProcess memory is temporary
استخدم الإعلانين المقدمين كحالة أولية. يحصل كل إنشاء صالح على المعرف التالي غير المستخدم. يغير PATCH حقل published فقط ويحفظ البقية. تعيد بداية العملية المحلية الواحدة تحميل العينة وتفقد التغييرات؛ وهذا سلوك متوقع للأسبوع السابع وليس تخزيناً دائماً. لا تصل قاعدة بيانات لحل هذا القيد.Use the two supplied notices as the initial state. Each valid create obtains the next unused id. PATCH changes only published and preserves the other fields. Restarting the single local process reloads the fixture and loses changes; this is expected Week 7 behavior, not persistence. Do not attach a database to solve that limitation.
أمثلة العرضDemonstration examples
معرفات أولية [1,2] ← إنشاء 3 ← PATCH 3 published=true ← إعادة التشغيل ← [1,2].Initial ids [1,2] → create id 3 → PATCH 3 published=true → restart → ids [1,2].تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- تتبع الطلب عبر تحقق النموذج والجلب أو الكتابة في الذاكرة وتحويل الاستجابة والرمز. افحص الحالة قبل تحديث نشر واحد وبعده.Trace a request through model validation, memory lookup or write, response serialization and status. Check the before/after state for one publication update.
تيسير المختبرLab facilitation
- ابدأ من عينة الإعلانين وتوقع الرمز وJSON الاستجابة وتغييرات الذاكرة قبل التنفيذ.Start from the two-notice fixture and predict status, response JSON and memory changes before execution.
- سجل الدوال الأربع في notice_api.py وأكملها. تحقق من ترتيب القائمة ومعرفات مميزة للإنشاء المتكرر وثبات العنوان والجسم في PATCH و404 للجلب والتحديث المفقودين.Register and complete the four functions in notice_api.py. Verify ascending list order, distinct ids on consecutive creates, unchanged title/body on PATCH, and 404 for missing GET and PATCH.
- قارن الاستجابة الفعلية والمتوقعة وأصلح أول حد مختلف وكرر من ذاكرة نظيفة.Compare actual and expected responses, repair the first differing boundary, and repeat from clean memory.
- احفظ دليل الطلب والاستجابة الخيالي والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط.Save only fictional request/response evidence, reasoning and the AI-use or non-use note.
الأدلة المتوقعةExpected evidence
- قدّم خريطة المسار والدالة وJSON المنشأ والمحدث ولقطات السجل المفقود ومقارنة إعادة التشغيل التي تشرح حدود الذاكرة.Submit the route-to-function map, created and updated JSON, missing-record captures, and restart comparison explaining the in-memory boundary.
w7d3-endpoint-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
ابنِ نقاط نهاية موثقة في FastAPI باستخدام Pydantic وبيانات في الذاكرة قبل التخزين الدائم.Build documented FastAPI endpoints using Pydantic with in-memory data before persistence.
- تتحقق مخططات Pydantic من الطلبات وتصف الاستجابات.Pydantic schemas validate requests and describe responses.
- تستخدم نقاط النهاية في الذاكرة طرقاً ومسارات ورموز حالة مناسبة.In-memory endpoints use suitable methods, paths and status codes.
- يوضح التوثيق المولد طلباً صالحاً وإدخالاً غير صالح وسجلاً مفقوداً.Generated documentation demonstrates a valid request, invalid input and missing record.
الأخطاء الشائعةCommon errors
- إرجاع 200 مع نص خطأ بدلاً من 404 أو استجابة التحقق المحددة في العقد.Returning 200 with an error string instead of the contract's 404 or validation response.
- تجتاز المسافات فحص الطول لأن إزالتها متأخرة أو تتحول قيمة نصية بصمت إلى منطقية.Whitespace passes a length check because stripping happens too late, or a text value is silently converted to boolean.
- تعيد الاختبارات استخدام ذاكرة معدلة أو تدعي التخزين الدائم لأن العملية لم تعد تشغيلها.Tests reuse mutated memory or claim persistence because the process was never restarted.
تدخلات المدرّبTrainer interventions
- ارجع إلى جدول نقاط النهاية وحدد أول اختلاف بين المخطط والرمز وجسم الاستجابة.Return to the endpoint table and locate the first disagreement among schema, status and response body.
- أعد العينة وافحص طلباً واحداً عبر التحقق والجلب وتحويل الاستجابة.Reset the fixture and inspect one request through validation, lookup and serialization.
الاستدراكRecovery
خلال أسبوع واحد أصلح حد مخطط أو نقطة نهاية واحدة كل مرة وأعد التقاط النتائج الصالحة وغير الصالحة والمفقودة نفسها ثم أعد تقديم دليل نقاط النهاية الأربع.Within one week, repair one schema or endpoint boundary at a time, recapture the same valid/invalid/missing outcomes, and resubmit the four-endpoint 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
استخدم الإعلانات العامة الخيالية المقدمة فقط. أبقِ بيانات الاتصال الحقيقية والرسائل الخاصة والرموز السرية والسجلات التشغيلية خارج المصدر والسجلات والأمثلة والتوثيق المولد.Use only the supplied fictional public notices. Keep real contact data, private messages, tokens and operational records out of source, logs, examples and generated documentation.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي مقارنة مفاهيم HTTP بعد كتابة جدول نقاط النهاية. عليك تعريف المخططات وتنفيذ نقاط النهاية وتشغيل كل طلب موثق وشرح كل اقتراح مقبول؛ ولا تطلب حل التحقق الكامل.AI may compare HTTP concepts after you draft the endpoint table. You must define the schemas, implement the endpoints, run each documented request and explain every accepted suggestion; do not request the complete checkpoint solution.
نص التسجيلRecording script
السردNarration
- اشرح فصل سلوك HTTP عن التخزين عبر طلب خيالي مختلف دون تقديم كود التحقق المكتمل.Explain Keep HTTP behavior separate from storage through a different fictional request without giving completed checkpoint code.
إجراءات الشاشةScreen actions
- اعرض جدول نقاط النهاية وملفات النماذج والمسارات النسبية والتوثيق المحلي وOpenAPI الخام والاستجابات الاصطناعية. أخفِ علامات المتصفح غير المرتبطة وتفاصيل الحساب.Show the endpoint table, project-relative model/route files, local docs, raw OpenAPI and synthetic responses. Hide unrelated browser tabs and account details.
النصوص الظاهرةCaptions
- اكتب الطريقة والمسار وقيد الحقل والرمز ومعنى الاستجابة بالعربية أولاً ثم الإنجليزية.Caption method, path, field constraint, status and response meaning in Arabic first, then English.
نقاط التوقفPause points
- توقف قبل كل طلب للتوقع وقبل الالتقاط لفحص الخصوصية.Pause before each request for a prediction and before capture for a privacy scan.
قائمة التحقق من التسجيلRecording checklist
- تحقق من أربع عمليات وثلاثة نماذج ودليل الصالح وغير الصالح والمفقود وإعادة الذاكرة وعدم وجود قاعدة بيانات أو بيانات حقيقية ووضوح مسار الاستدراك. إذا غابت موارد التوثيق دون اتصال فاعرض OpenAPI الخام وTestClient ورتب التقاط التوثيق التفاعلي.Verify four operations, three models, valid/invalid/missing evidence, in-memory reset, no database, no real data and a visible recovery route. If docs assets are unavailable offline, demonstrate raw OpenAPI and TestClient and schedule the interactive-docs capture.
اليوم 4Day 4
اليوم 4 — التوثيق المولد والأدلة القابلة للتكرارDay 4 — Generated documentation and repeatable evidence
التحضيرPreparation
- أكمل عمل عمليات السجلات المتحقق منها للأسبوع السادس أو مسار الدعم المتفق عليه.Complete the Week 6 validated record-operation work or the agreed supported route.
- افتح حزمة بداية الأسبوع السابع دون تغيير باستخدام Python 3.11 أو أحدث والاعتماديات المثبتة. استخدم عملية محلية واحدة والإعلانين الخياليين؛ ولا تحتاج قاعدة بيانات.Open the unchanged Week 7 starter with Python 3.11 or newer and the pinned dependencies. Use a single local process and the two fictional notices; no database is required.
المواد المطلوبة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
- افحص OpenAPI والتوثيق التفاعلي وجرب الحالات الصالحة وغير الصالحة والمفقودة وأكمل تأكيدات TestClient من عينة معادة.Inspect OpenAPI and interactive docs, exercise valid/invalid/missing cases, and complete focused TestClient assertions from a reset fixture.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| مقارنة العقد بالاستجابات الفعليةCompare the contract with real responses | 120 | تدريسInstruction | اشرح بالعربية أولاً. تتبع الطريقة والمسار والمخطط والذاكرة والاستجابة وقارن فشل التحقق بجلب مورد مفقود.Explain in Arabic first. Trace method, path, schema, memory and response; contrast a validation failure with a missing-resource lookup. | افحص OpenAPI والتوثيق التفاعلي وجرب الحالات الصالحة وغير الصالحة والمفقودة وأكمل تأكيدات TestClient من عينة معادة.Inspect OpenAPI and interactive docs, exercise valid/invalid/missing cases, and complete focused TestClient assertions from a reset fixture. |
| تدريب موجّه للطلب والاستجابةGuided request/response practice | 60 | ممارسة موجّهةGuided practice | اعرض طلباً خيالياً مختلفاً واحداً واطلب توقعاً ثم قلل التلميحات قبل حالة المتعلم الخاصة.Model one different fictional request, ask for a prediction, then fade prompts before the learner's own case. | ابحث عن مخططات الطلب والاستجابة في OpenAPI ونفذ طلباً صالحاً في التوثيق ثم توقع 422 و404 والتقطهما منفصلين.Find request and response schemas in OpenAPI, execute one valid request in docs, then predict and capture 422 and 404 separately. |
| مختبر API في الذاكرة بإشرافSupervised in-memory API lab | 120 | مختبر خاضع للإشرافSupervised lab | افحص الدليل الفردي وفق جدول نقاط النهاية. أبقِ التخزين الدائم خارج النطاق وامنع دخول الرسائل الحقيقية أو بيانات الاتصال إلى اللقطات.Inspect individual evidence against the endpoint table. Keep persistence out of scope and prevent real messages or contact data entering captures. | أكمل مطالب الاختبار الأربعة بما فيها عدم التغيير عند مدخل غير صالح ومسارا السجل المفقود. شغّل مرتين من العينة والتقط التوثيق والمخطط الخام والرموز وأجسام الاستجابة.Complete the four test prompts, including no mutation on invalid input and both missing paths. Run twice from the fixture; capture docs, raw schema, statuses and response bodies. |
ملاحظات الشرحExplanation notes
التوثيق عقد قابل للاختبارDocumentation is a testable contract
تشكل مزخرفات المسارات وأنواع الطلب ونماذج الاستجابة المخطط المولد. قارن العمليات الأربع الموثقة بجدولك؛ فظهور صفحة التوثيق وحده لا يثبت السلوك. يشغل TestClient التطبيق محلياً دون خادم يستمع للشبكة. أعد العينة ذات الصفين بين الاختبارات كي لا يخفي ترتيبها فشلاً.Decorators, request types and response models shape the generated schema. Compare all four documented operations with your endpoint table; a rendered docs page alone does not prove their behavior. TestClient runs the application locally without a listening server. Restore the two-row fixture between tests so test order cannot hide a failure.
أمثلة العرضDemonstration examples
يجب أن تصف /docs و/openapi.json عمليات الإعلان الأربع نفسها؛ وتقارن الاختبارات الرمز وJSON الدقيق لا نص النجاح فقط./docs and /openapi.json must describe the same four notice operations; tests compare status plus exact JSON, not only success text.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- ابحث عن مخططات الطلب والاستجابة في OpenAPI ونفذ طلباً صالحاً في التوثيق ثم توقع 422 و404 والتقطهما منفصلين.Find request and response schemas in OpenAPI, execute one valid request in docs, then predict and capture 422 and 404 separately.
تيسير المختبرLab facilitation
- ابدأ من عينة الإعلانين وتوقع الرمز وJSON الاستجابة وتغييرات الذاكرة قبل التنفيذ.Start from the two-notice fixture and predict status, response JSON and memory changes before execution.
- أكمل مطالب الاختبار الأربعة بما فيها عدم التغيير عند مدخل غير صالح ومسارا السجل المفقود. شغّل مرتين من العينة والتقط التوثيق والمخطط الخام والرموز وأجسام الاستجابة.Complete the four test prompts, including no mutation on invalid input and both missing paths. Run twice from the fixture; capture docs, raw schema, statuses and response bodies.
- قارن الاستجابة الفعلية والمتوقعة وأصلح أول حد مختلف وكرر من ذاكرة نظيفة.Compare actual and expected responses, repair the first differing boundary, and repeat from clean memory.
- احفظ دليل الطلب والاستجابة الخيالي والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط.Save only fictional request/response evidence, reasoning and the AI-use or non-use note.
الأدلة المتوقعةExpected evidence
- قدّم مقارنة نقاط النهاية وOpenAPI وفئات الاستجابة الموثقة الثلاث وإعداد الذاكرة النظيفة وتشغيلَي الاختبار. اشرح بديل المخطط وTestClient دون اتصال.Submit the endpoint/OpenAPI comparison, three documented response classes, clean-memory setup and two repeated test runs. Explain the offline schema/TestClient fallback.
w7d4-docs-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
ابنِ نقاط نهاية موثقة في FastAPI باستخدام Pydantic وبيانات في الذاكرة قبل التخزين الدائم.Build documented FastAPI endpoints using Pydantic with in-memory data before persistence.
- تتحقق مخططات Pydantic من الطلبات وتصف الاستجابات.Pydantic schemas validate requests and describe responses.
- تستخدم نقاط النهاية في الذاكرة طرقاً ومسارات ورموز حالة مناسبة.In-memory endpoints use suitable methods, paths and status codes.
- يوضح التوثيق المولد طلباً صالحاً وإدخالاً غير صالح وسجلاً مفقوداً.Generated documentation demonstrates a valid request, invalid input and missing record.
الأخطاء الشائعةCommon errors
- إرجاع 200 مع نص خطأ بدلاً من 404 أو استجابة التحقق المحددة في العقد.Returning 200 with an error string instead of the contract's 404 or validation response.
- تجتاز المسافات فحص الطول لأن إزالتها متأخرة أو تتحول قيمة نصية بصمت إلى منطقية.Whitespace passes a length check because stripping happens too late, or a text value is silently converted to boolean.
- تعيد الاختبارات استخدام ذاكرة معدلة أو تدعي التخزين الدائم لأن العملية لم تعد تشغيلها.Tests reuse mutated memory or claim persistence because the process was never restarted.
تدخلات المدرّبTrainer interventions
- ارجع إلى جدول نقاط النهاية وحدد أول اختلاف بين المخطط والرمز وجسم الاستجابة.Return to the endpoint table and locate the first disagreement among schema, status and response body.
- أعد العينة وافحص طلباً واحداً عبر التحقق والجلب وتحويل الاستجابة.Reset the fixture and inspect one request through validation, lookup and serialization.
الاستدراكRecovery
خلال أسبوع واحد أصلح حد مخطط أو نقطة نهاية واحدة كل مرة وأعد التقاط النتائج الصالحة وغير الصالحة والمفقودة نفسها ثم أعد تقديم دليل التوثيق والاختبار.Within one week, repair one schema or endpoint boundary at a time, recapture the same valid/invalid/missing outcomes, and resubmit the documentation and 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
استخدم الإعلانات العامة الخيالية المقدمة فقط. أبقِ بيانات الاتصال الحقيقية والرسائل الخاصة والرموز السرية والسجلات التشغيلية خارج المصدر والسجلات والأمثلة والتوثيق المولد.Use only the supplied fictional public notices. Keep real contact data, private messages, tokens and operational records out of source, logs, examples and generated documentation.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي مقارنة مفاهيم HTTP بعد كتابة جدول نقاط النهاية. عليك تعريف المخططات وتنفيذ نقاط النهاية وتشغيل كل طلب موثق وشرح كل اقتراح مقبول؛ ولا تطلب حل التحقق الكامل.AI may compare HTTP concepts after you draft the endpoint table. You must define the schemas, implement the endpoints, run each documented request and explain every accepted suggestion; do not request the complete checkpoint solution.
نص التسجيلRecording script
السردNarration
- اشرح مقارنة العقد بالاستجابات الفعلية عبر طلب خيالي مختلف دون تقديم كود التحقق المكتمل.Explain Compare the contract with real responses through a different fictional request without giving completed checkpoint code.
إجراءات الشاشةScreen actions
- اعرض جدول نقاط النهاية وملفات النماذج والمسارات النسبية والتوثيق المحلي وOpenAPI الخام والاستجابات الاصطناعية. أخفِ علامات المتصفح غير المرتبطة وتفاصيل الحساب.Show the endpoint table, project-relative model/route files, local docs, raw OpenAPI and synthetic responses. Hide unrelated browser tabs and account details.
النصوص الظاهرةCaptions
- اكتب الطريقة والمسار وقيد الحقل والرمز ومعنى الاستجابة بالعربية أولاً ثم الإنجليزية.Caption method, path, field constraint, status and response meaning in Arabic first, then English.
نقاط التوقفPause points
- توقف قبل كل طلب للتوقع وقبل الالتقاط لفحص الخصوصية.Pause before each request for a prediction and before capture for a privacy scan.
قائمة التحقق من التسجيلRecording checklist
- تحقق من أربع عمليات وثلاثة نماذج ودليل الصالح وغير الصالح والمفقود وإعادة الذاكرة وعدم وجود قاعدة بيانات أو بيانات حقيقية ووضوح مسار الاستدراك. إذا غابت موارد التوثيق دون اتصال فاعرض OpenAPI الخام وTestClient ورتب التقاط التوثيق التفاعلي.Verify four operations, three models, valid/invalid/missing evidence, in-memory reset, no database, no real data and a visible recovery route. If docs assets are unavailable offline, demonstrate raw OpenAPI and TestClient and schedule the interactive-docs capture.
اليوم 5Day 5
اليوم 5 — التحقق الفردي لـAPI موثقةDay 5 — Individual documented API checkpoint
التحضيرPreparation
- أكمل عمل عمليات السجلات المتحقق منها للأسبوع السادس أو مسار الدعم المتفق عليه.Complete the Week 6 validated record-operation work or the agreed supported route.
- افتح حزمة بداية الأسبوع السابع دون تغيير باستخدام Python 3.11 أو أحدث والاعتماديات المثبتة. استخدم عملية محلية واحدة والإعلانين الخياليين؛ ولا تحتاج قاعدة بيانات.Open the unchanged Week 7 starter with Python 3.11 or newer and the pinned dependencies. Use a single local process and the two fictional notices; no database is required.
المواد المطلوبة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
- أنجز API الإعلانات الموثقة في الذاكرة فردياً وأثبت سلوك المخططات ونقاط النهاية والسجل المفقود وفق العقد المنشور.Independently produce the documented in-memory notice API and demonstrate schema, endpoint and missing-record behavior against the published contract.
جدول التنفيذ الدقيقExact run sheet
| الفقرةBlock | الدقائقMinutes | النمطMode | إجراء المدرّبTrainer action | إجراء المتعلّمLearner action |
|---|---|---|---|---|
| التحقق الفردي لـAPI موثقةIndividual documented API checkpoint | 300 | مختبر خاضع للإشرافSupervised lab | راقب التنفيذ الفردي وافحص المخططات ونقاط النهاية الأربع واطلب دليلاً مباشراً للحالات الصالحة وغير الصالحة والمفقودة ورتب الاستدراك دون تقديم الإجابات المكتملة.Observe independent implementation, inspect schemas and all four endpoints, require live valid/invalid/missing evidence, and arrange recovery without supplying completed answers. | انطلاقاً من البداية دون تغيير نفّذ النماذج الثلاثة ونقاط النهاية الأربع واعرض التوثيق المولد وفئات الاستجابة كلها وأعد الفحوص المركزة واشرح فقد الحالة عند إعادة التشغيل.From the unchanged starter, implement the three models and four endpoints, demonstrate the generated docs and all response classes, rerun focused checks, and explain state loss on restart. |
ملاحظات الشرحExplanation notes
دليل من API العاملةEvidence from the running API
يجمع التحقق الناجح مخططات طلب واستجابة محددة النوع وأربع عمليات صحيحة ونتائج صالحة وغير صالحة ومفقودة موثقة وشرحاً واضحاً للحالة المؤقتة. لا تكفي اللقطات المحفوظة أو فحوص البيئة؛ اعرض طلباً مباشرة واشرح أين يُحسم كل فشل.A passing checkpoint combines typed request/response schemas, four correct operations, documented valid/invalid/missing outcomes and a clear explanation of temporary state. Saved screenshots or passing environment checks alone are insufficient; demonstrate one request live and explain where each failure is decided.
أمثلة العرضDemonstration examples
201 للإنشاء؛ 200 للقائمة المرتبة والجلب وتحديث النشر؛ 422 لرفض المخطط؛ 404 للجلب المفقود؛ إعادة التشغيل تعيد إعلانين.201 create; 200 ordered list/get/publication update; 422 schema rejection; 404 missing lookup; restart restores two notices.تسلسل الشرائح والعرضSlide and demonstration sequence
تيسير الممارسة الموجّهةGuided-practice facilitation
- اقرأ المعايير وتوقع الحالات المنشورة وخطط للأدلة دون تلقي كود نقاط النهاية المكتمل.Read the criteria, predict the published cases, and plan evidence without receiving completed endpoint code.
تيسير المختبرLab facilitation
- ابدأ من عينة الإعلانين وتوقع الرمز وJSON الاستجابة وتغييرات الذاكرة قبل التنفيذ.Start from the two-notice fixture and predict status, response JSON and memory changes before execution.
- انطلاقاً من البداية دون تغيير نفّذ النماذج الثلاثة ونقاط النهاية الأربع واعرض التوثيق المولد وفئات الاستجابة كلها وأعد الفحوص المركزة واشرح فقد الحالة عند إعادة التشغيل.From the unchanged starter, implement the three models and four endpoints, demonstrate the generated docs and all response classes, rerun focused checks, and explain state loss on restart.
- قارن الاستجابة الفعلية والمتوقعة وأصلح أول حد مختلف وكرر من ذاكرة نظيفة.Compare actual and expected responses, repair the first differing boundary, and repeat from clean memory.
- احفظ دليل الطلب والاستجابة الخيالي والتعليل وملاحظة استخدام الذكاء الاصطناعي أو عدم استخدامه فقط.Save only fictional request/response evidence, reasoning and the AI-use or non-use note.
الأدلة المتوقعةExpected evidence
- قدّم المصدر وجدول نقاط النهاية وOpenAPI ولقطات الصالح وغير الصالح والمفقود والاختبارات المتكررة ودليل إعادة التشغيل وفحص الخصوصية وملاحظة استخدام الذكاء الاصطناعي؛ واشرح حداً للمخطط وحداً للسجل المفقود مباشرة.Submit source, the endpoint table, OpenAPI, valid/invalid/missing captures, repeated tests, restart evidence, privacy scan and AI-use note; explain one schema and one missing-record boundary live.
w7d5-checkpoint-evidence
معايير التحقق المنشورةPublished checkpoint criteria
مهمة التحقق المنشورةPublished checkpoint prompt
ابنِ نقاط نهاية موثقة في FastAPI باستخدام Pydantic وبيانات في الذاكرة قبل التخزين الدائم.Build documented FastAPI endpoints using Pydantic with in-memory data before persistence.
- تتحقق مخططات Pydantic من الطلبات وتصف الاستجابات.Pydantic schemas validate requests and describe responses.
- تستخدم نقاط النهاية في الذاكرة طرقاً ومسارات ورموز حالة مناسبة.In-memory endpoints use suitable methods, paths and status codes.
- يوضح التوثيق المولد طلباً صالحاً وإدخالاً غير صالح وسجلاً مفقوداً.Generated documentation demonstrates a valid request, invalid input and missing record.
الأخطاء الشائعةCommon errors
- إرجاع 200 مع نص خطأ بدلاً من 404 أو استجابة التحقق المحددة في العقد.Returning 200 with an error string instead of the contract's 404 or validation response.
- تجتاز المسافات فحص الطول لأن إزالتها متأخرة أو تتحول قيمة نصية بصمت إلى منطقية.Whitespace passes a length check because stripping happens too late, or a text value is silently converted to boolean.
- تعيد الاختبارات استخدام ذاكرة معدلة أو تدعي التخزين الدائم لأن العملية لم تعد تشغيلها.Tests reuse mutated memory or claim persistence because the process was never restarted.
تدخلات المدرّبTrainer interventions
- ارجع إلى جدول نقاط النهاية وحدد أول اختلاف بين المخطط والرمز وجسم الاستجابة.Return to the endpoint table and locate the first disagreement among schema, status and response body.
- أعد العينة وافحص طلباً واحداً عبر التحقق والجلب وتحويل الاستجابة.Reset the fixture and inspect one request through validation, lookup and serialization.
الاستدراكRecovery
خلال أسبوع واحد أصلح حد مخطط أو نقطة نهاية واحدة كل مرة وأعد التقاط النتائج الصالحة وغير الصالحة والمفقودة نفسها ثم أعد تقديم التحقق الفردي لـAPI الموثقة.Within one week, repair one schema or endpoint boundary at a time, recapture the same valid/invalid/missing outcomes, and resubmit the individual documented API checkpoint.
البديل عند الانقطاع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
استخدم الإعلانات العامة الخيالية المقدمة فقط. أبقِ بيانات الاتصال الحقيقية والرسائل الخاصة والرموز السرية والسجلات التشغيلية خارج المصدر والسجلات والأمثلة والتوثيق المولد.Use only the supplied fictional public notices. Keep real contact data, private messages, tokens and operational records out of source, logs, examples and generated documentation.
الذكاء الاصطناعي المسؤولResponsible AI
يمكن للذكاء الاصطناعي مقارنة مفاهيم HTTP بعد كتابة جدول نقاط النهاية. عليك تعريف المخططات وتنفيذ نقاط النهاية وتشغيل كل طلب موثق وشرح كل اقتراح مقبول؛ ولا تطلب حل التحقق الكامل.AI may compare HTTP concepts after you draft the endpoint table. You must define the schemas, implement the endpoints, run each documented request and explain every accepted suggestion; do not request the complete checkpoint solution.
نص التسجيلRecording script
السردNarration
- اشرح شرح كل حد من حدود HTTP عبر طلب خيالي مختلف دون تقديم كود التحقق المكتمل.Explain Explain every HTTP boundary through a different fictional request without giving completed checkpoint code.
إجراءات الشاشةScreen actions
- اعرض جدول نقاط النهاية وملفات النماذج والمسارات النسبية والتوثيق المحلي وOpenAPI الخام والاستجابات الاصطناعية. أخفِ علامات المتصفح غير المرتبطة وتفاصيل الحساب.Show the endpoint table, project-relative model/route files, local docs, raw OpenAPI and synthetic responses. Hide unrelated browser tabs and account details.
النصوص الظاهرةCaptions
- اكتب الطريقة والمسار وقيد الحقل والرمز ومعنى الاستجابة بالعربية أولاً ثم الإنجليزية.Caption method, path, field constraint, status and response meaning in Arabic first, then English.
نقاط التوقفPause points
- توقف قبل كل طلب للتوقع وقبل الالتقاط لفحص الخصوصية.Pause before each request for a prediction and before capture for a privacy scan.
قائمة التحقق من التسجيلRecording checklist
- تحقق من أربع عمليات وثلاثة نماذج ودليل الصالح وغير الصالح والمفقود وإعادة الذاكرة وعدم وجود قاعدة بيانات أو بيانات حقيقية ووضوح مسار الاستدراك. إذا غابت موارد التوثيق دون اتصال فاعرض OpenAPI الخام وTestClient ورتب التقاط التوثيق التفاعلي.Verify four operations, three models, valid/invalid/missing evidence, in-memory reset, no database, no real data and a visible recovery route. If docs assets are unavailable offline, demonstrate raw OpenAPI and TestClient and schedule the interactive-docs capture.