saqel/AGENTS.md

تعليمات العمل الدائمة — صَقِل

المرجع والسياق

هذه تعليمات المشروع لأي نموذج ينفذ أعمالاً لاحقة. تعليمات المستخدم في المهمة الحالية مقدمة عليها. لا يبدأ تنفيذ ميزة لمجرد وجودها في خارطة الطريق؛ نفّذ نطاق المهمة المطلوبة فقط.

قبل تنفيذ أي مهمة من المرحلة القادمة اقرأ:

1. docs/NEXT_PHASE_MASTER_SPEC.md — قرارات المنتج، تجربة التعليم، ونموذج الدخل.
2. docs/CURRENT_STATE_AUDIT_2026-09-09.md — تدقيق الكود المحلي والفجوات المثبتة بتاريخ المراجعة.
3. docs/NEXT_PHASE_EXECUTION_BACKLOG.md — ترتيب التنفيذ ومعايير القبول؛ اختر المهمة ذات الصلة وتحقق من متطلباتها السابقة.
4. docs/VIDEO_REVIEW_AND_SOCRATIC_PROMPTS.md عند العمل على المحتوى أو الفيديو أو الفحص أو محادثة الدرس.

الوثائق القديمة مرجع تاريخي. لا تتبنى منها ادعاءات «100% مكتمل»، إيرادات، إعفاءات، شراكات، أو تميز على المنافسين من دون دليل حديث. عند اختلاف وصف التنفيذ والكود، سجّل الفرق ولا تفترض أن السيرفر مطابق للنسخة المحلية.

قواعد ملزمة للمنتج

• لا بيانات ديمو في تجربة المستخدم، ولا نجاح مالي أو تعليمي مصطنع. البيانات التعليمية المزروعة مقبولة عندما تكون حقيقية، مرتبطة بمصدر ونسخة ومراجعة. Fixtures الاختبارات معزولة عن التشغيل ولا تدخل الأرباح والتقييمات.
• المحتوى المنشور يأتي من حزمة معتمدة على الخادم. يمكن تخزين نسخة محلية موثقة منها للعمل دون اتصال؛ يمنع استخدام درس ثابت بديل عند فقد الملف المطلوب.
• اعتمد هوية منهجية ثابتة تشمل الصف والمبحث والفصل والوحدة والدرس ونسخة المنهج. العنوان وlesson_01 وحدهما ليسا هوية.
• الدرس المنهجي الواحد يقبل حصصاً من معلمين متعددين. لنفس المعلم حصة أساسية منشورة واحدة لكل درس؛ الإعادة تكون نسخة مرشحة للاستبدال تخضع للفحص الكامل. لا تلغ النسخة الحالية قبل نجاح البديلة.
• صفر حصص: حالة فارغة صادقة مع الموارد الموجودة. حصة واحدة متاحة: تشغيل مباشر. أكثر من حصة متاحة: قائمة المعلمين مرتبة بالتقييم الموثوق، مع عدد التقييمات والتصفح على دفعات.
• افصل صلاحيات المدرسة عن السوق المستقل، وميزانية دخل كل منهما. لا تفترض أن كل طالب مدرسي يولّد ربح مشاهدة أو أن راتب المعلم يلغي استحقاقه التعاقدي.
• دخل المعلم من الدقائق المستحقة وفق سياسة موثقة، وليس من بيع باقات المعلم. معاملات السعر ونسبة الصندوق تحتاج قراراً تجارياً مثبتاً، ولا تُخترع داخل الكود.
• المشاهدة والتقييم والأرباح والإتقان تُحتسب وتُراجع على الخادم. لا تعتمد عداد العميل أو نجاح سؤال واحد لإثبات دخل أو إتقان.
• البصمة/Face ID تأكيد للعملية على الجهاز. لا تخزن بيانات بيومترية ولا تعتمد biometric_success=true. اكتمال الدفع والسحب يحتاج دليلاً من مزود الدفع وتسوية قابلة للتتبع.
• أسئلة الفيديو ومحادثته مرتبطة بنسخة الفيديو والتفريغ الزمني وMarkdown المعتمد. لا توليد من العنوان فقط، ولا توقيتات تخمينية، ولا اعتماد تلقائي عند نقص الدليل.
• الإنجليزية تتبع الكتاب والدرس المحددين. يمنع اختراع ترجمة أو IPA، أو خلط قواعد الوحدات، أو تقديم نص متقدم بوصفه تبسيطاً لطالب مبتدئ.
• PDF الكتاب وأوراق العمل Markdown وصور الخرائط الذهنية أصول مستقلة ذات نسخ؛ لا تحل صورة أو ملخص مكان الأصل دون بيان واضح.

طريقة التنفيذ والتسليم

• حافظ على PHP الأصلي وFlutter/Cubits الحاليين؛ لا تحول المشروع إلى Laravel أو تعيد بناء التطبيقات دون طلب.
• ابدأ بتتبع مسار الميزة من الواجهة إلى قاعدة البيانات/التخزين. أصلح السبب في طبقة الخادم عندما يتعلق القرار بالصلاحية أو المال أو النشر.
• اجعل تغييرات قاعدة البيانات migrations واضحة مع خطة ترحيل وعودة. لا تنشئ الجداول داخل طلبات القراءة.
• للمزايا المالية أو الصلاحيات أو الاستبدال: اختبارات فشل وتزامن وidempotency إلزامية. اختبارات شكل الشاشة وحدها لا تكفي.
• لا تشغّل سكربتات تحمل اسم test قبل قراءتها؛ بعضها يستدعي خدمات مدفوعة أو يكتب بيانات. لا تفترض وجود php artisan test في هذا المشروع.
• سلّم: ما تغير، الملفات، الاختبارات التي شغلت فعلاً ونتائجها، ما لم يُختبر، وخطوة المتابعة. لا تحوّل المخطط إلى علامة «منجز» دون دليل.
• حافظ على تغييرات المستخدم الموجودة. لا تحذف بيانات إنتاج، ولا تنشر، ولا تحوّل أموالاً ضمن مهمة تخطيط أو مراجعة.
• لا تضف التوسع الجغرافي أو المهني أو ميزات المرحلة المؤجلة إلى مهمة إثبات الصف العاشر دون طلب جديد.