Add devcontainer support

Author: mgruner

.devcontainer/devcontainer.json

@@ -0,0 +1,35 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/universal
+{
+	"name": "zammad-org-devcontainer",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"image": "mcr.microsoft.com/devcontainers/base:debian-12",
+	"features": {
+		"ghcr.io/devcontainers/features/docker-outside-of-docker:1": {},
+    "ghcr.io/devcontainers/features/node:1": {},
+    "ghcr.io/joshuanianji/devcontainer-features/mount-pnpm-store:1": {},
+		"ghcr.io/devcontainers-extra/features/apt-get-packages": {
+      "packages": "libgtk2.0-0 libgtk-3-0 libgbm-dev libnotify-dev libgconf-2-4 libnss3 libxss1 libasound2 libxtst6 xauth xvfb" // cypress dependencies
+    },
+		"./features/po4a": {},
+	},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	"containerEnv": {
+		"LC_ALL" : "C.UTF-8",
+		"LANG": "C.UTF-8",
+		"LANGUAGE": "C.UTF-8",
+		"CYPRESS_BASE_URL": "http://host.docker.internal:8080"
+	},
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	"postCreateCommand": "/workspaces/${localWorkspaceFolderBasename}/.devcontainer/post_create.sh",
+
+	// Configure tool-specific properties.
+	// "customizations": {},
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

.devcontainer/features/po4a/devcontainer-feature.json

@@ -0,0 +1,12 @@
+{
+  "id": "po4a",
+  "version": "1.0.0",
+  "name": "Install po4a",
+  "description": "Installs po4a from git",
+  "dependsOn": {
+    "ghcr.io/devcontainers-extra/features/apt-get-packages": {
+      "packages": "libmodule-build-perl libosp5 libpod-parser-perl libsgmls-perl libsyntax-keyword-try-perl libtext-wrapi18n-perl libunicode-linebreak-perl libxs-parse-keyword-perl libyaml-tiny-perl libterm-readkey-perl libxml2-utils opensp sgml-base xsltproc"
+    },
+  },
+  "privileged": true
+}

.devcontainer/features/po4a/install.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env sh
+
+export LC_ALL=C.UTF-8
+export LANG=C.UTF-8
+export LANGUAGE=C.UTF-8
+
+# Build po4a from source to get the latest version.
+git clone https://github.com/mquinson/po4a.git
+(
+  cd po4a
+  perl Build.PL
+  ./Build || true # ignore errors, as the build may fail when trying to fetch an external, non-critical stylesheet
+  ./Build install
+)
+rm -rf po4a
+which po4a

.devcontainer/post_create.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+
+CI=true pnpm install --frozen-lockfile
+CI=true pnpm screenshots:install
+pnpm --dir ./.screenshots exec cypress install

.github/dependabot.yml

@@ -0,0 +1,12 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for more information:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+# https://containers.dev/guide/dependabot
+
+version: 2
+updates:
+ - package-ecosystem: "devcontainers"
+   directory: "/"
+   schedule:
+     interval: weekly

.screenshots/cypress.config.js

@@ -2,7 +2,7 @@ const { defineConfig } = require("cypress");
 
 module.exports = defineConfig({
   e2e: {
-    baseUrl: 'http://localhost:8080',
+    baseUrl: process.env.CYPRESS_BASE_URL || 'http://localhost:8080',
     env: {
       ADMIN_LOGIN: '[email protected]',
       ADMIN_PASS: 'lauren4711',