enh: Add phpmd, phpstan and phpcs

.github/workflows/lint-sniffs.yml

@@ -0,0 +1,34 @@
+name: Lint & Sniffs
+
+on:
+  pull_request:
+    branches:
+      - main
+      - dev
+jobs:
+  php-lint-sniffs:
+    name: PHP (Sniffs)
+    runs-on: ubuntu-latest
+#    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+          tools: composer
+
+      - name: Install Composer dependencies
+        run: composer install --prefer-dist --no-progress --no-suggest --no-interaction
+
+      - name: PHP Code Standards
+        run: composer phpcs:test
+
+      - name: PHP Static Analysis
+        run: composer phpstan
+
+      - name: PHP Mess Detector
+        run: composer phpmd
+
+      - name: Laravel Pint
+        run: composer pint:test

.github/workflows/checks.yml → .github/workflows/tests.yml

@@ -1,14 +1,18 @@
-name: Code checks
+name: Tests
 
 on:
   pull_request:
+  push:
     branches:
       - main
       - dev
 
 jobs:
   tests:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        php-version: [ '8.3', '8.4', '8.5' ]
     services:
       mysql-service:
         image: mysql:5.7
@@ -42,16 +46,35 @@ jobs:
           echo "DB_USERNAME=root" >> workbench/.env
           echo "DB_PASSWORD=password" >> workbench/.env
           echo "APP_ENV=testing" >> workbench/.env
+      - name: Testing on PHP ${{ matrix.php-version }}
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-version }}
+          tools: composer
+          extensions: pcov
+          coverage: pcov
       - name: Install dependencies
         run: composer install -q --no-ansi --no-interaction --no-scripts --no-suggest --no-progress --prefer-dist
-      - name: Publish roles migrations
-        run: vendor/bin/testbench vendor:publish --tag roles-migrations
       - name: Run migrations
         run: vendor/bin/testbench migrate
       - name: Run tests
-        run: vendor/bin/testbench package:test
-      - name: Run linter test
-        run: composer pint:test
+        run: vendor/bin/testbench package:test --coverage --coverage-clover=reports/coverage/coverage.xml
+      - name: Check code coverage
+        run: |
+          COVERAGE=$(php -r "
+            \$xml = simplexml_load_file('reports/coverage/coverage.xml');
+            \$metrics = \$xml->project->metrics;
+            \$coverage = ((int)\$metrics['coveredstatements'] / (int)\$metrics['statements']) * 100;
+            echo round(\$coverage, 2);
+          ")
+          echo "Code coverage: $COVERAGE%"
+          MIN_COVERAGE=59.1
+          if (( $(echo "$COVERAGE < $MIN_COVERAGE" | bc -l) )); then
+            echo "❌ Code coverage ($COVERAGE%) is below the minimum threshold of $MIN_COVERAGE%"
+            exit 1
+          else
+            echo "✅ Code coverage ($COVERAGE%) meets the minimum threshold of $MIN_COVERAGE%"
+          fi
       - name: Clean up SSH key
         if: always()
         run: rm -f ~/.ssh/id_rsa

.gitignore

@@ -3,4 +3,5 @@ vendor/
 .idea/
 .phpunit.result.cache
 workbench/storage
-.vscode
+.vscode
+reports/

composer.json

@@ -11,7 +11,7 @@
     }
   ],
   "require": {
-    "php": "^8.2",
+    "php": "^8.3",
     "laravel/framework": "^12.0",
     "laravel/sanctum": "^4.0",
     "whilesmart/eloquent-roles": "*",
@@ -22,7 +22,11 @@
     "zircote/swagger-php": "^5.1",
     "nunomaduro/collision": "^8.8",
     "laravel/pint": "^1.22",
-    "fakerphp/faker": "^1.24"
+    "fakerphp/faker": "^1.24",
+    "phpmd/phpmd": "@stable",
+    "phpstan/phpstan": "^2.1",
+    "larastan/larastan": "^3.0",
+    "squizlabs/php_codesniffer": "^4.0"
   },
   "suggest": {
     "whilesmart/organizations": "For organization/customer management within workspaces",
@@ -47,16 +51,22 @@
     }
   },
   "scripts": {
-    "test": "vendor/bin/testbench package:test",
     "clear": "@php vendor/bin/testbench package:purge-skeleton --ansi",
     "prepare": "@php vendor/bin/testbench package:discover --ansi",
     "build": "@php vendor/bin/testbench workbench:build --ansi",
     "pint": [
-      "./vendor/bin/pint"
+      "./vendor/bin/pint --preset psr12"
     ],
     "pint:test": [
-      "./vendor/bin/pint --test"
-    ]
+      "./vendor/bin/pint --preset psr12 --test"
+    ],
+    "phpmd": [
+      "vendor/bin/phpmd src text phpmd.xml"
+    ],
+    "phpstan": "phpstan analyse src --memory-limit=2048M --level=5",
+    "phpcs": "phpcbf src",
+    "phpcs:test": "phpcs src",
+    "test": "vendor/bin/testbench package:test --coverage"
   }
 }