Installatiegids voor retail- en franchisenetwerken

Conceptuele toewijzing

Niets in het paneel heet een winkel of een franchisenemer. De tabel zegt welk object welke rol speelt; de hoofdstukken hieronder richten ze in die volgorde in.

1Vereisten

Wat je nodig hebt voor de installatie.

1. Een server op het hoofdkantoor (Ubuntu 22.04 of 24.04), de installer en een server voor elke regio met veel winkels die vanuit die winkels bereikbaar is.
2. De content van het winkelkanaal (een encoder of een herhalende bron), de opnames van inwerk- en productopleidingen en de schermen of mediaspelers in de winkels.
3. Een besluit over de franchisestructuur: welke regio's een node krijgen en wie bij elke franchisenemer de lijnen beheert.

2Uitrol van de infrastructuur

Eerst het hoofdkantoor, daarna de regio's.

1. Draai de installer op de server van het hoofdkantoor en stel de afspeelbasis-URL in op een adres dat de winkels kunnen bereiken, achter TLS.
2. Voeg het winkelkanaal toe onder Streams en de opleidingsopnames onder Movies, en controleer ze in de webspeler.
3. Meld via Servers een node per regio aan; het paneel installeert hem via SSH, of de node meldt zich aan met een eenmalige code, en stuurt de winkels van die regio ernaartoe.
4. Maak een partneraccount voor het contentteam van het hoofdkantoor met rechten voor de catalogus en geen voor de lijnen van de winkels.

3Indeling van de content

Het winkelkanaal en de opleidingsbibliotheek.

1. Maak een live stream voor het winkelkanaal en zet hem in een eigen bouquet.
2. Maak categorieën per onderwerp en een serie per opleiding, met één aflevering per les; voeg één bouquet per functie toe (verkopers, managers, nieuwe medewerkers).
3. Maak één pakket voor de winkelschermen en één pakket per functie, elk met zijn bouquets en met de toegangsperiode als looptijd.
4. Geef franchisenemers de pakketten die ze aan hun winkels en medewerkers mogen doorverkopen.

4Configuratie van partners (resellers)

Eén partneraccount per franchisenemer.

1. Maak een groep met rechten die beperkt zijn tot lijnen, zonder wijzigingen in de catalogus.
2. Voeg elke franchisenemer toe onder Users → een reseller toevoegen, met die groep, zijn pakketten en een creditsaldo.
3. Een franchisenemer met meerdere regio's kan per regio een subreseller toevoegen, elk met eigen winkels.

5Configuratie van lijnen voor winkels en medewerkers

Een lijn per scherm en per medewerker.

1. Maak onder Lijnen → toevoegen één lijn per winkelscherm aan met de naam van de winkel en het winkelpakket; de franchisenemer doet hetzelfde voor zijn eigen winkels.
2. Stel het maximale aantal verbindingen in op het aantal schermen in de winkel, en op twee voor een medewerker (winkelvloer en telefoon).
3. Koppel een winkellijn aan het adres van de winkel als die een vast adres heeft, zodat de inloggegevens elders niet werken.
4. Configureer de speler van het scherm eenmalig (M3U, Xtream Codes API of het adres van de webspeler) en bewaar de inloggegevens in het dossier van de winkel.

6Opleidings- en productvideo

De bibliotheek voor medewerkers.

1. Upload elke opleiding als serie en elke productfilm als film, of importeer ze met de VOD-ingesttaak in de mediaroot.
2. Zet de opnames via hun categorieën in de bouquet van de juiste functie.
3. Controleer met een testlijn wat elke functie ziet voordat je de bibliotheek voor de franchisenemers opent.

7Het winkelkanaal

Eén kanaal voor alle schermen.

1. Voeg het winkelkanaal toe als live stream, gevoed door de encoder van het hoofdkantoor via RTMP of door een herhalende bron.
2. Schakel catch-up in voor de opleidingssessies die live gaan, en upload de opname daarna naar de bibliotheek.
3. De nodes in de regio's halen het kanaal één keer op bij de origin en bedienen hun winkels, zodat de verbindingen van de winkels niet verzadigd raken.

8Vervaldatum en verlenging

Toegang volgt de winkel of het contract.

1. Een lijn verloopt aan het einde van de periode van zijn pakket; de franchisenemer verlengt hem met een pakket of een credit.
2. Schakel de lijn van een gesloten winkel of een vertrekkende medewerker uit.
3. Abonneer het franchisebeheer- of HR-systeem op de webhooks om lijnen te zien die bijna verlopen of al zijn verlopen.

9Integratie met franchise- of HR-systemen

Systemen sturen de lijnen aan; de speler speelt af.

1. Maak een Reseller-API-sleutel voor het franchisebeheer- of HR-systeem; dat roept create_line, renew_line, enable_line en disable_line aan, met een request-id bij elke schrijfactie.
2. Gebruik een commerceconnector wanneer je franchisenemers voor de dienst factureert; elk ander systeem gebruikt de Reseller-API en webhooks.
3. Er is geen single sign-on voor kijkers: medewerkers melden zich in de speler aan met de inloggegevens van hun lijn.

10Beveiligingsoverwegingen

Houd elke winkel op zijn eigen lijnen.

1. Serveer het paneel achter een reverse proxy met TLS en stel TRUSTED_PROXIES in, zodat het auditlogboek en de IP-regels echte adressen zien.
2. Aanmelden met twee factoren voor elk account van het hoofdkantoor; franchisenemers krijgen een rechtengroep die beperkt is tot hun eigen lijnen.
3. Een verbindingslimiet per lijn, ondertekende en verlopende afspeellinks en adresbinding voor de winkelschermen.
4. Schakel de versleutelde databaseback-up met een off-sitekopie in en gebruik het auditlogboek om wijzigingen van lijnen en catalogus te controleren.

11Probleemoplossing

De gebruikelijke eerste controles.

1. Een winkelscherm is zwart: controleer of zijn lijn is ingeschakeld en niet is verlopen, de adresbinding en de verbindingslimiet als een tweede apparaat de lijn gebruikt.
2. Een regio buffert: controleer de heartbeat van de regionale node en of de winkels ernaartoe worden gestuurd.
3. Een franchisenemer kan geen lijnen aanmaken: controleer zijn creditsaldo, zijn groepsrechten en de pakketten die aan hem zijn toegewezen.
4. Het auditlogboek toont het adres van de proxy: stel TRUSTED_PROXIES in op de proxy en herstart het paneel.