Versendung: doppelseitiges Sammel PDF und diverse Verbesserungen
This commit is contained in:
1 parent
4b88aca958
commit
feab6135ff
31 files changed
+1285
-79
No files matched your search
@@ -29,6 +29,9 @@ let package = Package(
|
||||
name: "LektorenPlan",
|
||||
dependencies: ["LektorenPlanCore"],
|
||||
path: "Sources/LektorenPlan",
|
||||
resources: [
|
||||
.process("Resources")
|
||||
],
|
||||
swiftSettings: [
|
||||
.swiftLanguageMode(.v5)
|
||||
]
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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() {
|
||||
|
||||
@@ -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
|
||||
}
|
||||
}
|
||||
@@ -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<Void, Never>?
|
||||
|
||||
@@ -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,
|
||||
// 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,
|
||||
role: assignment.role
|
||||
))
|
||||
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)
|
||||
|
||||
@@ -0,0 +1 @@
|
||||
../../../doc/statistics.md
|
||||
@@ -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()
|
||||
}
|
||||
|
||||
@@ -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
|
||||
}
|
||||
}
|
||||
@@ -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] {
|
||||
|
||||
@@ -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 {
|
||||
|
||||
@@ -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")
|
||||
|
||||
@@ -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.
|
||||
@@ -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 (
|
||||
|
||||
+40
-12
@@ -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)
|
||||
|
||||
+123
-23
@@ -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
|
||||
}
|
||||
var reader io.ReadSeeker = bytes.NewReader(raw)
|
||||
importer := gofpdi.NewImporter()
|
||||
template := importer.ImportPageFromStream(out, &reader, 1, "/MediaBox")
|
||||
reader := new(io.ReadSeeker)
|
||||
*reader = bytes.NewReader(raw)
|
||||
importer.ImportPageFromStream(out, reader, 1, "/MediaBox")
|
||||
|
||||
sizes := importer.GetPageSizes()
|
||||
pages := len(sizes)
|
||||
if pages == 0 {
|
||||
if len(sizes) == 0 {
|
||||
return nil, fmt.Errorf("PDF ohne Seiten")
|
||||
}
|
||||
for page := 1; page <= pages; page++ {
|
||||
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)
|
||||
}
|
||||
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 {
|
||||
|
||||
+186
-1
@@ -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)
|
||||
}
|
||||
}
|
||||
@@ -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{
|
||||
|
||||
@@ -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),
|
||||
// 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,
|
||||
Role: assignment.Role, RoleLabel: assignment.Role.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])
|
||||
|
||||
@@ -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(`<strong>(\d+)</strong><small>(\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()
|
||||
|
||||
+116
@@ -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("<p>")
|
||||
out.WriteString(markdownInline(strings.Join(paragraph, " ")))
|
||||
out.WriteString("</p>\n")
|
||||
paragraph = nil
|
||||
}
|
||||
flushList := func() {
|
||||
if len(list) == 0 {
|
||||
return
|
||||
}
|
||||
out.WriteString("<ul>\n")
|
||||
for _, item := range list {
|
||||
out.WriteString("<li>")
|
||||
out.WriteString(markdownInline(item))
|
||||
out.WriteString("</li>\n")
|
||||
}
|
||||
out.WriteString("</ul>\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("<h1>" + markdownInline(strings.TrimSpace(line[2:])) + "</h1>\n")
|
||||
case strings.HasPrefix(line, "## "):
|
||||
flushParagraph()
|
||||
flushList()
|
||||
out.WriteString("<h2>" + markdownInline(strings.TrimSpace(line[3:])) + "</h2>\n")
|
||||
case strings.HasPrefix(line, "### "):
|
||||
flushParagraph()
|
||||
flushList()
|
||||
out.WriteString("<h3>" + markdownInline(strings.TrimSpace(line[4:])) + "</h3>\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] = "<strong>" + parts[index] + "</strong>"
|
||||
}
|
||||
escaped = strings.Join(parts, "")
|
||||
|
||||
parts = strings.Split(escaped, "`")
|
||||
for index := 1; index < len(parts); index += 2 {
|
||||
parts[index] = "<code>" + parts[index] + "</code>"
|
||||
}
|
||||
return strings.Join(parts, "")
|
||||
}
|
||||
@@ -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{
|
||||
"<h1>Titel</h1>",
|
||||
"<h2>Abschnitt</h2>",
|
||||
"<ul>",
|
||||
"<li><strong>Fett:</strong> <code>Code</code></li>",
|
||||
"<li>Zweiter Punkt</li>",
|
||||
"<p>Ein Absatz.</p>",
|
||||
} {
|
||||
if !strings.Contains(rendered, want) {
|
||||
t.Fatalf("rendered help misses %q:\n%s", want, rendered)
|
||||
}
|
||||
}
|
||||
if escaped := string(markdownToHTML("<script>alert(1)</script>")); strings.Contains(escaped, "<script>") {
|
||||
t.Fatalf("help renderer did not escape HTML: %s", escaped)
|
||||
}
|
||||
}
|
||||
|
||||
func TestStatisticsHelpPage(t *testing.T) {
|
||||
ts, _ := newTestServer(t)
|
||||
client := newClient(t)
|
||||
login(t, client, ts.URL, "editor", "editor123")
|
||||
|
||||
body := get(t, client, ts.URL+"/help/statistics?start=2026-03-01&end=2026-03-31", http.StatusOK)
|
||||
for _, want := range []string{"Statistik verstehen", "<h2>Grundbegriffe</h2>", "Besetzungsquote", "/statistics?start=2026-03-01"} {
|
||||
if !strings.Contains(body, want) {
|
||||
t.Fatalf("statistics help page misses %q", want)
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -416,6 +416,7 @@ var iconPaths = map[string]string{
|
||||
"external": `<path d="M14 3h7v7M10 14L21 3M21 14v7H3V3h7"/>`,
|
||||
"menu": `<path d="M4 7h16M4 12h16M4 17h16"/>`,
|
||||
"close": `<path d="M6 6l12 12M18 6L6 18"/>`,
|
||||
"help": `<circle cx="12" cy="12" r="9"/><path d="M9.5 9a2.5 2.5 0 1 1 4.2 1.8c-.9.8-1.7 1.4-1.7 2.7"/><path d="M12 17h.01"/>`,
|
||||
}
|
||||
|
||||
func iconSVG(name string) template.HTML {
|
||||
|
||||
+2
-1
@@ -68,7 +68,7 @@ func New(st *store.Store, opts Options) (*Server, error) {
|
||||
"login", "plan", "service", "services", "team", "person", "statistics",
|
||||
"exchange", "settings", "liturgy", "dispatch", "guest", "admin_tenants", "admin_users",
|
||||
"admin_churches", "password", "unlock", "error", "no_tenant",
|
||||
"swap_request", "swap_detail",
|
||||
"swap_request", "swap_detail", "help",
|
||||
}
|
||||
views := make(map[string]*template.Template, len(names))
|
||||
for _, name := range names {
|
||||
@@ -170,6 +170,7 @@ func (s *Server) Handler() http.Handler {
|
||||
mux.HandleFunc("POST /swap/{token}/respond", s.auth(s.handleSwapRespond))
|
||||
|
||||
mux.HandleFunc("GET /statistics", s.auth(s.handleStatistics))
|
||||
mux.HandleFunc("GET /help/statistics", s.auth(s.handleStatisticsHelp))
|
||||
mux.HandleFunc("GET /exchange", s.auth(s.handleExchange))
|
||||
mux.HandleFunc("GET /exchange/export", s.auth(s.handleExport))
|
||||
mux.HandleFunc("POST /exchange/import", s.editor(s.handleImport))
|
||||
|
||||
@@ -837,6 +837,7 @@ hr { border: 0; border-top: 1px solid var(--line); margin: 1rem 0; }
|
||||
border-left: 2px solid var(--line-soft); background: var(--card-alt); border-radius: 0 5px 5px 0;
|
||||
}
|
||||
.dispatch-actions { gap: .5rem; flex-wrap: wrap; }
|
||||
.dispatch-duplex { margin-right: auto; align-self: center; font-size: .8rem; }
|
||||
.dispatch-last-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 1rem; margin-bottom: .9rem; }
|
||||
.dispatch-last-grid div { display: flex; flex-direction: column; gap: .1rem; }
|
||||
.dispatch-last-grid strong { font-family: var(--serif); font-size: 1rem; }
|
||||
@@ -1057,3 +1058,18 @@ hr { border: 0; border-top: 1px solid var(--line); margin: 1rem 0; }
|
||||
.beyond-prompt { flex-direction: column; align-items: flex-start; }
|
||||
.service-delete { opacity: 1; }
|
||||
}
|
||||
|
||||
/* Help documents --------------------------------------------------------- */
|
||||
.help-card { padding: 1.4rem 1.6rem; }
|
||||
.help-doc { max-width: 78ch; }
|
||||
.help-doc h1 { font-family: var(--serif); font-size: 1.45rem; margin: 0 0 .8rem; }
|
||||
.help-doc h2 { font-family: var(--serif); font-size: 1.15rem; margin: 1.5rem 0 .55rem; }
|
||||
.help-doc h3 { font-size: .92rem; margin: 1.15rem 0 .4rem; color: var(--ink, #222); }
|
||||
.help-doc p { margin: 0 0 .7rem; line-height: 1.6; color: var(--ink-soft, #5f5a52); }
|
||||
.help-doc ul { margin: 0 0 .9rem; padding-left: 1.15rem; }
|
||||
.help-doc li { margin: .28rem 0; line-height: 1.55; color: var(--ink-soft, #5f5a52); }
|
||||
.help-doc strong { color: var(--ink, #222); }
|
||||
.help-doc code {
|
||||
font-size: .85em; padding: .08rem .3rem; border-radius: 4px;
|
||||
background: color-mix(in srgb, var(--line, #ddd) 45%, transparent);
|
||||
}
|
||||
@@ -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.
|
||||
@@ -103,7 +103,10 @@ func (s *Server) handleStatistics(w http.ResponseWriter, r *http.Request, user *
|
||||
minAssignments, maxAssignments := 0, 0
|
||||
first := true
|
||||
for _, stat := range stats.PersonStats {
|
||||
if !stat.Person.Active {
|
||||
// Fairness describes the distribution among people who actually served
|
||||
// in the period. Team members without an assignment are not part of
|
||||
// this comparison.
|
||||
if stat.Total == 0 {
|
||||
continue
|
||||
}
|
||||
if first || stat.Total < minAssignments {
|
||||
|
||||
@@ -177,8 +177,12 @@
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<p class="table-note">E-Mail-Empfänger erhalten den Plan als PDF-Anhang und zusätzlich eine Kalenderdatei (.ics) mit ihren eigenen Einsätzen zum Import in gängige Kalender-Apps. Über das Kalender-Symbol in der Spalte „Text / Kalender“ lässt sich die persönliche .ics-Datei auch einzeln herunterladen. Personen ohne Adresse oder mit der Auswahl „Ausdruck“ werden in einem sammelbaren PDF zusammengefasst – nacheinander mit Vorblatt und gewählter Liste. In der Spalte „Text“ kopiert das erste Symbol das persönliche Anschreiben; ohne SMTP öffnet das zweite Symbol einen fertigen Entwurf im eigenen E-Mail-Programm.{{if not .Data.CanManageSecrets}} Empfängeradressen und SMTP-Zugangsdaten sind für dieses Konto gesperrt und werden von Redakteuren verwaltet.{{end}}</p>
|
||||
<p class="table-note">E-Mail-Empfänger erhalten den Plan als PDF-Anhang und zusätzlich eine Kalenderdatei (.ics) mit ihren eigenen Einsätzen zum Import in gängige Kalender-Apps. Über das Kalender-Symbol in der Spalte „Text / Kalender“ lässt sich die persönliche .ics-Datei auch einzeln herunterladen. Personen ohne Adresse oder mit der Auswahl „Ausdruck“ werden in einem sammelbaren PDF zusammengefasst – nacheinander mit Vorblatt und gewählter Liste. Die Option „Für doppelseitigen Druck optimieren“ hängt an jedes Vorblatt und jede Liste bei Bedarf eine leere Seite an, damit beide auf der Vorderseite eines Blattes beginnen. In der Spalte „Text“ kopiert das erste Symbol das persönliche Anschreiben; ohne SMTP öffnet das zweite Symbol einen fertigen Entwurf im eigenen E-Mail-Programm.{{if not .Data.CanManageSecrets}} Empfängeradressen und SMTP-Zugangsdaten sind für dieses Konto gesperrt und werden von Redakteuren verwaltet.{{end}}</p>
|
||||
<div class="card-foot dispatch-actions">
|
||||
<label class="check dispatch-duplex" title="Hängt an jedes Vorblatt und jede Gottesdienstliste bei Bedarf eine leere Seite an, damit beim doppelseitigen Druck jedes Dokument auf der Vorderseite beginnt.">
|
||||
<input type="checkbox" name="duplex" value="1" checked>
|
||||
<span>Für doppelseitigen Druck optimieren</span>
|
||||
</label>
|
||||
<button class="btn btn-secondary" type="submit">{{icon "check"}} Auswahl speichern</button>
|
||||
{{if .Data.SMTPConfigured}}
|
||||
<button class="btn btn-primary" type="submit" formaction="/dispatch/send" data-confirm="Die E-Mails jetzt an alle ausgewählten Empfänger senden?">{{icon "send"}} E-Mails senden</button>
|
||||
|
||||
@@ -39,7 +39,7 @@
|
||||
|
||||
<section class="stat-strip three">
|
||||
<article class="mini-stat"><span class="mini-stat-label">Gottesdienste</span><strong>{{.Data.ServiceCount}}</strong><small>im gewählten Zeitraum</small></article>
|
||||
<article class="mini-stat {{if gt .Data.OpenSlots 0}}warn{{end}}"><span class="mini-stat-label">Offene Dienste</span><strong>{{.Data.OpenSlots}}</strong><small>{{plural .Data.OpenSlots "Dienst" "Dienste"}}</small></article>
|
||||
<article class="mini-stat {{if gt .Data.OpenSlots 0}}warn{{end}}"><span class="mini-stat-label">Offene Dienste</span><strong>{{.Data.OpenSlots}}</strong><small>{{if eq .Data.OpenSlots 1}}Dienst{{else}}Dienste{{end}}</small></article>
|
||||
<article class="mini-stat"><span class="mini-stat-label">Kirchen</span><strong>{{len .Data.Churches}}</strong><small>im öffentlichen Plan</small></article>
|
||||
</section>
|
||||
|
||||
@@ -161,9 +161,9 @@
|
||||
</span>
|
||||
<span class="day-status">
|
||||
{{if $row.HasServices}}
|
||||
<span>{{len $row.Services}} {{plural (len $row.Services) "Gottesdienst" "Gottesdienste"}}</span>
|
||||
<span>{{plural (len $row.Services) "Gottesdienst" "Gottesdienste"}}</span>
|
||||
{{if gt $row.OpenSlots 0}}
|
||||
<span class="day-status-open">{{$row.OpenSlots}} {{plural $row.OpenSlots "Dienst offen" "Dienste offen"}}</span>
|
||||
<span class="day-status-open">{{plural $row.OpenSlots "Dienst offen" "Dienste offen"}}</span>
|
||||
{{else}}
|
||||
<span class="day-status-ok">vollständig besetzt</span>
|
||||
{{end}}
|
||||
|
||||
@@ -0,0 +1,18 @@
|
||||
{{define "content"}}
|
||||
<div class="page-stack">
|
||||
<section class="range-banner">
|
||||
<div>
|
||||
<span class="eyebrow">Hilfe</span>
|
||||
<h2>Begriffe und Berechnungen</h2>
|
||||
<p>Alle Kennzahlen der Statistikseite im Überblick – mit Berechnungsgrundlage und Hinweisen zur Interpretation.</p>
|
||||
</div>
|
||||
<div class="range-actions">
|
||||
<a class="btn btn-ghost btn-small" href="/statistics?start={{.Data.Start}}&end={{.Data.End}}">{{icon "chart"}} Zur Statistik</a>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="card help-card">
|
||||
<div class="help-doc">{{.Data.HTML}}</div>
|
||||
</section>
|
||||
</div>
|
||||
{{end}}
|
||||
@@ -124,7 +124,7 @@
|
||||
<article class="mini-stat {{if gt .Data.Stats.OpenSlots 0}}warn{{end}}">
|
||||
<span class="mini-stat-label">Offen</span>
|
||||
<strong>{{.Data.Stats.OpenSlots}}</strong>
|
||||
<small>{{plural .Data.Stats.OpenSlots "Dienst" "Dienste"}}</small>
|
||||
<small>{{if eq .Data.Stats.OpenSlots 1}}Dienst{{else}}Dienste{{end}}</small>
|
||||
</article>
|
||||
<article class="mini-stat">
|
||||
<span class="mini-stat-label">Aktive Personen</span>
|
||||
@@ -278,9 +278,9 @@
|
||||
{{end}}
|
||||
<span class="day-status">
|
||||
{{if $row.HasServices}}
|
||||
<span>{{len $row.Services}} {{plural (len $row.Services) "Gottesdienst" "Gottesdienste"}}</span>
|
||||
<span>{{plural (len $row.Services) "Gottesdienst" "Gottesdienste"}}</span>
|
||||
{{if gt $row.OpenSlots 0}}
|
||||
<span class="day-status-open">{{$row.OpenSlots}} {{plural $row.OpenSlots "Dienst offen" "Dienste offen"}}</span>
|
||||
<span class="day-status-open">{{plural $row.OpenSlots "Dienst offen" "Dienste offen"}}</span>
|
||||
{{else}}
|
||||
<span class="day-status-ok">vollständig besetzt</span>
|
||||
{{end}}
|
||||
|
||||
@@ -22,9 +22,10 @@
|
||||
<div>
|
||||
<span class="eyebrow">Auswertung</span>
|
||||
<h2>{{rangeLong .Data.Stats.Range}}</h2>
|
||||
<p>{{dayCount .Data.Stats.Range}} Tage · {{.Data.Stats.ServiceCount}} Gottesdienste · {{.Data.Stats.ActivePeople}} aktive Personen</p>
|
||||
<p>{{dayCount .Data.Stats.Range}} Tage · {{.Data.Stats.ServiceCount}} Gottesdienste · {{.Data.Stats.ActivePeople}} eingesetzte Personen</p>
|
||||
</div>
|
||||
<div class="range-actions">
|
||||
<a class="btn btn-ghost btn-small" href="/help/statistics?start={{.Data.Start}}&end={{.Data.End}}">{{icon "help"}} Hilfe</a>
|
||||
<a class="btn btn-ghost btn-small" href="/plan?start={{.Data.Start}}&end={{.Data.End}}">{{icon "calendar"}} Zum Plan</a>
|
||||
<a class="btn btn-secondary btn-small" href="/pdf?variant=plan&start={{.Data.Start}}&end={{.Data.End}}" target="_blank" rel="noopener">{{icon "printer"}} PDF öffnen</a>
|
||||
</div>
|
||||
@@ -33,7 +34,7 @@
|
||||
<section class="stat-strip">
|
||||
<article class="mini-stat"><span class="mini-stat-label">Besetzungsquote</span><strong>{{percent .Data.Stats.CoverageRate}}</strong><small>{{.Data.Stats.AssignmentCount}} von {{.Data.Stats.RequiredSlots}} Diensten</small></article>
|
||||
<article class="mini-stat {{if gt .Data.Stats.OpenSlots 0}}warn{{end}}"><span class="mini-stat-label">Offene Dienste</span><strong>{{.Data.Stats.OpenSlots}}</strong><small>über alle Kirchen</small></article>
|
||||
<article class="mini-stat"><span class="mini-stat-label">Durchschnitt</span><strong>{{.Data.Average}}</strong><small>Einsätze je aktiver Person</small></article>
|
||||
<article class="mini-stat"><span class="mini-stat-label">Durchschnitt</span><strong>{{.Data.Average}}</strong><small>Einsätze je eingesetzter Person</small></article>
|
||||
<article class="mini-stat"><span class="mini-stat-label">Präferenztreffer</span><strong>{{preferencePct .Data.Stats}}</strong><small>{{.Data.Stats.PreferenceHits}} von {{.Data.Stats.PreferenceEligible}} bewertbaren Einsätzen</small></article>
|
||||
<article class="mini-stat"><span class="mini-stat-label">Abwesenheitstage</span><strong>{{.Data.Stats.AbsenceDays}}</strong><small>im gewählten Zeitraum</small></article>
|
||||
</section>
|
||||
@@ -60,14 +61,14 @@
|
||||
<div><span>Spannweite</span><strong>{{.Data.Span}}</strong></div>
|
||||
<div><span>Durchschnitt</span><strong>{{.Data.Average}}</strong></div>
|
||||
</div>
|
||||
<p class="empty-note">Die Spannweite zeigt, wie gleichmäßig die Einsätze auf aktive Personen verteilt sind. Präferenzen und Monatslimits können bewusst Abweichungen erzeugen.</p>
|
||||
<p class="empty-note">Die Spannweite zeigt, wie gleichmäßig die Einsätze auf die eingesetzten Personen verteilt sind. Präferenzen und Monatslimits können bewusst Abweichungen erzeugen.</p>
|
||||
</section>
|
||||
|
||||
<section class="card span-2">
|
||||
<div class="card-head"><div><span class="eyebrow">Einsatzhäufigkeit</span><h3>Personen</h3></div><span class="count-pill">{{len .Data.Stats.PersonStats}}</span></div>
|
||||
<div class="table-scroll">
|
||||
<table class="data-table compact-table">
|
||||
<thead><tr><th>Person</th><th>Gesamt</th><th>Lektor</th><th>Helfer</th><th>Sonntage</th><th>Präferenz</th><th>Verteilung</th></tr></thead>
|
||||
<thead><tr><th>Person</th><th>Gesamt</th><th>Lektor</th><th>Helfer</th><th>Sonntags-Einsätze</th><th>Präferenz</th><th>Verteilung</th></tr></thead>
|
||||
<tbody>
|
||||
{{range .Data.Stats.PersonStats}}
|
||||
<tr class="{{if not .Person.Active}}muted-row{{end}}">
|
||||
@@ -76,7 +77,7 @@
|
||||
<td>{{.Lectors}}</td>
|
||||
<td>{{.Helpers}}</td>
|
||||
<td>{{.SundayCount}}</td>
|
||||
<td>{{percent .PreferenceRate}}</td>
|
||||
<td>{{if .Person.HasPreference}}{{percent .PreferenceRate}}{{else}}—{{end}}</td>
|
||||
<td class="bar-cell"><div class="inline-bar"><span style="width:{{percentage (ratio .Total $.Data.MaxAssignments)}}"></span></div></td>
|
||||
</tr>
|
||||
{{else}}
|
||||
@@ -109,7 +110,7 @@
|
||||
<div class="card-head"><div><span class="eyebrow">Sonntage</span><h3>Sonntagsdienste</h3></div></div>
|
||||
<div class="big-number-block">
|
||||
<strong>{{.Data.Stats.SundayFilled}}</strong>
|
||||
<span>besetzte Dienste</span>
|
||||
<span>besetzte Dienstplätze</span>
|
||||
<small>bei {{.Data.Stats.SundayServiceCount}} Sonntagsgottesdiensten</small>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
Reference in new issue
Block a user