Aplicația pe telefon și notificări

Cum se instalează aplicația pe ecranul telefonului, ce notificări poți primi, cum le oprești și în ce limbă se afișează.

Pe scurt

Ce	Cum
Instalare	aplicație web (PWA): se adaugă pe ecranul principal din browser și se deschide fără bara browserului
Notificări	push în browser, plus clopoțelul din aplicație, după aceeași regulă de primire
Preferințe	pe cont și pe firmă: tipuri oprite și ore de liniște
Limba	română implicit; engleza e încă în lucru

Instalarea pe ecran

Aplicația are un manifest web (/manifest.webmanifest), deci telefonul o poate adăuga pe ecranul principal ca pe o aplicație.

Câmp din manifest	Valoare
Nume	numele din manifestul aplicației
Pornește la	`/`
Afișare	`standalone` (rezervă: `minimal-ui`)
Orientare	`portrait`
Culoare temă și fundal	`#0e4a2b`
Iconițe	192 × 192, 512 × 512 și o variantă `maskable` de 512 × 512

Pe iPhone, paginile au și etichetele Apple pentru ecranul principal, cu titlul din manifest.

Manifestul stă în spatele autentificării. De aceea, fiecare pagină îl cere cu crossorigin="use-credentials". Fără asta, browserul l-ar cere fără cookie și ar primi pagina de login în loc de manifest. Un test verifică regula pe toate paginile.

Aplicația nu are un buton propriu de instalare. Instalarea se face din meniul browserului.

Notificările push

Fiecare alertă are un tip. Pe pagina Setări → Notificări vezi un comutator pentru fiecare tip:

Tip	Ce anunță
`mz_dezactivat`	Meniul Zilei 1 sau 2 s-a dezactivat
`meniul_zilei`	meniul zilei pe toate ecranele, dimineața
`reduceri`	reducerile de pe Wolt au intrat sau s-au terminat
`campanie`	campanii Wolt refăcute, cu produse noi la reducere
`z`	Z-ul nescos la 23:30
`rezumat`	rezumatul zilei, la închiderea Z-ului
`raport_zilei`	raportul zilei gata, după închiderea Z
`zi_slaba`	zi slabă: vânzări mult sub obișnuit la 15:00
`raport`	raportul de dimineață, la 08:00
`rapoarte`	rapoartele tale pe departamente (PDF), la 21:00
`stoc`	stoc epuizat în bucătărie
`pret`	preț schimbat în DLS
`modificare`	modificări făcute de angajați (DLS, portaluri, panou)
`sincronizare`	sincronizare picată pe un canal
`tv`	televizor care nu răspunde
`aparate`	aparatele oprite sau pornite la loc
`fisier`	fișier nou pe Google Drive
`actualizare`	update-uri ale aplicației
`reparatie`	ce n-a putut repara serverul singur
`cod`	modificare oprită: un script al platformei are o greșeală de scriere
`imagine`	imagini generate, gata sau eșuate

Orele din tabel sunt cele din catalogul tipurilor. Trimiterea propriu-zisă a notificărilor push și înregistrarea service worker-ului nu sunt în codul platformei. Ele vin din platforma veche. Pagina doar citește abonamentul push existent al browserului.

Cine ce primește

Regula e una singură, pentru push și pentru clopoțel. Se calculează la citire, după drepturile de acum ale omului:

fiecare tip aparține unei funcții (preparate, vânzări, aparate, fișiere, administrare sau toți); îl primești dacă ai una din paginile funcției;
administratorul primește toate tipurile, mai puțin modificare;
unele roluri au o listă albă: Gestiune Produse, Bucătar Șef și Marketing primesc doar rapoarte și reduceri, iar Patron în plus raport_zilei;
alertele cu sume în lei (Z, rezumat, zi slabă, raportul zilei) ajung doar la cine vede sumele;
rolul Patron primește alertele de preparate, vânzări și rapoarte, chiar fără paginile lor;
reduceri ajunge la orice cont al firmei;
imagine și chat_gata ajung la un singur cont anume;
tipurile poza și stoc_reumplut sunt scoase și nu mai ajung la nimeni;
conturile de probă nu primesc nimic.

Cum le oprești

Acțiune	Rută
Citești preferințele	`GET /v1/eu/notificari/preferinte`
Oprești tipuri sau pui ore de liniște	`POST /v1/eu/notificari/preferinte`
Marchezi „văzut”	`POST /v1/eu/notificari/vazut`

POST /v1/eu/notificari/preferintejson

{ "oprite": ["zi_slaba", "tv"], "linisteDe": "22:00", "linistePana": "07:00" }

Orele de liniște au forma HH:MM și vin amândouă sau niciuna.
Corpul schimbă doar ce conține. Restul rămâne cum era.
Implicit nu e nimic oprit și nu există ore de liniște.
Butonul „Oprește pe acest dispozitiv” scoate abonamentul push al browserului curent. Pe celelalte dispozitive notificările continuă.

Clopoțelul marchează alertele drept văzute pe server când îl deschizi (POST /v1/eu/notificari/vazut). Pe un cont real, deschiderea lui schimbă starea pentru omul acela.

Platforma notează, ca urme anonime de utilizare, când o notificare push a fost afișată sau apăsată și dacă pagina rulează instalată (pwa). Vezi Jurnal de audit.

Limba aplicației

Limba implicită este româna (ro-RO). Cealaltă limbă pregătită este engleza (en-GB).
Alegerea se păstrează pe server, pe cont (GET și PUT /v1/eu/preferinte). În browser rămâne doar o copie, ca prima afișare să iasă direct în limba bună.
Engleza nu se poate alege încă din interfață: e ascunsă până la traducerea completă.
Banii, numerele și datele se formatează după limba aleasă: 1.234,50 lei în română.

A fost utilă pagina?