klausur-service (11 files): - cv_gutter_repair, ocr_pipeline_regression, upload_api - ocr_pipeline_sessions, smart_spell, nru_worksheet_generator - ocr_pipeline_overlays, mail/aggregator, zeugnis_api - cv_syllable_detect, self_rag backend-lehrer (17 files): - classroom_engine/suggestions, generators/quiz_generator - worksheets_api, llm_gateway/comparison, state_engine_api - classroom/models (→ 4 submodules), services/file_processor - alerts_agent/api/wizard+digests+routes, content_generators/pdf - classroom/routes/sessions, llm_gateway/inference - classroom_engine/analytics, auth/keycloak_auth - alerts_agent/processing/rule_engine, ai_processor/print_versions agent-core (5 files): - brain/memory_store, brain/knowledge_graph, brain/context_manager - orchestrator/supervisor, sessions/session_manager admin-lehrer (5 components): - GridOverlay, StepGridReview, DevOpsPipelineSidebar - DataFlowDiagram, sbom/wizard/page website (2 files): - DependencyMap, lehrer/abitur-archiv Other: nibis_ingestion, grid_detection_service, export-doclayout-onnx Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
271 lines
9.8 KiB
Python
271 lines
9.8 KiB
Python
"""
|
|
AI Processor - Print Version Generators
|
|
|
|
Generate printable HTML versions for Q&A, Cloze, and Multiple Choice.
|
|
"""
|
|
|
|
from pathlib import Path
|
|
import json
|
|
import logging
|
|
import random
|
|
|
|
from ..config import BEREINIGT_DIR
|
|
from .print_templates import get_qa_html_header, get_cloze_html_header, get_mc_html_header
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
def generate_print_version_qa(qa_path: Path, include_answers: bool = False) -> Path:
|
|
"""
|
|
Generate a printable HTML version of the Q&A pairs.
|
|
|
|
Args:
|
|
qa_path: Path to *_qa.json file
|
|
include_answers: True for solution sheet (for parents)
|
|
|
|
Returns:
|
|
Path to generated HTML file
|
|
"""
|
|
if not qa_path.exists():
|
|
raise FileNotFoundError(f"Q&A-Datei nicht gefunden: {qa_path}")
|
|
|
|
qa_data = json.loads(qa_path.read_text(encoding="utf-8"))
|
|
items = qa_data.get("qa_items", [])
|
|
metadata = qa_data.get("metadata", {})
|
|
|
|
title = metadata.get("source_title", "Arbeitsblatt")
|
|
subject = metadata.get("subject", "")
|
|
grade = metadata.get("grade_level", "")
|
|
|
|
html_parts = []
|
|
html_parts.append(get_qa_html_header(title))
|
|
|
|
# Header
|
|
version_text = "Loesungsblatt" if include_answers else "Fragenblatt"
|
|
html_parts.append(f"<h1>{title} - {version_text}</h1>")
|
|
meta_parts = []
|
|
if subject:
|
|
meta_parts.append(f"Fach: {subject}")
|
|
if grade:
|
|
meta_parts.append(f"Klasse: {grade}")
|
|
meta_parts.append(f"Anzahl Fragen: {len(items)}")
|
|
html_parts.append(f"<div class='meta'>{' | '.join(meta_parts)}</div>")
|
|
|
|
# Questions
|
|
for idx, item in enumerate(items, 1):
|
|
html_parts.append("<div class='question-block'>")
|
|
html_parts.append(f"<div class='question-number'>Frage {idx}</div>")
|
|
html_parts.append(f"<div class='question-text'>{item.get('question', '')}</div>")
|
|
|
|
if include_answers:
|
|
html_parts.append(f"<div class='answer'><strong>Antwort:</strong> {item.get('answer', '')}</div>")
|
|
key_terms = item.get("key_terms", [])
|
|
if key_terms:
|
|
terms_html = " ".join([f"<span>{term}</span>" for term in key_terms])
|
|
html_parts.append(f"<div class='key-terms'>Wichtige Begriffe: {terms_html}</div>")
|
|
else:
|
|
html_parts.append("<div class='answer-lines'>")
|
|
for _ in range(3):
|
|
html_parts.append("<div class='answer-line'></div>")
|
|
html_parts.append("</div>")
|
|
|
|
html_parts.append("</div>")
|
|
|
|
html_parts.append("</body></html>")
|
|
|
|
# Save
|
|
suffix = "_qa_solutions.html" if include_answers else "_qa_print.html"
|
|
out_name = qa_path.stem.replace("_qa", "") + suffix
|
|
out_path = BEREINIGT_DIR / out_name
|
|
out_path.write_text("\n".join(html_parts), encoding="utf-8")
|
|
|
|
logger.info(f"Print-Version gespeichert: {out_path.name}")
|
|
return out_path
|
|
|
|
|
|
def generate_print_version_cloze(cloze_path: Path, include_answers: bool = False) -> Path:
|
|
"""
|
|
Generate a printable HTML version of the cloze texts.
|
|
|
|
Args:
|
|
cloze_path: Path to *_cloze.json file
|
|
include_answers: True for solution sheet (for parents)
|
|
|
|
Returns:
|
|
Path to generated HTML file
|
|
"""
|
|
if not cloze_path.exists():
|
|
raise FileNotFoundError(f"Cloze-Datei nicht gefunden: {cloze_path}")
|
|
|
|
cloze_data = json.loads(cloze_path.read_text(encoding="utf-8"))
|
|
items = cloze_data.get("cloze_items", [])
|
|
metadata = cloze_data.get("metadata", {})
|
|
|
|
title = metadata.get("source_title", "Arbeitsblatt")
|
|
subject = metadata.get("subject", "")
|
|
grade = metadata.get("grade_level", "")
|
|
total_gaps = metadata.get("total_gaps", 0)
|
|
|
|
html_parts = []
|
|
html_parts.append(get_cloze_html_header(title))
|
|
|
|
# Header
|
|
version_text = "Loesungsblatt" if include_answers else "Lueckentext"
|
|
html_parts.append(f"<h1>{title} - {version_text}</h1>")
|
|
meta_parts = []
|
|
if subject:
|
|
meta_parts.append(f"Fach: {subject}")
|
|
if grade:
|
|
meta_parts.append(f"Klasse: {grade}")
|
|
meta_parts.append(f"Luecken gesamt: {total_gaps}")
|
|
html_parts.append(f"<div class='meta'>{' | '.join(meta_parts)}</div>")
|
|
|
|
# Collect all gap words for word bank
|
|
all_words = []
|
|
|
|
# Cloze texts
|
|
for idx, item in enumerate(items, 1):
|
|
html_parts.append("<div class='cloze-item'>")
|
|
html_parts.append(f"<div class='cloze-number'>{idx}.</div>")
|
|
|
|
gaps = item.get("gaps", [])
|
|
sentence = item.get("sentence_with_gaps", "")
|
|
|
|
if include_answers:
|
|
# Solution sheet: fill gaps with answers
|
|
for gap in gaps:
|
|
word = gap.get("word", "")
|
|
sentence = sentence.replace("___", f"<span class='gap-filled'>{word}</span>", 1)
|
|
else:
|
|
# Question sheet: gaps as lines
|
|
sentence = sentence.replace("___", "<span class='gap'> </span>")
|
|
for gap in gaps:
|
|
all_words.append(gap.get("word", ""))
|
|
|
|
html_parts.append(f"<div class='cloze-sentence'>{sentence}</div>")
|
|
|
|
# Show translation
|
|
translation = item.get("translation", {})
|
|
if translation:
|
|
lang_name = translation.get("language_name", "Uebersetzung")
|
|
full_sentence = translation.get("full_sentence", "")
|
|
if full_sentence:
|
|
html_parts.append("<div class='translation'>")
|
|
html_parts.append(f"<div class='translation-label'>{lang_name}:</div>")
|
|
html_parts.append(full_sentence)
|
|
html_parts.append("</div>")
|
|
|
|
html_parts.append("</div>")
|
|
|
|
# Word bank (only for question sheet)
|
|
if not include_answers and all_words:
|
|
random.shuffle(all_words)
|
|
html_parts.append("<div class='word-bank'>")
|
|
html_parts.append("<div class='word-bank-title'>Wortbank (diese Woerter fehlen):</div>")
|
|
for word in all_words:
|
|
html_parts.append(f"<span class='word'>{word}</span>")
|
|
html_parts.append("</div>")
|
|
|
|
html_parts.append("</body></html>")
|
|
|
|
# Save
|
|
suffix = "_cloze_solutions.html" if include_answers else "_cloze_print.html"
|
|
out_name = cloze_path.stem.replace("_cloze", "") + suffix
|
|
out_path = BEREINIGT_DIR / out_name
|
|
out_path.write_text("\n".join(html_parts), encoding="utf-8")
|
|
|
|
logger.info(f"Cloze Print-Version gespeichert: {out_path.name}")
|
|
return out_path
|
|
|
|
|
|
def generate_print_version_mc(mc_path: Path, include_answers: bool = False) -> str:
|
|
"""
|
|
Generate a printable HTML version of the multiple choice questions.
|
|
|
|
Args:
|
|
mc_path: Path to *_mc.json file
|
|
include_answers: True for solution sheet with marked correct answers
|
|
|
|
Returns:
|
|
HTML string (for direct delivery)
|
|
"""
|
|
if not mc_path.exists():
|
|
raise FileNotFoundError(f"MC-Datei nicht gefunden: {mc_path}")
|
|
|
|
mc_data = json.loads(mc_path.read_text(encoding="utf-8"))
|
|
questions = mc_data.get("questions", [])
|
|
metadata = mc_data.get("metadata", {})
|
|
|
|
title = metadata.get("source_title", "Arbeitsblatt")
|
|
subject = metadata.get("subject", "")
|
|
grade = metadata.get("grade_level", "")
|
|
|
|
html_parts = []
|
|
html_parts.append(get_mc_html_header(title))
|
|
|
|
# Header
|
|
version_text = "Loesungsblatt" if include_answers else "Multiple Choice Test"
|
|
html_parts.append(f"<h1>{title}</h1>")
|
|
html_parts.append(f"<div class='meta'><strong>{version_text}</strong>")
|
|
if subject:
|
|
html_parts.append(f" | Fach: {subject}")
|
|
if grade:
|
|
html_parts.append(f" | Klasse: {grade}")
|
|
html_parts.append(f" | Anzahl Fragen: {len(questions)}</div>")
|
|
|
|
if not include_answers:
|
|
html_parts.append("<div class='instructions'>")
|
|
html_parts.append("<strong>Anleitung:</strong> Kreuze bei jeder Frage die richtige Antwort an. ")
|
|
html_parts.append("Es ist immer nur eine Antwort richtig.")
|
|
html_parts.append("</div>")
|
|
|
|
# Questions
|
|
for idx, q in enumerate(questions, 1):
|
|
html_parts.append("<div class='question-block'>")
|
|
html_parts.append(f"<div class='question-number'>Frage {idx}</div>")
|
|
html_parts.append(f"<div class='question-text'>{q.get('question', '')}</div>")
|
|
|
|
html_parts.append("<div class='options'>")
|
|
correct_answer = q.get("correct_answer", "")
|
|
|
|
for opt in q.get("options", []):
|
|
opt_id = opt.get("id", "")
|
|
is_correct = opt_id == correct_answer
|
|
|
|
opt_class = "option"
|
|
checkbox_class = "option-checkbox"
|
|
if include_answers and is_correct:
|
|
opt_class += " option-correct"
|
|
checkbox_class += " checked"
|
|
|
|
html_parts.append(f"<div class='{opt_class}'>")
|
|
html_parts.append(f"<div class='{checkbox_class}'></div>")
|
|
html_parts.append(f"<span class='option-label'>{opt_id})</span>")
|
|
html_parts.append(f"<span class='option-text'>{opt.get('text', '')}</span>")
|
|
html_parts.append("</div>")
|
|
|
|
html_parts.append("</div>")
|
|
|
|
# Explanation only for solution sheet
|
|
if include_answers and q.get("explanation"):
|
|
html_parts.append(f"<div class='explanation'><strong>Erklaerung:</strong> {q.get('explanation')}</div>")
|
|
|
|
html_parts.append("</div>")
|
|
|
|
# Answer key (compact) - only for solution sheet
|
|
if include_answers:
|
|
html_parts.append("<div class='answer-key'>")
|
|
html_parts.append("<div class='answer-key-title'>Loesungsschluessel</div>")
|
|
html_parts.append("<div class='answer-key-grid'>")
|
|
for idx, q in enumerate(questions, 1):
|
|
html_parts.append("<div class='answer-key-item'>")
|
|
html_parts.append(f"<span class='answer-key-q'>{idx}.</span> ")
|
|
html_parts.append(f"<span class='answer-key-a'>{q.get('correct_answer', '')}</span>")
|
|
html_parts.append("</div>")
|
|
html_parts.append("</div>")
|
|
html_parts.append("</div>")
|
|
|
|
html_parts.append("</body></html>")
|
|
|
|
return "\n".join(html_parts)
|