tessera-ctl/apps/web/src/app/(portal)/modules/tender-radar/page.tsx

'use client';

import { Suspense, useState } from 'react';
import { useTranslations } from 'next-intl';
import { useRouter, useSearchParams } from 'next/navigation';
import Link from 'next/link';
import { PageHeader } from '@/components/layout/page-header';
import { CoverageBanner } from './components/CoverageBanner';
import { FilterPanel } from './components/FilterPanel';
import { PollNowButton } from './components/PollNowButton';
import { ResultsList } from './components/ResultsList';
import { SavedSearchBar } from './components/SavedSearchBar';
import { TenderDetail } from './components/TenderDetail';

/**
 * Ausschreibungs-Radar module page within the portal.
 *
 * Replaces the Phase 10 placeholder (CONFIG-01 MVP stub) with the real
 * Trefferliste (Plan 11-01): CoverageBanner explains data coverage,
 * FilterPanel writes filter/sort state into the URL, ResultsList reads it
 * and renders the ~1671 existing DÖE tenders.
 *
 * Plan 11-04 (UI-02, D-07): the `?tender=<id>` URL param drives an
 * in-component detail view (TenderDetail) rendered as an overlay on top
 * of the list — deliberately NOT a separate Next.js sub-route, since this
 * page is mounted via `dynamic(..., { ssr: false })` under
 * `[category]/[moduleSlug]` (Anti-Pattern/Assumption A5). A row click in
 * ResultsList sets the param; closing the detail removes it.
 *
 * `useSearchParams()` (used by FilterPanel/ResultsList/this component)
 * requires a Suspense boundary per the Next.js App Router contract —
 * wrapped here even though this component is loaded via
 * `dynamic(..., { ssr: false })` (module-loader.ts), per the plan's
 * explicit Next 16 guidance.
 *
 * Plan 11-06 (FILTER-06, D-08/D-11): SavedSearchBar renders above
 * FilterPanel — it reads/writes the same URL searchParams FilterPanel
 * uses, so saving/loading a profile is congruent with the filter state the
 * user currently sees.
 *
 * Plan 14-05 (CONFIG-03/UI-06, D-10): all strings render via the
 * tenderRadar i18n namespace — no more hardcoded German literals.
 *
 * Quick 260723-lvg: PollNowButton sits next to the settings gear and
 * bumps `refreshKey` on a successful poll, driving a ResultsList refetch —
 * same parent-increments-refreshKey pattern DKV uses for
 * InvoiceHistoryTable (STATE decision 07-05).
 */
function TenderRadarContent() {
  const t = useTranslations('tenderRadar');
  const router = useRouter();
  const searchParams = useSearchParams();
  const tenderId = searchParams.get('tender');
  const [refreshKey, setRefreshKey] = useState(0);

  const closeDetail = () => {
    const next = new URLSearchParams(searchParams.toString());
    next.delete('tender');
    router.replace(`?${next.toString()}`);
  };

  return (
    <div className="mx-auto max-w-5xl space-y-6 p-3 sm:p-6">
      <PageHeader
        moduleSlug="tender-radar"
        title={t('page.title')}
        actions={
          <>
            {/*
             * Zahnrad-Link. Absolute literal href (NOT the dynamic
             * [category]/[moduleSlug] basePath): tender-radar routes only
             * exist as literal paths — the dynamic settings route returns
             * "Modul nicht gefunden" for this module, so the gear must point
             * at the literal path directly.
             *
             * Phase 17 Plan 03 (D-03): points at "Meine Quellen", not the
             * admin-only settings page — that's the page every module user
             * (not just administrators) is allowed to configure something
             * on; administrators reach the platform-wide settings from there
             * with one more click.
             */}
            <Link
              href="/modules/tender-radar/my-sources"
              className="btn btn-secondary btn-icon"
              title={t('page.mySourcesTitle')}
              aria-label={t('page.mySourcesTitle')}
            >
              <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
              <circle cx="12" cy="12" r="3" />
              <path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83-2.83l.06-.06A1.65 1.65 0 0 0 4.68 15a1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1 0-4h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 2.83-2.83l.06.06A1.65 1.65 0 0 0 9 4.68a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 2.83l-.06.06A1.65 1.65 0 0 0 19.4 9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1z" />
            </svg>
            </Link>

            <PollNowButton onPolled={() => setRefreshKey((k) => k + 1)} />
          </>
        }
      />

      <CoverageBanner />
      <SavedSearchBar />
      <FilterPanel />
      <ResultsList refreshKey={refreshKey} />

      {tenderId && <TenderDetail tenderId={tenderId} onClose={closeDetail} />}
    </div>
  );
}

function TenderRadarFallback() {
  const t = useTranslations('tenderRadar');
  return (
    <div className="mx-auto max-w-5xl space-y-6 p-6">
      <p className="text-sm text-muted-foreground">{t('page.loading')}</p>
    </div>
  );
}

export default function TenderRadarPage() {
  return (
    <Suspense fallback={<TenderRadarFallback />}>
      <TenderRadarContent />
    </Suspense>
  );
}