lightspeed_sandbox_simulator 0.1.0

data/lib/lightspeed_sandbox_simulator/data/restaurant/items.json

@@ -0,0 +1,29 @@
+{
+  "items": [
+    { "name": "Buffalo Wings", "price": 12.99, "category": "Appetizers", "sku": "REST-APP-001" },
+    { "name": "Mozzarella Sticks", "price": 9.99, "category": "Appetizers", "sku": "REST-APP-002" },
+    { "name": "Loaded Nachos", "price": 13.99, "category": "Appetizers", "sku": "REST-APP-003" },
+    { "name": "Bruschetta", "price": 10.99, "category": "Appetizers", "sku": "REST-APP-004" },
+    { "name": "Calamari", "price": 11.99, "category": "Appetizers", "sku": "REST-APP-005" },
+    { "name": "Grilled Salmon", "price": 24.99, "category": "Entrees", "sku": "REST-ENT-001" },
+    { "name": "NY Strip Steak", "price": 29.99, "category": "Entrees", "sku": "REST-ENT-002" },
+    { "name": "Chicken Parmesan", "price": 18.99, "category": "Entrees", "sku": "REST-ENT-003" },
+    { "name": "Fish and Chips", "price": 16.99, "category": "Entrees", "sku": "REST-ENT-004" },
+    { "name": "Pasta Alfredo", "price": 15.99, "category": "Entrees", "sku": "REST-ENT-005" },
+    { "name": "BBQ Ribs", "price": 22.99, "category": "Entrees", "sku": "REST-ENT-006" },
+    { "name": "Caesar Salad", "price": 12.99, "category": "Entrees", "sku": "REST-ENT-007" },
+    { "name": "French Fries", "price": 5.99, "category": "Sides", "sku": "REST-SID-001" },
+    { "name": "Coleslaw", "price": 4.99, "category": "Sides", "sku": "REST-SID-002" },
+    { "name": "Mac and Cheese", "price": 6.99, "category": "Sides", "sku": "REST-SID-003" },
+    { "name": "Garden Salad", "price": 5.49, "category": "Sides", "sku": "REST-SID-004" },
+    { "name": "Onion Rings", "price": 6.49, "category": "Sides", "sku": "REST-SID-005" },
+    { "name": "Coca-Cola", "price": 2.99, "category": "Drinks", "sku": "REST-DRK-001" },
+    { "name": "Iced Tea", "price": 2.99, "category": "Drinks", "sku": "REST-DRK-002" },
+    { "name": "Draft Beer", "price": 6.99, "category": "Drinks", "sku": "REST-DRK-003" },
+    { "name": "House Wine", "price": 8.99, "category": "Drinks", "sku": "REST-DRK-004" },
+    { "name": "Lemonade", "price": 3.49, "category": "Drinks", "sku": "REST-DRK-005" },
+    { "name": "Chocolate Cake", "price": 8.99, "category": "Desserts", "sku": "REST-DES-001" },
+    { "name": "Cheesecake", "price": 9.99, "category": "Desserts", "sku": "REST-DES-002" },
+    { "name": "Ice Cream Sundae", "price": 7.99, "category": "Desserts", "sku": "REST-DES-003" }
+  ]
+}

data/lib/lightspeed_sandbox_simulator/data/restaurant/tenders.json

@@ -0,0 +1,9 @@
+{
+  "tenders": [
+    { "name": "Cash", "description": "Cash payment", "weight": 25 },
+    { "name": "Credit Card", "description": "Credit card payment", "weight": 45 },
+    { "name": "Debit Card", "description": "Debit card payment", "weight": 20 },
+    { "name": "Gift Card", "description": "Gift card payment", "weight": 5 },
+    { "name": "Check", "description": "Check payment", "weight": 5 }
+  ]
+}

data/lib/lightspeed_sandbox_simulator/data/retail_general/categories.json

@@ -0,0 +1,9 @@
+{
+  "categories": [
+    { "name": "Electronics", "sort_order": 1, "description": "Electronic devices and accessories" },
+    { "name": "Clothing", "sort_order": 2, "description": "Apparel and accessories" },
+    { "name": "Home & Garden", "sort_order": 3, "description": "Home goods and garden supplies" },
+    { "name": "Health & Beauty", "sort_order": 4, "description": "Health and beauty products" },
+    { "name": "Groceries", "sort_order": 5, "description": "Food and grocery items" }
+  ]
+}

data/lib/lightspeed_sandbox_simulator/data/retail_general/items.json

@@ -0,0 +1,17 @@
+{
+  "items": [
+    { "name": "Phone Charger", "price": 14.99, "category": "Electronics", "sku": "RET-ELC-001" },
+    { "name": "Bluetooth Speaker", "price": 29.99, "category": "Electronics", "sku": "RET-ELC-002" },
+    { "name": "USB Cable", "price": 9.99, "category": "Electronics", "sku": "RET-ELC-003" },
+    { "name": "T-Shirt", "price": 19.99, "category": "Clothing", "sku": "RET-CLO-001" },
+    { "name": "Baseball Cap", "price": 14.99, "category": "Clothing", "sku": "RET-CLO-002" },
+    { "name": "Socks Pack", "price": 8.99, "category": "Clothing", "sku": "RET-CLO-003" },
+    { "name": "Candle", "price": 12.99, "category": "Home & Garden", "sku": "RET-HOM-001" },
+    { "name": "Plant Pot", "price": 9.99, "category": "Home & Garden", "sku": "RET-HOM-002" },
+    { "name": "Picture Frame", "price": 11.99, "category": "Home & Garden", "sku": "RET-HOM-003" },
+    { "name": "Hand Cream", "price": 7.99, "category": "Health & Beauty", "sku": "RET-HLT-001" },
+    { "name": "Lip Balm", "price": 4.99, "category": "Health & Beauty", "sku": "RET-HLT-002" },
+    { "name": "Snack Bar", "price": 2.99, "category": "Groceries", "sku": "RET-GRC-001" },
+    { "name": "Water Bottle", "price": 1.99, "category": "Groceries", "sku": "RET-GRC-002" }
+  ]
+}

data/lib/lightspeed_sandbox_simulator/data/retail_general/tenders.json

@@ -0,0 +1,8 @@
+{
+  "tenders": [
+    { "name": "Cash", "description": "Cash payment", "weight": 20 },
+    { "name": "Credit Card", "description": "Credit card payment", "weight": 50 },
+    { "name": "Debit Card", "description": "Debit card payment", "weight": 25 },
+    { "name": "Gift Card", "description": "Gift card payment", "weight": 5 }
+  ]
+}

data/lib/lightspeed_sandbox_simulator/database.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+require 'active_record'
+require 'uri'
+
+module LightspeedSandboxSimulator
+  class Database
+    MIGRATIONS_PATH = File.expand_path('db/migrate', __dir__)
+    TEST_DATABASE = 'lightspeed_simulator_test'
+
+    class << self
+      def connect!(url)
+        raise ArgumentError, 'Only PostgreSQL URLs are supported' unless url.match?(%r{\Apostgres(ql)?://})
+
+        ActiveRecord::Base.establish_connection(url)
+        ActiveRecord::Base.connection.execute('SELECT 1')
+        ActiveRecord::Base.logger = LightspeedSandboxSimulator.logger
+        LightspeedSandboxSimulator.logger.info("Connected to #{sanitize_url(url)}")
+      end
+
+      def connected?
+        ActiveRecord::Base.connection_pool.connected? && ActiveRecord::Base.connection.active?
+      rescue StandardError
+        false
+      end
+
+      def disconnect!
+        ActiveRecord::Base.connection_pool.disconnect!
+      end
+
+      def create!(url)
+        db_name = URI.parse(url).path.delete_prefix('/')
+        admin_url = url.sub(%r{/[^/]+\z}, '/postgres')
+
+        ActiveRecord::Base.establish_connection(admin_url)
+        ActiveRecord::Base.connection.create_database(db_name)
+        LightspeedSandboxSimulator.logger.info("Created database: #{db_name}")
+      rescue ActiveRecord::StatementInvalid => e
+        raise unless e.message.include?('already exists')
+
+        LightspeedSandboxSimulator.logger.info("Database already exists: #{db_name}")
+      ensure
+        ActiveRecord::Base.connection_pool.disconnect!
+      end
+
+      def drop!(url)
+        db_name = URI.parse(url).path.delete_prefix('/')
+        admin_url = url.sub(%r{/[^/]+\z}, '/postgres')
+
+        ActiveRecord::Base.establish_connection(admin_url)
+        ActiveRecord::Base.connection.drop_database(db_name)
+        LightspeedSandboxSimulator.logger.info("Dropped database: #{db_name}")
+      rescue ActiveRecord::StatementInvalid => e
+        raise unless e.message.include?('does not exist')
+
+        LightspeedSandboxSimulator.logger.info("Database does not exist: #{db_name}")
+      ensure
+        ActiveRecord::Base.connection_pool.disconnect!
+      end
+
+      def migrate!
+        raise Error, 'Database not connected' unless connected?
+
+        ActiveRecord::MigrationContext.new(MIGRATIONS_PATH).migrate
+        LightspeedSandboxSimulator.logger.info('Migrations complete')
+      end
+
+      def seed!(business_type: :restaurant)
+        raise Error, 'Database not connected' unless connected?
+
+        load_factories!
+        Seeder.seed!(business_type: business_type)
+      end
+
+      def database_url
+        url = Configuration.database_url_from_file
+        raise Error, 'DATABASE_URL not found in .env.json' unless url
+
+        url
+      end
+
+      def test_database_url(base_url: nil)
+        return "postgres://localhost:5432/#{TEST_DATABASE}" unless base_url
+
+        uri = URI.parse(base_url)
+        uri.path = "/#{TEST_DATABASE}"
+        uri.to_s
+      rescue URI::InvalidURIError
+        "postgres://localhost:5432/#{TEST_DATABASE}"
+      end
+
+      private
+
+      def sanitize_url(url)
+        uri = URI.parse(url)
+        has_password = !uri.password.nil?
+        uri.user = '***' if uri.user
+        uri.password = '***' if has_password
+        uri.to_s
+      rescue URI::InvalidURIError
+        url.gsub(%r{://[^@]+@}, '://***:***@')
+      end
+
+      def load_factories!
+        return if @factories_loaded
+
+        factories_dir = File.expand_path('db/factories', __dir__)
+        FactoryBot.definition_file_paths = [factories_dir] if Dir.exist?(factories_dir)
+        FactoryBot.find_definitions
+        @factories_loaded = true
+      rescue StandardError => e
+        LightspeedSandboxSimulator.logger.warn("Failed to load factories: #{e.message}")
+      end
+    end
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/factories/api_requests.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :api_request, class: 'LightspeedSandboxSimulator::Models::ApiRequest' do
+    http_method { 'GET' }
+    url { 'https://api.lsk.lightspeed.app/api/v2/businesses/123/menu/categories' }
+    response_status { 200 }
+    duration_ms { 150 }
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/factories/business_types.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :business_type, class: 'LightspeedSandboxSimulator::Models::BusinessType' do
+    key { 'restaurant' }
+    name { 'Restaurant' }
+    industry { 'food' }
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/factories/categories.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :category, class: 'LightspeedSandboxSimulator::Models::Category' do
+    association :business_type
+    name { 'Appetizers' }
+    sort_order { 1 }
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/factories/items.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :item, class: 'LightspeedSandboxSimulator::Models::Item' do
+    association :category
+    name { 'Buffalo Wings' }
+    price { 1299 }
+    sku { 'WING-001' }
+    taxable { true }
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/factories/simulated_orders.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :simulated_order, class: 'LightspeedSandboxSimulator::Models::SimulatedOrder' do
+    order_id { rand(1000..9999).to_s }
+    order_type { 'local' }
+    status { 'paid' }
+    meal_period { 'lunch' }
+    dining_option { 'eat_in' }
+    order_date { Date.today }
+    total { 2500 }
+    tax_amount { 500 }
+    tip_amount { 375 }
+    discount_amount { 0 }
+    item_count { 3 }
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/factories/simulated_payments.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :simulated_payment, class: 'LightspeedSandboxSimulator::Models::SimulatedPayment' do
+    association :simulated_order
+    payment_id { rand(1000..9999).to_s }
+    tender_name { 'Cash' }
+    tender_type { 'CASH' }
+    status { 'successful' }
+    amount { 2500 }
+    tip_amount { 375 }
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/migrate/20260313000001_enable_pgcrypto.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+class EnablePgcrypto < ActiveRecord::Migration[8.0]
+  def change
+    enable_extension 'pgcrypto'
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/migrate/20260313000002_create_business_types.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+class CreateBusinessTypes < ActiveRecord::Migration[8.0]
+  def change
+    create_table :business_types, id: :uuid do |t|
+      t.string :key, null: false
+      t.string :name, null: false
+      t.string :industry, default: 'food'
+      t.timestamps
+    end
+
+    add_index :business_types, :key, unique: true
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/migrate/20260313000003_create_categories.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class CreateCategories < ActiveRecord::Migration[8.0]
+  def change
+    create_table :categories, id: :uuid do |t|
+      t.references :business_type, type: :uuid, null: false, foreign_key: true
+      t.string :name, null: false
+      t.string :description
+      t.integer :sort_order, default: 0
+      t.timestamps
+    end
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/migrate/20260313000004_create_items.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+class CreateItems < ActiveRecord::Migration[8.0]
+  def change
+    create_table :items, id: :uuid do |t|
+      t.references :category, type: :uuid, null: false, foreign_key: true
+      t.string :name, null: false
+      t.integer :price, null: false
+      t.string :sku
+      t.boolean :taxable, default: true
+      t.timestamps
+    end
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/migrate/20260313000005_create_simulated_orders.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+class CreateSimulatedOrders < ActiveRecord::Migration[8.0]
+  def change
+    create_table :simulated_orders, id: :uuid do |t|
+      t.string :order_id
+      t.string :order_type
+      t.string :status, default: 'paid'
+      t.string :meal_period
+      t.string :dining_option
+      t.date :order_date
+      t.integer :total, default: 0
+      t.integer :tax_amount, default: 0
+      t.integer :tip_amount, default: 0
+      t.integer :discount_amount, default: 0
+      t.integer :item_count, default: 0
+      t.timestamps
+    end
+
+    add_index :simulated_orders, :order_date
+    add_index :simulated_orders, :status
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/migrate/20260313000006_create_simulated_payments.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+class CreateSimulatedPayments < ActiveRecord::Migration[8.0]
+  def change
+    create_table :simulated_payments, id: :uuid do |t|
+      t.references :simulated_order, type: :uuid, null: false, foreign_key: true
+      t.string :payment_id
+      t.string :tender_name
+      t.string :tender_type
+      t.string :status, default: 'successful'
+      t.integer :amount, default: 0
+      t.integer :tip_amount, default: 0
+      t.timestamps
+    end
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/migrate/20260313000007_create_api_requests.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+class CreateApiRequests < ActiveRecord::Migration[8.0]
+  def change
+    create_table :api_requests, id: :uuid do |t|
+      t.string :http_method
+      t.text :url
+      t.text :request_payload
+      t.integer :response_status
+      t.text :response_payload
+      t.integer :duration_ms
+      t.string :resource_type
+      t.string :resource_id
+      t.text :error_message
+      t.timestamps
+    end
+  end
+end

data/lib/lightspeed_sandbox_simulator/db/migrate/20260313000008_create_daily_summaries.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+class CreateDailySummaries < ActiveRecord::Migration[8.0]
+  def change
+    create_table :daily_summaries, id: :uuid do |t|
+      t.date :summary_date, null: false
+      t.integer :order_count, default: 0
+      t.integer :payment_count, default: 0
+      t.integer :refund_count, default: 0
+      t.integer :total_revenue, default: 0
+      t.integer :total_tax, default: 0
+      t.integer :total_tips, default: 0
+      t.integer :total_discounts, default: 0
+      t.jsonb :breakdown, default: {}
+      t.timestamps
+    end
+
+    add_index :daily_summaries, :summary_date, unique: true
+  end
+end

data/lib/lightspeed_sandbox_simulator/generators/data_loader.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module LightspeedSandboxSimulator
+  module Generators
+    class DataLoader
+      DATA_DIR = File.expand_path('../data', __dir__)
+      BUSINESS_TYPES = %i[restaurant cafe_bakery bar_nightclub retail_general].freeze
+
+      attr_reader :business_type
+
+      def initialize(business_type: :restaurant)
+        @business_type = business_type
+      end
+
+      def load_categories
+        if Database.connected?
+          bt = Models::BusinessType.find_by(key: business_type.to_s)
+          return load_categories_from_db(bt) if bt
+        end
+
+        data = load_from_json('categories')
+        data.fetch('categories', [])
+      end
+
+      def load_items
+        if Database.connected?
+          bt = Models::BusinessType.find_by(key: business_type.to_s)
+          return load_items_from_db(bt) if bt
+        end
+
+        data = load_from_json('items')
+        data.fetch('items', [])
+      end
+
+      def load_tenders
+        data = load_from_json('tenders')
+        data.fetch('tenders', [])
+      end
+
+      def load_items_by_category
+        load_items.group_by { |i| i['category'] }
+      end
+
+      private
+
+      def load_categories_from_db(btype)
+        btype.categories.order(:sort_order).map do |cat|
+          { 'name' => cat.name, 'sort_order' => cat.sort_order, 'description' => cat.description }
+        end
+      end
+
+      def load_items_from_db(btype)
+        btype.items.includes(:category).map do |item|
+          {
+            'name' => item.name,
+            'price' => item.price / 100.0,
+            'category' => item.category&.name,
+            'sku' => item.sku
+          }
+        end
+      end
+
+      def load_from_json(type)
+        path = File.join(DATA_DIR, business_type.to_s, "#{type}.json")
+        return {} unless File.exist?(path)
+
+        JSON.parse(File.read(path))
+      rescue JSON::ParserError
+        {}
+      end
+    end
+  end
+end

data/lib/lightspeed_sandbox_simulator/generators/entity_generator.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module LightspeedSandboxSimulator
+  module Generators
+    class EntityGenerator
+      def initialize(config: nil, business_type: :restaurant)
+        @config = config || LightspeedSandboxSimulator.configuration
+        @business_type = business_type
+        @loader = DataLoader.new(business_type: business_type)
+        @manager = Services::Lightspeed::ServicesManager.new(config: @config)
+      end
+
+      def setup_all
+        categories = setup_categories
+        items = setup_items(categories)
+        payment_methods = setup_payment_methods
+
+        LightspeedSandboxSimulator.logger.info("Setup complete: #{categories.size} categories, " \
+                                               "#{items.size} items, #{payment_methods.size} payment methods")
+
+        { categories: categories, items: items, payment_methods: payment_methods }
+      end
+
+      def setup_categories
+        data = @loader.load_categories
+        created = []
+
+        data.each do |cat|
+          existing = @manager.menu.find_category_by_name(cat['name'])
+          if existing
+            created << existing
+          else
+            result = @manager.menu.create_category(name: cat['name'], sort_order: cat['sort_order'])
+            created << result if result
+          end
+        end
+
+        created
+      end
+
+      def setup_items(categories)
+        data = @loader.load_items
+        category_map = build_category_map(categories)
+        created = []
+
+        data.each do |item|
+          existing = @manager.menu.find_item_by_name(item['name'])
+          if existing
+            created << existing
+          else
+            category_id = category_map[item['category']]
+            result = @manager.menu.create_item(
+              name: item['name'],
+              price: item['price'],
+              category_id: category_id,
+              sku: item['sku']
+            )
+            created << result if result
+          end
+        end
+
+        created
+      end
+
+      def setup_payment_methods
+        data = @loader.load_tenders
+        created = []
+
+        data.each do |tender|
+          existing = @manager.payment_methods.find_payment_method_by_name(tender['name'])
+          if existing
+            created << existing
+          else
+            result = @manager.payment_methods.create_payment_method(
+              name: tender['name'],
+              type: tender.fetch('type', 'OTHER')
+            )
+            created << result if result
+          end
+        end
+
+        created
+      end
+
+      private
+
+      def build_category_map(categories)
+        categories.each_with_object({}) do |cat, map|
+          name = cat['name'] || cat[:name]
+          id = cat['id'] || cat[:id]
+          map[name] = id if name && id
+        end
+      end
+    end
+  end
+end