إرشاد عام للمدرّبينPublic trainer guidance
دليل التنفيذ للمدرّبينTrainer delivery hub
إرشاد عربي أولاً للتيسير والاستمرارية والأدلة لفوج البرنامج التأسيسي للذكاء الاصطناعي المكوّن من 20–25 متعلماً خلال 12 أسبوعاً.Arabic-first facilitation, continuity and evidence guidance for the 20–25 learner, 12-week AI Integration Foundations Pilot.
يمتلك نواتج التعلم والتدريس اليومي والتحققات الشفهية الأسبوعية وقرارات الاستدراك؛ ولا ينجز عملاً مُقيّماً نيابة عن المتعلمين.Owns learning outcomes, daily instruction, weekly oral checks and remediation decisions; does not complete assessed work for learners.
تقريباً مساعد واحد لكل 10–12 متعلماً يدعم المختبرات الخاضعة للإشراف ومراجعة التمارين والتدخل المبكر. ويكون مساعد واحد على الأقل مستعداً لاستمرار الدرس المجدول.Approximately one TA per 10–12 learners supports supervised labs, exercise review and early intervention. At least one TA is ready to continue a scheduled lesson.
يمتلك ترتيب التسجيل والحضور والتواصل والجدولة وسجلات الانقطاع الموثقة؛ ويحافظ على خصوصية تفاصيل الدعم.Owns registration order, attendance, communication, scheduling and documented interruption records; keeps support details private.
يمتلك البرمجيات والحسابات وجاهزية PostgreSQL والإنترنت والطاقة الاحتياطية والحصص المدارة والنسخ الاحتياطية؛ ولا يوزع أسراراً حية مشتركة أبداً.Owns software, accounts, PostgreSQL readiness, internet, backup power, managed quotas and backups; never distributes shared live secrets.
يقيّمان الأدلة والبوابة الفردية مع وجود مقيّم واحد على الأقل مستقل عن التدريس الأساسي؛ ولا ينشران مهام البوابة الحية أو يتدربان عليها.Assess evidence and an individual gate with at least one assessor independent of main instruction; they do not publish or rehearse live gate tasks.
تتضمن الأسابيع 1–12 مقدار 480 دقيقة تدريس و240 دقيقة ممارسة موجّهة و780 دقيقة مختبر خاضع للإشراف. استخدم سجل المتعلم الموجود كمصدر للغرض والممارسة والتحققات؛ وتضيف هذه الواجهة إرشاد التيسير والتدخل.Weeks 1–12 have 480 instruction minutes, 240 guided-practice minutes and 780 supervised-lab minutes. Use the existing learner record as the source for purpose, practice and checkpoints; this view adds facilitation and intervention guidance.
يومَا التهيئة إلزاميان وغير مُقيّمين بدرجات. استخدم أدلة الجاهزية لترتيب الدعم، لا لاستبعاد متعلم.Both orientation days are mandatory and ungraded. Use readiness evidence to arrange support, never to eliminate a learner.
تحقق من أن ليومي التهيئة الإلزاميين غير المُقيّمين سجلاً للجاهزية أو متابعة دعم خاصة.Confirm both mandatory, ungraded orientation days have a readiness record or a private support follow-up.
بعد يومي التهيئة، اعرض قائمة الجاهزية وكرّر الأمر الأول ونشاط Python. كلا اليومين إلزامي وغير مُقيّم بدرجات.After both orientation days, demonstrate the readiness checklist and repeat the first command and Python activity. Both days are mandatory and ungraded.
إذا نقص أي دليل للجاهزية، استخدم محطة التثبيت بدعم المدرّب وكرّر بند القائمة الناقص فقط قبل الأسبوع الأول.If any readiness evidence is missing, use the trainer-supported installation station and repeat only the missing checklist item before Week 1.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
اطلب من المتعلم إعادة شرح تحقق الأسبوع السابق وهدف اليوم قبل بدء العمل الموجّه: تحويل إدخال بسيط من المستخدم إلى قرار تم التحقق منه ونتيجة مفيدة في سطر الأوامر.Ask the learner to restate the previous checkpoint and today’s purpose before guided work begins: Turn simple user input into a validated decision and a useful console result.
اقرأ إدخالاً وتحقق من قيمة بسيطة ونفّذ تفرعاً لاتخاذ قرار واطبع نتيجة مفيدة.Read input, validate a simple value, branch on a decision, and print a useful result.
إذا لم يكتمل التحقق، املأ جدول الإدخال والمخرجات المتوقعة الذي يقدمه المدرّب، وصحّح مساراً فاشلاً، ثم أعد تقديم عمليات التشغيل الثلاث نفسها.If the checkpoint fails, complete a trainer-provided input/expected-output table, correct one failing path, and resubmit the same three console runs.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
اطلب من المتعلم إعادة شرح تحقق الأسبوع السابق وهدف اليوم قبل بدء العمل الموجّه: تنظيم منطق معالجة السجلات في دوال صغيرة باستخدام القوائم والقواميس.Ask the learner to restate the previous checkpoint and today’s purpose before guided work begins: Organise record-processing logic into small functions using lists and dictionaries.
قسّم برنامج معالجة سجلات إلى دوال باستخدام القوائم والقواميس.Split a record-processing program into functions using lists and dictionaries.
إذا كانت الأدلة غير مكتملة، أضف إلى مخطط الدوال المدخلات والقيم المعادة، ثم افصل مسؤولية واحدة كل مرة وأعد تشغيل قائمة السجلات المختلطة نفسها.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.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
اطلب من المتعلم إعادة شرح تحقق الأسبوع السابق وهدف اليوم قبل بدء العمل الموجّه: قراءة ملفات JSON بصورة دفاعية وفصل السجلات غير الصالحة وكتابة ملف نتائج موثوق.Ask the learner to restate the previous checkpoint and today’s purpose before guided work begins: Read JSON files defensively, separate malformed records and write a trustworthy result file.
حمّل JSON وارفض السجلات المعطوبة وعالج السجلات الصالحة واكتب ملف نتائج.Load JSON, reject malformed records, process valid records, and write a result file.
إذا كانت النتيجة خاطئة، شغّل عينات السجل الواحد بالترتيب، وأصلح أول حد يفشل، ثم أعد إنشاء ملف النتائج نفسه وافتحه.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.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
اطلب من المتعلم إعادة شرح تحقق الأسبوع السابق وهدف اليوم قبل بدء العمل الموجّه: إجراء تغيير مختبر في فرع ومراجعة الفروقات وشرح مساعدة الذكاء الاصطناعي بشفافية.Ask the learner to restate the previous checkpoint and today’s purpose before guided work begins: Make a tested change in a branch, review its diff and communicate AI assistance transparently.
أنشئ مستودعاً وفرعاً واختبر دالة وافتح طلب سحب وراجع الفروقات واشرح التغييرات التي ساعد فيها الذكاء الاصطناعي.Create a repository, branch, test a function, open a pull request, review a diff, and explain AI-assisted changes.
إذا كانت الأدلة غير مكتملة، أعد إنشاء التغيير باستخدام خريطة فروع يقدمها المدرّب، وشغّل الاختبار الموثق، ثم حدّث طلب السحب نفسه بالفروقات وشرح استخدام الذكاء الاصطناعي.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.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
اطلب من المتعلم إعادة شرح تحقق الأسبوع السابق وهدف اليوم قبل بدء العمل الموجّه: نمذجة بيانات مترابطة بهويات وعلاقات وقيود صريحة ثم الإجابة عن أسئلة باستخدام SQL.Ask the learner to restate the previous checkpoint and today’s purpose before guided work begins: Model related data with explicit identity, relationships and constraints, then answer questions with SQL.
صمّم ثلاثة جداول مترابطة بمفاتيح أساسية وخارجية وقيود واستعلامات SQL نموذجية.Design three related tables with primary keys, foreign keys, constraints, and sample SQL queries.
إذا لم ينجح التحقق، أعد بناء مخطط العلاقات باستخدام ستة صفوف مقدمة، وأصلح أول مفتاح أو قيد معطوب، ثم أعد تشغيل المخطط والاستعلامات النموذجية نفسها.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.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
اطلب من المتعلم إعادة شرح تحقق الأسبوع السابق وهدف اليوم قبل بدء العمل الموجّه: استخدام Python لإنشاء سجلات PostgreSQL وقراءتها وتحديثها والتحقق منها عبر واجهة سطر أوامر مختبرة.Ask the learner to restate the previous checkpoint and today’s purpose before guided work begins: Use Python to create, read, update and validate PostgreSQL records through a tested command-line interface.
نفّذ واجهة سطر أوامر بلغة Python تنشئ سجلات PostgreSQL وتقرأها وتحدثها وتتحقق منها مع اختبارات.Implement a Python CLI that creates, reads, updates, and validates PostgreSQL records with tests.
إذا فشلت الأدلة، شغّل أمراً واحداً على عينة نظيفة يقدمها المدرّب، وأصلح التحقق قبل الوصول إلى قاعدة البيانات، ثم أعد سجل الإنشاء والقراءة والتحديث والاختبارات نفسه.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.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
اطلب من المتعلم إعادة شرح تحقق الأسبوع السابق وهدف اليوم قبل بدء العمل الموجّه: بناء نقاط نهاية HTTP موثقة بعقود Pydantic محددة النوع وبيانات في الذاكرة قبل إضافة التخزين الدائم.Ask the learner to restate the previous checkpoint and today’s purpose before guided work begins: Build documented HTTP endpoints with typed Pydantic contracts and in-memory data before adding persistence.
ابنِ نقاط نهاية موثقة في FastAPI باستخدام Pydantic وبيانات في الذاكرة قبل التخزين الدائم.Build documented FastAPI endpoints using Pydantic with in-memory data before persistence.
إذا كان العقد غير واضح، أكمل جدول نقاط النهاية وأصلح حد Pydantic واحداً كل مرة ثم أعد التقاط الاستجابات الموثقة الثلاث نفسها.If the contract is unclear, complete the endpoint table, repair one Pydantic boundary at a time, and recapture the same three documented responses.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
اطلب من المتعلم إعادة شرح تحقق الأسبوع السابق وهدف اليوم قبل بدء العمل الموجّه: استبدال التخزين في الذاكرة بـPostgreSQL مع الحفاظ على عقد API وإثبات السلوك الدائم بالاختبارات.Ask the learner to restate the previous checkpoint and today’s purpose before guided work begins: Replace in-memory storage with PostgreSQL while preserving the API contract and proving persistent behaviour with tests.
اربط نقاط نهاية CRUD بـPostgreSQL وأثبت التخزين الدائم ومعالجة الإدخال غير الصالح وسلوك السجل المفقود والاختبارات الآلية.Connect CRUD endpoints to PostgreSQL and prove persistence, invalid-input handling, missing-record behaviour, and automated tests.
إذا فشلت الأدلة، قارن نقطة نهاية واحدة بعقد الأسبوع السابع واختبر دالة قاعدة بياناتها منفردة، ثم كرر إثبات إعادة التشغيل والإدخال غير الصالح والسجل المفقود والاختبارات الآلية نفسه.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.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
اطلب من المتعلم إعادة شرح تحقق الأسبوع السابق وهدف اليوم قبل بدء العمل الموجّه: استدعاء نموذج من كود موثوق على الخادم والتحقق من نتيجة منظمة والتعامل المقصود مع بيانات الدخول والتكلفة والفشل.Ask the learner to restate the previous checkpoint and today’s purpose before guided work begins: Call a model from trusted server-side code, validate a structured result and handle credentials, cost and failure deliberately.
استدعِ نموذجاً عبر عميل على الخادم واطلب نتيجة منظمة وتحقق منها وأبق المفتاح خارج التحكم بالمصدر وأظهر وعياً بالتكلفة والفشل.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.
إذا فشلت الأدلة، استخدم عينات الاستجابة الوهمية أولاً وأصلح التحقق من المخطط ومعالجة غياب المفتاح، ثم كرر استدعاءً حياً محدوداً واحداً والدليل المحجوب نفسه.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.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
اطلب من المتعلم إعادة شرح تحقق الأسبوع السابق وهدف اليوم قبل بدء العمل الموجّه: إتاحة ميزة ذكاء اصطناعي ضيقة التعريف عبر نقطة نهاية متحقق منها بحد زمني وأخطاء آمنة وسلوك بديل حتمي.Ask the learner to restate the previous checkpoint and today’s purpose before guided work begins: Expose one narrowly defined AI feature through a validated endpoint with time bounds, safe errors and deterministic fallback behaviour.
أتِح نقطة نهاية AI مضبوطة واحدة مع التحقق من المخطط ومعالجة المهلة والأخطاء ورسالة بديلة حتمية.Expose one controlled AI endpoint with schema validation, timeout/error handling, and a deterministic 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.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
اطلب من المتعلم إعادة شرح تحقق الأسبوع السابق وهدف اليوم قبل بدء العمل الموجّه: دمج API قاعدة البيانات وميزة AI محدودة واحدة في نسخة مرشحة للإصدار يملكها المتعلّم فردياً ومختبرة وموثقة.Ask the learner to restate the previous checkpoint and today’s purpose before guided work begins: Integrate the database API and one bounded AI feature into an individually owned, tested and documented release candidate.
ادمج API قاعدة البيانات وميزة AI المحدودة في نسخة فردية مرشحة للإصدار مع اختبارات وتوثيق.Combine the database API and bounded AI feature into an individual release candidate with tests and documentation.
إذا فشلت أدلة الإصدار، احذف الميزات المؤجلة واستعد آخر مسار أساسي ناجح وأصلح أول خطوة إعداد نظيف فاشلة ثم أعد إنشاء أدلة الاختبارات والتوثيق نفسها.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.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
اطلب من المتعلم إعادة شرح تحقق الأسبوع السابق وهدف اليوم قبل بدء العمل الموجّه: إعداد أدلة قابلة للتحقق للإعداد والمناقشة وشرح استخدام AI والتدرّب على التصحيح المستقل دون كشف مهمة البوابة الحية.Ask the learner to restate the previous checkpoint and today’s purpose before guided work begins: Prepare verifiable setup and defence evidence, explain AI use and rehearse independent debugging without disclosing the live gate task.
حضّر دليل إعداد نظيفاً ومناقشة المشروع وشرح استخدام AI وتدريب تصحيح مستقلاً دون كشف مهمة البوابة الحية.Prepare clean setup evidence, project defence, AI-use explanation, and an independent debugging rehearsal without revealing the live gate task.
إذا كانت الأدلة النهائية غير مكتملة، أصلح أول فجوة في الإعداد النظيف أو الشرح، وكرر أدلة مناقشة المشروع نفسها، وتدرّب على خلل تدريبي منفصل جديد دون الوصول إلى مهمة البوابة الحية أو مناقشتها.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.
استخدم العرض المسجّل والحزمة العربية القابلة للتنزيل والنسخة المحلية من البداية؛ واعتمد دليلاً مكافئاً عن بُعد أو دون اتصال بعد أن يسجل المنسق الانقطاع.Use the recorded demonstration, downloadable Arabic-first pack and local starter copy; approve equivalent remote or offline evidence after the coordinator records the interruption.
حضّر المتعلمين باستخدام المعايير المنشورة: أدلة ملف الإنجاز والعرض الحي والمناقشة ومهمة مستقلة تحت الملاحظة دون ذكاء اصطناعي. لا تكشف بنوك المهام أو المهام الحية أو ملاحظات المقيمين أو نتائج المشاركين هنا.Prepare learners using published criteria: portfolio evidence, a live demonstration and defence, and an observed independent task without AI. Do not expose task banks, live tasks, assessor notes or participant results here.
لإرشاد التنفيذ الداخلي، راجع دليل التقييم داخل المستودع فقط في:For internal operational guidance, consult the repository-only assessment handbook at:
docs/programs/ai-integration-foundation/assessment-handbook.mdهذا المسار ليس رابطاً في المتصفح عمداً. وسيحتوي إجراءات المقيمين لا محتوى مهام البوابة الحية.This path is intentionally not a browser link. It will contain assessor procedures, not live gate task content.