Tehniline analüüs ja arendusettepanek · eestiedu.ee LMS
Tööversioon · 15.09.2026
Eesmärk on võimaldada Haridus- ja Teadusministeeriumile kuuluvate eesti keele e-kursuste Keeleklikk, Keeletee ja Keelelend kasutamist kaasaegsetes õpikeskkondades ilma kursuste sisu kopeerimise, metoodika muutmise või olemasoleva keskkonna asendamiseta.
Integratsioonikiht peab võimaldama kasutada kursuste olemasolevaid õppetegevusi välises LMS-is, siduda need õppija õpiteega ning vahetada standardiseeritud kujul infot õppetegevuste läbimise kohta. Kursused jäävad iseseisvateks riiklikeks õppematerjalideks ning säilitavad oma senise struktuuri ja progressiloogika.
15.09.2026 tehtud brauseripõhine tehniline kontroll näitas, et olemasolevas süsteemis on juba mitu integratsiooniks vajalikku elementi:
Kontroll ei tõenda avaliku API olemasolu. Progressi koondandmed edastatakse praegu valdavalt serveri genereeritud HTML-is ning /lesson/passed/ on olemasoleva veebirakenduse sisemine liides. Seetõttu ei ole soovitatav ehitada välist integratsiooni dokumenteerimata sisemiste otspunktide peale.
| Võimekus | Minimaalne nõue | Miks vajalik |
| Kursuse struktuur | Masinloetav course → level → chapter → lesson → activity | Väline LMS saab õppematerjale korrektselt adresseerida. |
| Püsiv activity ID | Igal õppetegevusel stabiilne ID ja deep link | Õppija saab suunata otse õigesse tegevusse. |
| Progress | Autenditud read-only ligipääs activity staatusele ja võimalusel tulemusele | Väline LMS saab arvestada riiklikus kursuses tehtud tööd. |
| Identiteedi sidumine | Turvaline kasutaja sidumine, eelistatult OAuth2/OIDC/SSO | Sama õppija progress on mõlemas keskkonnas seostatav ilma paroolide jagamiseta. |
| Sündmused | Soovitavalt activity_completed/test_completed webhook või event | Progress saab liikuda süsteemide vahel ilma perioodilise päringuta. |
| Dokumentatsioon | Versioonitud API kirjeldus, sandbox/testkonto ja kasutustingimused | Integratsioon on hooldatav ja turvaline. |
Ministeeriumilt ei eeldata uue AI-süsteemi ega uue LMS-i ehitamist. Vajalik on olemasolevate riiklike õpperessursside tehniline integreeritavus.
| HTM / süsteemi omanik | eestiedu.ee / integratsiooni arendaja |
| Annab ametliku loa ja tehnilise ligipääsu. | Ehitatakse adapter/integratsioonikiht. |
| Annab olemasoleva andmemudeli ja liideste dokumentatsiooni või ligipääsu staging-keskkonnale. | Normaliseeritakse kursuste struktuur LMS-i ühtsesse mudelisse. |
| Määrab lubatud andmevahetuse, autentimise ja isikuandmete kasutamise reeglid. | Rakendatakse turvaline kasutaja sidumine ja nõusolekud. |
| Tagab püsivad identifikaatorid ning kokkulepitud liidese. | Kuvatakse õppijale, õpetajale ja organisatsioonile kokkulepitud õppeprogress. |
A. HTM tellib integratsioonikihi. Olemasoleva süsteemi arendaja avab ja dokumenteerib vajalikud liidesed; eestiedu.ee kasutab ametlikku API-t.
B. Integratsioonikiht arendatakse eestiedu.ee projekti raames. HTM annab arendajale vajalikud õigused, tehnilise dokumentatsiooni, staging-/testkeskkonna ja ligipääsu olemasolevale andmemudelile. Integratsioon ehitatakse kokkulepitud piirides ning tulemus dokumenteeritakse.
Mõlema mudeli puhul jäävad kursuste sisu, kasutajate senine progress ja olemasolev keskkond HTM-i kontrolli alla. Integratsioon ei eelda reaalse õppijate andmebaasi üleandmist arendajale; arenduseks piisavad testandmed ja testkontod.
Tegemist on tehnilise suurusjärgu, mitte fikseeritud hinnapakkumisega.
| Tööplokk | Hinnang | Spetsialist |
| Olemasoleva backendi ja andmemudeli audit | 12–24 h | backend / süsteemiarhitekt |
| Kursuse struktuuri read-only API | 12–24 h | backend |
| Progressi/completion API | 12–24 h | backend |
| Autentimine ja kasutaja sidumine | 16–40 h | backend / security |
| Webhook/event layer | 8–16 h | backend |
| Dokumentatsioon, testid, sandbox | 12–24 h | backend / QA |
| eestiedu.ee adapter ja andmemudeli mapping | 24–40 h | full-stack |
| End-to-end testimine | 12–24 h | QA / full-stack |
Esialgne kogumaht: ligikaudu 108–216 tundi. Kui olemasolev arendaja saab sisemised liidesed väikese muudatusega ametlikult avada, võib maht olla väiksem. Kui autentimine või andmemudel vajab ümbertegemist, tuleb hinnangut täpsustada pärast ligipääsu lähtekoodile ja tehnilisele dokumentatsioonile.
Sama integratsioonipõhimõte võimaldab hiljem ühendada uusi riiklikke kursusi ja keeletehnoloogiaid ilma olemasolevaid kursusi ümber ehitamata. Näiteks saab samasse LMS-i lisada kõnetuvastuse, kõnesünteesi, hääldustehnoloogia, sõnastiku- ja keeleandmed või tulevased C1-taseme õppematerjalid, kui vastavad teenused on kättesaadavad standardiseeritud liideste kaudu.
Koolis või organisatsioonis võib sama tehniline kiht võimaldada õppijal kasutada riiklikke õppematerjale ühes õpikeskkonnas ning õpetajal näha talle lubatud ulatuses õppija tegevust ja progressi. See ei muuda riiklike kursuste metoodikat, vaid suurendab nende taaskasutatavust.
Piloodi jaoks ei ole vaja muuta Keelekliki, Keeletee ega Keelelennu sisu. Soovitatav on valida piiratud hulk õppetegevusi ja üks testkasutajate rühm ning valideerida neli elementi: (1) tegevuse masinloetav identifikaator ja deep link; (2) turvaline kasutaja sidumine; (3) completion/progress andmevahetus; (4) tulemuse kuvamine välises LMS-is.
Piloodi õnnestumisel muutuvad olemasolevad riiklikud e-kursused tehniliselt taaskasutatavateks õpperessurssideks, mida saab ühendada erinevate kaasaegsete LMS-ide, koolide ja tulevaste digiteenustega ilma kursuste sisu dubleerimata.
Tehniline tööversioon · eestiedu.ee / Multikey