#126: IHKForm.java

Wicket-Formular für die IHK-Plugin-Oberfläche — bietet den Wochenauswähler, Konfigurationseditor und Export-Trigger. Erweitert AbstractStandardForm<Object, IHKPage> — ProjectForge's Wicket-Formular-Basisklasse mit Bootstrap-Grid-Layout. 248 Zeilen Java.

Formularsteuerelemente

• Wochenauswähler (QuickSelectWeekPanel) — Kalender-Widget zur Auswahl der Berichtswoche. Beinhaltet Vorherige/Nächste-Woche-Navigation und „Diese Woche“-Schnellauswahl-Button
• Start-/Enddatum-Anzeige (LocalDatePanel + LocalDateModel) — zeigt den Montag und Freitag der ausgewählten Woche als schreibgeschützte Felder an
• Konfigurationsbereich — bearbeitbare Felder für:
  • ausbildungsbeginn — Ausbildungsstartdatum (mit Datumsauswahl)
  • ausbildungsjahr — Ausbildungsjahr-Überschreibung (numerische Eingabe, Standard -1)
  • teamname — Team-/Abteilungsname (Texteingabe)
  Gebunden an IHKCommentObject über Wickets PropertyModel
• Export-Button (SingleButtonPanel mit SubmitLink) — löst IHKExporter.export() aus und streamt die Excel-Datei als HTTP-Download
• Konfiguration speichern-Button — serialisiert IHKCommentObject zurück zu JSON und schreibt es in das Adressbuch-Kommentarfeld (AddressDO.comment) über AddressDao

Datenladeprozess

1. Bei Formularinitialisierung wird ThreadLocalUserContext.getLoggedInUser() ausgelesen
2. Fragt AddressDao ab, um den passenden Adressbucheintrag zu finden (Abgleich nach Vor-/Nachname)
3. Wenn gefunden und das Kommentarfeld JSON enthält, wird IHKCommentObject über JsonUtils.fromJson() deserialisiert
4. Erkennt automatisch, ob der Auszubildende noch keine Konfiguration hat — zeigt Einrichtungsaufforderung an

Wicket-Layout

Verwendet ProjectForge's flowlayout-Paket für Bootstrap-Grid-basiertes Formular-Layout:

• FieldsetPanel — gruppiert verwandte Felder mit einer Überschrift
• DivPanel / DivTextPanel — Bootstrap-Grid-Container
• GridSize.COL50 / COL100 — responsive Spaltenbreiten
• WicketUtils.getImageIcon() — Symbole für Buttons (Download, Speichern)
• CSSColor — Styling-Konstanten für Info-/Warnmeldungen

Validierung

• ausbildungsbeginn muss ein gültiges Datum sein — wirft UserException mit lokalisierter Nachricht, falls fehlend oder ungültig
• Erfordert, dass Vor- und Nachname des Auszubildenden mit dem AddressDO-Datensatz übereinstimmen — wenn keine Übereinstimmung gefunden wird, wird eine Warnung angezeigt

Request-Zyklus

Wicket-Formular absenden → onSubmit() → ruft IHKExporter.export() auf → gibt byte[] zurück → verpackt in IResourceStream → löst Browser-Download von Berichtsheft_KW{week}_{Name}.xlsx aus.