PHPackages                             waysnx/business-framework - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. waysnx/business-framework

ActiveLibrary

waysnx/business-framework
=========================

WaysNX Business Framework - Laravel Implementation

v0.1.0(today)10Apache-2.0PHPPHP ^8.3

Since Aug 25Pushed todayCompare

[ Source](https://github.com/waysnx/business-framework-laravel)[ Packagist](https://packagist.org/packages/waysnx/business-framework)[ RSS](/packages/waysnx-business-framework/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (6)Versions (2)Used By (0)

WaysNX Business Framework — Laravel Implementation
==================================================

[](#waysnx-business-framework--laravel-implementation)

Official Laravel 13 implementation of the WaysNX Business Framework (WBF).

**WBF** is an enterprise-grade architecture framework for building business applications with structured design patterns, governance, and standardized practices.

What This Package Provides
--------------------------

[](#what-this-package-provides)

This Laravel package provides:

- **Business Framework foundation** — Structured architecture for enterprise applications
- **Service container integration** — Auto-discovery with Laravel's service provider pattern
- **CLI commands** — Commands for managing workflows, business functions, validations, modules, and entities
- **Registry system** — Central registries for workflows, business functions, validations, modules, and entities
- **Workflow engine** — Execute defined business workflows with lifecycle management
- **Validation framework** — Declarative validation engine with rules and issues reporting
- **Lifecycle management** — Hooks for before/after execution, custom logic injection
- **UUID support** — Built-in UUID generation for all entities

Requirements
------------

[](#requirements)

- **PHP:** ^8.3
- **Laravel:** ^13.0

Installation
------------

[](#installation)

```
composer require waysnx/business-framework
```

The package uses Laravel's auto-discovery. No manual service provider registration is required.

Quick Start
-----------

[](#quick-start)

### Verify Installation

[](#verify-installation)

```
php artisan wbf:doctor
```

This command checks that the WBF package is correctly installed and all components are available.

### List Available Resources

[](#list-available-resources)

```
php artisan wbf:list
```

Lists all available resource types. Use a specific resource type to see registered instances:

```
php artisan wbf:list workflows
php artisan wbf:list business-functions
php artisan wbf:list validations
php artisan wbf:list modules
php artisan wbf:list entities
```

CLI Commands
------------

[](#cli-commands)

The package provides the following Artisan commands:

### wbf:doctor — Verify Installation

[](#wbfdoctor--verify-installation)

Check WBF system health and component availability.

```
php artisan wbf:doctor               # Show health summary
php artisan wbf:doctor --detail      # Show detailed diagnostics
php artisan wbf:doctor --json        # Output as JSON
php artisan wbf:doctor --component WorkflowEngine   # Check specific component
```

### wbf:list — List Resources

[](#wbflist--list-resources)

List registered WBF resources (workflows, business functions, validations, modules, entities).

```
php artisan wbf:list                          # List available resource types
php artisan wbf:list workflows                # List all workflows
php artisan wbf:list business-functions       # List all business functions
php artisan wbf:list validations              # List all validations
php artisan wbf:list modules                  # List all modules
php artisan wbf:list entities                 # List all entities

# Options:
php artisan wbf:list workflows --detailed     # Show detailed information
php artisan wbf:list workflows --filter=hr    # Filter by name
php artisan wbf:list workflows --module=hr    # Filter by module
php artisan wbf:list workflows --json         # Output as JSON
```

### wbf:show — Show Resource Details

[](#wbfshow--show-resource-details)

Display detailed information about a specific resource.

```
php artisan wbf:show workflow employee-onboarding
php artisan wbf:show business-function apply-leave
php artisan wbf:show validation check-eligibility
php artisan wbf:show module hr
php artisan wbf:show entity Employee

# Options:
php artisan wbf:show workflow employee-onboarding --json   # Output as JSON
```

### wbf:make — Generate Artifacts

[](#wbfmake--generate-artifacts)

Create new WBF artifacts (workflows, business functions, validations, modules, entities).

```
php artisan wbf:make workflow OnboardingWorkflow
php artisan wbf:make business-function ApplyLeave
php artisan wbf:make validation CheckEligibility
php artisan wbf:make module HumanResources
php artisan wbf:make entity Employee

# Options:
php artisan wbf:make workflow OnboardingWorkflow --module=hr
php artisan wbf:make workflow OnboardingWorkflow --description="Employee onboarding workflow"
php artisan wbf:make business-function ApplyLeave --namespace="App\\Hr\\Functions"
php artisan wbf:make business-function ApplyLeave --force   # Overwrite if exists
php artisan wbf:make workflow OnboardingWorkflow --json     # Output as JSON
```

### wbf:register — Verify Registration

[](#wbfregister--verify-registration)

Verify that a resource is registered in its registry.

```
php artisan wbf:register workflow employee-onboarding
php artisan wbf:register business-function apply-leave
php artisan wbf:register validation check-eligibility

# Options:
php artisan wbf:register workflow employee-onboarding --fail-if-not-found  # Exit with error if not found
php artisan wbf:register workflow employee-onboarding --json               # Output as JSON
```

Example: Create a Business Function
-----------------------------------

[](#example-create-a-business-function)

```
php artisan wbf:make business-function SmokeTestFunction
```

This creates a new business function with scaffolded code ready for implementation.

Laravel Integration
-------------------

[](#laravel-integration)

The WBF Laravel package integrates seamlessly with Laravel's service container and auto-discovery:

- **Auto-discovery:** The `LaravelServiceProvider` is automatically discovered and registered by Laravel
- **Service container:** All WBF components (registries, workflow engine, validation framework, lifecycle manager) are bound to Laravel's container and injectable into your classes
- **Configuration:** Configuration is published to `config/business-framework.php` and managed through Laravel's config system
- **Artisan commands:** All WBF commands are available through `php artisan`

Documentation
-------------

[](#documentation)

For comprehensive documentation on the WaysNX Business Framework architecture, design patterns, specifications, and guidance, visit the main repository:

**[WaysNX Business Framework](https://github.com/waysnx/waysnx-business-framework)**

That repository contains:

- Full architecture documentation
- Framework specifications
- Design decisions (ADRs)
- Multi-technology implementation guidance
- Broader ecosystem information

License
-------

[](#license)

Apache License 2.0

See the `LICENSE` file for full license text.

---

**Built with WaysNX Business Framework** — Enterprise Architecture for Modern Applications

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance100

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/66766972?v=4)[waysnx](/maintainers/waysnx)[@waysnx](https://github.com/waysnx)

---

Top Contributors

[![umeshwani-waysnx](https://avatars.githubusercontent.com/u/66767833?v=4)](https://github.com/umeshwani-waysnx "umeshwani-waysnx (27 commits)")

---

Tags

business-frameworkbusiness-logicdeveloper-toolslaravellaravel-13laravel-packagephpwaysnxwbf

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/waysnx-business-framework/health.svg)

```
[![Health](https://phpackages.com/badges/waysnx-business-framework/health.svg)](https://phpackages.com/packages/waysnx-business-framework)
```

###  Alternatives

[illuminate/queue

The Illuminate Queue package.

20433.0M1.9k](/packages/illuminate-queue)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.4M354](/packages/psalm-plugin-laravel)[laravel/horizon

Dashboard and code-driven configuration for Laravel queues.

4.2k99.8M360](/packages/laravel-horizon)[illuminate/database

The Illuminate Database package.

2.8k55.8M13.3k](/packages/illuminate-database)[laravel/ai

The official AI SDK for Laravel.

1.1k4.6M341](/packages/laravel-ai)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

80427.1M249](/packages/laravel-mcp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
