CEL - interaktívny kurz Common Expression Language

Kontext

CEL vznikol ako samostatný vzdelávací projekt zameraný na Common Expression Language. Cieľom bolo pripraviť prostredie, ktoré nevysvetľuje jazyk iba ako syntax, ale ako praktický spôsob zapisovania pravidiel, podmienok a rozhodovacej logiky.

Projekt je koncipovaný ako produktovo nezávislý kurz. Má pomôcť používateľovi pochopiť princípy jazyka ešte pred tým, ako ich začne spájať s konkrétnou platformou, aplikáciou alebo interným riešením.

Kurz je verejne dostupný na adrese https://cel-course.jl-home.org/.

Problém

Common Expression Language môže byť pre nového používateľa neprehľadný, ak sa učí iba z dokumentácie alebo izolovaných úryvkov. Pri reálnom použití nestačí poznať operátory a typy; dôležité je vedieť preložiť slovnú požiadavku do presného výrazu a overiť, či sa správa správne pri rôznych vstupoch.

Ďalším problémom je hranica medzi tým, čo patrí do samotného jazyka, čo dodáva hostiteľská aplikácia a čo je iba podporné správanie vzdelávacieho prostredia. Bez jasného rozlíšenia by sa kurz mohol tváriť ako plná implementácia jazyka, hoci jeho účel je tréning a vysvetlenie.

Úloha

Mojou úlohou bolo navrhnúť celý vzdelávací koncept, štruktúru obsahu, dvojjazyčný model stránok, interaktívne časti a pravidlá, podľa ktorých sa kurz správa. Súčasťou práce bolo aj rozhodnúť, ktoré časti majú byť vysvetlené textom, ktoré majú byť overiteľné priamo v prehliadači a kde treba otvorene pomenovať limity.

Projekt som riešil ako kombináciu obsahovej architektúry, technického návrhu a praktickej implementácie webovej aplikácie. Dôležitá bola aj konzistencia medzi slovenskou a anglickou verziou, stabilné adresy, kontrola kvality obsahu a použiteľnosť na rôznych zariadeniach.

Obmedzenia

Vzdelávacie prostredie zámerne neprezentuje plnú implementáciu Common Expression Language. Prehliadačový evaluator podporuje iba rozsah potrebný pre kurz a nepodporované správanie má zlyhať viditeľne, nie byť potichu aproximované.

Projekt nepracuje s používateľskými účtami, databázou ani serverovou synchronizáciou. Stav učenia zostáva lokálne v prehliadači. Kurz zároveň neprezentuje žiadne produktovo špecifické tvrdenia ako overený výsledok v externej platforme.

Návrh riešenia

Riešenie je postavené ako bilingválny web s jasne oddeleným obsahom, navigáciou, progresom a interaktívnymi pracovnými plochami. Každá časť má používateľovi vysvetliť, čo sa učí, prečo je to dôležité a ako si môže správanie overiť bez toho, aby musel opustiť stránku.

Kurz kombinuje výklad, editovateľné vstupy, okamžitý výsledok a spätnú väzbu. Tým sa znižuje rozdiel medzi čítaním dokumentácie a reálnym premýšľaním nad pravidlom. Používateľ sa nespolieha iba na text, ale postupne si buduje schopnosť overiť vlastné rozhodnutie.

Technický postup

Aplikácia je postavená na Next.js App Router, Reacte a striktne typovanom TypeScripte. Obsah je uložený vo verziovaných Markdown súboroch a jeho štruktúru kontrolujú validačné schémy. Vyhľadávanie pracuje s lokálne generovaným indexom a jazykové verzie používajú rovnakú logiku smerovania.

Súčasťou riešenia je kontrolovaný renderer obsahu, klientsky stav progresu, pilotný evaluator pre potreby kurzu a automatizované kontroly. Testy pokrývajú obsah, lokalizáciu, interaktívne časti, responzívne rozloženia, prístupnosť a produkčný build.

Výsledok

Výsledkom je samostatný kurz, ktorý predstavuje Common Expression Language ako praktický nástroj na vyjadrovanie pravidiel a rozhodovacej logiky. Projekt ukazuje, že technické vzdelávanie môže byť postavené vecne, interaktívne a transparentne voči vlastným limitom.

CEL zároveň rozširuje portfólio projektov mimo ProjectWise oblasti. Ukazuje schopnosť navrhnúť kompletný webový produkt od obsahového modelu cez používateľské rozhranie až po technickú validáciu a automatizované overovanie kvality.