3neti / x-campaign
Beneficiary distribution and campaign orchestration package for the x-change Settlement Operating System
Maintainers
Requires
- php: ^8.2
- illuminate/support: ^12.0 || ^13.0
- phpoffice/phpspreadsheet: ^5.0
- spatie/laravel-data: ^4.0
Requires (Dev)
- laravel/pint: ^1.0
- orchestra/testbench: ^10.0 || ^11.0
- pestphp/pest: ^3.8 || ^4.0
- pestphp/pest-plugin-laravel: ^3.2 || ^4.0
This package is auto-updated.
Last update: 2026-08-01 06:21:41 UTC
README
x-campaign is the beneficiary distribution platform for the x-change Settlement Operating System.
It owns campaign, audience, recipient, distribution, engagement, attribution, and analytics scaffolding.
It does not own voucher execution, claim lifecycle, disbursement, settlement, notification transport, wallet mutation, or Pay Code generation.
Install
composer require 3neti/x-campaign
Laravel discovers XCampaignServiceProvider automatically. Publish and run the package migrations through the consuming application's normal deployment process.
Responsibilities
- encrypted beneficiary worksheet staging and import;
- worksheet validation, freezing, and authorization evidence;
- provider-neutral fulfillment plans and beneficiary result projections;
- portable Pay Code generation, delivery handoff, and claim-visibility planning;
- append-only campaign activity and export-ready read models.
Runtime execution remains in the consuming settlement application. Planning services never send notifications, move funds, execute provider calls, or issue Pay Codes directly.
Compatibility
- PHP 8.3 or 8.4
- Laravel 12 or 13
- Pest 3 or 4 for package development
Quality gates
composer validate --strict
vendor/bin/pint --test
composer test
composer audit