Files
slp-modular-cms/aidlc-docs/features/media-library/overview.md
T

44 lines
3.9 KiB
Markdown

# Mediabibliotheek (media-library)
**Status:** Gestart 2026-11-17 (Hero staat op master). Requirements Analysis en Application Design staan als concept op aannames in `inception/` en `assumptions-and-open-questions.md`; Bryan controleert die later. Er is niets gebouwd dat data verhuist of adressen wijzigt. Branch: `feature/media-library`.
**Doel:** een algemene Core-mediabibliotheek (niveau 3 uit de schatting) voor alle modules: Hero nu, later de gallerij-module. Foto's worden op één plek beheerd, bewaard en hergebruikt.
## Eisen van Bryan (invoer voor Requirements Analysis)
1. **Alles bewaren.** Een upload blijft staan tot de gebruiker hem zelf verwijdert. Geen automatische opruiming van ongebruikte foto's meer.
2. **Knop "Opruimen"** in de bibliotheek:
- standaard alles ouder dan 7 dagen, met een slider om meer of minder dagen terug te kijken;
- een checkbox "Alleen ongebruikte foto's", standaard AAN (uit = alle foto's in die periode).
3. **Overzicht voor het opruimen:** alle foto's die zouden worden opgeruimd, standaard allemaal geselecteerd, zodat de gebruiker er foto's uit kan zetten vóór bevestigen. Gesorteerd van nieuwste naar oudste. Per foto een indicator of hij nog gebruikt wordt, en liefst waar (module en plek, bv. "Hero, slide 3").
4. **Bulk-actie:** dit overzicht is meteen de manier om in de bibliotheek meerdere foto's te selecteren en te verwijderen.
5. **Opslag:** zichtbaar opslaggebruik en een melding bij de limiet.
6. **Bulkacties als eigen onderdeel** (aanvulling Bryan, 2026-11-17), los van het opruimoverzicht: in de bibliotheek zelf meerdere foto's selecteren (selectievakjes, alles selecteren/wissen, bereik met shift-klik, toetsenbord) en daar bulkacties op uitvoeren (verwijderen; later bv. taggen of verplaatsen). Het opruimoverzicht (eis 3) hergebruikt dezelfde selectie- en bulkcomponent. Eis 4 wordt hiermee: het opruimoverzicht is een voorgeselecteerde weergave van die component, niet de enige plek voor bulkacties.
7. **Uitsnede per gebruik, niet per foto** (aanvulling Bryan): gallerij en vooral het mozaïek op de fotoshoot-pagina's van ASF hebben per plek een eigen uitsnede/verhouding nodig. Een gallerij met masonry heeft geen eigen uitsneden nodig (foto in eigen verhouding).
## Datamodel-richting
- **Foto:** bron + metadata + standaardfocus.
- **Gebruik:** module/plek, verhouding, eigen focus/zoom. Een gebruik bepaalt de set varianten.
- De huidige Hero (focus per foto, wide/tall) moet hier zonder wijziging van de publieke adressen naartoe kunnen groeien (de Hero-focus wordt dan de standaardfocus plus een gebruik per slide).
## Randvoorwaarden
- De bestaande media-adressen (`/media/hero/<hash>/...`) en set-hashes blijven behouden, zodat ASF, SLS en de golden files niet veranderen.
- De huidige 7-daagse opruiming van ongebruikte uploads in de Hero blijft tot deze feature is gebouwd (eventueel eerder uit te zetten achter een instelling als dat veilig en klein kan; dan melden).
## Ontwerpvragen voor Bryan (niveau 3 niet ontwerpen vanuit alleen de Hero)
De behoeften van de gallerij-module moeten meewegen, zodat de abstractie niet op de verkeerde plek komt:
- Welke plekken en verhoudingen komen er? Mozaïek op de shoot-pagina's (welke verhoudingen per tegel?), hero wide/tall, masonry (eigen verhouding, geen uitsnede), thumbnails. Per-gebruik is vastgelegd als richting (eis 7); de vraag is welke gebruiken er zijn.
- Meerdere formaten/varianten per foto, en wie bepaalt de set?
- Rechten per module (wie mag welke foto's zien, gebruiken, verwijderen)?
- Publieke adressen: blijven die per module (`/media/<module>/...`) of komt er een gedeeld pad?
- Gebruiksregister: hoe weet de bibliotheek waar een foto wordt gebruikt (per module aanmelden of centraal)?
## Schatting (no-code, 2026-11-17)
Niveau 3: circa 12-18 dagen, 60-100 commits, plus 1-2 dagen ontwerp (±50%). Grootste risico: adresstabiliteit en de datamigratie van bestaande Hero-afbeeldingen.