Schaalbaarheid & enterprise-readiness¶
IntraVox is ontworpen om te schalen van kleine teams tot grote organisaties. Dit document beschrijft de performance-optimalisaties, resilience-patronen en enterprise-features.
Performance op schaal¶
Geteste capaciteit¶
| Metric | Ondersteund | Notes |
|---|---|---|
| Nextcloud-gebruikers | Tot 10.000 | People-widget gebruikt groep-scoped queries waar mogelijk |
| IntraVox-pagina's | Tot 5.000 | Pagina-metadata in DB geïndexeerd voor snelle lookups |
| Gelijktijdige gebruikers | Tot 1.000 | Singleflight voorkomt thundering herd op gedeelde resources |
| Externe feed-bronnen | Onbeperkt | Circuit breaker en background-refresh voorkomen cascade-failures |
De server dimensioneren¶
De aantallen hierboven gaan ervan uit dat de server genoeg PHP-workers kan draaien voor de lezers die tegelijk binnenkomen. Dat is de instelling die er het meest toe doet, en de standaard is afgestemd op een kleine installatie.
Feeds maken een pagina duur, en alleen de eerste lezer betaalt. De RSS-cache heeft de feed-URL als sleutel, zonder gebruiker erin: één lezer maakt de pagina warm en iedereen daarna wordt 15 minuten uit die cache bediend (een uur als de bron onbereikbaar is). Gemeten: vijftien gecachte feeds kosten samen 1,6 ms, tegenover ruwweg 160 ms per stuk als ze opgehaald moeten worden.
Daarom stuurt de client normaal één request per pagina en splitst hij pas als de server meldt dat er echt opgehaald moest worden. Een warme pagina kost één PHP-worker, een koude pagina kortstondig drie.
| Lezers tegelijk | Workers toestaan | Geheugen voor PHP | Opmerkingen |
|---|---|---|---|
| Tot 25 | 30–50 (de standaard 150 is ruim) | 512 MB–1 GB | Eén core volstaat. APCu alleen is genoeg. |
| 25–150 | 150 (de Apache-standaard) | 2–4 GB | Zet Redis erbij: feed- en paginacache worden dan gedeeld tussen workers in plaats van per proces gedupliceerd. |
| 150–500 | 300–500 | 8–16 GB | Redis verplicht. Geef de achtergrondtaak ruimte (zie hieronder). |
| 500–1.000 | 600–1.000 | 16–32 GB | Redis verplicht, en overweeg een tweede appserver achter de loadbalancer. |
Het aantal workers is MaxRequestWorkers bij Apache en pm.max_children bij
PHP-FPM. Reken op 30–50 MB geheugen per worker voor IntraVox, en sta nooit meer
workers toe dan dat geheugen toelaat — een machine die swapt is trager dan een
machine die wachtrijt.
Redis is verreweg de nuttigste toevoeging. Zonder gedeelde cache houdt elke
PHP-worker zijn eigen kopie, dus honderd workers halen dezelfde feed honderd keer
op. Mét Redis bedient één fetch ze allemaal. Configureer 'm als zowel
memcache.distributed als memcache.locking.
Lezers houden de cache zelf warm. Een entry geldt 15 minuten als vers en wordt daarna nog een uur uitgeserveerd, terwijl precies één request 'm op de achtergrond ververst. Een feed valt dus pas terug op een blokkerende fetch als niemand de pagina een uur lang heeft geopend — hoe drukker de installatie, hoe zeldzamer dat is. Hier is geen configuratie voor nodig.
FeedRefreshJob ververst geconfigureerde feed-verbindingen (de LMS- en
issue-tracker-koppelingen uit het beheerscherm) elke 10 minuten. Hij verwarmt
géén RSS-URL's die op een widget zijn ingevuld; die leunen op het mechanisme
hierboven. Gebruik je verbindingen, dan moet Nextcloud-cron op systeemcron staan
en niet op AJAX — AJAX-cron draait alleen als iemand een pagina opent, en dat is
precies het moment waarop je niet wilt ophalen.
Hoeveel feed-widgets per pagina is redelijk? Tot twintig is comfortabel. Daarboven stuurt de client meer dan één request per paginaweergave, en dat telt mee in de limiet van 30 requests per minuut per gebruiker. Een pagina met zevenenvijftig widgets werkt, maar kost drie requests elke keer dat iemand 'm opent — overweeg 'm op te splitsen in subpagina's, wat lezers meteen iets geeft dat te overzien is.
Bundle-optimalisatie¶
De frontend-JavaScript-bundle is gesplitst voor snelle initial-page-loads:
| Chunk | Grootte | Loading |
|---|---|---|
intravox-main.js |
~220 KB | Direct geladen |
intravox-vendors.js |
~2.9 MB | Direct geladen (gedeelde vendor-code, browser-cached) |
| TipTap-editor | ~240 KB | Lazy-loaded alleen bij edit-modus |
| Widget-componenten | ~5–30 KB elk | Lazy-loaded per widget-type op de pagina |
Alle widget-componenten (News, People, Calendar, Feed, Links) worden via defineAsyncComponent geladen, dus pagina's zonder een widget-type downloaden de code nooit. De TipTap rich-text-editor en al z'n uitbreidingen worden dynamisch geladen bij eerste bewerking — lezers betalen die kost nooit.
Caching-strategie¶
Server-side:
| Cache | Scope | TTL | Backend |
|---|---|---|---|
| Pagina-tree | Per gebruiker + taal | 5 min | Redis/APCu (gedistribueerd) + in-process statisch |
| Feed-resultaten | Per bron + config | 15 min | Redis/APCu (gedistribueerd) |
| People-filter-resultaten | Per filter-combinatie | 1 uur | Redis/APCu (gedistribueerd) |
| Gebruikers-status | Per gebruiker | Per request | In-process |
| Bestand-content / -permissies / dir-listings | Per request | Request-lifetime | In-process |
Client-side:
| Cache | TTL | Backend |
|---|---|---|
| Pagina-lijst | 5 min | localStorage |
| Navigatie | 5 min | localStorage |
| Footer | 5 min | localStorage |
| Engagement-instellingen | 5 min | localStorage |
| Huidige pagina | 2 min stale-while-revalidate | localStorage |
HTTP-caching:
| Endpoint | Cache-Control | ETag |
|---|---|---|
| Navigatie-API | private, max-age=300, must-revalidate |
Ja |
| Footer-API | private, max-age=300, must-revalidate |
Ja |
| RSS-feed-API | public, max-age=300, must-revalidate |
Ja |
| Image-proxy | public, max-age=86400, immutable |
Nee |
Pagina-metadata-index¶
Pagina-metadata (titel, uniqueId, pad, taal, status, modification-time) is geïndexeerd in een database-tabel (intravox_page_index) voor snelle lookups. Dit vermijdt O(N) filesystem-traversals voor pagina-listing, tree-building en zoek-operaties.
De index wordt automatisch bijgewerkt bij pagina-create, -update en -delete. De Nextcloud unified-search-provider (Ctrl+K) gebruikt de index voor instant titel-gebaseerde zoekresultaten, met fallback naar full-text filesystem-search voor content-matches.
Progressive rendering¶
Pagina-tree-componenten (PageTreeSelect, PageTreeModal) gebruiken progressive rendering: alleen de eerste 50 children van elk node worden initieel gerenderd. Een "Toon meer"-knop laadt extra items in batches van 50. Hierdoor blijft de DOM klein zelfs met duizenden pagina's.
Resilience¶
Feed-widget¶
Externe feed-bronnen zijn beschermd door drie lagen:
- Singleflight-lock — wanneer de cache vervalt, fetcht alleen de eerste request van de externe bron. Een request voor één losse feed wacht (tot 5 seconden) en leest daarna uit de net-gevulde cache. Voorkomt thundering herd wanneer veel gebruikers tegelijk dezelfde pagina openen.
Een batch-request wacht niet. Het wachten wordt per feed betaald en de feeds in een batch worden na elkaar opgehaald, dus een pagina met twintig widgets zou anders twintig keer vijf seconden kunnen slapen zonder één externe request te doen. Een batch haalt de feed dan zelf op — sneller, en eerlijker naar de lezer.
-
Circuit breaker — na 3 opeenvolgende mislukkingen voor een bron opent de circuit breaker, en volgende requests geven direct een "tijdelijk niet beschikbaar"-melding terug. De circuit reset automatisch na 5 minuten, of direct bij een succesvolle fetch.
-
Stale-while-revalidate — een entry is 15 minuten vers en wordt daarna nog een uur geserveerd. Voorbij het verse venster krijgt een lezer de gecachete kopie meteen, terwijl één request 'm op de achtergrond ververst. Niemand wacht achter andermans refetch.
FeedRefreshJob ververst daarnaast geconfigureerde feed-verbindingen elke 10 minuten. RSS-URL's op een widget worden niet voorverwarmd; die houden lezers warm volgens de regel hierboven.
Aanvullend:
- HTTP-timeout is 8 seconden, zodat één onbereikbare bron geen PHP-worker eindeloos vasthoudt
- Private IP-ranges worden geblokkeerd (SSRF-bescherming)
- Image-URLs zijn HMAC-ondertekend voor proxy-requests
- API-responses groter dan 10 MB worden geweigerd vóór parsing om OOM te voorkomen
People-widget¶
De People-widget beschermt tegen grote Nextcloud-installaties:
- Groep-scoped queries: bij groep-filter worden alleen gebruikers in die groep geladen — het efficiënte pad dat schaalt naar tienduizenden accounts
- Hard cap: het ongescoped filter-pad (geen groep-filter) is afgekapt op 5.000 gebruikers om OOM en timeouts te voorkomen
- Gedistribueerde cache: filter-resultaten worden 1 uur in Redis/APCu gecached, wat herhaalde volledige user-scans voorkomt
- Batch-status-fetching: gebruikers online/away/DND-statussen in één batch-call vooraf opgehaald in plaats van één API-call per gebruiker
News-widget¶
De News-widget-folder-scanner heeft een configureerbare collection-limit (standaard max(limit * 4, 200)) met early exit. Zodra genoeg items zijn verzameld stopt de recursieve folder-scan direct — ook na terugkeer uit recursieve subfolder-calls.
Export¶
De ZIP-export schrijft pagina's incrementeel naar disk in plaats van de hele export in memory te accumuleren. Elke pagina wordt individueel JSON-encoded en naar export.json geschreven, waardoor memory-gebruik constant blijft ongeacht het aantal pagina's.
Beveiliging¶
Rate limiting¶
Rate limits gelden per endpoint-categorie, niet over de hele linie — 14 van de 73 muterende operaties dragen een expliciete limiet. De rest leunt op Nextclouds brute-force-bescherming, en dat is een ánder mechanisme: die slaat aan op herhaald mislukte authenticatie vanaf één adres, niet op aantallen verzoeken.
| Endpoint-categorie | Limiet | Periode |
|---|---|---|
| Pagina aanmaken / verwijderen | 10 requests | 60 sec |
| Bulk-operaties (delete, move) | 5 requests | 60 sec |
| Comments | 20 requests | 60 sec |
| Reacties | 30 requests | 60 sec |
| Feed-fetch (geauthenticeerd) | 30 requests | 60 sec |
| Feed-fetch (publieke share) | 30 requests | 60 sec |
| Analytics-tracking | 60 requests | 60 sec |
| Publieke pagina-toegang | 60 requests | 60 sec |
Content Security Policy¶
IntraVox zet een strikte CSP op alle pagina-responses:
script-src: 'self'— alleen scripts van het Nextcloud-domeinframe-src: 'self' [whitelisted video-domeinen]— alleen iframes van geconfigureerde video-services- Geen
unsafe-evalofunsafe-inline
Audit-logging¶
Administratieve operaties worden gelogd met de IntraVox Audit:-prefix voor SIEM-integratie:
- Bulk delete / move / update (inclusief pagina-ID's en gebruiker)
- Licentie-sleutel-wijzigingen
- Organisatie-instellingen-wijzigingen
- Engagement-instellingen-wijzigingen
Logs worden geschreven naar het Nextcloud-log op info-niveau en filterbaar via de IntraVox Audit:-prefix.
AVG-compliance¶
Wanneer een Nextcloud-gebruiker wordt verwijderd, ruimt IntraVox automatisch op:
- Analytics-view-records (gehashte user-ID)
- Pagina-lock-records
- Feed-tokens en LMS-OAuth-tokens (opgeslagen in Nextcloud-user-preferences)
Dit wordt afgehandeld door de UserDeletedListener die naar Nextcloud's UserDeletedEvent luistert.
Health check¶
Een publiek health-check-endpoint is beschikbaar voor monitoring en orchestration:
Widget-performance¶
Debounced watchers¶
Alle widget-componenten (News, People, Feed) debouncen hun configuratie-watchers met 300ms vertraging. Voorkomt API-call-bursts wanneer widget-settings snel worden gewijzigd in de editor.
Uitgestelde initial-fetch¶
News- en Feed-widgets gebruiken requestIdleCallback voor de initial data-fetch, en stellen de network-request uit tot de hoofdthread van de browser idle is. Verbetert waargenomen page-load-performance door layout en rendering te prioriteren.
Parallel bootstrap¶
De applicatie laadt pagina's, navigatie, footer en engagement-instellingen parallel bij mount (Promise.all). Pagina-content en lock-status worden ook parallel opgehaald, wat een sequentiële waterfall elimineert die voorheen ~100ms aan pagina-navigatie toevoegde.