"""دليل البرنامج التدريبي، على معايير مراجعة 2026-09. ثلاث ملاحظات، وثلاثة أنواع مختلفة من الإصلاح. **المحاذاة.** «ضبط محاذاة كافة النصوص والقوائم لتكون محاذاة إلى اليمين مع محاذاة مساوية لجميع العناوين والنقاط المنسدلة». العناوين كانت مختلفة المحاذاة بين مستوى وآخر، والقوائم مضبوطة (justify) فلا تبدأ من حيث يبدأ العنوان فوقها. **الهدف العام.** «لا يُشترط أن يشتمل على فعل سلوكي ذري واحد … بل يصف الغايات الشاملة والأثر النهائي»، و«يُصاغ في عبارة مركزة ترتبط بـ تطوير مهارات الفئة المستهدفة + الأثر الميداني المتوقع، وتتجنب العبارات المطاطة والمركبة من عدة أهداف فرعية». **عدد الأهداف مقابل الزمن.** «الحقيبة مدتها يوم تدريبي واحد (4 ساعات)، بينما يحتوي الدليل على 10 أهداف تفصيلية … التوزيع المعياري الصحيح هو من 4 إلى 6 أهداف تفصيلية … بواقع 2-3 أهداف لكل جلسة». العدد صار دالّةً في عدد الجلسات بدل أن يكون ثابتًا. """ from __future__ import annotations import pytest from docx import Document from app.agents.arabic_bag import docx_render as R from app.agents.arabic_bag.context import using from app.agents.arabic_bag.preamble import ( GENERAL_OPENERS, MAX_CHAINED_AIMS, validate_preamble, ) from app.agents.arabic_bag.review_rules import ( covers_per_session, detailed_range, objectives_block, sessions_in_bag, ) def _bag(sessions: int = 2, **over) -> dict: return { "bag_name": "ريادة الأعمال في القطاع الحكومي", "target_audience": "مديرو الإدارات", "domain": "الإدارة الحكومية", "delivery_mode": "Face-to-Face", "audience_gender": "مذكر", "session_minutes": 120, "days": [{"day_number": 1, "sessions": [ {"session_number": i, "session_title": f"الجلسة {i}", "topics": []} for i in range(1, sessions + 1)]}], **over, } # ───────────────────────────── ١) المحاذاة def test_every_heading_has_the_same_alignment(): """«محاذاة مساوية لجميع العناوين». كان h1 في المنتصف وما تحته إلى اليمين.""" from docx.enum.text import WD_ALIGN_PARAGRAPH doc = Document() R._set_doc_rtl(doc) for level in ("h1", "h2", "h3", "h4"): R.add_h(doc, f"عنوان {level}", level) alignments = {p.alignment for p in doc.paragraphs if p.text.strip()} assert alignments == {WD_ALIGN_PARAGRAPH.RIGHT}, alignments def test_lists_start_where_their_heading_starts(): """«كافة النصوص والقوائم … محاذاة إلى اليمين». الضبط يمدّ سطرًا قصيرًا ويترك آخر سطر معلّقًا، فلا يقف البند تحت عنوانه.""" from docx.enum.text import WD_ALIGN_PARAGRAPH doc = Document() R._set_doc_rtl(doc) R.add_h(doc, "قائمة التجهيزات", "h2") R.add_bullets(doc, ["البند الأول", "البند الثاني"]) R.add_numbered(doc, ["الخطوة الأولى"]) R.add_titled_point(doc, "عنوان النقطة", "شرحها في سطرين.") for p in doc.paragraphs: if p.text.strip(): assert p.alignment == WD_ALIGN_PARAGRAPH.RIGHT, p.text[:40] def test_the_topic_title_is_still_centred(): """المراجعة نفسها طلبت «العنوان في المنتصف» للموضوع، وهو لا يُرسم عنوانًا فلا يشمله التغيير أعلاه.""" import inspect source = inspect.getsource(R.generate_word) # printed through clean_heading since the audit (no stop after a title) call = 'add_para(doc, clean_heading(c.get("topic")' assert call in source assert 'align="center"' in source[source.index(call):][:240] # ───────────────────────────── ٢) الهدف العام def test_the_general_objective_may_open_either_way(): """قالب النوتبوك يفتح بـ «تمكين» وحدها، ومثال المراجعة يفتح بـ «إكساب»؛ فاحصٌ يعرف واحدًا منهما يرفض صياغة المراجعة نفسها.""" assert set(GENERAL_OPENERS) == {"تمكين", "إكساب"} good = ("إكساب المشاركين المعارف والمهارات الأساسية لتطبيق مفاهيم ريادة " "الأعمال والابتكار في البيئة الحكومية، وتمكينهم من رصد وتطوير " "الفرص الاستثمارية والخدمية لرفع كفاءة الأداء المؤسسي.") with using(_bag()): errs = [e for e in validate_preamble({"general_objective": good}) if "الهدف العام" in e] assert not errs, errs def test_a_chain_of_secondary_aims_is_rejected(): """«تتجنب العبارات المطاطة والمركبة من عدة أهداف فرعية».""" chained = ("تمكين الفتيات من تنمية مهارات الذكاء العاطفي بما يعزز وعيهن " "بالذات، وقدرتهن على إدارة مشاعرهن، وبناء علاقات اجتماعية " "ومهنية متوازنة وإيجابية.") with using(_bag()): errs = validate_preamble({"general_objective": chained}) assert any("غايات متتابعة" in e for e in errs), errs assert MAX_CHAINED_AIMS == 1 def test_the_standard_is_in_the_prompt_too(): """الفاحص يردّ، والبرومبت يمنع الردّ أصلًا.""" with using(_bag()): block = objectives_block() assert "الأثر الميداني" in block assert "لا يلزم أن يحمل الهدف العام فعلًا سلوكيًا واحدًا" in block assert "«إكساب» أو «تمكين»" in block # ───────────────────────────── ٣) العدد مقابل الزمن @pytest.mark.parametrize("sessions,window", [ (1, (4, 4)), (2, (4, 6)), # الحقيبة التي راجعها المراجع: يوم واحد، جلستان (3, (6, 9)), (4, (8, 10)), (6, (10, 10)), # السقف يحكم، ولا يتجاوزه الحد الأدنى (15, (10, 10)), ]) def test_the_number_of_objectives_follows_the_clock(sessions, window): """«يُستحيل تحقق 10 أهداف تفصيلية بفاعلية» في أربع ساعات.""" with using(_bag(sessions)): assert detailed_range() == window assert sessions_in_bag() == sessions def test_ten_objectives_on_a_two_session_bag_are_rejected(): """هذه هي الحالة التي رُدّت: يوم واحد، جلستان، عشرة أهداف.""" with using(_bag(2)): errs = validate_preamble({ "general_objective": "إكساب المشاركين المهارات لرفع كفاءة الأداء المؤسسي.", "detailed_objectives": [f"يتعرف على المفهوم {i}." for i in range(10)], }) assert any("الأهداف التفصيلية 10" in e for e in errs), errs assert any("جلسة" in e for e in errs), "الرسالة لا تقول سبب الرقم" def test_the_session_count_became_one_objective_per_cover(): """«بواقع 2-3 أهداف لكل جلسة» في 2026-09، ثم «لكل محور تدريبي هدف سلوكي واحد فقط» في المراجعة التي تلتها. القاعدتان لا تتعارضان: الثانية هي الصيغة العامة للأولى — جلسة بمحورين أو ثلاثة تُولّد هدفين أو ثلاثة. الفرق أن العدد لم يعد نطاقًا يُختار منه، بل عدد محاور الجلسة بالضبط. الاختبار الكامل في `test_bag_curriculum.py`. """ with using(_bag(2)): assert covers_per_session() # الجلسات معروفة assert not hasattr( __import__("app.agents.arabic_bag.review_rules", fromlist=["x"]), "PER_SESSION", ), "النطاق القديم ما زال موجودًا إلى جانب القاعدة التي حلّت محلّه" def test_the_schema_is_an_envelope_not_the_rule(): """المخطط ثابت ولا يعرف الحقيبة؛ النافذة يفرضها الفاحص لأنه يعرفها. مخطط يشترط ثمانية كان يرفض الأربعة التي طلبتها المراجعة قبل أن يصل الردّ إلى الفاحص أصلًا. """ from app.agents.arabic_bag.preamble import PreambleOutput, SessionObjectives detailed = PreambleOutput.model_fields["detailed_objectives"] lengths = {type(m).__name__: getattr(m, "min_length", getattr(m, "max_length", None)) for m in detailed.metadata} assert lengths.get("MinLen", 99) <= 4, "المخطط ما زال يرفض أربعة أهداف" objectives = SessionObjectives.model_fields["objectives"] mins = [getattr(m, "min_length", None) for m in objectives.metadata] assert min([m for m in mins if m is not None], default=99) <= 2