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
|