// app/Domains/Inventory/Actions/AdjustStockAction.php
namespace App\Domains\Inventory\Actions;
use App\Domains\Inventory\Data\StockAdjustmentData;
use App\Domains\Inventory\Events\StockAdjustedEvent;
final class AdjustStockAction
{
public static function run(StockAdjustmentData $data): StockRecord
{
// Enforce domain invariants
$stock = StockRecord::findOrFail($data->skuId);
$stock->mutateQuantity($data->quantity);
// Emit decoupled domain event
StockAdjustedEvent::dispatch($stock);
return $stock;
}
}
// Unified fluent domain gateway access from anywhere in your app
// Calling your domain through IUM's fluent interface
$stockData = StockAdjustmentData::from([
'skuId' => $item->sku,
'quantity' => +10,
'reason' => 'Restock received',
]);
// Single, type-checked compile-safe call:
$record = ium()->inventory()->stock()->adjust($stockData);
// Fluid CQRS read query without overhead:
$available = ium()->inventory()->stock()->available($item->sku);
// plugins/inventory-addon/src/InventoryAddonServiceProvider.php
namespace Plugins\Inventory;
use Obelaw\Twist\Base\AddonServiceProvider;
use Obelaw\Twist\Facades\Twist;
class InventoryAddonServiceProvider extends AddonServiceProvider
{
public function registerAddon(): void
{
Twist::addon('inventory')
->title('Inventory Management')
->resources([
StockResource::class,
WarehouseResource::class,
])
->multiTenant();
}
}
// Add dynamic EAV attributes and audit logging with Attrify & Trail
use Obelaw\Attrify\Traits\HasDynamicAttributes;
use Obelaw\Trail\Facades\Trail;
class Product extends Model
{
use HasDynamicAttributes;
}
// Attach custom attributes at runtime
$product->setAttributeValue('barcode', '978-3-16-148410-0');
// Record verified audit trail automatically
Trail::log(
'stock.adjusted',
"Adjusted SKU item by +10",
$product
);
