---
name: lesson-authoring
description: قواعد تأليف دروس منصّة شوجب وأنواع الأسئلة التفاعلية وقاعدة توزيعها. استخدمها عند إضافة درس جديد، أو تأليف أسئلة تفاعلية، أو تعديل أسئلة درس قائم.
---

# تأليف دروس منصّة شوجب

دليل التأليف العمليّ: **أنماط التصميم والعرض والتفاعل** في المنصّة.
**القواعد الملزمة وكتالوج الأنواع ليست هنا** بل في مصادرها، وهذه المهارة تشير إليها دون تكرار.

## المراجع الملزمة (اقرأها قبل التأليف)
- **`CLAUDE.md`** — موطن كل القواعد الملزمة: **نطاق المواد**، **قاعدة التوزيع** (٥ أساسية إلزامية + إثرائي اختياري = ٥ أو ٦ أسئلة، للعلوم حالياً)، **المستوى المعرفي** (العلوم ٣ معرفة + ١ تطبيق + ١ استدلال · الرياضيات ٢+٢+١ · **اللغة العربية على سُلَّمٍ رباعيّ في دروس القراءة وفهم المقروء وحدها**: ١ `knowledge` + ١ `reasoning` + ٢ `application` + ١ `evaluation`؛ ودروس الأنماط والإملاء بلا توزيع إلزاميّ)، و**قالبا تأليف اللغة العربية** (قالبٌ لكلّ نوعٍ من الدرسَين)، **ربط السؤال بالهدف**، **قاعدة بناء الأنواع الجديدة بطلب مستقل فقط** (لكل المواد)، و**خطوات التأليف**.
- **`question-types.md`** — كتالوج الأنواع المشتركة الـ١٦ (٨ أساسية + ٨ إثرائية)، والأنواع الخاصة بكلِّ مادة (**العلوم** نوعٌ واحد · **الرياضيات** ثلاثةَ عشرَ · **اللغة العربية** خمسة)، وفئاتها (أساسية/إثرائية) وتنظيمها بحسب النطاق، والأنواع المخطّطة لكل مادة. **هو الحَكَم** في وصف نوعٍ أو فئتِه.
- **`نماذج-الأسئلة.md`** — صيغة بيانات الأنواع المبنية برمجياً؛ أثناء التأليف استخدم الأنواع الموثقة فيه **فقط**.

> **التأليف** = إنتاج بيانات أسئلة بمنطق الأنواع الموجود (اكتب المنطق مرة، يعمل مع كل البيانات) — لا برمجة أنواع جديدة (انظر «قاعدة بناء الأنواع الجديدة» في `CLAUDE.md`). إن استدعى الدرس نوعاً غير موجود، أخبر المستخدم أولاً ولا تنفّذه تلقائياً.

## أنماط تصميم مهمّة
### السحب والإفلات — نمطان
**١) تسمية على صورة** (تسمية أجزاء هيكل/نبتة/خريطة):
- الصورة في منتصف منطقة النشاط، والصناديق الفارغة **حولها** حسب موقع كل جزء (لا فوقها).
- من كل صندوق **خط واصل ينتهي بنقطة دائرية مؤشّرة** عند الجزء المقصود بالضبط.
- الطالب **يسحب الكلمة إلى صندوقها الجانبي**.
- طبقة **SVG شفّافة** فوق الصورة لرسم الخطوط والنقاط، بإحداثيات (x,y) قابلة للتعديل بسهولة في البيانات.

**٢) تصنيف** (فرز عناصر في مجموعات):
- صناديق المجموعات جنباً إلى جنب، تُسحب إليها العناصر، بلا صورة مركزية ولا خطوط.

**لون نصّ الكلمات المسحوبة أسود** (لا أبيض) ليكون واضحاً على أي خلفية.

### التوصيل
- المفردات في **عمودين متباعدين** (مسافة واسعة بينهما لرسم الخطوط)؛ عند التوصيل يُرسم **خط منحنٍ أنيق (Bézier)** بنقطة دائرية عند كل طرف، بطبقة **SVG** ديناميكية.
- **لون موحّد** لكل الخطوط (متناسق مع هوية المنصّة). الصحيح: يبقى الخط ثابتاً + صوت + نقاط. الخطأ: يُمحى الخط + تشجيع لطيف لإعادة المحاولة.
- يوصّل الطالب بالسحب من نقطة لنقطة أو بالنقر على طرف ثم الآخر (النقر أنسب للسبورة).

## عرض الأسئلة داخل الدرس (خطوة بخطوة)
- تُعرض الأسئلة **واحداً في كل مرة** (لا تظهر كلها دفعة واحدة)، والبقية مخفيّة.
- **توسيط السؤال**: محتوى السؤال (النصّ والخيارات ومنطقة النشاط) متموضع في **منتصف بطاقة السؤال** أفقياً وعمودياً — لا مُلتصقاً بالأعلى أو أحد الجوانب، مع مسافات متوازنة حوله.
- زرّان: "التالي ←" و"→ السابق"، والتنقّل **حرّ** دون إلزام بحلّ السؤال أولاً.
- **مؤشّر تقدّم** ("السؤال ٢ من ٥")، وزر "السابق" معطّل في الأول و"التالي" في الأخير.
- في الأخير: زر "إنهاء" يعرض النتيجة (عدد الإجابات الصحيحة من الإجمالي).
- الإجابات المحلولة **تبقى محفوظة** عند التنقّل ذهاباً وإياباً.

## دعم كل الأنواع (إلزامي)
- صوت عربي عند الإجابة (Web Speech API)، وصوت صحيح (`audio/correct.mp3`)، وزر كتم.
- **نظام المكافأة = رحلة الصاروخ** (`js/rocket.js` المشترك، مفعَّل تلقائياً لكل درس له أسئلة): الصاروخ يرتفع مع كل إجابة صحيحة نحو القمر (المعادلة تتكيّف مع عدد أسئلة الدرس)، ويختنق محرّكه وينزلق عند الخطأ. **لا يُعاد بناء هذا النظام في أي درس** — يكفي تأليف بيانات الأسئلة.
- **أُلغي نظام النجوم/النقاط نهائياً** (لا شريط علوي، ولا سطر «مجموع نجومك» في التقرير).
- **`audio/wrong.mp3` لم يعد يُستخدم** في دروس المنصّة (اختناق المحرّك هو تنبيه الخطأ)؛ لا تعتمد عليه في أي تأليف جديد.
- عناصر كبيرة تناسب اللمس على السبورة الذكية، واتجاه النص من اليمين لليسار (RTL).

## الصور والرسومات
- **قاعدة التفصيل البصري (إلزامية — نصّها في `CLAUDE.md`):** المعيار مستوى فنّ المنصّة (رسم الصاروخ)، تلقائياً بلا طلب: رسم يدوي غنيّ فوراً (مكونات الجسم الطبيعية + عمق مسطّح) + تسجيل بند ترقية في `graphics-queue.md` لكل رسم يجتاز بوّابة `shoogp-graphics`.
- **الأشكال البسيطة** (هياكل، مخطّطات، أشكال هندسية، رموز): ارسمها **SVG** داخل الكود مباشرة — لا صور خارجية.
- **المشاهد الواقعية** (نباتات، حيوانات، أشياء حقيقية): استخدم صورة من مجلّد `images\` (مجلّد واحد بجانب المنصّة).
- ابحث في `images\` عن صورة اسمها **يطابق موضوع السؤال**.
- **أسماء الصور بلا مسافات ولا أقواس؛ استخدم شَرطة `-`** (مثال: `هيكل-عظمي.png`).
- إن لم تجد صورة مناسبة، **أخبر المستخدم لإضافتها** — لا تستخدم صورة غير مطابقة.
- الصور الواقعية حرّة الحقوق أو من تصوير المعلّم.
- برومبتات الصور الناقصة تُصاغ بنفس أسلوب ومواصفات ملف برومبتات الكتاب (المرجع: قسم بطاقات الكتب في `CLAUDE.md`).