#126 [FR] : IHKForm.java

Formulaire Wicket pour l'interface utilisateur du plugin IHK — fournit le sélecteur de semaine, l'éditeur de configuration et le déclencheur d'exportation. Étend AbstractStandardForm<Object, IHKPage> — la classe de base des formulaires Wicket de ProjectForge avec une mise en page Bootstrap en grille. 248 lignes de Java.

Contrôles du formulaire

• Sélecteur de semaine (QuickSelectWeekPanel) — widget calendrier pour choisir la semaine du rapport. Inclut la navigation semaine précédente/suivante et un bouton de sélection rapide "cette semaine"
• Affichage des dates de début/fin (LocalDatePanel + LocalDateModel) — affiche le lundi et le vendredi de la semaine sélectionnée sous forme de champs en lecture seule
• Section de configuration — champs modifiables pour :
  • ausbildungsbeginn — date de début d'apprentissage (avec sélecteur de date)
  • ausbildungsjahr — année de formation (saisie numérique, valeur par défaut -1)
  • teamname — nom de l'équipe/département (saisie texte)
  Lié à IHKCommentObject via PropertyModel de Wicket
• Bouton d'exportation (SingleButtonPanel avec SubmitLink) — déclenche IHKExporter.export() et diffuse le fichier Excel en téléchargement HTTP
• Bouton de sauvegarde de la configuration — sérialise IHKCommentObject en JSON et l'écrit dans le champ de commentaire du carnet d'adresses (AddressDO.comment) via AddressDao

Flux de chargement des données

1. Lors de l'initialisation du formulaire, lit ThreadLocalUserContext.getLoggedInUser()
2. Interroge AddressDao pour trouver l'entrée correspondante dans le carnet d'adresses (correspondance par prénom/nom)
3. Si trouvé et que le champ de commentaire contient du JSON, désérialise IHKCommentObject via JsonUtils.fromJson()
4. Détecte automatiquement si l'apprenti n'a pas encore de configuration — affiche une invite de configuration

Mise en page Wicket

Utilise le package flowlayout de ProjectForge pour une mise en page de formulaire basée sur la grille Bootstrap :

• FieldsetPanel — regroupe les champs associés avec un titre
• DivPanel / DivTextPanel — conteneurs de grille Bootstrap
• GridSize.COL50 / COL100 — largeurs de colonnes responsives
• WicketUtils.getImageIcon() — icônes pour les boutons (téléchargement, sauvegarde)
• CSSColor — constantes de style pour les messages d'information/avertissement

Validation

• ausbildungsbeginn doit être une date valide — lève une UserException avec un message localisé si absent ou invalide
• Nécessite que le prénom/nom de l'apprenti corresponde à son enregistrement AddressDO — si aucune correspondance trouvée, affiche un avertissement

Cycle de requête

Soumission du formulaire Wicket → onSubmit() → appelle IHKExporter.export() → retourne byte[] → encapsulé dans IResourceStream → déclenche le téléchargement par le navigateur de Berichtsheft_KW{week}_{Name}.xlsx.