TenantAtlas/apps/platform/app/Support/RestoreRunIdempotency.php
ahmido ce0615a9c1 Spec 182: relocate Laravel platform to apps/platform (#213)
## Summary
- move the Laravel application into `apps/platform` and keep the repository root for orchestration, docs, and tooling
- update the local command model, Sail/Docker wiring, runtime paths, and ignore rules around the new platform location
- add relocation quickstart/contracts plus focused smoke coverage for bootstrap, command model, routes, and runtime behavior

## Validation
- `cd apps/platform && ./vendor/bin/sail artisan test --compact tests/Feature/PlatformRelocation`
- integrated browser smoke validated `/up`, `/`, `/admin`, `/admin/choose-workspace`, and tenant route semantics for `200`, `403`, and `404`

## Remaining Rollout Checks
- validate Dokploy build context and working-directory assumptions against the new `apps/platform` layout
- confirm web, queue, and scheduler processes all start from the expected working directory in staging/production
- verify no legacy volume mounts or asset-publish paths still point at the old root-level `public/` or `storage/` locations

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #213
2026-04-08 08:40:47 +00:00

85 lines
2.3 KiB
PHP

<?php
namespace App\Support;
use App\Models\RestoreRun;
use Illuminate\Support\Arr;
final class RestoreRunIdempotency
{
/**
* @param array<string, mixed> $context
*/
public static function buildKey(int $tenantId, string $operationType, string|int|null $targetId = null, array $context = []): string
{
$payload = [
'tenant_id' => $tenantId,
'operation_type' => trim($operationType),
'target_id' => $targetId === null ? null : (string) $targetId,
'context' => self::canonicalize($context),
];
return hash('sha256', json_encode($payload, JSON_THROW_ON_ERROR));
}
public static function findActiveRestoreRun(int $tenantId, string $idempotencyKey): ?RestoreRun
{
return RestoreRun::query()
->where('tenant_id', $tenantId)
->where('idempotency_key', $idempotencyKey)
->whereIn('status', ['queued', 'running'])
->latest('id')
->first();
}
/**
* Deterministic idempotency key for a live restore execution.
*
* @param array<int>|null $selectedItemIds
* @param array<string, string> $groupMapping
*/
public static function restoreExecuteKey(
int $tenantId,
int $backupSetId,
?array $selectedItemIds,
array $groupMapping = [],
): string {
$scopeIds = $selectedItemIds;
if (is_array($scopeIds)) {
$scopeIds = array_values(array_unique(array_map('intval', $scopeIds)));
sort($scopeIds);
}
return self::buildKey(
tenantId: $tenantId,
operationType: 'restore.execute',
targetId: (string) $backupSetId,
context: [
'scope' => $scopeIds,
'group_mapping' => $groupMapping,
],
);
}
/**
* @param array<string, mixed> $value
* @return array<string, mixed>
*/
private static function canonicalize(array $value): array
{
$value = Arr::map($value, function (mixed $item): mixed {
if (is_array($item)) {
/** @var array<string, mixed> $item */
return static::canonicalize($item);
}
return $item;
});
ksort($value);
return $value;
}
}