From feab6135ff87d0a878042a5ae5dd0dc87f5a26ab Mon Sep 17 00:00:00 2001 From: Thomas Date: Sat, 21 Nov 2026 22:37:38 +0100 Subject: [PATCH] Versendung: doppelseitiges Sammel PDF und diverse Verbesserungen --- Package.swift | 3 + README.md | 15 ++ .../PDF/DispatchCoverPDFRenderer.swift | 6 +- Sources/LektorenPlan/PDF/PDFMerger.swift | 28 +++ Sources/LektorenPlan/PlanModel.swift | 46 +++-- Sources/LektorenPlan/Resources/statistics.md | 1 + Sources/LektorenPlan/Views/DispatchView.swift | 8 + Sources/LektorenPlan/Views/HelpSheet.swift | 166 ++++++++++++++++ .../LektorenPlan/Views/StatisticsView.swift | 23 ++- Sources/LektorenPlanCore/Models.swift | 16 ++ Tests/LektorenPlanCoreTests/CoreTests.swift | 7 + doc/statistics.md | 121 ++++++++++++ web/domain/models.go | 23 +++ web/pdf/cover.go | 52 +++-- web/pdf/merge.go | 160 ++++++++++++--- web/pdf/pdf_test.go | 187 +++++++++++++++++- web/web/dispatch_calendar_test.go | 38 ++++ web/web/dispatch_handlers.go | 68 +++++-- web/web/dispatch_test.go | 69 +++++++ web/web/help.go | 116 +++++++++++ web/web/help_test.go | 50 +++++ web/web/render.go | 1 + web/web/server.go | 3 +- web/web/static/style.css | 16 ++ web/web/statistics-help.md | 121 ++++++++++++ web/web/statistics_handlers.go | 5 +- web/web/templates/dispatch.html | 6 +- web/web/templates/guest.html | 6 +- web/web/templates/help.html | 18 ++ web/web/templates/plan.html | 6 +- web/web/templates/statistics.html | 13 +- 31 files changed, 1302 insertions(+), 96 deletions(-) create mode 120000 Sources/LektorenPlan/Resources/statistics.md create mode 100644 Sources/LektorenPlan/Views/HelpSheet.swift create mode 100644 doc/statistics.md create mode 100644 web/web/help.go create mode 100644 web/web/help_test.go create mode 100644 web/web/statistics-help.md create mode 100644 web/web/templates/help.html diff --git a/Package.swift b/Package.swift index 3f635d3..ed4203c 100644 --- a/Package.swift +++ b/Package.swift @@ -29,6 +29,9 @@ let package = Package( name: "LektorenPlan", dependencies: ["LektorenPlanCore"], path: "Sources/LektorenPlan", + resources: [ + .process("Resources") + ], swiftSettings: [ .swiftLanguageMode(.v5) ] diff --git a/README.md b/README.md index 131f35b..1b5d23b 100644 --- a/README.md +++ b/README.md @@ -83,6 +83,20 @@ oder über die Kalender-Schaltfläche online aktualisiert werden. > Daten von www.eucharistiefeier.de – fair use, ausschließlich zur Anzeige. > Die Daten bleiben Eigentum der Quelle. +## Hilfe + +Die Statistik-Hilfe liegt als Markdown unter +[`doc/statistics.md`](doc/statistics.md). Sie erklärt alle Kennzahlen, +Berechnungen und Interpretationshinweise der Statistikseite. + +- In der Webversion ist sie über die Schaltfläche **Hilfe** auf der + Statistikseite erreichbar. Der Inhalt wird beim Bauen aus + `web/web/statistics-help.md` eingebettet; diese Kopie wird mit + `cd web && go generate ./web` aus dem Dokument erzeugt. +- In der macOS-App öffnet dieselbe Schaltfläche die Hilfe als Blatt. Die + Markdown-Datei wird über einen symbolischen Link in den App-Ressourcen + mitgeliefert. + ## Projektstruktur ``` @@ -91,6 +105,7 @@ Sources/ ├── LektorenPlan/ SwiftUI-App, Views, Sheets, PDF-Renderer Tests/LektorenPlanCoreTests/ Resources/AppIcon.icns App-Icon +doc/statistics.md Hilfe zur Statistikseite Scripts/build-app.sh erzeugt build/LektorenPlan.app Scripts/make-icon.swift erzeugt Resources/AppIcon.icns CONCEPT.md Grobkonzept diff --git a/Sources/LektorenPlan/PDF/DispatchCoverPDFRenderer.swift b/Sources/LektorenPlan/PDF/DispatchCoverPDFRenderer.swift index b3421de..f149b62 100644 --- a/Sources/LektorenPlan/PDF/DispatchCoverPDFRenderer.swift +++ b/Sources/LektorenPlan/PDF/DispatchCoverPDFRenderer.swift @@ -10,7 +10,9 @@ struct DispatchAssignment: Identifiable, Hashable { var church: String var place: String var title: String - var role: Role + var roles: [Role] + + var roleLabel: String { Role.combinedTitle(roles) } var dateLabel: String { "\(DayMath.shortWeekdayName(date)), \(DayMath.dayNumber(date)).\(DayMath.month(date)).\(DayMath.year(date))" @@ -246,7 +248,7 @@ enum DispatchCoverPDFRenderer { assignment.dateLabel, assignment.timeLabel, assignment.church, - "\(assignment.role.title) · \(assignment.title)" + "\(assignment.roleLabel) · \(assignment.title)" ] columnX = margin + 4 for (index, column) in columns.enumerated() { diff --git a/Sources/LektorenPlan/PDF/PDFMerger.swift b/Sources/LektorenPlan/PDF/PDFMerger.swift index d9ee0d1..93bacf7 100644 --- a/Sources/LektorenPlan/PDF/PDFMerger.swift +++ b/Sources/LektorenPlan/PDF/PDFMerger.swift @@ -1,3 +1,4 @@ +import CoreGraphics import Foundation import PDFKit @@ -19,4 +20,31 @@ enum PDFMerger { static func pageCount(_ data: Data) -> Int { PDFDocument(data: data)?.pageCount ?? 0 } + + /// Appends one blank page when the document has an odd page count, so that + /// every cover sheet and every service list starts on the front side of a + /// sheet when printed duplex. Documents with an even page count are + /// returned unchanged. + static func paddedToEvenPages(_ data: Data) -> Data { + guard let document = PDFDocument(data: data), document.pageCount % 2 == 1 else { + return data + } + let size = document.page(at: document.pageCount - 1)? + .bounds(for: .mediaBox).size ?? CGSize(width: 595, height: 842) + guard let blank = blankPage(size: size) else { return data } + return merge([data, blank]) + } + + private static func blankPage(size: CGSize) -> Data? { + guard size.width > 0, size.height > 0 else { return nil } + let data = NSMutableData() + var mediaBox = CGRect(origin: .zero, size: size) + guard let consumer = CGDataConsumer(data: data as CFMutableData), + let context = CGContext(consumer: consumer, mediaBox: &mediaBox, nil) + else { return nil } + context.beginPDFPage(nil) + context.endPDFPage() + context.closePDF() + return data as Data + } } diff --git a/Sources/LektorenPlan/PlanModel.swift b/Sources/LektorenPlan/PlanModel.swift index 62d3c00..624e936 100644 --- a/Sources/LektorenPlan/PlanModel.swift +++ b/Sources/LektorenPlan/PlanModel.swift @@ -227,6 +227,7 @@ final class PlanModel: ObservableObject { @Published var dispatchLog: [DispatchLogEntry] = [] @Published var dispatchIntro: String = PlanModel.defaultDispatchIntro @Published var dispatchGreeting: String = PlanModel.defaultDispatchGreeting + @Published var dispatchDuplex: Bool = true private var toastTask: Task? @@ -1066,23 +1067,35 @@ final class PlanModel: ObservableObject { } func dispatchAssignments(for personID: String) -> [DispatchAssignment] { - var result: [DispatchAssignment] = [] + var grouped: [String: DispatchAssignment] = [:] + var order: [String] = [] for row in rows { for service in row.services { for assignment in service.assignments where assignment.personID == personID { - result.append(DispatchAssignment( - id: assignment.id, - date: row.date, - timeMinutes: service.service.timeMinutes, - church: service.church.shortName, - place: service.service.placeName(church: service.church), - title: service.service.title, - role: assignment.role - )) + // One person can serve as lector and helper in the same + // service. Combine both assignments into one overview row + // and one calendar event. + if var existing = grouped[service.id] { + if !existing.roles.contains(assignment.role) { + existing.roles.append(assignment.role) + grouped[service.id] = existing + } + } else { + grouped[service.id] = DispatchAssignment( + id: service.id, + date: row.date, + timeMinutes: service.service.timeMinutes, + church: service.church.shortName, + place: service.service.placeName(church: service.church), + title: service.service.title, + roles: [assignment.role] + ) + order.append(service.id) + } } } } - return result.sorted { + return order.compactMap { grouped[$0] }.sorted { if $0.date != $1.date { return $0.date < $1.date } return $0.timeMinutes < $1.timeMinutes } @@ -1104,7 +1117,7 @@ final class PlanModel: ObservableObject { durationMinutes: 60, summary: assignment.title, location: assignment.place, - description: "Dienst: \(assignment.role.title)" + description: "Dienst: \(assignment.roleLabel)" ) } } @@ -1172,7 +1185,7 @@ final class PlanModel: ObservableObject { return "Für Sie sind in diesem Zeitraum keine Einsätze eingetragen." } return assignments - .map { "\($0.dateLabel) · \($0.timeLabel) · \($0.church) · \($0.role.title) · \($0.title)" } + .map { "\($0.dateLabel) · \($0.timeLabel) · \($0.church) · \($0.roleLabel) · \($0.title)" } .joined(separator: "\n") } @@ -1311,11 +1324,14 @@ final class PlanModel: ObservableObject { assignments: recipient.assignments, generatedAt: Date() )) - if !cover.isEmpty { documents.append(cover) } + if !cover.isEmpty { + documents.append(dispatchDuplex ? PDFMerger.paddedToEvenPages(cover) : cover) + } } let variant = recipient.preference.variant if planCache[variant] == nil { - planCache[variant] = dispatchPlanData(variant: variant) + let plan = dispatchPlanData(variant: variant) + planCache[variant] = dispatchDuplex ? PDFMerger.paddedToEvenPages(plan) : plan } if let planData = planCache[variant], !planData.isEmpty { documents.append(planData) diff --git a/Sources/LektorenPlan/Resources/statistics.md b/Sources/LektorenPlan/Resources/statistics.md new file mode 120000 index 0000000..4d0987d --- /dev/null +++ b/Sources/LektorenPlan/Resources/statistics.md @@ -0,0 +1 @@ +../../../doc/statistics.md \ No newline at end of file diff --git a/Sources/LektorenPlan/Views/DispatchView.swift b/Sources/LektorenPlan/Views/DispatchView.swift index adf122d..72ba187 100644 --- a/Sources/LektorenPlan/Views/DispatchView.swift +++ b/Sources/LektorenPlan/Views/DispatchView.swift @@ -32,6 +32,14 @@ struct DispatchView: View { subtitle: "Den Plan des aktuellen Zeitraums persönlich per E-Mail oder als Sammel-Ausdruck weitergeben." ) { HStack(spacing: 8) { + Toggle("Doppelseitig drucken", isOn: Binding( + get: { model.dispatchDuplex }, + set: { model.dispatchDuplex = $0 } + )) + .toggleStyle(.checkbox) + .font(.system(size: 10)) + .foregroundStyle(LP.inkSecondary) + .help("Hängt an jedes Vorblatt und jede Liste bei Bedarf eine leere Seite an, damit beide auf der Vorderseite eines Blattes beginnen.") SecondaryActionButton(title: "Einstellungen speichern", icon: "square.and.arrow.down") { model.saveDispatchSettings() } diff --git a/Sources/LektorenPlan/Views/HelpSheet.swift b/Sources/LektorenPlan/Views/HelpSheet.swift new file mode 100644 index 0000000..eb88f0e --- /dev/null +++ b/Sources/LektorenPlan/Views/HelpSheet.swift @@ -0,0 +1,166 @@ +import SwiftUI + +/// Loads help documents that are bundled with the app. The canonical Markdown +/// lives in doc/statistics.md and is linked into the app resources. +enum HelpDocument { + static var statisticsMarkdown: String { + guard let url = Bundle.module.url(forResource: "statistics", withExtension: "md"), + let text = try? String(contentsOf: url, encoding: .utf8) else { + return "# Statistik verstehen\n\nDie Hilfedatei konnte nicht geladen werden." + } + return text + } +} + +/// Sheet that displays one bundled Markdown help document. +struct HelpSheet: View { + let title: String + let markdown: String + + @Environment(\.dismiss) private var dismiss + + var body: some View { + VStack(spacing: 0) { + HStack(alignment: .center, spacing: 12) { + VStack(alignment: .leading, spacing: 2) { + Text("HILFE") + .font(.system(size: 8.5, weight: .bold, design: .rounded)) + .tracking(1.2) + .foregroundStyle(LP.inkTertiary) + Text(title) + .font(LP.serifHeadline) + .foregroundStyle(LP.ink) + } + Spacer() + Button("Schließen") { dismiss() } + .keyboardShortcut(.cancelAction) + } + .padding(.horizontal, 22) + .padding(.vertical, 15) + + Hairline() + + ScrollView { + MarkdownHelpView(markdown: markdown, hidesFirstHeading: true) + .padding(.horizontal, 26) + .padding(.vertical, 22) + } + } + .frame(minWidth: 620, idealWidth: 720, minHeight: 520, idealHeight: 680) + .background(LP.paper) + } +} + +/// Renders the small Markdown subset used by the bundled help documents: +/// headings, paragraphs, unordered lists and inline emphasis. +struct MarkdownHelpView: View { + let markdown: String + var hidesFirstHeading = false + + private var blocks: [MarkdownBlock] { + var parsed = MarkdownBlock.parse(markdown) + if hidesFirstHeading, case .heading(level: 1, _)? = parsed.first { + parsed.removeFirst() + } + return parsed + } + + var body: some View { + VStack(alignment: .leading, spacing: 9) { + ForEach(Array(blocks.enumerated()), id: \.offset) { _, block in + block.view + } + } + .frame(maxWidth: .infinity, alignment: .leading) + .textSelection(.enabled) + } +} + +private enum MarkdownBlock { + case heading(level: Int, text: String) + case paragraph(String) + case bullet(String) + + @ViewBuilder + var view: some View { + switch self { + case .heading(let level, let text): + Text(inline(text)) + .font(headingFont(level)) + .foregroundStyle(LP.ink) + .padding(.top, level == 1 ? 0 : 9) + + case .paragraph(let text): + Text(inline(text)) + .font(.system(size: 11.5)) + .foregroundStyle(LP.inkSecondary) + .lineSpacing(2) + .fixedSize(horizontal: false, vertical: true) + + case .bullet(let text): + HStack(alignment: .top, spacing: 7) { + Text("•") + .font(.system(size: 12, weight: .bold)) + .foregroundStyle(LP.accent) + .padding(.top, 1) + Text(inline(text)) + .font(.system(size: 11.5)) + .foregroundStyle(LP.inkSecondary) + .lineSpacing(2) + .fixedSize(horizontal: false, vertical: true) + } + } + } + + private func headingFont(_ level: Int) -> Font { + switch level { + case 1: LP.serifHeadline + case 2: LP.serifSubhead + default: .system(size: 12, weight: .semibold) + } + } + + private func inline(_ text: String) -> AttributedString { + let options = AttributedString.MarkdownParsingOptions( + interpretedSyntax: .inlineOnlyPreservingWhitespace + ) + return (try? AttributedString(markdown: text, options: options)) ?? AttributedString(text) + } + + static func parse(_ markdown: String) -> [MarkdownBlock] { + var blocks: [MarkdownBlock] = [] + var paragraph: [String] = [] + + func flushParagraph() { + guard !paragraph.isEmpty else { return } + blocks.append(.paragraph(paragraph.joined(separator: " "))) + paragraph.removeAll(keepingCapacity: true) + } + + let lines = markdown + .replacingOccurrences(of: "\r\n", with: "\n") + .components(separatedBy: "\n") + for raw in lines { + let line = raw.trimmingCharacters(in: .whitespaces) + if line.isEmpty { + flushParagraph() + } else if line.hasPrefix("### ") { + flushParagraph() + blocks.append(.heading(level: 3, text: String(line.dropFirst(4)))) + } else if line.hasPrefix("## ") { + flushParagraph() + blocks.append(.heading(level: 2, text: String(line.dropFirst(3)))) + } else if line.hasPrefix("# ") { + flushParagraph() + blocks.append(.heading(level: 1, text: String(line.dropFirst(2)))) + } else if line.hasPrefix("- ") || line.hasPrefix("* ") { + flushParagraph() + blocks.append(.bullet(String(line.dropFirst(2)))) + } else { + paragraph.append(line) + } + } + flushParagraph() + return blocks + } +} diff --git a/Sources/LektorenPlan/Views/StatisticsView.swift b/Sources/LektorenPlan/Views/StatisticsView.swift index 088ed8f..c145a86 100644 --- a/Sources/LektorenPlan/Views/StatisticsView.swift +++ b/Sources/LektorenPlan/Views/StatisticsView.swift @@ -4,6 +4,7 @@ import LektorenPlanCore struct StatisticsView: View { @EnvironmentObject private var model: PlanModel + @State private var showHelp = false private var stats: RangeStatistics { model.stats } @@ -43,6 +44,9 @@ struct StatisticsView: View { subtitle: "Einsatzhäufigkeit, Orte, Vorlieben und Fairness für den gewählten Zeitraum." ) { HStack(spacing: 8) { + SecondaryActionButton(title: "Hilfe", icon: "questionmark.circle") { + showHelp = true + } SecondaryActionButton(title: "PDF", icon: "doc.richtext") { model.createPDFPreview() } @@ -76,6 +80,9 @@ struct StatisticsView: View { .padding(.horizontal, 22) .padding(.top, 30) .padding(.bottom, 18) + .sheet(isPresented: $showHelp) { + HelpSheet(title: "Statistik verstehen", markdown: HelpDocument.statisticsMarkdown) + } } // MARK: - KPI @@ -89,7 +96,7 @@ struct StatisticsView: View { kpiCard(icon: "star", value: "\(Int(stats.preferenceRate * 100)) %", label: "Präferenztreffer", tint: LP.burgundy) kpiCard(icon: "person.2", value: "\(stats.activePeople)", label: "eingesetzte Personen", tint: LP.accent) kpiCard(icon: "calendar.badge.minus", value: "\(stats.absenceDays)", label: "Abwesenheitstage", tint: LP.open) - kpiCard(icon: "cross.case", value: "\(stats.sundayServiceCount)", label: "Sonntage", tint: LP.gold) + kpiCard(icon: "cross.case", value: "\(stats.sundayServiceCount)", label: "Sonntagsdienste", tint: LP.gold) } } @@ -177,7 +184,7 @@ struct StatisticsView: View { Text(String(format: "%.1f", average)) .font(.system(size: 30, weight: .bold, design: .rounded)) .foregroundStyle(LP.ink) - Text("Einsätze pro aktive Person im Schnitt") + Text("Einsätze pro eingesetzter Person im Schnitt") .font(.system(size: 9.5)) .foregroundStyle(LP.inkTertiary) @@ -186,7 +193,7 @@ struct StatisticsView: View { fairnessRow(label: "Höchste Last", value: "\(maximum)") fairnessRow(label: "Niedrigste Last", value: "\(minimum)") fairnessRow(label: "Spannweite", value: "\(maximum - minimum)") - fairnessRow(label: "Aktive Personen", value: "\(totals.count)") + fairnessRow(label: "Eingesetzte Personen", value: "\(totals.count)") Hairline() @@ -370,7 +377,7 @@ struct StatisticsView: View { .tracking(1.1) .foregroundStyle(LP.inkTertiary) Spacer() - Text("Personen mit Einsätzen im Zeitraum") + Text("Alle Personen im Zeitraum") .font(.system(size: 8.5)) .foregroundStyle(LP.inkTertiary) } @@ -385,8 +392,8 @@ struct StatisticsView: View { .frame(width: 28) Text("K") .frame(width: 28) - Text("Sonntage") - .frame(width: 62) + Text("Sonntags-Einsätze") + .frame(width: 92) Text("Kirchen") .frame(width: 150, alignment: .leading) Text("Präferenz") @@ -400,7 +407,7 @@ struct StatisticsView: View { .padding(.vertical, 7) .background(LP.cardMuted.opacity(0.5)) - ForEach(Array(activePersonStats.enumerated()), id: \.element.id) { index, stat in + ForEach(Array(stats.personStats.enumerated()), id: \.element.id) { index, stat in HStack(spacing: 8) { HStack(spacing: 6) { Avatar(initials: stat.person.initials, @@ -418,7 +425,7 @@ struct StatisticsView: View { Text("\(stat.helpers)") .frame(width: 28) Text("\(stat.sundayCount)") - .frame(width: 62) + .frame(width: 92) HStack(spacing: 3) { ForEach(Array(stat.churchCounts.sorted { $0.value > $1.value }.prefix(3)), id: \.key) { item in if let church = model.churchByID[item.key] { diff --git a/Sources/LektorenPlanCore/Models.swift b/Sources/LektorenPlanCore/Models.swift index d5fb1fb..90bbc0a 100644 --- a/Sources/LektorenPlanCore/Models.swift +++ b/Sources/LektorenPlanCore/Models.swift @@ -36,6 +36,22 @@ public enum Role: String, Codable, CaseIterable, Identifiable, Sendable, Hashabl } } + /// Readable combination of roles in canonical order, e.g. + /// "Lektor und Kommunionhelfer" when one person fills both roles in the + /// same service. + public static func combinedTitle(_ roles: [Role]) -> String { + let ordered = allCases.filter { roles.contains($0) } + switch ordered.count { + case 0: + return "" + case 1: + return ordered[0].title + default: + let leading = ordered.dropLast().map(\.title).joined(separator: ", ") + return "\(leading) und \(ordered[ordered.count - 1].title)" + } + } + /// The other role a service may need. Lector and communion helper do not /// exclude each other, so one person can fill both at the same service. public var complementary: Role { diff --git a/Tests/LektorenPlanCoreTests/CoreTests.swift b/Tests/LektorenPlanCoreTests/CoreTests.swift index 7964b9f..ecf3075 100644 --- a/Tests/LektorenPlanCoreTests/CoreTests.swift +++ b/Tests/LektorenPlanCoreTests/CoreTests.swift @@ -2,6 +2,13 @@ import XCTest @testable import LektorenPlanCore final class CoreTests: XCTestCase { + func testRoleCombinedTitle() { + XCTAssertEqual(Role.combinedTitle([.lector]), "Lektor") + XCTAssertEqual(Role.combinedTitle([.helper]), "Kommunionhelfer") + XCTAssertEqual(Role.combinedTitle([.helper, .lector]), "Lektor und Kommunionhelfer") + XCTAssertEqual(Role.combinedTitle([]), "") + } + func testEasterDates() { XCTAssertEqual(DayMath.key(LiturgicalCalendarEngine.easterSunday(year: 2026)), "2026-04-05") XCTAssertEqual(DayMath.key(LiturgicalCalendarEngine.easterSunday(year: 2027)), "2027-03-28") diff --git a/doc/statistics.md b/doc/statistics.md new file mode 100644 index 0000000..0794914 --- /dev/null +++ b/doc/statistics.md @@ -0,0 +1,121 @@ +# Statistik verstehen + +Diese Hilfe erklärt die Kennzahlen, Diagramme und Tabellen der Statistikseite. Alle Werte beziehen sich ausschließlich auf den oben gewählten Zeitraum. Wird der Zeitraum geändert, ändern sich sämtliche Angaben entsprechend. + +## Grundbegriffe + +- **Gottesdienst:** Ein konkreter Termin im gewählten Zeitraum. Die Zahl der Gottesdienste ist unabhängig davon, ob die benötigten Dienste besetzt sind. +- **Einsatz:** Eine konkrete Einteilung einer Person für einen Dienst an einem Gottesdienst. Eine Person kann bei demselben Gottesdienst sowohl als Lektor als auch als Kommunionhelfer eingeteilt sein; das zählt als zwei Einsätze, aber als ein Gottesdienst. +- **Benötigter Dienstplatz:** Ein laut Gottesdienstordnung benötigter Lektor- oder Kommunionhelferplatz. Die Summe aller benötigten Plätze ist die Grundlage für Besetzungsquote und offene Dienste. +- **Eingesetzte Person:** Eine Person mit mindestens einem Einsatz im gewählten Zeitraum. Diese Zahl ist nicht identisch mit der Zahl aller aktiven Team-Mitglieder. +- **Präferenz:** Eine hinterlegte Vorliebe für eine Kirche, einen Wochentag oder einen Gottesdiensttitel. Eine Person gilt als präferenzberechtigt, sobald mindestens eine dieser Angaben hinterlegt ist. + +## Kennzahlen im Überblick + +### Besetzungsquote + +**Berechnung:** Anzahl der Einsätze geteilt durch die Anzahl der benötigten Dienstplätze. + +- **100 %** bedeutet, dass alle benötigten Dienstplätze besetzt sind. +- **Unter 100 %** bleiben Dienstplätze offen. +- **Über 100 %** kann nur bei einer Überbesetzung auftreten, also wenn mehr Einsätze als benötigte Plätze vorhanden sind. +- Sind im Zeitraum keine Dienstplätze erforderlich, wird die Quote als 100 % angezeigt. + +### Offene Dienste + +**Berechnung:** Summe der benötigten Dienstplätze minus Summe der Einsätze. Der Wert wird nie negativ. + +Der Wert zählt einzelne Dienstplätze, nicht Gottesdienste. Ein Gottesdienst mit zwei offenen Kommunionhelferplätzen trägt also zwei offene Dienste bei. Die Zahl wird über alle Kirchen des Mandanten summiert. + +### Durchschnitt + +**Berechnung:** Anzahl aller Einsätze geteilt durch die Anzahl der eingesetzten Personen. + +- Personen ohne Einsatz im Zeitraum gehen nicht in den Durchschnitt ein. +- Eine Doppelrolle zählt als zwei Einsätze. +- Der Wert zeigt die durchschnittliche Last der Personen, die tatsächlich Dienst hatten. + +### Präferenztreffer + +**Berechnung:** Anzahl der Einsätze mit Präferenztreffer geteilt durch die Anzahl der bewertbaren Einsätze. + +- **Bewertbar** sind nur Einsätze von Personen, die mindestens eine Präferenz hinterlegt haben. +- Ein Einsatz ist ein **Treffer**, wenn die Kirche, der Wochentag oder der Gottesdiensttitel einer hinterlegten Präferenz entspricht. +- Erfüllt ein Einsatz mehrere Präferenzen gleichzeitig, zählt er trotzdem nur einmal. +- Einsätze von Personen ohne Präferenzen werden weder als Treffer noch als bewertbarer Einsatz gezählt. +- In der Personen-Tabelle wird zusätzlich der Anteil der Treffer an allen Einsätzen der jeweiligen Person angezeigt. Ohne hinterlegte Präferenz erscheint dort ein Strich. + +### Abwesenheitstage + +**Berechnung:** Summe der Abwesenheitstage aller aktiven Personen, begrenzt auf den gewählten Zeitraum. + +- Nur Abwesenheiten aktiver Team-Mitglieder werden berücksichtigt. +- Abwesenheiten, die über den Rand des Zeitraums hinausreichen, werden auf den Zeitraum zugeschnitten. +- Überlappende Abwesenheiten derselben Person können mehrfach gezählt werden. +- Der Wert beschreibt gemeldete Abwesenheitstage, nicht die Zahl der dadurch entstandenen offenen Dienste. + +## Diagramme und Tabellen + +### Einsätze nach Monat + +Das Diagramm zeigt für jeden Monat des Zeitraums die Anzahl der Einsätze, deren Gottesdienst in diesem Monat liegt. + +- Maßgeblich ist das Datum des Gottesdienstes, nicht der Zeitpunkt der Einteilung. +- Eine Doppelrolle zählt als zwei Einsätze. +- Monate ohne Einsätze werden mit 0 angezeigt. + +### Fairness und Verteilung + +Die Fairness-Karte vergleicht die Einsatzzahlen der eingesetzten Personen. + +- **Höchste Last:** Höchste Einsatzzahl einer eingesetzten Person. +- **Niedrigste Last:** Niedrigste Einsatzzahl einer eingesetzten Person. Personen ohne Einsatz werden nicht berücksichtigt. +- **Spannweite:** Differenz zwischen höchster und niedrigster Last. +- **Durchschnitt:** Durchschnittliche Einsatzzahl je eingesetzter Person. + +Eine geringe Spannweite spricht für eine gleichmäßige Verteilung. Bewusste Präferenzen, Abwesenheiten, Monatslimits oder Rollenbeschränkungen können zu Abweichungen führen. + +### Personen + +Die Personen-Tabelle listet alle Personen des Mandanten im gewählten Zeitraum auf. Personen ohne Einsatz erscheinen mit 0. + +- **Gesamt:** Anzahl aller Einsätze der Person im Zeitraum. +- **Lektor:** Anzahl der Einsätze in der Rolle Lektor. +- **Helfer:** Anzahl der Einsätze in der Rolle Kommunionhelfer. +- **Sonntags-Einsätze:** Anzahl der Einsätze, deren Gottesdienst auf einen Sonntag fällt. +- **Präferenz:** Anteil der Einsätze mit Präferenztreffer an allen Einsätzen der Person. Ohne hinterlegte Präferenz erscheint ein Strich. +- **Verteilung:** In der Webansicht ein Balken im Verhältnis zur höchsten Einsatzzahl im Zeitraum. +- **Kirchen:** In der macOS-App die bis zu drei Kirchen mit den meisten Einsätzen der Person. +- **Zuletzt:** In der macOS-App das Datum des spätesten Gottesdienstes der Person im Zeitraum. + +Inaktive Personen werden in der Webansicht gedämpft dargestellt; ihre statistischen Werte bleiben Bestandteil der Auswertung. + +### Verteilung auf Kirchen + +Für jede Kirche werden die Einsätze und Gottesdienste im Zeitraum ausgewiesen. + +- **Einsätze:** Anzahl der Einteilungen an Gottesdiensten dieser Kirche. +- **Gottesdienste:** Anzahl der Gottesdienste dieser Kirche im Zeitraum. +- **Offene Dienste:** Anzahl der noch nicht besetzten benötigten Dienstplätze dieser Kirche. +- **Personen:** Anzahl unterschiedlicher Personen mit mindestens einem Einsatz in dieser Kirche. +- **Vollständig:** Wird angezeigt, wenn für die Kirche keine offenen Dienstplätze bestehen. + +Die Balkenlänge vergleicht die Einsatzzahl der Kirche mit der Kirche mit den meisten Einsätzen im Zeitraum. + +### Sonntagsdienste + +Die Sonntags-Auswertung zeigt zwei unterschiedliche Werte. + +- **Sonntagsdienste:** Anzahl der Gottesdienste, die auf einen Sonntag fallen. Mehrere Gottesdienste an einem Sonntag zählen mehrfach. +- **Besetzte Dienstplätze:** Anzahl der Einsätze an diesen Sonntagsgottesdiensten. Diese Zahl kann höher sein als die Zahl der Sonntagsgottesdienste, wenn ein Gottesdienst mehrere Dienstplätze hat. + +In der macOS-App erscheint die Anzahl der Sonntagsdienste als eigene Kennzahl. In der Webansicht werden besetzte Dienstplätze und Sonntagsgottesdienste gemeinsam dargestellt. + +## Hinweise zur Interpretation + +- Statistische Werte beschreiben den gewählten Zeitraum, nicht das gesamte Kirchenjahr. +- Ein hoher Durchschnitt bei wenigen eingesetzten Personen bedeutet nicht automatisch eine gerechte Verteilung. +- Die Präferenztreffer-Quote ist nur so aussagekräftig wie die hinterlegten Präferenzen. +- Offene Dienste und Besetzungsquote beziehen sich auf Dienstplätze, nicht auf die Zahl der Gottesdienste. +- Doppelrollen erhöhen die Einsatz- und Präferenzzahlen, ohne einen zusätzlichen Gottesdienst zu erzeugen. +- Abwesenheitstage sind eine Planungsinformation und kein direkter Indikator für die Qualität der Besetzung. diff --git a/web/domain/models.go b/web/domain/models.go index a6652e6..e9b28ce 100644 --- a/web/domain/models.go +++ b/web/domain/models.go @@ -48,6 +48,29 @@ func (r Role) Complementary() Role { func (r Role) IsValid() bool { return r == RoleLector || r == RoleHelper } +// RoleTitles returns a readable list of roles in canonical order. A person can +// hold both roles in the same service, which is shown as +// "Lektor und Kommunionhelfer" instead of two separate entries. +func RoleTitles(roles []Role) string { + var titles []string + for _, role := range AllRoles { + for _, candidate := range roles { + if candidate == role { + titles = append(titles, role.Title()) + break + } + } + } + switch len(titles) { + case 0: + return "" + case 1: + return titles[0] + default: + return strings.Join(titles[:len(titles)-1], ", ") + " und " + titles[len(titles)-1] + } +} + type ChurchSymbol string const ( diff --git a/web/pdf/cover.go b/web/pdf/cover.go index 6c663d0..2f7c2da 100644 --- a/web/pdf/cover.go +++ b/web/pdf/cover.go @@ -6,6 +6,8 @@ import ( "strings" "time" + "github.com/go-pdf/fpdf" + "lektorenplan/domain" ) @@ -15,7 +17,7 @@ type DispatchAssignment struct { TimeMinutes int Church string Title string - Role domain.Role + RoleLabel string } // CoverData describes the personal cover sheet of a dispatch packet. @@ -39,7 +41,7 @@ func AssignmentLines(assignments []DispatchAssignment) []string { domain.MediumString(assignment.Date), domain.TimeString(assignment.TimeMinutes), assignment.Church, - assignment.Role.Title())) + assignment.RoleLabel)) } return lines } @@ -48,6 +50,34 @@ func coverOptions(data CoverData) Options { return Options{TenantName: data.TenantName, Diocese: data.Diocese, GeneratedAt: data.GeneratedAt} } +// writeCoverText writes letter paragraphs with manual page breaks. Cover pages +// are laid out with explicit coordinates, so fpdf's own page breaking would +// reset the cursor to the default margin and misalign the letter. A long +// introduction or greeting must nevertheless appear completely instead of +// running off the page. +func writeCoverText(pdf *fpdf.Fpdf, tr func(string) string, text string, x, y, width, lineHeight, pageTop, bottom float64) float64 { + text = strings.TrimSpace(strings.ReplaceAll(text, "\r\n", "\n")) + if text == "" { + return y + } + for _, paragraph := range strings.Split(text, "\n") { + if strings.TrimSpace(paragraph) == "" { + y += lineHeight + continue + } + for _, line := range pdf.SplitLines([]byte(tr(paragraph)), width) { + if y+lineHeight > bottom { + pdf.AddPage() + y = pageTop + } + pdf.SetXY(x, y) + pdf.CellFormat(width, lineHeight, string(line), "", 0, "L", false, 0, "") + y += lineHeight + } + } + return y +} + // Cover writes an A4 portrait cover letter with the personal assignment overview. func Cover(w io.Writer, data CoverData) error { pdf := newPDF("P") @@ -109,9 +139,8 @@ func Cover(w io.Writer, data CoverData) error { y += 10 setColor(pdf, colors.ink) pdf.SetFont("Times", "", 11.5) - pdf.SetXY(margin, y) - pdf.MultiCell(contentW, 5.6, tr(strings.TrimSpace(data.Intro)), "", "L", false) - y = pdf.GetY() + 8 + y = writeCoverText(pdf, tr, data.Intro, margin, y, contentW, 5.6, margin, 278) + y += 8 // Assignment table ----------------------------------------------------- setColor(pdf, colors.ink) @@ -162,7 +191,7 @@ func Cover(w io.Writer, data CoverData) error { dayLabel, domain.TimeString(assignment.TimeMinutes), assignment.Church, - assignment.Role.Title() + " · " + assignment.Title, + assignment.RoleLabel + " · " + assignment.Title, } for index, column := range columns { pdf.SetXY(x, y+2.1) @@ -179,16 +208,15 @@ func Cover(w io.Writer, data CoverData) error { // Greeting ------------------------------------------------------------- if strings.TrimSpace(data.Greeting) != "" { - if y > 245 { - pdf.AddPage() - y = margin - } setColor(pdf, colors.ink) pdf.SetFont("Times", "", 11.5) - pdf.SetXY(margin, y) - pdf.MultiCell(contentW, 5.6, tr(strings.TrimSpace(data.Greeting)), "", "L", false) + y = writeCoverText(pdf, tr, data.Greeting, margin, y, contentW, 5.6, margin, 278) + y += 8 } + // The recipient is already named explicitly in the address block above, + // so the cover does not repeat the name in parentheses at the end. + // Footer --------------------------------------------------------------- setColor(pdf, colors.tertiary) pdf.SetFont("Helvetica", "", 6.5) diff --git a/web/pdf/merge.go b/web/pdf/merge.go index 5b9deb1..891a876 100644 --- a/web/pdf/merge.go +++ b/web/pdf/merge.go @@ -4,48 +4,148 @@ import ( "bytes" "fmt" "io" + "runtime" "github.com/go-pdf/fpdf" "github.com/go-pdf/fpdf/contrib/gofpdi" ) -// Merge concatenates PDF documents page by page, preserving page sizes and -// orientation. It is used for printable dispatch packets that combine a cover -// sheet with the selected plan variant for every recipient. -func Merge(documents [][]byte) ([]byte, error) { +// PDF page boxes are reported in PostScript points while fpdf works in +// millimetres. +const mmPerPoint = 25.4 / 72.0 + +type documentPage struct { + width float64 + height float64 +} + +func pointsToMillimetres(value float64) float64 { + return value * mmPerPoint +} + +// documentPages returns the page geometry of a PDF in millimetres. +func documentPages(raw []byte) ([]documentPage, error) { out := fpdf.New("P", "mm", "A4", "") out.SetMargins(0, 0, 0) out.SetAutoPageBreak(false, 0) - for _, raw := range documents { - if len(raw) == 0 { - continue + importer := gofpdi.NewImporter() + reader := new(io.ReadSeeker) + *reader = bytes.NewReader(raw) + importer.ImportPageFromStream(out, reader, 1, "/MediaBox") + + sizes := importer.GetPageSizes() + if len(sizes) == 0 { + return nil, fmt.Errorf("PDF ohne Seiten") + } + pages := make([]documentPage, len(sizes)) + for page := 1; page <= len(sizes); page++ { + size, ok := sizes[page]["/MediaBox"] + if !ok { + return nil, fmt.Errorf("PDF-Seite %d ohne MediaBox", page) } - var reader io.ReadSeeker = bytes.NewReader(raw) - importer := gofpdi.NewImporter() - template := importer.ImportPageFromStream(out, &reader, 1, "/MediaBox") - sizes := importer.GetPageSizes() - pages := len(sizes) - if pages == 0 { - return nil, fmt.Errorf("PDF ohne Seiten") - } - for page := 1; page <= pages; page++ { - size, ok := sizes[page]["/MediaBox"] - if !ok { - return nil, fmt.Errorf("PDF-Seite %d ohne MediaBox", page) - } - width, height := size["w"], size["h"] - orientation := "P" - if width > height { - orientation = "L" - } - out.AddPageFormat(orientation, fpdf.SizeType{Wd: width, Ht: height}) - if page > 1 { - template = importer.ImportPageFromStream(out, &reader, page, "/MediaBox") - } - importer.UseImportedTemplate(out, template, 0, 0, width, height) + pages[page-1] = documentPage{ + width: pointsToMillimetres(size["w"]), + height: pointsToMillimetres(size["h"]), } } + return pages, nil +} + +// PageCount returns the number of pages in a PDF document. +func PageCount(raw []byte) (int, error) { + pages, err := documentPages(raw) + if err != nil { + return 0, err + } + return len(pages), nil +} + +// PadToEvenPages appends one blank page to documents with an odd page count so +// that every cover sheet and every service list starts on the front side of a +// sheet when printed duplex. Documents with an even page count are returned +// unchanged. +func PadToEvenPages(raw []byte) ([]byte, error) { + pages, err := documentPages(raw) + if err != nil { + return nil, err + } + if len(pages)%2 == 0 { + return raw, nil + } + last := pages[len(pages)-1] + blank, err := blankPage(last.width, last.height) + if err != nil { + return nil, err + } + return Merge([][]byte{raw, blank}) +} + +func blankPage(width, height float64) ([]byte, error) { + out := fpdf.New("P", "mm", "A4", "") + out.SetMargins(0, 0, 0) + out.SetAutoPageBreak(false, 0) + out.AddPageFormat("P", fpdf.SizeType{Wd: width, Ht: height}) + + var buffer bytes.Buffer + if err := out.Output(&buffer); err != nil { + return nil, err + } + if err := out.Error(); err != nil { + return nil, err + } + return buffer.Bytes(), nil +} + +// Merge concatenates PDF documents page by page, preserving page sizes and +// orientation. It is used for printable dispatch packets that combine a cover +// sheet with the selected plan variant for every recipient. +// +// All documents share one importer. A new importer per document would restart +// the internal template numbering, so later documents would silently overwrite +// earlier templates and their pages would show the wrong content. +func Merge(documents [][]byte) ([]byte, error) { + out := fpdf.New("P", "mm", "A4", "") + out.SetMargins(0, 0, 0) + out.SetAutoPageBreak(false, 0) + + importer := gofpdi.NewImporter() + // Keep each source stream pointer alive so gofpdi sees a distinct source + // identifier for every document. + var readers []*io.ReadSeeker + + for _, raw := range documents { + if len(raw) == 0 { + continue + } + reader := new(io.ReadSeeker) + *reader = bytes.NewReader(raw) + readers = append(readers, reader) + + template := importer.ImportPageFromStream(out, reader, 1, "/MediaBox") + sizes := importer.GetPageSizes() + pages := len(sizes) + if pages == 0 { + return nil, fmt.Errorf("PDF ohne Seiten") + } + for page := 1; page <= pages; page++ { + size, ok := sizes[page]["/MediaBox"] + if !ok { + return nil, fmt.Errorf("PDF-Seite %d ohne MediaBox", page) + } + width := pointsToMillimetres(size["w"]) + height := pointsToMillimetres(size["h"]) + // A4 portrait is passed explicitly: fpdf swaps width and height for + // "L", which would turn an already landscape-sized box back into + // portrait. "P" keeps the requested dimensions as they are. + out.AddPageFormat("P", fpdf.SizeType{Wd: width, Ht: height}) + if page > 1 { + template = importer.ImportPageFromStream(out, reader, page, "/MediaBox") + } + importer.UseImportedTemplate(out, template, 0, 0, width, height) + } + } + runtime.KeepAlive(readers) var buffer bytes.Buffer if err := out.Output(&buffer); err != nil { diff --git a/web/pdf/pdf_test.go b/web/pdf/pdf_test.go index 73576bb..06c10d2 100644 --- a/web/pdf/pdf_test.go +++ b/web/pdf/pdf_test.go @@ -115,7 +115,7 @@ func TestPDFUmlautsAreEncoded(t *testing.T) { Greeting: "Herzliche Grüße", Assignments: []DispatchAssignment{{ Date: domain.MustDate("2026-11-15"), TimeMinutes: 9*60 + 30, - Church: "St. Mariä Himmelfahrt", Title: "Hochamt für die Gemeinde", Role: domain.RoleLector, + Church: "St. Mariä Himmelfahrt", Title: "Hochamt für die Gemeinde", RoleLabel: "Lektor", }}, GeneratedAt: time.Now(), } @@ -311,3 +311,188 @@ func TestCompactPlanPaginatesWithoutContinuationTitle(t *testing.T) { t.Fatalf("footer count = %d, want %d", got, total) } } + +// A cover sheet placed between plan pages used to be overwritten by the next +// document's imported templates, so its letter text disappeared from the +// dispatch packet. +func TestMergeKeepsCoverBetweenPlanDocuments(t *testing.T) { + r, rows, _, people := sampleRows() + var cover bytes.Buffer + if err := Cover(&cover, CoverData{ + TenantName: "Köln", Diocese: "Erzbistum Köln", Range: r, Person: people[0], + Intro: "Liebe Lektorinnen und Lektoren, liebe Kommunionhelferinnen und -helfer,", + Greeting: "Mit freundlichen Grüßen", + GeneratedAt: time.Now(), + }); err != nil { + t.Fatalf("cover: %v", err) + } + var plan bytes.Buffer + if err := CompactPlan(&plan, r, rows, people, Options{TenantName: "Köln"}); err != nil { + t.Fatalf("plan: %v", err) + } + + merged, err := Merge([][]byte{plan.Bytes(), cover.Bytes(), plan.Bytes()}) + if err != nil { + t.Fatalf("merge: %v", err) + } + content := string(pdfContentStreams(t, merged)) + if !strings.Contains(content, "Liebe Lektorinnen") { + t.Fatal("cover letter text is missing from the merged packet") + } + if !strings.Contains(content, "Gottesdienstliste") { + t.Fatal("plan text is missing from the merged packet") + } + + pages, err := documentPages(merged) + if err != nil { + t.Fatalf("page sizes: %v", err) + } + if len(pages) != 3 { + t.Fatalf("merged page count = %d, want 3", len(pages)) + } + for _, page := range pages { + if page.width < 200 || page.width > 220 || page.height < 285 || page.height > 305 { + t.Fatalf("page size = %.1f x %.1f mm, want A4 portrait", page.width, page.height) + } + } +} + +func TestPadToEvenPages(t *testing.T) { + r, _, _, people := sampleRows() + var cover bytes.Buffer + if err := Cover(&cover, CoverData{ + TenantName: "Köln", Range: r, Person: people[0], + Intro: "Ein kurzer Text.", GeneratedAt: time.Now(), + }); err != nil { + t.Fatalf("cover: %v", err) + } + if count, err := PageCount(cover.Bytes()); err != nil || count != 1 { + t.Fatalf("cover page count = %d, %v; want 1", count, err) + } + padded, err := PadToEvenPages(cover.Bytes()) + if err != nil { + t.Fatalf("pad cover: %v", err) + } + if count, err := PageCount(padded); err != nil || count != 2 { + t.Fatalf("padded cover page count = %d, %v; want 2", count, err) + } + + even, err := Merge([][]byte{cover.Bytes(), cover.Bytes()}) + if err != nil { + t.Fatalf("merge even document: %v", err) + } + unchanged, err := PadToEvenPages(even) + if err != nil { + t.Fatalf("pad even document: %v", err) + } + if !bytes.Equal(unchanged, even) { + t.Fatal("a document with an even page count must not be changed") + } + + r, rows, churches, people := sampleRows() + var landscape bytes.Buffer + if err := FullPlan(&landscape, r, rows, churches, people, Options{TenantName: "Köln"}); err != nil { + t.Fatalf("full plan: %v", err) + } + padded, err = PadToEvenPages(landscape.Bytes()) + if err != nil { + t.Fatalf("pad full plan: %v", err) + } + pages, err := documentPages(padded) + if err != nil { + t.Fatalf("page sizes: %v", err) + } + if len(pages) != 2 { + t.Fatalf("padded full plan page count = %d, want 2", len(pages)) + } + for _, page := range pages { + if page.width < 285 || page.width > 305 || page.height < 200 || page.height > 220 { + t.Fatalf("page size = %.1f x %.1f mm, want A4 landscape", page.width, page.height) + } + } +} + +// The address block already names the recipient. The cover must not repeat the +// name in parentheses at the end. +func TestCoverNamesRecipientOnlyInAddressBlock(t *testing.T) { + r, _, _, people := sampleRows() + var buf bytes.Buffer + if err := Cover(&buf, CoverData{ + TenantName: "Köln", Range: r, Person: people[0], + Intro: "Ein kurzer Text.", Greeting: "Mit freundlichen Grüßen", + GeneratedAt: time.Now(), + }); err != nil { + t.Fatalf("cover: %v", err) + } + content := string(pdfContentStreams(t, buf.Bytes())) + if count := strings.Count(content, "Anna Berg"); count != 1 { + t.Fatalf("recipient name appears %d times, want only the address block:\n%s", count, content) + } + if strings.Contains(content, "\\(Anna Berg\\)") { + t.Fatalf("cover must not repeat the recipient in parentheses:\n%s", content) + } +} + +// A dispatch packet mixes the portrait cover with the optional landscape plan. +// Passing landscape dimensions together with fpdf's "L" orientation used to +// swap them back to portrait and crop the plan. +func TestMergeKeepsPortraitAndLandscapePages(t *testing.T) { + r, rows, churches, people := sampleRows() + var cover bytes.Buffer + if err := Cover(&cover, CoverData{ + TenantName: "Köln", Range: r, Person: people[0], + Intro: "Ein kurzer Text.", GeneratedAt: time.Now(), + }); err != nil { + t.Fatalf("cover: %v", err) + } + var plan bytes.Buffer + if err := FullPlan(&plan, r, rows, churches, people, Options{TenantName: "Köln"}); err != nil { + t.Fatalf("full plan: %v", err) + } + merged, err := Merge([][]byte{cover.Bytes(), plan.Bytes()}) + if err != nil { + t.Fatalf("merge: %v", err) + } + pages, err := documentPages(merged) + if err != nil { + t.Fatalf("page sizes: %v", err) + } + if len(pages) != 2 { + t.Fatalf("merged page count = %d, want 2", len(pages)) + } + if pages[0].width >= pages[0].height { + t.Fatalf("cover page is not portrait: %.1f x %.1f mm", pages[0].width, pages[0].height) + } + if pages[1].width <= pages[1].height { + t.Fatalf("plan page is not landscape: %.1f x %.1f mm", pages[1].width, pages[1].height) + } +} + +// The cover sheet must render the same letter text as the e-mail. A long +// introduction used to run past the page because the cover is laid out with +// explicit coordinates and page breaking was disabled. +func TestCoverKeepsCompleteLetterText(t *testing.T) { + r, _, _, people := sampleRows() + firstParagraph := "Liebe Lektorinnen und Lektoren, liebe Kommunionhelferinnen und -helfer," + lastParagraph := "Der Schluss des langen Freitextes bleibt sichtbar." + longMiddle := strings.Repeat("Dieser Satz füllt das Vorblatt über mehrere Seiten hinweg. ", 90) + greeting := "Mit freundlichen Grüßen\nIhr Pfarreiteam" + + var buf bytes.Buffer + if err := Cover(&buf, CoverData{ + TenantName: "Köln", Range: r, Person: people[0], + Intro: firstParagraph + "\n\n" + longMiddle + "\n\n" + lastParagraph, + Greeting: greeting, GeneratedAt: time.Now(), + }); err != nil { + t.Fatalf("cover: %v", err) + } + content := string(pdfContentStreams(t, buf.Bytes())) + for _, want := range []string{firstParagraph, lastParagraph, "Mit freundlichen"} { + if !strings.Contains(content, want) { + t.Fatalf("cover is missing %q:\n%s", want, content) + } + } + if pages, err := PageCount(buf.Bytes()); err != nil || pages < 2 { + t.Fatalf("long cover text should span several pages, got %d (%v)", pages, err) + } +} diff --git a/web/web/dispatch_calendar_test.go b/web/web/dispatch_calendar_test.go index ca8e1bc..74bce9e 100644 --- a/web/web/dispatch_calendar_test.go +++ b/web/web/dispatch_calendar_test.go @@ -10,6 +10,44 @@ import ( "lektorenplan/domain" ) +func TestDispatchAssignmentsCombineBothRolesInOneService(t *testing.T) { + day := time.Date(2026, 3, 8, 0, 0, 0, 0, time.Local) + church := domain.Church{ID: "c1", Name: "St. Andreas", ShortName: "Andreas"} + service := domain.ServiceOccurrence{ + ID: "s1", ChurchID: "c1", Date: day, TimeMinutes: 9*60 + 30, + Title: "Hochamt", LectorsNeeded: 1, HelpersNeeded: 1, Kind: domain.KindRegular, + } + row := domain.DayPlanRow{ + Date: day, + Services: []domain.ServiceWithAssignments{{ + Service: service, Church: church, + Assignments: []domain.Assignment{ + {ID: "a1", ServiceID: "s1", PersonID: "p1", Role: domain.RoleLector}, + {ID: "a2", ServiceID: "s1", PersonID: "p1", Role: domain.RoleHelper}, + {ID: "a3", ServiceID: "s1", PersonID: "p2", Role: domain.RoleHelper}, + }, + }}, + } + + assignments := dispatchAssignments([]domain.DayPlanRow{row}, "p1") + if len(assignments) != 1 { + t.Fatalf("assignments = %d, want one combined service entry", len(assignments)) + } + if assignments[0].RoleLabel != "Lektor und Kommunionhelfer" { + t.Fatalf("role label = %q", assignments[0].RoleLabel) + } + if assignments[0].ID != "s1" { + t.Fatalf("calendar id = %q, want service id", assignments[0].ID) + } + table := emailAssignmentTable(assignments) + if !strings.Contains(table, "Hochamt (Lektor und Kommunionhelfer)") { + t.Fatalf("email table does not combine the roles:\n%s", table) + } + if lines := strings.Split(strings.TrimSpace(table), "\n"); len(lines) != 3 { + t.Fatalf("email table has %d lines, want header and one service row:\n%s", len(lines), table) + } +} + func TestDispatchCalendarEventsMapAssignments(t *testing.T) { day := time.Date(2026, 3, 8, 0, 0, 0, 0, time.Local) events := dispatchCalendarEvents([]dispatchAssignmentView{ diff --git a/web/web/dispatch_handlers.go b/web/web/dispatch_handlers.go index 7f5b4b1..b7affe4 100644 --- a/web/web/dispatch_handlers.go +++ b/web/web/dispatch_handlers.go @@ -52,7 +52,7 @@ type dispatchAssignmentView struct { Church string Place string Title string - Role domain.Role + Roles []domain.Role RoleLabel string SortMinutes int } @@ -216,25 +216,42 @@ func effectiveDispatchChannel(channel, email string) string { } func dispatchAssignments(rows []domain.DayPlanRow, personID string) []dispatchAssignmentView { - var out []dispatchAssignmentView + byService := map[string]*dispatchAssignmentView{} + var order []string for _, row := range rows { for _, service := range row.Services { for _, assignment := range service.Assignments { if assignment.PersonID != personID { continue } - out = append(out, dispatchAssignmentView{ - ID: assignment.ID, Date: row.Date, DateLabel: domain.MediumString(row.Date), - TimeLabel: domain.TimeString(service.Service.TimeMinutes), - Church: service.Church.ShortName, - Place: service.Service.PlaceName(service.Church), - Title: service.Service.Title, - Role: assignment.Role, RoleLabel: assignment.Role.Title(), - SortMinutes: service.Service.TimeMinutes, - }) + // A person can serve as lector and helper in the same service. + // Both assignments share one line in the personal overview and + // one calendar event. + view, ok := byService[service.Service.ID] + if !ok { + view = &dispatchAssignmentView{ + ID: service.Service.ID, Date: row.Date, DateLabel: domain.MediumString(row.Date), + TimeLabel: domain.TimeString(service.Service.TimeMinutes), + Church: service.Church.ShortName, + Place: service.Service.PlaceName(service.Church), + Title: service.Service.Title, + SortMinutes: service.Service.TimeMinutes, + } + byService[service.Service.ID] = view + order = append(order, service.Service.ID) + } + if !hasDispatchRole(view.Roles, assignment.Role) { + view.Roles = append(view.Roles, assignment.Role) + } } } } + out := make([]dispatchAssignmentView, 0, len(order)) + for _, id := range order { + view := byService[id] + view.RoleLabel = domain.RoleTitles(view.Roles) + out = append(out, *view) + } sort.SliceStable(out, func(i, j int) bool { if !out[i].Date.Equal(out[j].Date) { return out[i].Date.Before(out[j].Date) @@ -244,6 +261,15 @@ func dispatchAssignments(rows []domain.DayPlanRow, personID string) []dispatchAs return out } +func hasDispatchRole(roles []domain.Role, role domain.Role) bool { + for _, candidate := range roles { + if candidate == role { + return true + } + } + return false +} + // dispatchCalendarEvents maps one person's assignments to calendar events. The // service time is a wall-clock time in the parish, so the event is built with // the server's local zone and stays a floating local time in the .ics file. @@ -741,6 +767,7 @@ func (s *Server) handleDispatchPrint(w http.ResponseWriter, r *http.Request, use s.redirect(w, r, "/dispatch?start="+domain.Key(form.Range.Start)+"&end="+domain.Key(form.Range.End)) return } + duplex := r.FormValue("duplex") == "1" rows, churches, peopleList, _, err := s.dispatchContextData(r.Context(), tenant.ID, form.Range) if err != nil { s.renderError(w, r, http.StatusInternalServerError, "Versendung", err.Error()) @@ -775,14 +802,22 @@ func (s *Server) handleDispatchPrint(w http.ResponseWriter, r *http.Request, use for _, assignment := range assignments { coverData.Assignments = append(coverData.Assignments, pdf.DispatchAssignment{ Date: assignment.Date, TimeMinutes: parseTimeLabel(assignment.TimeLabel), - Church: assignment.Church, Title: assignment.Title, Role: assignment.Role, + Church: assignment.Church, Title: assignment.Title, RoleLabel: assignment.RoleLabel, }) } if err := pdf.Cover(&cover, coverData); err != nil { s.renderError(w, r, http.StatusInternalServerError, "Versendung", err.Error()) return } - documents = append(documents, cover.Bytes()) + document := cover.Bytes() + if duplex { + document, err = pdf.PadToEvenPages(document) + if err != nil { + s.renderError(w, r, http.StatusInternalServerError, "Versendung", err.Error()) + return + } + } + documents = append(documents, document) } variant := normalizeDispatchVariant(selection.Variant) if _, ok := variantPDFs[variant]; !ok { @@ -791,6 +826,13 @@ func (s *Server) handleDispatchPrint(w http.ResponseWriter, r *http.Request, use s.renderError(w, r, http.StatusInternalServerError, "Versendung", err.Error()) return } + if duplex { + document, err = pdf.PadToEvenPages(document) + if err != nil { + s.renderError(w, r, http.StatusInternalServerError, "Versendung", err.Error()) + return + } + } variantPDFs[variant] = document } documents = append(documents, variantPDFs[variant]) diff --git a/web/web/dispatch_test.go b/web/web/dispatch_test.go index 370152c..7970840 100644 --- a/web/web/dispatch_test.go +++ b/web/web/dispatch_test.go @@ -1,16 +1,57 @@ package web import ( + "bytes" + "compress/zlib" "context" "io" "net/http" "net/url" + "regexp" "strings" "testing" + "lektorenplan/pdf" "lektorenplan/store" ) +// decodedPDFStreams concatenates the decoded streams of a PDF. Core-font text +// is stored there as single-byte cp1252 strings. +func decodedPDFStreams(t *testing.T, data []byte) string { + t.Helper() + var out bytes.Buffer + for { + open := bytes.Index(data, []byte("stream")) + if open < 0 { + break + } + start := open + len("stream") + if start < len(data) && data[start] == '\r' { + start++ + } + if start < len(data) && data[start] == '\n' { + start++ + } + end := bytes.Index(data[start:], []byte("endstream")) + if end < 0 { + break + } + raw := bytes.TrimRight(data[start:start+end], "\r\n") + if reader, err := zlib.NewReader(bytes.NewReader(raw)); err == nil { + if decoded, err := io.ReadAll(reader); err == nil { + out.Write(decoded) + out.WriteByte('\n') + } + reader.Close() + } else { + out.Write(raw) + out.WriteByte('\n') + } + data = data[start+end+len("endstream"):] + } + return out.String() +} + // dispatchRange is a range with seeded demo services and liturgical days. const dispatchRange = "start=2026-03-01&end=2026-03-31" @@ -128,15 +169,24 @@ func TestDispatchPrintPacketAndLog(t *testing.T) { login(t, client, ts.URL, "editor", "editor123") body := get(t, client, ts.URL+"/dispatch?"+dispatchRange, http.StatusOK) + if !strings.Contains(body, `name="duplex"`) || !strings.Contains(body, "Für doppelseitigen Druck optimieren") { + t.Fatal("dispatch page is missing the duplex option") + } + if !regexp.MustCompile(`name="duplex" value="1" checked`).MatchString(body) { + t.Fatal("duplex option must be enabled by default") + } csrf := extractCSRF(t, body) resp := postForm(t, client, ts.URL+"/dispatch/print", url.Values{ "csrf": {csrf}, "start": {"2026-03-01"}, "end": {"2026-03-31"}, + "intro": {"Liebe Lektoren,\n\nanbei der Plan."}, + "greeting": {"Viele Gruesse\nIhr Pfarreiteam"}, "channel_p-maria": {"print"}, "variant_p-maria": {"compact"}, "cover_p-maria": {"1"}, + "duplex": {"1"}, }) defer resp.Body.Close() if resp.StatusCode != http.StatusOK { @@ -153,6 +203,17 @@ func TestDispatchPrintPacketAndLog(t *testing.T) { if !strings.HasPrefix(string(raw), "%PDF") { t.Fatalf("response is not a PDF: %q", firstBytes(raw, 20)) } + if pages, err := pdf.PageCount(raw); err != nil || pages%2 != 0 { + t.Fatalf("duplex packet has %d pages (%v), want an even page count", pages, err) + } + // The printed cover must contain the whole letter text, not just the + // assignment table. + content := decodedPDFStreams(t, raw) + for _, want := range []string{"Liebe Lektoren,", "anbei der Plan.", "Viele Gruesse", "Maria Hoffmann"} { + if !strings.Contains(content, want) { + t.Fatalf("print packet is missing %q from the cover letter", want) + } + } ctx := context.Background() tenants, _ := st.Tenants(ctx) @@ -358,6 +419,14 @@ func TestGuestAccessIsReadOnlyAndAnonymous(t *testing.T) { if !strings.Contains(body, "Lektor") && !strings.Contains(body, "Kommunionhelfer") { t.Fatal("guest page should still show assignment roles") } + // Counts must appear exactly once: the plural helper already renders the + // number, so templates must not prepend it again. + if regexp.MustCompile(`\b\d+ \d+ (Gottesdienste|Dienste offen)\b`).MatchString(body) { + t.Fatal("guest page prints a day service count twice") + } + if match := regexp.MustCompile(`(\d+)(\d+) Dienste`).FindStringSubmatch(body); match != nil && match[1] == match[2] { + t.Fatalf("guest page prints the open-service count twice: %s", match[0]) + } // Guest data must never contain person records. ctx := context.Background() diff --git a/web/web/help.go b/web/web/help.go new file mode 100644 index 0000000..c1ebde0 --- /dev/null +++ b/web/web/help.go @@ -0,0 +1,116 @@ +package web + +import ( + _ "embed" + "html" + "html/template" + "net/http" + "strings" + + "lektorenplan/domain" + "lektorenplan/store" +) + +// The canonical document lives in doc/statistics.md. The copy next to this +// package is embedded because go:embed cannot reach outside the package. +// Refresh it with: go generate ./web +// +//go:generate cp ../../doc/statistics.md statistics-help.md +//go:embed statistics-help.md +var statisticsHelpMarkdown string + +type helpPageData struct { + HTML template.HTML + Start string + End string +} + +func (s *Server) handleStatisticsHelp(w http.ResponseWriter, r *http.Request, user *store.User, session *store.Session, tenant *store.Tenant) { + rng := s.rangeFromRequest(r) + data := s.baseView(w, r, "Statistik-Hilfe", "statistics") + data.Data = helpPageData{ + HTML: markdownToHTML(statisticsHelpMarkdown), + Start: domain.Key(rng.Start), + End: domain.Key(rng.End), + } + s.renderPage(w, r, "help", data) +} + +// markdownToHTML renders the small Markdown subset used by the help document: +// ATX headings, unordered lists, paragraphs, bold text and inline code. The +// document is maintained in the repository, so an intentionally small renderer +// avoids an additional runtime dependency. +func markdownToHTML(markdown string) template.HTML { + var out strings.Builder + var paragraph []string + var list []string + + flushParagraph := func() { + if len(paragraph) == 0 { + return + } + out.WriteString("

") + out.WriteString(markdownInline(strings.Join(paragraph, " "))) + out.WriteString("

\n") + paragraph = nil + } + flushList := func() { + if len(list) == 0 { + return + } + out.WriteString("
    \n") + for _, item := range list { + out.WriteString("
  • ") + out.WriteString(markdownInline(item)) + out.WriteString("
  • \n") + } + out.WriteString("
\n") + list = nil + } + + for _, raw := range strings.Split(strings.ReplaceAll(markdown, "\r\n", "\n"), "\n") { + line := strings.TrimSpace(raw) + switch { + case line == "": + flushParagraph() + flushList() + case strings.HasPrefix(line, "# "): + flushParagraph() + flushList() + out.WriteString("

" + markdownInline(strings.TrimSpace(line[2:])) + "

\n") + case strings.HasPrefix(line, "## "): + flushParagraph() + flushList() + out.WriteString("

" + markdownInline(strings.TrimSpace(line[3:])) + "

\n") + case strings.HasPrefix(line, "### "): + flushParagraph() + flushList() + out.WriteString("

" + markdownInline(strings.TrimSpace(line[4:])) + "

\n") + case strings.HasPrefix(line, "- ") || strings.HasPrefix(line, "* "): + flushParagraph() + list = append(list, strings.TrimSpace(line[2:])) + default: + flushList() + paragraph = append(paragraph, line) + } + } + flushParagraph() + flushList() + return template.HTML(out.String()) +} + +// markdownInline handles the inline markup used by the help document. +func markdownInline(text string) string { + escaped := html.EscapeString(text) + parts := strings.Split(escaped, "**") + for index := 1; index < len(parts); index += 2 { + parts[index] = "" + parts[index] + "" + } + escaped = strings.Join(parts, "") + + parts = strings.Split(escaped, "`") + for index := 1; index < len(parts); index += 2 { + parts[index] = "" + parts[index] + "" + } + return strings.Join(parts, "") +} diff --git a/web/web/help_test.go b/web/web/help_test.go new file mode 100644 index 0000000..bba4895 --- /dev/null +++ b/web/web/help_test.go @@ -0,0 +1,50 @@ +package web + +import ( + "net/http" + "os" + "strings" + "testing" +) + +func TestStatisticsHelpMatchesDoc(t *testing.T) { + canonical, err := os.ReadFile("../../doc/statistics.md") + if err != nil { + t.Fatalf("read canonical help document: %v", err) + } + if string(canonical) != statisticsHelpMarkdown { + t.Fatal("web help copy is out of date; run `go generate ./web` from the web directory") + } +} + +func TestMarkdownToHTML(t *testing.T) { + rendered := string(markdownToHTML("# Titel\n\n## Abschnitt\n\n- **Fett:** `Code`\n- Zweiter Punkt\n\nEin Absatz.\n")) + for _, want := range []string{ + "

Titel

", + "

Abschnitt

", + "
    ", + "
  • Fett: Code
  • ", + "
  • Zweiter Punkt
  • ", + "

    Ein Absatz.

    ", + } { + if !strings.Contains(rendered, want) { + t.Fatalf("rendered help misses %q:\n%s", want, rendered) + } + } + if escaped := string(markdownToHTML("")); strings.Contains(escaped, "