Gestionarea temelor

Creează, publică și urmărește o temă

Bun venit la Ghidul de gestionare a temelor pentru Utilizatorii Business ai DojoCode. Temele reprezintă elementul fundamental de predare pe platformă: îți permit să distribui un traseu de învățare sau o singură provocare unui student, unui grup întreg sau oricărei combinații, iar apoi să urmărești progresul în timp real pe măsură ce clasa ta parcurge materialul.

Acest ghid te va ghida prin întregul ciclu de viață — crearea unei ciorne, selectarea destinatarilor, publicarea, monitorizarea, prelungirea termenelor limită, arhivarea și analiza datelor.

Introducere

INFO

Crearea temelor este inclusă în toate planurile business. Nu există cerințe de nivel sau puncte — odată ce te-ai abonat și ți-ai verificat adresa de e-mail, poți trimite teme imediat.

Mergi la pagina Assignments (Teme) din bara laterală a panoului de control business. Vei vedea o listă cu temele tale existente (ciorne, publicate și arhivate la un loc), plus un buton NEW DRAFT pentru a începe una nouă.

Crearea unei teme

Fă clic pe NEW DRAFT pentru a deschide asistentul în patru pași.

Pasul 1 — Detalii

Introdu titlul și instrucțiunile opționale pentru temă. Instrucțiunile sunt redate în format markdown pentru studenții tăi, așa că poți folosi liber titluri, liste și blocuri de cod. Păstrează titlul scurt (3–120 de caractere) și descriptiv — studenții îl vor vedea peste tot.

Pasul 2 — Sursă

Alege ce dorești să atribui:

• Traseu de învățare — un parcurs cu mai multe lecții. Studenții finalizează lecțiile și provocările obligatorii în ordine. Ideal pentru programe de studiu structurate sau module de o săptămână.
• Provocare — un singur exercițiu de programare. Ideal pentru evaluări rapide, încălzire sau practică independentă.

Folosește secțiunea de căutare și filtrare pentru a restrânge selecția după șablon, limbaj, dificultate sau propriile etichete.

ATENȚIE

Sursa nu mai poate fi modificată după creare. Dacă alegi o sursă greșită, va trebui să ștergi ciorna și să începi de la capăt.

Pasul 3 — Destinatari

Alege grupuri, studenți individuali sau ambele. Asistentul arată numărul în timp real al destinatarilor unici, astfel încât să poți vedea exact câți studenți vor primi tema după eliminarea duplicatelor.

SFAT

Combinarea grupurilor și a studenților individuali este complet acceptată — un student care se află într-un grup selectat ȘI în lista de studenți individuali va primi o singură înregistrare de temă.

Pasul 4 — Planificare și evaluare

• Termen limită (Due date) (obligatoriu) — data până la care trebuie finalizată tema. După această dată, starea se schimbă automat în Overdue și studentul este blocat (până când îi acorzi o prelungire).
• Dată de limitare (Cutoff date) (opțională) — o blocare finală strictă. Trimiterile de după această dată nu sunt luate în considerare pentru temă, chiar dacă rândul studentului nu a fost încă trecut la starea de restanță prin crontab. Util când dorești un avertisment moderat (Due) urmat de o limitare strictă (Cutoff).
• Prag de evaluare automată (Autograding threshold) (opțional) — când este activat, doar trimiterile cu un scor egal sau mai mare decât pragul sunt considerate Passed. Când este dezactivat, orice finalizare este considerată promovată.

Apasă pe Create assignment pentru a salva ciorna. Temele noi se salvează întotdeauna ca ciorne — ele sunt invizibile pentru studenți până când le publici.

Tab-ul Students de pe o ciornă

Deschide o ciornă pe care tocmai ai creat-o și dă clic pe tab-ul Students. Vei vedea o previzualizare a fiecărui destinatar identificat din grupurile și selecțiile individuale, fiecare având o etichetă Pending publish. Coloanele de metrici (status, progress, score, time) rămân goale până la publicare — tabelul îți arată cine va primi tema.

Folosește acest pas pentru a verifica corectitudinea listei de destinatari înainte de a trimite tema.

Publicarea

Când ciorna arată bine, apasă pe Publish din:

• Bara de instrumente cu acțiuni de pe pagina de vizualizare.
• Meniul contextual al elementului din listă de pe /business/assignments.

Publicarea:

1. Rezolvă setul de destinatari (grupuri → studenți + studenți individuali, deduplicați, cu instructorul eliminat).
2. Creează un rând AssignmentProgress pentru fiecare destinatar.
3. Trimite o notificare și un e-mail fiecărui student pentru a anunța noua temă.
4. Emite un eveniment socket în timp real, astfel încât oricine are un tab de browser deschis să vadă tema apărând imediat.

ATENȚIE

Publicarea este o acțiune ireversibilă. Odată publicată, nu mai poți modifica sursa, titlul sau instrucțiunile — aceste editări sunt permise doar pentru ciorne. Folosește Extend deadline pentru a modifica datele, Archive pentru a elimina tema din listele studenților sau Delete pentru a o șterge complet.

Dacă ciorna ta are zero destinatari valizi (grupuri goale + niciun student individual), publicarea va fi respinsă cu o eroare clară.

Monitorizarea progresului

Pagina de vizualizare a temei publicate afișează:

• Casete statistice — Destinatari, % Finalizare, Scor mediu, Timp mediu.
• Distribuția stării — o diagramă cu bare stivuite care arată ponderea studenților în fiecare stare (Completed / In progress / Not started / Overdue), cu o casetă de legendă pentru fiecare stare.
• Tab-ul Overview — instrucțiuni, destinatari (numele grupurilor + numele de utilizator individuale sub formă de tag-uri), linkul către sursă, cronologia planificării, configurația de evaluare.
• Tab-ul Students — tabelul de progres pentru fiecare student. Filtrează după stare, paginează și acordă prelungiri direct din tabel.
• Tab-ul Analytics — diagrame d3: diagramă circulară (donut) pentru rezultate, rata de promovabilitate pe lecție (doar pentru tipul LP), histograma distribuției scorurilor, cronologia cumulativă a finalizării.

Tabelul Students se actualizează în timp real pe măsură ce clasa ta lucrează — nu este necesară reîmprospătarea paginii pentru evenimentele transmise prin socket, iar un buton manual Refresh este disponibil chiar deasupra tabelului.

Acordarea prelungirilor

Fă clic pe Extend deadline în bara de instrumente cu acțiuni pentru a deschide fereastra modală de prelungire. Poți:

• Prelungi la nivel global — decalează termenul limită pentru toți destinatarii. Studenții a căror stare era overdue (restanți) sunt deblocați automat înapoi la In progress.
• Prelungi pentru studenți specifici — alege din lista de studenți și asociază fiecăruia un nou termen limită + un motiv opțional („concediu medical”, „a întâmpinat un blocaj”). Excepțiile stabilite pentru fiecare student în parte au prioritate față de termenul limită global.

SFAT

Data de limitare (cutoff date) este actualizată automat dacă noul termen limită trece de ea, astfel încât prelungirea chiar oferă studentului timp suplimentar de lucru. Nu trebuie să îți aduci aminte să actualizezi manual data de limitare.

Prelungirile individuale trimit, de asemenea, o notificare și un e-mail studentului vizat, conținând noul termen limită și motivul tău.

Poți acorda aceeași prelungire de mai multe ori — nu există nicio limită. O nouă prelungire creează pur și simplu o nouă înregistrare care o anulează pe cea anterioară.

Arhivarea

Când un capitol s-a încheiat, apasă pe Archive în bara de instrumente cu acțiuni (vizibil doar pentru temele published - publicate). Temele arhivate:

• Dispar imediat din listele studenților.
• Nu mai înregistrează trimiterile noi în contul temei.
• Sunt luate în considerare în continuare în analizele tale cu flagul includeOrphaned, în cazul în care ai nevoie vreodată să le auditezi.

O fereastră de confirmare te protejează de clicurile accidentale. Arhivarea este reversibilă doar prin ștergere și recreare — nu există o acțiune de restaurare.

Ștergerea

Acțiunea Delete este disponibilă în orice stare și șterge în cascadă:

• Documentul temei propriu-zise.
• Fiecare rând AssignmentProgress care face referire la aceasta.
• Fiecare notificare asociată (intrările din clopoțel pentru fiecare destinatar).

O poți folosi fără griji pentru ciorne. În cazul unei teme publicate care are progres activ, fereastra de confirmare te va avertiza cu privire la ștergerea în cascadă („All N student progress rows … will also be deleted”) înainte de a confirma.

ATENȚIE

Ștergerea este permanentă. Odată ce ai confirmat, acțiunea nu mai poate fi anulată — va trebui să creezi tema de la zero și să o publici din nou.

Editarea unei ciorne

Poți edita o temă aflată în stadiul de ciornă fie din meniul contextual al elementului din listă, fie din butonul Edit de pe pagina de vizualizare. Asistentul se va reîncărca cu valorile existente și îți va permite să modifici orice — titlul, instrucțiunile, sursa, destinatarii, planificarea, evaluarea.

ATENȚIE

Editarea este permisă doar pentru ciorne. Odată publicată tema, butonul Edit dispare de pe pagina de vizualizare și din meniul contextual al elementului. Pentru a schimba structura unei teme publicate, șterge-o și creeaz-o din nou.

Referință ciclu de viață

Scurtă recapitulare a stărilor:

De la	Acțiune	La
(niciuna)	Creare asistent	Ciornă
Ciornă	Editare asistent	Ciornă
Ciornă	Publicare	Publicat (se declanșează distribuirea)
Publicat	Prelungire termen limită	Publicat (se deblochează rândurile restante)
Publicat	Arhivare	Arhivat
oricare	Ștergere	(eliminat, șters în cascadă)

Cron-uri care rulează în fundal:

• Verificarea orară a restanțelor schimbă rândurile eligibile din not_started / in_progress în overdue odată ce termenul lor limită efectiv a trecut (se respectă prelungirile per student). Studenții restanțieri primesc o notificare + e-mail pentru a ști să ceară o prelungire.
• Memento-ul zilnic pentru termen apropiat la ora de server 08:00 notifică fiecare student activ al cărui termen limită efectiv este în următoarele 24 de ore.

Ce văd studenții

Pentru o vizibilitate completă asupra experienței studenților — cum apare tema pe pagina lor My Assignments, cum arată vizualizarea temei și cum este sărbătorită finalizarea — consultă pagina Conceptul de temă.