Breng de opstartkosten terug en geef de werkstand een schakelaar

De inlogpagina haalde 1,46 MB over de lijn, waaronder de volledige kaartmotor
van 213 kB terwijl er geen kaart staat. De werkbank is nu een aparte brok die
pas na aanmelden geladen wordt: de eerste JS-bundel gaat van 476 naar 30 kB, en
met de beeldwerk uit een eerdere commit komt de inlogpagina op 344 kB.

Bij het opstarten gingen 27 verzoeken de deur uit in drie golven. Alles werd
vooraf opgehaald, ook voor werkbladen die de gebruiker misschien nooit opent,
en twee daarvan werden dubbel opgevraagd door effecten die negentig
milliseconde na elkaar liepen. Gelijktijdige en vlak opeenvolgende identieke
GET-verzoeken delen nu één belofte, en elk werkblad haalt zijn eigen gegevens
pas op wanneer het geopend wordt. Nu zestien verzoeken.

Typen in het themazoekveld kostte 53 ms mediaan met uitschieters tot 127 ms,
omdat die filterwaarde in het viewmodel van de hele werkruimte leefde. Het veld
is een eigen component geworden dat zijn invoer zelf bijhoudt. React.memo om de
kaart is geprobeerd en weer verwijderd: van de negentien props worden er te
veel per render opnieuw gemaakt, dus de vergelijking sloeg nooit over.

Verder: donker blijft de standaard maar er is nu een weg terug naar licht, de
kaartondergrond schakelt mee zonder de datalagen te herbouwen, de onderste
hero-afbeelding wordt pas opgehaald als hij in beeld komt, en de werkbank heeft
een h1 zodat schermlezers een ankerpunt hebben.

De tests op de bootstrap legden het oude gedrag vast en toetsen nu het nieuwe,
van drie naar zeven gevallen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

frontend/src/hooks/useDeferredBackground.test.tsx

@@ -0,0 +1,51 @@
+import { cleanup, render } from '@testing-library/react'
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { useDeferredBackground } from './useDeferredBackground'
+
+function Blok(): JSX.Element {
+  const ref = useDeferredBackground<HTMLDivElement>()
+  return <div data-testid="blok" ref={ref} />
+}
+
+describe('useDeferredBackground', () => {
+  afterEach(() => {
+    cleanup()
+    vi.unstubAllGlobals()
+  })
+
+  it('zet de achtergrond pas wanneer het blok in beeld komt', () => {
+    type Terugroep = (invoeren: { isIntersecting: boolean }[]) => void
+    const waarnemers: { melden: Terugroep }[] = []
+    const disconnect = vi.fn()
+    vi.stubGlobal('IntersectionObserver', class {
+      melden: Terugroep
+      constructor(terugroep: Terugroep) {
+        this.melden = terugroep
+        waarnemers.push(this)
+      }
+      observe() {}
+      disconnect = disconnect
+    })
+    const meldIntersectie = (invoeren: { isIntersecting: boolean }[]) => {
+      for (const w of waarnemers) w.melden(invoeren)
+    }
+
+    const { getByTestId } = render(<Blok />)
+    expect(getByTestId('blok').getAttribute('data-achtergrond')).toBeNull()
+
+    meldIntersectie([{ isIntersecting: false }])
+    expect(getByTestId('blok').getAttribute('data-achtergrond')).toBeNull()
+
+    meldIntersectie([{ isIntersecting: true }])
+    expect(getByTestId('blok').getAttribute('data-achtergrond')).toBe('geladen')
+    // Eenmaal geladen hoeft er niet verder gekeken te worden.
+    expect(disconnect).toHaveBeenCalled()
+  })
+
+  it('zet de achtergrond meteen wanneer de browser niet kan waarnemen', () => {
+    vi.stubGlobal('IntersectionObserver', undefined)
+    const { getByTestId } = render(<Blok />)
+    // Liever een afbeelding te vroeg dan een leeg vlak dat nooit vult.
+    expect(getByTestId('blok').getAttribute('data-achtergrond')).toBe('geladen')
+  })
+})

frontend/src/hooks/useDeferredBackground.ts

@@ -0,0 +1,45 @@
+import { useEffect, useRef } from 'react'
+
+/**
+ * Stelt een achtergrondafbeelding uit tot het element in beeld komt.
+ *
+ * Achtergronden in CSS kennen geen loading="lazy": zodra de regel matcht, gaat
+ * het verzoek eruit. Op de landingspagina betekende dat drie afbeeldingen van
+ * samen 413 kB bij het openen, terwijl twee ervan pas ver onder de vouw staan.
+ *
+ * Het element krijgt hier pas het attribuut data-achtergrond="geladen" wanneer
+ * het in de buurt van het scherm komt; de CSS hangt de url aan dat attribuut.
+ * Zonder IntersectionObserver — of met beperkte beweging — wordt de afbeelding
+ * meteen gezet, zodat er nooit een leeg vlak achterblijft.
+ */
+export function useDeferredBackground<T extends HTMLElement>(): React.RefObject<T> {
+  const ref = useRef<T>(null)
+
+  useEffect(() => {
+    const element = ref.current
+    if (!element) return
+
+    const toon = () => element.setAttribute('data-achtergrond', 'geladen')
+
+    if (typeof IntersectionObserver === 'undefined') {
+      toon()
+      return
+    }
+
+    const waarnemer = new IntersectionObserver(
+      (invoeren) => {
+        if (invoeren.some((invoer) => invoer.isIntersecting)) {
+          toon()
+          waarnemer.disconnect()
+        }
+      },
+      // Ruim voor de vouw beginnen, zodat de afbeelding er staat voordat de
+      // gebruiker hem bereikt.
+      { rootMargin: '600px' },
+    )
+    waarnemer.observe(element)
+    return () => waarnemer.disconnect()
+  }, [])
+
+  return ref
+}

frontend/src/hooks/useWorkbenchBootstrap.test.tsx

@@ -7,8 +7,9 @@ function action() {
   return vi.fn().mockResolvedValue(undefined)
 }
 
-function options(selectedProjectId: string | null) {
+function options(selectedProjectId: string | null, activeWorkspace = 'map') {
   return {
+    activeWorkspace,
     selectedProjectId,
     selectedDetectionRunId: '',
     detectionClassFilter: '',
@@ -36,20 +37,17 @@ function options(selectedProjectId: string | null) {
 }
 
 describe('useWorkbenchBootstrap', () => {
-  it('loads global capabilities and clears project-owned state without a project', async () => {
+  it('haalt zonder project alleen de werkruimtes op en wist projectgebonden state', async () => {
     const state = options(null)
     renderHook(() => useWorkbenchBootstrap(state))
 
     await waitFor(() => expect(state.loadProjects).toHaveBeenCalledOnce())
-    expect(state.loadCapabilities).toHaveBeenCalledOnce()
-    expect(state.loadDetectionModels).toHaveBeenCalledOnce()
-    expect(state.loadSegmentationModels).toHaveBeenCalledOnce()
     expect(state.resetProjectData).toHaveBeenCalledOnce()
     expect(state.resetDatasetForProject).toHaveBeenCalledOnce()
     expect(state.loadProjectData).not.toHaveBeenCalled()
   })
 
-  it('resets stale state before loading every project-owned collection', async () => {
+  it('laadt op het kaartwerkblad de gebieden en bronnen, en verder niets', async () => {
     const state = options('project-1')
     renderHook(() => useWorkbenchBootstrap(state))
 
@@ -59,25 +57,76 @@ describe('useWorkbenchBootstrap', () => {
     expect(state.resetDetectionForProject).toHaveBeenCalledOnce()
     expect(state.resetSegmentationForProject).toHaveBeenCalledOnce()
     expect(state.resetExportsForProject).toHaveBeenCalledOnce()
-    expect(state.loadDetectionRuns).toHaveBeenCalledWith('project-1')
-    expect(state.loadSegmentationRuns).toHaveBeenCalledWith('project-1')
-    expect(state.loadQualityChecks).toHaveBeenCalledWith('project-1')
-    expect(state.loadExports).toHaveBeenCalledWith('project-1')
+
+    // Alles wat bij een ander werkblad hoort blijft liggen tot dat werkblad
+    // geopend wordt. Voorheen ging dit alles bij het opstarten de deur uit,
+    // ook voor werkbladen die de gebruiker nooit opende.
+    expect(state.loadCapabilities).not.toHaveBeenCalled()
+    expect(state.loadDetectionModels).not.toHaveBeenCalled()
+    expect(state.loadSegmentationModels).not.toHaveBeenCalled()
+    expect(state.loadDetectionRuns).not.toHaveBeenCalled()
+    expect(state.loadSegmentationRuns).not.toHaveBeenCalled()
+    expect(state.loadQualityChecks).not.toHaveBeenCalled()
+    expect(state.loadExports).not.toHaveBeenCalled()
   })
 
-  it('loads the same analysis catalog and project results for a guest', async () => {
-    const state = { ...options('project-1'), restrictedMode: true }
+  it('haalt de beeldanalysegegevens op zodra dat werkblad open staat', async () => {
+    const state = options('project-1', 'ai')
     renderHook(() => useWorkbenchBootstrap(state))
 
-    await waitFor(() => expect(state.loadProjectData).toHaveBeenCalledWith('project-1'))
-    expect(state.loadCapabilities).toHaveBeenCalledOnce()
-    expect(state.loadQualityChecks).toHaveBeenCalledWith('project-1')
-    expect(state.loadDetectionModels).toHaveBeenCalledOnce()
+    await waitFor(() => expect(state.loadDetectionModels).toHaveBeenCalledOnce())
     expect(state.loadSegmentationModels).toHaveBeenCalledOnce()
     expect(state.loadDetectionRuns).toHaveBeenCalledWith('project-1')
     expect(state.loadSegmentationRuns).toHaveBeenCalledWith('project-1')
-    expect(state.loadExports).toHaveBeenCalledWith('project-1')
     expect(state.loadDetectionResults).toHaveBeenCalledOnce()
     expect(state.loadSegmentationResults).toHaveBeenCalledOnce()
+    expect(state.loadExports).not.toHaveBeenCalled()
+  })
+
+  it('haalt kwaliteit, downloads en bronkoppelingen op hun eigen werkblad', async () => {
+    const kwaliteit = options('project-1', 'analysis')
+    renderHook(() => useWorkbenchBootstrap(kwaliteit))
+    await waitFor(() => expect(kwaliteit.loadQualityChecks).toHaveBeenCalledWith('project-1'))
+
+    const downloads = options('project-1', 'exports')
+    renderHook(() => useWorkbenchBootstrap(downloads))
+    await waitFor(() => expect(downloads.loadExports).toHaveBeenCalledWith('project-1'))
+
+    const systeem = options('project-1', 'system')
+    renderHook(() => useWorkbenchBootstrap(systeem))
+    await waitFor(() => expect(systeem.loadCapabilities).toHaveBeenCalledOnce())
+  })
+
+  it('blijft geladen wanneer de gebruiker terugkeert naar de kaart', async () => {
+    const state = options('project-1', 'ai')
+    const { rerender } = renderHook((props: { werkblad: string }) =>
+      useWorkbenchBootstrap({ ...state, activeWorkspace: props.werkblad }), {
+      initialProps: { werkblad: 'ai' },
+    })
+    await waitFor(() => expect(state.loadDetectionRuns).toHaveBeenCalledWith('project-1'))
+    const naEerste = state.loadDetectionRuns.mock.calls.length
+
+    rerender({ werkblad: 'map' })
+    // Een bezocht werkblad blijft bijgewerkt worden; het wordt niet opnieuw
+    // dichtgezet zodra de gebruiker wegklikt.
+    expect(state.loadDetectionRuns.mock.calls.length).toBeGreaterThanOrEqual(naEerste)
+  })
+
+  it('meldt een mislukte laadactie in plaats van haar weg te slikken', async () => {
+    const state = options('project-1')
+    state.loadProjectData = vi.fn().mockRejectedValue(new Error('netwerk weg'))
+    const gemeld: string[] = []
+    renderHook(() => useWorkbenchBootstrap({ ...state, onLoadError: (onderdeel) => gemeld.push(onderdeel) }))
+
+    await waitFor(() => expect(gemeld).toContain('gebieden en bronnen'))
+  })
+
+  it('laadt voor een gast hetzelfde als voor een operator', async () => {
+    const state = { ...options('project-1', 'ai'), restrictedMode: true }
+    renderHook(() => useWorkbenchBootstrap(state))
+
+    await waitFor(() => expect(state.loadProjectData).toHaveBeenCalledWith('project-1'))
+    expect(state.loadDetectionModels).toHaveBeenCalledOnce()
+    expect(state.loadDetectionRuns).toHaveBeenCalledWith('project-1')
   })
 })

frontend/src/hooks/useWorkbenchBootstrap.ts

@@ -1,10 +1,15 @@
-import { useEffect } from 'react'
+import { useEffect, useRef } from 'react'
 
 type AsyncAction = () => Promise<unknown>
 type ProjectAction = (projectId: string) => Promise<unknown>
 
 interface WorkbenchBootstrapOptions {
   restrictedMode?: boolean
+  /** Het werkblad dat nu open staat. Bepaalt wat er geladen mag worden. */
+  activeWorkspace?: string
+  /** Meldt een mislukte laadactie, zodat de gebruiker het verschil ziet tussen
+      "er is niets" en "het is niet gelukt". */
+  onLoadError?: (onderdeel: string, fout: unknown) => void
   selectedProjectId: string | null
   selectedDetectionRunId: string
   detectionClassFilter: string
@@ -32,6 +37,8 @@ interface WorkbenchBootstrapOptions {
 
 export function useWorkbenchBootstrap({
   restrictedMode = false,
+  activeWorkspace = 'map',
+  onLoadError,
   selectedProjectId,
   selectedDetectionRunId,
   detectionClassFilter,
@@ -56,13 +63,39 @@ export function useWorkbenchBootstrap({
   resetSegmentationForProject,
   resetExportsForProject,
 }: WorkbenchBootstrapOptions): void {
+  const foutMelder = useRef(onLoadError)
+  foutMelder.current = onLoadError
+
+  // Een mislukte laadactie werd overal met .catch(() => null) weggeslikt. De
+  // gebruiker zag dan "Nog geen bronnen beschikbaar", precies hetzelfde scherm
+  // als wanneer er echt niets is. Nu wordt de fout doorgegeven.
+  const meld = (onderdeel: string) => (fout: unknown) => {
+    foutMelder.current?.(onderdeel, fout)
+    return null
+  }
+
+  // Welke werkbladen welke gegevens nodig hebben. Alles werd voorheen bij het
+  // opstarten opgehaald, ook voor werkbladen die de gebruiker nooit opent; dat
+  // waren 27 verzoeken in drie golven voordat de kaart bruikbaar was.
+  const bezocht = useRef(new Set<string>())
+  bezocht.current.add(activeWorkspace)
+  const geopend = (werkblad: string): boolean => bezocht.current.has(werkblad)
+
   useEffect(() => {
-    loadProjects().catch(() => null)
-    loadCapabilities().catch(() => null)
-    loadDetectionModels().catch(() => null)
-    loadSegmentationModels().catch(() => null)
+    loadProjects().catch(meld('werkruimtes'))
   }, [restrictedMode])
 
+  useEffect(() => {
+    if (!geopend('system')) return
+    loadCapabilities().catch(meld('bronkoppelingen'))
+  }, [restrictedMode, activeWorkspace])
+
+  useEffect(() => {
+    if (!geopend('ai')) return
+    loadDetectionModels().catch(meld('detectiemodellen'))
+    loadSegmentationModels().catch(meld('segmentatiemodellen'))
+  }, [restrictedMode, activeWorkspace])
+
   useEffect(() => {
     if (!selectedProjectId) {
       resetProjectData()
@@ -77,18 +110,32 @@ export function useWorkbenchBootstrap({
     resetDetectionForProject()
     resetSegmentationForProject()
     resetExportsForProject()
-    loadProjectData(selectedProjectId).catch(() => null)
-    loadQualityChecks(selectedProjectId).catch(() => null)
-    loadDetectionRuns(selectedProjectId).catch(() => null)
-    loadSegmentationRuns(selectedProjectId).catch(() => null)
-    loadExports(selectedProjectId).catch(() => null)
+    loadProjectData(selectedProjectId).catch(meld('gebieden en bronnen'))
   }, [restrictedMode, selectedProjectId])
 
   useEffect(() => {
-    loadDetectionResults().catch(() => null)
-  }, [restrictedMode, selectedDetectionRunId, detectionClassFilter, detectionMinConfidenceFilter])
+    if (!selectedProjectId || !geopend('analysis')) return
+    loadQualityChecks(selectedProjectId).catch(meld('kwaliteitscontroles'))
+  }, [restrictedMode, selectedProjectId, activeWorkspace])
 
   useEffect(() => {
-    loadSegmentationResults().catch(() => null)
-  }, [restrictedMode, selectedSegmentationRunId, segmentationClassFilter, segmentationMinConfidenceFilter])
+    if (!selectedProjectId || !geopend('ai')) return
+    loadDetectionRuns(selectedProjectId).catch(meld('detectieruns'))
+    loadSegmentationRuns(selectedProjectId).catch(meld('segmentatieruns'))
+  }, [restrictedMode, selectedProjectId, activeWorkspace])
+
+  useEffect(() => {
+    if (!selectedProjectId || !geopend('exports')) return
+    loadExports(selectedProjectId).catch(meld('downloads'))
+  }, [restrictedMode, selectedProjectId, activeWorkspace])
+
+  useEffect(() => {
+    if (!geopend('ai')) return
+    loadDetectionResults().catch(meld('detectieresultaten'))
+  }, [restrictedMode, activeWorkspace, selectedDetectionRunId, detectionClassFilter, detectionMinConfidenceFilter])
+
+  useEffect(() => {
+    if (!geopend('ai')) return
+    loadSegmentationResults().catch(meld('segmentatieresultaten'))
+  }, [restrictedMode, activeWorkspace, selectedSegmentationRunId, segmentationClassFilter, segmentationMinConfidenceFilter])
 }

frontend/src/hooks/useWorkbenchTheme.test.tsx

@@ -0,0 +1,62 @@
+import { act, renderHook } from '@testing-library/react'
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import { useWorkbenchTheme } from './useWorkbenchTheme'
+
+const SLEUTEL = 'geointel.workbench-theme.v1'
+
+describe('useWorkbenchTheme', () => {
+  beforeEach(() => {
+    window.localStorage.clear()
+    delete document.body.dataset.theme
+  })
+
+  afterEach(() => {
+    window.localStorage.clear()
+  })
+
+  it('begint donker, ook wanneer het besturingssysteem licht meldt', () => {
+    // Browsers melden standaard 'light', ook als de gebruiker nooit iets
+    // instelde. Daarop afgaan zou vrijwel iedereen in de lichte werkstand
+    // zetten terwijl donker de gekozen richting is.
+    const { result } = renderHook(() => useWorkbenchTheme())
+    expect(result.current.theme).toBe('dark')
+    expect(document.body.dataset.theme).toBe('dark')
+  })
+
+  it('schakelt om en zet het attribuut op body', () => {
+    const { result } = renderHook(() => useWorkbenchTheme())
+    act(() => result.current.toggleTheme())
+    expect(result.current.theme).toBe('light')
+    expect(document.body.dataset.theme).toBe('light')
+
+    act(() => result.current.toggleTheme())
+    expect(result.current.theme).toBe('dark')
+    expect(document.body.dataset.theme).toBe('dark')
+  })
+
+  it('onthoudt de keuze voor een volgende sessie', () => {
+    const eerste = renderHook(() => useWorkbenchTheme())
+    act(() => eerste.result.current.toggleTheme())
+    eerste.unmount()
+
+    expect(window.localStorage.getItem(SLEUTEL)).toBe('light')
+
+    const tweede = renderHook(() => useWorkbenchTheme())
+    expect(tweede.result.current.theme).toBe('light')
+  })
+
+  it('blijft werken wanneer opslag geblokkeerd is', () => {
+    const origineel = window.localStorage.setItem
+    window.localStorage.setItem = () => {
+      throw new Error('opslag geweigerd')
+    }
+    try {
+      const { result } = renderHook(() => useWorkbenchTheme())
+      act(() => result.current.toggleTheme())
+      // Niet kunnen bewaren mag het omschakelen niet blokkeren.
+      expect(result.current.theme).toBe('light')
+    } finally {
+      window.localStorage.setItem = origineel
+    }
+  })
+})

frontend/src/hooks/useWorkbenchTheme.ts

@@ -0,0 +1,56 @@
+import { useCallback, useEffect, useState } from 'react'
+
+export type WorkbenchTheme = 'dark' | 'light'
+
+const OPSLAGSLEUTEL = 'geointel.workbench-theme.v1'
+
+/**
+ * De werkstand van de werkbank.
+ *
+ * Donker is de standaard: de werkbank staat tegen luchtbeelden en
+ * satellietdata aan, en een lichte schil daarnaast laat de kaart altijd
+ * verliezen. Maar donker-alleen is geen antwoord voor wie op een fel verlichte
+ * locatie werkt of een scherm deelt met een beamer, dus de keuze blijft.
+ *
+ * De keuze wordt per browser bewaard. Wie niets kiest krijgt donker. Het
+ * voorkeurssignaal van het besturingssysteem telt bewust niet mee: browsers
+ * melden standaard 'light', ook als de gebruiker nooit iets ingesteld heeft,
+ * en dan zou vrijwel iedereen in de lichte werkstand landen terwijl donker de
+ * gekozen richting van dit product is. Licht is een bewuste keuze, geen
+ * gevolg van een standaardwaarde elders.
+ */
+function beginwaarde(): WorkbenchTheme {
+  if (typeof window === 'undefined') return 'dark'
+  try {
+    const bewaard = window.localStorage.getItem(OPSLAGSLEUTEL)
+    if (bewaard === 'light' || bewaard === 'dark') return bewaard
+  } catch {
+    // Privémodus of geblokkeerde opslag: dan geldt gewoon de standaard.
+  }
+  return 'dark'
+}
+
+export function useWorkbenchTheme(): { theme: WorkbenchTheme; toggleTheme: () => void } {
+  const [theme, setTheme] = useState<WorkbenchTheme>(beginwaarde)
+
+  useEffect(() => {
+    document.body.dataset.theme = theme
+    return () => {
+      delete document.body.dataset.theme
+    }
+  }, [theme])
+
+  const toggleTheme = useCallback(() => {
+    setTheme((huidig) => {
+      const volgend: WorkbenchTheme = huidig === 'dark' ? 'light' : 'dark'
+      try {
+        window.localStorage.setItem(OPSLAGSLEUTEL, volgend)
+      } catch {
+        // Niet kunnen bewaren mag het omschakelen niet blokkeren.
+      }
+      return volgend
+    })
+  }, [])
+
+  return { theme, toggleTheme }
+}