Shto Përbërës të Ri

Foto e përbërësit

📋 Ngjit nga Excel/Sheets ▸

Lista e Përbërësve

Baza e kostos suaj — e saktë deri në qindarkë.

🔎 Produkte të Mundshme të Dyfishta

Të njëjtin produkt, regjistruar dy herë me emra pak të ndryshëm? Shikoji këtu.

🔁 Zëvendësime Përbërësish

Nëse mungon një përbërës, çfarë mund ta zëvendësojë — regjistrohet një herë, shfaqet automatikisht kudo që përdoret ai përbërës.

Kategoritë e Përbërësve

Kategoritë regjistrohen automatikisht kur i shton te forma e Përbërësve, ose i shton manualisht këtu.

Kategoritë e Recetave

Kategoritë e integruara nuk mund të fshihen; mund të shtosh kategori shtesë custom këtu.

Timer Gatimi

Shto Detyrë Përgatitjeje

Vetëm për "💾 Ruaj si Shabllon" (opsionale, jo për "+ Shto Detyrë" të njëhershme):

Sektori i shablonit — Pa sektor —

Mënyra e përsëritjes 📅 Ditë fikse të javës ⏳ Sipas jetëgjatësisë (ribëhet X ditë pas prep-it të fundit)

Ditët e javës (bosh = çdo ditë)

Hën Mar Mër Enj Pre Sht Die

Ribëhet çdo (ditë)

Kohëzgjatja (min)

Lidh me Recetë (opsionale) — Pa lidhje —

Kategori brenda sektorit

Foto reference

Hapa të shkurtër (1 për rresht, opsionale)

Video hap-pas-hapi (URL, opsionale)

Niveli minimal i kërkuar — Pa kufizim — Fillestar Mesatar Ekspert (kërkon përvojë)

Toleranca / cilësia e pritshme

Shabllonet e Prep (Par-Levels)

Kliko një shabllon për ta shtuar menjëherë në listën e datës aktuale.

📋 Plani i Punës sipas Sektorit

Bazuar te shabllonet e ruajtura më sipër (secili i lidhur me sektorin e vet) — zgjidh sektorin dhe datën, pastaj gjenero planin e punës në 1 klik.

✅ Check Mise en Place

Për çdo pjatë të menusë së këtij sektori (referuar te "Menu i Sektorit" më sipër) — çfarë nën-recetash/përbërësish duhen GATI para se sektori të jetë gati për servirje. Rivendoset çdo ditë. Sektori/data merren nga "Plani i Punës" më sipër.

🏷️ Etiketa Printimi (Ushqim i Përgatitur)

Gjenero etiketa me datë prodhimi/skadence për ushqimin e përgatitur, gati për printim në fletë etiketash standarde (Avery-style). Për detyra të Planit të Punës më sipër, etiketa sugjerohet vetë kur i shënon "e kryer".

📜 Historiku i Kryerjes (Prep)

Të gjitha detyrat e prep-it të kryera, me kush-i-kreu dhe kur — përgjegjshmëri reale, jo vetëm ✓ anonim.

📊 Raportim & Analitikë e Prep-it

💰 Kosto e Prep-it Muaj pas Muaji

⏰ Detyrat më Shpesh të Pakryera

⚖️ Ngarkesa e Punës mes Sektorëve (7 ditët e fundit)

🔮 Parashikim Kërkese për Prep

Bazuar te Regjistri i Shitjeve — dallim i qëllimshëm nga "Parashikim Konsumi & Porosie" te Inventari (F3 #21): ai llogarit konsum mesatar DITOR për RIPOROSITJE përbërësish; ky këtu parashikon SASINË E PRITSHME PËR ÇDO RECETË sipas ditës së javës (p.sh. e shtunave shitet ~2x më shumë se të hënave) — për të planifikuar SA prej çdo pjate të përgatitësh, jo çfarë të porositësh.

Lista e Përgatitjes

🔄 Shënime Handover mes Turneve

Çfarë duhet ta dijë turni tjetër. F8 #71: tani i strukturuar (çfarë mungon / çfarë kërkon vëmendje / rezervime VIP) në vend të vetëm një shënimi të lirë — fusha e shënimit të përgjithshëm mbetet gjithmonë opsionale për çdo gjë tjetër.

📢 Tabela e Njoftimeve të Ekipit

Mesazhe të përgjithshme për të gjithë stafin. Shëno "kritik" për njoftime që kërkojnë konfirmim leximi (F8 #78) — shfaqen si dritare që duhet mbyllur me dorë kur hap app-in derisa të konfirmohen.

🌅 Brifimi Ditor për Menaxherin

Përmbledhje e gjeneruar automatikisht nga të dhënat e djeshme/sotme — temperatura jashtë normës, stok i ulët, probleme të raportuara, incidente/ankesa aktive.

📞 Kontakte Urgjence

Gjithmonë e disponueshme — teknik frigoriferësh, zjarrfikëse, autoritet shëndetësor, etj. Dallim nga kontakti i urgjencës te profili i furnitorit (F6 #56): ky këtu është për shërbime/autoritete të jashtme, jo furnitorë.

🔗 Zinxhir Përshkallëzimi Incidenti

Kush njoftohet i pari, i dyti, etj., sipas llojit të problemit. ⚠️ Kufizim i sinqertë: kjo është VETËM plan/udhëzues referencë për stafin — app-i NUK i njofton/telefonon vetë kontaktet automatikisht.

🎓 Checklist Trajnimi (Food Bible)

Shëno seksionet e Food Bible-it që një anëtar stafi ka kaluar në trajnim, me nënshkrim dixhital.

🧊 Komponentë të Përgatitur & Gjenerim Prep-i

F4 #31/#37: nën-recetat/komponentët (salca, bazë, brumë...) tashmë ndiqen si receta të veta me kosto/jetëgjatësi (fusha "Jetëgjatësia e Ruajtjes" te forma e recetës) — këtu shtohet "Par Level Prep-i" + "Sasia Gati Tani", që të gjenerohet automatikisht lista e prep-it kur diçka bie nën nivelin e vet.

🧹 Checklist "Mise en Place" sipas Stacionit

F4 #32: checklist i përgjithshëm përpara-shërbimit, i ndarë nga checklist-et HACCP/turni — përsëritet për çdo stacion/ditë.

🔗 Përbërës/Komponentë të Përbashkët

F4 #36: cilët përbërës/nën-receta përdoren në SHUMË receta të tjera — ndihmon planifikimin e prep-it të përbashkët (nëse e prek njërën, prek shumë pjata).

🔧 Kalendar Mirëmbajtjeje Pajisjesh

F4 #38: regjistro pajisjet (furra, frigoriferë...) me interval shërbimi, dhe sistemi llogarit kur duhet servisi tjetër. (Ndryshe nga tab-i ekzistues "Pajisjet" — atje regjistrohen thjesht emra pajisjesh për t'u sugjeruar te receta; këtu ndiqet mirëmbajtja periodike reale.)

💡 Ndjekje Energji & Ujë

F4 #39: regjistro leximet periodike të energjisë/ujit, për të kuptuar koston reale operative (jo vetëm koston e ushqimit).

🖥️ Radha e Kuzhinës (KDS i Thjeshtë)

F4 #40: krijo "bileta" pune dhe ndiqi nëpër status Në Pritje → Në Përgatitje → Gati, si radhë pune dixhitale.

🧊 Vitrina 🔆 🌙 📷

Prek një produkt kur diçka del nga kuzhina te vitrina, rregullo sasinë me +/− dhe regjistro. Produktet shfaqen këtu vetëm nëse janë shënuar "🧊 Shfaq te Regjistri i Vitrinës" te formulari i recetës.

📊 Analitika e Vitrinës

📊 Raporti i Ditës: Dalë · Shitur · Për nesër · Firo

🏆 Kush regjistroi më shumë sot

📋 Regjistrimet e Sotme ▾

🗂️ Organizimi i sektorëve

Për çdo sektor: çfarë mbahet gjatë shërbimit, në çfarë vaskele dhe ku (ambient, frig, karrel). Zgjidh sektorin, shërbimin dhe pamjen.

Njësitë Matëse

Këto njësi shfaqen te menytë e zgjedhjes (Përbërës, Rendimenti i nën-recetave).

🔁 Konvertues Njësish

Konverton vetëm mes njësive të njëjtit lloj (peshë kg↔g, ose vëllim lt↔ml).

🧮 Kalkulatori i Shpejtë i Kostos

Provo koston e një pjate hipotetike pa e ruajtur si recetë.

Furnitorët

Furnitorët regjistrohen automatikisht kur i shton te Përbërësit, ose i shton manualisht këtu.

⭐ Vlerësim Furnitori

Vlerëso çdo dorëzim/marrëdhënie me furnitorin — cilësi, kohë dorëzimi, çmim. Mesatarja llogaritet automatikisht dhe krahasohet.

⚖️ Krahasim Çmimesh Shumë-Furnitorësh

Ndryshe nga krahasimi te faqja e vetë përbërësit (një nga një), këtu shihen NJËKOHËSISHT të gjithë përbërësit me ≥2 oferta furnitori — furnitori më i lirë vs. më i shtrenjti dhe kursimi i mundshëm.

🚨 Alarme Ndryshimi Çmimi

Bazuar te Historiku i Çmimeve të çdo përbërësi — flamuron kur çmimi i fundit u rrit mbi pragun e mëposhtëm krahasuar me blerjen paraardhëse.

✍️ Rrjedhë Miratimi Porosie

Çdo porosi e re fillon si "kërkesë" — duhet miratim menaxheri PARA se të konsiderohet e gatshme për dërgim te furnitori. Vetë miratimi/dërgimi bëhet te karta "Porositë e Ruajtura" (skeda Inventari); këtu shihet vetëm përmbledhja e atyre në pritje.

📸 Mospërputhje Dorëzimi

Raporto çka mungon/nuk përputhet kur mbërrin një dorëzim — me foto dëshmie. Ndryshe nga rakordimi automatik i faturës (numra), ky është raportim manual i shpejtë nga stafi i pranimit.

📇 Kontaktet e Furnitorëve

Telefon, email, orë pune, kontakt urgjence — profil i veçantë nga vetë lista e emrave të furnitorëve më sipër.

📄 Kontrata & Marrëveshje me Furnitorë

🌍 Lokal vs. Importuar

Fusha "Origjina" te çdo përbërës (Përbërës → forma) ekzistonte tashmë si tekst i lirë, por s'shfaqej askund si etiketë/statistikë — tani normalizohet për filtrim (shih çipat "🏡 Lokal"/"🚢 Importuar" te lista e Përbërësve) dhe përmblidhet këtu.

📦 Sugjerim Bashkimi/Optimizimi Porosie

Bazuar te Porosia e Sugjeruar (Inventari) dhe ofertat e furnitorëve për sasi më të mëdha — flamuron kur blerja e një sasie pak më të madhe ul ndjeshëm koston/njësi.

📊 Besueshmëria e Furnitorit sipas Rakordimeve

Ndryshe nga rakordimi vetë i faturës kundrejt porosisë (F3 #30, te Inventari, çdo herë që skanon një faturë), kjo është pamja AGREGATE — cili furnitor ka më shumë mospërputhje ndër kohë, duke kombinuar rakordimet e porosive dhe raportimet e mospërputhjes (#55).

Pajisjet

Pajisjet e regjistruara këtu sugjerohen automatikisht kur plotëson pajisjet e nevojshme të një recete.

🔗 Arka → Receta (Simphony)

Lidh çdo artikull ushqimor të arkës me recetën (ose recetat) që përdor. Shitjet merren automatikisht nga Oracle Simphony çdo 15 minuta — pijet përjashtohen.

Regjistri i Shitjeve

Ngjit shitjet nga POS-i (shpejt, shumë rreshta njëherësh) ose shto manualisht sa njësi u shitën nga secila recetë — për të ushqyer Menu Engineering-un dhe raportet KPI.

📦 Ambalazhe (Kosto për Delivery)

Regjistro këtu llojet e ambalazhimit me SASINË dhe koston E BLERJES (p.sh. "1 rrotull film = 3 kg me 900 Lek", ose "50 kuti me 1500 Lek") — app-i llogarit vetë koston për njësi (kg/gram/copë). Pastaj lidhi te forma e recetës (hapi 2, "Ambalazhi për Delivery") me sasinë e përdorur për 1 porosi.

📈 Shitjet e Arkës — Food

Matrica Menu Engineering

Bazuar në shitjet e regjistruara: Stars = shitje të larta + fitim i lartë, Plowhorses = shitje të larta + fitim i ulët, Puzzles = shitje të ulëta + fitim i lartë, Dogs = shitje të ulëta + fitim i ulët. (Kolona "Sasi Shitjesh" tregon gjithashtu popullaritetin/shpejtësinë e shitjes së çdo pjate — F5 #48.)

🔗 Analizë Përzierje Menuje

⚠️ Kufizim i sinqertë: Regjistri i Shitjeve ruan sasi TË SHITURA PËR DITË, jo porosi/fletë individuale (do të kërkonte integrim real POS me artikuj-për-faturë) — kështu kjo tregon çifte recetash që shiten SHPESH NË TË NJËJTËN DITË (co-occurrence sipas datës), jo domosdoshmërisht të porositura bashkë në të njëjtën tavolinë/faturë.

📅 Kalendar Planifikimi Menuje Sezonale

F5 #43: planifiko përpara ndryshimet sezonale të menusë, në vend të ndryshimit ad-hoc në çast — cakto çfarë recetash duhet të hyjnë/dalin dhe kur.

🧮 Analizë "Çfarë-Nëse" e Çmimit

F5 #44: provo ndryshime çmimi shitjeje ose kostoje dhe shiko menjëherë ndikimin te marzhi/food cost % — PA e ruajtur ende recetën.

📏 Ndjekje Porcion-Konsistence

F5 #46: krahaso porcionin e PLANIFIKUAR (nga receta) me atë REALISHT të shërbyer — ndryshe nga F3 #25 (rendimenti total i një serie prep-i), kjo është për porcionin individual në momentin e shërbimit.

✍️ Recetat në Pritje të Miratimit

Vetëm recetat "Të Publikuara" (të nënshkruara) shfaqen te zgjedhësi i recetave për menutë e klientëve.

Inventari / Stoku

Vendos sasinë aktuale në stok për çdo përbërës. Statusi tregon nëse duhet porositur.

📉 Inventari teorik (nga arka)

Gjendja në çdo moment = numërimi i fundit + furnizimet − shitjet e arkës (Simphony) × receta. Përditësohet vetë çdo 15 minuta. Sasitë janë bruto (me humbjen e pastrimit) — sa del nga magazina.

🤖 Sugjero Recetë nga Stoku i Tepërt

AI-ja shikon përbërësit me stok dukshëm mbi par-level dhe sugjeron një recetë të re për t'i konsumuar, para se të rrezikojnë skadencë.

📦 Inventari Mujor Multi-Sektor

Çdo zonë/stacion numëron nga telefoni i vet (edhe nën-recetat/produktet) — në fund, gjithçka bashkohet automatikisht në një dokument të vetëm, edhe kur i njëjti artikull gjendet në disa zona (p.sh. sektor + frigorifer i përbashkët).

📊 Analitikë & Historik i Numërimit

Tendencat ndërtohen automatikisht ndërsa mbyllen sesionet e numërimit muaj pas muaji.

🗓️ Historiku i Sesioneve (kthehu te çdo muaj i kaluar)

💰 Vlera e Inventarit të Numëruar (muaj pas muaji)

🔎 Artikujt me Devijimin më të Shpeshtë (≥30%)

📸 Skano Faturën e Furnitorit (OCR + AI)

Ngarko një foto të faturës. Sistemi lexon tekstin (OCR në shfletues) dhe pastaj AI-ja e strukturon në rreshta (emër, sasi, njësi, çmim). Kontrollo/rregullo më poshtë përpara se t'i shtosh në inventar — asgjë s'ruhet automatikisht pa konfirmimin tënd.

🛒 Lista e Blerjeve sipas Ditës së Dorëzimit

Përbërësit nën "Par Level" të grupuar sipas "Ditës së Porosisë" (vendose te forma e përbërësit).

📈 Parashikim Konsumi & Porosie (nga Shitjet)

Bazuar te Regjistri i Shitjeve — sasia mesatare ditore e përdorur për çdo përbërës dhe sa duhet porositur për 7 ditët e ardhshme.

⏳ FEFO — Përdori Këto së Pari

Përbërësit me datë skadence, të renditur nga më afër skadencës (First-Expired-First-Out).

📉 Analiza e Humbjeve (Waste)

Kosto mujore e humbjeve dhe përbërësit që humbasin më shumë.

Regjistri i Humbjeve

Regjistro sasinë e humbur (prishje, skadencë, gabim) dhe sistemi llogarit koston automatikisht.

🎯 Qëllime Reduktimi Firo

Vendos një objektiv reduktimi për muajin aktual dhe ndiq progresin kundrejt kostos bazë (muaji paraardhës).

♻️ Regjistër Kompostimi/Riciklimi

Për qëllime qëndrueshmërie/raportimi — sa nga produktet e mbetura shkojnë për kompostim/riciklim në vend të hedhjes së thjeshtë.

Porosi e Sugjeruar

Lista gjenerohet automatikisht nga përbërësit me stok të ulët ose pa stok, grupuar sipas furnitorit.

📝 Krijo Flete Porosie Manuale

Shto çdo artikull që duhet porositur te lista e përbashkët më poshtë — furnitori mbushet vetë nga profili i përbërësit (redaktueshëm nëse duhet ndryshuar për këtë porosi). Kur printon/eksporton, artikujt ndahen vetë sipas furnitorit.

📑 Porosi të Hapura & Rakordim me Faturë

F3 #30: ruaj porositë (nga "Porosia e Sugjeruar" ose fleta manuale) si "të hapura", pastaj kur importon faturën përkatëse via OCR, krahaso automatikisht sasi/çmim kundrejt asaj që u porosit.

💰 Vlera e Inventarit (Mesatare e Ponderuar)

F3 #26: vlera totale e stokut aktual, llogaritur me koston mesatare të ponderuar nga historiku i çmimeve (jo FIFO real me lote — shih kufizimin te README).

🎯 Par Level sipas Sektorit

F3 #27: shiko/rregullo Par Level-in për përbërësit e një sektori specifik (çdo përbërës i takon një sektori te fusha "Sektori/Stacioni").

💤 Stok i Ngrirë (Dead Stock)

F3 #28: përbërës me stok pozitiv por pa asnjë lëvizje (ndryshim sasie) prej mbi 30 ditësh — mund të jenë të harruar ose të gabuar në numërim.

📐 Ndjekje Rendimenti (Teorik vs. Real)

F3 #25: kur përgatit një recetë/nën-recetë, krahaso sasinë e pritur (yield-i teorik × shumëfishuesi i sasisë) me sasinë reale të matur pas përgatitjes.

✏️ Redakto Formularin

👥 Stafi (Lista)

Roster bazë i stafit — përdoret nga orari, hyrje/dalje, certifikatat dhe kërkesat e pushimit më poshtë.

📅 Shto Turn në Orar

📊 Sugjerim Personeli sipas Ditëve të Pikut

⚠️ Kufizim i sinqertë: Regjistri i Shitjeve ruan vetëm DATË (jo orë specifike) — kështu sugjerimi këtu është sipas DITËS SË JAVËS (p.sh. "e premte/shtunë kanë ~40% më shumë shitje se e martë") dhe jo sipas orëve specifike të pikut (do të kërkonte kohë-vulë reale porosish nga një sistem POS të lidhur). Krahasoje me orarin ekzistues të turneve më sipër.

⏱️ Hyrje/Dalje (Clock In/Out)

✅ Checklist Detyrash për Turn

Detyra operacionale të turnit (jo HACCP) — p.sh. ndez pajisjet, kontrollo stokun e ditës.

📜 Certifikimet e Stafit

Certifikata higjiene ushqimi — skadenca dhe kujtues rinovimi.

🏖️ Kërkesa Pushimi

🕘 Prezenca & Vonesat

💶 Eksporto Orët e Punuara (Pagesë)

Llogarit orët e punuara nga regjistrimet Hyrje/Dalje, brenda një periudhe, gati për eksport CSV.

💡 Kutia e Sugjerimeve

Stafi propozon përmirësime — anonimisht ose me emër. Menaxheri mund të përgjigjet.

📘 Manuali BOH — Le District Tirana

Manuali i plotë i Operacioneve të Back of House (kultura, HACCP, Food Bible, sektorët e kuzhinës, shërbimi, siguria, trajnimet, etj.) — kërkohet direkt këtu, ose shkarkohet si PDF.

🚀 Onboarding i Punonjësit të Ri

Checklist i strukturuar hap-pas-hapi, i ndarë nga regjistri i thjeshtë i temave të trajnimit më sipër. Kërkohet konfirmim eksplicit i menaxherit (jo vetëm vetë-konfirmim) para se punonjësi të konsiderohet "gati".

🎬 Bibliotekë Trajnimi për Stacion

Si përdoret çdo pajisje/procedurë specifike. ⚠️ Kufizim i sinqertë: videot ruhen si LINK i jashtëm (YouTube/Google Drive, jo brenda vetë app-it — do të fryente shpejt madhësinë e state-it); fotot mund të ngarkohen drejtpërdrejt.

📝 Kuiz Certifikimi — Siguria Ushqimore

Brenda vetë app-it, i vetë-korrigjuar. Bazë pyetjesh e integruar (HACCP/alergjenë/temperatura) — jo e personalizueshme ende nga menaxheri (shih kufizimin te README-teknik.md).

🔀 Planet e Cross-Training

Ndryshe nga fusha e lirë "Stacionet" te roster-i i stafit më sipër (thjesht listë çfarë di dikush) — këtu ndiqet PROCESI aktiv: niveli aktual dhe data-objektiv për të arritur nivelin tjetër.

🤝 Sistemi "Shoku" për Punonjës të Rinj

📊 Vlerësim Periodik Kompetencash

Rivlerësim i planifikuar, jo vetëm certifikim një-herësh — vendos datën e vlerësimit tjetër që të ridalë vetë si kujtues.

ℹ️ Rreth ChefsTime

Aplikacion për kostot e recetave, menutë, inventarin dhe operacionet e kuzhinës — ndërtuar posaçërisht, i thjeshtë, pa varësi nga shërbime të jashtme përveç Supabase-it për sinkronizim.

🗺️ Harta e Sistemit

Kërko çdo seksion të app-it, shko direkt tek ai, ose shënoje si "të preferuar" që të shfaqet lart në sidebar.

Llogaria

🌍 Fjalor Frazash për Staf

App-i mbështet plotësisht vetëm shqip/anglisht (butonat SQ/EN në krye). ⚠️ Kufizim i sinqertë: përkthimi i plotë i gjithë app-it në një gjuhë të tretë s'është ndërtuar këtu — do të kërkonte përkthim profesional real, jo të fabrikuar, veçanërisht për terma sigurie ushqimore ku një keqkuptim është i rrezikshëm. Në vend të kësaj, shto këtu fraza/udhëzime të shkurtra pune (p.sh. emra pajisjesh, paralajmërime, hapa procedure) të përkthyera nga vetë restoranti në gjuhën që i duhet ekipit — një fjalor real pune, jo zëvendësim i app-it.

🏭 Sektorët/Stacionet (Inventari Mujor)

Krijo sektorët/stacionet e kuzhinës tënde (p.sh. Kuzhinë e Ngrohtë, Kuzhinë e Ftohtë, Bar, Ëmbëlsira, Walk-in, Magazinë). Çdo përbërës mund t'i caktohet një sektori (te forma e Përbërësve, ose me shumicë te Inventari) — kështu çdo stacion sheh vetëm listën e vet kur bën numërimin mujor. PIN-i është opsional, thjesht një pengesë e vogël aksidentale, jo mbrojtje reale sigurie.

🗄️ Kancelari / Uniforma / Pajisje të Imta (Numërim Tremujor)

INV2 #14/#81: sende që numërohen VETËM çdo 3 muaj (jo çdo muaj si lëndët e para) — listë e veçantë, më e lehtë (emër+sasi+zonë), pa fushat e panevojshme të një përbërësi (kosto/furnitor/humbje).

👤 Roli i Këtij Terminali

Vendos rolin për këtë pajisje/terminal specifik (nuk lidhet me llogarinë — çdo pajisje mund të ketë rol tjetër). Roli "Staf" fsheh butonat e fshirjes për të parandaluar gabime aksidentale.

"Vetëm Lexim" bllokon automatikisht çdo ruajtje/fshirje në këtë terminal (i njëjti mekanizëm si "Mënyra Vetëm-Lexim" më poshtë te Shëndeti i Sistemit) — i përshtatshëm për dikë të jashtëm që duhet vetëm të shohë raporte/kosto, jo t'i ndryshojë.

🔐 Rolet & Aksesi

Role SPECIFIKE sipas pozicionit real në kuzhinë (Cook, Shef Kuzhine, Menaxher Turni, Pronar, Kontabilist), lidhur me VETË PERSONIN (jo vetëm terminalin) — çdo rol sheh vetëm tab-et e caktuara. Shkallëzimi bazë këtu është në nivel TAB-i; skopimi MË I IMËT (kartë-për-kartë brenda disa tab-eve, p.sh. Cook-u te "Siguria Ushqimore") u shtua në O6 — shih tabelën "Çfarë Sheh Çdo Rol" më poshtë për detaje të plota. ⚠️ Kufizim i sinqertë: O6 mbulon vetëm rastet e vëna re si më domethënëse (shih tabelën); shumica e tab-eve të tjera ende ndahen VETËM në nivel tab-i, jo çdo kartë individualisht.

⚠️ Kufizim i sinqertë (siguri): ky sistem rolesh fsheh/kufizon VETËM çfarë shihet në ndërfaqe (butona, karta, tab-e) — s'është mur sigurie i vërtetë te të dhënat. Çdo punonjës që hyn me "Hyr si..." përdor TË NJËJTËN llogari reale (Supabase) si pronari — rregullat e sigurisë në cloud (RLS) mbrojnë vetëm kundrejt llogarive TË TJERA, jo kundrejt roleve BRENDA kësaj llogarie. Pra dikush me pak njohuri teknike (Console e shfletuesit) mund të anashkalojë çdo kufizim roli këtu, edhe një rol të shënuar "vetëm-lexim". Përdore këtë sistem si ndihmë organizative për stafin e zakonshëm (më pak rreshta për t'u ngatërruar), JO si mbrojtje kundër dikujt që qëllimisht kërkon të shkelë kufijtë.

📊 Përdorimi i Kartave

⚠️ Kufizim i sinqertë: "përdorim" këtu do të thotë klikime brenda vetë kartës (buton, input, etj.) — jo llogari e saktë e "sa herë u hap/u lexua". Të dhënat mbahen lokalisht në këtë pajisje (si "Tabet e Preferuara" më sipër), jo në cloud. Përdor 📌 pranë çdo karte te "Raportet"/"Siguria Ushqimore" për ta gozhduar në krye (max. 3 për tab).

🔲 Mënyra me Kontrast të Lartë

Rrit dukshëm kontrastin e tekstit dhe kufijve — e dobishme në kuzhina me dritë shumë të fortë, ose në ekrane të vjetra. E ndryshme nga tema e errët.

🔴 Modaliteti "Kuzhinë e Errët" (Ruajtje Shikimi Natën)

Paletë vetëm e kuqe/portokalli, pa asnjë blu apo jeshile — drita blu/jeshile "prish" përshtatjen e syve me terrin. E dobishme kur punon natën në errësirë pothuajse të plotë (magazina, walk-in). Mund ta përdorësh vetëm ose bashkë me dark mode.

💾 Mënyra Kursimi

E dobishme me wifi/të dhëna mobile të dobëta në kuzhinë/magazinë — fotot e reja (recetë, numërim mujor, temperaturë) ruhen në cilësi/përmasë më të ulët, dhe leximi OCR (motor ~2-3MB nga interneti) kërkon konfirmim eksplicit para se të shkarkohet.

🔊 Tinguj të Lehtë (Sonor)

Tinguj shumë të lehtë, opsionalë — "cha-ching" i butë pas një shitjeje të re, dhe klikim i lehtë mekanik gjatë futjes së numrave. Të fikur si parazgjedhje.

🔎 Densiteti i Ndërfaqes

"Kompakt" fut më shumë informacion në ekran. "Komod" e bën tekstin/hapësirat më të mëdha — i dobishëm për sy të lodhur pas turni të gjatë. Preferenca ruhet vetëm në këtë pajisje.

📲 Instalo si Aplikacion (Telefon, Tablet, Desktop)

Instaloje ChefsTime si aplikacion — hapet me ikonën e vet, pa shiritin e shfletuesit, si çdo app tjetër. Në Android/Chrome kliko butonin poshtë; në iPhone/iPad ndiq udhëzimin që shfaqet.

🖥️ Modaliteti Kiosk (Tablet Fiks në Kuzhinë)

Për tableta/ekrane të montuara fiks në kuzhinë: fsheh sidebar-in dhe menunë e plotë, duke lënë të dukshme VETËM Log-un e Temperaturave dhe Checklist-in HACCP. Aktivizohet vetëm në KËTË pajisje (jo për të gjitha pajisjet e restorantit njëkohësisht).

Dalja bëhet me butonin diskret poshtë-djathtas të ekranit kiosk (kërkon PIN-in Mbrojtës nëse është vendosur më sipër te "Të Dhënat").

🔍 Mënyra Inspektor (Gatishmëri Auditimi)

Pamje vetëm-lexim, e organizuar VETËM me karta të Sigurisë Ushqimore (kontrolle ditore + dokumentacion/auditim) — për t'i treguar një inspektori real pa e lënë të shohë çmime, kosto apo të dhëna të tjera të restorantit. Butonat e shtim/fshirjes çaktivizohen; eksporti/printimi mbeten aktivë.

Dalja bëhet me butonin diskret poshtë-djathtas (kërkon PIN-in Mbrojtës nëse është vendosur më sipër te "Të Dhënat").

Njoftimet e Stokut

Merr një njoftim të shfletuesit kur ke përbërës me stok të ulët ose pa stok (kërkon leje dhe faqja hapur).

🚨 Njoftime Kritike Push

⚠️ Kufizim i sinqertë (gjetur nga auditi, 30.08.2026): asnjë njoftim këtu S'ARRIN te telefoni kur ekrani është i fikur/i kyçur, apo kur shfletuesi/app-i është mbyllur plotësisht — as edhe për një alarm HACCP kritik natën (p.sh. temperaturë e frigoriferit jashtë intervalit). Kjo NUK është push i vërtetë i serverit, është vetëm njoftim i shfletuesit ndërsa vetë skeda është e hapur dhe pajisja aktive. Për alarme reale natën/kur je larg, përdor gjithsesi një sistem fizik/komercial monitorimi temperature derisa kjo veçori të zgjerohet me push serveri (kërkon çelës VAPID + një funksion server-i që s'është ndërtuar ende).

Njoftimi i shfletuesit ekziston tashmë vetëm për stok (më sipër). Ky këtu e zgjeron kontrollin (temperaturë jashtë normës + incidente sigurie ushqimore aktive) — funksionon VETËM ndërsa app-i është hapur DHE pajisja aktive. Regjistrimi për push TË VËRTETË (edhe kur app-i është mbyllur) kërkon çelës VAPID nga zhvilluesi — shih README-teknik.md.

🔔 Qendra e Njoftimeve

Të gjitha alarmet aktive të app-it, në një vend të vetëm, të renditura sipas urgjencës reale — jo të shpërndara nëpër tabe të ndryshme. Alarme "urgjente" (të kuqe) s'mund të heshten; ato "kujdes" (portokalli) dhe "informative" (gri) mund të heshten deri nesër.

🧾 VAT / TVSH sipas Vendit

Vendos një VAT % parazgjedhur që aplikohet automatikisht te recetat e reja.

🎨 Ngjyra e Markës (Aplikacioni)

Zgjidh ngjyrën kryesore të markës për të GJITHË aplikacionin (butona, topbar, theksime) — jo vetëm printimet. E njëjta ngjyrë përdoret në temën e çelët dhe të errët.

🎨 Printimi & Dokumentet

Personalizo si duken dokumentet e printuara (Food Bible, menu, etiketa) — ngjyra, madhësia e letrës dhe stili.

🖋️ Historia e Markës (Menu Publike)

Shto kapituj të shkurtër për historinë e restorantit tënd — shfaqen te "Menu Publike" e eksportuar/printuar, me zbulim animuar ndërsa lexuesi bën scroll (efekt storytelling).

📜 Regjistri i Aktivitetit

30 veprimet e fundit — kush shtoi, ndryshoi ose fshiu diçka.

🔐 Verifikim Dy-Faktorësh (2FA)

Shtresë shtesë sigurie për llogarinë e pronarit/menaxherit — edhe nëse fjalëkalimi zbulohet, dikush ende s'mund të futet pa app-in autentikues në telefonin tënd. Opsionale, jo e detyrueshme.

📱 Pajisjet e Njohura

Kur u përdor ChefsTime për herë të fundit nga secila pajisje/terminal — i dobishëm nëse ke disa tableta/kompjuterë në kuzhinë.

🗑️ Kosha (Soft-Delete Universal)

Çdo fshirje e Përbërësve, Recetave, Sektorëve, Pajisjeve, Kategorive, Furnitorëve dhe Menuve kalon këtu — jo vetëm banderola 8-sekondëshe "zhbëj" e mëparshme. Rikthe çdo element individualisht, brenda 30 ditësh.

🔑 Regjistri i Hyrjeve

Ndryshe nga Regjistri i Aktivitetit më sipër — ky tregon KUSH u fut në llogari, KUR, dhe nga çfarë lloj pajisjeje. E dobishme në rast dyshimi për akses të paautorizuar.

🔒 Privatësia & Pajtueshmëria

Çfarë të dhënash ruhen, ku, sa kohë, dhe si të kërkosh eksport/fshirje — e dukshme për këdo që përdor ChefsTime, jo vetëm zhvilluesin.

📈 Përdorimi i Sotëm

Vetëm për pronarin/manaxherin — s'shfaqet për stafin. Rivendoset vetë çdo ditë.

🩺 Shëndeti i Sistemit

Kontrolle teknike bazë — a funksionon llogaritja e kostos saktë, a jemi lidhur me cloud-in, a ka gabime të regjistruara kohët e fundit. E dobishme për vetë-diagnostikim përpara se të kërkosh ndihmë.

🔖 Versioni & Ndihmë

🆕 Çfarë ka të Re

• 16 Korrik 2026: Kërkim global, dark mode, të preferuarat, Cook Mode, fshirje me rikthim, panel shëndeti të dhënash, analizë ABC, krahasim recetash, konvertues njësish, kalkulator kostoje i shpejtë, tags recetash, bashkim përbërësish të dyfishuar.
• 16 Korrik 2026: Format printimi "Food Bible" për receta/nën-receta, fusha të reja (Kodi, Departamenti, Shelf Life, Standardi i Cilësisë).

🎯 Tur i Shpejtë i App-it

Disa "spotlight" të shkurtra që tregojnë ku ndodhen gjërat kryesore — aktivizohet me dorë, sa herë të duash, nuk shfaqet vetë kurrë.

🏆 Progresi i Profilit të Kuzhinës

Sa e ke plotësuar ende ChefsTime-in me të dhëna reale të restorantit tënd — jo detyrim, thjesht një udhërrëfyes i lehtë.

🎨 Udhëzuesi i Stilit (Style Guide)

Referencë e gjallë e sistemit të dizajnit të ChefsTime — ngjyrat, tipografia, rrezet e cepave dhe butonat aktualë, gjeneruar automatikisht nga vetë app-i, që gjithçka të mbetet konsistente me kohën.

Shkarkon një skedar HTML të pavarur me ngjyrat (hex), fontin dhe logon — për ta dhënë te printeri/dizajneri i jashtëm për menu, banderola, etj.

🔀 Bashko Përbërës të Dyfishuar

Gjen përbërës me emra shumë të ngjashëm (gabime shtypi / dublikatë aksidentale) dhe i lejon t'i bashkosh në një të vetëm — të gjitha recetat që i përdorin përditësohen automatikisht.

🔀 Dublikatë të Zgjeruara (Receta/Sektorë/Furnitorë)

E njëjta kërkim fuzzy si më sipër, por për receta, sektorë dhe furnitorë. Recetat NUK bashkohen automatikisht (vetëm sinjalizohen) — sektorët/furnitorët po, si te përbërësit.

🧹 Listë Pastrimi — Të Dhëna "Jetime"

Referenca drejt përbërësve/recetave/sektorëve që janë fshirë diku tjetër (p.sh. një rresht recete që përdor një përbërës që s'ekziston më).

🔧 Rregullo Përbërës të Fshirë në Receta

Kur fshihet një përbërës, rreshtat e recetave/nën-recetave që e përdornin mbeten pa referencë. Këtu rikuperohet emri origjinal (nga Kosha ose kopja rezervë) dhe sugjerohet zëvendësim me një përbërës aktual — me kod real dhe çmim.

🔍 Sasi të Dyshimta në Receta

Gjen rreshta receta ku sasia e futur duket jashtë shkallës normale për njësinë e vet (p.sh. 5+ kg/lt për një rresht të vetëm, ose nën 0.5 g/ml) — shpesh shenjë e një sasie të shkruar gabimisht ×1000 (kg në vend të gram, apo e kundërta). Çdo rresht ofron ndryshim me 1 klik, mundësi për sasi tjetër, ose "injoro" nëse sasia është vërtet e saktë.

🔁 Referenca Rrethore Recetë↔Nën-recetë

Zbulon nëse një recetë përdor (drejtpërdrejt ose zinxhir) veten si nën-recetë — gjë që prish llogaritjen e kostos.

☁️ Krahasim Lokal-vs-Cloud

Checksum i shpejtë (jo kriptografik) i të dhënave lokale kundrejt cloud-it — zbulim i hershëm devijimesh. Kontrollohet automatikisht çdo ~15 minuta (kur app-i është hapur), ose manualisht këtu.

🎓 Modaliteti Demo

Ngarko disa përbërës e receta shembull për të trajnuar staf të ri, pa prekur të dhënat reale. Të gjitha të dhënat demo janë të etiketuara dhe mund t'i heqësh me një klik.

Të Dhënat

🛟 Kopje Rezervë Automatike & Kthim Prapa

Kjo tani është rrjetë sigurie e menjëhershme — VETËM kopja lokale më e fundit, ruajtur automatikisht 1 çast PARA një veprimi të rrezikshëm (import, bashkim, fshirje totale, rikthim nga cloud). Kopjet periodike/manuale të plota tani shkojnë te "Kopje Rezervë në Cloud" më poshtë, që të mos e mbushin hapësirën e shfletuesit.

☁️ Kopje Rezervë në Cloud

Kopjet lokale (kutia sipër) mbrojnë nga gabime brenda kësaj pajisjeje, por jo nga humbja e vetë llogarisë Supabase. Këto ruhen NË CLOUD, në një tabelë të veçantë nga të dhënat live — automatikisht max 1x/24h, ose manualisht kur të duash. Kërkon një hap teknik një-herësh: krijimin e tabelës "app_state_backups" në Supabase (shih skedarin supabase-setup.sql të dhënë bashkë me app-in).

Çmimet e Përbërësve

Eksporto listën e përbërësve në Excel/CSV, plotëso kolonën "Kosto" me çmimet reale nga furnitori, pastaj ngarkoje sërish këtu — çmimet përditësohen automatikisht te përbërësit me të njëjtin ID ose Emër.

Shënim i sinqertë: ky është një hap-nga-hapi (shkarkon CSV-në, hap Google Sheets, ti bën "Import"), jo një sinkronizim automatik i gjallë. Një "pasqyrë e gjallë" e vërtetë (që përditësohet vetë pa veprim tënd) kërkon një hap teknik shtesë — një Google Cloud OAuth Client ID që duhet krijuar nga vetë llogaria jote Google, diçka që s'mund ta krijoj unë për ty.

🔄 Rillogarit të Gjitha Kostot e Recetave F20: që nga tani, kostot rillogariten VETË sa herë ndryshon çmimi/sasia/humbja e një përbërësi (redaktim i shpejtë, forma e plotë, ngarkim CSV, ngjitje masive). Ky buton mbetet si rrjet sigurie/transparencë — kliko VETËM nëse dyshon se diçka mbeti pa u rifreskuar (p.sh. pas rikuperimi nga një kopje rezervë e vjetër).

🗺️ Ku Jemi Realisht (jo optimizëm, gjendje faktike)

Përmbledhje e sinqertë e gjendjes teknike aktuale — përditësohet manualisht kur ndryshon diçka thelbësore (jo automatike).

📚 Dokumentet Teknike

Lidhje direkte drejt dokumenteve që jetojnë bashkë me kodin (jo brenda vetë app-it) — hapen te dosja e projektit.