From 852a162bc366ac6d18e3545da68d521cddf64a19 Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Mon, 16 Nov 2026 21:14:00 +0100 Subject: [PATCH] Hero: varianten op de achtergrond knippen; upload en opslaan antwoorden direct Opslaan van 8 foto's met gewijzigde focus duurde 40 s op een snelle pc en ruim 3 minuten op de Pi (proxy-timeout 60 s gaf 504, hero niet bewaard). Upload bewaart het origineel en antwoordt; HeroRenderService knipt de set per afbeelding en schakelt over zodra de set compleet is (oude set blijft ondertussen live; afbeelding zonder set wordt niet gepubliceerd). Opslaan legt alleen de focus vast. Admin toont 'wordt verwerkt' en ververst zelf; Seed-Hero wacht tot alles klaar is. Metingen: HeroSaveTimingTests. Co-Authored-By: Claude Sonnet 5.5 --- .../assumptions-and-open-questions.md | 1 + docs/hero-module.md | 5 +- frontend/src/features/hero/mocks/handlers.ts | 1 + .../src/features/hero/pages/HeroPage.test.tsx | 10 ++ frontend/src/features/hero/pages/HeroPage.tsx | 8 +- frontend/src/features/hero/services/hooks.ts | 2 + frontend/src/features/hero/services/types.ts | 2 + frontend/src/i18n/locales/en/translation.json | 4 +- frontend/src/i18n/locales/nl/translation.json | 4 +- openapi/slpsoftware.v1.json | 4 + scripts/Seed-Hero.ps1 | 11 ++ .../HeroAsfSiteE2ETests.cs | 10 ++ .../HeroInjectionPipelineTests.cs | 9 ++ .../HeroFocusSaveTests.cs | 64 +++++++++- .../HeroSaveTimingTests.cs | 54 ++++++++ .../HeroTestRig.cs | 28 ++++- src/SlpModularCms.Modules.Hero/HeroModule.cs | 2 + .../Models/HeroModels.cs | 3 +- .../Repositories/HeroRepository.cs | 13 ++ .../Services/HeroImageService.cs | 119 +++++++++++++----- .../Services/HeroMapping.cs | 10 +- .../Services/HeroRenderService.cs | 89 +++++++++++++ .../Services/HeroService.cs | 7 +- 23 files changed, 414 insertions(+), 46 deletions(-) create mode 100644 src/SlpModularCms.Modules.Hero.Tests/HeroSaveTimingTests.cs create mode 100644 src/SlpModularCms.Modules.Hero/Services/HeroRenderService.cs diff --git a/aidlc-docs/features/hero-module/assumptions-and-open-questions.md b/aidlc-docs/features/hero-module/assumptions-and-open-questions.md index d0ef1e9..fbd00fc 100644 --- a/aidlc-docs/features/hero-module/assumptions-and-open-questions.md +++ b/aidlc-docs/features/hero-module/assumptions-and-open-questions.md @@ -28,3 +28,4 @@ Kept while Bryan was away (2026-11-16): no questions to him, a likely assumption | 22 | **Production seed**. | Not done; only the test hosts, with Bryan's password, after his go. | n/a | `scripts/Seed-Hero.ps1`, `docs/release-checklist-productie.md` section 4b | | 23 | What does the host write for a hero **without any slide** (SLP Software)? | A text-only region in the first HTML (so a CMS change is visible without JavaScript, LCP is the text): `h1.cms-hero-title` with an optional `span.cms-hero-tagline` and `span.cms-hero-title-lines` (title lines separated by `
`, no brand prefix), then `p.cms-hero-lead` (lead, line breaks as `
`) and `p.cms-hero-buttons` with `a.cms-hero-button`. Nothing to preload, and the preload region is left as built. A hero WITH slides but none usable stays empty (ASF unchanged). This is a per-site switch, `Hero:TextOnlyRegion`: on in the committed settings of the SLP site, off by default (so ASF keeps its baked hero when its CMS hero has no slide, as ASF asked). | A separate marker for the text region instead of a switch. | `HeroOptions.TextOnlyRegion`, `HeroPictureRenderer.Render` and `TextOnlyRegion`, `HeroHtmlTransform.ApplyAsync`, `Api.SlpSoftware/appsettings.json`, `HeroTextOnlyTests` | | 24 | Does the data block carry the hero when it has no slides? | Yes (intended): the site reads the hero from the data block, the baked block is `{}`. | n/a | `HeroPageModel`, `HeroDataContributor` | +| 25 | **Variants are cut in the background**, not inside the upload or save request (2026-11-16, found on the ASF test host: saving 8 photos took 60 s+ on the Pi and the proxy cut it with a 504). | Upload and save return at once; `HeroRenderService` cuts one image at a time and switches an image to its new set when it is complete (old set stays live meanwhile); an image without a set is not published; a failing image is tried 3 times, then left until the next restart. Measured on a 20-core PC: upload 3.5-8.8 s and save of 8 changed focus points 39.6 s before, 0.1 s and 0.1 s after (the 37.5 s of cutting moved to the background, 4.7 s per photo). On the Pi: about 25-30 s per photo, 4 minutes for 8. | A longer proxy time-out is then not needed; if cutting should be faster, reduce the variant set or the AVIF effort. | `HeroImageService.RenderNextPendingAsync`, `HeroRenderService`, `HeroSaveTimingTests` | diff --git a/docs/hero-module.md b/docs/hero-module.md index 19351bc..b8517fb 100644 --- a/docs/hero-module.md +++ b/docs/hero-module.md @@ -10,7 +10,7 @@ Admin > **Hero** (Owner en Administrator, module `Hero`): - Maximaal twee knoppen met tekst en doel. Een doel is een `#anker`, een `/pad` of een `https://`-adres; andere waarden worden geweigerd. - Planning (aan of uit, van en tot). Buiten de planning, of uitgezet, toont de website zijn eigen ingebakken hero. - Slides: een afbeelding met verplichte beschrijving (alt-tekst) of de markering decoratief, volgorde, aan of uit per slide. Er is geen grens op het aantal slides; technisch publiceert de host er hoogstens `Hero:MaxPublishedSlides` (50). -- Focus: per afbeelding een algemeen punt en zoom, en optioneel een eigen punt voor de liggende (`wide`, 3:2) en de staande (`tall`, 4:5) weergave. De host snijdt de varianten daaromheen uit. **Een wijziging van het focuspunt geldt pas als je de hero opslaat** (Bryan, 2026-11-16): het focus-venster houdt de wijziging lokaal in de admin (knop Toepassen, een markering bij de slide); bij Opslaan gaat ze mee in dezelfde aanvraag (`imageFocus`), de host snijdt dan de varianten opnieuw in nieuwe bestanden en bewaart hero en afbeeldingen in één keer. Verlaat je de pagina zonder op te slaan, dan vervalt de wijziging en is er niets aan de server veranderd. Mislukt een opslag nadat nieuwe bestanden zijn geschreven, dan verwijst niets ernaar en ruimt de opschoning ze na 7 dagen op; de oude bestanden blijven ook 7 dagen staan voor sites die nog oude data hebben. +- Focus: per afbeelding een algemeen punt en zoom, en optioneel een eigen punt voor de liggende (`wide`, 3:2) en de staande (`tall`, 4:5) weergave. De host snijdt de varianten daaromheen uit. **Een wijziging van het focuspunt geldt pas als je de hero opslaat** (Bryan, 2026-11-16): het focus-venster houdt de wijziging lokaal in de admin (knop Toepassen, een markering bij de slide); bij Opslaan gaat ze mee in dezelfde aanvraag (`imageFocus`); de host bewaart hero en focus direct (onder een seconde) en snijdt de varianten daarna op de achtergrond in nieuwe bestanden. De afbeelding schakelt over naar de nieuwe set zodra die compleet is; tot die tijd blijft de oude set in beeld. Verlaat je de pagina zonder op te slaan, dan vervalt de wijziging en is er niets aan de server veranderd. Mislukt een opslag nadat nieuwe bestanden zijn geschreven, dan verwijst niets ernaar en ruimt de opschoning ze na 7 dagen op; de oude bestanden blijven ook 7 dagen staan voor sites die nog oude data hebben. De admin toont alleen een badge Live of Niet live. @@ -51,10 +51,11 @@ Een gegevensmap naast de site, buiten de webroot, waarin het account van de appl ./scripts/Seed-Hero.ps1 -BaseUrl https://test.slpsoftware.nl -SeedFile ./scripts/hero-sls.json ``` -`hero-asf.json` bevat de 8 huidige foto's met alt-teksten en een eerste schatting van de focuspunten (door de ASF-sessie); Bryan past ze aan in de admin. `hero-sls.json` is de huidige SLP-hero (alleen tekst, twee knoppen). Het script uploadt eerst alle foto's (dezelfde foto is dezelfde afbeelding, dus een tweede run dupliceert niets) en slaat dan de hero in een keer op, met de focuspunten in dezelfde aanvraag (`imageFocus`): een focuspunt geldt pas bij het opslaan van de hero. Het slaat een CMS over dat al een hero heeft (`-Force` vervangt), vraagt het wachtwoord interactief (alleen voor een lokale host of testrun leest het `SEED_HERO_PASSWORD`) en gebruikt voor productie niets zonder Bryans go. Getest op PowerShell 7 en Windows PowerShell 5.1 tegen een lokale host, met de ASF-seed en `hero-sls.json`. +`hero-asf.json` bevat de 8 huidige foto's met alt-teksten en een eerste schatting van de focuspunten (door de ASF-sessie); Bryan past ze aan in de admin. `hero-sls.json` is de huidige SLP-hero (alleen tekst, twee knoppen). Het script uploadt eerst alle foto's (de varianten worden daarna op de achtergrond gemaakt; het script wacht tot alles klaar is) (dezelfde foto is dezelfde afbeelding, dus een tweede run dupliceert niets) en slaat dan de hero in een keer op, met de focuspunten in dezelfde aanvraag (`imageFocus`): een focuspunt geldt pas bij het opslaan van de hero. Het slaat een CMS over dat al een hero heeft (`-Force` vervangt), vraagt het wachtwoord interactief (alleen voor een lokale host of testrun leest het `SEED_HERO_PASSWORD`) en gebruikt voor productie niets zonder Bryans go. Getest op PowerShell 7 en Windows PowerShell 5.1 tegen een lokale host, met de ASF-seed en `hero-sls.json`. ## Wat er achter de schermen gebeurt +- Verwerking op de achtergrond: een upload bewaart het origineel en geeft direct antwoord (`processing: true`, nog geen varianten, de afbeelding wordt niet gepubliceerd); `HeroRenderService` knipt de varianten, een afbeelding per keer (op een Raspberry Pi 4 ongeveer 25-30 s per foto), en pikt bij het opstarten en elke minuut werk op dat nog openstaat. Daardoor kapt de proxy-time-out (60 s) nooit een upload of een opslag af, en laat een afgebroken verzoek niets half bewaard achter (bestanden eerst, rij als laatste; een herhaling doet het gewoon opnieuw). De admin ververst zelf zolang er afbeeldingen worden verwerkt. - Upload: echt bestandstype aan de inhoud (geen SVG), grenzen op bytes, pixels, tijd en gelijktijdigheid; metadata (GPS) uit het opgeslagen origineel en alle varianten; varianten per verhouding rond het focuspunt, nooit groter dan de bron, in WebP (en AVIF waar het platform dat kan). Dezelfde foto nog een keer is hetzelfde plaatje (en herstelt verloren bestanden). - Oude bestanden (nieuwe focus, vervangen of ongebruikte foto) blijven 7 dagen en worden dan opgeschoond; een bestand dat nog gebruikt wordt, verdwijnt nooit. - Ondersteunde invoer: JPEG, PNG, WebP, GIF, BMP, TIFF en AVIF; HEIC alleen als aangegeven mogelijkheid van de bibliotheek (nog niet met een echt bestand getest). diff --git a/frontend/src/features/hero/mocks/handlers.ts b/frontend/src/features/hero/mocks/handlers.ts index 2742402..2622c4d 100644 --- a/frontend/src/features/hero/mocks/handlers.ts +++ b/frontend/src/features/hero/mocks/handlers.ts @@ -15,6 +15,7 @@ const seedImage = (id: string, width = 1600, height = 1067): HeroImageDto => ({ { ratio: 'wide', width, height, type: 'image/webp', url: `/media/hero/0123456789abcdef/wide-${width}.webp` }, { ratio: 'tall', width: 640, height: 800, type: 'image/webp', url: '/media/hero/0123456789abcdef/tall-640.webp' }, ], + processing: false, }); export const emptyHero = (): HeroAdminDto => ({ diff --git a/frontend/src/features/hero/pages/HeroPage.test.tsx b/frontend/src/features/hero/pages/HeroPage.test.tsx index b7f15ca..af850e4 100644 --- a/frontend/src/features/hero/pages/HeroPage.test.tsx +++ b/frontend/src/features/hero/pages/HeroPage.test.tsx @@ -31,6 +31,16 @@ describe('Hero page', () => { expect(screen.getByTestId('hero-display-single')).toBeChecked(); }); + it('shows a placeholder, and no focus button, for an image whose variants are still being cut', async () => { + const waiting = slide(1); + setMockHero({ ...emptyHero(), id: 'h1', title: 'T', slides: [{ ...waiting, image: { ...waiting.image, variants: [], src: '', processing: true } }] }); + + await openPage(); + + expect(await screen.findByTestId('hero-slide-0-processing', {}, T)).toBeInTheDocument(); + expect(screen.getByTestId('hero-slide-0-focus')).toBeDisabled(); + }); + it('is reachable from the navigation for an administrator', async () => { mockAuthenticated(); renderApp('/dashboard'); diff --git a/frontend/src/features/hero/pages/HeroPage.tsx b/frontend/src/features/hero/pages/HeroPage.tsx index 8e211d2..9e35a33 100644 --- a/frontend/src/features/hero/pages/HeroPage.tsx +++ b/frontend/src/features/hero/pages/HeroPage.tsx @@ -299,7 +299,11 @@ function HeroEditor({ hero }: { hero: HeroAdminDto }) { const decorative = watchedSlides[index]?.decorative ?? false; return (
  • - {image ? ( + {image && image.variants.length === 0 ? ( +
    + {t('hero.slides.processing')} +
    + ) : image ? ( ) : (
    ?
    @@ -329,7 +333,7 @@ function HeroEditor({ hero }: { hero: HeroAdminDto }) { -