File size: 9,818 Bytes
a7e08a9
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
968115e
 
 
 
a7e08a9
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
"""دليل البرنامج التدريبي، على معايير مراجعة 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