#300: ProjectForgeApplication.java

El punto de entrada único para todo el servidor ProjectForge. Ejecutar con ./gradlew bootRun o java -jar projectforge-application.jar. Anotado con @SpringBootApplication (habilita la auto-configuración, el escaneo de componentes y la auto-configuración) y @ServletComponentScan (descubre anotaciones @WebFilter/@WebServlet para servlets Wicket y REST). Extiende SpringBootServletInitializer para soporte de despliegue WAR tradicional.

1. Análisis de argumentos: Los argumentos personalizados se extraen antes de que Spring Boot los procese. --base-dir=/ruta establece el directorio de trabajo (logs, configuración, archivos temporales). --time-zone=Europe/Berlin establece TimeZone.setDefault(). Los argumentos desconocidos se pasan a Spring Boot para su manejo estándar (puerto, perfiles, etc.).

2. Resolución del directorio base (orden de prioridad):
① Argumento CLI --base-dir → ② propiedad del sistema projectforge.base-dir → ③ variable de entorno PROJECTFORGE_BASE_DIR → ④ ~/.projectforge (predeterminado)

3. Inicialización de directorios: Crea los subdirectorios logs/, temp/ y fonts/ bajo el directorio base. Escribe el PID del proceso actual en temp/projectforge.pid para monitoreo y scripts de apagado.

4. Configuración de zona horaria: Establece TimeZone.setDefault() al valor configurado (predeterminado: UTC). Esto es crítico — todos los cálculos de fecha del lado del servidor usan esta zona horaria. El frontend puede mostrar fechas en la zona horaria local del usuario, pero el servidor opera en una zona única y consistente.

5. Banner de versión: Lee META-INF/projectforge-version.properties (generado por Gradle) y registra la versión, la marca de tiempo de compilación y el hash del commit de git.

6. Inicio de Spring Boot: Llama a SpringApplication.run() con el contexto de la aplicación completamente configurado.

Conflicto de puerto: Captura ConnectorStartFailedException — si el puerto 8080 ya está en uso, lee el PID existente de temp/projectforge.pid y registra un mensaje claro: "El puerto 8080 ya está en uso por el proceso PID=XXXXX". NO reintenta ni cambia automáticamente de puerto — el administrador debe resolver el conflicto manualmente.

Apagado seguro: Registra un hook de apagado mediante SecurityShutdown que limpia datos sensibles (contraseñas, tokens, claves de cifrado) de la memoria al finalizar la JVM. Esta es una medida de defensa en profundidad — si el heap de la JVM se vuelca después del apagado, los datos sensibles deberían estar puestos a cero.

ProjectForgeApplication extends SpringBootServletInitializer — esto permite el despliegue como un archivo WAR tradicional en un contenedor de servlets (Tomcat, Jetty) además del modo de servidor embebido. El método configure() se sobrescribe para establecer las fuentes en ProjectForgeApplication.class, indicando al contenedor de servlets qué clase de configuración de Spring debe arrancar.

La anotación @ServletComponentScan es esencial para la compatibilidad con Wicket — Wicket registra su filtro mediante la anotación @WebFilter en lugar de FilterRegistrationBean de Spring Boot, y sin @ServletComponentScan el filtro de Wicket nunca sería descubierto.