Schülerberichte und erweiterte Deckblatt-Bausteine ergänzen
CI / build-and-test (push) Canceled after 0s

This commit is contained in:
admin committed 2026-10-22 11:24:43 +02:00
1 parent 336869e75f
commit e2f019667a
31 files changed
+961 -14

No files matched your search

+2
View File
@@ -117,6 +117,8 @@ public static class ExamCoverPlaceholders
new("Result.Points", PlaceholderType.Text, "52,5", "Erreichte Punkte, als Blanko eine Linie"),
new("Result.Percent", PlaceholderType.Text, "85 %", "Erreichter Anteil, als Blanko leer"),
new("Result.Grade", PlaceholderType.Text, "2", "Note, als Blanko eine Linie"),
new(ReportTextDrawing.RepeatInfo, PlaceholderType.Drawing, "", "Informationen zur ersten Arbeit und Bewertungsregel der Wiederholung"),
new(ReportTextDrawing.InterimGrades, PlaceholderType.Drawing, "", "Gespeicherter Zwischenstand: mündlich, schriftlich, vorläufige Zeugnisnote"),
new(ExamPointsTableDrawing.PlaceholderName, PlaceholderType.Drawing, "",
"Punktetabelle (Aufgabe / Max. Punktzahl / Punktzahl)"),
];
@@ -226,6 +226,18 @@ public sealed class QuestTemplateRenderer : ITemplateRenderer, ITemplatePreviewR
canvas.Layers(layers =>
{
layers.PrimaryLayer().Background(Colors.White);
// Ohne eigene Folgeseitenvorlage ist derselbe Hintergrund auf jeder Seite
// vorgesehen. Zwei zustandsbehaftete ShowOnce/SkipOnce-Layer für dieselben
// Elemente können sich beim Paginieren gegenseitig verdrängen.
if (ReferenceEquals(first, continuation))
{
foreach (var element in first.Elements)
{
var current = element;
layers.Layer().Repeat().Element(root => RenderElement(root, current, template, values));
}
return;
}
foreach (var element in first.Elements)
{
var current = element;
+36
View File
@@ -316,3 +316,39 @@ Höhe ins Elementformular. Im Bearbeitungsmodus lassen sich vorhandene Elemente
außer einzeiligem `TEXT` - am rechten unteren Anfasser skalieren. Rasterfang und Pfeiltasten sind
für Feinkorrekturen verfügbar. Änderungen werden in die ursprüngliche DSL-Zeile zurückgeschrieben,
wobei Inhalte, Platzhalter, Formatangaben und Attribute erhalten bleiben.
### Weitere Deckblatt- und Schülerbericht-Bausteine
Die Sonderinhalte im TemplateDesigner umfassen zusätzlich:
| Platzhalter (Drawing) | Inhalt |
| --- | --- |
| `Exam.RepeatInfo` | Erste Arbeit, bisherige Note und Regel der Wiederholung; bei normalen Arbeiten leer |
| `Student.InterimGrades` | Gespeicherter Zwischenstand mit Stichtag/Anlass, mündlich, schriftlich und vorläufiger Zeugnisnote |
| `Student.ParticipationChart` | Gewichtete Mitarbeit und Einzelaspekte auf der gemeinsamen -2 bis +2-Achse |
| `Student.Competencies` | Kompetenzbewertungen aus Klausuren und Mitarbeit |
| `Student.Homework` | Hausaufgabenkontrollen mit Datum und aktuellem Nachreichstatus |
| `Student.Documentation` | Dokumentation und Unterrichtsnotizen der gewählten Lerngruppe |
`Exam.RepeatInfo` und `Student.InterimGrades` sind in Klausur-Deckblättern verfügbar.
Ein Zwischenstand wird im Druckdialog über Datum und Anlass gewählt; fehlt ein ausgewählter
Schüler in diesem Durchgang, wird der Druck mit einem Hinweis verhindert.
Für Schülerberichte im Schülerdetail gibt es eine eingebaute Standardvorlage und importierbare
Pakete mit `report-type=student-report` (in einer der beiden vorhandenen Vorlagenbibliotheken).
Im Designer setzt „Als Schülerbericht einrichten“ den Typ und ergänzt die benötigten Platzhalter;
die Sonderinhalte werden danach nach Bedarf in den Content-Flow eingefügt. Es werden außerdem
`Student.Name`, `Group.Name`, `Report.Period` (Text) und `Report.Comment` (Multiline) befüllt.
Es gibt keine erforderliche Kontaktadresse: der Bericht ist für den Austausch mit Kollegen gedacht.
Für lange Inhalte `FLOWDRAWBOX … fit=content` verwenden. Ihre Höhe muss einschließlich `gap`
in den Flow-Slot passen; die Standardvorlage nutzt 230 mm Inhaltshöhe in einem 240-mm-Slot.
Feste `DRAWBOX`-Textblöcke melden Platzmangel. Der Mitarbeitsgraph braucht mindestens 50 mm
Breite und ausreichend Höhe für seine Legende. Die Textbausteine beachten die Maßeinheit der Vorlage.
Der Bericht filtert auf Schüler, Gruppe und Zeitraum. Gelöschte Dokumentation und Entwürfe werden
nicht übernommen; vertrauliche Dokumentation ist im Dialog zuschaltbar. Hausaufgabenstatus und
Dokumentation entsprechen dem aktuellen gespeicherten Zustand. Notenzwischenstände werden aus
gespeicherten Durchgängen übernommen und nicht beim Druck neu berechnet. KI-Texterzeugung ist
noch nicht angebunden; ergänzende Texte lassen sich im Berichtsdialog eingeben.
+61
View File
@@ -0,0 +1,61 @@
namespace LehrerApp.Templating;
/// <summary>Lesbare, umbrechende Textblöcke für Berichtsbausteine. Jede Zeile ist ein eigener
/// Zeichenbefehl, damit FLOWDRAWBOX auch lange Berichte an Zeilengrenzen aufteilen kann.</summary>
public static class ReportTextDrawing
{
public const string RepeatInfo = "Exam.RepeatInfo";
public const string InterimGrades = "Student.InterimGrades";
public static DrawingValue Build(string title, IEnumerable<string> paragraphs,
float width = 170, float scale = 1, float pageHeight = 240, bool fixedBox = false)
{
if (!float.IsFinite(width) || !float.IsFinite(scale) || !float.IsFinite(pageHeight)
|| scale <= 0 || width < 20 * scale || pageHeight < 12 * scale)
throw new InvalidDataException("Der Berichtsbaustein benötigt mindestens 20 × 12 mm Platz.");
var commands = new List<DrawingCommand>();
var lineHeight = 5f * scale;
var y = 0f;
// Konservative Zeichenbreiten in Gevierten der Standardschrift. Breite Buchstaben
// bekommen mehr Raum; auch einzelne überlange Wörter werden umgebrochen.
var available = (width - 2 * scale) / (10 * 25.4f / 72 * scale);
static float Advance(char c) => char.IsWhiteSpace(c) ? .4f
: c is 'm' or 'w' or 'M' or 'W' ? 1.1f
: c > 255 ? 1.1f : char.IsUpper(c) ? 1f : .7f;
void Line(string text, bool bold)
{
var offset = y % pageHeight;
if (offset + lineHeight > pageHeight + .001f) y += pageHeight - offset;
if (fixedBox && y + lineHeight > pageHeight + .001f)
throw new InvalidDataException("Der Berichtsbaustein passt nicht in die feste DRAWBOX. Bitte FLOWDRAWBOX verwenden oder die Box vergrößern.");
commands.Add(new DrawStringEx(scale, y, lineHeight, width - 2 * scale, text,
DrawingTextAlignment.AlignLeft, 10, Bold: bold));
y += lineHeight;
}
foreach (var paragraph in new[] { title }.Concat(paragraphs))
{
foreach (var original in paragraph.Replace("\r\n", "\n").Split('\n'))
{
var remaining = original.Trim();
if (remaining.Length == 0) { Line("", false); continue; }
while (remaining.Length > 0)
{
var length = 0;
var used = 0f;
while (length < remaining.Length && used + Advance(remaining[length]) <= available)
used += Advance(remaining[length++]);
length = Math.Max(1, length);
var cut = length;
if (length < remaining.Length)
{
var space = remaining.LastIndexOf(' ', length - 1, length);
if (space > 0) cut = space;
}
Line(remaining[..cut], paragraph == title);
remaining = remaining[cut..].TrimStart();
}
}
}
return new DrawingValue(commands, y);
}
}
+114
View File
@@ -0,0 +1,114 @@
namespace LehrerApp.Templating;
public static class StudentReportTemplate
{
public const string Participation = "Student.ParticipationChart";
public const string Competencies = "Student.Competencies";
public const string Homework = "Student.Homework";
public const string Documentation = "Student.Documentation";
public static IReadOnlyList<string> Drawings { get; } =
[ReportTextDrawing.InterimGrades, Participation, Competencies, Homework, Documentation];
public const string Layout = """
PAGE 210 297 mm
#pragma format-version 3
#pragma page-template first
TEXT 20 12 "Schülerbericht: $Student.Name" size=15
TEXT 20 22 "Lerngruppe: $Group.Name · $Report.Period" size=10
#pragma flow-slot body x=20 y=34 w=170 h=240
#pragma end-page-template
#pragma content-flow body
FLOWDRAWBOX $Student.InterimGrades w=170 h=230 fit=content gap=5
FLOWDRAWBOX $Student.ParticipationChart w=170 h=230 fit=content gap=5
FLOWDRAWBOX $Student.Competencies w=170 h=230 fit=content gap=5
FLOWDRAWBOX $Student.Homework w=170 h=230 fit=content gap=5
FLOWDRAWBOX $Student.Documentation w=170 h=230 fit=content gap=5
FLOWBOX $Report.Comment w=170 size=10
#pragma end-content-flow
""";
public static DrawingValue SampleDrawing(string name, DeclaredDrawingBox? declared = null)
{
var box = declared ?? new DeclaredDrawingBox(170, 240, 1, false);
var from = new DateOnly(2026, 1, 1);
if (name == Participation)
return ParticipationReportDrawing.Build([new("Gewichtete Mitarbeit", "#6C5CE7",
[new(from, -.5), new(from.AddDays(7), .5), new(from.AddDays(14), 1.2)])], from, from.AddDays(20), box.Width, box.MillimeterScale);
var (title, text) = name switch
{
ReportTextDrawing.RepeatInfo => ("Wiederholungsarbeit", new[] { "Erste Arbeit: Atombau vom 18.12.2025", "Note der ersten Arbeit: 4", "Für die Bewertung zählt die bessere Note aus beiden Arbeiten." }),
ReportTextDrawing.InterimGrades => ("Vorläufiger Notenzwischenstand", new[] { "Stichtag: 15.01.2026 · Sprechtag", "Mündlich: 2", "Schriftlich: 3", "Vorläufige Zeugnisnote: 2-3" }),
Competencies => ("Kompetenzen", new[] { "CH1 Aufbau der Atome beschreiben: 75 % (4 Bewertungen)" }),
Homework => ("Hausaufgaben", new[] { "12.01.2026: Hausaufgabe gemacht", "14.01.2026: Hausaufgabe nachgereicht" }),
_ => ("Klassenbucheinträge und Unterrichtsnotizen", new[] { "15.01.2026 · Gespräch: Lernentwicklung", "Erika arbeitet inzwischen regelmäßig mit." }),
};
return ReportTextDrawing.Build(title, text, box.Width, box.MillimeterScale, box.Height, box.IsFixed);
}
public static LoadedTemplate Create() => new(new TemplateManifest
{
Id = "student-report-standard", Name = "Schülerbericht Standard",
Metadata = new() { [TemplateMetadataKeys.ReportType] = TemplateReportTypes.StudentReport },
Placeholders = new[]
{
new PlaceholderDefinition("Student.Name", PlaceholderType.Text),
new PlaceholderDefinition("Group.Name", PlaceholderType.Text),
new PlaceholderDefinition("Report.Period", PlaceholderType.Text),
new PlaceholderDefinition("Report.Comment", PlaceholderType.Multiline),
}.Concat(Drawings.Select(n => new PlaceholderDefinition(n, PlaceholderType.Drawing))).ToList(),
}, new LayoutParser().Parse(Layout), new Dictionary<string, byte[]>());
}
public sealed record ReportChartPoint(DateOnly Date, double Value);
public sealed record ReportChartSeries(string Label, string Color, IReadOnlyList<ReportChartPoint> Points);
public static class ParticipationReportDrawing
{
public static DrawingValue Build(IReadOnlyList<ReportChartSeries> series, DateOnly from, DateOnly to,
float width = 170, float scale = 1)
{
if (from > to || width < 50 * scale || scale <= 0 || !float.IsFinite(width) || !float.IsFinite(scale))
throw new InvalidDataException("Der Mitarbeitsgraph benötigt mindestens 50 mm Breite und einen gültigen Zeitraum.");
if (series.All(s => s.Points.Count == 0))
return ReportTextDrawing.Build("Mitarbeitsentwicklung", ["Keine bewerteten Sitzungen im gewählten Zeitraum."], width, scale);
var commands = new List<DrawingCommand>();
void Text(float x, float y, string text, string color = "#334155", bool bold = false) =>
commands.Add(new DrawString(x * scale, y * scale, text, 9, color, Bold: bold));
var right = width / scale - 4;
const float left = 12, top = 14, height = 40;
Text(1, 0, "Mitarbeitsentwicklung (-2 bis +2)", bold: true);
for (var value = -2; value <= 2; value++)
{
var y = top + (2 - value) / 4f * height;
Text(1, y - 2, value.ToString(System.Globalization.CultureInfo.InvariantCulture));
commands.Add(new DrawLine(left * scale, y * scale, right * scale, y * scale, "#CBD5E1", .2f * scale));
}
var days = Math.Max(1, to.DayNumber - from.DayNumber);
foreach (var item in series)
{
(float X, float Y)? previous = null;
foreach (var point in item.Points.Where(p => p.Date >= from && p.Date <= to).OrderBy(p => p.Date))
{
var x = (left + (point.Date.DayNumber - from.DayNumber) / (float)days * (right - left)) * scale;
var y = (top + (2 - (float)Math.Clamp(point.Value, -2, 2)) / 4 * height) * scale;
if (previous is { } prev) commands.Add(new DrawLine(prev.X, prev.Y, x, y, item.Color, .5f * scale));
commands.Add(new DrawCircle(x, y, .8f * scale, item.Color, .2f * scale, item.Color));
previous = (x, y);
}
}
Text(left, 57, from.ToString("dd.MM.yyyy"));
Text(Math.Max(left, right - 26), 57, to.ToString("dd.MM.yyyy"));
var legendY = 64f;
foreach (var item in series)
{
// Jede Kurve bekommt eine eigene beschriftete Legendenzeile.
commands.Add(new DrawLine(left * scale, (legendY + 2) * scale, (left + 6) * scale, (legendY + 2) * scale, item.Color, .6f * scale));
var legend = ReportTextDrawing.Build("", [item.Label], (right - left - 10) * scale, scale);
// Legendentexte konservativ umbrechen, auch bei individuell langen Aspektnamen.
foreach (var line in legend.Commands.OfType<DrawStringEx>().Skip(1))
commands.Add(line with { X = (left + 9) * scale, Y = line.Y - 5 * scale + legendY * scale, Color = item.Color });
legendY += legend.ContentHeight / scale - 5;
}
return new DrawingValue(commands, (legendY + 2) * scale);
}
}
@@ -12,6 +12,7 @@ public static class TemplateReportTypes
{
public const string Letter = "letter";
public const string ExamCover = "exam-cover";
public const string StudentReport = "student-report";
}
public static class TemplateMetadataText
+1
View File
@@ -65,6 +65,7 @@ public static class TemplatePackage
public sealed record InstalledTemplate(string Id, string Name, string Description, string PackagePath,
DateTime ImportedAtUtc, string ReportType = "")
{
public bool IsStudentReport => ReportType.Equals(TemplateReportTypes.StudentReport, StringComparison.OrdinalIgnoreCase);
public bool IsExamCover => ReportType.Equals(TemplateReportTypes.ExamCover, StringComparison.OrdinalIgnoreCase);
}