A free open source IT asset/license management system
<?php
namespace Tests\Feature\AssetModels\Ui;
use App\Enums\CheckoutRequestState;
use App\Models\Asset;
use App\Models\AssetModel;
use App\Models\CheckoutRequest;
use App\Models\Statuslabel;
use App\Models\User;
use Illuminate\Support\Facades\Notification;
use Tests\TestCase;
/**
* Bulk-fulfill flow for AssetModel. Distinct from the qty-tracked
* types because each row hands out a specific Asset OF the model
* (not a qty count). The controller iterates ticked rows and
* lockForUpdates each target asset before checkout - the double-
* assignment race and hand-crafted-POST collision cases are both
* covered by the per-row assigned_to guard.
*/
class BulkFulfillAssetModelTest extends TestCase
{
protected function setUp(): void
{
parent::setUp();
Notification::fake();
}
public function test_requires_asset_checkout_permission(): void
{
// Model requests fulfill via asset checkout, so the gate
// is checkoutAssets (not a nonexistent models.checkout).
$model = AssetModel::factory()->create();
$this->actingAs(User::factory()->create())
->get(route('models.fulfill-requests.create', $model))
->assertForbidden();
}
public function test_fulfills_ticked_rows_with_distinct_assets(): void
{
// Happy path: two rows tick with different asset ids from
// the pool; both check out cleanly to their requesters.
$admin = User::factory()->checkoutAssets()->create();
$model = AssetModel::factory()->create();
$status = Statuslabel::factory()->rtd()->create();
$assetA = Asset::factory()->create(['model_id' => $model->id, 'status_id' => $status->id]);
$assetB = Asset::factory()->create(['model_id' => $model->id, 'status_id' => $status->id]);
$alice = User::factory()->create();
$bob = User::factory()->create();
$aliceReq = CheckoutRequest::factory()->create([
'user_id' => $alice->id,
'requestable_id' => $model->id,
'requestable_type' => AssetModel::class,
]);
$bobReq = CheckoutRequest::factory()->create([
'user_id' => $bob->id,
'requestable_id' => $model->id,
'requestable_type' => AssetModel::class,
]);
$this->actingAs($admin)
->post(route('models.fulfill-requests.store', $model), [
'enabled_requests' => [$aliceReq->id => '1', $bobReq->id => '1'],
'asset_id' => [
$aliceReq->id => $assetA->id,
$bobReq->id => $assetB->id,
],
'notes' => [],
])
->assertRedirect(route('requests.index'));
$this->assertSame(CheckoutRequestState::Fulfilled, $aliceReq->fresh()->state);
$this->assertSame(CheckoutRequestState::Fulfilled, $bobReq->fresh()->state);
$this->assertSame($alice->id, (int) $assetA->fresh()->assigned_to);
$this->assertSame($bob->id, (int) $assetB->fresh()->assigned_to);
}
public function test_double_assignment_of_same_asset_wins_first_row_only(): void
{
// Two rows accidentally point at the SAME asset id
// (admin misclicked auto-pick, or hand-crafted POST, or
// JS drift). Sequential per-row lockForUpdate + assigned_to
// check means row 1 checks out, row 2 sees the asset now
// taken and skips with row_asset_taken. Second requester's
// request stays pending on the queue.
$admin = User::factory()->checkoutAssets()->create();
$model = AssetModel::factory()->create();
$status = Statuslabel::factory()->rtd()->create();
$asset = Asset::factory()->create(['model_id' => $model->id, 'status_id' => $status->id]);
$alice = User::factory()->create();
$bob = User::factory()->create();
$aliceReq = CheckoutRequest::factory()->create([
'user_id' => $alice->id,
'requestable_id' => $model->id,
'requestable_type' => AssetModel::class,
]);
$bobReq = CheckoutRequest::factory()->create([
'user_id' => $bob->id,
'requestable_id' => $model->id,
'requestable_type' => AssetModel::class,
]);
$this->actingAs($admin)
->post(route('models.fulfill-requests.store', $model), [
'enabled_requests' => [$aliceReq->id => '1', $bobReq->id => '1'],
'asset_id' => [
$aliceReq->id => $asset->id,
$bobReq->id => $asset->id,
],
'notes' => [],
])
->assertRedirect(route('requests.index'));
// First row wins the asset.
$this->assertSame(CheckoutRequestState::Fulfilled, $aliceReq->fresh()->state);
$this->assertSame($alice->id, (int) $asset->fresh()->assigned_to);
// Second row's request stays pending - the admin can pick
// a different asset (or wait for stock) on a later pass.
$this->assertSame(CheckoutRequestState::Pending, $bobReq->fresh()->state);
}
public function test_asset_from_a_different_model_is_rejected(): void
{
// Guard against hand-crafted POSTs pointing at an asset
// that isn't of this model (would silently check out the
// wrong physical unit).
$admin = User::factory()->checkoutAssets()->create();
$model = AssetModel::factory()->create();
$otherModel = AssetModel::factory()->create();
$status = Statuslabel::factory()->rtd()->create();
$offModelAsset = Asset::factory()->create(['model_id' => $otherModel->id, 'status_id' => $status->id]);
$requester = User::factory()->create();
$request = CheckoutRequest::factory()->create([
'user_id' => $requester->id,
'requestable_id' => $model->id,
'requestable_type' => AssetModel::class,
]);
$this->actingAs($admin)
->post(route('models.fulfill-requests.store', $model), [
'enabled_requests' => [$request->id => '1'],
'asset_id' => [$request->id => $offModelAsset->id],
'notes' => [],
])
->assertRedirect(route('requests.index'));
$this->assertSame(CheckoutRequestState::Pending, $request->fresh()->state);
$this->assertNull($offModelAsset->fresh()->assigned_to);
}
}