feat: materialize award references into the QSO row (award_refs column)

Award refs are now computed once and stored on the QSO as a JSON column
(award_refs, e.g. {"DDFM":"74","WAJA":"12"}) instead of recomputing the whole
award engine on every grid page load. Written on log/edit/UDP-import and
bulk-recomputed when an award definition or reference list changes; a one-time
per-logbook backfill materializes pre-existing QSOs. The grid reads the column
directly like any other field, so it's fast and available everywhere (including
the shared MySQL logbook).

Also fix per-profile grid column layout: the DB copy was already per-profile,
but the localStorage cache used one global namespace and shadowed it, so a
profile switch kept the previous profile's columns/widths. gridPrefs now scopes
the cache by active profile id and the grids remount on profile:changed.

frontend/src/App.tsx

@@ -41,9 +41,8 @@ import {
   ChatAvailable, GetChatHistory, SendChatMessage, GetOnlineOperators,
   QSOAudioBegin, QSOAudioCancel, QSOAudioRestart, QSOAudioResetClock,
   GetAwardDefs,
-  GetUIPref,
+  GetUIPref, GetActiveProfile,
   ReportLiveActivity, GetLiveStatusEnabled, LiveLastQSOAgeSec,
-  AwardRefsForQSOs,
 } from '../wailsjs/go/main/App';
 import { Combobox } from '@/components/ui/combobox';
 import { applyAwardRefs } from '@/lib/awardRefs';
@@ -87,6 +86,7 @@ import { SendSpotModal, type RecentSpotQSO } from '@/components/SendSpotModal';
 import { WinkeyerPanel, type WKStatus, type WKMacro } from '@/components/WinkeyerPanel';
 import { RotorCompass } from '@/components/RotorCompass';
 import { writeUiPref } from '@/lib/uiPref';
+import { setGridPrefsProfile } from '@/lib/gridPrefs';
 import { DvkPanel, type DVKMsg, type DVKStat } from '@/components/DvkPanel';
 
 import { Button } from '@/components/ui/button';
@@ -135,6 +135,22 @@ const emptyDetails: DetailsState = {
   award_refs: '',
 };
 
+// parseAwardRefs turns the QSO row's materialised award_refs JSON string
+// ({"DDFM":"74","WAJA":"12"}) into the code→ref object the grid columns read.
+// Tolerant of empty / malformed values (returns {}), and passes an already-parsed
+// object straight through.
+function parseAwardRefs(s: any): Record<string, string> {
+  if (!s) return {};
+  if (typeof s === 'object') return s as Record<string, string>;
+  if (typeof s !== 'string') return {};
+  try {
+    const o = JSON.parse(s);
+    return o && typeof o === 'object' ? o : {};
+  } catch {
+    return {};
+  }
+}
+
 function fmtDateUTC(s: any): string {
   if (!s) return '';
   const d = new Date(s);
@@ -1234,38 +1250,28 @@ export default function App() {
   // list once, then compute each shown QSO's reference per award and attach it
   // to the rows (the grids render one hideable column per award).
   const [awardCols, setAwardCols] = useState<{ code: string; name: string }[]>([]);
-  // Bumped whenever award definitions are saved so the grid columns AND the
-  // per-QSO refs re-fetch — the ref/name display choice is computed live, so
-  // changing it updates ALL contacts (old included) with no restart.
+  // Bumped when award definitions change (or the backend finishes a bulk
+  // award_refs recompute) so the set of award COLUMNS re-reads from GetAwardDefs.
+  // The per-QSO values themselves ride on the row (award_refs) and refresh with
+  // the grid reload triggered alongside this bump.
   const [awardsVersion, setAwardsVersion] = useState(0);
   useEffect(() => {
     GetAwardDefs().then((defs: any[]) =>
       setAwardCols(((defs ?? []) as any[]).map((d) => ({ code: d.code, name: d.name })).sort((a, b) => a.code.localeCompare(b.code))),
     ).catch(() => {});
   }, [awardsVersion]);
-  const [qsoAwardRefs, setQsoAwardRefs] = useState<Record<string, Record<string, string>>>({});
-  useEffect(() => {
-    const ids = (qsos as any[]).map((q) => q.id).filter(Boolean);
-    if (ids.length === 0 || awardCols.length === 0) { setQsoAwardRefs({}); return; }
-    let alive = true;
-    AwardRefsForQSOs(ids as any).then((m: any) => { if (alive) setQsoAwardRefs(m ?? {}); }).catch(() => {});
-    return () => { alive = false; };
-  }, [qsos, awardCols.length, awardsVersion]);
+  // Award references are now MATERIALISED on the QSO row (the award_refs JSON
+  // column, written by the backend on log/edit and bulk-recomputed when awards
+  // change). The grid reads them straight from the row — no per-page backend
+  // recompute — so here we just parse the stored JSON string into the code→ref
+  // object the award columns expect (keys are already upper-case).
   const qsosWithAwards = useMemo(
-    () => (qsos as any[]).map((q) => ({ ...q, award_refs: qsoAwardRefs[String(q.id)] })),
-    [qsos, qsoAwardRefs],
+    () => (qsos as any[]).map((q) => ({ ...q, award_refs: parseAwardRefs(q.award_refs) })),
+    [qsos],
   );
-  const [wbAwardRefs, setWbAwardRefs] = useState<Record<string, Record<string, string>>>({});
-  useEffect(() => {
-    const ids = ((wb?.entries ?? []) as any[]).map((e) => e.id).filter(Boolean);
-    if (ids.length === 0 || awardCols.length === 0) { setWbAwardRefs({}); return; }
-    let alive = true;
-    AwardRefsForQSOs(ids as any).then((m: any) => { if (alive) setWbAwardRefs(m ?? {}); }).catch(() => {});
-    return () => { alive = false; };
-  }, [wb, awardCols.length, awardsVersion]);
   const wbWithAwards = useMemo(
-    () => (wb ? { ...wb, entries: ((wb.entries ?? []) as any[]).map((e) => ({ ...e, award_refs: wbAwardRefs[String(e.id)] })) } : null),
-    [wb, wbAwardRefs],
+    () => (wb ? { ...wb, entries: ((wb.entries ?? []) as any[]).map((e) => ({ ...e, award_refs: parseAwardRefs(e.award_refs) })) } : null),
+    [wb],
   );
   // Always-current copy of the entry callsign, so the UDP event handlers
   // (which live in a []-deps effect with a stale `callsign` closure) can
@@ -1426,6 +1432,15 @@ export default function App() {
     return () => { offUploaded(); offDone(); offEqsl(); if (t) window.clearTimeout(t); };
   }, [refresh]);
 
+  // The backend bulk-recomputed the materialised award_refs (an award definition
+  // or reference list changed, or the one-time backfill ran). Reload the rows so
+  // the award columns show the new values, and bump awardsVersion so the set of
+  // award COLUMNS refreshes too (a new award may have appeared).
+  useEffect(() => {
+    const off = EventsOn('awards:recomputed', () => { refresh(); setAwardsVersion((v) => v + 1); });
+    return () => { off(); };
+  }, [refresh]);
+
   // Backend-emitted toast messages (e.g. recording auto-send result/skip).
   useEffect(() => {
     const off = EventsOn('toast', (msg: any) => { if (msg) showToast(String(msg)); });
@@ -2025,11 +2040,25 @@ export default function App() {
     } catch { /* keyer not configured */ }
   }, []);
 
+  // Active profile id — scopes the grids' column layout (visibility / width /
+  // order) so each profile keeps its own. Seeded once on mount and updated on
+  // every profile switch; the grids take it as their React key so they remount
+  // and re-read the now-correct per-profile layout.
+  const [activeProfileId, setActiveProfileId] = useState<number | null>(null);
+  useEffect(() => {
+    GetActiveProfile().then((p: any) => {
+      if (p && p.id != null) { setGridPrefsProfile(p.id); setActiveProfileId(p.id); }
+    }).catch(() => {});
+  }, []);
+
   // Every setting is per-profile, so when the active profile changes the whole
   // main UI re-reads its config (station identity, lists, CAT, keyer). The Go
   // side reloads its managers; this keeps the React state in sync.
   useEffect(() => {
-    const off = EventsOn('profile:changed', () => {
+    const off = EventsOn('profile:changed', (id: any) => {
+      // Re-scope the grid column layout BEFORE the grids remount (key change).
+      setGridPrefsProfile(id ?? null);
+      setActiveProfileId(typeof id === 'number' ? id : null);
       loadStation(); loadLists(); loadCATCfg(); reloadWk(); loadMainPanes();
       // The chat is per shared logbook — clear the previous profile's messages
       // and reload for the new logbook (or hide if it isn't a MySQL log).
@@ -3610,6 +3639,7 @@ export default function App() {
         return (
           <div className="h-full w-full min-h-0 flex flex-col bg-card border border-border rounded-lg overflow-hidden">
             <RecentQSOsGrid
+              key={`rqg-${activeProfileId ?? 'x'}`}
               rows={qsosWithAwards as any}
               total={total}
               awardCols={awardCols}
@@ -4636,6 +4666,7 @@ export default function App() {
               )}
 
               <RecentQSOsGrid
+                key={`rqg2-${activeProfileId ?? 'x'}`}
                 rows={qsosWithAwards as any}
                 total={total}
                 awardCols={awardCols}

frontend/src/lib/gridPrefs.ts

@@ -6,11 +6,32 @@
 // back to the DB copy and re-seed the cache.
 import { GetUIPref, SetUIPref } from '../../wailsjs/go/main/App';
 
+// The DB copy is ALREADY per-profile (the backend prefixes every ui.* key with
+// the active profile id). The localStorage cache, however, is one namespace for
+// the whole WebView, so without scoping it too a profile switch would keep
+// serving the previous profile's cached layout and the correct per-profile DB
+// value would never win. lsScope makes the cache per-profile as well; it's set
+// once the active profile is known and updated on every profile switch.
+let lsScope = '';
+
+// setGridPrefsProfile scopes the localStorage cache to a profile. Call it before
+// the grids read their state (at startup) and again whenever the active profile
+// changes so each profile keeps its own column layout / widths.
+export function setGridPrefsProfile(id: number | string | null | undefined): void {
+  lsScope = id == null || id === '' ? '' : `p${id}.`;
+}
+
+// lsKey scopes ONLY the localStorage cache key. The DB key passed to
+// GetUIPref/SetUIPref is left untouched — the backend already scopes it.
+function lsKey(key: string): string {
+  return lsScope + key;
+}
+
 // loadLocal reads the cached column state synchronously (used in onGridReady
 // to apply instantly, before the async DB round-trip).
 export function loadLocal(key: string): any[] | null {
   try {
-    const raw = localStorage.getItem(key);
+    const raw = localStorage.getItem(lsKey(key));
     const v = raw ? JSON.parse(raw) : null;
     return Array.isArray(v) ? v : null;
   } catch {
@@ -29,15 +50,16 @@ export async function loadRemote(key: string): Promise<any[] | null> {
   }
 }
 
-// saveState write-throughs to both the cache and the DB (fire-and-forget).
+// saveState write-throughs to both the cache and the DB (fire-and-forget). Only
+// the cache key is profile-scoped; the DB key is scoped by the backend.
 export function saveState(key: string, state: any[]) {
   const json = JSON.stringify(state);
-  try { localStorage.setItem(key, json); } catch { /* quota / private mode */ }
+  try { localStorage.setItem(lsKey(key), json); } catch { /* quota / private mode */ }
   SetUIPref(key, json).catch(() => { /* DB unavailable — cache still holds it */ });
 }
 
 // seedLocal writes a value into the cache without touching the DB (used after
 // hydrating the cache from the DB on a fresh machine).
 export function seedLocal(key: string, state: any[]) {
-  try { localStorage.setItem(key, JSON.stringify(state)); } catch { /* ignore */ }
+  try { localStorage.setItem(lsKey(key), JSON.stringify(state)); } catch { /* ignore */ }
 }

frontend/src/lib/uiPref.ts

@@ -32,7 +32,10 @@ const PORTABLE_KEYS = [
   'opslog.clusterLockBand', 'opslog.clusterLockMode', 'opslog.clusterStatusFilter',
   'opslog.clusterModeFilter', 'opslog.clusterSearch', 'opslog.clusterHideWorked',
   'opslog.activeTab',     // last selected tab
-  'hamlog.awardColsShown', // which award columns are shown in the QSO grid
+  // NOTE: 'hamlog.awardColsShown' and the grid column layouts are NOT listed here.
+  // They are handled by lib/gridPrefs, which scopes the localStorage cache PER
+  // PROFILE and mirrors to the DB (already per-profile) itself — mirroring them
+  // through this global path would fight that per-profile scoping.
 ];
 
 // syncPortablePrefs reconciles the DB with the local cache at startup:

frontend/wailsjs/go/main/App.d.ts

@@ -666,6 +666,8 @@ export function QSOAudioRestart():Promise<boolean>;
 
 export function QuitApp():Promise<void>;
 
+export function RecomputeAllAwardRefs():Promise<number>;
+
 export function RefreshCtyDat():Promise<main.CtyDatInfo>;
 
 export function RefreshSolar():Promise<void>;

frontend/wailsjs/go/main/App.js

@@ -1290,6 +1290,10 @@ export function QuitApp() {
   return window['go']['main']['App']['QuitApp']();
 }
 
+export function RecomputeAllAwardRefs() {
+  return window['go']['main']['App']['RecomputeAllAwardRefs']();
+}
+
 export function RefreshCtyDat() {
   return window['go']['main']['App']['RefreshCtyDat']();
 }

frontend/wailsjs/go/models.ts

@@ -3648,6 +3648,7 @@ export namespace qso {
 	    my_arrl_sect?: string;
 	    my_vucc_grids?: string;
 	    extras?: Record<string, string>;
+	    award_refs?: string;
 	    // Go type: time
 	    created_at: any;
 	    // Go type: time
@@ -3785,6 +3786,7 @@ export namespace qso {
 	        this.my_arrl_sect = source["my_arrl_sect"];
 	        this.my_vucc_grids = source["my_vucc_grids"];
 	        this.extras = source["extras"];
+	        this.award_refs = source["award_refs"];
 	        this.created_at = this.convertValues(source["created_at"], null);
 	        this.updated_at = this.convertValues(source["updated_at"], null);
 	    }