Schülerberichte und erweiterte Deckblatt-Bausteine ergänzen
CI / build-and-test (push) Canceled after 0s
CI / build-and-test (push) Canceled after 0s
This commit is contained in:
1 parent
336869e75f
commit
e2f019667a
31 files changed
+961
-14
No files matched your search
@@ -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;
|
||||
|
||||
@@ -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.
|
||||
@@ -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);
|
||||
}
|
||||
}
|
||||
@@ -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
|
||||
|
||||
@@ -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);
|
||||
}
|
||||
|
||||
|
||||
Reference in new issue
Block a user