TenantAtlas/app/Filament/Resources/InventorySyncRunResource.php

<?php

namespace App\Filament\Resources;

use App\Filament\Clusters\Inventory\InventoryCluster;
use App\Filament\Resources\InventorySyncRunResource\Pages;
use App\Models\InventorySyncRun;
use App\Models\Tenant;
use App\Models\User;
use App\Services\Auth\CapabilityResolver;
use App\Support\Auth\Capabilities;
use App\Support\Badges\BadgeDomain;
use App\Support\Badges\BadgeRenderer;
use App\Support\OperationRunLinks;
use App\Support\Ui\ActionSurface\ActionSurfaceDeclaration;
use App\Support\Ui\ActionSurface\Enums\ActionSurfaceInspectAffordance;
use App\Support\Ui\ActionSurface\Enums\ActionSurfaceProfile;
use App\Support\Ui\ActionSurface\Enums\ActionSurfaceSlot;
use BackedEnum;
use Filament\Infolists\Components\TextEntry;
use Filament\Infolists\Components\ViewEntry;
use Filament\Resources\Resource;
use Filament\Schemas\Components\Section;
use Filament\Schemas\Schema;
use Filament\Tables;
use Filament\Tables\Table;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use UnitEnum;

class InventorySyncRunResource extends Resource
{
    protected static ?string $model = InventorySyncRun::class;

    protected static bool $shouldRegisterNavigation = true;

    protected static ?string $cluster = InventoryCluster::class;

    protected static ?int $navigationSort = 2;

    protected static string|BackedEnum|null $navigationIcon = 'heroicon-o-clock';

    protected static string|UnitEnum|null $navigationGroup = 'Inventory';

    public static function actionSurfaceDeclaration(): ActionSurfaceDeclaration
    {
        return ActionSurfaceDeclaration::forResource(ActionSurfaceProfile::RunLog)
            ->exempt(ActionSurfaceSlot::ListHeader, 'Inventory sync runs list intentionally has no header actions; sync is started from Inventory surfaces.')
            ->satisfy(ActionSurfaceSlot::InspectAffordance, ActionSurfaceInspectAffordance::ClickableRow->value)
            ->exempt(ActionSurfaceSlot::ListBulkMoreGroup, 'Bulk actions are intentionally omitted for sync-run records.')
            ->exempt(ActionSurfaceSlot::ListEmptyState, 'Empty-state CTA is intentionally omitted; sync runs appear after initiating inventory sync.')
            ->exempt(ActionSurfaceSlot::DetailHeader, 'View page is informational and currently has no header actions.');
    }

    public static function canViewAny(): bool
    {
        $tenant = Tenant::current();
        $user = auth()->user();

        if (! $tenant instanceof Tenant || ! $user instanceof User) {
            return false;
        }

        /** @var CapabilityResolver $resolver */
        $resolver = app(CapabilityResolver::class);

        return $resolver->can($user, $tenant, Capabilities::TENANT_VIEW);
    }

    public static function canView(Model $record): bool
    {
        $tenant = Tenant::current();
        $user = auth()->user();

        if (! $tenant instanceof Tenant || ! $user instanceof User) {
            return false;
        }

        /** @var CapabilityResolver $resolver */
        $resolver = app(CapabilityResolver::class);

        if (! $resolver->can($user, $tenant, Capabilities::TENANT_VIEW)) {
            return false;
        }

        if ($record instanceof InventorySyncRun) {
            return (int) $record->tenant_id === (int) $tenant->getKey();
        }

        return true;
    }

    public static function getNavigationLabel(): string
    {
        return 'Sync History';
    }

    public static function form(Schema $schema): Schema
    {
        return $schema;
    }

    public static function infolist(Schema $schema): Schema
    {
        return $schema
            ->schema([
                Section::make('Legacy run view')
                    ->description('Canonical monitoring is now available in Monitoring → Operations.')
                    ->schema([
                        TextEntry::make('canonical_view')
                            ->label('Canonical view')
                            ->state('View in Operations')
                            ->url(fn (InventorySyncRun $record): string => OperationRunLinks::index(Tenant::current() ?? $record->tenant))
                            ->badge()
                            ->color('primary'),
                    ])
                    ->columnSpanFull(),

                Section::make('Sync Run')
                    ->schema([
                        TextEntry::make('user.name')
                            ->label('Initiator')
                            ->placeholder('—'),
                        TextEntry::make('status')
                            ->badge()
                            ->formatStateUsing(BadgeRenderer::label(BadgeDomain::InventorySyncRunStatus))
                            ->color(BadgeRenderer::color(BadgeDomain::InventorySyncRunStatus))
                            ->icon(BadgeRenderer::icon(BadgeDomain::InventorySyncRunStatus))
                            ->iconColor(BadgeRenderer::iconColor(BadgeDomain::InventorySyncRunStatus)),
                        TextEntry::make('selection_hash')->label('Selection hash')->copyable(),
                        TextEntry::make('started_at')->dateTime(),
                        TextEntry::make('finished_at')->dateTime(),
                        TextEntry::make('items_observed_count')->label('Observed')->numeric(),
                        TextEntry::make('items_upserted_count')->label('Upserted')->numeric(),
                        TextEntry::make('errors_count')->label('Errors')->numeric(),
                        TextEntry::make('had_errors')
                            ->label('Had errors')
                            ->badge()
                            ->formatStateUsing(BadgeRenderer::label(BadgeDomain::BooleanHasErrors))
                            ->color(BadgeRenderer::color(BadgeDomain::BooleanHasErrors))
                            ->icon(BadgeRenderer::icon(BadgeDomain::BooleanHasErrors))
                            ->iconColor(BadgeRenderer::iconColor(BadgeDomain::BooleanHasErrors)),
                    ])
                    ->columns(2)
                    ->columnSpanFull(),

                Section::make('Selection Payload')
                    ->schema([
                        ViewEntry::make('selection_payload')
                            ->label('')
                            ->view('filament.infolists.entries.snapshot-json')
                            ->state(fn (InventorySyncRun $record) => $record->selection_payload ?? [])
                            ->columnSpanFull(),
                    ])
                    ->columnSpanFull(),

                Section::make('Error Summary')
                    ->schema([
                        ViewEntry::make('error_codes')
                            ->label('Error codes')
                            ->view('filament.infolists.entries.snapshot-json')
                            ->state(fn (InventorySyncRun $record) => $record->error_codes ?? [])
                            ->columnSpanFull(),
                        ViewEntry::make('error_context')
                            ->label('Safe error context')
                            ->view('filament.infolists.entries.snapshot-json')
                            ->state(fn (InventorySyncRun $record) => $record->error_context ?? [])
                            ->columnSpanFull(),
                    ])
                    ->columnSpanFull(),
            ]);
    }

    public static function table(Table $table): Table
    {
        return $table
            ->defaultSort('id', 'desc')
            ->columns([
                Tables\Columns\TextColumn::make('user.name')
                    ->label('Initiator')
                    ->placeholder('—')
                    ->toggleable(),
                Tables\Columns\TextColumn::make('status')
                    ->badge()
                    ->formatStateUsing(BadgeRenderer::label(BadgeDomain::InventorySyncRunStatus))
                    ->color(BadgeRenderer::color(BadgeDomain::InventorySyncRunStatus))
                    ->icon(BadgeRenderer::icon(BadgeDomain::InventorySyncRunStatus))
                    ->iconColor(BadgeRenderer::iconColor(BadgeDomain::InventorySyncRunStatus)),
                Tables\Columns\TextColumn::make('selection_hash')
                    ->label('Selection')
                    ->copyable()
                    ->limit(12),
                Tables\Columns\TextColumn::make('started_at')->since(),
                Tables\Columns\TextColumn::make('finished_at')->since(),
                Tables\Columns\TextColumn::make('items_observed_count')
                    ->label('Observed')
                    ->numeric(),
                Tables\Columns\TextColumn::make('items_upserted_count')
                    ->label('Upserted')
                    ->numeric(),
                Tables\Columns\TextColumn::make('errors_count')
                    ->label('Errors')
                    ->numeric(),
            ])
            ->recordUrl(static fn (Model $record): ?string => static::canView($record)
                ? static::getUrl('view', ['record' => $record])
                : null)
            ->actions([])
            ->bulkActions([]);
    }

    public static function getEloquentQuery(): Builder
    {
        $tenantId = Tenant::current()?->getKey();

        return parent::getEloquentQuery()
            ->with('user')
            ->when($tenantId, fn (Builder $query) => $query->where('tenant_id', $tenantId));
    }

    public static function getPages(): array
    {
        return [
            'index' => Pages\ListInventorySyncRuns::route('/'),
            'view' => Pages\ViewInventorySyncRun::route('/{record}'),
        ];
    }
}