Telepítés és műszaki konfiguráció

Ez az útmutató intézményi informatikai csapatoknak segít a VisuoLab telepítésének megtervezésében. A műszaki összefoglaló magas szintű információkat tartalmaz; a pontos kapacitást és konfigurációt minden intézménynél külön kell ellenőrizni. Nem tartalmaz ellenőrzött, végrehajtható telepítési parancsokat vagy konkrét függőségverziókat.

Architektúra és szolgáltatások

A szolgáltatások külön Docker-konténerekben futnak, amelyeket a Docker Compose koordinál.

Komponens	Technológia
Backend	Laravel / PHP
Frontend	Nuxt.js / Vue.js / Vuetify
Adatbázis	MySQL vagy MariaDB
Gyorsítótár és feladatsorok	Redis
Aszinkron feladatfeldolgozás	Horizon
Videó- és hangfeldolgozás	FFmpeg
Webkiszolgáló	NGINX
Közös szövegszerkesztés	Etherpad
Videókonferencia	Jitsi Meet
Telepítés	Docker és Docker Compose

Kiindulási infrastruktúra

Erőforrás	Tervezési referencia
CPU	4 vCPU
Memória	16 GB RAM
Tárhely	250 GB SSD
Operációs rendszer	Ubuntu Server 22.04 LTS vagy újabb
Kapcsolat	Stabil hálózat, nyilvános IP vagy intézményi reverse proxy

Ez egyetlen virtuális gépre vonatkozó kiindulási profil, teszteléshez, pilotokhoz és alacsony vagy közepes terheléshez. Nem garantál meghatározott felhasználószámot vagy videókonferencia-kapacitást. Az egyidejű használatot, a videófeltöltéseket, a feldolgozást, a megőrzést, a mentéseket és a későbbi növekedést külön kell méretezni.

A telepítés előkészítése

Lépj kapcsolatba a Levante Lab technikai csapatával, és jelöld ki az intézményi műszaki kapcsolattartót.
Egyeztesd a platformadminisztráció, tárhely, domain, tanúsítvány, adatbázis, médiafájlok, mentések és frissítések felelőseit.
Szerezd be az adott kiadás jóváhagyott kódját, a Docker/Compose-fájlokat, a telepítési leírást és az ellenőrzött PHP-, Node.js- és adatbázisverziókat.
Készítsd elő az infrastruktúrát és a tartós köteteket. Az adatbázis és a feltöltött fájlok a konténerek újralétrehozása után is megmaradjanak.
Konfiguráld a domaint, a HTTPS-hozzáférést, az adatbázist, a frontend szolgáltatást, a feladatsorokat és a médiakezelést.
Ellenőrizd az Etherpad és Jitsi Meet hálózati igényeit, majd készítsd elő az adminisztrátori fiókokat, jogosultságokat és nyelveket.
Dokumentáld a telepített kiadást, a konfigurációt és a felelős csapatokat.

Hálózat és külső hozzáférés

A műszaki összefoglaló 443-as porton elérhető HTTPS-t és belső Docker-hálózati kommunikációt ír le. Ellenőrizd a domainirányítást, a tanúsítványokat és megújításukat, a proxyt, a konténerhálózatok elkülönítését és a videókonferencia követelményeit. A 443-as port nem a teljes tűzfalszabály-lista.

Videótárhely és feldolgozás

A videók és a feldolgozás eredményei gyorsan növelhetik a tárhelyhasználatot. Kövesd a szabad helyet, állíts be riasztást, és ellenőrizd a hibás feldolgozási feladatokat. Teszteld a Redis/Horizon és az FFmpeg működését valódi próbafeltöltéssel.

Biztonság és működési folytonosság

Kontroll	Intézményi ellenőrzés
TLS 1.3	Engedélyezett protokollok a HTTPS-végponton.
AES-256 titkosítás	Védett kötetek, tárhely, mentések és kulcskezelés.
Szerepkör-alapú jogosultság	Általános felhasználó, résztvevő, felügyelő, adminisztrátor.
SSH-kulcs és MFA	Biztonságos adminisztrációs hozzáférés.
Naplózás és monitorozás	Naplók, riasztások, felelősök és hozzáférések.
Frissítések	Alkalmazás, konténerképek és kiszolgáló karbantartása.
Titkosított rendszeres mentés	Gyakoriság, elkülönített hely és visszaállítási próba.

A kontrollok nem válnak automatikusan aktívvá a platform telepítésétől.

Biztonsági mentések

Egyeztesd a mentések gyakoriságát, megőrzését, helyét és a visszaállítás felelősét. Végezz olyan visszaállítási próbát, amely az adatbázist és a médiafájlokat is magában foglalja.

Adatok és megőrzési idők

Az összefoglaló szerint felhasználói adatok, videók, hanganyagok, annotációk, hozzászólások, közösen készített tartalmak, IP-címek és használati adatok is kezelhetők. Referenciaként szerepel, hogy a felhasználói adatok az utolsó aktivitás után 12 hónappal törölhetők vagy anonimizálhatók, a mentések 90 nap után felülírhatók, és tudományos adatkészletek anonimizált formában archiválhatók. Ezek referenciaidők, nem bizonyított automatikus törlési mechanizmusok. A tényleges megőrzést és adatkezelési megfelelést helyben kell ellenőrizni és megállapodni róla.

Nyelvek konfigurálása

A nyelvek kezelése az adminisztrációs panelt és a frontend kódját is érintheti. A műszaki összefoglaló alapján:

A frontend lang könyvtárában hozz létre fordítási JSON-fájlt, például en.json, pt.json vagy de.json.
A nuxt.config.js fájlban az i18n locales listában rögzítsd a nyelvkódot, nevet és fájlhivatkozást.
Master jogosultsággal a Platform → Platform Form → Languages részen állítsd be a nyelvet.
A fejlesztő a megfelelő adatbázisrekord is_default mezőjét állíthatja true értékre az alapértelmezett nyelvhez.
Ellenőrizd a menüket, értesítéseket, üzeneteket, többnyelvű űrlapokat és a frontend buildet.

Fontos: a pontos táblanevet, eljárást és a kiadásra jellemző lépéseket a telepített verzió forráskódjából kell ellenőrizni. A nyelv hozzáadása nem fordítja le automatikusan a videókat, annotációkat vagy adatbázisrekordokat.

Ellenőrzőlista

A domain HTTPS-en elérhető.
A bejelentkezés és a szerepkörök működnek.
Próbaforrás megtekinthető és közzétehető.
Videó feltölthető, feldolgozható és lejátszható.
Az aszinkron feladatfeldolgozás működik.
Terek és tevékenységek teszteltek.
Etherpad és Jitsi Meet elérhető, ha engedélyezett.
A nyelvek és alapértelmezett locale konzisztens.
Az adatok tartósan megmaradnak.
A mentési és visszaállítási próba sikeres.
A kiadás, a felelősségek és a karbantartási eljárások dokumentáltak.

Végrehajtható telepítési utasítások

A reprodukálható parancsokhoz szükség van a tényleges Docker Compose-fájlokra, függőségverziókra, környezeti sablonokra, adatbáziseljárásokra, frontend buildre, worker- és ütemezési beállításokra, integrációkra és frissítési útmutatóra.