clover_sandbox_simulator 1.0.0

data/lib/clover_sandbox_simulator/data/restaurant/items.json

@@ -0,0 +1,238 @@
+{
+  "items": [
+    {
+      "name": "Buffalo Wings",
+      "price": 1299,
+      "category": "Appetizers",
+      "description": "Crispy wings tossed in buffalo sauce"
+    },
+    {
+      "name": "Loaded Nachos",
+      "price": 1099,
+      "category": "Appetizers",
+      "description": "Tortilla chips with cheese, jalapeños, and salsa"
+    },
+    {
+      "name": "Mozzarella Sticks",
+      "price": 899,
+      "category": "Appetizers",
+      "description": "Golden fried with marinara sauce"
+    },
+    {
+      "name": "Spinach Artichoke Dip",
+      "price": 1199,
+      "category": "Appetizers",
+      "description": "Creamy dip with tortilla chips"
+    },
+    {
+      "name": "Calamari",
+      "price": 1399,
+      "category": "Appetizers",
+      "description": "Lightly fried with aioli"
+    },
+    {
+      "name": "Classic Burger",
+      "price": 1499,
+      "category": "Entrees",
+      "description": "8oz beef patty with lettuce, tomato, onion"
+    },
+    {
+      "name": "Bacon Cheeseburger",
+      "price": 1699,
+      "category": "Entrees",
+      "description": "Burger with bacon and cheddar"
+    },
+    {
+      "name": "Grilled Salmon",
+      "price": 2199,
+      "category": "Entrees",
+      "description": "Atlantic salmon with lemon herb butter"
+    },
+    {
+      "name": "NY Strip Steak",
+      "price": 2899,
+      "category": "Entrees",
+      "description": "12oz steak cooked to order"
+    },
+    {
+      "name": "Chicken Parmesan",
+      "price": 1899,
+      "category": "Entrees",
+      "description": "Breaded chicken with marinara and mozzarella"
+    },
+    {
+      "name": "Fettuccine Alfredo",
+      "price": 1599,
+      "category": "Entrees",
+      "description": "Creamy parmesan sauce over pasta"
+    },
+    {
+      "name": "Fish and Chips",
+      "price": 1699,
+      "category": "Entrees",
+      "description": "Beer-battered cod with fries"
+    },
+    {
+      "name": "BBQ Ribs",
+      "price": 2399,
+      "category": "Entrees",
+      "description": "Full rack with house BBQ sauce"
+    },
+    {
+      "name": "Caesar Salad",
+      "price": 1199,
+      "category": "Entrees",
+      "description": "Romaine, parmesan, croutons"
+    },
+    {
+      "name": "Grilled Chicken Salad",
+      "price": 1399,
+      "category": "Entrees",
+      "description": "Mixed greens with grilled chicken"
+    },
+    {
+      "name": "French Fries",
+      "price": 499,
+      "category": "Sides",
+      "description": "Crispy golden fries"
+    },
+    {
+      "name": "Sweet Potato Fries",
+      "price": 599,
+      "category": "Sides",
+      "description": "With honey drizzle"
+    },
+    {
+      "name": "Onion Rings",
+      "price": 549,
+      "category": "Sides",
+      "description": "Beer-battered and fried"
+    },
+    {
+      "name": "Coleslaw",
+      "price": 399,
+      "category": "Sides",
+      "description": "Creamy house-made coleslaw"
+    },
+    {
+      "name": "Mashed Potatoes",
+      "price": 499,
+      "category": "Sides",
+      "description": "Creamy with gravy"
+    },
+    {
+      "name": "Steamed Vegetables",
+      "price": 449,
+      "category": "Sides",
+      "description": "Seasonal vegetables"
+    },
+    {
+      "name": "Chocolate Brownie",
+      "price": 699,
+      "category": "Desserts",
+      "description": "Warm brownie with ice cream"
+    },
+    {
+      "name": "New York Cheesecake",
+      "price": 799,
+      "category": "Desserts",
+      "description": "Classic creamy cheesecake"
+    },
+    {
+      "name": "Apple Pie",
+      "price": 749,
+      "category": "Desserts",
+      "description": "A la mode with vanilla ice cream"
+    },
+    {
+      "name": "Tiramisu",
+      "price": 899,
+      "category": "Desserts",
+      "description": "Italian coffee-flavored dessert"
+    },
+    {
+      "name": "Soft Drink",
+      "price": 299,
+      "category": "Drinks",
+      "description": "Coke, Sprite, Dr Pepper"
+    },
+    {
+      "name": "Iced Tea",
+      "price": 299,
+      "category": "Drinks",
+      "description": "Fresh brewed, sweetened or unsweetened"
+    },
+    {
+      "name": "Lemonade",
+      "price": 349,
+      "category": "Drinks",
+      "description": "Fresh squeezed lemonade"
+    },
+    {
+      "name": "Coffee",
+      "price": 349,
+      "category": "Drinks",
+      "description": "Regular or decaf"
+    },
+    {
+      "name": "Hot Tea",
+      "price": 299,
+      "category": "Drinks",
+      "description": "Assorted flavors"
+    },
+    {
+      "name": "Draft Beer",
+      "price": 599,
+      "category": "Alcoholic Beverages",
+      "description": "Rotating selection of craft beers"
+    },
+    {
+      "name": "Domestic Beer",
+      "price": 499,
+      "category": "Alcoholic Beverages",
+      "description": "Bud Light, Coors, Miller"
+    },
+    {
+      "name": "Import Beer",
+      "price": 649,
+      "category": "Alcoholic Beverages",
+      "description": "Corona, Heineken, Guinness"
+    },
+    {
+      "name": "House Wine",
+      "price": 799,
+      "category": "Alcoholic Beverages",
+      "description": "Red or white by the glass"
+    },
+    {
+      "name": "Premium Wine",
+      "price": 1199,
+      "category": "Alcoholic Beverages",
+      "description": "Cabernet, Chardonnay, Pinot Noir"
+    },
+    {
+      "name": "Margarita",
+      "price": 999,
+      "category": "Alcoholic Beverages",
+      "description": "House or frozen"
+    },
+    {
+      "name": "Long Island Iced Tea",
+      "price": 1099,
+      "category": "Alcoholic Beverages",
+      "description": "Classic cocktail"
+    },
+    {
+      "name": "Chef's Special",
+      "price": 2499,
+      "category": "Specials",
+      "description": "Ask your server for today's special"
+    },
+    {
+      "name": "Soup of the Day",
+      "price": 599,
+      "category": "Specials",
+      "description": "Fresh made daily"
+    }
+  ]
+}

data/lib/clover_sandbox_simulator/data/restaurant/modifiers.json

@@ -0,0 +1,62 @@
+{
+  "modifier_groups": [
+    {
+      "name": "Temperature",
+      "min_required": 0,
+      "max_allowed": 1,
+      "modifiers": [
+        { "name": "Rare", "price": 0 },
+        { "name": "Medium Rare", "price": 0 },
+        { "name": "Medium", "price": 0 },
+        { "name": "Medium Well", "price": 0 },
+        { "name": "Well Done", "price": 0 }
+      ]
+    },
+    {
+      "name": "Add-Ons",
+      "min_required": 0,
+      "max_allowed": 5,
+      "modifiers": [
+        { "name": "Extra Cheese", "price": 150 },
+        { "name": "Bacon", "price": 200 },
+        { "name": "Avocado", "price": 175 },
+        { "name": "Fried Egg", "price": 125 },
+        { "name": "Jalapeños", "price": 75 }
+      ]
+    },
+    {
+      "name": "Side Choice",
+      "min_required": 1,
+      "max_allowed": 1,
+      "modifiers": [
+        { "name": "French Fries", "price": 0 },
+        { "name": "Sweet Potato Fries", "price": 100 },
+        { "name": "Onion Rings", "price": 100 },
+        { "name": "Side Salad", "price": 0 },
+        { "name": "Coleslaw", "price": 0 }
+      ]
+    },
+    {
+      "name": "Dressing",
+      "min_required": 0,
+      "max_allowed": 1,
+      "modifiers": [
+        { "name": "Ranch", "price": 0 },
+        { "name": "Blue Cheese", "price": 0 },
+        { "name": "Caesar", "price": 0 },
+        { "name": "Balsamic Vinaigrette", "price": 0 },
+        { "name": "Honey Mustard", "price": 0 }
+      ]
+    },
+    {
+      "name": "Drink Size",
+      "min_required": 1,
+      "max_allowed": 1,
+      "modifiers": [
+        { "name": "Small", "price": 0 },
+        { "name": "Medium", "price": 50 },
+        { "name": "Large", "price": 100 }
+      ]
+    }
+  ]
+}

data/lib/clover_sandbox_simulator/data/restaurant/tenders.json

@@ -0,0 +1,41 @@
+{
+  "tenders": [
+    {
+      "label": "Cash",
+      "label_key": "com.clover.tender.cash",
+      "opens_cash_drawer": true,
+      "weight": 30
+    },
+    {
+      "label": "Check",
+      "label_key": "com.clover.tender.check",
+      "opens_cash_drawer": true,
+      "weight": 5
+    },
+    {
+      "label": "Gift Card",
+      "label_key": "com.clover.tender.external_gift_card",
+      "opens_cash_drawer": false,
+      "weight": 15
+    },
+    {
+      "label": "External Payment",
+      "label_key": "com.clover.tender.external_payment",
+      "opens_cash_drawer": false,
+      "weight": 10
+    },
+    {
+      "label": "Mobile Payment",
+      "label_key": "com.clover.tender.mobile_payment",
+      "opens_cash_drawer": false,
+      "weight": 20
+    },
+    {
+      "label": "Store Credit",
+      "label_key": "com.clover.tender.store_credit",
+      "opens_cash_drawer": false,
+      "weight": 10
+    }
+  ],
+  "note": "Credit Card and Debit Card are intentionally excluded - they are broken in Clover sandbox"
+}

data/lib/clover_sandbox_simulator/generators/data_loader.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module CloverSandboxSimulator
+  module Generators
+    # Loads data from JSON files for different business types
+    class DataLoader
+      attr_reader :business_type
+
+      def initialize(business_type: :restaurant)
+        @business_type = business_type
+      end
+
+      def categories
+        @categories ||= load_json("categories")["categories"]
+      end
+
+      def items
+        @items ||= load_json("items")["items"]
+      end
+
+      def discounts
+        @discounts ||= load_json("discounts")["discounts"]
+      end
+
+      def tenders
+        @tenders ||= load_json("tenders")["tenders"]
+      end
+
+      def modifiers
+        @modifiers ||= load_json("modifiers")["modifier_groups"]
+      end
+
+      def items_for_category(category_name)
+        items.select { |item| item["category"] == category_name }
+      end
+
+      private
+
+      def load_json(filename)
+        path = File.join(data_path, "#{filename}.json")
+
+        unless File.exist?(path)
+          raise Error, "Data file not found: #{path}"
+        end
+
+        JSON.parse(File.read(path))
+      end
+
+      def data_path
+        File.join(CloverSandboxSimulator.root, "lib", "clover_sandbox_simulator", "data", business_type.to_s)
+      end
+    end
+  end
+end

data/lib/clover_sandbox_simulator/generators/entity_generator.rb

@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+module CloverSandboxSimulator
+  module Generators
+    # Creates restaurant entities in Clover (categories, items, discounts, etc.)
+    class EntityGenerator
+      attr_reader :services, :data, :logger
+
+      def initialize(services: nil, business_type: :restaurant)
+        @services = services || Services::Clover::ServicesManager.new
+        @data = DataLoader.new(business_type: business_type)
+        @logger = CloverSandboxSimulator.logger
+      end
+
+      # Set up all entities (categories, items, discounts, etc.)
+      def setup_all
+        logger.info "=" * 60
+        logger.info "Setting up restaurant entities in Clover..."
+        logger.info "=" * 60
+
+        results = {
+          categories: setup_categories,
+          items: setup_items,
+          discounts: setup_discounts,
+          employees: setup_employees,
+          customers: setup_customers
+        }
+
+        logger.info "=" * 60
+        logger.info "Entity setup complete!"
+        logger.info "  Categories: #{results[:categories].size}"
+        logger.info "  Items: #{results[:items].size}"
+        logger.info "  Discounts: #{results[:discounts].size}"
+        logger.info "  Employees: #{results[:employees].size}"
+        logger.info "  Customers: #{results[:customers].size}"
+        logger.info "=" * 60
+
+        results
+      end
+
+      # Create categories from data file
+      def setup_categories
+        logger.info "Setting up categories..."
+
+        existing = services.inventory.get_categories
+        existing_names = existing.map { |c| c["name"] }
+
+        created = []
+        data.categories.each do |cat_data|
+          if existing_names.include?(cat_data["name"])
+            logger.debug "Category '#{cat_data["name"]}' already exists, skipping"
+            created << existing.find { |c| c["name"] == cat_data["name"] }
+          else
+            cat = services.inventory.create_category(
+              name: cat_data["name"],
+              sort_order: cat_data["sort_order"]
+            )
+            created << cat if cat
+          end
+        end
+
+        logger.info "Categories ready: #{created.size}"
+        created
+      end
+
+      # Create items from data file
+      def setup_items
+        logger.info "Setting up menu items..."
+
+        # Build category lookup
+        categories = services.inventory.get_categories
+        category_lookup = categories.each_with_object({}) do |cat, hash|
+          hash[cat["name"]] = cat["id"]
+        end
+
+        existing = services.inventory.get_items
+        existing_names = existing.map { |i| i["name"] }
+
+        created = []
+        data.items.each do |item_data|
+          if existing_names.include?(item_data["name"])
+            logger.debug "Item '#{item_data["name"]}' already exists, skipping"
+            created << existing.find { |i| i["name"] == item_data["name"] }
+          else
+            category_id = category_lookup[item_data["category"]]
+
+            item = services.inventory.create_item(
+              name: item_data["name"],
+              price: item_data["price"],
+              category_id: category_id
+            )
+            created << item if item
+          end
+        end
+
+        logger.info "Items ready: #{created.size}"
+        created
+      end
+
+      # Create discounts from data file
+      def setup_discounts
+        logger.info "Setting up discounts..."
+
+        existing = services.discount.get_discounts
+        existing_names = existing.map { |d| d["name"] }
+
+        created = []
+        data.discounts.each do |disc_data|
+          if existing_names.include?(disc_data["name"])
+            logger.debug "Discount '#{disc_data["name"]}' already exists, skipping"
+            created << existing.find { |d| d["name"] == disc_data["name"] }
+          else
+            disc = if disc_data["percentage"]
+                     services.discount.create_percentage_discount(
+                       name: disc_data["name"],
+                       percentage: disc_data["percentage"]
+                     )
+                   else
+                     services.discount.create_fixed_discount(
+                       name: disc_data["name"],
+                       amount: disc_data["amount"]
+                     )
+                   end
+            created << disc if disc
+          end
+        end
+
+        logger.info "Discounts ready: #{created.size}"
+        created
+      end
+
+      # Ensure employees exist
+      def setup_employees
+        logger.info "Setting up employees..."
+        employees = services.employee.ensure_employees(count: 5)
+        logger.info "Employees ready: #{employees.size}"
+        employees
+      end
+
+      # Ensure customers exist
+      def setup_customers
+        logger.info "Setting up customers..."
+        customers = services.customer.ensure_customers(count: 20)
+        logger.info "Customers ready: #{customers.size}"
+        customers
+      end
+
+      # Delete all entities (for clean slate)
+      def delete_all
+        logger.warn "=" * 60
+        logger.warn "DELETING ALL ENTITIES..."
+        logger.warn "=" * 60
+
+        services.inventory.delete_all
+
+        services.discount.get_discounts.each do |d|
+          services.discount.delete_discount(d["id"])
+        end
+
+        logger.info "All entities deleted"
+      end
+    end
+  end
+end