<?php

declare(strict_types=1);

namespace App\Filament\Pages\Findings;

use App\Filament\Resources\FindingExceptionResource;
use App\Filament\Resources\FindingResource;
use App\Models\Finding;
use App\Models\Tenant;
use App\Models\User;
use App\Models\Workspace;
use App\Services\Auth\WorkspaceCapabilityResolver;
use App\Services\Findings\FindingAssignmentHygieneService;
use App\Support\Filament\CanonicalAdminTenantFilterState;
use App\Support\Filament\TablePaginationProfiles;
use App\Support\Navigation\CanonicalNavigationContext;
use App\Support\OperateHub\OperateHubShell;
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 App\Support\Ui\ActionSurface\Enums\ActionSurfaceType;
use App\Support\Workspaces\WorkspaceContext;
use BackedEnum;
use Filament\Actions\Action;
use Filament\Facades\Filament;
use Filament\Pages\Page;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Concerns\InteractsWithTable;
use Filament\Tables\Contracts\HasTable;
use Filament\Tables\Filters\SelectFilter;
use Filament\Tables\Table;
use Illuminate\Database\Eloquent\Builder;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
use UnitEnum;

class FindingsHygieneReport extends Page implements HasTable
{
    use InteractsWithTable;

    protected static bool $isDiscovered = false;

    protected static bool $shouldRegisterNavigation = false;

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

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

    protected static ?string $title = 'Findings hygiene report';

    protected static ?string $slug = 'findings/hygiene';

    protected string $view = 'filament.pages.findings.findings-hygiene-report';

    /**
     * @var array<int, Tenant>|null
     */
    private ?array $visibleTenants = null;

    private ?Workspace $workspace = null;

    public string $reasonFilter = FindingAssignmentHygieneService::FILTER_ALL;

    public static function actionSurfaceDeclaration(): ActionSurfaceDeclaration
    {
        return ActionSurfaceDeclaration::forPage(ActionSurfaceProfile::ListOnlyReadOnly, ActionSurfaceType::ReadOnlyRegistryReport)
            ->satisfy(ActionSurfaceSlot::ListHeader, 'Header controls keep the hygiene scope fixed and expose only fixed reason views plus tenant-prefilter recovery when needed.')
            ->satisfy(ActionSurfaceSlot::InspectAffordance, ActionSurfaceInspectAffordance::ClickableRow->value)
            ->exempt(ActionSurfaceSlot::ListRowMoreMenu, 'The hygiene report stays read-only and exposes row click as the only inspect path.')
            ->exempt(ActionSurfaceSlot::ListBulkMoreGroup, 'The hygiene report does not expose bulk actions.')
            ->satisfy(ActionSurfaceSlot::ListEmptyState, 'The empty state stays calm and only offers a tenant-prefilter reset when the active tenant filter hides otherwise visible issues.')
            ->exempt(ActionSurfaceSlot::DetailHeader, 'Repair remains on the existing tenant finding detail surface.');
    }

    public function mount(): void
    {
        $this->reasonFilter = $this->resolveRequestedReasonFilter();
        $this->authorizePageAccess();

        app(CanonicalAdminTenantFilterState::class)->sync(
            $this->getTableFiltersSessionKey(),
            [],
            request(),
        );

        $this->applyRequestedTenantPrefilter();
        $this->mountInteractsWithTable();
        $this->normalizeTenantFilterState();
    }

    protected function getHeaderActions(): array
    {
        return [
            Action::make('clear_tenant_filter')
                ->label('Clear tenant filter')
                ->icon('heroicon-o-x-mark')
                ->color('gray')
                ->visible(fn (): bool => $this->currentTenantFilterId() !== null)
                ->action(fn (): mixed => $this->clearTenantFilter()),
        ];
    }

    public function table(Table $table): Table
    {
        return $table
            ->query(fn (): Builder => $this->issueBaseQuery())
            ->paginated(TablePaginationProfiles::customPage())
            ->persistFiltersInSession()
            ->columns([
                TextColumn::make('tenant.name')
                    ->label('Tenant'),
                TextColumn::make('subject_display_name')
                    ->label('Finding')
                    ->state(fn (Finding $record): string => $record->resolvedSubjectDisplayName() ?? 'Finding #'.$record->getKey())
                    ->wrap(),
                TextColumn::make('owner')
                    ->label('Owner')
                    ->state(fn (Finding $record): string => FindingResource::accountableOwnerDisplayFor($record)),
                TextColumn::make('assignee')
                    ->label('Assignee')
                    ->state(fn (Finding $record): string => FindingResource::activeAssigneeDisplayFor($record))
                    ->description(fn (Finding $record): ?string => $this->assigneeContext($record)),
                TextColumn::make('due_at')
                    ->label('Due')
                    ->dateTime()
                    ->placeholder('—')
                    ->description(fn (Finding $record): ?string => FindingExceptionResource::relativeTimeDescription($record->due_at) ?? FindingResource::dueAttentionLabelFor($record)),
                TextColumn::make('hygiene_reasons')
                    ->label('Hygiene reason')
                    ->state(fn (Finding $record): string => implode(', ', $this->hygieneService()->reasonLabelsFor($record)))
                    ->wrap(),
                TextColumn::make('last_workflow_activity')
                    ->label('Last workflow activity')
                    ->state(fn (Finding $record): mixed => $this->hygieneService()->lastWorkflowActivityAt($record))
                    ->dateTime()
                    ->placeholder('—')
                    ->description(fn (Finding $record): ?string => FindingExceptionResource::relativeTimeDescription($this->hygieneService()->lastWorkflowActivityAt($record))),
            ])
            ->filters([
                SelectFilter::make('tenant_id')
                    ->label('Tenant')
                    ->options(fn (): array => $this->tenantFilterOptions())
                    ->searchable(),
            ])
            ->actions([])
            ->bulkActions([])
            ->recordUrl(fn (Finding $record): string => $this->findingDetailUrl($record))
            ->emptyStateHeading(fn (): string => $this->emptyState()['title'])
            ->emptyStateDescription(fn (): string => $this->emptyState()['body'])
            ->emptyStateIcon(fn (): string => $this->emptyState()['icon'])
            ->emptyStateActions($this->emptyStateActions());
    }

    /**
     * @return array<string, mixed>
     */
    public function appliedScope(): array
    {
        $tenant = $this->filteredTenant();

        return [
            'workspace_scoped' => true,
            'fixed_scope' => 'visible_findings_hygiene_only',
            'reason_filter' => $this->currentReasonFilter(),
            'reason_filter_label' => $this->hygieneService()->filterLabel($this->currentReasonFilter()),
            'tenant_prefilter_source' => $this->tenantPrefilterSource(),
            'tenant_label' => $tenant?->name,
        ];
    }

    /**
     * @return array<int, array<string, mixed>>
     */
    public function availableFilters(): array
    {
        return [
            [
                'key' => 'hygiene_scope',
                'label' => 'Findings hygiene only',
                'fixed' => true,
                'options' => [],
            ],
            [
                'key' => 'tenant',
                'label' => 'Tenant',
                'fixed' => false,
                'options' => collect($this->visibleTenants())
                    ->map(fn (Tenant $tenant): array => [
                        'value' => (string) $tenant->getKey(),
                        'label' => (string) $tenant->name,
                    ])
                    ->values()
                    ->all(),
            ],
        ];
    }

    /**
     * @return array<int, array<string, mixed>>
     */
    public function availableReasonFilters(): array
    {
        $summary = $this->summaryCounts();
        $currentFilter = $this->currentReasonFilter();

        return [
            [
                'key' => FindingAssignmentHygieneService::FILTER_ALL,
                'label' => 'All issues',
                'active' => $currentFilter === FindingAssignmentHygieneService::FILTER_ALL,
                'badge_count' => $summary['unique_issue_count'],
                'url' => $this->reportUrl(['reason' => null]),
            ],
            [
                'key' => FindingAssignmentHygieneService::REASON_BROKEN_ASSIGNMENT,
                'label' => 'Broken assignment',
                'active' => $currentFilter === FindingAssignmentHygieneService::REASON_BROKEN_ASSIGNMENT,
                'badge_count' => $summary['broken_assignment_count'],
                'url' => $this->reportUrl(['reason' => FindingAssignmentHygieneService::REASON_BROKEN_ASSIGNMENT]),
            ],
            [
                'key' => FindingAssignmentHygieneService::REASON_STALE_IN_PROGRESS,
                'label' => 'Stale in progress',
                'active' => $currentFilter === FindingAssignmentHygieneService::REASON_STALE_IN_PROGRESS,
                'badge_count' => $summary['stale_in_progress_count'],
                'url' => $this->reportUrl(['reason' => FindingAssignmentHygieneService::REASON_STALE_IN_PROGRESS]),
            ],
        ];
    }

    /**
     * @return array{unique_issue_count: int, broken_assignment_count: int, stale_in_progress_count: int}
     */
    public function summaryCounts(): array
    {
        $workspace = $this->workspace();
        $user = auth()->user();

        if (! $workspace instanceof Workspace || ! $user instanceof User) {
            return [
                'unique_issue_count' => 0,
                'broken_assignment_count' => 0,
                'stale_in_progress_count' => 0,
            ];
        }

        return $this->hygieneService()->summary(
            $workspace,
            $user,
            $this->currentTenantFilterId(),
        );
    }

    /**
     * @return array<string, mixed>
     */
    public function emptyState(): array
    {
        if ($this->tenantFilterAloneExcludesRows()) {
            return [
                'title' => 'No hygiene issues match this tenant scope',
                'body' => 'Your current tenant filter is hiding hygiene issues that are still visible elsewhere in this workspace.',
                'icon' => 'heroicon-o-funnel',
                'action_name' => 'clear_tenant_filter_empty',
                'action_label' => 'Clear tenant filter',
                'action_kind' => 'clear_tenant_filter',
            ];
        }

        if ($this->reasonFilterAloneExcludesRows()) {
            return [
                'title' => 'No findings match this hygiene reason',
                'body' => 'The current fixed reason view is narrower than the visible issue set in this workspace.',
                'icon' => 'heroicon-o-adjustments-horizontal',
            ];
        }

        return [
            'title' => 'No visible hygiene issues right now',
            'body' => 'Visible broken assignments and stale in-progress work are currently calm across the entitled tenant scope.',
            'icon' => 'heroicon-o-wrench-screwdriver',
        ];
    }

    public function updatedTableFilters(): void
    {
        $this->normalizeTenantFilterState();
    }

    public function clearTenantFilter(): void
    {
        $this->removeTableFilter('tenant_id');
        $this->resetTable();
    }

    /**
     * @return array<int, Tenant>
     */
    public function visibleTenants(): array
    {
        if ($this->visibleTenants !== null) {
            return $this->visibleTenants;
        }

        $workspace = $this->workspace();
        $user = auth()->user();

        if (! $workspace instanceof Workspace || ! $user instanceof User) {
            return $this->visibleTenants = [];
        }

        return $this->visibleTenants = $this->hygieneService()->visibleTenants($workspace, $user);
    }

    private function authorizePageAccess(): void
    {
        $user = auth()->user();
        $workspace = $this->workspace();

        if (! $user instanceof User) {
            abort(403);
        }

        if (! $workspace instanceof Workspace) {
            throw new NotFoundHttpException;
        }

        if (! app(WorkspaceCapabilityResolver::class)->isMember($user, $workspace)) {
            throw new NotFoundHttpException;
        }
    }

    private function workspace(): ?Workspace
    {
        if ($this->workspace instanceof Workspace) {
            return $this->workspace;
        }

        $workspaceId = app(WorkspaceContext::class)->currentWorkspaceId(request());

        if (! is_int($workspaceId)) {
            return null;
        }

        return $this->workspace = Workspace::query()->whereKey($workspaceId)->first();
    }

    /**
     * @return Builder<Finding>
     */
    private function issueBaseQuery(): Builder
    {
        $workspace = $this->workspace();
        $user = auth()->user();

        if (! $workspace instanceof Workspace || ! $user instanceof User) {
            return Finding::query()->whereRaw('1 = 0');
        }

        return $this->hygieneService()->issueQuery(
            $workspace,
            $user,
            tenantId: null,
            reasonFilter: $this->currentReasonFilter(),
            applyOrdering: true,
        );
    }

    /**
     * @return Builder<Finding>
     */
    private function filteredIssueQuery(bool $includeTenantFilter = true, ?string $reasonFilter = null): Builder
    {
        $workspace = $this->workspace();
        $user = auth()->user();

        if (! $workspace instanceof Workspace || ! $user instanceof User) {
            return Finding::query()->whereRaw('1 = 0');
        }

        return $this->hygieneService()->issueQuery(
            $workspace,
            $user,
            tenantId: $includeTenantFilter ? $this->currentTenantFilterId() : null,
            reasonFilter: $reasonFilter ?? $this->currentReasonFilter(),
            applyOrdering: true,
        );
    }

    /**
     * @return array<string, string>
     */
    private function tenantFilterOptions(): array
    {
        return collect($this->visibleTenants())
            ->mapWithKeys(static fn (Tenant $tenant): array => [
                (string) $tenant->getKey() => (string) $tenant->name,
            ])
            ->all();
    }

    private function applyRequestedTenantPrefilter(): void
    {
        $requestedTenant = request()->query('tenant');

        if (! is_string($requestedTenant) && ! is_numeric($requestedTenant)) {
            return;
        }

        foreach ($this->visibleTenants() as $tenant) {
            if ((string) $tenant->getKey() !== (string) $requestedTenant && (string) $tenant->external_id !== (string) $requestedTenant) {
                continue;
            }

            $this->tableFilters['tenant_id']['value'] = (string) $tenant->getKey();
            $this->tableDeferredFilters['tenant_id']['value'] = (string) $tenant->getKey();

            return;
        }
    }

    private function normalizeTenantFilterState(): void
    {
        $configuredTenantFilter = data_get($this->currentFiltersState(), 'tenant_id.value');

        if ($configuredTenantFilter === null || $configuredTenantFilter === '') {
            return;
        }

        if ($this->currentTenantFilterId() !== null) {
            return;
        }

        $this->removeTableFilter('tenant_id');
    }

    /**
     * @return array<string, mixed>
     */
    private function currentFiltersState(): array
    {
        $persisted = session()->get($this->getTableFiltersSessionKey(), []);

        return array_replace_recursive(
            is_array($persisted) ? $persisted : [],
            $this->tableFilters ?? [],
        );
    }

    private function currentTenantFilterId(): ?int
    {
        $tenantFilter = data_get($this->currentFiltersState(), 'tenant_id.value');

        if (! is_numeric($tenantFilter)) {
            return null;
        }

        $tenantId = (int) $tenantFilter;

        foreach ($this->visibleTenants() as $tenant) {
            if ((int) $tenant->getKey() === $tenantId) {
                return $tenantId;
            }
        }

        return null;
    }

    private function filteredTenant(): ?Tenant
    {
        $tenantId = $this->currentTenantFilterId();

        if (! is_int($tenantId)) {
            return null;
        }

        foreach ($this->visibleTenants() as $tenant) {
            if ((int) $tenant->getKey() === $tenantId) {
                return $tenant;
            }
        }

        return null;
    }

    private function activeVisibleTenant(): ?Tenant
    {
        $activeTenant = app(OperateHubShell::class)->activeEntitledTenant(request());

        if (! $activeTenant instanceof Tenant) {
            return null;
        }

        foreach ($this->visibleTenants() as $tenant) {
            if ($tenant->is($activeTenant)) {
                return $tenant;
            }
        }

        return null;
    }

    private function tenantPrefilterSource(): string
    {
        $tenant = $this->filteredTenant();

        if (! $tenant instanceof Tenant) {
            return 'none';
        }

        $activeTenant = $this->activeVisibleTenant();

        if ($activeTenant instanceof Tenant && $activeTenant->is($tenant)) {
            return 'active_tenant_context';
        }

        return 'explicit_filter';
    }

    private function assigneeContext(Finding $record): ?string
    {
        if (! $this->hygieneService()->recordHasBrokenAssignment($record)) {
            return null;
        }

        if ($record->assigneeUser?->trashed()) {
            return 'Soft-deleted user';
        }

        return 'No current tenant membership';
    }

    private function tenantFilterAloneExcludesRows(): bool
    {
        if ($this->currentTenantFilterId() === null) {
            return false;
        }

        if ((clone $this->filteredIssueQuery())->exists()) {
            return false;
        }

        return (clone $this->filteredIssueQuery(includeTenantFilter: false))->exists();
    }

    private function reasonFilterAloneExcludesRows(): bool
    {
        if ($this->currentReasonFilter() === FindingAssignmentHygieneService::FILTER_ALL) {
            return false;
        }

        if ((clone $this->filteredIssueQuery())->exists()) {
            return false;
        }

        return (clone $this->filteredIssueQuery(includeTenantFilter: true, reasonFilter: FindingAssignmentHygieneService::FILTER_ALL))->exists();
    }

    private function findingDetailUrl(Finding $record): string
    {
        $tenant = $record->tenant;

        if (! $tenant instanceof Tenant) {
            return '#';
        }

        $url = FindingResource::getUrl('view', ['record' => $record], panel: 'tenant', tenant: $tenant);

        return $this->appendQuery($url, $this->navigationContext()->toQuery());
    }

    private function navigationContext(): CanonicalNavigationContext
    {
        return new CanonicalNavigationContext(
            sourceSurface: 'findings.hygiene',
            canonicalRouteName: static::getRouteName(Filament::getPanel('admin')),
            tenantId: $this->currentTenantFilterId(),
            backLinkLabel: 'Back to findings hygiene',
            backLinkUrl: $this->reportUrl(),
        );
    }

    private function reportUrl(array $overrides = []): string
    {
        $resolvedTenant = array_key_exists('tenant', $overrides)
            ? $overrides['tenant']
            : $this->filteredTenant()?->external_id;
        $resolvedReason = array_key_exists('reason', $overrides)
            ? $overrides['reason']
            : $this->currentReasonFilter();

        return static::getUrl(
            panel: 'admin',
            parameters: array_filter([
                'tenant' => is_string($resolvedTenant) && $resolvedTenant !== '' ? $resolvedTenant : null,
                'reason' => is_string($resolvedReason) && $resolvedReason !== FindingAssignmentHygieneService::FILTER_ALL
                    ? $resolvedReason
                    : null,
            ], static fn (mixed $value): bool => $value !== null && $value !== ''),
        );
    }

    private function resolveRequestedReasonFilter(): string
    {
        $requestedFilter = request()->query('reason');
        $availableFilters = $this->hygieneService()->filterOptions();

        return is_string($requestedFilter) && array_key_exists($requestedFilter, $availableFilters)
            ? $requestedFilter
            : FindingAssignmentHygieneService::FILTER_ALL;
    }

    private function currentReasonFilter(): string
    {
        $availableFilters = $this->hygieneService()->filterOptions();

        return array_key_exists($this->reasonFilter, $availableFilters)
            ? $this->reasonFilter
            : FindingAssignmentHygieneService::FILTER_ALL;
    }

    /**
     * @return array<int, Action>
     */
    private function emptyStateActions(): array
    {
        $emptyState = $this->emptyState();

        if (($emptyState['action_kind'] ?? null) !== 'clear_tenant_filter') {
            return [];
        }

        return [
            Action::make((string) $emptyState['action_name'])
                ->label((string) $emptyState['action_label'])
                ->icon('heroicon-o-arrow-right')
                ->color('gray')
                ->action(fn (): mixed => $this->clearTenantFilter()),
        ];
    }

    /**
     * @param  array<string, mixed>  $query
     */
    private function appendQuery(string $url, array $query): string
    {
        if ($query === []) {
            return $url;
        }

        return $url.(str_contains($url, '?') ? '&' : '?').http_build_query($query);
    }

    private function hygieneService(): FindingAssignmentHygieneService
    {
        return app(FindingAssignmentHygieneService::class);
    }
}