TenantAtlas/apps/platform/app/Support/OpsUx/BulkRunContext.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

68 lines
2.1 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\OpsUx;
use InvalidArgumentException;
final class BulkRunContext
{
/**
* @param array{entra_tenant_id?: mixed, directory_context_id?: mixed} $targetScope
* @param array{kind: string, ids_hash?: string, query_hash?: string} $selectionIdentity
* @param array<string, mixed> $extra
* @return array<string, mixed>
*/
public static function build(
string $operationType,
array $targetScope,
array $selectionIdentity,
string $fingerprint,
array $extra = [],
): array {
$targetScope = self::normalizeTargetScope($targetScope);
return array_merge($extra, [
'operation' => [
'type' => trim($operationType),
],
'target_scope' => $targetScope,
'selection' => $selectionIdentity,
'idempotency' => [
'fingerprint' => trim($fingerprint),
],
]);
}
/**
* @param array{entra_tenant_id?: mixed, directory_context_id?: mixed} $targetScope
* @return array{entra_tenant_id?: string, directory_context_id?: string}
*/
public static function normalizeTargetScope(array $targetScope): array
{
$entraTenantId = $targetScope['entra_tenant_id'] ?? null;
$directoryContextId = $targetScope['directory_context_id'] ?? null;
$normalized = [];
if (is_string($entraTenantId) && trim($entraTenantId) !== '') {
$normalized['entra_tenant_id'] = trim($entraTenantId);
}
if (is_string($directoryContextId) && trim($directoryContextId) !== '') {
$normalized['directory_context_id'] = trim($directoryContextId);
}
if (is_int($directoryContextId)) {
$normalized['directory_context_id'] = (string) $directoryContextId;
}
if (! isset($normalized['entra_tenant_id']) && ! isset($normalized['directory_context_id'])) {
throw new InvalidArgumentException('Target scope must include entra_tenant_id or directory_context_id.');
}
return $normalized;
}
}