#300: ProjectForgeApplication.java

Единственная точка входа для всего сервера ProjectForge. Запуск с помощью ./gradlew bootRun или java -jar projectforge-application.jar. Аннотирован @SpringBootApplication (включает автоматическую настройку, сканирование компонентов и автоконфигурацию) и @ServletComponentScan (обнаруживает аннотации @WebFilter/@WebServlet для сервлетов Wicket и REST). Расширяет SpringBootServletInitializer для поддержки традиционного WAR-развертывания.

1. Разбор аргументов: Пользовательские аргументы извлекаются до того, как Spring Boot их обработает. --base-dir=/path устанавливает рабочую директорию (логи, конфигурация, временные файлы). --time-zone=Europe/Berlin устанавливает TimeZone.setDefault(). Неизвестные аргументы передаются в Spring Boot для стандартной обработки (порт, профили и т.д.).

2. Определение базовой директории (порядок приоритета):
① аргумент CLI --base-dir → ② системное свойство projectforge.base-dir → ③ переменная окружения PROJECTFORGE_BASE_DIR → ④ ~/.projectforge (по умолчанию)

3. Инициализация директорий: Создаёт поддиректории logs/, temp/ и fonts/ внутри базовой директории. Записывает текущий PID процесса в temp/projectforge.pid для мониторинга и скриптов завершения.

4. Настройка часового пояса: Устанавливает TimeZone.setDefault() в соответствии с настроенным значением (по умолчанию: UTC). Это критически важно — все серверные расчёты дат используют этот часовой пояс. Интерфейс может отображать даты в локальном часовом поясе пользователя, но сервер работает в едином согласованном поясе.

5. Баннер версии: Читает META-INF/projectforge-version.properties (сгенерированный Gradle) и логирует версию, временную метку сборки и хэш коммита git.

6. Запуск Spring Boot: Вызывает SpringApplication.run() с полностью настроенным контекстом приложения.

Конфликт портов: Перехватывает ConnectorStartFailedException — если порт 8080 уже занят, считывает существующий PID из temp/projectforge.pid и выводит понятное сообщение: «Порт 8080 уже используется процессом PID=XXXXX». Не выполняет повторные попытки и не переключает порты автоматически — администратор должен разрешить конфликт вручную.

Корректное завершение: Регистрирует хук завершения через SecurityShutdown, который очищает конфиденциальные данные (пароли, токены, ключи шифрования) из памяти при завершении JVM. Это мера защиты на случай дампа кучи JVM после завершения — конфиденциальные данные должны быть обнулены.

ProjectForgeApplication extends SpringBootServletInitializer — это позволяет развёртывать приложение как традиционный WAR-файл в контейнере сервлетов (Tomcat, Jetty) в дополнение к режиму встроенного сервера. Метод configure() переопределён для установки источников на ProjectForgeApplication.class, сообщая контейнеру сервлетов, какой класс конфигурации Spring загружать.

Аннотация @ServletComponentScan необходима для совместимости с Wicket — Wicket регистрирует свой фильтр через аннотацию @WebFilter, а не через FilterRegistrationBean от Spring Boot, и без @ServletComponentScan фильтр Wicket никогда не был бы обнаружен.