clover_sandbox_simulator 1.4.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 74de5928a11de82d6c3b389aec6fd92a4c63844eb55ad22bbfafecb805e4aca8
-  data.tar.gz: 2f11d97b104c0a58a37266b9792157d497ed30ff10fd39bb7bca964239893dc9
+  metadata.gz: 71bf747b5954c1ed19674690e6bd87b50565e6134d271578d0ca555107c5768b
+  data.tar.gz: a6e887ab824caa87d013d98fefc58040d0668849b05f60694375d14202792ad5
 SHA512:
-  metadata.gz: 5ff02a1e8a9e90d8230c6af743887851e65c0eb266f9574571cdbcc3e973f06c719abb5fa64b164cdc14b473ee48355f0f822149ba89a0c543c36afa5b97eb68
-  data.tar.gz: 2ae75ceca9d7d77e762fa5fbb94361cd85bea8bdd3e4b8a8c15bc9461aa228f941096e7c079d681bbce4722068b068ecae27496562875fc9019e715dfe8e1167
+  metadata.gz: 01fbdfe1c3deb2506c2c49b8f800e4636b9c34150047276f034b85a4f51a60681feb0d6374abe2682481de2d44410e337a44b4f5b9a84ef93ebc0003e396d801
+  data.tar.gz: 845682838c47593dbfff5face1418d6a1359224bfbd1c167c314527d7ca7a1c4a3a9c39a6ac2d10a8b81bcb3a9180a17014f4881c2be139b55ba3947b22e31ef

data/Gemfile

@@ -4,6 +4,9 @@ source "https://rubygems.org"
 
 gemspec
 
+# Project management tracking (shared across all TOS projects)
+gem "linear_api", path: "../linear"
+
 group :development, :test do
   gem "pry", "~> 0.14"
   gem "pry-byebug", "~> 3.10"

data/bin/simulate

@@ -386,7 +386,230 @@ module CloverSandboxSimulator
 
     desc "version", "Show version"
     def version
-      puts "Clover Sandbox Simulator v1.0.0"
+      puts "Clover Sandbox Simulator v#{CloverSandboxSimulator::VERSION}"
+    end
+
+    # ============================================
+    # Database Management Commands (db: namespace)
+    # ============================================
+
+    desc "db SUBCOMMAND", "Database management commands"
+    subcommand "db", Class.new(Thor) {
+      def self.banner(task, namespace = true, subcommand = true)
+        "simulate db #{task.usage}"
+      end
+
+      namespace "db"
+
+      desc "create", "Create the PostgreSQL database"
+      def create
+        db = CloverSandboxSimulator::Database
+        url = db.database_url
+        puts "Creating database..."
+        db.create!(url)
+        puts "Done."
+      rescue CloverSandboxSimulator::Error => e
+        puts "Error: #{e.message}"
+        exit 1
+      end
+
+      desc "migrate", "Run pending migrations"
+      def migrate
+        db = CloverSandboxSimulator::Database
+        url = db.database_url
+        puts "Connecting and running migrations..."
+        db.connect!(url)
+        db.migrate!
+        puts "Done."
+      rescue CloverSandboxSimulator::Error => e
+        puts "Error: #{e.message}"
+        exit 1
+      end
+
+      desc "seed", "Seed the database with realistic data via FactoryBot"
+      option :type, type: :string, desc: "Business type to seed (e.g. restaurant, retail_clothing). Seeds all if omitted."
+      def seed
+        db = CloverSandboxSimulator::Database
+        url = db.database_url
+        puts "Connecting and seeding..."
+        db.connect!(url)
+        bt = options[:type]&.to_sym
+        result = db.seed!(business_type: bt)
+        puts "Seeded: #{result[:business_types]} business types, #{result[:categories]} categories, #{result[:items]} items"
+        puts "  (#{result[:created]} created, #{result[:found]} already existed)"
+      rescue CloverSandboxSimulator::Error => e
+        puts "Error: #{e.message}"
+        exit 1
+      end
+
+      desc "reset", "Drop, create, migrate, and seed the database"
+      option :type, type: :string, desc: "Business type to seed (e.g. restaurant). Seeds all if omitted."
+      option :confirm, type: :boolean, desc: "Confirm destructive operation"
+      def reset
+        unless options[:confirm]
+          puts "This will DROP and recreate the database. All data will be lost."
+          puts "Run with --confirm to proceed."
+          return
+        end
+
+        db = CloverSandboxSimulator::Database
+        url = db.database_url
+
+        puts "Dropping database..."
+        db.drop!(url)
+
+        puts "Creating database..."
+        db.create!(url)
+
+        puts "Connecting and running migrations..."
+        db.connect!(url)
+        db.migrate!
+
+        puts "Seeding..."
+        bt = options[:type]&.to_sym
+        result = db.seed!(business_type: bt)
+        puts "Seeded: #{result[:business_types]} business types, #{result[:categories]} categories, #{result[:items]} items"
+        puts "Done."
+      rescue CloverSandboxSimulator::Error => e
+        puts "Error: #{e.message}"
+        exit 1
+      end
+    }
+
+    # ============================================
+    # Audit & Reporting Commands
+    # ============================================
+
+    desc "summary", "Show daily summary for current merchant"
+    option :date, type: :string, aliases: "-d", desc: "Date (YYYY-MM-DD, default: today)"
+    def summary
+      configure_logging
+      require_db_connection!
+
+      date = options[:date] ? Date.parse(options[:date]) : Date.today
+      merchant_id = CloverSandboxSimulator.configuration.merchant_id
+
+      s = Models::DailySummary.for_merchant(merchant_id).on_date(date).first
+
+      unless s
+        puts "No summary found for merchant #{merchant_id} on #{date}."
+        puts "Run 'simulate generate' to create orders first."
+        return
+      end
+
+      puts "Daily Summary: #{date}"
+      puts "=" * 50
+      puts "  Merchant:      #{merchant_id}"
+      puts "  Orders:        #{s.order_count}"
+      puts "  Payments:      #{s.payment_count}"
+      puts "  Refunds:       #{s.refund_count}"
+      puts ""
+      puts "  Revenue:       #{format_cents(s.total_revenue)}"
+      puts "  Tax:           #{format_cents(s.total_tax)}"
+      puts "  Tips:          #{format_cents(s.total_tips)}"
+      puts "  Discounts:     #{format_cents(s.total_discounts)}"
+
+      breakdown = s.breakdown || {}
+
+      if breakdown["by_meal_period"]&.any?
+        puts ""
+        puts "  By Meal Period:"
+        breakdown["by_meal_period"].each do |period, count|
+          rev = breakdown.dig("revenue_by_meal_period", period) || 0
+          puts "    #{period.ljust(15)} #{count.to_s.rjust(3)} orders  #{format_cents(rev)}"
+        end
+      end
+
+      if breakdown["by_dining_option"]&.any?
+        puts ""
+        puts "  By Dining Option:"
+        breakdown["by_dining_option"].each do |opt, count|
+          rev = breakdown.dig("revenue_by_dining_option", opt) || 0
+          puts "    #{opt.ljust(15)} #{count.to_s.rjust(3)} orders  #{format_cents(rev)}"
+        end
+      end
+
+      if breakdown["by_tender"]&.any?
+        puts ""
+        puts "  By Tender:"
+        breakdown["by_tender"].each do |tender, count|
+          puts "    #{tender.ljust(20)} #{count} payments"
+        end
+      end
+    end
+
+    desc "audit", "Show recent API requests"
+    option :limit, type: :numeric, aliases: "-l", default: 20, desc: "Number of requests to show (default: 20)"
+    option :errors, type: :boolean, aliases: "-e", desc: "Show only error requests"
+    def audit
+      configure_logging
+      require_db_connection!
+
+      scope = Models::ApiRequest.order(created_at: :desc)
+      scope = scope.errors if options[:errors]
+      requests = scope.limit(options[:limit])
+
+      if requests.empty?
+        label = options[:errors] ? "error " : ""
+        puts "No #{label}API requests found."
+        return
+      end
+
+      label = options[:errors] ? "Error " : ""
+      puts "Recent #{label}API Requests (#{requests.size})"
+      puts "=" * 80
+
+      requests.each do |req|
+        status_indicator = req.error_message ? "ERR" : "OK "
+        ts = req.created_at.strftime("%H:%M:%S")
+        duration = req.duration_ms ? "#{req.duration_ms}ms" : "N/A"
+
+        puts "#{status_indicator} #{ts} #{req.http_method.ljust(6)} #{req.response_status || '---'} " \
+             "#{duration.rjust(7)}  #{truncate_url(req.url, 50)}"
+
+        if req.error_message
+          puts "    Error: #{req.error_message[0..80]}"
+        end
+      end
+
+      total = Models::ApiRequest.count
+      errors = Models::ApiRequest.errors.count
+      puts "\nTotal: #{total} requests, #{errors} errors"
+    end
+
+    desc "business_types", "List business types with category and item counts"
+    def business_types
+      configure_logging
+      require_db_connection!
+
+      types = Models::BusinessType.all.order(:key)
+
+      if types.empty?
+        puts "No business types found. Run 'simulate db seed' first."
+        return
+      end
+
+      puts "Business Types"
+      puts "=" * 60
+      puts "#{'Key'.ljust(20)} #{'Industry'.ljust(10)} #{'Categories'.rjust(10)} #{'Items'.rjust(8)}"
+      puts "-" * 60
+
+      total_cats = 0
+      total_items = 0
+
+      types.each do |bt|
+        cat_count = bt.categories.count
+        item_count = Models::Item.for_business_type(bt.key).count
+        total_cats += cat_count
+        total_items += item_count
+
+        industry = bt.industry || "N/A"
+
+        puts "#{bt.key.ljust(20)} #{industry.ljust(10)} #{cat_count.to_s.rjust(10)} #{item_count.to_s.rjust(8)}"
+      end
+
+      puts "-" * 60
+      puts "#{'TOTAL'.ljust(20)} #{' '.ljust(10)} #{total_cats.to_s.rjust(10)} #{total_items.to_s.rjust(8)}"
     end
 
     # ============================================
@@ -488,7 +711,8 @@ module CloverSandboxSimulator
       rates.each do |rate|
         rate_pct = (rate["rate"] || 0) / 100_000.0
         default_str = rate["isDefault"] ? "Yes" : "No"
-        puts "#{(rate['name'] || 'N/A').ljust(25)} #{'%.3f%' % rate_pct.rjust(8)} #{default_str.ljust(10)} #{rate['id']}"
+        rate_str = format("%.3f%%", rate_pct)
+        puts "#{(rate['name'] || 'N/A').ljust(25)} #{rate_str.rjust(8)} #{default_str.ljust(10)} #{rate['id']}"
       end
     end
 
@@ -890,6 +1114,25 @@ module CloverSandboxSimulator
       "#{card_number[0..3]}********#{card_number[-4..]}"
     end
 
+    def format_cents(cents)
+      "$#{'%.2f' % ((cents || 0) / 100.0)}"
+    end
+
+    def require_db_connection!
+      url = Database.database_url
+      Database.connect!(url) unless Database.connected?
+    rescue Error => e
+      puts "Database not available: #{e.message}"
+      puts "Run 'simulate db create && simulate db migrate' first."
+      exit 1
+    end
+
+    def truncate_url(url, max_length)
+      return url if url.nil? || url.length <= max_length
+
+      "...#{url[-(max_length - 3)..]}"
+    end
+
     def configure_logging
       config = CloverSandboxSimulator.configuration
 

data/lib/clover_sandbox_simulator/configuration.rb

@@ -182,15 +182,36 @@ module CloverSandboxSimulator
       apply_merchant_config(merchants.first)
     end
 
+    # Parse .env.json, supporting both the legacy array format and the
+    # new object format: { "DATABASE_URL": "...", "merchants": [...] }
     def load_merchants_file
       return [] unless File.exist?(MERCHANTS_FILE)
 
-      JSON.parse(File.read(MERCHANTS_FILE))
+      data = JSON.parse(File.read(MERCHANTS_FILE))
+      return data if data.is_a?(Array) # legacy format
+
+      # New object format — extract merchants list
+      data.fetch("merchants", [])
     rescue JSON::ParserError => e
       warn "Failed to parse #{MERCHANTS_FILE}: #{e.message}"
       []
     end
 
+    # Read the top-level DATABASE_URL from .env.json (new object format only).
+    # Returns nil when the file uses the legacy array format or has no key.
+    #
+    # @return [String, nil] The DATABASE_URL or nil
+    def self.database_url_from_file
+      return nil unless File.exist?(MERCHANTS_FILE)
+
+      data = JSON.parse(File.read(MERCHANTS_FILE))
+      return nil if data.is_a?(Array)
+
+      data["DATABASE_URL"]
+    rescue JSON::ParserError
+      nil
+    end
+
     def apply_merchant_config(merchant)
       @merchant_id   = merchant["CLOVER_MERCHANT_ID"]
       @merchant_name = merchant["CLOVER_MERCHANT_NAME"]

data/lib/clover_sandbox_simulator/data/restaurant/categories.json

@@ -6,33 +6,48 @@
       "description": "Start your meal right"
     },
     {
-      "name": "Entrees",
+      "name": "Soups & Salads",
       "sort_order": 2,
+      "description": "Fresh soups and crisp salads"
+    },
+    {
+      "name": "Entrees",
+      "sort_order": 3,
       "description": "Main courses"
     },
     {
       "name": "Sides",
-      "sort_order": 3,
+      "sort_order": 4,
       "description": "Perfect accompaniments"
     },
+    {
+      "name": "Kids Menu",
+      "sort_order": 5,
+      "description": "For our younger guests"
+    },
+    {
+      "name": "Brunch",
+      "sort_order": 6,
+      "description": "Weekend brunch favorites"
+    },
     {
       "name": "Desserts",
-      "sort_order": 4,
+      "sort_order": 7,
       "description": "Sweet endings"
     },
     {
       "name": "Drinks",
-      "sort_order": 5,
+      "sort_order": 8,
       "description": "Non-alcoholic beverages"
     },
     {
       "name": "Alcoholic Beverages",
-      "sort_order": 6,
+      "sort_order": 9,
       "description": "Beer, wine, and cocktails"
     },
     {
       "name": "Specials",
-      "sort_order": 7,
+      "sort_order": 10,
       "description": "Chef's daily specials"
     }
   ]

data/lib/clover_sandbox_simulator/data/restaurant/combos.json

@@ -215,27 +215,50 @@
     {
       "id": "kids_meal",
       "name": "Kids Meal",
-      "description": "Side + Drink free with entree (kids under 12)",
+      "description": "Kids item + Drink for 10% off",
       "discount_type": "percentage",
-      "discount_value": 100,
+      "discount_value": 10,
       "required_components": [
         {
-          "category": "Entrees",
+          "category": "Kids Menu",
           "quantity": 1
         },
         {
-          "category": "Sides",
+          "category": "Drinks",
+          "quantity": 1
+        }
+      ],
+      "applies_to": "total",
+      "max_discount_amount": 300,
+      "active": true
+    },
+    {
+      "id": "brunch_special",
+      "name": "Brunch Special",
+      "description": "Brunch item + Drink + Side for 15% off",
+      "discount_type": "percentage",
+      "discount_value": 15,
+      "required_components": [
+        {
+          "category": "Brunch",
           "quantity": 1
         },
         {
           "category": "Drinks",
           "quantity": 1
+        },
+        {
+          "category": "Sides",
+          "quantity": 1
         }
       ],
-      "applies_to": "cheapest_items",
-      "max_items_discounted": 2,
-      "requires_kid": true,
-      "max_discount_amount": 898,
+      "applies_to": "total",
+      "time_restricted": true,
+      "time_rules": {
+        "start_hour": 7,
+        "end_hour": 14
+      },
+      "max_discount_amount": 500,
       "active": true
     }
   ]

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

@@ -30,6 +30,48 @@
       "category": "Appetizers",
       "description": "Lightly fried with aioli"
     },
+    {
+      "name": "Bruschetta",
+      "price": 999,
+      "category": "Appetizers",
+      "description": "Toasted bread with tomato, basil, and balsamic"
+    },
+    {
+      "name": "Shrimp Cocktail",
+      "price": 1599,
+      "category": "Appetizers",
+      "description": "Chilled jumbo shrimp with cocktail sauce"
+    },
+    {
+      "name": "Tomato Bisque",
+      "price": 699,
+      "category": "Soups & Salads",
+      "description": "Creamy tomato soup with croutons"
+    },
+    {
+      "name": "French Onion Soup",
+      "price": 849,
+      "category": "Soups & Salads",
+      "description": "Classic broth with gruyère crouton"
+    },
+    {
+      "name": "Garden Salad",
+      "price": 899,
+      "category": "Soups & Salads",
+      "description": "Mixed greens, tomato, cucumber, choice of dressing"
+    },
+    {
+      "name": "Wedge Salad",
+      "price": 1099,
+      "category": "Soups & Salads",
+      "description": "Iceberg wedge with blue cheese and bacon"
+    },
+    {
+      "name": "Clam Chowder",
+      "price": 899,
+      "category": "Soups & Salads",
+      "description": "New England style cream-based clam chowder"
+    },
     {
       "name": "Classic Burger",
       "price": 1499,
@@ -90,6 +132,18 @@
       "category": "Entrees",
       "description": "Mixed greens with grilled chicken"
     },
+    {
+      "name": "Mushroom Risotto",
+      "price": 1799,
+      "category": "Entrees",
+      "description": "Arborio rice with wild mushrooms and parmesan"
+    },
+    {
+      "name": "Shrimp Scampi",
+      "price": 2099,
+      "category": "Entrees",
+      "description": "Sautéed shrimp in garlic butter over linguine"
+    },
     {
       "name": "French Fries",
       "price": 499,
@@ -126,6 +180,78 @@
       "category": "Sides",
       "description": "Seasonal vegetables"
     },
+    {
+      "name": "Mac and Cheese Bites",
+      "price": 599,
+      "category": "Sides",
+      "description": "Crispy fried mac and cheese balls"
+    },
+    {
+      "name": "Garlic Bread",
+      "price": 449,
+      "category": "Sides",
+      "description": "Toasted with garlic butter and herbs"
+    },
+    {
+      "name": "Chicken Tenders",
+      "price": 799,
+      "category": "Kids Menu",
+      "description": "Hand-breaded chicken strips with fries"
+    },
+    {
+      "name": "Kids Mac and Cheese",
+      "price": 649,
+      "category": "Kids Menu",
+      "description": "Classic creamy macaroni"
+    },
+    {
+      "name": "Mini Burger",
+      "price": 699,
+      "category": "Kids Menu",
+      "description": "Small patty with fries"
+    },
+    {
+      "name": "Grilled Cheese",
+      "price": 599,
+      "category": "Kids Menu",
+      "description": "Melted cheddar on toasted bread with fries"
+    },
+    {
+      "name": "Kids Quesadilla",
+      "price": 649,
+      "category": "Kids Menu",
+      "description": "Cheese quesadilla with sour cream"
+    },
+    {
+      "name": "Eggs Benedict",
+      "price": 1499,
+      "category": "Brunch",
+      "description": "Poached eggs, ham, hollandaise on English muffin"
+    },
+    {
+      "name": "Avocado Toast",
+      "price": 1299,
+      "category": "Brunch",
+      "description": "Smashed avocado on sourdough with poached egg"
+    },
+    {
+      "name": "Pancake Stack",
+      "price": 1099,
+      "category": "Brunch",
+      "description": "Fluffy buttermilk pancakes with maple syrup"
+    },
+    {
+      "name": "French Toast",
+      "price": 1199,
+      "category": "Brunch",
+      "description": "Brioche dipped in vanilla custard with berries"
+    },
+    {
+      "name": "Breakfast Burrito",
+      "price": 1199,
+      "category": "Brunch",
+      "description": "Scrambled eggs, chorizo, cheese, salsa verde"
+    },
     {
       "name": "Chocolate Brownie",
       "price": 699,
@@ -150,6 +276,12 @@
       "category": "Desserts",
       "description": "Italian coffee-flavored dessert"
     },
+    {
+      "name": "Crème Brûlée",
+      "price": 949,
+      "category": "Desserts",
+      "description": "Vanilla custard with caramelized sugar crust"
+    },
     {
       "name": "Soft Drink",
       "price": 299,
@@ -180,6 +312,18 @@
       "category": "Drinks",
       "description": "Assorted flavors"
     },
+    {
+      "name": "Sparkling Water",
+      "price": 349,
+      "category": "Drinks",
+      "description": "San Pellegrino or Perrier"
+    },
+    {
+      "name": "Fresh Juice",
+      "price": 499,
+      "category": "Drinks",
+      "description": "Orange, apple, or cranberry"
+    },
     {
       "name": "Draft Beer",
       "price": 599,
@@ -222,6 +366,12 @@
       "category": "Alcoholic Beverages",
       "description": "Classic cocktail"
     },
+    {
+      "name": "Old Fashioned",
+      "price": 1299,
+      "category": "Alcoholic Beverages",
+      "description": "Bourbon, bitters, orange peel"
+    },
     {
       "name": "Chef's Special",
       "price": 2499,

data/lib/clover_sandbox_simulator/data/restaurant/tax_rates.json

@@ -25,8 +25,11 @@
     "Wine": ["Sales Tax", "Alcohol Tax"],
     "Cocktails": ["Sales Tax", "Alcohol Tax"],
     "Appetizers": ["Sales Tax"],
+    "Soups & Salads": ["Sales Tax"],
     "Entrees": ["Sales Tax"],
     "Sides": ["Sales Tax"],
+    "Kids Menu": ["Sales Tax"],
+    "Brunch": ["Sales Tax"],
     "Desserts": ["Sales Tax"],
     "Drinks": ["Sales Tax"],
     "Specials": ["Sales Tax"],