Curatoria traseelor de învățare

🎬 Un tutorial video pentru această pagină este în curs de înregistrare și va fi încorporat aici. Pagina tutoriale video listează ce este deja disponibil.

Ce este un traseu de învățare?

Un traseu de învățare este o secvență organizată de lecții, fiecare combinând o scurtă parte de teorie cu un set de provocări de programare, care ghidează cursantul de la un concept la altul. Folosește-l pentru a preda un subiect de la cap la coadă — alege provocările care consolidează cel mai bine fiecare concept, decide care dintre ele sunt obligatorii pentru a finaliza traseul și lasă-le pe celelalte ca bonus.

Traseele pe care le construiești sunt salvate ca ciorne în timp ce lucrezi la ele și pot fi publicate atunci când ești gata să le partajezi. Un traseu publicat cu vizibilitate în comunitate apare pe pagina Explorează trasee de învățare (Explore Learning Paths), de unde alți utilizatori îl pot copia în propriul lor cont.

Crearea unui traseu de învățare

1. Începe o ciornă nouă

   Mergi la Traseele mele de învățare (My Learning Paths) și dă clic pe butonul NEW DRAFT din partea de sus a listei. Se va deschide o fereastră modală.

2. Completează informațiile de bază

   Fereastra modală îți va cere:

   • Titlu (obligatoriu) — un nume scurt și descriptiv pentru traseu. Minimum 3 caractere, maximum 120.
   • Descriere (opțională) — câteva fraze care explică ce va învăța cursantul. Până la 500 de caractere.

   Traseele noi sunt create ca ciorne Private. Poți schimba vizibilitatea mai târziu din pagina de editare.

3. Dă clic pe Create draft

   Vei fi redirecționat direct la pagina de editare, de unde poți detalia traseul.

Pagina de editare pe scurt

┌─────────────────────────────────────────────┐
│  [Banner: „Conturează-ți călătoria”]         │
├─────────────────────────────────────────────┤
│         [Șterge]  [Salvează]  [Publică]     │  ← bara de instrumente de sus
├─────────────────────────────────────────────┤
│  Conținut | Setări | ...                    │  ← tab-uri
├─────────────────────────────────────────────┤
│  ┌ Detalii traseu (titlu/vizibilitate/desc)┐ │
│  │                                        │ │
│  └────────────────────────────────────────┘ │
│                                             │
│  ┌ Cardul Lecției 1 ──────────────────────┐ │
│  │                                        │ │
│  └────────────────────────────────────────┘ │
│  ┌ Cardul Lecției 2 ──────────────────────┐ │
│  │                                        │ │
│  └────────────────────────────────────────┘ │
│             + Adaugă lecție                 │
└─────────────────────────────────────────────┘

Tab-uri: Conținut (Content) este singurul tab activ. Setările, Temele (Assignments), Mementourile și Traducerile sunt doar substituenți pentru funcționalități viitoare.

Detalii traseu

În partea de sus a tab-ului Conținut vei găsi formularul la nivel de traseu:

• Titlu — redenumește traseul în orice moment cât timp este încă în stadiul de ciornă.
• Vizibilitate — Privat păstrează traseul doar pentru tine; Comunitate îl face să apară pe pagina Explorează odată ce este publicat. Poți schimba vizibilitatea înainte sau după publicare — fie din acest formular, fie direct din Traseele mele de învățare, folosind opțiunile Make Public / Make Private din meniul contextual al traseului.
• Descriere — explicația mai lungă afișată pe cardurile din listă și pe pagina de detalii a traseului. Markdown nu este randat aici — tratează-l ca text simplu.

Toate cele trei câmpuri sunt stocate local temporar. Nimic nu este salvat până când nu apeși pe Save în bara de instrumente de sus (sau Ctrl+S / ⌘+S).

Când traseul este Publicat, aceste câmpuri sunt dezactivate. Trece mai întâi traseul în stadiul de ciornă dacă trebuie să le editezi.

Lecții

Sub formularul de detalii se află lista de lecții.

Adăugarea unei lecții

Dă clic pe + Add lesson (în partea de jos a listei, sau în starea goală când traseul nu are încă nicio lecție). O nouă lecție apare imediat cu valori implicite — o poți extinde apoi pentru a o edita.

Lecțiile sunt create pe server imediat ce dai clic pe buton, astfel încât se păstrează chiar dacă închizi tab-ul înainte de a salva editările câmpurilor.

Anatomia cardului de lecție

Fiecare lecție este un card pliabil cu un antet care arată:

• Indicatorul de poziție și controalele de reordonare în stânga — un câmp numeric (poziție indexată de la 1) plus săgeți sus/jos.
• Titlu și o linie de metadate: N provocări · dificultate · XP · minute.
• Eticheta Unsaved (portocalie) atunci când cardul are editări nesalvate.
• Butoanele Edit (creion) și Delete (coș de gunoi) în dreapta.

Dă clic pe creion pentru a extinde cardul și a edita lecția. Dă clic din nou (acum o pictogramă de restrângere) pentru a închide cardul la loc.

Câmpurile lecției

În interiorul unui card extins vei găsi:

Secțiune	Câmpuri
Informații lecție	Titlu, Descriere scurtă
Teorie	O zonă de text cu suport Markdown afișată cursantului înainte de a încerca provocările
Întrebări pentru cursant	O listă de întrebări scurte. Adaugă / elimină liber intrări individuale
Recompensă și dificultate	Dificultate (Începător / Intermediar / Expert), XP lecție, Minute estimate
Provocări	Exercițiile de programare care susțin lecția (vezi secțiunea următoare)

Dificultatea și XP-ul lecției

Setarea Dificultății completează automat o valoare implicită pentru XP-ul lecției:

Dificultate	XP implicit lecție
Începător	50
Intermediar	100
Expert	150

Poți suprascrie XP-ul ulterior dacă dorești să recompensezi o anumită lecție mai mult sau mai puțin. XP-ul este acordat cursantului atunci când finalizează lecția (adică o termină prin chat-ul cu mentorul AI).

Provocări

Dă clic pe Add challenges pentru a deschide selectorul de provocări. Este aceeași fereastră modală de selectare multiplă folosită în alte părți ale platformei — caută după titlu, bifează sau debifează intrările și dă clic pe Add N challenges pentru a confirma. Selecțiile sunt adăugate la lecție și marcate ca modificate; ele se vor păstra la următoarea salvare.

Fiecare rând de provocare arată:

• Titlul provocării și o etichetă de dificultate (Începător / Intermediar / Expert).

• O casetă de selectare Required — vezi Provocări obligatorii vs. opționale.

• Eticheta XP — XP-ul pe care îl obține cursantul când rezolvă provocarea, derivat automat din nivelul său de dificultate (aceasta este doar pentru citire; XP-ul provocării aparține provocării în sine, nu traseului):

  Dificultate provocare	XP provocare
  Începător	50
  Intermediar	200
  Expert	500
  În așteptare / fără dificultate încă	20

• Săgeți sus/jos pentru a reordona în cadrul lecției.

• Un ❌ pentru a elimina provocarea din această lecție (nu șterge provocarea în sine).

Provocări obligatorii vs. opționale

O provocare obligatorie (Required) condiționează finalizarea traseului — cursantul trebuie să rezolve fiecare provocare obligatorie (și să termine fiecare lecție) pentru ca traseul să fie marcat ca finalizat. Provocările opționale sunt un bonus — cursantul le poate rezolva pentru XP, dar ignorarea lor nu blochează finalizarea.

În mod implicit, fiecare provocare pe care o adaugi este obligatorie. Debifează caseta de selectare Required pentru a o face opțională.

Reordonarea lecțiilor

Trei moduri:

1. Săgețile sus/jos de lângă indicatorul de poziție — mută cu câte o poziție pe rând.
2. Introdu o nouă poziție direct în câmpul numeric și apasă Enter / Tab — sari direct la acea poziție.
3. (Doar pentru provocări) Săgețile sus/jos de pe fiecare rând de provocare — mută o singură provocare în cadrul lecției sale.

Modificările de reordonare se aplică imediat — nu este necesară salvarea.

Ștergerea unei lecții

Dă clic pe 🗑 de pe cardul lecției. Se va deschide o fereastră modală de confirmare. La confirmare, lecția este ștearsă definitiv, iar pozițiile lecțiilor rămase sunt compactate (fără goluri).

Indicatorul „Unsaved” (Nesalvat)

De îndată ce editezi orice câmp dintr-un card de lecție extins, o etichetă portocalie Unsaved apare lângă titlul lecției în antet. Butonul Save din bara de sus devine de asemenea activ. Dă clic pe Reset în interiorul cardului pentru a renunța la modificările nesalvate ale acelui card fără a le salva.

Salvarea

Butonul Save din bara de instrumente de sus aplică:

1. Toate modificările pregătite la nivel de traseu (titlu, descriere, vizibilitate).
2. Fiecare card de lecție care are modificări în așteptare.

Butonul este dezactivat atunci când nu există nimic de salvat. Reguli de siguranță:

• Acțiunile CRUD pentru lecții (adăugare, ștergere, reordonare) se aplică imediat — nu sunt stocate temporar (staged).
• Editările la nivel de câmp sunt stocate temporar până la Salvare.
• Ctrl+S / ⌘+S declanșează Salvarea de oriunde de pe pagină.
• Dacă salvarea unei lecții eșuează, o notificare de tip toast afișează eroarea, iar acea lecție rămâne nesalvată (dirty) pentru a putea reîncerca. Celelalte lecții care s-au salvat cu succes își păstrează starea salvată.

Publicarea

1. Fă clic pe Publish în bara de instrumente de sus. Se va deschide o fereastră modală de confirmare.
2. Dacă ai modificări nesalvate, ți se va solicita să le salvezi mai întâi.
3. La confirmare, starea traseului de învățare se schimbă în Published.

Reguli de publicare:

• Un traseu de învățare Private + Published este marcat ca finalizat de partea ta, dar nu apare nicăieri public.
• Un traseu de învățare Community + Published apare pe pagina Explore Learning Paths. Alți utilizatori îl pot copia în propriul lor cont (vezi mai jos).
• Odată ce este Published, toate câmpurile (detaliile traseului de învățare și cardurile lecțiilor) devin doar pentru citire (read-only). Pentru a le edita din nou, fă clic mai întâi pe Mark as draft.

Cerință de rang

Oricine poate crea un traseu de învățare și îl poate publica ca fiind Private. Schimbarea vizibilității la Community (astfel încât traseul de învățare să apară pe pagina Explore) necesită rangul Persistence DOJO (3001+ XP) — utilizatorii sub acest rang nu văd opțiunea Make Public. Vezi Privilegiile utilizatorilor pentru tabelul complet.

Anularea publicării

Fă clic pe Mark as draft în bara de instrumente de sus. Se va deschide o fereastră modală de confirmare. La confirmare:

• Traseul de învățare dispare de pe pagina Explore (dacă era de tip community).
• Toate câmpurile devin din nou editabile.
• Copiile existente pe care le-au făcut alți utilizatori rămân ale lor — acestea nu sunt afectate.

Ștergerea

Butonul Delete este vizibil cât timp traseul de învățare este schiță (draft) (iar pentru super-administratori, întotdeauna). Ștergerea este permanentă: traseul de învățare și toate lecțiile sale sunt eliminate. Utilizatorii care au copiat deja o versiune publică (community) a traseului își păstrează copiile — ștergerea afectează doar originalul tău.

Fluxul de copiere

Când un traseu de învățare este Community + Published, acesta apare pe /explore-learning-paths. Orice utilizator poate face clic pe Copy de pe card pentru a adăuga o copie nouă a traseului de învățare în propria secțiune My Learning Paths. Câteva detalii:

• Copia este Private și este readusă la starea de Draft — cel care a copiat-o poate apoi să parcurgă traseul sau să îl personalizeze în continuare.
• Copia păstrează aceleași lecții, teorie, întrebări și provocări.
• Autorul originalului este menționat pe copie prin intermediul linkului copiedFrom.
• Se aplică creditul pre-completat: dacă persoana care a copiat a rezolvat deja o provocare în altă parte, acea provocare este marcată ca fiind finalizată în copie cu 0 path XP — fără numărare dublă.

Editarea ca super-administrator

Super-administratorii pot vizualiza și edita traseul de învățare al oricărui utilizator, indiferent de proprietar:

• My Learning Paths listează fiecare traseu de învățare din sistem atunci când este vizualizat ca super-administrator.
• Opțiunea Edit din meniul contextual deschide aceeași pagină de editare folosită de proprietari.
• Acțiunile Save, Publish, Mark as draft și Delete funcționează exact la fel.

Această funcționalitate este destinată moderării și curatorierii de conținut — folosește-o cu moderație și comunică modificările autorului original.

Scurtături de tastatură

Tastă	Acțiune
Ctrl+S / ⌘+S	Salvează toate modificările în așteptare

Vezi lista completă pe pagina Keyboard Shortcuts.

Bune practici

• Menține lecțiile concentrate. Un singur concept pe lecție, cu două sau trei provocări care să îl fixeze.
• Folosește Required cu moderație. Marchează doar provocările care sunt esențiale pentru „finalizarea” lecției; lasă-le pe cele orientate spre explorare ca Optional, astfel încât să nu blochezi finalizarea din cauza unor subiecte secundare.
• Ajustează XP-ul lecțiilor în mod deliberat. Valorile implicite (50/100/150) sunt doar un punct de plecare — mărește-le pentru lecțiile care necesită un angajament profund, redu-le pentru recapitulări rapide.
• Scrie teorie cu adevărat utilă. Formatarea Markdown, blocurile de cod și exemplele concrete sunt toate redate — folosește-le.
• Combină dificultățile provocărilor. Un traseu de învățare format exclusiv din provocări Expert este descurajant; un traseu format doar din provocări Beginner este ușor de uitat. Încearcă să obții o progresie care să se potrivească cu evoluția conceptului.
• Publică doar când este gata, nu înainte. Modul draft este pentru tine. Odată publicat cu vizibilitate community, alți utilizatori îl pot copia; modificările substanțiale aduse după acel moment vor exista doar în originalul tău și nu se vor propaga în copiile lor.

Depanare

Butonul „Save” nu se activează niciodată. Nu sunt detectate modificări în așteptare. Acțiunile de reordonare / adăugare / ștergere sunt salvate automat, deci nu activează niciodată butonul Save. Editările de câmpuri din interiorul cardurilor de lecție îl activează.

Am adăugat o provocare, dar detaliile traseului de învățare arată 0 provocări. Numărul de pe cardul lecției se actualizează imediat din editările tale locale. Numărul de pe pagina de detalii a traseului de învățare (în afara editorului) reflectă doar starea salvată — fă clic pe Save pentru a persista modificările.

Nu pot edita câmpurile pe un traseu de învățare publicat. Acesta este comportamentul prevăzut. Fă clic pe Mark as draft în bara de instrumente de sus pentru a reactiva editarea.

Reordonarea eșuează cu o eroare. Starea traseului de învățare s-a desincronizat — pagina se reîncarcă automat pentru recuperare. Încearcă din nou reordonarea.

Am șters o provocare dintr-o lecție, dar istoricul de progres al cursantului o menționează în continuare. Ștergerea afectează doar provocările atașate lecției. Orice înregistrări de tip CompletedChallenge pe care cursantul le avea deja rămân — așa cum este și normal, deoarece cursantul chiar a rezolvat acea provocare în afara acestei lecții specifice.