docs: enhance OpenAPI documentation

.github/workflows/run-linter.yml

@@ -0,0 +1,30 @@
+name: Fix coding style
+
+on:
+  push:
+    branches:
+    - main
+  pull_request:
+    branches:
+    - main
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Laravel Pint
+        uses: aglipanci/laravel-pint-action@latest
+        with:
+          verboseMode: true
+          testMode: false
+
+      - name: Commit linted files
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "refactor: fix coding style"

Makefile

@@ -52,11 +52,11 @@ stan: serve
 
 lint: serve
 	@clear
-	./src/vendor/bin/pint --test -v src/app src/tests src/routes --preset per
+	./src/vendor/bin/pint --test -v
 
 lint-fix: serve
 	@clear
-	./src/vendor/bin/pint src/app src/tests src/routes --preset per
+	./src/vendor/bin/pint
 
 vendor: distclean
 	@clear

pint.json

@@ -0,0 +1,18 @@
+{
+	"preset": "per",
+	"exclude": [
+        "src/bootstrap",
+        "src/config",
+        "src/public",
+        "src/resources",
+        "src/storage",
+        "src/vendor"
+    ],
+    "notPath": [
+        "src/artisan"
+    ],
+    "rules": {
+			"class_definition": true,
+			"new_with_parentheses": true
+    }
+}

src/composer.json

@@ -14,7 +14,7 @@
         "symfony/yaml": "^6.4"
     },
     "require-dev": {
-        "laravel/pint": "^1.1",
+        "laravel/pint": "^1.17",
         "laravel/telescope": "^5.5",
         "mockery/mockery": "^1.6.12",
         "nunomaduro/collision": "^8.1",