Concepte
Numerele săptămânilor și de ce cele din calendar sunt greșite
Fiecare instituție își numerotează săptămânile de predare, aproape niciuna nu le numerotează ca în calendar, iar în această diferență se ascunde o cantitate surprinzătoare de confuzie.
Două numere diferite cu același nume
Întrebați calendarul ce săptămână este și veți primi numărul săptămânii ISO: săptămâna 1 este cea care conține prima joi din ianuarie, iar la începutul unui an universitar din emisfera nordică vă aflați cam în săptămâna 36–40.
Puneți aceeași întrebare unui birou de orare și veți primi un număr complet diferit. Săptămâna 1 este prima săptămână de predare a anului, oriunde în calendar s-ar afla, iar totul se numără de acolo. Este numărul tipărit pe orar, numărul din formularul de rezervare a sălilor și numărul pe care îl folosesc doi colegi când stabilesc să se întâlnească în săptămâna 9.
Cele două nu coincid niciodată, decât dacă anul de predare al unei instituții începe în prima săptămână din ianuarie, adică: niciodată. Și, fiindcă ambele se numesc numărul săptămânii, un software care îl produce discret pe cel greșit produce ceva care pare pe deplin plauzibil.
Cum arată când merge prost
Nu arată ca o eroare. Arată ca o pagină cu un număr în partea de sus, iar numărul este greșit cu o altă valoare la fiecare instituție — deoarece fiecare își începe anul la altă dată.
Acesta este motivul pentru care costă. O cădere a sistemului este raportată într-o oră. Un titlu care scrie Săptămâna 36, când toți din clădire îi spun Săptămâna 2, este raportat după săptămâni, de cineva care a presupus că a înțeles greșit sistemul, nu că sistemul l-a înțeles greșit pe el — iar între timp oamenii s-au prezentat la săli pe baza lui.
Regula care o evită este scurtă: un număr de săptămână se citește, nu se calculează niciodată. Instituția decide unde este săptămâna 1; sarcina software-ului este să raporteze ce a decis instituția, nu să deducă un număr propriu dintr-o dată.
Săptămâna 1 nu este întotdeauna prima săptămână care există
Instituțiile au adesea nevoie de date dinaintea anului lor de predare: două săptămâni de orientare, o perioadă de restanțe, o școală de vară care aparține anului ce se încheie. În loc să renumeroteze totul — ceea ce ar schimba discret sensul fiecărui orar, al fiecărei rezervări și al fiecărui mesaj trimis vreodată despre săptămâna 9 — mișcarea rezonabilă este extinderea calendarului înapoi, spre zero și spre numere negative.
La prima vedere pare ciudat, iar la a doua este exact corect: săptămâna 1 continuă să însemne ceea ce a însemnat mereu, iar cele două săptămâni dinaintea ei sunt săptămâna −1 și săptămâna −2. Avem instituții al căror tabel de săptămâni se întinde mult în negativ și mult peste sfârșitul anului de predare, iar tot ce se află între ele corespunde unei date reale.
Orice citește un orar programatic ar trebui să se aștepte la asta. Numărul unei săptămâni este un întreg cu semn, nu un contor care pornește de la unu.
Iar unele instituții nu folosesc deloc numere
Oxford și Cambridge își denumesc săptămânile după trimestru, nu le numără pe parcursul anului: o dată se află în a patra săptămână din Michaelmas, iar un număr nu ar însemna nimic pentru nimeni din sală. Alte instituții denumesc două săptămâni Recapitulare, Orientare sau Perioadă de evaluare și se așteaptă ca orarul să o spună.
Așadar, o săptămână de predare poartă două lucruri, nu unul: numărul prin care o adresează software-ul și denumirea proprie a instituției pentru ea, pe care cititorul o dorește de fapt în partea de sus a paginii. Acolo unde există o denumire, ea trebuie tipărită în locul numărului și tipărită integral — abrevierea convenției de trimestre a cuiva pentru a economisi opt pixeli este genul de amabilitate pe care nimeni nu l-a cerut.
Acolo unde nu există denumire, iar pentru majoritatea instituțiilor nu există, numărul este denumirea și este perfect în regulă.
Patru lucruri de verificat în orice sistem de orare
Niciunul nu este exotic. Toate sunt discret greșite undeva.
| Întrebare | Cum arată un răspuns bun |
|---|---|
| Unde începe săptămâna 1? | O dată stabilită de instituția dumneavoastră, stocată o singură dată, folosită peste tot. Nu dedusă din calendar și nu configurabilă pe ecran. |
| Poate calendarul să meargă înaintea săptămânii 1? | Da, spre zero și numere negative, fără a renumerota nimic din ce există deja. |
| Poate o săptămână să poarte o denumire? | Da, iar denumirea este tipărită în locul numărului, integral. |
| De unde primește o aplicație pentru studenți numărul? | Din orar, în același răspuns cu orele. Un client care își calculează propriul număr va greși, și va greși diferit la fiecare instituție. |
De ce este și o întrebare de integrare
Un portal, o aplicație sau un ecran informativ care afișează un titlu de săptămână trebuie să îl obțină de undeva, iar singura sursă care poate fi corectă este orarul însuși. În Wise Timetable răspunsul pentru program conține numerele și denumirile săptămânilor pentru intervalul acoperit, astfel încât un client nu are niciodată motiv să calculeze unul — iar GET /v2/weeks răspunde separat la aceeași întrebare pentru un ecran care trebuie să eticheteze un întreg semestru deodată.
Manualul API REST le documentează pe amândouă, inclusiv cazul negativ, și este publicat integral și fără restricții, astfel încât un dezvoltator să poată verifica forma răspunsului înainte ca cineva să semneze ceva.
Doriți să vedeți cum funcționează?
Rezervați o prezentare online de 45 de minute și o vom parcurge împreună, pornind de la problema de programare proprie instituției dumneavoastră.