#126: IHKForm.java

Formulario Wicket para la interfaz de usuario del plugin IHK — proporciona el selector de semana, el editor de configuración y el disparador de exportación. Extiende AbstractStandardForm<Object, IHKPage> — la clase base de formularios Wicket de ProjectForge con diseño de cuadrícula Bootstrap. 248 líneas de Java.

Controles del formulario

• Selector de semana (QuickSelectWeekPanel) — widget de calendario para elegir la semana del informe. Incluye navegación de semana anterior/siguiente y botón de selección rápida "esta semana"
• Visualización de fecha inicio/fin (LocalDatePanel + LocalDateModel) — muestra el lunes y viernes de la semana seleccionada como campos de solo lectura
• Sección de configuración — campos editables para:
  • ausbildungsbeginn — fecha de inicio del aprendizaje (con selector de fecha)
  • ausbildungsjahr — anulación del año de formación (entrada numérica, valor predeterminado -1)
  • teamname — nombre del equipo/departamento (entrada de texto)
  Vinculado a IHKCommentObject a través de PropertyModel de Wicket
• Botón de exportación (SingleButtonPanel con SubmitLink) — activa IHKExporter.export() y transmite el archivo Excel como descarga HTTP
• Botón de guardar configuración — serializa IHKCommentObject de vuelta a JSON y lo escribe en el campo de comentario de la libreta de direcciones (AddressDO.comment) a través de AddressDao

Flujo de carga de datos

1. Al inicializar el formulario, lee ThreadLocalUserContext.getLoggedInUser()
2. Consulta AddressDao para encontrar la entrada correspondiente en la libreta de direcciones (coincidencia por nombre/apellido)
3. Si se encuentra y el campo de comentario contiene JSON, deserializa IHKCommentObject mediante JsonUtils.fromJson()
4. Detecta automáticamente si el aprendiz aún no tiene configuración — muestra un aviso de configuración

Diseño Wicket

Utiliza el paquete flowlayout de ProjectForge para el diseño de formularios basado en cuadrícula Bootstrap:

• FieldsetPanel — agrupa campos relacionados con un encabezado
• DivPanel / DivTextPanel — contenedores de cuadrícula Bootstrap
• GridSize.COL50 / COL100 — anchos de columna responsivos
• WicketUtils.getImageIcon() — iconos para botones (descarga, guardar)
• CSSColor — constantes de estilo para mensajes de información/advertencia

Validación

• ausbildungsbeginn debe ser una fecha válida — lanza UserException con mensaje localizado si falta o es inválida
• Requiere que el nombre/apellido del aprendiz coincida con su registro AddressDO — si no se encuentra coincidencia, muestra una advertencia

Ciclo de solicitud

Envío del formulario Wicket → onSubmit() → llama a IHKExporter.export() → devuelve byte[] → envuelve en IResourceStream → activa la descarga en el navegador de Berichtsheft_KW{week}_{Name}.xlsx.