ZResto connects all restaurant and cafe departments in a single real-time workflow. When a customer places an order (via the Cashier or by scanning the table's QR Code), the order is instantly routed to the Kitchen Display System (KDS). Upon payment, the system automatically deducts raw ingredients from inventory based on the meal's Recipe (Bill of Materials - BOM), updates the cashier shift drawer, records net profit, and awards customer loyalty points simultaneously.

Quick Role Guide: Who Uses What?

When you open ZResto in your browser, you are greeted by the secure sign-in screen.

Step-by-Step Login Instructions:

1. Enter your Username / Email in the first field (e.g., [email protected] or your cashier account).
2. Enter your Password in the second field. Click the Eye icon to reveal and verify the password if needed.
3. Click the blue Sign In (تسجيل الدخول) button to access the workspace assigned to your role.

Upon logging in as an Administrator, the Dashboard provides an instant, comprehensive overview of your restaurant's financial and operational health, powered by the Smart Analytics Engine.

Key Dashboard Indicators & Widgets:

• Quick Action Bar (Top): One-click shortcuts for daily tasks: Open POS (فتح الكاشير), Daily Report (تقرير اليوم), Add Product (إضافة منتج), Purchase Invoice (فاتورة شراء), Shifts Report (تقرير الشيفتات), and Customers (العملاء).
• Daily Financial KPI Cards:
  • Today's Sales: Total revenue generated today, percentage growth compared to yesterday, and total invoice count.
  • Estimated Net Profit: Real net profit after deducting cost of goods sold (COGS) and today's operating expenses.
  • Today's Expenses: Total operating payouts recorded today (utilities, maintenance, supplies).
  • Critical Stock: Number of menu items or raw materials that have reached or fallen below their reorder threshold.
• Smart Operational Insights: Highlights Today's Peak Hour, Fastest-Selling Product, Inventory Turnover Rate, and Average Ticket Size.
• Interactive Charts & Low-Stock Alerts: 7-day sales trend, hourly sales distribution, payment method breakdown, top 5 best-sellers, and an actionable low-stock alert table.

The Restaurant POS screen is the operational heart of ZResto. It unifies the visual menu, order cart, interactive floor plan, open orders manager, and Kitchen Display System (KDS) into a single, ultra-fast workspace without page reloads.

Step-by-Step: Creating a Dine-in Order:

1. From the top bar of the Restaurant POS, select the Dine-in (صالة) order mode.
2. Click the Tables (الطاولات) tab to view the live floor plan across all zones (Main Hall, Terrace, VIP).
3. Available tables appear in Green (Available), while occupied tables appear in Red (Occupied) with their active order number.
4. Click the desired table (e.g., T-01) to link the order to that table.
5. Browse menu categories (Meals, Offers, Add-ons, Burgers, Grills, Pizza...) or search by name/code in Search item by name or code....
6. Click any meal card to add it to the order cart, and use the + and - side buttons to adjust quantities.
7. To add a preparation note for the chef (e.g., Well-done kebab + no chili), click the item in the cart and enter your note.
8. Click the blue Save (حفظ) button to send the order directly to the Kitchen Display System (KDS) and category printer.

Step-by-Step: Creating a Delivery Order:

1. Click the Delivery (ديليفري) button in the top bar to open the Delivery Customer Details modal.
2. Enter the customer's Mobile Number; if the customer is already registered, their name and saved addresses load automatically.
3. For a new customer, fill in the Name, Area/District, Street, Building, Floor, Apartment, Landmark, and Delivery Fee, then click Confirm Details (تأكيد البيانات).
4. Add the requested meals to the cart and save the order to dispatch it to the kitchen.

• 1. Cashier Open Orders (كاشير الطلبات): Displays all ongoing orders in one dashboard, filterable by type (All, Dine-in, Takeaway, Delivery). Each card shows the order number, table/customer name, item preparation status, and total amount, with quick buttons to load the order into the cart, print a pre-check, or settle payment immediately.
• 2. Smart Kitchen Display System (المطبخ KDS): Mounted in the kitchen for chefs. New orders arrive with an audio chime and a live elapsed preparation timer that changes color if an order exceeds standard prep time. Customer notes are highlighted clearly below each dish. Chefs tap Ready (جاهز) per item or for the entire ticket to notify waiters, then tap Served (تم التسليم) once picked up.
• 3. Customer QR Requests & Voice Announcements (طلبات العملاء QR): When a dine-in guest scans the table's QR code, the top alert badge lights up and the system speaks a clear Arabic voice announcement (e.g., announcing a table requesting the bill or calling a waiter). The modal lists Waiter Calls, Bill Requests, and New Mobile Orders that can be accepted and sent to the kitchen with one click.

A. Step-by-Step: Completing Payment & Multi-Currency (الدفع والطباعة):

1. With the order loaded in the cart, click the green Pay & Print (الدفع والطباعة) button at the bottom.
2. The Checkout Modal displays the full breakdown (Subtotal, Discount, VAT, Service/Delivery Charge, and Grand Total).
3. Select the payment method: Cash (with automatic change calculation), Card (Visa/MasterCard), Mixed Payment (Cash + Card), or Credit (On Account) for registered customers.
4. Foreign Currency Payment (Optional): Select a foreign currency (e.g., USD, SAR) to automatically convert the total amount using the configured exchange rate.
5. Click Confirm Payment & Print to close the check, free the table back to green (Available), and print the thermal receipt.

B. Split Check, Table Transfer/Merge & Quick Returns:

• Split Check (Scissors Icon ✂️): Select specific items/quantities to move to a sub-bill on the left; the system proportionally calculates taxes and service charges so each guest can pay their share separately.
• Transfer Table (⇄): Moves the entire active check from the current table to another available table.
• Merge Tables: Combines two occupied tables into a single unified bill and releases the secondary table.
• Quick Return: Search by invoice number directly from the POS, select the returned items/quantities and return reason, and confirm to refund the customer.

1. Tables Management, Reservations & QR Stickers (Restaurant > Tables)

• Add a New Table: Click + Add Table (+ إضافة طاولة), specify the table name/number (e.g., T-10), seating capacity, and zone (Main Hall, Outdoor Terrace, Family Section, VIP).
• Print Table QR Codes: Click the QR button next to any table to print its unique QR stand/sticker, or click Print All QR to batch-print QR codes for all tables at once.
• Table Reservations: Record advance bookings with the guest's name, phone number, and arrival time so the table appears in Yellow (Reserved) on the POS map.

2. Interactive Floor Plan Designer (Floor Plan تخطيط الصالة)

1. From the Tables screen, click Floor Plan (تخطيط الصالة) and choose the zone (Main Hall, Terrace, VIP).
2. Drag and Drop each table onto the visual grid to mirror your real-world dining room layout, and customize table shapes (Round, Square, Rectangle) and dimensions.
3. Click Save Layout (حفظ التخطيط) to immediately update the live map for all cashiers and waiters.

3. Customer Mobile QR Digital Menu (QR Digital Menu)

When a guest scans the table's QR code with their smartphone camera (no app download required), an interactive mobile menu opens automatically linked to their table number (e.g., Table T-02). Guests can browse illustrated dishes and send orders directly to the POS, tap the Bell icon to call a waiter, tap the Receipt icon to request the bill, or book a future reservation.

The Recipes (BOM) module is the key to strict Food Cost control and automated kitchen inventory deduction.

Step-by-Step: Linking a Menu Dish to Its Raw Ingredients:

1. From the sidebar, navigate to Recipes / BOM (الوصفات والمكونات).
2. Select the finished menu item (e.g., Royal Mixed Grill or Double Angus Burger).
3. Add each Raw Material from inventory (e.g., Fresh Ground Angus Beef, Chicken Breast Fillet, Basmati Rice, Shredded Mozzarella) along with the exact Quantity Consumed per serving and any natural wastage percentage.
4. The system immediately calculates the Actual Recipe Cost, compares it against the selling price, and displays the exact Profit Margin (Currency & %).

• Categories & Kitchen Printer Routing (Categories الأقسام): Assign each category (Grills, Pizza Oven, Cafe Bar) to its dedicated thermal kitchen printer so multi-category orders split and print at the right station automatically.
• Product Configuration (Products المنتجات): Set bilingual names, barcode, cost/sale price, dish photo, Kitchen Prep Time (minutes) for KDS alerts, or mark the item as a Raw Material (hidden from the POS menu and used exclusively in Recipes and Purchases).
• Bulk Quick Price Editor (تعديل سريع للأسعار): Update purchase and selling prices across dozens of items in a single spreadsheet-style grid and save with one click.
• Barcode Label Printing (طباعة الباركود): Select packaged items, choose label dimensions and copies, preview the thermal sticker layout, and print directly.

Alongside the Restaurant POS, ZResto includes a high-speed Barcode Retail POS ideal for bakeries, grab-and-go pastry counters, and supermarkets, complete with dual-screen Customer Display support.

• Barcode Scanner & Electronic Scale Integration: Instantly scans standard product barcodes as well as weight/price-embedded scale barcodes (prefixes 20–29).
• Hold & Recall Invoices (Hold Bill تعليق الفاتورة): Put a customer's cart on hold to serve the next person in line, then restore it with one click.
• Customer-Facing Display: Opens a dedicated secondary screen showing the customer their scanned items, discounts, and live total in real time.

Step-by-Step Shift Lifecycle (Open → Operate → Close & Reconcile):

1. Open a New Shift: At the start of a shift, the cashier navigates to Shifts > Open Shift and enters the Opening Cash Float in the drawer.
2. During the Shift: Every cash sale, card payment, return refund, and petty cash expense is automatically tracked against the active shift.
3. Close Shift: At the end of the shift, the cashier counts the physical cash in the drawer and enters the Actual Closing Cash amount.
4. Z-Report Generation (Z-Report): The system calculates Expected Cash (Opening Float + Cash Sales − Cash Returns − Cash Expenses), compares it against Actual Cash to flag any Shortage or Overage, and breaks down revenue by category and payment method for thermal printing and sign-off.

• Branches & Warehouses (Warehouses الفروع والمخازن): Define unlimited branches and storage locations (e.g., New Cairo Main Branch, Sheikh Zayed Branch, Central Kitchen). Click View Stock (عرض المخزون) to inspect item quantities and total valuation at cost and retail.
• Physical Stock Take (Stock Take الجرد المخزني): Open a stock count sheet, enter the Actual Counted Quantity per item, review the automatically calculated variance (shortage/surplus) and financial impact, and click Approve & Reconcile to update stock balances automatically.
• Inter-Branch Stock Transfers (Stock Transfers تحويلات المخزون): Transfer raw materials or products from the Central Warehouse to any branch with a formal transfer voucher that deducts from the source and adds to the destination instantaneously.

• Suppliers & Account Statements (Suppliers الموردين): Click Statement (كشف حساب) next to any supplier to view total purchases, total payments, remaining balance, and a chronological ledger, plus a form to record new Supplier Payment Vouchers.
• Purchase Orders & Purchase Invoices (أوامر الشراء / فواتير الشراء): Issue draft Purchase Orders to vendors and convert them into Purchase Invoices upon delivery to automatically increase warehouse quantities, recalculate weighted average cost, and update supplier balances.
• Daily Expenses (Expenses المصروفات): Log daily operational expenses (electricity, gas, rent, kitchen maintenance) by category so they are automatically deducted when calculating net profit.

• Customers & Loyalty Program (Customers العملاء): Maintains complete customer profiles including delivery addresses, purchase history, Loyalty Points Balance (redeemable for instant discounts at checkout), and credit account limits.
• Coupons & Automated Promotions (الكوبونات / العروض الترويجية): Create promo codes (percentage or fixed discount with minimum order rules and expiry dates) or automated Buy X Get Y deals.
• Sale Returns & Exchanges (Sale Returns مرتجعات المبيعات): Complete audit trail of all returned invoices, return reasons, refund methods, and printable return receipts.

• Reports Hub & AI Smart Forecasting (مركز التقارير): Analyzes daily consumption velocity for every product, predicts the exact number of days until stockout, and recommends the Optimal Reorder Quantity for the coming week.
• Daily Summary Report (ملخص اليوم): A single-page executive summary of total sales, invoice count, COGS, expenses, Final Net Profit, payment breakdown, and top-performing dishes.
• Kitchen Order Timings Report (أوقات التحضير): Measures average kitchen preparation time and delivery turnaround per order to identify and resolve kitchen bottlenecks.
• Additional Specialized Reports: Itemized Profit Report, Cashier Performance Report, Monthly Tax Return (VAT), and Multi-Branch Comparison, all exportable to Excel.

• General System Settings (Settings الإعدادات): Configure restaurant branding, receipt header/footer, VAT percentage,foreign currency exchange rates, loyalty point rules, and units of measure.
• Users, Roles & Granular Permissions (Users / Roles): Create staff accounts, assign functional roles (Admin, Cashier, Waiter, Kitchen, Accountant), and set quick-lock PIN codes.
• Security Audit Logs (Audit Logs سجل المراجعة): A tamper-evident black box recording every sensitive action (price changes, deletions, stock adjustments, shift closures, returns) with the user, exact timestamp, IP address, and before/after values.
• Database Backups (Backup النسخ الاحتياطي): Create an instant full database backup with one click, download backup files to external storage, or restore a previous backup at any time.