Curatorierea traseelor de învățare

Ce este un traseu de învățare?

Un traseu de învățare este o secvență selectată de lecții, fiecare asociind 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 creezi sunt salvate ca schițe în timp ce lucrezi la ele și pot fi publicate când ești gata să le partajezi. Un traseu publicat cu vizibilitate pentru comunitate apare pe pagina Explorează trasee de învățare, de unde ceilalți utilizatori îl pot copia în propriul cont.

Crearea unui traseu de învățare

1. Începe o schiță nouă

   Mergi la Traseele mele de învățare și dă clic pe butonul SCHIȚĂ NOUĂ din partea de sus a listei. Se va deschide o fereastră modală.

2. Completează datele 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 propoziții care explică ce va învăța cursantul. Până la 500 de caractere.

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

3. Dă clic pe Creare schiță

   Vei fi redirecționat direct către pagina de editare, unde poți dezvolta traseul.

Pagina de editare pe scurt

┌─────────────────────────────────────────────┐
│  [Banner: "Conturează-ți traseul"]          │
├─────────────────────────────────────────────┤
│              [Șterge] [Salvează] [Publică]  │  ← bara de instrumente de sus
├─────────────────────────────────────────────┤
│  Conținut | Setări | ...                     │  ← file
├─────────────────────────────────────────────┤
│  ┌ Detalii traseu (titlu/vizibilitate/desc)┐ │
│  │                                        │ │
│  └────────────────────────────────────────┘ │
│                                             │
│  ┌ Card Lecția 1 ─────────────────────────┐ │
│  │                                        │ │
│  └────────────────────────────────────────┘ │
│  ┌ Card Lecția 2 ─────────────────────────┐ │
│  │                                        │ │
│  └────────────────────────────────────────┘ │
│             + Adaugă lecție                 │
└─────────────────────────────────────────────┘

File: Conținut este singura filă activă. Setări, Teme, Mementouri și Traduceri sunt doar substituenți pentru funcționalități viitoare.

Detalii traseu

În partea de sus a filei 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 schiță.
• 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 Fă public / Fă privat din meniul contextual al unui traseu.
• Descriere — explicația mai lungă afișată pe cardurile din listă și pe pagina de detalii a traseului. Markdown-ul nu este redat aici — tratează textul ca text simplu.

Toate cele trei câmpuri sunt pregătite local. Nimic nu este salvat până când nu apeși pe Salvează î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 schiță 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 + Adaugă lecție (în partea de jos a listei sau în starea goală când traseul nu are încă lecții). 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, așa că acestea vor fi păstrate chiar dacă închizi fila înainte de a salva modificările aduse câmpurilor.

Anatomia cardului de lecție

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

• Indicator de poziție și controale de reordonare în stânga — un câmp numeric (poziție bazată pe 1) plus săgeți sus/jos.
• Titlu și o linie meta: N provocări · dificultate · XP · minute.
• Eticheta Nesalvat (galben/portocaliu) când cardul are modificări neînregistrate.
• Butoanele Editează (creion) și Șterge î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 înapoi.

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 pentru Markdown, afișată cursantului înainte de a încerca provocările
Întrebări pentru cursant	O listă de întrebări scurte. Adaugă / șterge 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)

Dificultate și XP lecție

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ă oferi o recompensă mai mare sau mai mică pentru o anumită lecție. XP-ul este acordat cursantului atunci când finalizează lecția (adică o termină prin chatul cu mentorul AI).

Provocări

Dă clic pe Adaugă provocări pentru a deschide selectorul de provocări. Este aceeași fereastră modală de selecție multiplă utilizată în alte părți ale platformei — caută după titlu, bifează sau debifează intrările și dă clic pe Adaugă N provocări pentru a confirma. Selecțiile sunt adăugate la lecție și marcate ca nesalvate; acestea vor fi păstrate 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 Obligatoriu — vezi Obligatoriu vs Opțional.

• Eticheta XP — XP-ul pe care îl câștigă cursantul când rezolvă provocarea, derivat automat din nivelul său de dificultate (acesta este doar în 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 setată	20

• Săgeți sus/jos pentru reordonare î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 blochează 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 omiterea lor nu blochează finalizarea.

În mod implicit, fiecare provocare pe care o adaugi este Obligatorie. Debifează caseta Obligatoriu pentru a o face Opțională.

Reordonarea lecțiilor

Trei moduri:

1. Săgeți 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ți sus/jos 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ă o Salvare.

Ștergerea unei lecții

Dă clic pe 🗑 de pe cardul de lecție. 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 „Nesalvat”

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

Salvarea

Butonul Salvează din bara de instrumente de sus înregistrează:

1. Toate modificările pregătite la nivel de traseu (titlu, descriere, vizibilitate).
2. Fiecare card de lecție cu modificări neînregistrate.

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.
• Modificările la nivel de câmp sunt stocate temporar până la salvare.
• Ctrl+S / ⌘+S declanșează Salvarea oriunde 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ă 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 deschide o fereastră modală de confirmare.
2. Dacă ai modificări nesalvate, ți se cere să le salvezi mai întâi.
3. După confirmare, starea traseului de învățare devine Published.

Reguli de publicare:

• Un traseu de învățare Private + Published este marcat ca finalizat din perspectiva ta, dar nu apare nicăieri în mod public.
• Un traseu de învățare Community + Published apare pe pagina Explore Learning Paths. Alți utilizatori îl pot copia în propriul 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 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 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 Privilegii utilizator pentru tabelul complet.

Anularea publicării

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

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

Ștergerea

Butonul Delete este vizibil cât timp traseul de învățare este 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 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 la adresa /explore-learning-paths. Orice utilizator poate face clic pe Copy pe cardul respectiv pentru a adăuga o copie nouă a traseului în secțiunea sa My Learning Paths. Câteva detalii:

• Copia este Private și este trecută înapoi în starea Draft — cel care o copiază 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 pentru provocările finalizate anterior: dacă cel care copiază a rezolvat deja o provocare în altă parte, acea provocare este marcată ca finalizată în copie cu 0 path XP — fără dublă contorizare.

Editarea de către super-administratori

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 de un super-administrator.
• Opțiunea Edit din meniul contextual deschide aceeași pagină de editare folosită de proprietari.
• Opțiunile Save, Publish, Mark as draft și Delete funcționează la fel.

Acest lucru este prevăzut pentru moderare și curățare 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 Scurtături de tastatură.

Recomandări practice

• Menține lecțiile concentrate. Un singur concept pe lecție, cu două sau trei provocări care să îl consolideze.
• Folosește Required cu moderație. Marchează doar provocările care sunt esențiale pentru „finalizarea” lecției; lasă-le ca Optional pe cele orientate spre explorare, pentru a nu bloca finalizarea din cauza unor subiecte secundare.
• Ajustează XP-ul lecției în mod deliberat. Valorile implicite (50/100/150) sunt doar un punct de plecare — mărește-le pentru lecțiile care necesită efort profund, micșorează-le pentru recapitulări rapide.
• Scrie teorie care își merită locul. Formatarea Markdown, blocurile de cod și exemplele concrete se randează toate — folosește-le.
• Combină dificultățile provocărilor. Un traseu format în întregime din provocări de nivel Expert este descurajant; un traseu format doar din provocări pentru Începători este ușor de uitat. Urmărește o dificultate progresivă 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 de după acel moment rămân î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, așa că nu vor activa niciodată butonul Save. Editările de câmpuri din interiorul cardurilor de lecții o fac.

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

Nu pot edita câmpurile unui traseu de învățare publicat. Așa a fost proiectat sistemul. Fă clic pe Mark as draft în bara de instrumente de sus pentru a reactiva editarea.

Reordonarea eșuează cu o eroare. Starea traseului 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 le avea deja cursantul rămân — așa cum este și normal, deoarece cursantul a rezolvat într-adevăr acea provocare în afara acestei lecții specifice."