GExtension-Abgleich mit Handpruefung fuer unklare Pakete

Die Profilseiten sind ohne Login abrufbar und betten die Kaeufe als JSON ins
HTML ein. Gelesen wird dieses JSON statt der gerenderten Tabelle: das ist
unempfindlich gegen Layout-Aenderungen und liefert zusaetzlich Kaufdatum,
Betrag und den Storno-Status. Ein Headless-Browser ist nicht noetig.

Der Abgleich bucht nichts von sich aus. Eindeutige Treffer landen als
regulaerer Import in der bestehenden Vorschau, die per package_bought_id
dedupliziert. Titel, die nach CC klingen, sich aber keiner Guthaben-Art
sicher zuordnen lassen, gehen in eine Handpruefung statt geraten zu werden -
sichtbar als Hinweis auf der Uebersicht und als Box beim Spieler.

Beachtet werden dabei: stornierte Kaeufe werden uebersprungen, der Web-
Bereich enthaelt nie CC-Pakete, und ein Redesign-Titel zaehlt als Redesign,
auch wenn Custom Character darin vorkommt. Letzteres war auch in den
Standard-Mappings des Datei-Imports falsch herum einsortiert.

Der Lauf geht bewusst nur ueber bereits erfasste Spieler und haelt eine
Sekunde Abstand zwischen den Anfragen, da die Seite fremde Infrastruktur ist.

Voraussetzung dafuer ist, dass SteamIDs auf eine Schreibweise gebracht
werden: die Legacy-Form, die Steam3-Form und die 64-Bit-Zahl bezeichnen
dieselbe Person, wurden bisher aber als verschiedene Spieler gefuehrt.
Gespeichert wird jetzt immer die 64-Bit-Form, Eingabe und Suche akzeptieren
alle drei.

web/src/pages/Dashboard.tsx

@@ -4,7 +4,7 @@ import Modal from '../components/Modal';
 import Notice from '../components/Notice';
 import { ApiError, api } from '../lib/api';
 import { useSession } from '../lib/session';
-import type { PlayerSummary } from '../lib/types';
+import type { PlayerSummary, ScrapeSummary, UnmatchedOverview } from '../lib/types';
 
 interface SearchResult {
   total: number;
@@ -26,6 +26,9 @@ export default function Dashboard() {
   const [loading, setLoading] = useState(true);
   const [error, setError] = useState<string | null>(null);
   const [creating, setCreating] = useState(false);
+  const [flagged, setFlagged] = useState<UnmatchedOverview>({ total: 0, players: [] });
+  const [syncing, setSyncing] = useState(false);
+  const [syncResult, setSyncResult] = useState<string | null>(null);
 
   const load = useCallback(async (search: string, signal?: AbortSignal) => {
     setLoading(true);
@@ -42,6 +45,37 @@ export default function Dashboard() {
     }
   }, []);
 
+  const loadFlagged = useCallback(async () => {
+    try {
+      setFlagged(await api<UnmatchedOverview>('/api/scrape/unmatched/overview'));
+    } catch {
+      // Der Hinweis ist Beiwerk - ein Fehler hier darf die Liste nicht stoeren.
+    }
+  }, []);
+
+  useEffect(() => {
+    void loadFlagged();
+  }, [loadFlagged]);
+
+  const runSync = async () => {
+    setSyncing(true);
+    setSyncResult(null);
+    try {
+      const result = await api<ScrapeSummary>('/api/scrape/run', { method: 'POST', body: {} });
+      const parts = [`${result.scannedPlayers} Profile geprueft`];
+      if (result.newRows > 0) parts.push(`${result.newRows} neue Pakete zur Bestaetigung`);
+      if (result.unclear > 0) parts.push(`${result.unclear} ungeklaert`);
+      if (result.duplicates > 0) parts.push(`${result.duplicates} schon gebucht`);
+      if (result.failedPlayers.length > 0) parts.push(`${result.failedPlayers.length} nicht erreichbar`);
+      setSyncResult(parts.join(', ') + '.');
+      await Promise.all([load(query), loadFlagged()]);
+    } catch (err) {
+      setError(err instanceof ApiError ? err.message : 'Abgleich fehlgeschlagen');
+    } finally {
+      setSyncing(false);
+    }
+  };
+
   // Tippen entprellen, damit nicht jeder Anschlag eine Anfrage ausloest.
   useEffect(() => {
     const controller = new AbortController();
@@ -56,11 +90,18 @@ export default function Dashboard() {
     <div className="page">
       <div className="page-head">
         <h1>Spieler</h1>
-        {can('EDITOR') && (
-          <button type="button" className="btn btn-primary" onClick={() => setCreating(true)}>
-            Spieler anlegen
-          </button>
-        )}
+        <div className="head-actions">
+          {can('ADMIN') && (
+            <button type="button" className="btn" disabled={syncing} onClick={() => void runSync()}>
+              {syncing ? 'Gleiche ab …' : 'GExtension abgleichen'}
+            </button>
+          )}
+          {can('EDITOR') && (
+            <button type="button" className="btn btn-primary" onClick={() => setCreating(true)}>
+              Spieler anlegen
+            </button>
+          )}
+        </div>
       </div>
 
       <input
@@ -73,6 +114,24 @@ export default function Dashboard() {
       />
 
       {error && <Notice kind="error">{error}</Notice>}
+      {syncResult && <Notice kind="success" onDismiss={() => setSyncResult(null)}>{syncResult}</Notice>}
+
+      {flagged.total > 0 && (
+        <Notice kind="warn">
+          <strong>
+            {flagged.total} ungeklaerte {flagged.total === 1 ? 'Eintrag' : 'Eintraege'} bei{' '}
+            {flagged.players.length} {flagged.players.length === 1 ? 'Spieler' : 'Spielern'}:
+          </strong>{' '}
+          {flagged.players.map((entry, index) => (
+            <span key={entry.playerId}>
+              {index > 0 && ', '}
+              <Link to={`/players/${entry.playerId}`}>
+                {entry.displayName} ({entry.count})
+              </Link>
+            </span>
+          ))}
+        </Notice>
+      )}
 
       <div className="table-wrap">
         <table className="table">
@@ -185,7 +244,16 @@ function CreatePlayerModal({ onClose, onCreated }: { onClose: () => void; onCrea
         />
 
         <label htmlFor="steamId">SteamID (optional)</label>
-        <input id="steamId" value={steamId} onChange={(event) => setSteamId(event.target.value)} />
+        <input
+          id="steamId"
+          value={steamId}
+          onChange={(event) => setSteamId(event.target.value)}
+          placeholder="76561198... oder STEAM_0:1:..."
+        />
+        <p className="muted small">
+          Beide Schreibweisen sind moeglich, auch <code className="mono">[U:1:...]</code>.
+          Gespeichert wird immer die 64-Bit-Form, damit derselbe Spieler nicht doppelt anlegt.
+        </p>
 
         <label htmlFor="forumName">Forum-Name (optional)</label>
         <input

web/src/pages/PlayerDetail.tsx

@@ -1,6 +1,7 @@
 import { useCallback, useEffect, useState } from 'react';
 import { Link, useParams } from 'react-router-dom';
 import BalanceCards from '../components/BalanceCards';
+import UnmatchedBox from '../components/UnmatchedBox';
 import Modal from '../components/Modal';
 import Notice from '../components/Notice';
 import { ApiError, api } from '../lib/api';
@@ -87,6 +88,21 @@ export default function PlayerDetail() {
 
       <BalanceCards balances={detail.balances} />
 
+      {detail.player.gextensionUsage !== null && (
+        <p className="muted small usage-hint">
+          GExtension meldet <strong>{detail.player.gextensionUsage}</strong> Mal verbraucht
+          {detail.player.gextensionSyncedAt &&
+            ` (Stand ${formatDate(detail.player.gextensionSyncedAt)})`}
+          . Nur zum Abgleich — wird nicht automatisch verrechnet.
+        </p>
+      )}
+
+      <UnmatchedBox
+        items={detail.unmatched ?? []}
+        canResolve={can('ADMIN')}
+        onResolved={() => void load()}
+      />
+
       {editor && (
         <section className="action-bar">
           <button
@@ -140,6 +156,25 @@ export default function PlayerDetail() {
           >
             Neuer CC
           </button>
+          {can('ADMIN') && detail.player.steamId && (
+            <button
+              type="button"
+              className="btn"
+              disabled={busy}
+              title="Pakete dieses Spielers von GExtension abrufen"
+              onClick={() =>
+                void run(async () => {
+                  const result = await api<{ newRows: number; unclear: number }>(
+                    `/api/scrape/player/${playerId}`,
+                    { method: 'POST', body: {} },
+                  );
+                  return result;
+                }, 'GExtension abgeglichen.')
+              }
+            >
+              GExtension abgleichen
+            </button>
+          )}
         </section>
       )}