Release: promote beta to stable — initial CI pipeline and app scaffold

.claude/settings.local.json

@@ -0,0 +1,45 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(composer run-script:*)",
+      "Bash(composer phpcs:*)",
+      "Bash(composer phpmd:*)",
+      "Bash(composer psalm:*)",
+      "Bash(composer phpcs:fix:*)",
+      "Bash(./vendor/bin/phpmd:*)",
+      "Bash(cat:*)",
+      "Bash(echo:*)",
+      "Bash(./vendor/bin/phpcs:*)",
+      "Bash(./vendor/bin/phpcbf:*)",
+      "Bash(./vendor/bin/psalm:*)",
+      "Bash(sudo chown:*)",
+      "Bash(xargs -I {} sh -c 'echo \"\"$\\(grep -c \"\"@SuppressWarnings\\(PHPMD\"\" {} 2>/dev/null\\) {}\"\"')",
+      "Bash(docker ps:*)",
+      "Bash(docker exec:*)",
+      "Bash(./run-tests.sh:*)",
+      "Bash(grep:*)",
+      "Bash(ls:*)",
+      "Bash(git log:*)",
+      "Bash(git status:*)",
+      "Bash(git diff:*)",
+      "Bash(git show:*)",
+      "Bash(git branch:*)",
+      "Bash(git rev-parse:*)",
+      "Bash(git describe:*)",
+      "Bash(git tag:*)",
+      "Bash(git blame:*)",
+      "Bash(git stash list:*)",
+      "Bash(git shortlog:*)",
+      "Bash(git remote:*)",
+      "Bash(git -C:*)",
+      "Bash(git fetch:*)",
+      "Bash(which:*)",
+      "Bash(find:*)",
+      "Bash(head:*)",
+      "Bash(tail:*)",
+      "Bash(wc:*)",
+      "Bash(stat:*)",
+      "Bash(jq:*)"
+    ]
+  }
+}

.gitattributes

@@ -0,0 +1,64 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Source code - always use LF
+*.js text eol=lf
+*.jsx text eol=lf
+*.ts text eol=lf
+*.tsx text eol=lf
+*.mjs text eol=lf
+*.cjs text eol=lf
+
+# Configuration files - always use LF
+*.json text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.toml text eol=lf
+*.xml text eol=lf
+
+# Styles - always use LF
+*.css text eol=lf
+*.scss text eol=lf
+*.sass text eol=lf
+*.less text eol=lf
+
+# HTML and templates - always use LF
+*.html text eol=lf
+*.htm text eol=lf
+*.svg text eol=lf
+
+# Documentation - always use LF
+*.md text eol=lf
+*.txt text eol=lf
+*.rtf text eol=lf
+
+# Docker and shell scripts - always use LF
+Dockerfile text eol=lf
+*.dockerfile text eol=lf
+*.sh text eol=lf
+
+# Git files - always use LF
+.gitattributes text eol=lf
+.gitignore text eol=lf
+.gitmodules text eol=lf
+
+# Windows script files - use CRLF
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+
+# Binary files - do not modify
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.webp binary
+*.pdf binary
+*.woff binary
+*.woff2 binary
+*.ttf binary
+*.eot binary
+*.zip binary
+*.gz binary
+*.tar binary

.github/workflows/code-quality.yml

@@ -4,7 +4,7 @@ on:
   push:
     branches: [main, development, feature/**, bugfix/**, hotfix/**]
   pull_request:
-    branches: [main, master, development]
+    branches: [main, master, development, beta]
   workflow_dispatch:
 
 jobs:
@@ -17,10 +17,11 @@ jobs:
       nextcloud-test-refs: '["stable31", "stable32"]'
       enable-psalm: true
       enable-phpstan: true
-      enable-phpmetrics: false
+      enable-phpmetrics: true
       enable-frontend: true
       enable-eslint: true
       enable-phpunit: true
-      enable-newman: false
-      additional-apps: '[{"repo":"ConductionNL/openregister","app":"openregister","ref":"main"}]'
+      enable-newman: true
+      # additional-apps: '[]'  # Add app dependencies here if needed, e.g.:
+      # additional-apps: '[{"repo":"ConductionNL/openregister","app":"openregister","ref":"main"}]'
       enable-sbom: true

.github/workflows/pull-request-lint-check.yaml

@@ -0,0 +1,22 @@
+name: Lint Check
+
+on:
+  pull_request:
+    branches:
+      - development
+      - main
+      - beta
+
+jobs:
+  lint-check:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Linting
+        run: npm run lint

.gitignore

@@ -1,7 +1,90 @@
+/.idea/
+/*.iml
+*.Identifier
+.phphunit.result.cache
+
+/vendor/
+/vendor-bin/*/vendor/
+
+/.php-cs-fixer.cache
+/tests/.phpunit.cache
+/.phpunit.cache
+.phpunit.cache/
+
 /node_modules/
+/website/node_modules/
+/website/.docusaurus/
 /js/
-/vendor/
+/custom_apps/
+/config/
+
+/coverage/
+/coverage-frontend/
+
+# Quality reports
+/quality-reports/
+quality-baseline.json
+/phpmetrics/
+/phpmetrics-deps/
+
+# PHPCS/Psalm output files (not config files)
+phpcs-*.json
+phpcs-*.txt
+psalm-errors.json
+psalm-output.json
+psalm-full-output.json
+phpqa_output.log
+
+# Data files
+*.csv
+*.xls
+*.xlsx
+
+# Files with unusual extensions or no extensions that could be mistakes
+**/PR *
+**/adds *
+**/implements *
+**/ALL *
+**/endpoints *
+**/*Analysis*
+**/*references*
+**/*encoding*
+**/ter
+**/clearCache*
+**/update*Settings*
+**/rebase*
+**/setup*
+
+# Temporary test files that shouldn't be committed
+simple-solr-test.php
+test-solr-connection.php
+
+# Files with unusual extensions or no extensions that could be mistakes
+**/PR *
+**/adds *
+**/implements *
+
+phpqa/
+
+# Docker AI models (too large for git)
+docker/dolphin/models/
+
+# Issues folder should be tracked
+!issues/
+!issues/**
+
 /docusaurus/node_modules/
 /docusaurus/build/
 /docusaurus/.docusaurus/
-/test-results/screenshots/
+# Test screenshots — images generated by browser test commands (test-app, run-test-scenario)
+# Only images are ignored; markdown reports and scenario files are kept in git.
+test-results/**/*.png
+test-results/**/*.jpg
+test-results/**/*.jpeg
+test-results/**/*.gif
+test-results/**/*.webp
+openspec/test-site-results/**/*.png
+openspec/test-site-results/**/*.jpg
+openspec/test-site-results/**/*.jpeg
+openspec/test-site-results/**/*.gif
+openspec/test-site-results/**/*.webp

.prettierrc

@@ -0,0 +1,38 @@
+{
+  "overrides": [
+    {
+      "files": ["*.json"],
+      "options": {
+        "parser": "json",
+        "printWidth": 120,
+        "tabWidth": 2
+      }
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "options": {
+        "parser": "typescript",
+        "printWidth": 120,
+        "trailingComma": "all",
+        "tabWidth": 2,
+        "singleQuote": false
+      }
+    },
+    {
+      "files": ["*.css", "*.scss"],
+      "options": {
+        "parser": "css",
+        "tabWidth": 2
+      }
+    },
+    {
+      "files": ["conduction.css"],
+      "options": {
+        "parser": "css",
+        "trailingComma": "all",
+        "tabWidth": 2,
+        "printWidth": 150
+      }
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,29 @@
+{
+    "files.autoSave": "afterDelay",
+    "editor.defaultFormatter": "dbaeumer.vscode-eslint",
+    "editor.formatOnSave": true,
+    "eslint.format.enable": true,
+    "cSpell.words": [
+        "depubliceren",
+        "Depubliceren",
+        "gedepubliceerd",
+        "Matadata",
+        "nextcloud",
+        "opencatalogi",
+        "organisation",
+        "Organisation",
+        "organisations",
+        "Organisations",
+        "pinia",
+        "Toegangs"
+    ],
+    "[javascript]": {
+        "editor.defaultFormatter": "dbaeumer.vscode-eslint"
+    },
+    "[css]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[php]": {
+        "editor.defaultFormatter": "DEVSENSE.phptools-vscode"
+    },
+}

Makefile

@@ -0,0 +1,21 @@
+# Makefile for nextcloud-app-template development
+
+# Create a relative symlink in the parent directory so Nextcloud can find the
+# app by its ID (app-template) even though the repo is cloned as nextcloud-app-template.
+# Nextcloud requires the directory name to match the <id> in appinfo/info.xml.
+dev-link:
+	@if [ -L ../app-template ]; then \
+		echo "Symlink ../app-template already exists."; \
+	else \
+		ln -s nextcloud-app-template ../app-template && \
+		echo "Created symlink: apps-extra/app-template -> nextcloud-app-template"; \
+	fi
+
+dev-unlink:
+	@if [ -L ../app-template ]; then \
+		rm ../app-template && echo "Removed symlink ../app-template"; \
+	else \
+		echo "No symlink found at ../app-template."; \
+	fi
+
+.PHONY: dev-link dev-unlink