revel_sandbox_simulator 0.1.0

data/lib/revel_sandbox_simulator/data/cafe_bakery/items.json

@@ -0,0 +1,27 @@
+[
+  { "name": "Espresso", "price": 350, "sku": "CAF-ESPRES", "category": "Hot Drinks" },
+  { "name": "Cappuccino", "price": 450, "sku": "CAF-CAPPUC", "category": "Hot Drinks" },
+  { "name": "Latte", "price": 499, "sku": "CAF-LATTE", "category": "Hot Drinks" },
+  { "name": "Americano", "price": 399, "sku": "CAF-AMRCNO", "category": "Hot Drinks" },
+  { "name": "Hot Chocolate", "price": 449, "sku": "CAF-HTCHOC", "category": "Hot Drinks" },
+  { "name": "Iced Coffee", "price": 399, "sku": "CAF-ICDCOF", "category": "Cold Drinks" },
+  { "name": "Cold Brew", "price": 499, "sku": "CAF-CLDBRW", "category": "Cold Drinks" },
+  { "name": "Iced Latte", "price": 549, "sku": "CAF-ICDLAT", "category": "Cold Drinks" },
+  { "name": "Smoothie", "price": 649, "sku": "CAF-SMOOTH", "category": "Cold Drinks" },
+  { "name": "Lemonade", "price": 399, "sku": "CAF-LMNADE", "category": "Cold Drinks" },
+  { "name": "Croissant", "price": 350, "sku": "CAF-CRSSNT", "category": "Pastries" },
+  { "name": "Muffin", "price": 399, "sku": "CAF-MUFFIN", "category": "Pastries" },
+  { "name": "Scone", "price": 375, "sku": "CAF-SCONE", "category": "Pastries" },
+  { "name": "Danish", "price": 425, "sku": "CAF-DANISH", "category": "Pastries" },
+  { "name": "Cinnamon Roll", "price": 475, "sku": "CAF-CINROL", "category": "Pastries" },
+  { "name": "Avocado Toast", "price": 950, "sku": "CAF-AVOTST", "category": "Sandwiches" },
+  { "name": "BLT", "price": 899, "sku": "CAF-BLT", "category": "Sandwiches" },
+  { "name": "Turkey Club", "price": 1099, "sku": "CAF-TRKCLB", "category": "Sandwiches" },
+  { "name": "Grilled Cheese", "price": 799, "sku": "CAF-GRLCHS", "category": "Sandwiches" },
+  { "name": "Veggie Wrap", "price": 899, "sku": "CAF-VGWRAP", "category": "Sandwiches" },
+  { "name": "Chocolate Cake", "price": 599, "sku": "CAF-CHKCKE", "category": "Cakes" },
+  { "name": "Red Velvet", "price": 649, "sku": "CAF-RDVLVT", "category": "Cakes" },
+  { "name": "Carrot Cake", "price": 599, "sku": "CAF-CRTCKE", "category": "Cakes" },
+  { "name": "Lemon Tart", "price": 549, "sku": "CAF-LMNTRT", "category": "Cakes" },
+  { "name": "Brownie", "price": 449, "sku": "CAF-BROWNE", "category": "Cakes" }
+]

data/lib/revel_sandbox_simulator/data/cafe_bakery/tenders.json

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

data/lib/revel_sandbox_simulator/data/restaurant/categories.json

@@ -0,0 +1,7 @@
+[
+  { "name": "Appetizers", "sort_order": 0, "description": "Starters and small plates" },
+  { "name": "Entrees", "sort_order": 1, "description": "Main course dishes" },
+  { "name": "Sides", "sort_order": 2, "description": "Side dishes and salads" },
+  { "name": "Beverages", "sort_order": 3, "description": "Drinks and refreshments" },
+  { "name": "Desserts", "sort_order": 4, "description": "Sweet treats and desserts" }
+]

data/lib/revel_sandbox_simulator/data/restaurant/items.json

@@ -0,0 +1,27 @@
+[
+  { "name": "Buffalo Wings", "price": 1299, "sku": "RES-BUFWNG", "category": "Appetizers" },
+  { "name": "Mozzarella Sticks", "price": 999, "sku": "RES-MOZSTK", "category": "Appetizers" },
+  { "name": "Calamari", "price": 1399, "sku": "RES-CALMRI", "category": "Appetizers" },
+  { "name": "Bruschetta", "price": 1099, "sku": "RES-BRUSCH", "category": "Appetizers" },
+  { "name": "Spinach Dip", "price": 1199, "sku": "RES-SPNDIP", "category": "Appetizers" },
+  { "name": "NY Strip Steak", "price": 2999, "sku": "RES-NYSTK", "category": "Entrees" },
+  { "name": "Grilled Salmon", "price": 2499, "sku": "RES-GRLSLM", "category": "Entrees" },
+  { "name": "Chicken Parmesan", "price": 1899, "sku": "RES-CHKPRM", "category": "Entrees" },
+  { "name": "Lamb Chops", "price": 3299, "sku": "RES-LMBCHP", "category": "Entrees" },
+  { "name": "Shrimp Pasta", "price": 2199, "sku": "RES-SHRPST", "category": "Entrees" },
+  { "name": "Caesar Salad", "price": 1299, "sku": "RES-CSRSLD", "category": "Sides" },
+  { "name": "Mashed Potatoes", "price": 699, "sku": "RES-MSHPOT", "category": "Sides" },
+  { "name": "Grilled Vegetables", "price": 799, "sku": "RES-GRLVEG", "category": "Sides" },
+  { "name": "French Fries", "price": 599, "sku": "RES-FRNFRY", "category": "Sides" },
+  { "name": "Coleslaw", "price": 499, "sku": "RES-COLSLW", "category": "Sides" },
+  { "name": "Soft Drink", "price": 299, "sku": "RES-SFTDRK", "category": "Beverages" },
+  { "name": "Iced Tea", "price": 349, "sku": "RES-ICDTEA", "category": "Beverages" },
+  { "name": "Lemonade", "price": 399, "sku": "RES-LMNADE", "category": "Beverages" },
+  { "name": "Coffee", "price": 299, "sku": "RES-COFFEE", "category": "Beverages" },
+  { "name": "Sparkling Water", "price": 349, "sku": "RES-SPKWTR", "category": "Beverages" },
+  { "name": "Chocolate Cake", "price": 899, "sku": "RES-CHKCKE", "category": "Desserts" },
+  { "name": "Tiramisu", "price": 999, "sku": "RES-TRMISU", "category": "Desserts" },
+  { "name": "Cheesecake", "price": 899, "sku": "RES-CHSCKE", "category": "Desserts" },
+  { "name": "Creme Brulee", "price": 1099, "sku": "RES-CRMBRL", "category": "Desserts" },
+  { "name": "Apple Pie", "price": 799, "sku": "RES-APLPIE", "category": "Desserts" }
+]

data/lib/revel_sandbox_simulator/data/restaurant/tenders.json

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

data/lib/revel_sandbox_simulator/data/retail_general/categories.json

@@ -0,0 +1,7 @@
+[
+  { "name": "Electronics", "sort_order": 0, "description": "Tech accessories and gadgets" },
+  { "name": "Clothing", "sort_order": 1, "description": "Apparel and accessories" },
+  { "name": "Home & Garden", "sort_order": 2, "description": "Home decor and garden items" },
+  { "name": "Health & Beauty", "sort_order": 3, "description": "Personal care products" },
+  { "name": "Groceries", "sort_order": 4, "description": "Snacks and beverages" }
+]

data/lib/revel_sandbox_simulator/data/retail_general/items.json

@@ -0,0 +1,27 @@
+[
+  { "name": "Phone Charger", "price": 1999, "sku": "RTL-PHNCHR", "category": "Electronics" },
+  { "name": "USB Cable", "price": 999, "sku": "RTL-USBCBL", "category": "Electronics" },
+  { "name": "Earbuds", "price": 2499, "sku": "RTL-EARBD", "category": "Electronics" },
+  { "name": "Power Bank", "price": 3499, "sku": "RTL-PWRBNK", "category": "Electronics" },
+  { "name": "Screen Protector", "price": 1299, "sku": "RTL-SCNPRT", "category": "Electronics" },
+  { "name": "T-Shirt", "price": 2499, "sku": "RTL-TSHIRT", "category": "Clothing" },
+  { "name": "Hoodie", "price": 4999, "sku": "RTL-HOODIE", "category": "Clothing" },
+  { "name": "Cap", "price": 1999, "sku": "RTL-CAP", "category": "Clothing" },
+  { "name": "Socks", "price": 899, "sku": "RTL-SOCKS", "category": "Clothing" },
+  { "name": "Belt", "price": 2999, "sku": "RTL-BELT", "category": "Clothing" },
+  { "name": "Candle", "price": 1499, "sku": "RTL-CANDLE", "category": "Home & Garden" },
+  { "name": "Mug", "price": 1299, "sku": "RTL-MUG", "category": "Home & Garden" },
+  { "name": "Plant Pot", "price": 1799, "sku": "RTL-PLTPOT", "category": "Home & Garden" },
+  { "name": "Picture Frame", "price": 1999, "sku": "RTL-PICFRM", "category": "Home & Garden" },
+  { "name": "Cushion", "price": 2499, "sku": "RTL-CUSHN", "category": "Home & Garden" },
+  { "name": "Hand Cream", "price": 899, "sku": "RTL-HNDCRM", "category": "Health & Beauty" },
+  { "name": "Lip Balm", "price": 499, "sku": "RTL-LIPBLM", "category": "Health & Beauty" },
+  { "name": "Face Mask", "price": 699, "sku": "RTL-FCMSK", "category": "Health & Beauty" },
+  { "name": "Shampoo", "price": 1199, "sku": "RTL-SHMPO", "category": "Health & Beauty" },
+  { "name": "Body Wash", "price": 999, "sku": "RTL-BDWSH", "category": "Health & Beauty" },
+  { "name": "Snack Bar", "price": 299, "sku": "RTL-SNKBAR", "category": "Groceries" },
+  { "name": "Energy Drink", "price": 399, "sku": "RTL-ENGDRK", "category": "Groceries" },
+  { "name": "Water Bottle", "price": 199, "sku": "RTL-WTRBTL", "category": "Groceries" },
+  { "name": "Trail Mix", "price": 549, "sku": "RTL-TRLMIX", "category": "Groceries" },
+  { "name": "Protein Bar", "price": 399, "sku": "RTL-PRTBAR", "category": "Groceries" }
+]

data/lib/revel_sandbox_simulator/data/retail_general/tenders.json

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

data/lib/revel_sandbox_simulator/database.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require "active_record"
+require "logger"
+
+module RevelSandboxSimulator
+  module Database
+    MIGRATIONS_PATH = File.expand_path("db/migrate", __dir__)
+
+    class << self
+      def connect!(url = nil)
+        url ||= RevelSandboxSimulator.configuration.database_url
+        raise ConfigurationError, "DATABASE_URL is required" if url.nil? || url.empty?
+
+        ActiveRecord::Base.establish_connection(url)
+        ActiveRecord::Base.logger = Logger.new(File::NULL)
+        true
+      end
+
+      def connected?
+        ActiveRecord::Base.connection_pool.with_connection(&:active?)
+      rescue StandardError
+        false
+      end
+
+      def disconnect!
+        ActiveRecord::Base.connection_handler.clear_active_connections!
+      end
+
+      def create!(url = nil)
+        url ||= RevelSandboxSimulator.configuration.database_url
+        config = connection_config(url)
+        database = config[:database]
+
+        ActiveRecord::Base.establish_connection(config.merge(database: "postgres"))
+        ActiveRecord::Base.connection.create_database(database)
+        RevelSandboxSimulator.logger.info("Created database: #{sanitize_url(url)}")
+      rescue ActiveRecord::DatabaseAlreadyExists
+        RevelSandboxSimulator.logger.info("Database already exists: #{sanitize_url(url)}")
+      ensure
+        ActiveRecord::Base.connection_handler.clear_active_connections!
+      end
+
+      def drop!(url = nil)
+        url ||= RevelSandboxSimulator.configuration.database_url
+        config = connection_config(url)
+        database = config[:database]
+
+        ActiveRecord::Base.establish_connection(config.merge(database: "postgres"))
+        ActiveRecord::Base.connection.drop_database(database)
+        RevelSandboxSimulator.logger.info("Dropped database: #{sanitize_url(url)}")
+      rescue ActiveRecord::NoDatabaseError
+        RevelSandboxSimulator.logger.info("Database does not exist: #{sanitize_url(url)}")
+      ensure
+        ActiveRecord::Base.connection_handler.clear_active_connections!
+      end
+
+      def migrate!
+        ActiveRecord::MigrationContext.new(MIGRATIONS_PATH).migrate
+        RevelSandboxSimulator.logger.info("Migrations complete")
+      end
+
+      def seed!(business_type: nil)
+        Seeder.new.seed!(business_type: business_type)
+      end
+
+      def test_database_url(base_url: nil)
+        base = base_url || RevelSandboxSimulator.configuration.database_url
+        return nil unless base
+
+        base.sub(%r{/[^/]+$}, "/revel_simulator_test")
+      end
+
+      private
+
+      def connection_config(url)
+        if url
+          parsed = ActiveRecord::DatabaseConfigurations::UrlConfig.new("primary", "primary", url)
+          parsed.configuration_hash.to_h
+        else
+          ActiveRecord::Base.connection_db_config.configuration_hash.to_h
+        end
+      end
+
+      def sanitize_url(url)
+        return "nil" unless url
+
+        url.gsub(%r{://[^@]+@}, "://***:***@")
+      end
+    end
+  end
+end

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

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :api_request, class: "RevelSandboxSimulator::Models::ApiRequest" do
+    http_method { "GET" }
+    url { "https://sandbox.revelup.com/resources/Product/" }
+    response_status { 200 }
+    duration_ms { rand(50..500) }
+    request_payload { nil }
+    response_payload { { "objects" => [], "meta" => {} } }
+    error_message { nil }
+    resource_type { "Product" }
+    resource_id { nil }
+  end
+end

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :business_type, class: "RevelSandboxSimulator::Models::BusinessType" do
+    sequence(:key) { |n| "business_type_#{n}" }
+    name { key.to_s.tr("_", " ").split.map(&:capitalize).join(" ") }
+    industry { "food" }
+    order_profile { {} }
+
+    trait :restaurant do
+      key { "restaurant" }
+      name { "Restaurant" }
+      industry { "food" }
+    end
+
+    trait :cafe_bakery do
+      key { "cafe_bakery" }
+      name { "Cafe Bakery" }
+      industry { "food" }
+    end
+
+    trait :bar_nightclub do
+      key { "bar_nightclub" }
+      name { "Bar Nightclub" }
+      industry { "food" }
+    end
+
+    trait :retail_general do
+      key { "retail_general" }
+      name { "Retail General" }
+      industry { "retail" }
+    end
+  end
+end

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

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :category, class: "RevelSandboxSimulator::Models::Category" do
+    sequence(:name) { |n| "Category #{n}" }
+    sort_order { 1 }
+    description { "A test category" }
+    association :business_type
+  end
+end

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

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :item, class: "RevelSandboxSimulator::Models::Item" do
+    sequence(:name) { |n| "Item #{n}" }
+    sequence(:sku) { |n| "SKU-#{n.to_s.rjust(4, '0')}" }
+    price { rand(299..2999) }
+    metadata { {} }
+    association :business_type
+    association :category
+  end
+end

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

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :simulated_order, class: "RevelSandboxSimulator::Models::SimulatedOrder" do
+    sequence(:revel_order_id) { |n| (10_000 + n).to_s }
+    status { "paid" }
+    business_date { Date.today }
+    dining_option { %w[dine_in takeout delivery].sample }
+    meal_period { %w[breakfast lunch happy_hour dinner late_night].sample }
+    subtotal { rand(800..5000) }
+    discount_amount { 0 }
+    tax_amount { (subtotal * 0.0825).round }
+    tip_amount { rand(0..500) }
+    total { subtotal - discount_amount + tax_amount + tip_amount }
+    metadata { { source: "test" } }
+
+    trait :refunded do
+      status { "refunded" }
+    end
+
+    trait :open do
+      status { "open" }
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :simulated_payment, class: "RevelSandboxSimulator::Models::SimulatedPayment" do
+    sequence(:revel_payment_id) { |n| (20_000 + n).to_s }
+    association :simulated_order
+    tender_name { "Credit Card" }
+    amount { simulated_order&.total || rand(800..5000) }
+    tip_amount { 0 }
+    tax_amount { 0 }
+    status { "success" }
+    payment_type { "credit_card" }
+  end
+end

data/lib/revel_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/revel_sandbox_simulator/db/migrate/20260313000002_create_business_types.rb

@@ -0,0 +1,16 @@
+# 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, null: false
+      t.jsonb :order_profile, default: {}
+
+      t.timestamps
+    end
+
+    add_index :business_types, :key, unique: true
+  end
+end

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

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

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+class CreateItems < ActiveRecord::Migration[8.0]
+  def change
+    create_table :items, id: :uuid do |t|
+      t.string :name, null: false
+      t.integer :price, null: false, default: 0
+      t.string :sku
+      t.string :barcode
+      t.jsonb :metadata, default: {}
+      t.references :business_type, type: :uuid, null: false, foreign_key: true
+      t.references :category, type: :uuid, foreign_key: true
+
+      t.timestamps
+    end
+
+    add_index :items, :sku, unique: true, where: "sku IS NOT NULL"
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+class CreateSimulatedOrders < ActiveRecord::Migration[8.0]
+  def change
+    create_table :simulated_orders, id: :uuid do |t|
+      t.string :revel_order_id, null: false
+      t.string :status, null: false, default: "open"
+      t.date :business_date, null: false
+      t.string :dining_option, null: false
+      t.string :meal_period, null: false
+      t.integer :subtotal, null: false, default: 0
+      t.integer :tax_amount, null: false, default: 0
+      t.integer :tip_amount, null: false, default: 0
+      t.integer :discount_amount, null: false, default: 0
+      t.integer :total, null: false, default: 0
+      t.jsonb :metadata, default: {}
+
+      t.timestamps
+    end
+
+    add_index :simulated_orders, :revel_order_id, unique: true
+    add_index :simulated_orders, :status
+    add_index :simulated_orders, :business_date
+    add_index :simulated_orders, :meal_period
+    add_index :simulated_orders, :dining_option
+  end
+end

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

@@ -0,0 +1,22 @@
+# 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: { on_delete: :cascade }
+      t.string :revel_payment_id
+      t.string :tender_name, null: false
+      t.integer :amount, null: false, default: 0
+      t.integer :tip_amount, null: false, default: 0
+      t.integer :tax_amount, null: false, default: 0
+      t.string :status, null: false, default: "success"
+      t.string :payment_type
+
+      t.timestamps
+    end
+
+    add_index :simulated_payments, :revel_payment_id, unique: true, where: "revel_payment_id IS NOT NULL"
+    add_index :simulated_payments, :tender_name
+    add_index :simulated_payments, :status
+  end
+end

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

@@ -0,0 +1,22 @@
+# 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.string :url
+      t.jsonb :request_payload
+      t.integer :response_status
+      t.jsonb :response_payload
+      t.integer :duration_ms
+      t.string :error_message
+      t.string :resource_type
+      t.string :resource_id
+
+      t.timestamps
+    end
+
+    add_index :api_requests, :resource_type
+    add_index :api_requests, :created_at
+  end
+end

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

@@ -0,0 +1,21 @@
+# 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, null: false, default: 0
+      t.integer :payment_count, null: false, default: 0
+      t.integer :refund_count, null: false, default: 0
+      t.integer :total_revenue, null: false, default: 0
+      t.integer :total_tax, null: false, default: 0
+      t.integer :total_tips, null: false, default: 0
+      t.integer :total_discounts, null: false, default: 0
+      t.jsonb :breakdown, default: {}
+
+      t.timestamps
+    end
+
+    add_index :daily_summaries, :summary_date, unique: true
+  end
+end

data/lib/revel_sandbox_simulator/generators/data_loader.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module RevelSandboxSimulator
+  module Generators
+    class DataLoader
+      BUSINESS_TYPES = %i[restaurant cafe_bakery bar_nightclub retail_general].freeze
+      DATA_DIR = File.expand_path("../data", __dir__)
+
+      attr_reader :config
+
+      def initialize(config: nil)
+        @config = config || RevelSandboxSimulator.configuration
+      end
+
+      def load_categories
+        if Database.connected?
+          load_categories_from_db
+        else
+          load_categories_from_json
+        end
+      end
+
+      def load_items
+        if Database.connected?
+          load_items_from_db
+        else
+          load_items_from_json
+        end
+      end
+
+      def load_tenders
+        load_json_file(config.business_type, "tenders")
+      end
+
+      def load_items_by_category
+        items = load_items
+        items.group_by { |item| item[:category] }
+      end
+
+      private
+
+      def load_categories_from_db
+        bt = Models::BusinessType.find_by(key: config.business_type.to_s)
+        return load_categories_from_json unless bt
+
+        Models::Category.for_business_type(bt).order(:sort_order).map do |cat|
+          { name: cat.name, sort_order: cat.sort_order, description: cat.description }
+        end
+      end
+
+      def load_items_from_db
+        bt = Models::BusinessType.find_by(key: config.business_type.to_s)
+        return load_items_from_json unless bt
+
+        Models::Item.for_business_type(bt).includes(:category).map do |item|
+          { name: item.name, price: item.price, sku: item.sku, category: item.category&.name }
+        end
+      end
+
+      def load_categories_from_json
+        load_json_file(config.business_type, "categories").map do |cat|
+          { name: cat["name"], sort_order: cat["sort_order"] || 0, description: cat["description"] }
+        end
+      end
+
+      def load_items_from_json
+        load_json_file(config.business_type, "items").map do |item|
+          { name: item["name"], price: item["price"], sku: item["sku"], category: item["category"] }
+        end
+      end
+
+      def load_json_file(business_type, filename)
+        path = File.join(DATA_DIR, business_type.to_s, "#{filename}.json")
+        return [] unless File.exist?(path)
+
+        JSON.parse(File.read(path))
+      end
+    end
+  end
+end

data/lib/revel_sandbox_simulator/generators/entity_generator.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module RevelSandboxSimulator
+  module Generators
+    class EntityGenerator
+      attr_reader :config, :services, :data_loader
+
+      def initialize(config: nil, services: nil)
+        @config = config || RevelSandboxSimulator.configuration
+        @services = services || Services::Revel::ServicesManager.new(config: @config)
+        @data_loader = DataLoader.new(config: @config)
+      end
+
+      def setup_all
+        RevelSandboxSimulator.logger.info("Setting up entities for #{config.business_type}...")
+
+        categories = setup_categories
+        products = setup_products(categories)
+        customers = setup_customers
+
+        stats = { categories: categories.size, products: products.size, customers: customers.size }
+        RevelSandboxSimulator.logger.info("Setup complete: #{stats}")
+        stats
+      end
+
+      def setup_categories
+        categories_data = data_loader.load_categories
+        categories_data.map do |cat_data|
+          result = services.product.find_or_create_category(
+            name: cat_data[:name],
+            description: cat_data[:description],
+            sort_order: cat_data[:sort_order]
+          )
+          RevelSandboxSimulator.logger.debug("Category: #{cat_data[:name]} -> #{result['id']}")
+          result
+        end
+      end
+
+      def setup_products(categories)
+        items_data = data_loader.load_items
+        category_map = categories.to_h { |c| [c["name"], c["id"]] }
+
+        items_data.map do |item_data|
+          category_id = category_map[item_data[:category]]
+          result = services.product.find_or_create_product(
+            name: item_data[:name],
+            price: item_data[:price],
+            category_id: category_id,
+            sku: item_data[:sku]
+          )
+          RevelSandboxSimulator.logger.debug("Product: #{item_data[:name]} -> #{result['id']}")
+          result
+        end
+      end
+
+      def setup_customers(count: 20)
+        services.customer.ensure_customers(count: count)
+      end
+    end
+  end
+end