Merge branch 'main' into develop

Author: kpscyber

.github/workflows/dependabot-auto-merge.yml

@@ -14,7 +14,7 @@ jobs:
 
       - name: Dependabot metadata
         id: metadata
-        uses: dependabot/fetch-metadata@v2.2.0
+        uses: dependabot/fetch-metadata@v2.4.0
         with:
           github-token: "${{ secrets.GITHUB_TOKEN }}"
 

.github/workflows/fix-php-code-style-issues.yml

@@ -15,14 +15,14 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           ref: ${{ github.head_ref }}
 
       - name: Fix PHP code style issues
-        uses: aglipanci/laravel-pint-action@2.4
+        uses: aglipanci/laravel-pint-action@2.6
 
       - name: Commit changes
-        uses: stefanzweifel/git-auto-commit-action@v5
+        uses: stefanzweifel/git-auto-commit-action@v6
         with:
           commit_message: Fix styling

.github/workflows/phpstan.yml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 5
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2

.github/workflows/run-tests.yml

@@ -34,7 +34,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2

.github/workflows/update-changelog.yml

@@ -14,7 +14,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           ref: main
 
@@ -25,7 +25,7 @@ jobs:
           release-notes: ${{ github.event.release.body }}
 
       - name: Commit updated CHANGELOG
-        uses: stefanzweifel/git-auto-commit-action@v5
+        uses: stefanzweifel/git-auto-commit-action@v6
         with:
           branch: main
           commit_message: Update CHANGELOG

CHANGELOG.md

@@ -1,3 +1,27 @@
 # Changelog
 
 All notable changes to `laravel-workflow-loader` will be documented in this file.
+
+## v0.1.2 - 2024-09-26
+
+### What's Changed
+
+* Fixed: if migration not run before publishing service provider, run m… by @soap in https://github.com/soap/laravel-workflow-loader/pull/12
+
+**Full Changelog**: https://github.com/soap/laravel-workflow-loader/compare/v0.1.1...v0.1.2
+
+## v0.1.1 - 2024-09-25
+
+### What's Changed
+
+* Add fromStatesName attribute to display from states by @soap in https://github.com/soap/laravel-workflow-loader/pull/11
+
+**Full Changelog**: https://github.com/soap/laravel-workflow-loader/compare/v0.1.0...v0.1.1
+
+## v0.1.0 - 2024-09-19
+
+### What's Changed
+
+* Develop by @soap in https://github.com/soap/laravel-workflow-loader/pull/10
+
+**Full Changelog**: https://github.com/soap/laravel-workflow-loader/compare/v0.0.11...v0.1.0

README.md

@@ -9,7 +9,7 @@
 This package extends [zerodahero/laravel-workflow](https://github.com/zerodahero/laravel-workflow) by adding option to store workflow configuration in database. Laravel workflow only support loading configuration form Laravel configuration. This package provides user to change workflow configuration without helping from developers. 
 
 ## Support us
-
+You can suggest for any approvement, sponsor this project or make a pull request. I am happy to consider any recommendation. I am not a good programmer so my design may not be the best one. My background is not computer programming. I am an Electrical engineer.
 
 ## Installation
 
@@ -36,17 +36,63 @@ This is the contents of the published config file:
 
 ```php
 return [
+    'loaders' => [
+        'database' => [
+            'tableNames' => [
+                'workflows' => 'workflows',
+                'workflow_states' => 'workflow_states',
+                'workflow_transitions' => 'workflow_transitions',
+                'workflow_state_transitions' => 'workflow_state_transitions',
+            ],
+            'class' => \Soap\WorkflowLoader\DatabaseLoader::class,
+        ],
+    ],
 ];
 ```
 
+To use this package to load workflow configuration from database, you need to register workflow service provider provided by the package. Zerodahero 's workflow registry will be used to load configuration retreiving from database. 
+```
+php artisan venodr:publish --tag="workflow-loader-provider"
+```
 
-## Usage
-
-To use this package to store workflow configuration you need to register workflow binding in your application service provider. You have to instruct Laravel to use new 'workflow' binding instead of the one provided by zerodahero/laravel-workflow.
+This will copy the following WorkflowServiceProvider.php to application providers folder, ensure that it was included in application bootstrap. The following is the content of the file.
 
 ```php
 
+namespace App\Providers;
+
+use Illuminate\Support\ServiceProvider;
+
+class WorkflowServiceProvider extends ServiceProvider
+{
+    public function register() {}
+
+    public function boot()
+    {
+        $registry = app()->make('workflow');
+        $workflowLoaderRegistry = app()->make('workflowLoaderRegistry');   
+        foreach ($workflowLoaderRegistry->all() as $workflow => $config) {
+            $registry->addFromArray($workflow, $config);
+        }
+    }
+}
+```
+This package doesnot provide user interface for user to manage workflow configuration. By design it should be in separate package. I have a plan to create filament plugin to handle this.
+
+## Usage
+After you have completed setup, create workflow configuration in database using your own way or provided by other package. Then use them like the one you use by zerohadero/laravel-workflow. Storing configuration in database is easy to develop workflow for user.
+
+## To Do
+Curently guards should be created via event subscriber. I have a plan to use Symfony expression as upper guard layer. For example, you can write;
+
+```
+guard => $subject.isWaitingFor($user) || !$subject.isOwnedBy($user)
+```
+or 
+```
+guard => $subject.isApprovers($user) || $subject.isReviewers($user)
 ```
+Then the package will inject $subject and $user for you and use Symfony expression to evaluate blocking of the transition.
 
 ## Testing
 

composer.json

@@ -19,7 +19,7 @@
         "php": "^8.2",
         "illuminate/contracts": "^10.0||^11.0",
         "spatie/laravel-package-tools": "^1.16",
-        "zerodahero/laravel-workflow": "^4.0|^5.0"
+        "zerodahero/laravel-workflow": "^6.0.0"
     },
     "require-dev": {
         "laravel/pint": "^1.14",