TenantAtlas/tests/Feature/Operations/AssignmentRunSummaryCountsTest.php
ahmido 03127a670b Spec 096: Ops polish (assignment summaries + dedupe + reconcile tracking + seed DX) (#115)
Implements Spec 096 ops polish bundle:

- Persist durable OperationRun.summary_counts for assignment fetch/restore (final attempt wins)
- Server-side dedupe for assignment jobs (15-minute cooldown + non-canonical skip)
- Track ReconcileAdapterRunsJob via workspace-scoped OperationRun + stable failure codes + overlap prevention
- Seed DX: ensure seeded tenants use UUID v4 external_id and seed satisfies workspace_id NOT NULL constraints

Verification (local / evidence-based):
- `vendor/bin/sail artisan test --compact tests/Feature/Operations/AssignmentRunSummaryCountsTest.php tests/Feature/Operations/AssignmentJobDedupeTest.php tests/Feature/Operations/ReconcileAdapterRunsJobTrackingTest.php tests/Feature/Seed/PoliciesSeederExternalIdTest.php`
- `vendor/bin/sail bin pint --dirty`

Spec artifacts included under `specs/096-ops-polish-assignment-dedupe-system-tracking/` (spec/plan/tasks/checklists).

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #115
2026-02-15 20:49:38 +00:00

147 lines
4.7 KiB
PHP

<?php
use App\Jobs\FetchAssignmentsJob;
use App\Jobs\RestoreAssignmentsJob;
use App\Models\BackupItem;
use App\Models\BackupSet;
use App\Models\OperationRun;
use App\Models\RestoreRun;
use App\Models\Tenant;
use App\Services\AssignmentBackupService;
use App\Services\AssignmentRestoreService;
use App\Services\OperationRunService;
use Illuminate\Foundation\Testing\RefreshDatabase;
uses(RefreshDatabase::class);
test('fetch assignment job persists terminal summary counts and overwrites previous values', function (): void {
$tenant = Tenant::factory()->create();
$backupSet = BackupSet::factory()->create([
'tenant_id' => (int) $tenant->getKey(),
]);
$backupItem = BackupItem::factory()->create([
'tenant_id' => (int) $tenant->getKey(),
'backup_set_id' => (int) $backupSet->getKey(),
'policy_type' => 'settingsCatalogPolicy',
'policy_identifier' => 'policy-fetch-summary',
'metadata' => [],
]);
$operationRun = OperationRun::factory()->for($tenant)->create([
'workspace_id' => (int) $tenant->workspace_id,
'type' => 'assignments.fetch',
'status' => 'queued',
'outcome' => 'pending',
'summary_counts' => [
'total' => 99,
'processed' => 99,
'failed' => 99,
],
]);
$assignmentBackupService = \Mockery::mock(AssignmentBackupService::class);
$assignmentBackupService->shouldReceive('enrichWithAssignments')
->once()
->andReturnUsing(function (BackupItem $item): BackupItem {
$metadata = is_array($item->metadata) ? $item->metadata : [];
$metadata['assignments_fetch_failed'] = false;
$item->update([
'metadata' => $metadata,
'assignments' => [
['id' => 'assignment-1'],
],
]);
return $item->refresh();
});
$job = new FetchAssignmentsJob(
backupItemId: (int) $backupItem->getKey(),
tenantExternalId: (string) $tenant->external_id,
policyExternalId: (string) $backupItem->policy_identifier,
policyPayload: ['id' => (string) $backupItem->policy_identifier],
operationRun: $operationRun,
);
$job->handle($assignmentBackupService, app(OperationRunService::class));
$operationRun->refresh();
expect($operationRun->status)->toBe('completed')
->and($operationRun->outcome)->toBe('succeeded')
->and($operationRun->summary_counts)->toMatchArray([
'total' => 1,
'processed' => 1,
'failed' => 0,
]);
});
test('restore assignment job persists terminal summary counts and overwrites previous values', function (): void {
$tenant = Tenant::factory()->create();
$backupSet = BackupSet::factory()->create([
'tenant_id' => (int) $tenant->getKey(),
]);
$restoreRun = RestoreRun::factory()->create([
'tenant_id' => (int) $tenant->getKey(),
'backup_set_id' => (int) $backupSet->getKey(),
]);
$operationRun = OperationRun::factory()->for($tenant)->create([
'workspace_id' => (int) $tenant->workspace_id,
'type' => 'assignments.restore',
'status' => 'queued',
'outcome' => 'pending',
'summary_counts' => [
'total' => 88,
'processed' => 88,
'failed' => 88,
],
]);
$assignmentRestoreService = \Mockery::mock(AssignmentRestoreService::class);
$assignmentRestoreService->shouldReceive('restore')
->once()
->andReturn([
'outcomes' => [
['status' => 'success'],
['status' => 'success'],
['status' => 'failed', 'reason' => 'Graph request failed'],
],
'summary' => [
'success' => 2,
'failed' => 1,
'skipped' => 0,
],
]);
$job = new RestoreAssignmentsJob(
restoreRunId: (int) $restoreRun->getKey(),
tenantId: (int) $tenant->getKey(),
policyType: 'settingsCatalogPolicy',
policyId: 'policy-restore-summary',
assignments: [
['id' => 'assignment-1'],
['id' => 'assignment-2'],
['id' => 'assignment-3'],
],
groupMapping: [],
foundationMapping: [],
operationRun: $operationRun,
);
$job->handle($assignmentRestoreService, app(OperationRunService::class));
$operationRun->refresh();
expect($operationRun->status)->toBe('completed')
->and($operationRun->outcome)->toBe('partially_succeeded')
->and($operationRun->summary_counts)->toMatchArray([
'total' => 3,
'processed' => 3,
'failed' => 1,
]);
});