Feature/ee8 ee10 split

.dockerignore

@@ -0,0 +1,47 @@
+# Version control
+.git
+.gitignore
+
+# Docker files themselves
+Dockerfile
+compose*.yml
+.dockerignore
+docker/
+
+# Build output (rebuilt inside Docker)
+**/target/
+**/*.war
+**/*.jar
+!install/*.jar
+
+# IDE and editor
+.idea/
+*.iml
+.vscode/
+*.swp
+*.swo
+
+# AI Factory
+.ai-factory/
+.claude/
+AGENTS.md
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Environment files (never bake into image)
+.env
+.env.*
+!.env.example
+
+# Test artifacts
+**/surefire-reports/
+**/failsafe-reports/
+
+# Maven wrapper (already COPY'd explicitly if needed)
+# Keep mvnw / .mvn in the image for development stage

.env.example

@@ -0,0 +1,23 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Superfly — Docker environment variables
+# Copy to .env and fill in values. Never commit .env to git.
+# ─────────────────────────────────────────────────────────────────────────────
+
+# Project name (used as Docker Compose project prefix)
+COMPOSE_PROJECT_NAME=superfly
+
+# ─── Application ─────────────────────────────────────────────────────────────
+APP_PORT=8080
+# For production: pre-built image tag
+# APP_IMAGE=registry.example.com/superfly
+# APP_VERSION=2.0.0
+
+# ─── Database ────────────────────────────────────────────────────────────────
+DB_NAME=sso
+DB_USER=sso
+DB_PASSWORD=change_me_in_production
+DB_ROOT_PASSWORD=change_root_password_in_production
+DB_TIMEZONE=UTC
+
+# Development: expose MySQL port to host
+MYSQL_HOST_PORT=3306

.gitignore

@@ -5,3 +5,20 @@ target
 .classpath
 .project
 .settings
+
+# Docker secrets — never commit
+.env
+
+# AI Factory / Claude Code — local tooling, not for repo
+.ai-factory.json
+.ai-factory/
+.claude/
+.cursor/
+.mcp.json
+skills-lock.json
+PLAN.md
+FIX_PLAN.md
+
+# IDE run configs & generated plan docs — local, not for repo
+.run/
+docs/plans/

AGENTS.md

@@ -0,0 +1,131 @@
+# AGENTS.md
+
+> Этот файл — структурная карта проекта для AI-агентов и новых разработчиков.
+> Обновлять при значительных изменениях структуры проекта.
+
+## Обзор проекта
+
+Superfly — централизованный SSO-сервер для управления пользователями, ролями и правами
+доступа в нескольких системах одновременно. Поддерживает Spring Security, Wicket-UI и
+EE8/EE10 (javax/jakarta servlet) клиентские библиотеки.
+
+## Технологический стек
+
+- **Язык:** Java 21
+- **Фреймворк:** Spring Framework 6.2.18 + Spring Security 6.4.11
+- **Веб-UI:** Apache Wicket 10.6.0
+- **База данных:** MySQL (stored procedures, jdbc-proc)
+- **Logging:** SLF4J 2.0 + Logback
+- **Сборка:** Maven (multi-module, 20 модулей)
+- **CI:** GitHub Actions
+
+## Структура проекта
+
+```
+superfly/
+├── pom.xml                        # корневой POM, версии всех зависимостей
+├── AGENTS.md                      # этот файл
+├── README.md                      # описание проекта
+├── mvnw / mvnw.cmd                # Maven wrapper
+├── .github/workflows/             # GitHub Actions CI
+│   └── maven.yml
+│
+├── superfly-remote-api/           # REST/RPC API интерфейсы для клиентов
+├── superfly-spi/                  # SPI-интерфейсы (HOTP, соль и др.)
+├── superfly-spi-support/          # Реализации SPI
+├── superfly-service/              # Бизнес-логика: пользователи, роли, права
+│   └── src/main/java/com/payneteasy/superfly/
+│       ├── dao/                   # DAO через jdbc-proc (stored procedures)
+│       ├── service/               # Spring @Service — бизнес-операции
+│       ├── model/                 # Доменные модели и UI-модели (UI* prefix)
+│       ├── password/              # Хэширование паролей
+│       ├── hotp/                  # HOTP/2FA
+│       ├── email/                 # Email-уведомления
+│       └── spring/                # Spring конфигурация, условия
+│
+├── superfly-web/                  # Веб-приложение (Wicket + Spring MVC, Jetty)
+│   └── src/main/java/com/payneteasy/superfly/web/wicket/
+│       ├── page/                  # Wicket страницы (users, roles, actions...)
+│       ├── component/             # Переиспользуемые Wicket компоненты
+│       └── security/              # Security-интеграция для веб-слоя
+│
+├── superfly-client-core/          # Клиент без servlet зависимости
+├── superfly-client-ee8/           # Клиент для javax.servlet (EE8)
+├── superfly-client-ee10/          # Клиент для jakarta.servlet (EE10)
+├── superfly-client/               # Клиент (алиас/агрегат)
+├── superfly-client-web-security/  # Web security клиент
+├── superfly-client-opt/           # Клиент с опциональными фичами
+│
+├── superfly-spring-security-core/ # Spring Security integration (core, без servlet)
+├── superfly-spring-security-ee8/  # Spring Security для EE8 (javax.servlet)
+├── superfly-spring-security/      # Spring Security для EE10 (jakarta.servlet)
+│
+├── superfly-wicket/               # Wicket компоненты (EE10)
+├── superfly-wicket-ee8/           # Wicket компоненты (EE8)
+│
+├── superfly-common/               # Shared utilities
+├── superfly-crypto/               # Шифрование, хэширование
+├── superfly-httpclient-hc5/       # HTTP client (Apache HC5) + SSL/mTLS хелперы
+│
+├── superfly-sql/                  # SQL-скрипты и миграции
+│   ├── src/                       # Stored procedures
+│   └── mi/                        # Миграции: R<version>/<desc>.sql
+│
+├── superfly-integration-test/     # Интеграционные тесты (против реальной MySQL)
+└── superfly-demo/                 # Демо-приложение
+```
+
+## Ключевые точки входа
+
+| Файл | Назначение |
+|------|-----------|
+| `pom.xml` | Корневой POM, версии зависимостей (`spring.version`, `wicket.version` и др.) |
+| `superfly-web/src/main/webapp/WEB-INF/jetty-web.xml` | Конфигурация Jetty |
+| `superfly-web/src/main/resources/jetty-env.conf` | Переменные окружения Jetty |
+| `superfly-service/src/main/java/.../spring/` | Spring Application Context конфигурации |
+| `superfly-sql/mi/` | SQL-миграции базы данных |
+| `.github/workflows/maven.yml` | CI pipeline |
+
+## Документация
+
+| Документ | Путь | Описание |
+|----------|------|---------|
+| README | README.md | Landing page проекта |
+| Установка и запуск | docs/getting-started.md | Требования, сборка, первый запуск |
+| Конфигурация | docs/configuration.md | БД, Jetty, Spring конфиги |
+| Доменная модель | docs/domain-model.md | Сущности, связи, перечисления |
+| API Reference | docs/api.md | RPC и REST endpoints |
+| Руководство по интеграции | docs/integration-guide.md | Подключение клиентских приложений |
+| Миграция EE8 / EE10 | docs/migration-client-ee8-ee10.md | Переход на раздельные модули |
+| Выпуск релиза | docs/releasing.md | Публикация в Maven Central |
+
+## AI Context файлы
+
+| Файл | Назначение |
+|------|-----------|
+| AGENTS.md | Карта проекта для AI-агентов |
+| .ai-factory/DESCRIPTION.md | Детальное описание стека и модулей |
+| .ai-factory/ARCHITECTURE.md | Clean Architecture: слои, правила зависимостей, примеры кода |
+| .ai-factory/rules/base.md | Кодовые конвенции проекта |
+| .ai-factory/config.yaml | Настройки AI Factory |
+
+## Docker
+
+| Файл | Назначение |
+|------|-----------|
+| `Dockerfile` | Multi-stage: builder → production (Jetty 12) + development (mvn jetty:run) |
+| `compose.yml` | База: app + MySQL 8.0 |
+| `compose.override.yml` | Dev-оверрайды: source mount, Maven hot-reload |
+| `compose.production.yml` | Hardened production: read_only, cap_drop, resource limits |
+| `docker/jetty/ROOT.xml` | Jetty context descriptor с JNDI datasource (env vars) |
+| `docker/jetty/entrypoint.sh` | Передаёт DB-параметры как Java system properties |
+| `.env.example` | Шаблон переменных окружения |
+
+## Правила для агентов
+
+- Команды git выполнять по одной — не объединять в цепочку:
+  - Неправильно: `git checkout master && git pull`
+  - Правильно: сначала `git checkout master`, затем `git pull origin master`
+- Не мешать javax.servlet и jakarta.servlet в одном модуле — см. EE8/EE10 разделение
+- Интеграционные тесты требуют реальный MySQL — не заменять на H2/mock
+- Слой данных — только stored procedures через jdbc-proc, без JPA/Hibernate

Dockerfile

@@ -0,0 +1,94 @@
+# syntax=docker/dockerfile:1
+# ─────────────────────────────────────────────────────────────────────────────
+# Stage 1: Build WAR and collect runtime JARs
+# ─────────────────────────────────────────────────────────────────────────────
+FROM maven:3.9-eclipse-temurin-21-alpine AS builder
+WORKDIR /build
+
+# Prefetch dependencies separately so this layer is cached
+COPY pom.xml ./
+COPY */pom.xml ./
+# Hack: copy individual module poms while preserving directory structure
+RUN --mount=type=cache,target=/root/.m2 \
+    find . -name "pom.xml" -exec dirname {} \; | xargs -I{} mkdir -p {} 2>/dev/null; true
+
+COPY . .
+
+# Build WAR (skip tests; tests require a live MySQL)
+RUN --mount=type=cache,target=/root/.m2 \
+    ./mvnw -B -DskipTests -pl superfly-web -am package
+
+# Download JARs that are test-scoped but required at Jetty runtime
+RUN --mount=type=cache,target=/root/.m2 \
+    ./mvnw -B dependency:copy \
+      -Dartifact=com.mysql:mysql-connector-j:8.2.0:jar \
+      -DoutputDirectory=/build/jetty-lib && \
+    ./mvnw -B dependency:copy \
+      -Dartifact=org.apache.commons:commons-dbcp2:2.13.0:jar \
+      -DoutputDirectory=/build/jetty-lib && \
+    ./mvnw -B dependency:copy \
+      -Dartifact=org.apache.commons:commons-pool2:2.12.0:jar \
+      -DoutputDirectory=/build/jetty-lib
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Stage 2: Production image — Jetty 12 + WAR + JNDI datasource from env vars
+# ─────────────────────────────────────────────────────────────────────────────
+FROM eclipse-temurin:21-jre-alpine AS production
+
+ARG JETTY_VERSION=12.0.32
+ENV JETTY_HOME=/opt/jetty
+ENV JETTY_BASE=/var/lib/jetty
+ENV JETTY_PORT=8080
+
+# Install Jetty standalone
+RUN apk add --no-cache curl gettext && \
+    curl -fsSL "https://repo1.maven.org/maven2/org/eclipse/jetty/jetty-home/${JETTY_VERSION}/jetty-home-${JETTY_VERSION}.tar.gz" \
+    | tar xz -C /opt && \
+    mv /opt/jetty-home-${JETTY_VERSION} ${JETTY_HOME}
+
+# Set up Jetty base with required modules
+RUN mkdir -p ${JETTY_BASE}/webapps ${JETTY_BASE}/lib/ext && \
+    cd ${JETTY_BASE} && \
+    java -jar ${JETTY_HOME}/start.jar \
+      --add-modules=server,http,deploy,webapp,jndi,plus,annotations,logging-jetty
+
+# Copy WAR and extra JARs
+COPY --from=builder /build/superfly-web/target/superfly.war ${JETTY_BASE}/webapps/ROOT.war
+COPY --from=builder /build/jetty-lib/ ${JETTY_BASE}/lib/ext/
+
+# Copy context descriptor and entrypoint
+COPY docker/jetty/ROOT.xml ${JETTY_BASE}/webapps/ROOT.xml
+COPY docker/jetty/entrypoint.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
+
+# Non-root user
+RUN addgroup -S jetty && adduser -S jetty -G jetty && \
+    chown -R jetty:jetty ${JETTY_BASE}
+USER jetty
+
+EXPOSE ${JETTY_PORT}
+
+HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
+    CMD wget -qO- http://localhost:${JETTY_PORT}/ >/dev/null 2>&1 || exit 1
+
+ENTRYPOINT ["/entrypoint.sh"]
+CMD ["java", "-jar", "/opt/jetty/start.jar"]
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Stage 3: Development image — Maven + hot-reload via jetty:run
+# ─────────────────────────────────────────────────────────────────────────────
+FROM maven:3.9-eclipse-temurin-21-alpine AS development
+WORKDIR /app
+
+# Pre-fetch dependencies
+COPY pom.xml ./
+COPY */pom.xml ./
+RUN --mount=type=cache,target=/root/.m2 \
+    ./mvnw -B dependency:go-offline -pl superfly-web -am || true
+
+COPY . .
+
+EXPOSE 8080
+
+# jetty:run uses jetty-env.conf for JNDI — override via -Djetty.jndi.* if needed
+CMD ["./mvnw", "-pl", "superfly-web", "jetty:run"]