Ga naar inhoud

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:

  1. 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.

  1. 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.

  2. 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-domein
  • frame-src: 'self' [whitelisted video-domeinen] — alleen iframes van geconfigureerde video-services
  • Geen unsafe-eval of unsafe-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:

GET /apps/intravox/api/health
→ {"status": "ok", "app": "intravox", "version": "1.3.0"}

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.