> ## 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.
# Paigaldamine ja tehniline seadistamine
> VisuoLabi asutuse taristu, juurutamine, turvalisus, varukoopiad ja keelte seadistamine.
See juhend aitab tehnilistel meeskondadel planeerida **VisuoLabi** asutuse paigaldust, lähtudes tehnilisest ülevaatest.
Ülevaade kirjeldab süsteemi üldisel tasemel. Ressursid ja seadistused tuleb iga asutuse jaoks üle kontrollida. Dokument ei sisalda käivitatavaid paigalduskäske ega sõltuvuste versioone.
## Arhitektuur ja teenused
Teenused töötavad eraldi Docker-konteinerites, mida koordineeritakse Docker Compose'iga.
| Komponent | Tehnoloogia |
| - | - |
| Taustarakendus | Laravel / PHP |
| Kasutajaliides | Nuxt.js / Vue.js ja Vuetify |
| Andmebaas | MySQL või MariaDB |
| Vahemälu ja järjekorrad | Redis |
| Asünkroonsed tööd | Horizon |
| Video- ja helitöötlus | FFmpeg |
| Veebiserver | NGINX |
| Ühine tekstiredigeerimine | Etherpad |
| Videokonverentsid | Jitsi Meet |
| Juurutamine | Docker ja Docker Compose |
Majutus võib toimuda asutuse või pilve taristus vastavalt kohalikele reeglitele.
## Taristu lähteprofiil
| Ressurss | Esialgne võrdlusalus |
| - | - |
| CPU | 4 vCPU-d |
| Mälu | 16 GB RAM |
| Salvestusruum | 250 GB SSD |
| Operatsioonisüsteem | Ubuntu Server 22.04 LTS või uuem |
| Ühendus | Stabiilne ühendus avaliku IP või asutuse pöördproksiga |
Ühe virtuaalmasina profiil on lähtepunkt testimiseks, pilootkasutuseks ja väikese kuni mõõduka koormuse jaoks. See ei taga kindlat kasutajate või samaaegsete videosessioonide arvu.
Hinda samaaegset kasutust, videote üleslaadimise sagedust ja suurust, töötlusvajadust, videokonverentse, säilitamist, arhiivi kasvu ja varukoopiaid. Suurema paigalduse puhul võib teenused eraldada ning kasutada välist või objektipõhist salvestust. Kontrolli selle tuge juurutatavas versioonis.
## Valmista juurutamine ette
### Samm 0 — Võta ühendust Levante Labiga
Kirjuta **Levante Labi tehnilisele meeskonnale** aadressil [contato@levantelab.com.br](mailto:contato@levantelab.com.br). Tutvusta asutust ja kohalikku tehnilist kontaktisikut, et alustada juurutamise kooskõlastamist.
Tutvusta mõlemat tehnilist meeskonda ja leppige kokku suhtluskanalid. Määrake ühiselt platvormi administraator, toe kontaktid ning vastutus majutuse, domeeni, sertifikaatide, andmebaasi, meedia, varukoopiate ja uuenduste eest.
Hangi lähtekoodihoidla, kinnitatud versioon, Docker-/Compose-failid ja vastavad juhised. Kontrolli PHP, Node.js-i, andmebaasi ja teiste sõltuvuste nõutud versioone.
Loo kokkulepitud ressursid ja püsivad andmeköited. Andmebaas ja üleslaaditud failid peavad säilima konteinerite uuesti loomisel. Planeeri salvestusruumi laiendamine.
Seadista asutuse aadress, vajadusel pöördproksi ja HTTPS. Kontrolli Etherpadi ning Jitsi Meeti võrgunõudeid.
Järgi kasutatava versiooni juhiseid. Seadista juurdepääsuandmed, keskkond, andmebaas, kasutajaliides, järjekorrad, meediatöötlus ja integratsioonid.
Valmista ette administraatori juurdepääs, õigused, lubatud keeled ja kasutajatugi.
Tee allolevad kontrollid ning dokumenteeri versioon, seadistused ja vastutajad.
Tehniline ülevaade ei esita Compose-teenuste nimesid, keskkonnamuutujaid ega migratsiooni-, ehitus-, käivitus- või uuenduskäske. Hangi ja kontrolli need paigaldatud versiooni lähtekoodihoidlast.
## Võrk ja väline juurdepääs
Ülevaade kirjeldab **HTTPS-i pordil 443** ning sisemist suhtlust Dockeri võrgus.
Kontrolli domeeni suunamist, sertifikaate ja nende uuendamist, NGINX-i või proksi seadistust, konteinerite ühendusi ja eraldatust, Etherpadi integratsiooni ning Jitsi Meeti paigalduse nõudeid.
Port 443 on veebijuurdepääsu võrdlusalus, mitte täielik tulemüüri- või videokonverentsiportide loend.
## Videote salvestus ja töötlus
Üleslaadimised ja töötlustulemused võivad salvestusvajadust märkimisväärselt suurendada. Jälgi vaba ruumi ja köidete kasvu, määra hoiatused, planeeri laiendused ja jälgi ebaõnnestunud töid. Varukoopiad peavad sisaldama andmebaasi ja taastamiseks vajalikke faile.
Kontrolli **Redis/Horizoni** ja **FFmpegi** tööd testvideo üleslaadimisega.
## Turvalisus ja töö järjepidevus
Kontrolli ülevaates kirjeldatud meetmete rakendamist:
| Meede | Asutuse kontroll |
| - | - |
| TLS 1.3 | HTTPS-i lõpp-punktis lubatud protokollid. |
| AES-256 salvestuskrüptimine | Kaitstud köited, salvestusteenused, varukoopiad ja võtmehaldus. |
| Rollipõhised õigused | Tavakasutaja, osaleja, juhendaja ja administraatori juurdepääs. |
| SSH-võtmed ja MFA | Haldusjuurdepääs ning kasutatav MFA-mehhanism. |
| Audit ja seire | Logid, hoiatused, vastutajad ja logidele ligipääs. |
| Uuendused ja turvakontrollid | Rakenduse, konteineritõmmiste ja serveri hooldus. |
| Regulaarsed krüptitud varukoopiad | Sagedus, eraldi asukoht ja taastamine. |
Need meetmed ei aktiveeru automaatselt ainult rakenduse paigaldamisega.
### Varukoopiad
Ülevaade kirjeldab krüptitud varukoopiaid eraldi andmekeskustes. Leppige kokku sagedus, säilitamine, vastutus ja taastamisprotseduur. Testi andmebaasi ning meedia ühist taastamist.
## Andmed ja säilitamine
Töödelda võidakse kontoandmeid, videoid, heli, annotatsioone, kommentaare, ühissisu, IP-aadresse, brauseriandmeid ja kasutusloge.
| Andmed | Ülevaate võrdlusalus |
| - | - |
| Kasutajaandmed | Võidakse kustutada või anonüümida 12 kuud pärast viimast tegevust. |
| Varukoopiad | Kirjutatakse üle 90 päeva pärast. |
| Teadusandmestikud | Võidakse arhiveerida anonüümitult teadustööks. |
Kinnita kohaldatavad tähtajad ja rakendusmehhanismid asutuses. Ülevaade ei tõenda automaatset kustutamist ega anonüümimist. Määrake kokkulepped, vastutus ja kohaldatavad andmekaitsenõuded.
## Keelte seadistamine
Keele seadistus hõlmab halduspaneeli ja kasutajaliidest. Vaikekeele määramine nõuab lisaks tehnilist muudatust andmebaasis.
Loo kausta **lang** JSON-fail, näiteks **en.json**, **pt.json** või **de.json**, vajalike tõlkevõtmete ja väärtustega.
Lisa faili **nuxt.config.js** jaotises **i18n locales** keelekood, nimi ja failiviide.
Kasuta **master**-õigustega teed **Platform → Platform Form → Languages**. Ülevaate järgi ei nõua see otsest andmebaasikirjet.
Pärast tõlgete ja kasutajaliidese ettevalmistamist määrab arendaja valitud keele kirjes **is\_default** väärtuseks **true**. Kontrolli vaikekeele seadistuse kooskõla.
Kontrolli menüüsid, sõnumeid, teavitusi ja mitmekeelseid vorme. Järgi lähtekoodihoidla ehitus- ja avaldamisprotseduuri.
Tõlgitakse silte, navigeerimist, teavitusi ja süsteemi tagasisidet. Ühilduvad vormid saavad uue keele väljad. Videoid, annotatsioone ja muid kirjeid **ei tõlgita automaatselt**.
VisuoLabi vaikekeele jaoks nimetatud väli on **is\_default**. Kontrolli tabeli nime ja muutmisprotseduuri kasutatava versiooni lähtekoodihoidlast.
## Kontrollnimekiri
* Ava asutuse domeen HTTPS-iga.
* Testi sisselogimist ja rollide õigusi.
* Vaata ja avalda testmaterjal.
* Laadi üles, töötle ja esita testvideo.
* Kontrolli töid ja asünkroonseid töötajaid.
* Testi õpperuume ja tegevusi.
* Testi lubatud Etherpadi ja Jitsi Meeti integratsioone.
* Kontrolli keeli ja vaikekeelt.
* Kontrolli andmete püsimist ja kettaruumi.
* Kontrolli varundamist ja taastamist.
* Dokumenteeri versioon, vastutus ja hooldusprotseduurid.
## Käivitatavate juhiste eeldused
Korratavate käskude lisamiseks on vaja Compose-faile, sõltuvuste versioone, keskkonnaseadistuse malli, andmebaasiprotseduure, kasutajaliidese ehitust, töötajaid, ajastatud ülesandeid, integratsioone ja versiooni uuendamise protseduuri.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.