refactor: modernize codebase

.devcontainer/Dockerfile

@@ -0,0 +1,16 @@
+FROM mcr.microsoft.com/devcontainers/php:1-8.4-bookworm
+
+RUN rm -f /etc/apt/sources.list.d/yarn.list \
+    && apt-get update \
+    && export DEBIAN_FRONTEND=noninteractive \
+    && apt-get install -y --no-install-recommends ca-certificates curl gnupg \
+    && mkdir -p /etc/apt/keyrings \
+    && curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key \
+        | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg \
+    && echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_24.x nodistro main" \
+        > /etc/apt/sources.list.d/nodesource.list \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends nodejs \
+    && npm install -g npm@latest \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*

.devcontainer/devcontainer.json

@@ -0,0 +1,29 @@
+{
+  "name": "LSTelegramNotify",
+  "dockerComposeFile": [
+    "../docker-compose.yml",
+    "docker-compose.extend.yml"
+  ],
+  "service": "workspace",
+  "runServices": [
+    "lime-db",
+    "limesurvey",
+    "workspace"
+  ],
+  "workspaceFolder": "/workspaces/LSTelegramNotify",
+  "shutdownAction": "stopCompose",
+  "postCreateCommand": "composer install --no-interaction --prefer-dist && npm install",
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "files.eol": "\n",
+        "terminal.integrated.defaultProfile.linux": "bash"
+      },
+      "extensions": [
+        "bmewburn.vscode-intelephense-client",
+        "ms-playwright.playwright",
+        "EditorConfig.EditorConfig"
+      ]
+    }
+  }
+}

.devcontainer/docker-compose.extend.yml

@@ -0,0 +1,21 @@
+services:
+  limesurvey:
+    environment:
+      PUBLIC_URL: http://limesurvey:8080
+      BASE_URL: http://limesurvey:8080
+
+  workspace:
+    build:
+      context: .
+      dockerfile: .devcontainer/Dockerfile
+    depends_on:
+      - limesurvey
+    volumes:
+      - .:/workspaces/LSTelegramNotify:cached
+    working_dir: /workspaces/LSTelegramNotify
+    command: sleep infinity
+    environment:
+      LIMESURVEY_BASE_URL: http://limesurvey:8080
+      LIMESURVEY_ADMIN_USER: admin
+      LIMESURVEY_ADMIN_PASSWORD: admin
+      PLAYWRIGHT_HEADLESS: 'true'

.docker/php/Dockerfile

@@ -0,0 +1,22 @@
+ARG LIMESURVEY_STACK_IMAGE=martialblog/limesurvey@sha256:4bfa6cac546fc95de6b26dc9afe118814df7941ebdec3f902f18cfbcd1478452
+FROM ${LIMESURVEY_STACK_IMAGE}
+
+USER root
+
+ENV COMPOSER_ALLOW_SUPERUSER=1 \
+    COMPOSER_HOME=/tmp/composer-home \
+    COMPOSER_CACHE_DIR=/tmp/composer-cache \
+    HOME=/tmp/composer-home
+
+RUN apt-get update \
+    && export DEBIAN_FRONTEND=noninteractive \
+    && apt-get install -y --no-install-recommends ca-certificates curl git unzip \
+    && mkdir -p "$COMPOSER_HOME" "$COMPOSER_CACHE_DIR" \
+    && chmod 1777 /tmp "$COMPOSER_HOME" "$COMPOSER_CACHE_DIR" \
+    && git config --system --add safe.directory /var/www/html/plugins/LSTelegramNotify \
+    && php -r "copy('https://getcomposer.org/installer', '/tmp/composer-setup.php');" \
+    && php /tmp/composer-setup.php --quiet --install-dir=/usr/local/bin --filename=composer \
+    && rm /tmp/composer-setup.php \
+    && composer --version \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*

.github/dependabot.yml

@@ -0,0 +1,39 @@
+version: 2
+updates:
+  - package-ecosystem: "composer"
+    directory: "/"
+    target-branch: "main"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "06:00"
+      timezone: "UTC"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "chore(deps)"
+    groups:
+      php-minor-and-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "npm"
+    directory: "/"
+    target-branch: "main"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "06:15"
+      timezone: "UTC"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "chore(deps)"
+    groups:
+      javascript-minor-and-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"

.github/workflows/behat.yml

@@ -0,0 +1,46 @@
+name: Behat Integration Tests
+
+on:
+  pull_request:
+  push:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: behat-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  behat:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Prepare disposable LimeSurvey stack
+        run: |
+          docker compose up -d --build --wait
+          docker compose exec -T --user "$(id -u):$(id -g)" limesurvey composer install --working-dir=/var/www/html/plugins/LSTelegramNotify --no-interaction --prefer-dist --no-dev --no-scripts
+          docker compose exec -T --user "$(id -u):$(id -g)" limesurvey composer install --working-dir=/var/www/html/plugins/LSTelegramNotify/tests/Integration --no-interaction --prefer-dist
+
+      - name: Run Behat integration tests
+        run: |
+          docker compose exec -T --user "$(id -u):$(id -g)" limesurvey composer --working-dir=/var/www/html/plugins/LSTelegramNotify/tests/Integration run test:junit
+
+      - name: Upload Behat report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: behat-report
+          path: tests/Integration/output/report.xml
+          if-no-files-found: ignore
+
+      - name: Print container logs
+        if: always()
+        run: docker compose logs --no-color
+
+      - name: Stop disposable LimeSurvey stack
+        if: always()
+        run: docker compose down -v

.github/workflows/documentation-screenshots.yml

@@ -0,0 +1,97 @@
+name: Documentation Screenshots
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  screenshot:
+    runs-on: ubuntu-latest
+    env:
+      LIMESURVEY_BASE_URL: http://127.0.0.1:18080
+      LIMESURVEY_ADMIN_USER: admin
+      LIMESURVEY_ADMIN_PASSWORD: admin
+      LIMESURVEY_STACK_HOST_PORT: '18080'
+      PLAYWRIGHT_HEADLESS: 'true'
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup PHP 8.5
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.5'
+          tools: composer:v2
+          coverage: none
+
+      - name: Setup Node.js 24
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: npm
+
+      - name: Install PHP dependencies
+        run: composer install --no-interaction --prefer-dist --no-scripts
+
+      - name: Install Node dependencies
+        run: npm ci
+
+      - name: Install Chromium for Playwright
+        run: npx playwright install --with-deps chromium
+
+      - name: Start LimeSurvey test stack
+        run: docker compose up -d --force-recreate
+
+      - name: Wait for LimeSurvey admin login page
+        run: >-
+          curl --fail --silent --show-error
+          --retry 60
+          --retry-all-errors
+          --retry-delay 2
+          "$LIMESURVEY_BASE_URL/index.php/admin/authentication/sa/login"
+          > /dev/null
+
+      - name: Validate documentation screenshots
+        id: screenshot_check
+        continue-on-error: true
+        run: npm run screenshots:check
+
+      - name: Explain screenshot failure
+        if: steps.screenshot_check.outcome == 'failure'
+        run: |
+          cat <<'EOF' >> "$GITHUB_STEP_SUMMARY"
+          ## Documentation screenshots need attention
+
+          - Run `composer install --no-interaction --prefer-dist --no-scripts` if your local checkout does not already have `vendor/`.
+          - To reproduce with the same disposable LimeSurvey stack used in CI, run `LIMESURVEY_STACK_HOST_PORT=18080 docker compose up -d --force-recreate` from the repository root.
+          - Then run `LIMESURVEY_BASE_URL=http://127.0.0.1:18080 LIMESURVEY_ADMIN_USER=admin LIMESURVEY_ADMIN_PASSWORD=admin npm run screenshots:check`.
+          - If the screenshots drifted, run `LIMESURVEY_BASE_URL=http://127.0.0.1:18080 LIMESURVEY_ADMIN_USER=admin LIMESURVEY_ADMIN_PASSWORD=admin npm run screenshots:update` and commit the updated PNG files.
+          - Download the `documentation-screenshot-diffs` artifact from this workflow run for the visual diff.
+          EOF
+          echo "::error::Documentation screenshots are out of date. Reproduce with the screenshot compose stack, run npm run screenshots:update, and commit the updated PNG files."
+
+      - name: Upload screenshot diff artifacts
+        if: steps.screenshot_check.outcome == 'failure'
+        uses: actions/upload-artifact@v4
+        with:
+          name: documentation-screenshot-diffs
+          path: test-results/screenshots
+          if-no-files-found: ignore
+
+      - name: Show LimeSurvey stack logs on failure
+        if: failure()
+        run: |
+          docker compose ps
+          docker compose logs --no-color
+
+      - name: Stop LimeSurvey test stack
+        if: always()
+        run: docker compose down -v
+
+      - name: Fail when documentation screenshots are stale
+        if: steps.screenshot_check.outcome == 'failure'
+        run: exit 1

.github/workflows/lint-php-cs.yml

@@ -0,0 +1,29 @@
+name: PHP CS Fixer
+
+on:
+  pull_request:
+  push:
+
+jobs:
+  lint-php-cs:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup PHP 8.5
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.5'
+          tools: composer
+          coverage: none
+
+      - name: Validate composer.json
+        run: composer validate --no-check-publish
+
+      - name: Install dependencies
+        run: composer install --no-interaction --prefer-dist
+
+      - name: Check PHP coding style
+        run: composer run cs:check

.github/workflows/lint-php.yml

@@ -0,0 +1,23 @@
+name: PHP Lint
+
+on:
+  pull_request:
+  push:
+
+jobs:
+  lint-php:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup PHP 8.5
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.5'
+          tools: composer
+          coverage: none
+
+      - name: Run PHP syntax lint
+        run: composer run lint

.github/workflows/psalm.yml

@@ -0,0 +1,30 @@
+name: Psalm
+
+on:
+  pull_request:
+  push:
+
+jobs:
+  psalm:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup PHP 8.5
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.5'
+          tools: composer
+          coverage: none
+          extensions: dom, simplexml
+
+      - name: Validate composer.json
+        run: composer validate --no-check-publish
+
+      - name: Install dependencies
+        run: composer install --no-interaction --prefer-dist
+
+      - name: Run Psalm
+        run: composer run psalm

.github/workflows/screenshot-scripts.yml

@@ -0,0 +1,25 @@
+name: Screenshot Script Tests
+
+on:
+  pull_request:
+  push:
+
+jobs:
+  screenshot-script-tests:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js 24
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: npm
+
+      - name: Install Node dependencies
+        run: npm ci
+
+      - name: Run screenshot automation unit tests
+        run: npm run screenshots:test

.gitignore

@@ -1 +1,10 @@
 /vendor/
+/vendor-bin/**/vendor/
+/tests/Integration/vendor/
+/tests/Integration/output/
+/node_modules/
+/.env
+/playwright-report/
+/test-results/
+/.php-cs-fixer.cache
+/.psalm/