Purchase Request Approval
PurchaseRequest → Manager approval before converting to a purchase order → Controlled purchasing flow
Model-first approval workflow engine for Laravel & Filament
Add approval workflows to any Laravel model in minutes.
Bind workflows to PurchaseRequest, Refund, or any Eloquent model—without a BPM server.
Walk through refund and purchase-request approvals on real business objects — no local install required.
<?php
namespace App\Models;
use DbflowLabs\Core\Traits\HasWorkflow;
use Illuminate\Database\Eloquent\Model;
class RefundDispute extends Model
{
use HasWorkflow;
}use DbflowLabs\Core\DBFlow;
DBFlow::start('refund_dispute_approval', $dispute, $user);How it works
How DBFlow works
Workflows attach to Eloquent models. DBFlow manages instances, tasks, and audit trails.
Eloquent Model
Your domain record
Workflow Definition
Steps & transitions
Workflow Instance
Run on this record
Pending Task
Assigned approver
Approve / Reject
Actor decision
Business Continues
Your app logic runs
Philosophy
Why model-first?
Approval logic belongs on the business objects your app already owns.
Traditional BPM
- External process engine
- Duplicated business logic
- Complex integration layer
- Difficult long-term maintenance
DBFlow
- Existing Eloquent models
- Native Laravel services
- Filament-ready UI layer
- Dedicated approval infrastructure
Practical value
Why not build approvals yourself?
Tasks, reject paths, audit trails, permissions, and versioning add up fast.
Without DBFlow
- Create workflow tables manually
- Build pending task logic
- Handle approval modes
- Implement reject flows
- Track audit history
- Add Filament pages
- Protect business actions
- Maintain workflow versions
With DBFlow
- Install the package
- Add HasWorkflow
- Define a workflow
- Add Filament actions
- Approve or reject tasks
- View the timeline
- Keep business logic in your app
Use cases
Typical use cases
Real Laravel business objects—not abstract process diagrams.
Refund Approval
Refund → Finance review before refunding a customer → Safer refund handling
Expense Approval
ExpenseClaim → Manager and finance review → Cleaner internal approvals
Vendor Approval
Vendor → Onboarding review before activation → Safer supplier management
High-value Order Approval
Order → Approval when amount exceeds a threshold → Controlled high-risk sales
Inventory Adjustment Approval
InventoryAdjustment → Supervisor approval before stock changes → Safer inventory operations
Laravel-native
Built for Laravel projects
Atomic task actions, append-only audit logs, WorkflowHooks, and optional Filament UI.
Eloquent integration docs →- Eloquent models — workflows bind to business objects
- Database transactions — approve and reject atomically
- WorkflowHooks — map events to model status columns
- Append-only audit trail in dbflow_workflow_logs
- Filament UI — My Tasks, timelines, resource actions
- PHPUnit — test real approval workflow runs
Product layers
Core, Filament Standard, Pro Builder
Core runs workflows. Filament adds admin UI. Pro helps design definitions.
C
F
Filament Standard
dbflowlabs/filament
Free Filament UI for workflow tasks, timelines, resource actions and workflow instance pages.
P
Pro Builder
dbflowlabs/filament-pro
Visual workflow builder for definitions. Commercial license.
1.1 stable
1.1 — Core, Filament, and Pro
Core and Filament Standard are on 1.1 — SLA, delegation, reliable actions, and outbound webhooks on the frozen 1.0 runtime API. DBFlow Pro is a commercial 1.1 visual builder aligned with the same release line.
Learn & explore
Documentation & examples
Install Core
Composer, migrations, and first panel pages.
Open →Build Your First Workflow
End-to-end approval workflow on an Eloquent model.
Open →Explore Examples
Refund, purchase request, and common approval patterns.
Open →Tutorials
Structured learning path from install to deeper guides.
Open →FAQ
Common questions
Is DBFlow a BPM platform?
No. DBFlow is a model-first approval workflow engine for Laravel Eloquent models—not a BPMN server or low-code suite.
Do I need Filament?
No. Core runs workflows without Filament. Filament Standard adds My Tasks, timelines, and resource actions.
Do I need Pro?
No. Pro Builder is optional visual authoring. Core and Filament Standard are enough to evaluate.
Can I start with one model?
Yes. Pick one business object, add HasWorkflow, and expand when it proves useful.
Can I keep my existing business logic?
Yes. DBFlow manages workflow state and audit trails. Your services and rules stay in control.
What is the current maturity level?
Core and Filament Standard are 1.1 stable on Packagist. DBFlow Pro is a commercial 1.1 visual builder.
Can I remove DBFlow later?
Workflow state lives in separate dbflow_workflow_* tables, separate from your domain models.
More questions?
Community
·
Package status
Add approval workflows to your Laravel app
Try the live demo, install Core, or explore Pro.