> ## Documentation Index
> Fetch the complete documentation index at: https://docs-visuolab.levantelab.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

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

> A VisuoLab telepítésének és API-integrációinak műszaki útmutatója.

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

1. Lépj kapcsolatba a [Levante Lab technikai csapatával](mailto:contato@levantelab.com.br), és jelöld ki az intézményi műszaki kapcsolattartót.
2. Egyeztesd a platformadminisztráció, tárhely, domain, tanúsítvány, adatbázis, médiafájlok, mentések és frissítések felelőseit.
3. 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.
4. 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.
5. 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.
6. 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.
7. 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:

1. 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**.
2. A **nuxt.config.js** fájlban az **i18n locales** listában rögzítsd a nyelvkódot, nevet és fájlhivatkozást.
3. **Master** jogosultsággal a **Platform → Platform Form → Languages** részen állítsd be a nyelvet.
4. A fejlesztő a megfelelő adatbázisrekord **is\_default** mezőjét állíthatja **true** értékre az alapértelmezett nyelvhez.
5. 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.

## Műszaki hivatkozások

[VisuoLab API-dokumentáció](https://api-visuolab.levantelab.com.br/docs/en#description/introduction) · [További technikai dokumentumok](https://visuolab.levantelab.com.br/en/documentation)

[Integrációk és API →](https://docs-visuolab.levantelab.com.br/hu/integrations-api.md)

## Műszaki illusztrációk

![Telepítés és műszaki konfiguráció: 1. ábra](https://mintcdn.com/levante-lab/AmDjV5pdvScH8PnS/images/installation/opening.png?fit=max\&auto=format\&n=AmDjV5pdvScH8PnS\&q=85\&s=22ec1e9f965c47fa6f7987162fa7ae06)

1. illusztráció

![Telepítés és műszaki konfiguráció: 2. ábra](https://mintcdn.com/levante-lab/Z9kRMfqGtaUHT5na/images/installation/step-0-email.png?fit=max\&auto=format\&n=Z9kRMfqGtaUHT5na\&q=85\&s=c4e1574850f3ed42a5575a89789ce596)

2. illusztráció

![Telepítés és műszaki konfiguráció: 3. ábra](https://mintcdn.com/levante-lab/Z9kRMfqGtaUHT5na/images/installation/step-1.png?fit=max\&auto=format\&n=Z9kRMfqGtaUHT5na\&q=85\&s=44c2aba2cbb6b4190d9fe0add346b9f8)

3. illusztráció

![Telepítés és műszaki konfiguráció: 4. ábra](https://mintcdn.com/levante-lab/Z9kRMfqGtaUHT5na/images/installation/step-2.png?fit=max\&auto=format\&n=Z9kRMfqGtaUHT5na\&q=85\&s=f41a1bb38053cf90db488c5354df4893)

4. illusztráció

![Telepítés és műszaki konfiguráció: 5. ábra](https://mintcdn.com/levante-lab/Z9kRMfqGtaUHT5na/images/installation/step-3.png?fit=max\&auto=format\&n=Z9kRMfqGtaUHT5na\&q=85\&s=5c6b34540b28fc2e26ac34aa9d7d1af0)

5. illusztráció

![Telepítés és műszaki konfiguráció: 6. ábra](https://mintcdn.com/levante-lab/Z9kRMfqGtaUHT5na/images/installation/step-4.png?fit=max\&auto=format\&n=Z9kRMfqGtaUHT5na\&q=85\&s=cf53dc9b7579ee0c71a620103cd7257d)

6. illusztráció

![Telepítés és műszaki konfiguráció: 7. ábra](https://mintcdn.com/levante-lab/Z9kRMfqGtaUHT5na/images/installation/step-5.png?fit=max\&auto=format\&n=Z9kRMfqGtaUHT5na\&q=85\&s=f94b878aa63a51b3f6540ba77e4e565b)

7. illusztráció

![Telepítés és műszaki konfiguráció: 8. ábra](https://mintcdn.com/levante-lab/Z9kRMfqGtaUHT5na/images/installation/step-6.png?fit=max\&auto=format\&n=Z9kRMfqGtaUHT5na\&q=85\&s=f11b417baff1e2e8872635840b2f7600)

8. illusztráció

![Telepítés és műszaki konfiguráció: 9. ábra](https://mintcdn.com/levante-lab/Z9kRMfqGtaUHT5na/images/installation/step-7.png?fit=max\&auto=format\&n=Z9kRMfqGtaUHT5na\&q=85\&s=7f12bc905df2b885617af19d257582ce)

9. illusztráció

![Telepítés és műszaki konfiguráció: 10. ábra](https://mintcdn.com/levante-lab/-78XUSikEFsH2Z-B/images/installation/language-step-1.png?fit=max\&auto=format\&n=-78XUSikEFsH2Z-B\&q=85\&s=7f8e4cd2da43d81e648b06b2dbef0734)

10. illusztráció

![Telepítés és műszaki konfiguráció: 11. ábra](https://mintcdn.com/levante-lab/-78XUSikEFsH2Z-B/images/installation/language-step-2.png?fit=max\&auto=format\&n=-78XUSikEFsH2Z-B\&q=85\&s=96f60c35604cbbf3e4d22a7631541db1)

11. illusztráció

![Telepítés és műszaki konfiguráció: 12. ábra](https://mintcdn.com/levante-lab/-78XUSikEFsH2Z-B/images/installation/language-step-3.png?fit=max\&auto=format\&n=-78XUSikEFsH2Z-B\&q=85\&s=93197e498e52a1f4a695fe2ef2ce5252)

12. illusztráció

![Telepítés és műszaki konfiguráció: 13. ábra](https://mintcdn.com/levante-lab/-78XUSikEFsH2Z-B/images/installation/language-step-4.png?fit=max\&auto=format\&n=-78XUSikEFsH2Z-B\&q=85\&s=0daa5e87feacdf207bc71ededca8fa48)

13. illusztráció

![Telepítés és műszaki konfiguráció: 14. ábra](https://mintcdn.com/levante-lab/-78XUSikEFsH2Z-B/images/installation/language-step-5.png?fit=max\&auto=format\&n=-78XUSikEFsH2Z-B\&q=85\&s=f1de8767b337e6ec42b307613ffa79c2)

14. illusztráció


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.