Pamamahala ng Menu

Ang Menu tab sa ilalim ng Kapeterya ang lugar kung saan mo binubuo ang catalog na nakikita ng customer sa handy.cafe/{slug}. Binubuo ang menu ng mga category at product. Ang mga product ay maaaring may variant group para sa mga pagpipilian tulad ng Size o Toppings.

Estruktura

Antas	Gamit
Category	Bahagi ng menu, halimbawa "Hot Drinks" o "Burgers". May icon at sort order ang bawat category.
Product	Isang item na maaaring i-order sa loob ng category. May pangalan, description, larawan, presyo, VAT rate, at preparation time ito.
Variant Group	Opsyonal. Isang set ng pagpipilian na naka-attach sa product, halimbawa "Size: Small, Medium, Large". May dagdag o bawas na presyo ang bawat variant.

Mga Category

May mga sumusunod na field ang bawat category:

Field	Kahulugan
Name	Ipinapakita bilang heading ng seksyon sa customer menu.
Icon	Pangalan ng MDI (Material Design Icons). Pumili mula sa icon picker.
Sort Order	Integer. Ang mas mababang numero ay nauna. Maaaring ayusin gamit ang drag o move-up at move-down controls.
Active	Kapag naka-off, nakatago ang category at lahat ng product nito sa customer menu pero hindi binubura.

Pagdagdag ng Category

Buksan ang Kapeterya > Menu.
I-click ang Add Category.
Maglagay ng pangalan.
I-click ang icon box at pumili ng MDI icon. Magbubukas ang picker na may searchable list. Subukan ang mga keyword tulad ng "coffee", "burger", o "pizza".
I-save. Lalabas ang category sa menu editor.

Pag-aayos ng Pagkakasunod ng Category

I-drag ang handle sa row ng category para ilipat ito. Naka-save ang bagong posisyon kapag binitiwan mo ang mouse. Maaari mo ring gamitin ang move-up at move-down arrows para sa eksaktong puwesto.

Soft Delete

Ang pag-delete ng category na may dependent products ay nagma-mark lamang ng category bilang inactive sa halip na tanggalin ang record. Pinapanatili nito ang order history na tumutukoy sa orihinal na product IDs. Para ibalik, i-enable muli ang category mula sa admin UI.

Mga Product

May mga sumusunod na field ang bawat product:

Field	Kahulugan
Category	Ang parent category.
Name	Nakikita ng customer.
Description	Suportado ang Markdown. Lumalabas ito sa product detail sheet kapag tinap ng customer ang item.
Ingredients	Maikling linya sa ilalim ng description. Gamitin ito para sa allergens o ingredient highlights.
Base Price	Presyo bago ang variants. Naka-store sa minor units (halimbawa cents) pero inilalagay sa buong yunit ng currency.
VAT Rate	Porsyento. Inilalapat kapag ipinapakita ang totals sa customer receipt.
Unit	Opsyonal na label tulad ng "ml" o "g". Lumalabas sa tabi ng presyo.
Photo	Larawan ng product. Tinatanggap ang anumang format. Inirerekomenda ang WebP hanggang 2 MB para sa pinakamabilis na pag-load ng menu.
Track Stock	Kapag naka-on, may in-stock quantity ang product na nababawas sa bawat order.
In Stock	Kasalukuyang stock count. Bumabagsak ang order para sa customer kapag umabot sa zero ang stock at awtomatikong nagtatago ang product.
Active	Kapag naka-off, nakatago ang product sa customer menu.
Sort Order	Puwesto sa loob ng category.
Preparation Time	Static fallback estimate sa minuto. Tingnan ang Dynamic Preparation Time sa ibaba.

Pag-upload ng Larawan

Buksan ang product.
I-click ang photo area.
Pumili ng larawan mula sa iyong computer. Tinatanggap ng upload endpoint ang anumang format.
Pinoproseso ng server ang file, nag-i-store ng asset ID, MIME type, at checksum, at nagbabalik ng URL.
Lumalabas agad ang larawan sa editor at sa customer menu sa loob ng ilang segundo.

Palitan ang larawan sa pamamagitan ng pag-click sa kasalukuyang image at pag-upload ng bagong file. Pinapalitan na ng bago ang luma.

Markdown sa mga Description

Suportado ng product description ang Markdown. Karaniwang gamit:

Bold highlight gamit ang **strong**.
Line breaks para sa multi-line description.
Maiikling listahan para sa ingredients o pairing.

Iwasan ang headings (H1 hanggang H6) sa product description. Ipinapakita ng customer menu ang description sa limitadong sheet at mukhang hindi maayos ang headings.

Mga Variant Group

Ang variants ay kumakatawan sa pagpili ng customer na nagbabago sa presyo o configuration. Maaaring may maraming variant group ang isang product, halimbawa Size at Toppings sa iisang burger.

May mga sumusunod na field ang bawat variant:

Field	Kahulugan
Name	Label na nakikita ng customer, halimbawa "Size" o "Extra Cheese".
Price Delta	Halagang idinadagdag sa base price kapag pinili ang variant. Maaari itong zero o negative.
Required	Kapag naka-on, kailangang pumili ang customer ng kahit isang variant mula sa group na ito bago idagdag sa cart.
Sort Order	Puwesto sa loob ng group.

Paglikha ng Variant Group

Buksan ang product.
I-scroll sa Variants section.
I-click ang Add Variant.
Ilagay ang pangalan at price delta. I-enable ang Required kung mandatory ang pagpili.
I-save.

Ulitin para sa bawat option sa group. Ang karaniwang "Size" group ay may tatlong row: Small na delta 0, Medium na delta +1.00, at Large na delta +2.00.

Dynamic Preparation Time

Kayang kalkulahin ng HandyCafe ang real-time na pagtataya ng preparation time para sa bawat product batay sa aktwal na performance ng kitchen. Mas tumpak nitong naipapakita ang estimate chip sa customer menu at sa active orders.

Setting	Epekto
Static Time	Naka-store sa product. Ginagamit kapag kulang pa ang history para makalkula ang dynamic value.
Dynamic Estimate	Kinukuwenta mula sa huling 30 araw ng order history. Ang average na preparation time ng produkto ay minumultiply sa busy-factor na hinango mula sa kasalukuyang haba ng pila. Naka-clamp ang multiplier sa pagitan ng 1.0 at 2.0. Ang final value ay naka-clamp sa pagitan ng 1 at 120 minuto.

Kinokontrol ng setting na "Show Prep Time on Menu" sa business profile kung makikita ng customer ang estimate chip. Palaging nakikita ng staff ang estimate sa Orders dashboard.

Stock Tracking

I-enable ang Track Stock per product para maiwasang makapagbenta ng item na ubos na.

Kapag may order na nailagay, nababawasan ang stock count ayon sa dami ng na-order.
Kapag umabot sa zero ang stock, awtomatikong nagtatago ang product sa customer menu hanggang i-update mo ang count.
Para mag-restock, i-edit ang product at ilagay ang bagong In Stock value.

Ang mga product na walang Track Stock ay kumikilos na parang walang limitasyong inventory at hindi awtomatikong nagtatago.

Pag-aayos ng Product sa Loob ng Category

I-drag ang handle para i-move pataas o pababa ang product. Naka-save ang bagong sort order kapag binitiwan mo ang handle. Maa-update ang customer menu sa susunod na menu refresh, na nangyayari sa bawat session load.

Mga Tip

Magsimula sa 6 hanggang 10 category. Kapag sobrang dami ng category, bumabagal ang pag-browse ng customer menu.
Gumamit ng mataas na contrast at maliwanag na mga larawan. Ang dim o maingay na larawan ay nagpapababa ng order conversion.
Panatilihing mas maikli sa 120 character ang description kung maaari. Ang mahahabang description ay nagtutulak sa Add to Cart button palabas ng unang screen sa telepono.
Magtakda ng makatotohanang static preparation times. Ang dynamic system ay nangangailangan ng 30 araw para matuto. Hanggang doon, ang static number ang makikita ng customer.
Para sa mga item na maraming pagpipilian, hatiin ang mga ito sa dalawang variant group imbes na isang napakahabang listahan. Mas malinaw ang "Size" plus "Milk" kaysa "Size with Milk".