Ingredients

The Ingredients module is the foundation of the inventory system.
It manages all raw materials and components used to prepare products (e.g., recipes, menu items).

Index Page

The Ingredients Index Page provides a comprehensive overview of all ingredients used across branches. It displays key details like name, branch, current stock, alert quantity, unit, and cost per unit.
This page helps managers monitor ingredient availability, identify shortages, and maintain stock efficiently.

Filters

• Branch – Filter ingredients by specific branch.
• Unit – Filter by unit type (e.g., Gram, Liter, Bottle).
• From / To – Date range filter based on creation or update date.

Actions

• Create Ingredient – Add a new ingredient to the system.
• Row Actions
  • Edit Ingredient
  • Delete Ingredient
• Bulk Actions
  • Delete Ingredient(s)

CRUD Attributes

Attribute	Description	Required
Name	Ingredient name (translatable)	✅ Yes
Branch	Assign ingredient to a branch	✅ Yes
Unit	Unit of measurement (linked to Units module)	✅ Yes
Cost Per Unit	Define cost for one unit of the ingredient	✅ Yes
Alert Quantity	Minimum stock level to trigger alerts	✅ Yes
Returnable	Determines if ingredient stock is restored when a POS order is refunded	❌ No

Create Page

The Create Ingredient Page allows adding new ingredients with full details.

• Ingredient Information Section
  • Enter ingredient name (multi-language supported).
  • Select branch where the ingredient will be available.
  • Choose unit (mass, volume, count, etc.).
  • Define cost per unit for accurate purchase and sales tracking.
  • Set alert quantity to get low-stock notifications.
  • Enable/disable Choose whether the ingredient is returnable (i.e., refunded stock goes back to inventory or not)

Best Practice: Always set an appropriate alert quantity to avoid stockouts.

Edit Page

The Edit Ingredient Page is used to update existing ingredient details.

• Editable Fields
  • Update name for localization or corrections.
  • Change unit if measurement type changes (ensure consistent reporting).
  • Modify cost per unit to reflect new supplier pricing.
  • Adjust alert quantity for improved stock management.
  • Toggle returnable option based on supplier agreements.

⚠️ Note: Changing unit type or cost per unit may affect cost calculations, recipes, and reports. Update with caution.