## 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
85 lines
2.3 KiB
PHP
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;
|
|
}
|
|
}
|