AI FOR PALESTINEAI for Palestine × TAQAT × BrightGaza

مساحة المتعلّمLearner space

أسس التكامل مع الذكاء الاصطناعيAI Integration Foundations

مسار تعلم عربي أولاً لتهيئة أسبوع الصفر واثني عشر أسبوعاً تقنياً. لا يوجد اختبار دخول في الإنجليزية أو البرمجة أو الذكاء الاصطناعي.Arabic-first learning pathway for Week 0 setup and twelve technical weeks. There is no English, programming or AI entrance test.

تتبّع تعليمي ذاتي محفوظ على جهازك. ليس حضوراً رسمياً، ولا درجة، ولا اجتيازاً للبوابة، وليس نتيجة شهادة.Self-reported learning tracker stored on your device. It is not official attendance, a score, Foundation Gate passage, or a certificate result.

جارٍ تحميل تتبعك المحلي…Loading your local learning tracker…

0%أدلة التعلّم الذاتيةSelf-reported learning evidence0 / 29

ابدأ بالأسبوع صفرStart with Week 0

الأسبوع صفر إلزامي، غير مُقيّم بدرجات، ومدته يومان للتحقق من الحاسوب والشاحن والأدوات والحسابات وطلب الدعم عند الحاجة.Week 0 is mandatory, ungraded, and runs for two days to check the laptop, charger, tools, accounts and access to support when needed.

مسارك خلال 12 أسبوعاًYour 12-week pathway

0الإعداد والجاهزيةSetup and Readinessتجهيز حاسوب آمن وقابل للاستخدام والتدرّب على سير العمل الأساسي المطلوب للأسبوع الأول.Prepare a safe, usable laptop and practise the basic workflow needed for Week 1.غير مُقيّم بدرجاتUngraded

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام الإعداد والجاهزيةComplete Setup and Readiness
افتح الحزمة التعليمية الكاملةOpen complete course pack

تهيئة الجاهزية ليومينTwo-day readiness setup

اليوم الأول — الوصول والمشاركة والإعداد الآمنDay 1 — access, participation and safe setup

  • افحص الحاسوب والشاحن والاتصال وأي احتياج للمعدات أو الدعم، ثم اتفق على خطة دعم عملية.Check the laptop, charger, connectivity and any equipment or support need, then agree a practical support plan.
  • أنشئ الحسابات المطلوبة وتعرّف إلى إجراءات الحضور والإبلاغ عن الغياب وتدرّب على نظام مساحة العمل المشتركة.Create required accounts, learn attendance and absence reporting, and practise the shared-workspace routine.
  • أنشئ مجلدات المساق وأكمل تدريب الاستخدام الآمن للمتصفح والتنزيلات.Create the course folders and complete safe browser and download practice.

اليوم الثاني — الأدوات والتواصل وتشغيل Python الأولDay 2 — tools, communication and first Python run

  • ثبّت المحرر وPython وGit وتحقق منها مع إبقاء أسرار الحسابات خاصة.Install and verify the editor, Python and Git while keeping account secrets private.
  • شغّل أوامر الطرفية الأولى ونشاط الترحيب في Python.Run the first terminal commands and Python welcome activity.
  • أعد إنتاج خطأ مقصود واحد وأرسل طلب مساعدة آمناً ومنظماً.Reproduce one deliberate error and send a safe, structured help request.

العمل الموجّهGuided work

أساسيات الحاسوب والملفات والمتصفحLaptop, files and browser basics

العثور على معلومات الجهاز وإدارة المجلدات والتنزيلات واستخدام ألسنة المتصفح بأمان.Find device information, manage folders and downloads, and use browser tabs safely.

يمنع تنظيم المجلدات ومعرفة موقع التنزيل ضياع العمل. يُشرح شريط العنوان والألسنة والنطاقات الموثوقة بالعربية مع تقديم مسمياتها الإنجليزية.A predictable folder structure and known download location prevent lost work. Browser address bars, tabs and trusted domains are demonstrated in Arabic while their English labels are introduced.

  • أنشئ مجلد البرنامج وفيه مجلدات فرعية للكود والبيانات والأدلة.Create a pilot folder with code, data and evidence subfolders.
  • نزّل ملفاً عاماً تجريبياً وانقله إلى مجلد البيانات وامنحه اسماً واضحاً.Download a public sample file, move it to data and rename it clearly.

الأدوات والحسابات والتعامل مع الأسرارTools, accounts and secret handling

تثبيت الأدوات المعتمدة وإنشاء الحسابات المطلوبة والدخول إليها وإبعاد بيانات الدخول عن الملفات المشتركة.Install the approved tools, create and access required accounts, and keep credentials out of shared files.

يوضّح المدرّب الفرق بين اسم المستخدم العام وكلمة المرور أو الرمز أو مفتاح API الخاص، وكيفية طلب المساعدة دون كشف سر.The trainer distinguishes a public username from a private password, token or API key and models how to ask for help without sharing a secret.

  • ثبّت محرر النصوص وPython وGit ثم تحقّق من إصدار كل أداة.Install the editor, Python and Git, then verify each version.
  • أنشئ حسابي التعلّم واستضافة الكود وتحقق من الوصول إليهما وفعّل حماية الحساب المتاحة.Create the learning and code-hosting accounts, verify access and enable available account protection.

الحضور ومساحة العمل وخطة الدعمAttendance, workspace and support plan

اتباع إجراءات المشاركة وتحديد احتياجات المعدات أو الدعم مبكراً.Follow participation procedures and identify equipment or support needs early.

يتدرّب المتعلمون على تسجيل الحضور والإبلاغ عن الغياب والحفاظ على سلامة مساحة العمل المشتركة وترك الملفات جاهزة للجلسة التالية. ويُتفق على دعم المعدات أو سهولة الوصول بصورة خاصة دون تحويله إلى اختبار قبول.Learners practise checking in, reporting an absence, keeping the shared workspace safe and leaving files ready for the next session. Equipment or accessibility support is agreed privately without making it an admission test.

  • أكمل تسجيل حضور تجريبياً وأرسل رسالة غياب نموذجية عبر القناة المعتمدة.Complete a mock check-in and send a sample absence message through the approved channel.
  • استخدم تحقق الدعم الخاص لتحديد احتياجات الشاحن أو الاتصال أو جهاز الإدخال أو الشاشة أو الجلوس أو أي دعم تعلّم آخر.Use the private support check to identify charger, connectivity, input-device, display, seating or other learning support needs.
  • تدرّب على قائمة إجراءات بداية اليوم ونهايته في مساحة العمل المشتركة.Practise the start-of-day and end-of-day shared-workspace checklist.

الأمر الأول ونشاط Python وطلب المساعدةFirst command, Python activity and help request

تشغيل أمر وتنفيذ ملف Python صغير وشرح الخطأ بوضوح.Run a command, execute a small Python file and communicate an error clearly.

الأوامر تعليمات مكتوبة. رسائل الخطأ أدلة تُقرأ وتُشارك بعد إزالة المسارات الشخصية أو الأسرار، وليست دليلاً على الفشل.Commands are typed instructions. Error messages are evidence to read and share after removing personal paths or secrets, not signs of failure.

  • استخدم الطرفية لإظهار المجلد الحالي وإصدار Python.Use the terminal to show the current folder and Python version.
  • شغّل ملف Python يطلب اسماً للعرض ثم يطبع رسالة ترحيب.Run a Python file that asks for a display name and prints a welcome message.

جولة التحقق من الجاهزيةReadiness walkthrough

على مدى يومي تهيئة إلزاميين غير مُقيّمين بدرجات، أكمل جاهزية المشاركة والحسابات والمعدات والأدوات، ثم شغّل الأمر الأول ونشاط Python باستخدام اسم عرض خيالي.Across two mandatory, ungraded orientation days, complete participation, account, equipment and tool readiness, then run the first command and Python activity using a fictional display name.

  1. في اليوم الأول، تحقّق من نظام التشغيل والمساحة المتاحة والشاحن والاتصال وأي متابعة للمعدات أو الدعم.On Day 1, confirm the operating system, free disk space, charger, connectivity and any equipment or support follow-up.
  2. أنشئ الحسابات المطلوبة واعرض إجراءات الحضور والإبلاغ عن الغياب ومساحة العمل المشتركة.Create required accounts and demonstrate attendance, absence-reporting and shared-workspace procedures.
  3. أنشئ بنية المجلدات المتفق عليها وحدد مكان عينة عامة تم تنزيلها.Create the agreed folder structure and locate a downloaded public sample.
  4. في اليوم الثاني، تحقّق من تثبيت المحرر وPython وGit دون كشف بيانات الدخول.On Day 2, verify the editor, Python and Git installations without exposing credentials.
  5. شغّل برنامج الترحيب وقدّم طلب مساعدة منظماً وآمناً لخطأ مقصود واحد.Run the welcome script and submit a safe, structured help request for one deliberate error.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

بعد يومي التهيئة، اعرض قائمة الجاهزية وكرّر الأمر الأول ونشاط Python. كلا اليومين إلزامي وغير مُقيّم بدرجات.After both orientation days, demonstrate the readiness checklist and repeat the first command and Python activity. Both days are mandatory and ungraded.

  • المعدات والاتصال جاهزان أو تم ترتيب متابعة دعم خاصة.Equipment and connectivity are ready or a private support follow-up is arranged.
  • تعمل الحسابات المطلوبة وتُفهم إجراءات الحضور والغياب ومساحة العمل المشتركة.Required accounts work and attendance, absence and shared-workspace procedures are understood.
  • تفتح الأدوات المطلوبة وتعمل أوامر التحقق من الإصدارات.Required tools open and version checks run.
  • يمكن العثور على المجلدات وتنزيلات المتصفح دون مساعدة.Folders and browser downloads can be found without assistance.
  • يعمل نشاط Python ويشرح المتعلّم كيف يطلب المساعدة دون كشف الأسرار.The Python activity runs and the learner describes how to request help without exposing secrets.

إذا نقص أي دليل للجاهزية، استخدم محطة التثبيت بدعم المدرّب وكرّر بند القائمة الناقص فقط قبل الأسبوع الأول.If any readiness evidence is missing, use the trainer-supported installation station and repeat only the missing checklist item before Week 1.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

استخدم العينة العامة المقدمة واسم عرض خيالياً فقط؛ ولا تضع كلمة مرور أو رمزاً أو رقم هوية أو رسالة خاصة في لقطات الشاشة أو الكود.Use only the supplied public sample and a fictional display name; never place a password, token, ID number or private message in screenshots or code.

يمكن للذكاء الاصطناعي ترجمة اسم أداة أو شرح خطأ بعد إزالة الأسرار والمسارات الشخصية؛ وعلى المتعلّم تشغيل كل أمر وشرحه بنفسه.AI may translate a tool label or explain an error after secrets and personal paths are removed; the learner must run and explain every command personally.

الإنجليزية التقنيةTechnical English

  • مجلد لحفظ الملفات وتنظيمهاfolder
  • متصفح لفتح مواقع الويبbrowser
  • طرفية لكتابة الأوامرterminal
  • تعليمة مكتوبة ينفذها الحاسوبcommand
  • قيمة خاصة مثل كلمة المرور أو مفتاح APIsecret
01البداية مع PythonPython Starts Hereتحويل إدخال بسيط من المستخدم إلى قرار تم التحقق منه ونتيجة مفيدة في سطر الأوامر.Turn simple user input into a validated decision and a useful console result.

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام البداية مع PythonComplete Python Starts Here
افتح الحزمة التعليمية الكاملةOpen complete course pack

العمل الموجّهGuided work

الإدخال والقيم والتحققInput, values and validation

قراءة إدخال نصي وتحويل قيمة بسيطة ورفض الإدخال غير الصالح.Read text input, convert a simple value and reject unusable input.

يكون إدخال Python نصاً حتى يتم تحويله. يحمي التحقق القرار من القيم الفارغة أو غير الرقمية أو الخارجة عن النطاق.Python input is text until it is converted. Validation protects the decision from blank, non-numeric or out-of-range values.

  • تتبّع ثلاث قيم إدخال مقدمة خلال عملية التحويل.Trace three supplied inputs through conversion.
  • أضف رسالة واضحة لقيمة عمر غير صالحة.Add a clear message for an invalid age value.

القرارات والمخرجات المفيدةDecisions and useful output

استخدام تفرع شرطي وشرح المسار الذي تم تنفيذه.Use a conditional branch and explain which path ran.

يُقيّم الشرط إلى صحيح أو خطأ. ينبغي أن يمنح كل فرع المستخدم خطوة تالية محددة لا رسالة نجاح مبهمة.A condition evaluates to true or false. Each branch should give the user a specific next step, not a vague success message.

  • توقّع المخرجات لقيم صالحة على جانبي حد القرار.Predict output for valid values on both sides of a threshold.
  • أعد صياغة رسالة طباعة مبهمة لتصبح نتيجة قابلة للتنفيذ.Rewrite one vague print message as an actionable result.

برنامج سطر أوامر للإدخال والقراراتInput/decision console program

ابنِ مساعد أهلية في سطر الأوامر لورشة عامة خيالية باستخدام عمر اصطناعي للمشارك فقط.Build a console eligibility helper for a fictional public workshop using only a participant's synthetic age.

  1. اقرأ العمر كإدخال.Read the age as input.
  2. تحقّق من أنه عدد صحيح ضمن النطاق المحدد.Validate that it is a whole number in the stated range.
  3. نفّذ تفرعاً بناءً على قاعدة العمر المنشورة للورشة.Branch on the workshop's published age rule.
  4. اطبع رسالة مفيدة للأهلية أو التصحيح وشغّل أمثلة عند حدود القرار.Print a useful eligibility or correction message and run boundary examples.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

اقرأ إدخالاً وتحقق من قيمة بسيطة ونفّذ تفرعاً لاتخاذ قرار واطبع نتيجة مفيدة.Read input, validate a simple value, branch on a decision, and print a useful result.

  • يُرفض الإدخال غير الصالح برسالة تصحيحية.Invalid input is rejected with a corrective message.
  • ينتج الشرط الفرع الصحيح عند الحد.The condition produces the correct branch at the boundary.
  • توضح المخرجات القرار والخطوة التالية المناسبة.Output states the decision and an appropriate next step.

إذا لم يكتمل التحقق، املأ جدول الإدخال والمخرجات المتوقعة الذي يقدمه المدرّب، وصحّح مساراً فاشلاً، ثم أعد تقديم عمليات التشغيل الثلاث نفسها.If the checkpoint fails, complete a trainer-provided input/expected-output table, correct one failing path, and resubmit the same three console runs.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

استخدم أعماراً مختلقة فقط؛ ولا تجمع أسماء أو تواريخ ميلاد أو أرقام هوية أو قرارات أهلية حقيقية.Use invented ages only; do not collect names, dates of birth, IDs or real eligibility decisions.

يمكن للذكاء الاصطناعي شرح الصياغة بعد أن تكتب جدول القرار؛ وعليك كتابة منطق التفرع النهائي وتشغيله وشرحه.AI may explain syntax after you write the decision table; you must type, run and explain the final branch logic.

الإنجليزية التقنيةTechnical English

  • قيمة يدخلها المستخدمinput
  • يتحقق من صلاحية القيمةvalidate
  • شرط تكون نتيجته صحيحة أو خاطئةcondition
  • مسار يُختار بناءً على شرطbranch
  • نتيجة يعرضها البرنامجoutput
02الدوال وهياكل البياناتFunctions and Dataتنظيم منطق معالجة السجلات في دوال صغيرة باستخدام القوائم والقواميس.Organise record-processing logic into small functions using lists and dictionaries.

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام الدوال وهياكل البياناتComplete Functions and Data
افتح الحزمة التعليمية الكاملةOpen complete course pack

العمل الموجّهGuided work

القوائم والقواميسLists and dictionaries

تمثيل عدة سجلات اصطناعية بصورة متسقة والوصول إلى حقولها.Represent several synthetic records consistently and access their fields.

يمنح القاموس السجل حقولاً مسماة، وتحفظ القائمة عدة سجلات بالترتيب. تتيح أسماء الحقول الثابتة التحقق لاحقاً.A dictionary gives one record named fields; a list keeps multiple records in order. Stable field names make later validation possible.

  • أنشئ ثلاثة سجلات مخزون خيالية من دليل الحقول المقدم.Create three fictional inventory records from a supplied field guide.
  • مرّ على القائمة واطبع حقلاً واحداً محدداً.Loop through the list and print one selected field.

الدوال الصغيرة والقيم المعادةSmall functions and return values

فصل مسؤوليات التحقق والمعالجة والعرض.Separate validation, processing and display responsibilities.

ينبغي أن يكون لكل دالة عمل واضح واحد ومعاملات مسماة وقيمة معادة تستطيع دالة أخرى استخدامها.Each function should have one clear job, named parameters and a return value that another function can use.

  • استخرج حساب السعر المتكرر في دالة.Extract repeated price calculation into a function.
  • تتبّع سجلاً خلال دالتي التحقق والمعالجة.Trace a record through validation and processing functions.

معالج سجلات معياريModular record processor

أعد تنظيم معالج مخزون لمطبخ مجتمعي خيالي إلى دوال تعمل على قائمة من القواميس.Refactor a fictional community-kitchen stock processor into functions that operate on a list of dictionaries.

  1. مثّل سجلات المخزون الاصطناعية المقدمة كقواميس داخل قائمة.Represent the supplied synthetic stock records as dictionaries in a list.
  2. اكتب دالة تتحقق من الحقول المطلوبة ومن أن الكمية غير سالبة.Write a function that validates required fields and non-negative quantity.
  3. اكتب دالة تحسب ملخصاً من السجلات الصالحة.Write a function that calculates a summary from valid records.
  4. اكتب دالة عرض وأثبت أن السجلات المرفوضة لا تؤثر في النتيجة.Write a display function and prove that rejected records do not affect the result.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

قسّم برنامج معالجة سجلات إلى دوال باستخدام القوائم والقواميس.Split a record-processing program into functions using lists and dictionaries.

  • تستخدم السجلات حقول قاموس متسقة داخل قائمة.Records use consistent dictionary fields inside a list.
  • التحقق والمعالجة دالتان منفصلتان بقيم معادة مفيدة.Validation and processing are separate functions with useful return values.
  • يعالج البرنامج السجلات الصالحة ويستبعد غير الصالحة من الملخص.The program processes valid records and excludes invalid ones from the summary.

إذا كانت الأدلة غير مكتملة، أضف إلى مخطط الدوال المدخلات والقيم المعادة، ثم افصل مسؤولية واحدة كل مرة وأعد تشغيل قائمة السجلات المختلطة نفسها.If evidence is incomplete, annotate the function diagram with inputs and returns, refactor one responsibility at a time, and rerun the same mixed record list.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

استخدم سجلات المخزون الخيالية المقدمة في الصف؛ ولا تستخدم سجلات مستفيدين أو متبرعين أو أسر.Use the fictional stock records supplied in class; do not use beneficiary, donor or household records.

يمكن للذكاء الاصطناعي اقتراح أسماء للدوال بعد رسم مخطط الدوال؛ وعليك تحديد المسؤوليات والتحقق من كل قيمة معادة.AI may suggest function names after you draw the function diagram; you must decide the responsibilities and verify every returned value.

الإنجليزية التقنيةTechnical English

  • مجموعة مرتبة من القيمlist
  • سجل من مفاتيح وقيمdictionary
  • جزء مسمى من الكود يؤدي مهمةfunction
  • اسم يستقبل قيمة داخل الدالةparameter
  • قيمة تعيدها الدالةreturn
03الملفات وJSON ومعالجة الأخطاءFiles, JSON and Errorsقراءة ملفات JSON بصورة دفاعية وفصل السجلات غير الصالحة وكتابة ملف نتائج موثوق.Read JSON files defensively, separate malformed records and write a trustworthy result file.

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام الملفات وJSON ومعالجة الأخطاءComplete Files, JSON and Errors
افتح الحزمة التعليمية الكاملةOpen complete course pack

العمل الموجّهGuided work

JSON وحدود الملفاتJSON and file boundaries

تحميل مستند JSON والتمييز بين أخطاء الملف والصياغة وشكل السجل.Load a JSON document and distinguish file, syntax and record-shape errors.

قد يكون الملف قابلاً للقراءة لكنه يحتوي JSON غير صالح، وقد تكون صياغة JSON صالحة مع حقول ناقصة أو من نوع خاطئ. يحتاج كل حد إلى تحقق مستقل.A readable file can still contain invalid JSON, and valid JSON can still have missing or wrongly typed fields. Each boundary needs a separate check.

  • أصلح الصياغة في عينة عامة معطوبة عمداً.Repair syntax in a deliberately broken public fixture.
  • صنّف أربعة أعطال إلى خطأ ملف أو صياغة JSON أو تحقق من السجل.Classify four failures as file, JSON syntax or record validation errors.

الوحدات والاستيراد والحزمModules, imports and packages

تقسيم الكود القابل لإعادة الاستخدام في وحدة والتمييز بين الوحدة المحلية ووحدة المكتبة القياسية والحزمة المثبتة.Split reusable code into a module and distinguish a local module, standard-library module and installed package.

الوحدة ملف Python يمكن استيراده. تجمع الحزمة وحدات قابلة لإعادة الاستخدام وقد تُثبّت كاعتمادية؛ وتسجيل اسم الحزمة وإصدارها يجعل إعداد متعلّم آخر قابلاً للتكرار.A module is a Python file that can be imported. A package groups reusable modules and may be installed as a dependency; recording the package and version makes another learner's setup repeatable.

  • انقل دالة التحقق من السجلات إلى وحدة محلية واستوردها من أداة الملفات.Move the record validator into a local module and import it from the file tool.
  • استخدم وحدة json من المكتبة القياسية وحدد من أين يُحل استيرادها.Use the standard-library json module and identify where its import is resolved.
  • ثبّت حزمة اختبار معتمدة في بيئة المشروع وسجّل الاعتمادية الدقيقة.Install an approved test package in the project environment and record the exact dependency.

السجلات الصالحة وملفات النتائجValid records and result files

معالجة السجلات الصالحة فقط وكتابة مخرجات JSON قابلة لإعادة الإنتاج.Process only valid records and write reproducible JSON output.

ينبغي عدّ السجلات المرفوضة مع أسباب آمنة. ويجب أن يحتوي ملف المخرجات على نتائج مشتقة لا أن ينسخ الإدخال المعطوب بصمت.Rejected records should be counted with safe reasons. The output file should contain derived results, not silently copy malformed input.

  • رشّح قائمة مختلطة باستخدام دالة تحقق الأسبوع الثاني.Filter a mixed list with the Week 2 validator.
  • اكتب ملخصاً ثم أعد فتحه للتأكد من بنيته.Write a summary and reopen it to confirm its structure.

أداة ملفات JSON تم التحقق منهاValidated JSON file tool

ابنِ أداة ملفات لفهرس مكتبة عامة اصطناعي يحتوي سجلات صالحة وأخرى معطوبة.Build a file tool for a synthetic public-library catalogue containing valid and malformed records.

  1. حمّل ملف JSON المقدم مع معالجة صريحة لغياب الملف ولصياغة JSON غير الصالحة.Load the supplied JSON file with explicit handling for a missing file and invalid JSON.
  2. تحقّق من الحقول المطلوبة وأنواعها لكل سجل في الفهرس.Validate required fields and types for every catalogue record.
  3. انقل التحقق إلى وحدة محلية مستوردة وسجّل اعتمادية حزمة الاختبار المعتمدة.Move validation into an imported local module and record the approved test-package dependency.
  4. ارفض السجلات المعطوبة مع أسباب آمنة وعالج السجلات الصالحة فقط.Reject malformed records with safe reasons and process only valid records.
  5. اكتب ملف نتائج JSON وأعد فتحه وافحصه مع أعداد السجلات الصالحة والمرفوضة.Write, reopen and inspect a JSON result file with valid and rejected counts.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

حمّل JSON وارفض السجلات المعطوبة وعالج السجلات الصالحة واكتب ملف نتائج.Load JSON, reject malformed records, process valid records, and write a result file.

  • ينتج عن غياب الملف وJSON غير الصالح رسائل مضبوطة.Missing-file and invalid-JSON failures produce controlled messages.
  • تُستبعد السجلات المعطوبة وتُعالج السجلات الصالحة بصورة صحيحة.Malformed records are excluded and valid records are processed correctly.
  • يُعاد فتح الناتج كـJSON صالح وتتطابق أعداده.The written result reopens as valid JSON and its counts reconcile.

إذا كانت النتيجة خاطئة، شغّل عينات السجل الواحد بالترتيب، وأصلح أول حد يفشل، ثم أعد إنشاء ملف النتائج نفسه وافتحه.If the result is wrong, run the supplied one-record fixtures in order, repair the first failing boundary, then regenerate and reopen the same result file.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

استخدم عينة الفهرس الاصطناعية فقط؛ ويجب ألا تحتوي مسارات الملفات أو صور الأخطاء أو المخرجات على أسماء أو معرفات حسابات أو مستندات خاصة.Use only the synthetic catalogue fixture; file paths, error captures and outputs must not contain names, account IDs or private documents.

يمكن للذكاء الاصطناعي شرح خطأ منسوخ بعد حجب المسارات والبيانات؛ وعليك تصنيف الحد واختيار قاعدة التحقق وفحص ملف المخرجات.AI may explain a copied error after paths and data are redacted; you must classify the boundary, choose the validation rule and verify the output file.

الإنجليزية التقنيةTechnical English

  • صيغة نصية منظمة لتبادل البياناتJSON
  • يقرأ النص ويحوله إلى بنية بياناتparse
  • معطوب أو مخالف للبنية المتوقعةmalformed
  • حدث يوقف المسار المعتاد للكودexception
  • ملف تُكتب فيه نتائج المعالجةresult file
  • ملف Python يحوي كوداً قابلاً للاستيرادmodule
  • مجموعة وحدات قابلة للتثبيت وإعادة الاستخدامpackage
  • تعليمة تتيح استخدام كود من وحدة أخرىimport
04Git والاختبار والمراجعةGit, Testing and Reviewإجراء تغيير مختبر في فرع ومراجعة الفروقات وشرح مساعدة الذكاء الاصطناعي بشفافية.Make a tested change in a branch, review its diff and communicate AI assistance transparently.

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام Git والاختبار والمراجعةComplete Git, Testing and Review
افتح الحزمة التعليمية الكاملةOpen complete course pack

العمل الموجّهGuided work

المستودع والفرع والفروقاتRepository, branch and diff

إنشاء إيداعات قابلة للتتبع على فرع ميزة وقراءة الأسطر المتغيرة.Create traceable commits on a feature branch and read the changed lines.

يسجل Git لقطات من العمل. يعزل الفرع التغيير، والفروقات هي الدليل الذي يُفحص قبل الدمج، بما في ذلك تغييرات اقترحها الذكاء الاصطناعي.Git records snapshots. A branch isolates work; a diff is the evidence to inspect before merging, including changes suggested by AI.

  • أنشئ مستودعاً وأودع دالة بداية مقدمة.Create a repository and commit a supplied starter function.
  • أجر تغييراً صغيراً في فرع واشرح كل جزء من الفروقات.Make a small branch change and explain each diff hunk.

اختبارات الدالة ومراجعة طلب السحبFunction tests and pull-request review

كتابة اختبارات مركزة وفتح طلب سحب واضح والاستجابة لأدلة المراجعة.Write focused tests, open a clear pull request and respond to review evidence.

يسمي الاختبار المفيد السلوك المتوقع ويتضمن حداً. يربط طلب السحب بين السبب والتغيير ونتيجة الاختبار وملاحظة استخدام الذكاء الاصطناعي.A useful test names expected behaviour and includes a boundary. A pull request connects the reason, change, test result and AI-use note.

  • اكتب اختباراً للحالة العادية وآخر للحد للدالة المختارة.Write a normal-case and boundary test for the selected function.
  • راجع فروقات نموذجية واترك تعليقاً واحداً مستنداً إلى دليل.Review a sample diff and leave one evidence-based comment.

اعتماديات الحزم تحت المراجعةPackage dependencies under review

إعادة إنشاء بيئة المشروع من سجل الاعتماديات ومراجعة تغييرات الحزم كجزء من الفروقات.Recreate the project environment from its dependency record and review package changes as part of the diff.

لا يحمل المستودع البيئة المثبتة نفسها، بل يسجل الحزم اللازمة لإعادة إنشائها، وتُظهر فروقات طلب السحب الاعتماديات المضافة أو المحذوفة أو المتغيرة للمراجعة.A repository does not carry an installed environment. It records the packages needed to reproduce it, while the pull-request diff makes added, removed or changed dependencies visible for review.

  • أنشئ بيئة مشروع نظيفة وثبّت من سجل الاعتماديات فقط.Create a clean project environment and install only from the dependency record.
  • راجع فروقات اعتماديات نموذجية واشرح غرض كل تغيير في الحزم.Review a sample dependency diff and explain the purpose of each package change.
  • شغّل اختبارات الدالة من البيئة المعاد إنشاؤها.Run the function tests from the recreated environment.

طلب سحب للمستودع تم اختبارهTested repository pull request

انقل أداة التحقق من الفهرس الاصطناعي إلى مستودع واختبر دالة واحدة وراجع التغيير عبر طلب سحب.Move the synthetic catalogue validator into a repository, test one function and review the change through a pull request.

  1. أنشئ المستودع وأضف README مركزة وأودع النسخة الأساسية العاملة.Create the repository, add a focused README and commit the working baseline.
  2. أنشئ فرع ميزة وأضف اختبارات عادية وغير صالحة وحدية لدالة واحدة.Create a feature branch and add normal, invalid and boundary tests for one function.
  3. أعد إنشاء البيئة من سجل الاعتماديات وأدرج أي تغيير في الحزم ضمن مراجعة الفروقات.Recreate the environment from the dependency record and include any package change in diff review.
  4. افتح طلب سحب يشرح التغيير وأمر الاختبار وأي مساعدة من الذكاء الاصطناعي.Open a pull request that explains the change, test command and any AI assistance.
  5. راجع الفروقات سطراً سطراً وعالج تعليقاً واحداً وسجّل نجاح الاختبار النهائي.Review the diff line by line, address one comment and record the final passing test.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

أنشئ مستودعاً وفرعاً واختبر دالة وافتح طلب سحب وراجع الفروقات واشرح التغييرات التي ساعد فيها الذكاء الاصطناعي.Create a repository, branch, test a function, open a pull request, review a diff, and explain AI-assisted changes.

  • يُظهر سجل المستودع نسخة أساسية وفرع ميزة مركزاً.Repository history shows a baseline and a focused feature branch.
  • تتضمن اختبارات الدالة حداً وتنجح باستخدام الأمر الموثق.The function tests include a boundary and pass from the documented command.
  • يشرح طلب السحب الفروقات والرد على المراجعة والمساعدة الدقيقة من الذكاء الاصطناعي أو يذكر عدم استخدامها.The pull request explains the diff, review response and exact AI assistance or states that none was used.

إذا كانت الأدلة غير مكتملة، أعد إنشاء التغيير باستخدام خريطة فروع يقدمها المدرّب، وشغّل الاختبار الموثق، ثم حدّث طلب السحب نفسه بالفروقات وشرح استخدام الذكاء الاصطناعي.If the evidence is incomplete, recreate the change on a trainer-provided branch map, run the documented test, then update the same pull request with a diff and AI-use explanation.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

يجب أن يحتوي المستودع على عينة الفهرس الاصطناعية فقط؛ افحص الملفات المجهزة والفروقات بحثاً عن بيانات الدخول والمسارات الشخصية والسجلات الخاصة قبل الرفع.The repository must contain only the synthetic catalogue fixture; inspect staged files and the diff for credentials, personal paths and private records before pushing.

يُسمح بالكود الذي ساعد فيه الذكاء الاصطناعي فقط عندما يحدد طلب السحب ما تم اقتراحه وما عُدّل وكيف تحققت منه الاختبارات ومراجعة الفروقات.AI-assisted code is allowed only when the pull request identifies what was suggested, what was changed, and how tests and diff review verified it.

الإنجليزية التقنيةTechnical English

  • مكان يحفظ الكود وتاريخهrepository
  • مسار عمل معزول داخل المستودعbranch
  • لقطة مسماة من التغييراتcommit
  • طلب لمراجعة تغيير ودمجهpull request
  • عرض للأسطر المضافة والمحذوفةdiff
  • حزمة يعتمد عليها المشروع للعملdependency
  • مساحة معزولة لتثبيت حزم المشروع وتشغيلهenvironment
05البيانات العلائقية وSQLRelational Data and SQLنمذجة بيانات مترابطة بهويات وعلاقات وقيود صريحة ثم الإجابة عن أسئلة باستخدام SQL.Model related data with explicit identity, relationships and constraints, then answer questions with SQL.

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام البيانات العلائقية وSQLComplete Relational Data and SQL
افتح الحزمة التعليمية الكاملةOpen complete course pack

العمل الموجّهGuided work

الجداول والمفاتيح والعلاقاتTables, keys and relationships

فصل ثلاثة كيانات وربطها دون تكرار الحقائق.Separate three entities and connect them without duplicating facts.

يعرّف المفتاح الأساسي صفاً. ويشير المفتاح الخارجي إلى صف آخر، فتُحفظ الحقائق المشتركة في جدول واحد وتبقى العلاقات قابلة للتحقق.A primary key identifies a row. A foreign key points to another row, so shared facts belong in one table and relationships remain checkable.

  • صنّف حقول ورشة خيالية مقدمة إلى كيانات المشارك والجلسة والحجز.Sort supplied fictional workshop fields into participant, session and booking entities.
  • ارسم أسهم المفاتيح الأساسية والخارجية للجداول الثلاثة.Draw primary-key and foreign-key arrows for the three tables.

القيود وأسئلة SQLConstraints and SQL questions

حماية قواعد البيانات الأساسية واسترجاع نتائج مترابطة.Protect basic data rules and retrieve joined results.

ترفض قيود NOT NULL وUNIQUE وCHECK الحالات المستحيلة. وتحول استعلامات SELECT وJOIN والتجميع الصفوف المخزنة إلى دليل لسؤال محدد.NOT NULL, UNIQUE and CHECK reject impossible states. SELECT, JOIN and aggregate queries turn stored rows into evidence for a defined question.

  • اختر قيوداً لقاعدتي السعة وحالة الحجز.Choose constraints for a capacity and booking status rule.
  • اكتب استعلام ربط وآخر للعد المجمع انطلاقاً من سؤالين بلغة بسيطة.Write one join and one grouped-count query from plain-language questions.

مخطط PostgreSQL مُطبَّعNormalised PostgreSQL schema

صمّم مخطط PostgreSQL لجلسات ورشة عامة خيالية ومشاركين وحجوزات.Design a PostgreSQL schema for fictional public workshop sessions, participants and bookings.

  1. عرّف ثلاثة جداول مترابطة بأعمدة مسماة وأنواع بيانات مناسبة.Define three related tables with named columns and suitable data types.
  2. أضف مفتاحاً أساسياً لكل جدول ومفاتيح خارجية إلى جدول الحجز.Add a primary key to each table and foreign keys to the booking table.
  3. أضف قيود الإلزام والتفرّد والنطاق وأدخل صفوفاً اصطناعية.Add required, unique and domain constraints and insert synthetic rows.
  4. شغّل استعلامات SQL نموذجية لحجوزات الجلسات والمشاركين بلا حجز والأعداد حسب الجلسة.Run sample SQL queries for session bookings, unbooked participants and counts by session.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

صمّم ثلاثة جداول مترابطة بمفاتيح أساسية وخارجية وقيود واستعلامات SQL نموذجية.Design three related tables with primary keys, foreign keys, constraints, and sample SQL queries.

  • للجداول الثلاثة مفاتيح أساسية ثابتة وعلاقات مفاتيح خارجية صالحة.All three tables have stable primary keys and valid foreign-key relationships.
  • ترفض القيود صفاً اصطناعياً مستحيلاً واحداً على الأقل.Constraints reject at least one impossible synthetic row.
  • تجيب استعلامات الربط والتجميع النموذجية عن أسئلتها المحددة بصورة صحيحة.Sample join and aggregate queries answer their stated questions correctly.

إذا لم ينجح التحقق، أعد بناء مخطط العلاقات باستخدام ستة صفوف مقدمة، وأصلح أول مفتاح أو قيد معطوب، ثم أعد تشغيل المخطط والاستعلامات النموذجية نفسها.If the checkpoint fails, rebuild the relationship diagram with six supplied rows, correct the first broken key or constraint, and rerun the same schema and sample queries.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

املأ المخطط بأسماء خيالية ومعرفات مولدة فقط؛ ولا تستورد قوائم تسجيل أو بيانات اتصال حقيقية.Populate the schema only with fictional names and generated identifiers; do not import registration sheets or real contact details.

يمكن للذكاء الاصطناعي نقد المخطط بعد أن تحدد قواعد العمل؛ وعليك تبرير كل مفتاح وقيد وتشغيل كل استعلام بنفسك.AI may critique a diagram after you define the business rules; you must justify every key and constraint and run every query yourself.

الإنجليزية التقنيةTechnical English

  • بنية من صفوف وأعمدةtable
  • قيمة تميز كل صفprimary key
  • قيمة تشير إلى صف في جدول آخرforeign key
  • قاعدة ترفض بيانات غير صالحةconstraint
  • استعلام يربط صفوفاً من عدة جداولjoin
06ربط Python مع PostgreSQLPython with PostgreSQLاستخدام Python لإنشاء سجلات PostgreSQL وقراءتها وتحديثها والتحقق منها عبر واجهة سطر أوامر مختبرة.Use Python to create, read, update and validate PostgreSQL records through a tested command-line interface.

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام ربط Python مع PostgreSQLComplete Python with PostgreSQL
افتح الحزمة التعليمية الكاملةOpen complete course pack

العمل الموجّهGuided work

اتصالات قاعدة البيانات والمعاملاتDatabase connections and parameters

فتح اتصال قاعدة البيانات وإغلاقه بأمان وتنفيذ SQL بمعاملات.Open and close a database connection safely and execute parameterised SQL.

تنتمي إعدادات الاتصال إلى خارج الكود المصدري. تفصل معاملات الاستعلام القيم عن صياغة SQL، وتحدد المعاملات متى تصبح التغييرات دائمة.Connection settings belong outside source code. Query parameters keep values separate from SQL syntax and transactions define when changes become durable.

  • اتصل باستخدام إعدادات البيئة المحلية وشغّل استعلام قراءة.Connect with local environment settings and run a read query.
  • استبدل SQL المبني بدمج النص باستعلام ذي معاملات.Replace string-built SQL with a parameterised query.

أوامر الإنشاء والقراءة والتحديث واختباراتهاCreate, read and update commands and tests

ربط أوامر سطر أوامر واضحة بدوال قاعدة بيانات صغيرة واختبار المسارات الصالحة وغير الصالحة.Map clear CLI commands to small database functions and test valid and invalid paths.

يبقى تحليل الأمر والتحقق من القيمة والوصول إلى قاعدة البيانات منفصلاً. تجهز الاختبارات صفوفاً اصطناعية معروفة وتنظفها كي لا تعتمد النتائج على تشغيل سابق.Command parsing, value validation and database access remain separate. Tests set up known synthetic rows and clean them up so results do not depend on earlier runs.

  • اربط أوامر الإنشاء والعرض والتحديث باستدعاءات دوال.Map create, list and update commands to function calls.
  • اكتب اختباراً لحالة غير صالحة ومعرف غير موجود.Write a test for an invalid status and a missing identifier.

واجهة سطر أوامر لقاعدة البيانات تم اختبارهاTested database CLI

نفّذ واجهة سطر أوامر فوق قاعدة بيانات الورشة الاصطناعية مع الحفاظ على قيود المخطط.Implement a CLI over the synthetic workshop database while preserving its schema constraints.

  1. حمّل إعدادات الاتصال المحلية دون إيداع كلمة مرور.Load local connection settings without committing a password.
  2. نفّذ أمري الإنشاء والقراءة باستخدام SQL ذي معاملات.Implement create and read commands with parameterised SQL.
  3. نفّذ التحديث والتحقق من الإدخال مع سلوك مفيد للسجل المفقود.Implement update and input validation with useful missing-record behaviour.
  4. أضف اختبارات آلية لمسارات الإنشاء والقراءة والتحديث الصالحة والقيم غير الصالحة والإعداد القابل للتكرار.Add automated tests for valid create, read and update paths, invalid values and repeatable setup.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

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

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

إذا فشلت الأدلة، شغّل أمراً واحداً على عينة نظيفة يقدمها المدرّب، وأصلح التحقق قبل الوصول إلى قاعدة البيانات، ثم أعد سجل الإنشاء والقراءة والتحديث والاختبارات نفسه.If evidence fails, run one command against a trainer-provided clean fixture, repair validation before database access, and rerun the same create/read/update and test transcript.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

استخدم صفوف ورشة مولدة فقط في قاعدة التدريب المحلية؛ واحفظ بيانات دخول القاعدة في إعدادات بيئة مستبعدة من Git وخارج السجلات.Use only generated workshop rows in the local training database; keep database credentials in ignored environment settings and out of logs.

يمكن للذكاء الاصطناعي مراجعة دالة قاعدة بيانات بعد إزالة بيانات الدخول والبيانات؛ وعليك التحقق محلياً من المعاملات وسلوك المعاملة والاختبارات.AI may review a database function after credentials and data are removed; you must verify parameterisation, transaction behaviour and tests locally.

الإنجليزية التقنيةTechnical English

  • قناة تواصل مع قاعدة البياناتconnection
  • استعلام تُمرر قيمه منفصلة عن SQLparameterised query
  • مجموعة تغييرات تثبت أو تتراجع معاًtransaction
  • إنشاء البيانات وقراءتها وتحديثهاCRU
  • بيانات اختبار معروفة ومجهزة مسبقاًfixture
07HTTP وFastAPIHTTP and FastAPIبناء نقاط نهاية HTTP موثقة بعقود Pydantic محددة النوع وبيانات في الذاكرة قبل إضافة التخزين الدائم.Build documented HTTP endpoints with typed Pydantic contracts and in-memory data before adding persistence.

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام HTTP وFastAPIComplete HTTP and FastAPI
افتح الحزمة التعليمية الكاملةOpen complete course pack

العمل الموجّهGuided work

طلبات HTTP واستجاباتهHTTP requests and responses

اختيار الطرق والمسارات ورموز الحالة وأجسام JSON لمورد صغير.Choose methods, paths, status codes and JSON bodies for a small resource.

يخبر عقد API العميل بما يرسله وما قد يستقبله. وتعبّر الطريقة والمسار والمخطط ورمز الحالة معاً عن السلوك.An API contract tells a client what to send and what it can receive. Method, path, schema and status code together express behaviour.

  • طابق أربع عمليات مع GET وPOST وPATCH ومساراتها.Match four operations to GET, POST, PATCH and their paths.
  • صنّف استجابات نموذجية إلى نجاح أو إدخال غير صالح أو مورد مفقود.Classify example responses as success, invalid input or missing resource.

FastAPI ومخططات PydanticFastAPI and Pydantic schemas

تنفيذ وفحص نقاط نهاية محددة النوع ومدعومة بمجموعة في الذاكرة.Implement and inspect typed endpoints backed by an in-memory collection.

يتحقق Pydantic من الحدود قبل تشغيل منطق نقطة النهاية. وتُبقي البيانات في الذاكرة تمرين API الأول مركزاً على HTTP والتوثيق.Pydantic validates the boundary before endpoint logic runs. In-memory data keeps the first API exercise focused on HTTP and documentation.

  • عرّف نموذجي الطلب والاستجابة لإعلان خيالي.Define request and response models for a fictional notice.
  • استخدم التوثيق المولد لإرسال طلبات صالحة وغير صالحة.Use generated docs to send valid and invalid requests.

واجهة API موثقة في الذاكرةDocumented in-memory API

ابنِ API في الذاكرة لإعلانات عامة خيالية واجعل عقدها مفهوماً في التوثيق المولد.Build an in-memory API for fictional public notices and make its contract understandable in generated documentation.

  1. عرّف نماذج طلب واستجابة في Pydantic مع قيود للحقول.Define Pydantic request and response models with field constraints.
  2. نفّذ نقطتي نهاية للإنشاء والعرض فوق مجموعة في الذاكرة.Implement create and list endpoints over an in-memory collection.
  3. نفّذ سلوك الجلب والتحديث بما في ذلك المعرف المفقود.Implement get and update behaviour including a missing identifier.
  4. استخدم التوثيق المولد لإثبات سلوك الطلبات الصالحة وغير الصالحة.Use generated documentation to prove valid and invalid request behaviour.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

ابنِ نقاط نهاية موثقة في 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.

إذا كان العقد غير واضح، أكمل جدول نقاط النهاية وأصلح حد Pydantic واحداً كل مرة ثم أعد التقاط الاستجابات الموثقة الثلاث نفسها.If the contract is unclear, complete the endpoint table, repair one Pydantic boundary at a time, and recapture the same three documented responses.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

استخدم إعلانات عامة خيالية ومعرفات مختلقة؛ ويجب ألا تحتوي أمثلة API أو السجلات أو التوثيق المولد على رسائل خاصة أو بيانات اتصال حقيقية.Use fictional public notices and invented identifiers; API examples, logs and generated docs must contain no private messages or real contact data.

يمكن للذكاء الاصطناعي مقارنة مفاهيم HTTP بعد أن تكتب جدول نقاط النهاية؛ وعليك تعريف المخطط وتشغيل كل طلب موثق وشرح كل رمز حالة.AI may compare HTTP concepts after you draft the endpoint table; you must define the schema, run each documented request and explain each status code.

الإنجليزية التقنيةTechnical English

  • مسار API ينفذ عملية محددةendpoint
  • رسالة يرسلها العميل إلى الخادمrequest
  • رسالة يعيدها الخادمresponse
  • رقم يلخص نتيجة طلب HTTPstatus code
  • وصف منظم لشكل البيانات وقواعدهاschema
08واجهة REST ببيانات دائمةPersistent REST APIاستبدال التخزين في الذاكرة بـPostgreSQL مع الحفاظ على عقد API وإثبات السلوك الدائم بالاختبارات.Replace in-memory storage with PostgreSQL while preserving the API contract and proving persistent behaviour with tests.

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام واجهة REST ببيانات دائمةComplete Persistent REST API
افتح الحزمة التعليمية الكاملةOpen complete course pack

العمل الموجّهGuided work

التخزين الدائم خلف APIPersistence behind the API

ربط منطق المسارات بدوال قاعدة البيانات دون تسريب تفاصيل التخزين إلى المخططات.Connect route logic to database functions without leaking storage details into schemas.

يبقى عقد HTTP ثابتاً بينما تستبدل طبقة الوصول إلى البيانات القائمة. ويجب أن تبقى الكتابات المثبتة بعد إعادة تشغيل الخادم.The HTTP contract stays stable while a data-access layer replaces the list. Committed writes must survive a server restart.

  • اربط كل عملية في الذاكرة بدالة قاعدة بيانات ذات معاملات.Map each in-memory operation to a parameterised database function.
  • أنشئ سجلاً وأعد تشغيل API ثم استرجع المعرف نفسه.Create a record, restart the API and retrieve the same identifier.

سلوك أعطال API والاختبارات الآليةAPI failure behaviour and automated tests

تحويل نتائج التحقق والصفوف المفقودة وقاعدة البيانات إلى استجابات ثابتة.Translate validation, missing rows and database outcomes into stable responses.

ينبغي أن يفشل الإدخال غير الصالح قبل الكتابة؛ والصف المفقود سلوك متوقع يظهر للعميل؛ وتبقى تفاصيل قاعدة البيانات غير المتوقعة خارج الاستجابات.Invalid input should fail before a write; a missing row is expected client-visible behaviour; unexpected database details stay out of responses.

  • اختبر إدخال إنشاء غير صالح وتأكد من عدم إدخال صف.Test invalid create input and confirm no row was inserted.
  • اختبر الجلب والتحديث لمعرف مفقود.Test get and update for a missing identifier.

واجهة CRUD مع PostgreSQL تم اختبارهاTested CRUD API with PostgreSQL

خزّن API الإعلانات الخيالية بصورة دائمة في PostgreSQL واختبر عقدها كاملاً.Persist the fictional notice API in PostgreSQL and test its full contract.

  1. استبدل المجموعة في الذاكرة بدوال وصول مختبرة إلى PostgreSQL.Replace the in-memory collection with tested PostgreSQL data-access functions.
  2. نفّذ نقاط نهاية الإنشاء والقراءة والتحديث والحذف مع الحفاظ على المخططات.Implement create, read, update and delete endpoints while preserving schemas.
  3. أثبت بقاء سجل منشأ بعد إعادة تشغيل الخادم وأن الإدخال غير الصالح لا ينشئ صفاً.Prove a created record survives a server restart and invalid input creates no row.
  4. أتمت اختبارات CRUD الصالحة والتحقق والسجل المفقود انطلاقاً من قاعدة نظيفة.Automate valid CRUD, validation and missing-record tests from a clean database state.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

اربط نقاط نهاية 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.

إذا فشلت الأدلة، قارن نقطة نهاية واحدة بعقد الأسبوع السابع واختبر دالة قاعدة بياناتها منفردة، ثم كرر إثبات إعادة التشغيل والإدخال غير الصالح والسجل المفقود والاختبارات الآلية نفسه.If evidence fails, compare one endpoint against the Week 7 contract, test its database function alone, then repeat the same restart, invalid-input, missing-record and automated-test proof.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

خزّن سجلات إعلانات مولدة فقط في قاعدة التدريب؛ واحجب سلاسل الاتصال ومحتويات القاعدة من لقطات الشاشة وسجلات الاختبار.Persist only generated notice records in the training database; redact connection strings and database contents from screenshots and test logs.

يمكن للذكاء الاصطناعي مراجعة اختبار فاشل بعد حجب البيانات؛ وعليك إعادة إنتاج الفشل وفحص حالة قاعدة البيانات وإثبات الإصلاح بمجموعة الاختبارات كاملة.AI may review a redacted failing test; you must reproduce the failure, inspect database state and prove the fix with the complete test suite.

الإنجليزية التقنيةTechnical English

  • بقاء البيانات بعد انتهاء التشغيلpersistence
  • طبقة تعزل عمليات قاعدة البياناتdata-access layer
  • سجل مطلوب غير موجودmissing record
  • اختبار لتعاون عدة أجزاءintegration test
  • تراجع عن تغييرات معاملة فاشلةrollback
09واجهات النماذج والاستخدام الآمنModel APIs and Safetyاستدعاء نموذج من كود موثوق على الخادم والتحقق من نتيجة منظمة والتعامل المقصود مع بيانات الدخول والتكلفة والفشل.Call a model from trusted server-side code, validate a structured result and handle credentials, cost and failure deliberately.

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام واجهات النماذج والاستخدام الآمنComplete Model APIs and Safety
افتح الحزمة التعليمية الكاملةOpen complete course pack

العمل الموجّهGuided work

عميل النموذج على الخادم والأسرارServer-side model client and secrets

إعداد عميل نموذج دون كشف مفتاحه في التحكم بالمصدر أو كود المتصفح.Configure a model client without exposing its key to source control or browser code.

يسمح مفتاح النموذج بطلبات مدفوعة ويبقى في إعدادات بيئة الخادم. وينبغي أن يفشل تحقق بدء التشغيل بأمان عند غياب المفتاح.A model key authorises billable requests and stays in server-side environment settings. A startup check should fail safely when the key is absent.

  • تتبّع مسار الطلب وحدد حد الثقة بين المتصفح والخادم.Trace the request path and mark the browser/server trust boundary.
  • تحقّق من إعداد البيئة المستبعد وافحص فروقات المستودع بحثاً عن قيم تشبه الأسرار.Verify ignored environment setup and scan the repository diff for secret-like values.

النتائج المنظمة والتكلفة والفشلStructured results, cost and failure

طلب مخطط محدود والتحقق من الاستجابة والتعرف إلى مخاطر المهلة والمعدل والصيغة والتكلفة.Request a bounded schema, validate the response and recognise timeout, rate, format and cost risks.

تظل مخرجات النموذج غير موثوقة حتى عند طلب صيغة منظمة. يتحقق التطبيق من الحقول ويحد المدخلات والمخرجات ويسجل حقائق تشغيل آمنة بدلاً من محتوى الطلب.Model output is untrusted even when a structured format is requested. The application validates fields, limits input and output, and records safe operational facts rather than prompt content.

  • تحقّق من استجابات مقدمة صالحة ومعطوبة وذات حقول زائدة.Validate supplied valid, malformed and extra-field responses.
  • قدّر عدد الطلبات وحجم المخرجات المحدود لميزانية تمرين صغيرة.Estimate request count and bounded output size for a small exercise budget.

تمرين منظم لاستدعاء نموذجStructured model-call exercise

أرسل مسودة قصيرة لإعلان عام اصطناعي إلى نموذج واطلب كائن تصنيف وملخص محدوداً.Send a short synthetic public-notice draft to a model and request a bounded classification and summary object.

  1. أعد عميل الخادم بمفتاح خارج التحكم بالمصدر وتحقق من مسار غياب المفتاح.Configure the server-side client with a key outside source control and verify the missing-key path.
  2. أرسل إعلاناً اصطناعياً واحداً واطلب نتيجة منظمة موثقة بحقول محدودة.Send one synthetic notice and request a documented structured result with bounded fields.
  3. تحقّق من الكائن المعاد وارفض عينة استجابة معطوبة مقدمة.Validate the returned object and reject a supplied malformed response fixture.
  4. سجّل عدد الطلبات وحد المخرجات وسلوك الخطأ الآمن وما يراه المستخدم عند الفشل.Record request count, bounded output, safe error behaviour and what the user sees on failure.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

استدعِ نموذجاً عبر عميل على الخادم واطلب نتيجة منظمة وتحقق منها وأبق المفتاح خارج التحكم بالمصدر وأظهر وعياً بالتكلفة والفشل.Call a model through a server-side client, request a structured result, validate it, keep the key outside source control, and show cost/failure awareness.

  • يعمل استدعاء النموذج على الخادم ولا تحتوي أدلة المستودع على مفتاح.The model call runs server-side and repository evidence contains no key.
  • يتم التحقق من الاستجابة المنظمة وتُرفض المخرجات المعطوبة بأمان.The structured response is validated and malformed output is rejected safely.
  • تحدد الأدلة حدود الطلب والمخرجات والأعطال المحتملة ورسالة فشل تظهر للمستخدم.Evidence identifies request/output bounds, likely failures and a user-visible failure message.

إذا فشلت الأدلة، استخدم عينات الاستجابة الوهمية أولاً وأصلح التحقق من المخطط ومعالجة غياب المفتاح، ثم كرر استدعاءً حياً محدوداً واحداً والدليل المحجوب نفسه.If evidence fails, use the mocked response fixtures first, repair schema validation and missing-key handling, then repeat one bounded live call and the same redacted proof.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

أرسل الإعلان العام الاصطناعي المقدم فقط؛ ولا ترسل سجلات شخصية أو رسائل خاصة أو بيانات دخول أو محتوى قاعدة إنتاج إلى نموذج.Send only the supplied synthetic public notice; never send personal records, private messages, credentials or production database content to a model.

مخرجات الذكاء الاصطناعي إدخال غير موثوق للتطبيق: تحقّق منها وحدد استخدامها ولا تلصق أسراراً أو بيانات شخصية في طلب النموذج.AI output is untrusted application input: validate it, keep its use bounded and never paste secrets or personal data into a model prompt.

الإنجليزية التقنيةTechnical English

  • مكتبة ترسل طلبات إلى نموذجmodel client
  • سر يصرح باستخدام خدمة APIAPI key
  • مخرجات تتبع حقولاً وشكلاً محددينstructured output
  • حد لعدد الطلبات خلال مدةrate limit
  • وحدة تقريبية لحجم إدخال النموذج أو مخرجاتهtoken
10ميزة ذكاء اصطناعي مضبوطةControlled AI Featureإتاحة ميزة ذكاء اصطناعي ضيقة التعريف عبر نقطة نهاية متحقق منها بحد زمني وأخطاء آمنة وسلوك بديل حتمي.Expose one narrowly defined AI feature through a validated endpoint with time bounds, safe errors and deterministic fallback behaviour.

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام ميزة ذكاء اصطناعي مضبوطةComplete Controlled AI Feature
افتح الحزمة التعليمية الكاملةOpen complete course pack

العمل الموجّهGuided work

عقد ميزة مضبوطةA controlled feature contract

تحديد ما تقبله نقطة نهاية الذكاء الاصطناعي وما تعيده وما ترفضه بدقة.Define exactly what the AI endpoint accepts, returns and refuses.

للخاصية المحدودة غرض مستخدم واحد وحد لطول الإدخال وقيود للحقول ومخطط مخرجات متحقق منه، ولا تمرر طلبات عامة إلى النموذج.A bounded feature has one user purpose, input length and field constraints, a validated output schema, and no general-purpose prompt forwarding.

  • اكتب أمثلة مسموحة ومرفوضة لعقد نقطة النهاية.Write allowed and refused examples for the endpoint contract.
  • اختبر الطلبات الفارغة والطويلة جداً وذات النوع الخاطئ قبل الوصول إلى النموذج.Test empty, over-length and wrongly typed requests before model access.

المهلات والأخطاء والبديل الحتميTimeouts, errors and deterministic fallback

إعادة استجابة ثابتة ومفيدة عندما لا تستطيع خدمة النموذج إنتاج نتيجة صالحة في الوقت المحدد.Return a stable, useful response when model service cannot produce a valid result in time.

تشترك المهلة وخطأ المزود ومخرجات النموذج غير الصالحة في مسار مضبوط للمستخدم. لا تخترع الرسالة البديلة الثابتة محتوى من النموذج ولا تتغير بين التشغيلات.Timeout, provider error and invalid model output share a controlled user-facing path. A fixed fallback message does not invent model content or vary between runs.

  • حاكِ المهلة وخطأ المزود والمخرجات المعطوبة باستخدام بدائل اختبارية.Simulate timeout, provider error and malformed output with test doubles.
  • تحقّق من أن كل فشل يعيد الرسالة البديلة الموثقة نفسها.Assert that each failure returns the same documented fallback message.

نقطة نهاية للذكاء الاصطناعي تم التحقق منها مع بديلValidated AI endpoint with fallback

أتِح تصنيف الإعلان الاصطناعي كنقطة نهاية AI مضبوطة واحدة، مع بديل ثابت يبدأ بالعربية.Expose the synthetic-notice classification as one controlled API endpoint, including a fixed Arabic-first fallback.

  1. عرّف مخططي طلب واستجابة مقيدين وارفض الإدخال خارج النطاق قبل استدعاء النموذج.Define constrained request and response schemas and reject out-of-scope input before a model call.
  2. اربط دالة النموذج المتحقق منها على الخادم بمهلة صريحة.Connect the validated server-side model function with an explicit timeout.
  3. عالج المهلة وخطأ المزود والمخرجات غير الصالحة دون تسريب تفاصيل داخلية.Handle timeout, provider error and invalid output without leaking internal details.
  4. اختبر أن كل فشل محاكى للنموذج يعيد الرسالة البديلة الحتمية نفسها.Test that every simulated model failure returns the same deterministic fallback message.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

أتِح نقطة نهاية AI مضبوطة واحدة مع التحقق من المخطط ومعالجة المهلة والأخطاء ورسالة بديلة حتمية.Expose one controlled AI endpoint with schema validation, timeout/error handling, and a deterministic fallback message.

  • تحد مخططات الطلب والاستجابة الميزة وترفض الإدخال غير الصالح قبل الوصول إلى النموذج.Request and response schemas bound the feature and reject invalid input before model access.
  • تُعالج المهلة وخطأ المزود والمخرجات غير الصالحة دون تسريب تفاصيل داخلية.Timeout, provider error and invalid output are handled without internal-detail leakage.
  • تتحقق اختبارات الفشل من رسالة بديلة حتمية دقيقة واحدة تبدأ بالعربية.Failure tests assert one exact deterministic Arabic-first fallback message.

إذا فشلت الأدلة، استبدل العميل الحي ببدائل الفشل الثلاثة المقدمة وأصلح تحقق المخطط وتوكيدات البديل ثم أعد مجموعة اختبارات نقطة النهاية نفسها.If evidence fails, replace the live client with the three supplied failure doubles, repair schema and fallback assertions, then rerun the identical endpoint test set.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

تقبل نقطة النهاية إعلانات عامة اصطناعية قصيرة فقط؛ ولا تسجل أجسام الطلبات ولا ترسل سجلات قاعدة البيانات أو بيانات الاتصال أو بيانات الدخول إلى المزود.The endpoint accepts only short synthetic public notices; do not log request bodies or send database records, contact details or credentials to the provider.

يجب ألا تقبل نقطة النهاية طلبات عامة؛ ويتم التحقق من مخطط كل نتيجة نموذج ويستخدم كل غياب أو نتيجة غير صالحة البديل الثابت الموثق.The endpoint must not accept arbitrary prompts; every model result is schema-validated and every unavailable or invalid result uses the documented fixed fallback.

الإنجليزية التقنيةTechnical English

  • إيقاف انتظار عملية بعد مدة محددةtimeout
  • استجابة بديلة عند تعذر المسار الأساسيfallback
  • يعطي النتيجة نفسها للظروف نفسهاdeterministic
  • فشل تعيده خدمة النموذجprovider error
  • محدود بنطاق وقواعد واضحةbounded
11بناء المشروع الفرديIndividual Capstone Buildدمج API قاعدة البيانات وميزة AI محدودة واحدة في نسخة مرشحة للإصدار يملكها المتعلّم فردياً ومختبرة وموثقة.Integrate the database API and one bounded AI feature into an individually owned, tested and documented release candidate.

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام بناء المشروع الفرديComplete Individual Capstone Build
افتح الحزمة التعليمية الكاملةOpen complete course pack

العمل الموجّهGuided work

النطاق الفردي والتكاملIndividual scope and integration

تحديد رحلة مستخدم صغيرة وربط السجلات المخزنة بإجراء AI محدود.Define a small user journey and connect stored records to a bounded AI action.

يثبت المشروع التكامل لا كثرة الميزات. يترك سير سجلات واضح واحد وميزة AI مضبوطة واحدة وقتاً كافياً للاختبارات والتوثيق والشرح.The capstone proves integration, not feature volume. One clear record workflow and one controlled AI feature leave enough time for tests, documentation and explanation.

  • اكتب نطاقاً فردياً يتضمن العمل الضروري والمؤجل صراحة.Write an individual scope containing must-have and explicitly deferred work.
  • تتبّع سجلاً اصطناعياً واحداً من التخزين عبر API إلى استجابة AI المحدودة.Trace one synthetic record from API persistence to the bounded AI response.

اختبارات الإصدار وتوثيقهRelease tests and documentation

إعداد مسار تثبيت نظيف وأدلة آلية وسجل شفاف لاستخدام الذكاء الاصطناعي.Prepare a clean setup path, automated evidence and transparent AI-use record.

يمكن لشخص آخر التحقق من النسخة المرشحة للإصدار انطلاقاً من README. تغطي الاختبارات API الأساسية والتخزين وبديل AI، ويذكر التوثيق الافتراضات والقيود ومساعدة الذكاء الاصطناعي.A release candidate can be checked by another person from its README. Tests cover core API, persistence and AI fallback; documentation states assumptions, limitations and AI assistance.

  • شغّل الإعداد في بيئة محلية نظيفة باستخدام الخطوات الموثقة فقط.Run setup in a clean local environment using only documented steps.
  • أنشئ قائمة تحقق للإصدار تشمل الاختبارات والأسرار والبيانات النموذجية والتوثيق والقيود المعروفة.Create a release checklist for tests, secrets, sample data, docs and known limitations.

مستودع مرشح للإصدارRelease-candidate repository

ابنِ النسخة الفردية المعتمدة المرشحة للإصدار مع API سجلات دائمة وميزة AI مضبوطة واحدة.Build the approved individual release candidate with a persistent record API and one controlled AI feature.

  1. ثبّت نطاقاً فردياً صغيراً ووثّق نموذج البيانات الاصطناعية أو العامة.Freeze a small individual scope and document the synthetic/public data model.
  2. ادمج تخزين CRUD المختبر بنقطة نهاية AI واحدة محدودة ومتحقق من مخططها.Integrate tested CRUD persistence with one schema-validated bounded AI endpoint.
  3. أضف اختبارات آلية للمسار الأساسي والإدخال غير الصالح والسجل المفقود والتخزين وبديل AI.Add automated core-flow, invalid-input, missing-record, persistence and AI-fallback tests.
  4. اكتب توثيق الإعداد النظيف والاستخدام والاختبارات والمعمارية والقيود واستخدام AI وتحقق منه مع زميل.Write clean setup, usage, test, architecture, limitations and AI-use documentation and verify it with a peer.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

ادمج API قاعدة البيانات وميزة AI المحدودة في نسخة فردية مرشحة للإصدار مع اختبارات وتوثيق.Combine the database API and bounded AI feature into an individual release candidate with tests and documentation.

  • يشغّل المستودع الفردي مسار CRUD بتخزين دائم وميزة AI واحدة محدودة ومتحققاً منها.The individual repository runs a persistent CRUD flow and one bounded, validated AI feature.
  • تغطي الاختبارات الآلية النجاح الأساسي وسلوكيات فشل قاعدة البيانات وAI المطلوبة.Automated tests cover core success and required database and AI failure behaviours.
  • يتبع زميل التوثيق من إعداد نظيف ويشرح سجل استخدام AI ملكية التغييرات.A peer follows the documentation from clean setup and the AI-use record explains ownership of changes.

إذا فشلت أدلة الإصدار، احذف الميزات المؤجلة واستعد آخر مسار أساسي ناجح وأصلح أول خطوة إعداد نظيف فاشلة ثم أعد إنشاء أدلة الاختبارات والتوثيق نفسها.If the release evidence fails, cut deferred features, restore the last passing core flow, repair the first failed clean-setup step, and regenerate the same tests and documentation evidence.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

يجب أن يستخدم المشروع بيانات اصطناعية أو عامة بوضوح؛ ولا يجوز أن يحتوي تاريخ المستودع أو العينات أو السجلات أو العروض على سجلات شخصية أو محتوى خاص أو بيانات دخول.The capstone must use synthetic or clearly public data; repository history, fixtures, logs and demos must contain no personal records, private content or credentials.

يمكن للذكاء الاصطناعي المساعدة فقط في تغييرات معلنة ومراجعة؛ ويملك المتعلّم النطاق ويستطيع شرح كل تغيير مقدم ويتحقق منه بالاختبارات ومراجعة الفروقات.AI may assist only with disclosed, reviewed changes; the learner owns the scope, can explain every submitted change, and verifies it with tests and diff review.

الإنجليزية التقنيةTechnical English

  • مشروع ختامي يدمج مهارات البرنامجcapstone
  • نسخة جاهزة للتحقق قبل الإصدارrelease candidate
  • حدود العمل المتفق عليهاscope
  • من بداية رحلة المستخدم إلى نتيجتهاend-to-end
  • قيد معروف في الحلlimitation
12الأدلة وبوابة الأساسEvidence and Foundation Gateإعداد أدلة قابلة للتحقق للإعداد والمناقشة وشرح استخدام AI والتدرّب على التصحيح المستقل دون كشف مهمة البوابة الحية.Prepare verifiable setup and defence evidence, explain AI use and rehearse independent debugging without disclosing the live gate task.

ما ستتمكن من إنجازهWhat you will be able to do

  • إتمام الأدلة وبوابة الأساسComplete Evidence and Foundation Gate
افتح الحزمة التعليمية الكاملةOpen complete course pack

العمل الموجّهGuided work

الإعداد النظيف والمناقشة وشرح استخدام AIClean setup, defence and AI-use explanation

إظهار قابلية إعادة الإنتاج وشرح التصميم والأدلة والقيود والمساعدة بكلمات المتعلّم.Demonstrate reproducibility and explain design, evidence, limitations and assistance in the learner's own words.

تربط المناقشة حاجة المستخدم بالمعمارية وقواعد البيانات والاختبارات وسلوك AI الآمن. وتميز أدلة استخدام AI بين الاقتراح وقرار المتعلّم والتعديل والتحقق.The defence links a user need to architecture, data rules, tests and safe AI behaviour. AI-use evidence distinguishes suggestion, learner decision, modification and verification.

  • اطلب من زميل إجراء إعداد نظيف بينما يسجل صاحب المشروع فجوات التوثيق.Ask a peer to perform clean setup while the owner records documentation gaps.
  • تدرّب على شرح المعمارية واستخدام AI في خمس دقائق مع روابط الأدلة.Rehearse a five-minute architecture and AI-use explanation with evidence links.

تدريب التصحيح المستقلIndependent debugging rehearsal

استخدام حلقة قابلة للتكرار من الملاحظة والفرضية والاختبار والتحقق دون AI.Use a repeatable observation, hypothesis, test and verification loop without AI.

يستخدم التدريب خللاً تدريبياً منفصلاً لا المهمة الحية السرية تحت الملاحظة. يقيّم المدرّبون العملية: إعادة الإنتاج والعزل وإجراء تغيير واحد وإعادة الدليل والشرح.The rehearsal uses a separate practice defect, not the confidential live observed task. Trainers assess the process: reproduce, isolate, make one change, rerun evidence and explain.

  • صحّح خللاً تدريبياً مقدماً دون AI واحتفظ بسجل قرار قصير.Debug a supplied practice defect without AI and keep a short decision log.
  • اشرح لماذا يثبت الاختبار النهائي إصلاح الخلل التدريبي.Explain why the final test proves the practice defect is fixed.

تسليم نهائي تمت مناقشتهDefended final submission

جهّز التسليم الفردي النهائي وتدرّب على مناقشته وأكمل تمرين تصحيح منفصلاً دون AI.Package the individual final submission, rehearse its defence and complete a separate no-AI practice debugging exercise.

  1. تحقّق من الإعداد النظيف والترحيلات والبيانات الاصطناعية الأولية والاختبارات كاملة من النسخة المقدمة.Verify clean setup, migrations, synthetic seed data and full tests from the submitted revision.
  2. حضّر مناقشة موجزة تربط القرارات والقيود والسلامة بالأدلة.Prepare a concise defence linking decisions, limitations, safety and evidence.
  3. حضّر شرحاً دقيقاً لاستخدام AI في التغييرات المساعدة والمكتوبة باستقلال.Prepare an exact AI-use explanation for assisted and independently written changes.
  4. أكمل تدريب تصحيح غير مرتبط دون AI وحافظ على سرية المهمة الحية تحت الملاحظة.Complete an unrelated practice debugging rehearsal without AI and keep the live observed task confidential.
دليلي المبلّغ عنه ذاتياًMy self-reported evidence

هذا التتبع للتعلّم الذاتي فقط، وليس حضوراً رسمياً أو درجة أو نتيجة بوابة أو نتيجة شهادة.This is for self-reported learning support only. It is not official attendance, a score, gate passage, or a certificate result.

التحقق والاستدراكCheckpoint and recovery

حضّر دليل إعداد نظيفاً ومناقشة المشروع وشرح استخدام AI وتدريب تصحيح مستقلاً دون كشف مهمة البوابة الحية.Prepare clean setup evidence, project defence, AI-use explanation, and an independent debugging rehearsal without revealing the live gate task.

  • تُثبت النسخة المقدمة وتبدأ وتنجح في اختباراتها الموثقة من إعداد نظيف.The submitted revision installs, starts and passes its documented tests from clean setup.
  • يناقش المتعلّم قرارات التصميم والسلامة ويشرح بدقة كل تغيير جوهري ساعد فيه AI.The learner defends design and safety decisions and accurately explains every material AI-assisted change.
  • يُظهر سجل تصحيح تدريبي منفصل دون AI منهجاً مستقلاً ولا يحتوي أي تفاصيل للمهمة الحية.A separate no-AI practice debugging transcript demonstrates an independent method and contains no live gate detail.

إذا كانت الأدلة النهائية غير مكتملة، أصلح أول فجوة في الإعداد النظيف أو الشرح، وكرر أدلة مناقشة المشروع نفسها، وتدرّب على خلل تدريبي منفصل جديد دون الوصول إلى مهمة البوابة الحية أو مناقشتها.If final evidence is incomplete, repair the first clean-setup or explanation gap, repeat the same project defence evidence, and rehearse a new separate practice defect without accessing or discussing the live gate task.

السلامة وممارسة الذكاء الاصطناعيSafety and AI practice

يجب أن تستخدم الأدلة النهائية سجلات اصطناعية أو عامة وتحجب بيانات الدخول والمسارات المحلية والمراسلات الخاصة؛ ولا يجوز أن تظهر مهمة البوابة الحية السرية في الملاحظات أو المستودعات.Final evidence must use synthetic/public records and redact credentials, local paths and private communications; the confidential live gate task must not appear in notes or repositories.

يجب الإفصاح عن مساعدة AI في المشروع؛ ويُنجز تدريب التصحيح المستقل ومهمة البوابة الحية تحت الملاحظة دون AI.AI assistance must be disclosed for the project; the independent debugging rehearsal and the live observed gate task are completed without AI.

الإنجليزية التقنيةTechnical English

  • مناقشة يشرح فيها المتعلّم قراراته وأدلتهdefence
  • يمكن إعادة النتيجة باتباع الخطواتreproducible
  • تفسير محتمل يُختبر بدليلhypothesis
  • اختبار يمنع عودة خلل سابقregression test
  • مهمة ينفذها المتعلّم تحت الملاحظةobserved task

الاستعداد لبوابة الأساسFoundation Gate preparation

هذه معايير منشورة للتحضير فقط. التحقق الرسمي والنتيجة لا يظهران في هذه المساحة.These are published preparation criteria only. Official verification and results do not appear in this space.

ملف الإنجازPortfolio

  • مشروع Python/FastAPI يعملWorking Python/FastAPI project
  • مخطط PostgreSQL منطقي وبيانات دائمةSensible PostgreSQL schema and persistent data
  • ميزة AI واحدة مضبوطةAt least one controlled AI feature
  • تحقق من الإدخال وأخطاء منظمةInput validation and structured error handling
  • اختبارات آلية قابلة للتشغيلFunctioning automated tests
  • تعليمات إعداد واستخدام من حالة نظيفةSetup and usage documentation from a clean state
  • سجل Git فردي ذو معنىMeaningful individual Git history

المناقشةDefence

  • تشغيل المشروع من إعداد نظيف موثقRuns the project from a clean documented setup
  • شرح تدفق API وقاعدة البيانات وAIExplains the API, database, and AI data flow
  • شرح فشل واحد وطريقة التعامل معهExplains at least one failure and its handling
  • تبرير القرارات التقنية المهمةJustifies important technical choices
  • تحديد اقتراحات AI المقبولة والمعدلة والمرفوضةIdentifies AI suggestions accepted, changed, or rejected

مهمة تحت الملاحظةObserved task

  • تشخيص العطل أو تحديد التعديلDiagnoses the defect or scopes the modification
  • تنفيذ تغيير محدود وصحيحImplements a bounded, correct change
  • تشغيل الاختبارات وتفسير الدليلRuns tests and interprets the evidence
  • شرح شفهي للعمل والقرارGives an oral explanation of the work and decision
  • إكمال المهمة دون AICompletes the task without AI assistance

تُنجز المهمة المستقلة تحت الملاحظة من دون مساعدة الذكاء الاصطناعي.The independent observed task is completed without AI assistance.

حالات الرسوب التلقائيAutomatic failure conditions

أي حالة من هذه الحالات تجعل بوابة الأساس غير مجتازة بعد.Any one of these conditions makes the Foundation Gate not yet passed.

  • لا يستطيع تشغيل أو شرح مشروعهCannot run or explain their own submitted project
  • يكشف بيانات اعتماد أو سراً حياًExposes a live credential or secret
  • لا يحتوي المشروع بيانات PostgreSQL دائمةSubmits a project without persistent PostgreSQL data
  • لا يقدم دليل اختبار آلي يعملSubmits no functioning automated test evidence
  • لا يكمل ويشرح المهمة المستقلة المرصودةCannot complete and explain the observed independent task