File size: 12,903 Bytes
ea1dd9a
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3502ad3
ea1dd9a
 
3502ad3
ea1dd9a
 
3502ad3
ea1dd9a
3502ad3
ea1dd9a
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
"""The HTML export - cell [20].

Ported from `case_study_pipeline.ipynb`. The notebook was one namespace, so
each module re-imports the ones before it; every prompt and every standard is
the notebook's text, compared character by character by the fidelity test.
"""

from __future__ import annotations

import asyncio  # noqa: F401
import datetime  # noqa: F401
import html  # noqa: F401
import json  # noqa: F401
import pathlib  # noqa: F401
import re  # noqa: F401
from typing import Any, Callable, Literal, Optional  # noqa: F401

from pydantic import (  # noqa: F401
    BaseModel,
    ConfigDict,
    Field,
    ValidationError,
    model_validator,
)

from app.agents.case_study.helpers import *  # noqa: F403
from app.agents.case_study.profiles import *  # noqa: F403
from app.agents.case_study.standards import *  # noqa: F403

# The notebook was one namespace; the exporters read it too.
from app.agents.case_study.llms import RUN_CONFIG  # noqa: F401
# `_answer_lines` is defined in the Word exporter's cell and used by both.
from app.services.case_study.docx_case import _answer_lines

def _e(s) -> str:
    return html.escape(str(s or ""))

_HTML_CSS = """
:root{--ink:#1d2433;--muted:#667085;--line:#d0d7e2;--brand:#1f4e79;--soft:#eef4fb;--ok:#e2efda;--warn:#fff2cc;--act:#c55a11;--bg:#f6f8fb;--card:#fff}
*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink);font:15px/1.8 "Noto Naskh Arabic","Traditional Arabic",Tahoma,Arial,sans-serif}
main{max-width:1180px;margin:0 auto;padding:24px 16px 64px}h1{font-size:26px;margin:0 0 4px;color:var(--brand)}
.sub{color:var(--muted);margin:0 0 24px}h2{font-size:19px;color:var(--brand);margin:32px 0 12px;border-bottom:2px solid var(--brand);padding-bottom:4px}
table{width:100%;border-collapse:collapse;background:var(--card);table-layout:fixed}td,th{border:1px solid var(--line);padding:8px 10px;vertical-align:top;text-align:start;word-wrap:break-word}
th{background:var(--brand);color:#fff}.lab{background:var(--soft);font-weight:700;width:24%}.num{width:8%;text-align:center;font-weight:700;font-size:20px}
.kind{display:block;font-size:11px;color:var(--muted);font-weight:400}.vo{width:40%}.ln{margin:0 0 4px}.idx{color:#98a2b3;font-size:11px;margin-inline-end:4px}
td p{margin:0 0 6px}.dlg b{color:#7030a0}.bul::before{content:"▪ ";color:var(--brand)}.strong{font-weight:700}.center{text-align:center}
.inter-title{color:var(--act);font-weight:700;margin-bottom:6px}.itab td{font-size:14px}.ok{background:var(--ok);font-weight:700}.fb{background:var(--warn);font-weight:700}
.btn{display:inline-block;border:1px solid var(--brand);border-radius:6px;padding:0 10px;color:var(--brand);font-weight:700}
.k{color:var(--brand);font-weight:700}.freeze{color:#bf8f00;font-weight:700;margin-top:6px}ul{margin:4px 0;padding-inline-start:20px}
.beat{margin:0 0 4px;font-size:14px}.note{color:var(--muted);font-style:italic}details{margin-top:24px;background:var(--card);border:1px solid var(--line);padding:10px 14px;border-radius:8px}
@media (max-width:760px){table,tbody,tr,td,th{display:block;width:100%!important}thead{display:none}td{border-top:none}.num{text-align:start}}
"""

def _answers_html(it: dict, fam: str) -> str:
    return "".join(f"<div>{_e(a)}</div>" for a in _answer_lines(it, fam))

def _interaction_html(sc: dict) -> str:
    it, fam = sc["interaction"], sc["interaction_family"]
    rows = [f"<tr><td colspan=2><div class=k>{_e(it['header'])}</div><div class=strong>{_e(it['situation_sentence'] + ' ' + it['question'])}</div></td></tr>"]
    if fam == "choice" and len(it["items"]) == 2:
        rows.append("<tr>" + "".join(f"<td>{'أب'[i]}. {_e(x['text'])}</td>" for i, x in enumerate(it["items"])) + "</tr>")
    else:
        mark = {"multi_select": "🔘", "reveal": "▣", "poll": "○"}.get(fam, "▫")
        cats = f"<div class=strong>الفئات: {_e(' | '.join(it['categories']))}</div>" if fam == "categorize" else ""
        rows.append("<tr><td colspan=2>" + cats + "".join(f"<div>{mark} {_e(x['text'])}</div>" for x in it["items"]) + "</td></tr>")
    rows.append(f"<tr><td colspan=2 class=strong>{_e(it['instruction'])}" + (f"<div>{_e(it['hint_sentence'])}</div>" if it.get("hint_sentence") else "") + "</td></tr>")
    if it.get("hint"):
        rows.append("<tr><td colspan=2><b>💡 تلميح (Hint):</b><ul>" + "".join(f"<li>{_e(h)}</li>" for h in it["hint"]) + "</ul></td></tr>")
    rows.append(f"<tr><td colspan=2 class=ok>✅ الإجابة الصحيحة</td></tr><tr><td colspan=2>{_answers_html(it, fam)}</td></tr>")
    if it.get("check_button"):
        rows.append(f"<tr><td colspan=2 class=center><span class=btn>{_e(it['check_button_label'])}</span></td></tr>")
    rows.append("<tr><td colspan=2 class=fb>التغذية الراجعة</td></tr>")
    fc, fi = it["feedback_correct"], it.get("feedback_incorrect")
    if fi:
        rows.append(f"<tr><td>✅<div class=strong>{_e(fc['opener'])}</div>{_e(fc['text'])}</td>"
                    f"<td>❌{' (بعد استنفاد المحاولات)' if it.get('feedback_retry') else ''}<div class=strong>{_e(fi['opener'])}</div>{_e(fi['text'])}"
                    + "".join(f"<p class=note>({_e(x['id'])}) {_e(x['feedback'])}</p>" for x in it["items"] if x.get("feedback") and not x.get("is_correct"))
                    + "</td></tr>")
    else:
        rows.append(f"<tr><td colspan=2>✅ تعليق ختامي<div class=strong>{_e(fc['opener'])}</div>{_e(fc['text'])}</td></tr>")
    if it.get("feedback_retry"):
        r = it["feedback_retry"]
        rows.append(f"<tr><td colspan=2>❌ المحاولة الأولى الخاطئة (مع إتاحة المحاولة الثانية)<div class=strong>{_e(r['opener'])}</div>{_e(r['text'])}</td></tr>")
    mech = "<div class=k>آلية التفاعل التقني:</div><ul>" + "".join(f"<li>{_e(m)}</li>" for m in it["mechanism"]) + "</ul>"
    return (f"<div class=inter-title>⏸ شاشة تفاعل: {_e(it['type_ar'])}</div><p class=note>المحاولات المتاحة: {it['attempts']}</p>"
            f"<table class=itab>{''.join(rows)}</table>{mech}")

def _vo_html(sc: dict) -> str:
    out = []
    for i, ln in enumerate(sc["lines"]):
        cls = {"bullet": "ln bul", "closing_sentence": "ln strong", "thanks": "ln strong center", "dialogue": "ln dlg"}.get(ln["role"], "ln")
        sp = f"<b>{_e(ln['speaker'])}:</b> " if ln["role"] == "dialogue" else ""
        out.append(f"<p class='{cls}'><span class=idx>[{i + 1}]</span>{sp}{_e(ln['text'])}</p>")
    return "".join(out)

def _desc_html(sc: dict) -> str:
    v = sc["visual"]
    if not v:
        return ""
    out = ["<div class=k>وصف المشهد:</div><div class=k>التتابع البصري (beat لكل سطر):</div>"]
    for b in v["beats"]:
        parts = [b["visual_idea"], f"اللقطة: {b['shot']}", f"الحركة: {b['action']}"]
        if b.get("on_screen_text"):
            parts.append(f"على الشاشة: «{b['on_screen_text']}»" + (f" ({b['text_position']})" if b.get("text_position") else ""))
        parts += [f"{lab}: {b[k]}" for k, lab in (("effect", "التأثير"), ("sfx", "الصوت"), ("transition", "الانتقال")) if b.get(k)]
        out.append(f"<p class=beat><span class=idx>[{b['line_index'] + 1}]</span>{_e(' — '.join(parts))}</p>")
    out.append(f"<p><span class=k>الوصف التنفيذي:</span> {_e(v['narrative'])}</p>")
    d = v["description"]
    for k, lab in (("background", "الخلفية والبيئة"), ("characters", "الشخصيات وتعبيرات الوجه"), ("actions", "الحركات والأفعال"),
                   ("shots", "اللقطات والزوايا"), ("visual_effects", "المؤثرات البصرية"), ("sound_effects", "المؤثرات الصوتية"),
                   ("graphics_notes", "ملحوظات لفريق الجرافيك")):
        out.append(f"<p><span class=k>{lab}:</span> {_e(d[k])}</p>")
    iv = v.get("interaction_visual")
    if iv:
        out.append(f"<div class=inter-title>مشهد التفاعل</div><p><span class=k>إطار السؤال:</span> {_e(iv['question_frame'])}</p>")
        out.append("<div class=k>بطاقات العناصر/الخيارات:</div><ul>" + "".join(f"<li>({_e(o['item_id'])}) {_e(o['visual'])}</li>" for o in iv["option_cards"]) + "</ul>")
        for key, lab in (("instruction_frame", "إطار الجملة التوجيهية"), ("hint_visual", "التلميح 💡"), ("check_button_visual", "زر التحقق"),
                         ("feedback_correct_visual", "✅ مشهد التغذية الإيجابية"), ("feedback_incorrect_visual", "❌ مشهد التغذية السلبية")):
            if iv.get(key):
                out.append(f"<p><span class=k>{lab}:</span> {_e(iv[key])}</p>")
        if iv.get("mechanism_visual"):
            out.append("<ul>" + "".join(f"<li>{_e(m)}</li>" for m in iv["mechanism_visual"]) + "</ul>")
    if v.get("reference_suggestions"):
        out.append("<ul>" + "".join(f"<li>مرجع بصري مقترح: {_e(r)}</li>" for r in v["reference_suggestions"]) + "</ul>")
    if v.get("freeze_at_end"):
        out.append(f"<div class=freeze>⏸ تتجمّد الشاشة عند هذه اللحظة: {_e(v.get('freeze_description'))}</div>")
    return "".join(out)

def export_html(content: dict, path: Optional[str] = None) -> pathlib.Path:
    path = pathlib.Path(path or out_path("case_study_script.html"))
    m, cv = content["meta"], content["covers"]
    cc, es = cv["case_cover"], cv["end_screen"]
    lst = lambda xs: "<ul>" + "".join(f"<li>{_e(x)}</li>" for x in xs) + "</ul>"
    t1 = "".join(f"<tr><td class=lab>{lab}</td><td>{val}</td></tr>" for lab, val in (
        ("نوع العنصر", _e(m["type_label"])),
        ("اسم العنصر (المحور الرئيس)", _e(m["title"])), ("المحاور الفرعية", lst(m["axes"])), ("الأهداف التعليمية", lst(m["objectives"]))))
    icons = "".join(f"<li>الأيقونة {i} (من المشهد {ic['scene_number']}): {_e(ic['description'])}</li>" for i, ic in enumerate(cc["icons"], 1))
    rows = [f"""<tr><td class=num>الغلاف</td><td class=vo><p><span class=k>غلاف دراسة الحالة:</span></p><p class='strong center'>{_e(cc['title'])}</p>
<p>والـ Header: <b>{_e(cc['header'])}</b></p><p>مع زر: {' '.join(f'<span class=btn>{_e(b)}</span>' for b in cc['buttons'])}</p></td>
<td><p><span class=k>غلاف دراسة الحالة — التصميم:</span> {_e(cc['character_design'])}</p><ul>{icons}</ul>
<p class=note>جميع الأيقونات مستخرجة من مشاهد حقيقية داخل دراسة الحالة نفسها لضمان التكامل البصري.</p></td></tr>"""]
    for sc in content["scenes"]:
        vo = _interaction_html(sc) if sc["interaction"] else _vo_html(sc)
        rows.append(f"<tr><td class=num>{sc['scene_number']}<span class=kind>{_e(sc['kind_ar'])}</span></td>"
                    f"<td class=vo>{vo}</td><td>{_desc_html(sc)}</td></tr>")
    thanks = "".join(f"<p class='strong center'>{_e(t)}</p>" for t in es["thanks_lines"])
    end_btns = ("<p>مع زر: " + " ".join(f"<span class=btn>{_e(b)}</span>" for b in es["buttons"]) + "</p>") if es.get("buttons") else ""
    rows.append(f"<tr><td class=num>الختام</td><td class=vo>{thanks}{end_btns}</td>"
                f"<td><p><span class=k>شاشة الختام:</span> {_e(es['design'])}</p><p><span class=k>عند الضغط:</span> {_e(es.get('return_to'))}</p></td></tr>")
    qa_items = content.get("qa", {}).get("qa_log", [])
    qa_html = "".join(f"<li><b>{_e(q['step'])}</b> ({_e(q['kind'])}): {_e('؛ '.join(q['messages']))}</li>" for q in qa_items) or "<li>لا ملاحظات</li>"
    doc = f"""<!doctype html><html lang="ar" dir="rtl"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>{_e(m['title'])}</title><style>{_HTML_CSS}</style></head><body><main>
<h1>إسكربت {_e(m['type_label'])}: {_e(m['title'])}</h1><p class=sub>{_e(m['profile_label'])} — {m['actual_words']} كلمة مسموعة (المستهدف {m['target_words']})</p>
<h2>الجدول الأول: المعلومات التوصيفية</h2><table>{t1}</table>
<h2>الجدول الثاني: النص المسموع (VO) ووصف المشاهد</h2>
<table><thead><tr><th class=num style="font-size:14px">رقم المشهد</th><th class=vo>النص المسموع (VO)</th><th>وصف المشاهد لفريق الجرافيك</th></tr></thead>
<tbody>{''.join(rows)}</tbody></table>
<h2>ملحوظات مهمة لفريق الجرافيك والإنتاج</h2>{lst(content['production_notes'])}
<details><summary>تقرير الجودة (ملاحظات مقبولة / ضبط الطول)</summary><ul>{qa_html}</ul></details>
</main></body></html>"""
    log(f"✓ HTML: {path}")
    return doc