Installationsguide för idrottsföreningar och akademier

Begreppsmässig mappning

Inget i panelen heter lag eller medlem. Tabellen anger vilket objekt som spelar vilken roll; kapitlen nedan sätter upp dem i den ordningen.

1Förutsättningar

Vad du ska ha innan du installerar.

1. En server (Ubuntu 22.04 eller 24.04) med en publik adress eller en domän, och tillräcklig uppströmsbandbredd för de matcher du planerar att streama.
2. Kameran och encodern på planen som kan skicka RTMP, och de inspelade tränings- och analysfiler dina tränare redan har.
3. Ett beslut om vem som ser vad: vilka lag som delar material, vilka matcher som bara är för medlemmar och vem i personalen som får ett panelkonto.

2Driftsättning av infrastrukturen

Först akademin, en nod när matchdagar kräver det.

1. Kör installationsprogrammet på akademins server och lägg panelen bakom en reverse proxy med TLS; ange de betrodda proxyerna så att loggar och IP-regler ser tittarens riktiga adress.
2. Ange uppspelningsbasens URL till den publika adress tittarna når, så att länkarna panelen utfärdar fungerar hemifrån.
3. Om många familjer tittar på samma match, registrera en nod via Servers; panelen installerar den via SSH och fördelar livekanalen därifrån.
4. Skapa ett partnerkonto (reseller) för tränarstaben med behörigheter för katalogen och inga för medlemmarnas linjer.

3Organisation av innehållet

Lag och säsonger som kategorier, åtkomst som bouquets.

1. Skapa kategorier per åldersgrupp och per säsong, och serier för tävlingar med ett avsnitt per match.
2. Skapa en bouquet per lags analysmaterial, en för livematchkanalerna och en för hela akademin.
3. Skapa ett paket per sorts medlemskap: de bouquets det ger, med säsongen som löptid och ett pris i krediter om personalen säljer det.
4. Namnge bouquets efter det lag eller den tävling de hör till, så att personalen vet vilket paket de ska ge en familj.

4Konfiguration av partner (återförsäljare)

Personal som hanterar sina egna medlemmar, om föreningen vill det.

1. Skapa en grupp med katalogbehörigheter för tränarna och en grupp med linjebehörigheter för medlemssekreteraren.
2. Lägg till var och en av dem som återförsäljare med motsvarande grupp; ge sekreteraren krediter bara om medlemskap säljs via panelen.
3. En satellitakademi eller en supporterklubb med egna medlemmar får ett eget partnerkonto och egna paket.

5Konfiguration av medlems- och familjeåtkomst

En linje per medlem eller per familj.

1. Skapa en Reseller API-nyckel för butiken eller föreningshanteringssystemet och förvara den bland det systemets hemligheter.
2. Vid registrering anropar systemet action=create_line med medlemskapets paket och ett request-id; säsongen är paketets löptid.
3. Ställ in max antal anslutningar på de enheter en familj behöver (vanligtvis tre eller fyra) så att ett medlemskap inte delas utanför hushållet.
4. För en provmatchdag, lägg till en linje via Linjer → lägg till med ett testpaket, eller skriv ut aktiveringskoder för supportrarna på läktaren.

6Analys- och reprisbibliotek

Matcher och pass på begäran.

1. Ladda upp varje match eller pass som ett avsnitts källa, eller importera det med VOD-ingestjobbet; behåll datum, motståndare och lag i titeln.
2. Koppla inspelningen till lagets bouquet via dess serie, så att bara det lagets linjer ser den.
3. Kontrollera uppspelningen med en testlinje för varje medlemskap för att bekräfta vem som ser vad.

7Match- och träningsflöden

En kamera på planen som en livekanal.

1. Lägg till en live-ström för varje encoder på planen (RTMP-push) och lägg den i bouqueten för matchdagen.
2. Aktivera catch-up så att en familj som ansluter sent kan spola tillbaka, och lägg till inspelningen i biblioteket efter slutsignalen.
3. Kontrollera en hektisk matchdag att noden hämtar kanalen en gång från origin och betjänar de tittare som dirigeras till den.

8Medlemskapets förfallodatum

Åtkomsten följer säsongen.

1. En linje går ut vid slutet av sitt pakets period; butiken förnyar den med action=renew_line när nästa säsongs avgift är betald.
2. Prenumerera butiken på webhooks för att skicka en påminnelse vid line.expiring och stänga medlemskapet vid line.expired.
3. En spelare som slutar mitt i säsongen inaktiveras av butiken med action=disable_line; linjen sparas för bokföringen.

9Integration med butiken eller föreningsprogramvaran

Systemen styr åtkomsten; spelaren spelar.

1. Installera connectorn för din handelsplattform (WooCommerce, Shopify och fler) på butikens sida så att ett köp skapar linjen och en betalning förnyar den.
2. Ett föreningshanterings- eller biljettsystem ansluts via Reseller API och webhooks; det finns ingen inbyggd connector för det.
3. Det finns ingen single sign-on för tittare: medlemmar loggar in i spelaren med inloggningsuppgifterna för sin linje, som butiken skickar dem.

10Säkerhetsaspekter

Lagmaterial stannar hos laget.

1. Servera panelen och uppspelningsbasens URL över TLS och sätt TRUSTED_PROXIES till din reverse proxy.
2. Tvåfaktorsinloggning för varje panelkonto, och behörighetsgrupper så att sekreteraren inte kan ändra katalogen och tränarna inte kan se linjer.
3. Signerade uppspelningslänkar som går ut, en anslutningsgräns per linje och en IP- eller landbindning för personallinjer.
4. Krypterade databassäkerhetskopior med en kopia utanför platsen, och granskningsloggen för varje ändring av linjer och katalog.

11Felsökning

De vanliga första kontrollerna.

1. En förälder ser a-lagets analys: kontrollera linjens paket och de bouquets det ger.
2. En ny medlem saknar åtkomst efter betalning: kontrollera Reseller API-anropsloggen för butikens begäran och linjens förfallodatum.
3. Matchflödet hackar vid avspark: kontrollera encoderns uppladdning på planen, och nodens heartbeat om en betjänar tittarna.
4. Granskningsloggen visar proxyns adress: sätt TRUSTED_PROXIES till proxyn och starta om panelen.