MODULE DEPENDENCY AND ARCHITECTURE

RMS is built as an addon over Agile Codex Magento 2 Web POS. Web POS can run as a standalone POS module, while RMS depends on Web POS and adds restaurant-specific workflows.

• Web POS Base: Handles POS cart, checkout, customer, payment, and product sync workflow.
• RMS Addon: Adds table, waiter, kitchen, service, and restaurant order metadata features.
• Magento Order Flow: Restaurant orders are still created through Magento/Web POS sales order flow.
• No Sales Order Duplication: RMS stores restaurant metadata and links it with Magento order data.

INSTALLATION AND SETUP

Install the RMS module after installing and enabling Agile Codex Magento 2 Web POS. RMS should be installed as an addon module because it uses the Web POS frontend, product sync, checkout, and order placement workflow.

• Install Web POS First: Confirm Web POS is installed and working.
• Install RMS Addon: Add the Acx_Rms module to Magento.
• Run Setup Upgrade: Execute Magento setup upgrade and dependency compilation.
• Flush Cache: Clear Magento cache and deploy static content if needed.

RMS STORE AND RESTAURANT MENU SETUP

For a clean RMS demo or restaurant workflow, create a dedicated RMS store view or website and assign restaurant menu products under an RMS root category.

• RMS Store View: Use a dedicated store view for the restaurant POS demo.
• RMS Root Category: Create a root or parent category for restaurant menu items.
• Restaurant Products: Assign only restaurant menu items to the RMS category tree.
• Product Sync Filter: Use POS Product Sync Filter to sync only RMS category products.
• Separate Demo URL: A separate subdomain helps avoid browser IndexedDB conflicts with normal Web POS.

TABLE ZONES AND TABLE MANAGEMENT

Table zones and restaurant tables can be managed from Magento admin. These records are used during dine-in order placement and waiter service workflow.

• Table Zones: Create areas such as Main Hall, Patio, VIP Room, or Branch-specific zones.
• Restaurant Tables: Add table number, name, capacity, zone, and status.
• Table Status: Track table availability, occupied status, or service completion.
• Dine-in Flow: Select a table when placing a dine-in order from RMS checkout.

WAITER MANAGEMENT

Waiters can be managed from the RMS admin section and assigned during POS checkout or service workflow. This helps restaurant staff track who is handling each order.

• Waiter Records: Add waiter name, phone, email, shift, and status.
• Order Assignment: Assign waiter to dine-in or restaurant service orders.
• Ready Order Handling: Waiters can process ready orders from the RMS frontend.
• Service Status: Track picked up, served, and completed service states.

RMS CHECKOUT PANEL

The Restaurant Order panel appears on the RMS frontend checkout. It allows staff to add restaurant-specific details before placing a POS order.

• Order Type: Choose Dine-in, Takeaway, or Delivery.
• Table Selection: Select a table for dine-in orders.
• Waiter Assignment: Assign a waiter to the order.
• Guest Count: Enter the number of guests.
• RMS Note: Add restaurant order notes when needed.

RMS METADATA IN MAGENTO ORDER

After an RMS order is placed through Web POS, RMS metadata is linked with the Magento sales order. Admin users can review restaurant information from the Magento order view.

• Sales Order Link: RMS metadata is linked with sales_order.entity_id.
• Quote Link: RMS metadata can also track the quote_id used before order creation.
• Restaurant Order Tab: View order type, table, waiter, guest count, status, and notes.
• Clean Data Storage: Magento sales/order data remains in Magento; RMS stores restaurant metadata.

KITCHEN QUEUE

The kitchen queue helps chefs see restaurant orders that need preparation. Kitchen staff can update order preparation status as the order moves through the kitchen workflow.

• New Orders: New dine-in, takeaway, and delivery orders appear in the queue.
• Accepted: Chef can accept an order for preparation.
• Preparing: Chef can mark the order as being prepared.
• Ready: Chef can mark the order ready for waiter pickup or delivery handling.
• Status History: Kitchen status changes are saved for traceability.

KITCHEN TICKETS AND TICKET ITEMS

Kitchen tickets are created from restaurant orders and ticket items can be generated from Magento sales order items. This helps kitchen staff understand what needs to be prepared.

• Kitchen Ticket: Created for RMS orders linked with Magento sales orders.
• Ticket Items: Generated from sales order item data.
• Kitchen Status: Ticket status follows the kitchen workflow.
• Duplicate Protection: Existing tickets and ticket items are updated instead of duplicated.

WAITER READY-ORDER SCREEN

The waiter screen helps service staff view kitchen-ready orders and update the service workflow after an order leaves the kitchen.

• Ready Orders: Waiter sees orders where kitchen status is ready.
• Picked Up: Mark the order as picked up from the kitchen.
• Served: Mark the order as served to the customer.
• Completed: Complete the service workflow and update table status.
• Table Status Update: Dine-in tables can become available after completion.

SYNCHRONIZATION DATA

RMS uses Web POS-style synchronization for setup data and selected workflow data. This helps the RMS frontend load tables, waiters, bookings, and kitchen orders efficiently.

• RMS Table Zones: Sync table zone records to the frontend.
• RMS Tables: Sync restaurant table records.
• RMS Waiters: Sync waiter records for checkout and service workflows.
• RMS Bookings: Sync booking or reservation data where needed.
• RMS Kitchen Orders: Sync kitchen queue data for frontend workflow visibility.

RESTAURANT REPORTS

RMS reports help restaurant managers review order activity, table usage, waiter performance, kitchen status, and sales totals linked with Magento order data.

• Order Type Report: Review dine-in, takeaway, and delivery order activity.
• Table Report: View restaurant order activity by table.
• Waiter Report: Review waiter-assigned restaurant orders.
• Kitchen Status Report: Understand kitchen workflow by status.
• Magento Order Totals: Link RMS report data with Magento sales order totals.

ADMIN CONFIGURATION

RMS admin configuration and menu sections help administrators manage restaurant setup data, workflow screens, and reporting from Magento admin.

• Restaurant Management Menu: Access RMS tables, waiters, bookings, kitchen queue, orders, and reports.
• Product Sync Filter: Configure restaurant menu product synchronization using store/category filters.
• Frontend Demo Store: Use a dedicated store view or demo URL for RMS frontend workflow.
• Role Access: Give RMS frontend kitchen/waiter screens to permitted POS/admin users.